drew
/
acadia-newlib
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

* pathnames.sgml: Cleanup raw device text to be more coherent.

This commit is contained in:
Corinna Vinschen 2001-10-16 16:03:22 +00:00
parent 7b46bb01e1
commit 0aa019b960
2 changed files with 29 additions and 24 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
winsup/doc/ChangeLog
View File

@ -1,3 +1,7 @@
Tue Oct 16 18:02:00 2001 Corinna Vinschen <corinna@vinschen.de>
* pathnames.sgml: Cleanup raw device text to be more coherent.
Tue Oct 16 17:14:00 2001 Corinna Vinschen <corinna@vinschen.de> Tue Oct 16 17:14:00 2001 Corinna Vinschen <corinna@vinschen.de>
* pathnames.sgml: Add description for new fixed device paths. * pathnames.sgml: Add description for new fixed device paths.

49
winsup/doc/pathnames.sgml
View File

@ -201,33 +201,35 @@ These devices cannot be seen with the command <command>ls /dev</command>
although commands such as <command>ls /dev/tty</command> work fine. although commands such as <command>ls /dev/tty</command> work fine.
</para> </para>
<para>However, on Windows NT/W2K there are different devices which are <para>Windows NT/W2K/XP additionally support raw devices like floppies,
supported but have to be created as mount points. These are the raw block disks, partitions and tapes. These are accessed from Cygwin applications
special devices and tape devices. These devices need a special handling using POSIX device names which are supported in two different ways.
which is enabled through the mount points. The usage of the native Windows Up to 1.3.3, Cygwin only uses Win32 device names, since 1.3.4
device names is not sufficent. it additionally uses NT internal device names.
</para> </para>
<para>NT/W2K supports raw block special device support for partitions <para>Up to Cygwin 1.3.3 the only way to access those devices is
and drives. The Win32 device name for a partition is the drive letter to mount the Win32 device names to a POSIX device name.
</para>
<para>
The Win32 device name for a partition is the drive letter
with leading <filename>\\.\</filename>, so the floppy would be with leading <filename>\\.\</filename>, so the floppy would be
<filename>\\.\A:</filename>, the first partition typically <filename>\\.\A:</filename>, the first partition typically
<filename>\\.\C:</filename>. Complete drives (except floppies <filename>\\.\C:</filename>. Complete drives (except floppies and CD-ROMS
which are supported as partitions only) are named which are supported as partitions only) are named
<filename>\\.\PHYSICALDRIVEx</filename>. The <literal>x</literal> <filename>\\.\PHYSICALDRIVEx</filename>. The <literal>x</literal>
is the drive number which you can check in the disk manager. is the drive number which you can check in the disk manager.
Each drive line has prepended the text "Disk x". Each drive line has prepended the text "Disk x".
</para> </para>
<para>To access tape drives, NT/W2K uses the Win32 file name <para>To access tape drives the Win32 file name <filename>\\.\TAPEx</filename>
<filename>\\.\TAPEx</filename>. For example the first installed tape device is used. For example the first installed tape device is named
is named <filename>\\.\tape0</filename>. <filename>\\.\tape0</filename>.
</para> </para>
<para>Up to Cygwin 1.3.3 this is the only way to use those devices. <para>
To access them you have to mount them and you have to use the posix The naming convention is simple: The name of the POSIX device has to begin with
name of the device to be recognized by Cygwin.
The naming convention is simple: The name has to begin with
<filename>/dev/</filename> and the rest is as you like. The only <filename>/dev/</filename> and the rest is as you like. The only
exception are tape devices. To identify if the tape device is exception are tape devices. To identify if the tape device is
used as a rewind or a no-rewind device the name must not begin with used as a rewind or a no-rewind device the name must not begin with
@ -250,21 +252,20 @@ file I/O is in "binary mode".
</para> </para>
<para> <para>
NT knows another way of accessing these devices. In the internal NT Since Cygwin 1.3.4 raw devices are accessible from inside of Cygwin processes
namespace the devices are using different names. The Win32 names are using fixed POSIX device names. That means, you don't have to mount the devices
only a sort of symbolic link to the NT internal device name. anymore which results in a more cleaner mount table.
</para>
<para>
These new fixed POSIX device names are generated using a direct conversion
from the POSIX namespace to the internal NT namespace.
E.g. the first harddisk is the NT internal device \device\harddisk0\partition0 E.g. the first harddisk is the NT internal device \device\harddisk0\partition0
or the first partition on the third harddisk is \device\harddisk2\partition1. or the first partition on the third harddisk is \device\harddisk2\partition1.
The first floppy in the system is \device\floppy0, the first CD-ROM is The first floppy in the system is \device\floppy0, the first CD-ROM is
\device\cdrom0 and the first tape drive is \device\tape0. \device\cdrom0 and the first tape drive is \device\tape0.
</para> </para>
<para>
Since Cygwin 1.3.4 these devices are accessible from inside of Cygwin processes
using fixed device names. That means, you don't have to mount the devices
anymore which results in a more cleaner mount table.
</para>
<para>The new fixed POSIX names are mapped to NT internal devices as <para>The new fixed POSIX names are mapped to NT internal devices as
follows:</para> follows:</para>