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 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-setup-files