diff --git a/winsup/doc/ChangeLog b/winsup/doc/ChangeLog index 994b796ef..c1f207b94 100644 --- a/winsup/doc/ChangeLog +++ b/winsup/doc/ChangeLog @@ -1,3 +1,7 @@ +2004-03-26 Joshua Daniel Franklin + * cygwinenv.sgml: Add example for CYGWIN=error_start. + * pathnames.sgml: Update list of /dev/ devices. + 2004-02-22 Joshua Daniel Franklin * Makefile.in: Fix problem links in faq0.html file. * what.texinfo: Remove outdated 'recent' history. diff --git a/winsup/doc/cygwinenv.sgml b/winsup/doc/cygwinenv.sgml index b9d9af394..1ebd770df 100644 --- a/winsup/doc/cygwinenv.sgml +++ b/winsup/doc/cygwinenv.sgml @@ -20,8 +20,6 @@ for redirection from the Windows command shell. It will also affect the default translation mode of a pipe, although most shells set the pipe to binary by default. -Warning!If set in 12/98 b20.1, all files -always open in binary mode. check_case:level - Controls the behaviour of @@ -81,11 +79,15 @@ settings are re-exported to the environment as CYGWIN again. Defaults to off. -error_start:filepath - if set, runs -filepath when cygwin encounters a fatal error. This is -useful for debugging. filepath is usually set to the path -to the gdb or dumper program. -There is no default set. + +error_start:Win32filepath - if set, runs +Win32filepath when cygwin encounters a fatal error, +which is useful for debugging. Win32filepath is +usually set to the path to gdb or +dumper, for example +C:\cygwin\bin\gdb.exe. +There is no default set. + forkchunk:32768 - causes fork() diff --git a/winsup/doc/pathnames.sgml b/winsup/doc/pathnames.sgml index 61e374f08..93b492281 100644 --- a/winsup/doc/pathnames.sgml +++ b/winsup/doc/pathnames.sgml @@ -156,16 +156,28 @@ default printer with the command cat filename > PRN POSIX devices There is no need to create a POSIX /dev -directory as it is simulated within Cygwin automatically. -It supports the following devices: /dev/null, -/dev/zero, /dev/tty, -/dev/ttyX, /dev/ptmx, -/dev/comX (the serial ports), -/dev/windows (the windows message queue), -/dev/random and /dev/urandom. -These devices cannot be seen with the command ls /dev +directory as Cygwin automatically simulates it internally. +These devices cannot be seen with the command ls /dev/ although commands such as ls /dev/tty work fine. + +Cygwin supports the following devices commonly found on POSIX systems: +/dev/dsp, /dev/null, +/dev/zero, /dev/console, +/dev/tty, /dev/ttym, +/dev/ttyX, /dev/ttySX, +/dev/pipe, /dev/port, +/dev/ptmx, /dev/mem, +/dev/random, and /dev/urandom. +Cygwin also has several Windows-specific devices: +/dev/comX (the serial ports, starting with +COM1 which is the same as ttyS0), +/dev/conin (Windows CONIN$), +/dev/conout (Windows CONOUT$), +/dev/clipboard (the Windows clipboard, currently +text only), and +/dev/windows (the Windows message queue). + Windows NT/W2K/XP additionally support raw devices like floppies, disks, partitions and tapes. These are accessed from Cygwin applications @@ -232,6 +244,7 @@ ln -s /dev/nst0 /dev/tape ... + Note that you can't use the mount table to map from fixed device name to your own device name or to map from internal NT device name to @@ -241,10 +254,11 @@ The following three examples will not work as expected: -mount -f -b /dev/nst0 /dev/tape +mount -f -b /dev/nst0 /dev/tape mount -f -b /device/tape0 /dev/tape ln -s /device/tape0 /dev/tape +