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-ntsec
DOCTOOL-INSERT-setup-files