# Setting Up Cygwin

## Cygwin Contents

The following packages are included in the full release:

Development tools: binutils, bison, byacc, dejagnu, diff, expect, flex, gas, gcc, gdb, itcl, ld, libstdc++, make, patch, tcl, tix, tk

User tools: ash, bash, bzip2, diff, fileutils, findutils, gawk, grep, gzip, less, m4, sed, shellutils, tar, textutils, time

The user tools release only contains the user tools.

Full source code is available for these tools.

## Installing the binary release

Important! Be sure to remove any older versions of the Cygwin tools from your `PATH` environment variable so you do not execute them by mistake.

Connect to one of the ftp servers listed in http://sourceware.cygnus.com/cygwin/mirrors.html and `cd` to the directory containing the latest release.

If you want the development tools and the programs necessary to run the GNU configure mechanism, you should download the full binary release called `full.exe`. If you only care about the user tools listed above, download `usertools.exe` instead.

If you have an unreliable connection, download the appropriate binary in smaller chunks instead. For the split full installer, get the files in the `full-split' subdirectory. Once downloaded, combine the split files at the command prompt by doing a:

    C:\Cygnus\>copy /b xaa + xab + xac + ... + xak + xal full.exe
    C:\Cygnus\>del xa*.*

A similar process can be used for the user tools.

Once you have installed the executable on your system, run it. First off, the installer will prompt you for a location to extract the temporary files it needs to install the release on your system. The default should be fine for most people.

Next it will ask you to choose an install location. The default is ``system-drive`:\cygnus\cygwin-b20`. Feel free to choose another location if you would prefer.

Finally, it will ask you for the name of the Program Files folder shortcut to add. By default, the installer will create a `Cygwin B20' entry in a folder called `Cygnus Solutions'. When this step is completed, it will install the tools and exit.

If you should ever want to uninstall the tools, you may do so via the "Add/Remove Programs" control panel.

At this point you should be able to look under the start menu and select "Cygwin Beta 20" (or whatever you named it). This will pop up a bash shell with special environment variables set up for you. If you are running Windows 95 or 98 and are faced with the error message "Out of environment space", you need to increase the amount of environment space. Adding the line `shell=C:\command.com /e:4096 /p` to the file `C:\CONFIG.SYS` and then rebooting should do the trick if `C:` is your system drive letter.

If you want to install the sources follow the instructions in the next section, else go directly to setup-dir to complete your system setup.

## Installing the source code

Before downloading the source code corresponding to the release, you should install the latest release of the tools (either the full release or just the user tools).

Create the directory that will house the source code. `cd` there.

Connect to one of the ftp servers listed above and `cd` to the directory containing the latest release.

The source code is split into two units: user tools and development tools. If you want the user tools source code, `cd` into the `user-src-split` subdirectory. Download the files there. If you want the development tools sources, `cd` into the `dev-src-split` subdirectory. Download the files there.

Back in the Windows command shell, for the user tools source:

    C:\Cygnus\> copy /b xba + xbb + xbc + xbd + xbe + xbf + xbg user-src.tar.bz2
    C:\Cygnus\> del xb*.*
    C:\Cygnus\> bunzip2 user-src.tar.bz2
    C:\Cygnus\> tar xvf user-src.tar

For the development tools source:

    C:\Cygnus\> copy /b xca + xcb + xcc + xcd + ... + xck + xcl dev-src.tar.bz2
    C:\Cygnus\> del xc*.*
    C:\Cygnus\> bunzip2 dev-src.tar.bz2
    C:\Cygnus\> tar xvf dev-src.tar

Both will expand into a directory called `src`.

Note: if you want the sources corresponding to everything in the full.exe binary installer, you will need to download and expand both the `user-src.tar.bz2` and `dev-src.tar.bz2` source archives!

DOCTOOL-INSERT-setup-dir DOCTOOL-INSERT-setup-env DOCTOOL-INSERT-ntsec DOCTOOL-INSERT-setup-files