add Vcs entries to the control file

[debian/makedev] / MAKEDEV.man

diff --git a/MAKEDEV.man b/MAKEDEV.man
index 72fb9aad43647c54c4f0bcee9874b9e2a982cf5c..8b455b56eb9fd3e0a2ccee2177c1b373c559e2e9 100644 (file)
--- a/MAKEDEV.man
+++ b/MAKEDEV.man
@@ -1,16 +1,18 @@
-.\" $Id: MAKEDEV.man,v 2.2 1995/05/21 17:55:30 alfie Exp $
-.TH MAKEDEV 8 "14th August 1994" Linux "Linux Programmer's Manual"
+.\" $Id: MAKEDEV.man,v 3.0 2002/05/17 22:47 toff Exp $
+.TH MAKEDEV 8 "May 17 2002" Linux "Make Linux Devices"

 .SH NAME
 MAKEDEV \- create devices
 .SH SYNOPSIS
 .SH NAME
 MAKEDEV \- create devices
 .SH SYNOPSIS

-.B "cd dev; ./MAKEDEV -V"
+.B "cd /dev; ./MAKEDEV [ -n ] [ -v ] [ update ]"

 .br
 .br

-.B "cd dev; ./MAKEDEV [ -n ] [ -v ] update"
+.B "cd /dev; ./MAKEDEV [ -n ] [ -v ] [ generic ] [ local ] [ group-keyword ... device ... ]"

 .br
 .br

-.BI "cd dev; ./MAKEDEV [ -n ] [ -v ] [ -d ]" " device ..."
+.BI "cd /dev; ./MAKEDEV [ -n ] [ -v ] [ -d ]" " device ..."

 .SH DESCRIPTION
 .B MAKEDEV
 .SH DESCRIPTION
 .B MAKEDEV

-is a script that will create the devices in \fC/dev\fP used to interface
+is a script that will create the devices in 
+.B /dev
+used to interface

 with drivers in the kernel.
 .PP
 Note that programs giving the error ``ENOENT: No such file or
 with drivers in the kernel.
 .PP
 Note that programs giving the error ``ENOENT: No such file or


@@ -19,9 +21,6 @@ directory'' normally means that the device file is missing, whereas
 driver configured or loaded.
 .SH OPTIONS
 .TP
 driver configured or loaded.
 .SH OPTIONS
 .TP

-.B \-V
-Print out version (actually RCS version information) and exit.
-.TP

 .B \-n
 Do not actually update the devices, just print the actions that would be
 performed.
 .B \-n
 Do not actually update the devices, just print the actions that would be
 performed.


@@ -43,9 +42,7 @@ to reflect your site's settings.  Near the top of the file is a mapping
 from device type to user, group and permissions (e.g. all CD-ROM devices
 are set from the \fC$cdrom\fP variable).  If you wish to change the
 defaults, this is the section to edit.
 from device type to user, group and permissions (e.g. all CD-ROM devices
 are set from the \fC$cdrom\fP variable).  If you wish to change the
 defaults, this is the section to edit.

-.SH DEVICES
-.TP
-.B General Options
+.SH GENERAL OPTIONS

 .TP
 .B update
 This only works on kernels which have \fC/proc/interrupts\fP (introduced
 .TP
 .B update
 This only works on kernels which have \fC/proc/interrupts\fP (introduced


@@ -56,95 +53,246 @@ Devices which are new since then or have a different major number are
 created, and those which are no longer configured are deleted.
 .TP
 .B generic
 created, and those which are no longer configured are deleted.
 .TP
 .B generic

-Create a generic subset of devices.  This is the standard devices, plus
-floppy drives, various hard drives, pseudo-terminals, console devices,
-basic serial devices, busmice, and printer ports.
-.TP
-.B
-std
-Standard devices.
-These are:
+Create a generic subset of devices.  This subset consists of the
+standard devices, plus floppy drives, various hard drives, CD-ROM
+drives, pseudo-terminals, console devices, basic serial devices,
+busmice, audio devices, video framebuffers, printer ports, and some
+specialized devices. The generic subset varies somewhat according to
+architecture; see the 
+.B /dev/MAKEDEV
+script itself for details.
+.TP 
+.B local
+This simply runs 
+.BR MAKEDEV.local .
+This is a script that can create any local devices.
+.SH DEVICE GROUPS 
+.B MAKEDEV 
+creates groups of devices when passed keywords for the group.
+Each listing below shows the 
+.B MAKEDEV 
+keyword and then lists the devices which will be created. Many 
+devices can also be specified individually.
+.SH STANDARD DEVICES
+.TP
+.B std
+Creates this group of standard devices:

 .B mem
 .B mem

-\- acess to physical memory;
+for access to physical memory,

 .B kmem
 .B kmem

-\- access to kernel virtual memory;
+for access to kernel virtual memory,

 .B null
 .B null

-\- null device (infinite sink);
+the null device (infinite sink),

 .B port
 .B port

-\- access to I/O ports;
+for access to I/O ports,

 .B zero
 .B zero

-\- null byte source (infinite source);
-.B core
-\- symlink to /proc/kcore (for kernel debugging);
+the null byte source (infinite source),
+.BR core ,
+a symlink to /proc/kcore (for kernel debugging),

 .B full
 .B full

-\- always returns ENOSPACE on write;
-.B ram
-\- ramdisk;
+which always returns ENOSPACE on write,
+.BR random " and " urandom
+random byte generators, and

 .B tty
 .B tty

-\- to access the controlling tty of a process.
+to access the controlling tty of a process. The
+loopback disk devices
+.B loop0 
+through 
+.BR loop7 
+are also created in the 
+.B std
+group.  These allow you to use a regular file as a
+block device. A filesystem image can be mounted,
+and used as though it were a filesystem on a partition or other 
+block device.  
+.B loop
+may also be used as a separate keyword to create the 8 loop devices. Finally, the
+.B ram
+group of memory devices is also created by the 
+.B std 
+keyword (see below).
+.SH MEMORY DEVICES
+.TP
+.B ram
+This is the keyword used to generate the ramdisk devices 
+.BI ram {0..16}
+and the 
+.B ram 
+symlink. This group does not include 
+.BR initrd .
+.TP
+.B initrd
+Ramdisk which has been pre-initialized by a bootloader. 
+.B initrd
+is not created in the 
+.B ram
+group; it must be specifically included 
+in the command line if you want it to be created.
+.TP
+.IR cpu " or " microcode
+Creates the CPU microcode update interface in the 
+.B cpu/
+folder, with devices 
+.BR microcode ,
+and subfolders 
+.BR {0..3}
+each containing devices 
+.BR msr " and " cpuid .
+.TP
+.B rom
+Creates the 
+.BI rom {0..7} " rrom" {0..7} " flaxh" {0..7} 
+and
+.BI rflash {0..7}  
+flash memory card devices. 
+.BR rrom " and " rflash
+devices are read-only.
+.SH CONSOLE DEVICES
+.TP
+.B console
+This keyword creates virtual consoles;
+.BI tty {0..63}
+devices, the corresponding 
+.B vcs
+and 
+.B vcsa
+devices which are used to generate screen-dumps, and the 
+.B console 
+device itself plus appropriate symlinks.
+To create the console device alone, use 
+.BR consoleonly .
+The device 
+.B tty0 
+is the currently active virtual console. The 
+.B console
+device serves the same function.
+.SH PSEUDO TERMINALS

 .TP 
 .TP 

-.B local
-This simply runs 
-.BR MAKEDEV.local .
-This is a script that can create any local devices.
+.B pty
+This keyword creates the Pseudo-TTY masters 
+.BI pty {a..e,p..z}
+and corresponding 
+.BI tty {a..e,p..z}
+devices, along with 
+.BR ptmx . 
+Each possible argument will create a bank of 16 master and slave pairs.
+The master pseudo-terminals are 
+.BR pty{p..s}{0..9a..f} ,
+and the slaves are
+.BR tty{p..s}{0..9a..f} .
+.SH SERIAL DEVICES

 .TP
 .TP

-.B Virtual Terminals
+.I ttyS{0..63}
+Standard serial ports. There is no group keyword, you must 
+specify these individually. However 
+.BI ttyS{0..3}
+are created under the 
+.B generic
+option for most architectures.

 .TP
 .TP

-.I console
-This creates the devices associated with the console.  This is the virtual
-terminals
-.RI tty x ,
-where
-.I x
-can be from 0 though 63.  The device tty0 is the currently active vt, and
-is also known as \fCconsole\fP.  For each vt, there are two devices
-.RI vcs x
+.BR cyclades " or " ttyC
+Creates Cyclades ports 
+.BI ttyC {0..31} \fR.
+.TP
+.BR digi " or " ttyD
+Creates Digiboard serial card ports
+.BI ttyD {0..15} \fR.
+.TP
+.BR stallion " or " ttyE
+Creates Stallion devices 
+.BI ttyE {0..255} 
+and 
+.BI staliomem {0..3} \fR.
+.TP
+.BR computone " or " ttyF
+Creates CompuTone serial card ports
+.BI ttyH {0..255} 
+and special devices 
+.B ip2ipl{0,4,8,12}

 and
 and

-.RI vcsa x ,
-which are used to generate screen-dumps of the vt (the
-.BI vcs x
-is just the text,
+.BR ip2stat{1,5,9,13} \fR.
+.TP
+.BR chase " or " ttyH
+Creates Chase serial card ports
+.BI ttyH {0..15} \fR.
+.TP
+.BR isdnmodem " or " ttyI
+Creates isdn4linux virtual modem ports
+.BI ttyI {0..63} \fR.
+.TP
+.BR isdn-tty
+Also creates isdn4linux virtual modem ports
+.BI ttyI {0..7} \fR.
+.TP
+.B isdnbri
+Creates ISDN BRI driver devices
+.B isdn{0..63} isdnctrl{0..63} ippp{0..63} 

 and
 and

-.BI vcsa x
-includes the attributes).
+.BR isdninfo .

 .TP
 .TP

-.B Serial Devices
+.B isdn-io
+Also creates ISDN BRI driver devices
+.B isdn{0..7} isdnctrl{0..7} ippp{0..7} 
+and
+.BR isdninfo .
+The
+.B isdn-ippp 
+keyword can be used separately to create only the 
+.BI ippp {0..7} 
+devices.

 .TP
 .TP

-.I ttyS{0..63}
-Serial ports and corresponding dialout device.  For device
-.BI ttyS x ,
-there is also the device
-.BI cua x
-which is used to dial out with.  This can avoid the need for cooperative
-locks in simple situations.
-.TP
-.I cyclades
-Dial-in and dial-out devices for the cyclades intelligent I/O serial card.
-The dial in device is
-.BI ttyC x
-and the corresponding dial-out device is
-.BI cub x 
-By default devices for 7 lines are created, but this can be changed to
-15 by removing the comment.
-.TP
-.B Pseudo Terminals
-.TP
-.I pty[p-s]
-Each possible argument will create a bank of 16 master and slave
-pairs.  The current kernel (1.2) is limited to 64 such pairs.
-The master pseudo-terminals are 
-.BR pty[p-s][0-9a-f] ,
-and the slaves are
-.BR tty[p-s][0-9a-f] .
+.B ppp
+Creates a device independent PPP interface.

 .TP
 .TP

-.B Parallel Ports
+.B dcbri
+Creates Spellcaster DataComm/BRI ISDN card devices 
+.BR dcbri{0..3} .

 .TP
 .TP

-.I lp
-Standard parallel ports.  The devices are created 
+.BR riscom " or " ttyL
+Creates Riscom serial card ports
+.BI ttyL {0..15} \fR.
+.TP
+.BR PAM " or " ttyM
+Creates PAM multimodem (or ISI serial card) ports 
+.BI ttyM {0..15} \fR.
+.TP
+.BR ESP " or " ttyP
+Creates ESP ports 
+.BI ttyP {0..4} \fR.
+.TP
+.BR rocketport " or " ttyR
+Creates Rocketport devices
+.BI ttyR {0..63} \fR.
+.TP
+.BR ttyV
+Creates Comtrol VS-1000 serial controller ports 
+.BI ttyV {0..15} \fR.
+.TP
+.BR specialixIO8 " or " ttyW
+Creates Specialix IO8+ ports 
+.BI ttyW {0..15} \fR.
+.TP
+.BR specialix " or " ttyX
+Creates Specialix ports 
+.BI ttyX {0..15} \fR.
+.TP
+.BI i2c
+Creates 
+.BI i2c {0..7}
+devices for the I2C bus interface.
+.TP
+.BI tlk
+Philips SAA5249 Teletext signal decoder {2.6} ports 
+.BI tlk {0..3} \fR.
+.SH PARALLEL PORTS
+.TP
+.IR lp
+Creates the standard parallel ports 

 .BR lp0 , 
 .BR lp1 ,
 and 
 .BR lp0 , 
 .BR lp1 ,
 and 

-.BR lp2 .
+.BR lp2 
+normally used for printers.

 These correspond to ports at 0x3bc, 0x378 and 0x278.
 Hence, on some machines, the first printer port may actually be
 .BR lp1 .
 These correspond to ports at 0x3bc, 0x378 and 0x278.
 Hence, on some machines, the first printer port may actually be
 .BR lp1 .


@@ -152,27 +300,128 @@ Hence, on some machines, the first printer port may actually be
 .I par
 Alternative to
 .IR lp .
 .I par
 Alternative to
 .IR lp .

-Ports are named
-.BI par x
+The same ports are created, but are named
+.BI par {0..2}

 instead of
 instead of

-.BI lp x .
+.BI lp {0..2} \fR.
+.TP
+.I parport
+Creates raw parallel ports
+.BR parport0 , 
+.BR parport1 ,
+and 
+.BR parport2 .
+.TP
+.B slm
+Creates the Atari SLM ACSI laser printer (68k/Atari) ports
+.BI slm {0..3} \fR.
+.TP
+.B pg
+Parallel port generic ATAPI interface (devices 
+.BI pg {0..3} \fR.

 .TP
 .TP

-.B Bus Mice
+.B paride
+Parallel port IDE disk devices 
+.BI pd {a..d}
+with 15 partitions on each. Also creates
+.BR pcd{0..3} " and " pf{0..3} . 
+.SH OTHER BUS PORTS
+.TP
+.BR netlink " or " tap
+Creates NetLink devices 
+.B route skip fwmonitor
+and
+.BI tap {0..15} 
+Ethertap devices.
+The
+.BI tap x
+virtual ethernet device was designed as low level kernel support for
+Ethernet tunneling. Userland application can write Ethernet frame to
+.BI /dev/tapX
+and the kernel will receive this frame from tapX interface. 
+Every frame the kernel writes to a
+.BI tapX
+interface can be read by a userland application from the corresponding
+.BI /dev/tapX
+device.
+.TP 
+.B enskip
+ENskip kernel encryption package.
+.TP
+.B qng
+ComScire Quantum Noise Generator.
+.TP
+.B ipsec
+The Free S/WAN implementation of IPSEC.
+.TP 
+.B adb
+On powerpc, creates 
+.B adb
+for the Apple Data Bus and 
+.BR adbmouse .
+On m68k, 
+.B adb
+creates the ACSI disk device 
+.B adb
+and partitions
+.B adb1 
+through 
+.BR adb15 .
+.TP
+.B hamradio
+Creates the 
+.BI scc {0..7} 
+and 
+.BI bc {0..3} 
+device groups.
+.TP 
+.B comx
+Creates COMX devices
+.BI comx {0..4} \fR.
+.TP
+.B irda
+Creates IrCOMM devices (IrDA serial/parallel emulation)
+.B ircomm0 ircomm1 irlpt0
+and
+.BR irlpt1 .
+.TP
+.B comedi
+Control and Measurement devices 
+.BI comedi {0..3} \fR.
+.SH MOUSE DEVICES

 .TP
 .I busmice
 .TP
 .I busmice

-The various bus mice devices.  This creates the following devices:
-.B logimouse
+This keyword creates the following devices:
+.B logibm

 (Logitech bus mouse),
 (Logitech bus mouse),

-.B psmouse
+.B psaux

 (PS/2-style mouse),
 (PS/2-style mouse),

-.B msmouse
+.B inportbm

 (Microsoft Inport bus mouse) and
 (Microsoft Inport bus mouse) and

-.B atimouse
+.B atibm

 (ATI XL bus mouse) and
 (ATI XL bus mouse) and

-.B jmouse
+.B jbm

 (J-mouse).
 .TP
 (J-mouse).
 .TP

-.B Joystick Devices
+.I m68k-mice
+Creates mouse devices for the m68k architecture, including:
+.BR amigamouse ,
+.BR amigamouse1 ,
+.B atarimouse 
+and
+.BR adbmouse .
+.TP
+.I input
+On powerpc, this keyword creates the 
+.I input 
+folder which groups input devices
+.BR mice , 
+.BI mouse {0..3} \fR,
+.BI event {0..3} \fR,
+and 
+.BI js {0..3}
+(joystick), and creates these devices inside. 
+.SH JOYSTICK DEVICES

 .TP
 .I js
 Joystick.  Creates 
 .TP
 .I js
 Joystick.  Creates 


@@ -180,28 +429,61 @@ Joystick.  Creates
 and 
 .BR js1 .
 .TP
 and 
 .BR js1 .
 .TP

-.B Disk Devices
+.I djs
+Digital joystick. Creates 
+.B djs0
+and 
+.BR djs1 .
+.SH USB DEVICES

 .TP
 .TP

-.I fd[0-7]
+.B usb
+USB is a general purpose I/O bus which can serve many purposes. The
+.B usb
+keyword creates a 
+.B usb
+folder, and devices in the folder:
+.BI lp {0..15}
+(printer),
+.BI mouse {0..15}
+(USB connected mice),
+.BI ez {0..15}
+(firmware loaders)
+.BI scanner {0..15}
+(scanner interfaces),
+.BI ttyACM {0..15} 
+and
+.BI ttyUSB {0..15}
+(dialout devices),
+and 
+.B rio500
+the Diamond Rio 500 device. 
+.SH DISK DEVICES
+.TP
+.BI fd {0..7}

 Floppy disk devices.  The device
 .BI fd x
 Floppy disk devices.  The device
 .BI fd x

-is the device which autodetects the format, and the additional devices are
+is the device which autodetects the format, 
+and the additional devices are

 fixed format (whose size is indicated in the name).
 The other devices are named as
 fixed format (whose size is indicated in the name).
 The other devices are named as

-.BI fd xLn .
-The single letter
-.I L
-identifies the type of floppy disk (d = 5.25" DD, h = 5.25" HD, D = 3.5"
-DD, H = 3.5" HD, E = 3.5" ED).  The number
+.BI fd x{dqhu}n .
+The single letter 
+.RI ( d ,
+.IR q , 
+.IR h or 
+.IR u )
+signifies the type of drive: 5.25" Double Density (d),
+5.25" Quad Density (q), 5.25" High Density (h) or 3.5"
+(any model, u). The number

 .I n
 .I n

-represents the capacity of that format in K.  Thus the standard formats
-are
+represents the capacity of that format in K.  
+Thus the standard formats are

 .BI fd x d360 ,
 .BI fd x h1200 ,
 .BI fd x d360 ,
 .BI fd x h1200 ,

-.BI fd x D720 ,
-.BI fd x H1440 ,
+.BI fd x 720 ,
+.BI fd x 1440 ,

 and
 and

-.RI fd x E2880 .
+.BI fd x 2880 .

 .IP
 For more information see Alain Knaff's fdutils package.
 .IP
 .IP
 For more information see Alain Knaff's fdutils package.
 .IP


@@ -215,12 +497,16 @@ through
 .BI fd7 *
 are floppy disks on the second controller.
 .TP
 .BI fd7 *
 are floppy disks on the second controller.
 .TP

-.I hd[a-d]
-AT hard disks.  The device
+.BI fd {0..7} -bare
+Creates just the autodetecting floppy device specified, without the fixed 
+format devices.
+.TP
+.BI hd {a..l}
+AT (ide) hard disks.  The device

 .BI hd x
 provides access to the whole disk, with the partitions being
 .BI hd x
 provides access to the whole disk, with the partitions being

-.BI hd x [0-20].
-The four primary partitions are
+.BI hd x {1..63}.
+For i386, the four primary partitions are

 .BI hd x 1
 through
 .BI hd x 4,
 .BI hd x 1
 through
 .BI hd x 4,


@@ -228,95 +514,237 @@ with the logical partitions being numbered from
 .BI hd x 5
 though
 .BI hd x 20.
 .BI hd x 5
 though
 .BI hd x 20.

-(A primary partition can be made into an extended partition, which can hold
-4 logical partitions).
-By default, only the devices for 4 logical partitions are made.  The
-others can be made by uncommenting them.
+(A primary partition can be made into an extended partition, which can
+hold 4 logical partitions). Other architectures may not differentiate
+partition types.  By default, devices for 20 logical partitions are
+made. The kernel supports up to 63 partitions per device.

 .IP
 .IP

-Drives hda and hdb are the two on the first controller.  If using the new
-IDE driver (rather than the old HD driver), then hdc and hdd are the two
+Drives 
+.B hda 
+and  
+.B hdb 
+are the two on the primary controller
+.B hdc 
+and
+.B hdd 
+are the two

 drives on the secondary controller.  These devices can also be used to
 drives on the secondary controller.  These devices can also be used to

-acess IDE CDROMs if using the new IDE driver.
+access IDE CDROMs. Additional devices 
+.BI hd {e..l} 
+can be created.

 .TP
 .TP

-.I xd[a-d] 
-XT hard disks.  Partitions are the same as IDE disks.
+.BI xd {a..d} 
+XT hard disks.  Partitions are the same as IDE disks, except only 8 
+partitions are created. 

 .TP
 .TP

-.I sd[a-h]
+.BI sd {a..h}

 SCSI hard disks.  The partitions are similar to the IDE disks, but there
 is a limit of 11 logical partitions
 SCSI hard disks.  The partitions are similar to the IDE disks, but there
 is a limit of 11 logical partitions

-.RI (sd x 5
+.BI sd x 5

 through
 through

-.RI sd x 15).
-This is to allow there to be 8 SCSI disks.
+.BI sd x 15, 
+to allow there to be 8 SCSI disks on a system 
+(addresses 0 through 7). 

 .TP
 .TP

-.I loop
-Loopback disk devices.  These allow you to use a regular file as a
-block device.  This means that images of filesystems can be mounted,
-and used as normal.  This creates 8 devices loop0 through loop7.
+.BI sd {i..z} 
+and 
+.BI sd {a..d}{a..z}
+The kernel (and MAKEDEV) can handle up to 128 SCSI disks (up to 
+.BR sddx ).
+15 partition devices are created for each.
+.TP
+.B eda edb
+MCA ESDI hard disk. Partitions are handled the same as hd.
+.TP
+.BI dasd {a..z}
+Direct Access Storage Devices for the s390 architecture. Currently
+only one device partition is created (for example, 
+.BR dasda1 ).
+.TP
+.BI ada {a..p}
+ACSI disk (68k/Atari). 15 partitions are created for each.
+.TP
+.BI dac960. {0..7} 
+Mylex DAC960 PCI RAID controller. For this device, an 
+.B rd
+directory is created. 32 logical devices
+.BI c x d {0..31}
+are created for each unit 
+.I x
+specified, each with 7 partitions 
+.BI c x d {0..31} p {1..7} \fR.
+The 
+.B dac960
+keyword will create all 7 units at once.

 .TP
 .TP

-.B Tape Devices
+.BI dpti
+Adaptec I2O RAID and DPT SmartRAID V I2O controllers. Creates
+7 devices for handling up to 7 controllers.

 .TP
 .TP

-.I st[0-7]
-SCSI tapes.  This creates the rewinding tape device
+.BI ataraid. {0..7} 
+Obsolete, device not in current devices.txt. For this device, an 
+.B ataraid
+directory is created. 
+.BI d x 
+is created for each unit 
+.I x
+specified, and 15 partitions 
+.BI d x p {1..15} \fR.
+The 
+.B ataraid
+keyword will create all 7 units at once.
+.TP
+.BI i2o.hd{a..d}{a..z}
+I2O based harddisk drives. Device nodes are located in the
+.B i2o
+directory. The filename is followed by a number that specifies the partition on
+each disk. The numbers are handled the same as hd.
+.TP
+.BI ida. {0..7} 
+Compaq Intelligent Drive Array. For this device, an 
+.B ida
+directory is created. 16 logical devices
+.BI c x d {0..15}
+are created for each unit 
+.I x
+specified, each with 15 partitions 
+.BI c x d {0..15} p {1..15} \fR.
+The 
+.B ida
+keyword will create the first three units.
+.TP
+.BI cciss. {0..7} 
+Compaq Next Generation Drive Array. For this device, a
+.B cciss
+directory is created. 16 logical devices
+.BI c x d {0..15}
+are created for each unit 
+.I x
+specified, each with 15 partitions 
+.BI c x d {0..15} p {1..15} \fR.
+The 
+.B cciss
+keyword will create the first three units.
+.TP
+.BI md
+Creates Metadisk (RAID) disk array with 16 devices.
+.SH TAPE DEVICES
+.TP
+.I st{0..7}
+SCSI tape devices.  This creates the rewinding tape device

 .BI st x
 and the non-rewinding tape device
 .BI st x
 and the non-rewinding tape device

-.BI nst x .
+.BI nst x ,
+for each of modes 0 through 3.

 .TP
 .I qic
 .TP
 .I qic

-QIC-80 tapes.  The devices created are
+QIC-11, -24, -120, and -150 tapes.  The devices created are
+.B ntpqic11 tpqic11 ntpqic24 tpqic24 ntpqic120 tpqic120 ntpqic150
+and 
+.B tpqic150
+tape devices, along with

 .BR rmt8 ,
 .BR rmt16 ,
 .BR tape-d ,
 and
 .BR tape-reset .
 .TP
 .BR rmt8 ,
 .BR rmt16 ,
 .BR tape-d ,
 and
 .BR tape-reset .
 .TP

-.I ftape
+.I ftape               

 Floppy driver tapes (QIC-117).  There are 4 methods of access depending on
 the floppy tape drive.  For each of access methods 0, 1, 2 and 3, the
 devices
 Floppy driver tapes (QIC-117).  There are 4 methods of access depending on
 the floppy tape drive.  For each of access methods 0, 1, 2 and 3, the
 devices

-.BI rft x
+.BI qft x
+.BI zqft x
+and
+.BI rawqftx

 (rewinding) and
 (rewinding) and

-.BI nrft x
-(non-rewinding) are created.  For compatability, devices
+.BI nqft x
+.BI nzqft x
+.BI nrawqdt x
+(non-rewinding) are created.  For compatibility, devices

 .B ftape
 and
 .B nftape
 are symlinks to
 .B ftape
 and
 .B nftape
 are symlinks to

-.B rft0
+.B qft0

 and
 and

-.B nrft0
+.B nqft0

 respectively.
 .TP
 respectively.
 .TP

-.B CDROM Devices
+.B ht0
+Creates IDE tape devices 
+.B ht0
+and
+.BR nht0 .
+.TP
+.BI pt {0..3}
+Creates parallel port ATAPI tape devices
+.B pt{0..3}
+and
+.BR npt{0..3} .
+.SH CDROM DEVICES
+.TP
+.BR sr " or " scd " or " scd-all
+Creates 
+.BI scd {0..16}
+SCSI CD players and 
+.BI sr {0..16}
+symlinks for these devices.
+.B cdrom 
+is a symlink which can be created by the user to the active CD device.
+It is not created by 
+.BR MAKEDEV .
+.TP
+.B pktcdvd
+Provides packet writing devices 
+.BI pktcdvd {0..3}
+for CD/DVD.

 .TP
 .TP

-.I scd[0-7]
-SCSI CD players.
+.I pcd{0..3}
+Parallel port ATAPI CD-ROM devices

 .TP
 .TP

-.I sonycd
-Sony CDU-31A CD player.
+.I sonycd 
+Sony CDU-31a CD-ROM

 .TP
 .TP

-.I mcd
-Mitsumi CD player.
+.I mcd 
+Mitsumi CD-ROM
+.TP
+.I mcdx
+Obsolete, device not in current devices.txt.

 .TP
 .I cdu535
 .TP
 .I cdu535

-Sony CDU-535 CD player.
+Sony CDU-535 CD-ROM
+.TP
+.IR lmscd
+Philips LMS CM-205 CD-ROM. The newer name for this device is 
+.IR cm205 ,
+but MAKEDEV creates only lmscd at this time.
+.TP
+.I cm206cd
+Philips LMS CM-206 CD-ROM
+.TP
+.I bpcd
+MicroSolutions BackPack parallel port CD-ROM (Obsolete - use pcd)
+.TP
+.I sbpcd{0..15}
+Matsushita (Panasonic/SoundBlaster) CD-ROM. Units {0..3} are created with the keyword
+.BR sbpcd .

 .TP
 .TP

-.I lmscd
-LMS/Philips CD player.
+.I aztcd
+Aztech/Orchid/Okano/Wearnes CD-ROM

 .TP
 .TP

-.I sbpcd{,1,2,3}
-Sound Blaster CD player.  The kernel is capable of supporting 16 CDROMs,
-each of which is accessed as
-.BR sbpcd[0-9a-f] .
-These are assigned in groups of 4 to each controller.
-.B sbpcd
-is a symlink to
-.BR sbpcd0 .
-.\" .TP
-.\" .I idecd
-.\" NEC CDR-260 (note: this will probably be obsoleted by the new IDE driver).
+.I gscd 
+GoldStar CD-ROM

 .TP
 .TP

-.B Scanner
+.I optcd
+Optics Storage CD-ROM
+.TP
+.I sjcd
+Sanyo CD-ROM
+.TP
+.I hitcd
+Hitachi CD-ROM
+.SH SCANNERS

 .TP
 .I logiscan
 Logitech ScanMan32 & ScanMan 256.
 .TP
 .I logiscan
 Logitech ScanMan32 & ScanMan 256.


@@ -326,34 +754,105 @@ Mustek M105 Handscanner.
 .TP
 .I ac4096
 A4Tek Color Handscanner.
 .TP
 .I ac4096
 A4Tek Color Handscanner.

-.TP
-.B Audio
+.SH AUDIO DEVICES

 .TP
 .I audio
 This creates the audio devices used by the sound driver.  These include
 .TP
 .I audio
 This creates the audio devices used by the sound driver.  These include

-.BR mixer ,
-.BR sequencer ,
-.BR dsp ,
+.B mixer mixer{1..3}
+(Mixer controls), 
+.B sequencer
+(Audio sequencer),
+.B dsp dsp{1..3}
+(Digital audio),
+.B sndstat
+(Sound card status information),
+.B audioctl
+(SPARC audio control device)

 and
 and

-.BR audio .
+.B audio audio{1..3} 
+(Sun-compatible digital audio). MIDI devices are 
+.B midi00
+through
+.BR midi03 ,
+.BI midi {0..3} \fR,
+.BI rmidi {0..3} \fR,
+.BI smpte {0..3} \fR.
+In addition, devices 
+.B mpu401data
+and
+.B mpu401stat
+are created.

 .TP
 .I pcaudio
 Devices for the PC Speaker sound driver.  These are
 .TP
 .I pcaudio
 Devices for the PC Speaker sound driver.  These are

-.BR pcmixer .
+.BR pcmixer ,

 .BR pxsp ,
 and
 .BR pcaudio .
 .BR pxsp ,
 and
 .BR pcaudio .

+.SH VIDEO DEVICES
+.TP
+.B fb
+Creates framebuffer devices
+.BI fb {0..7} \fR,
+.BI fb {0..7} current \fR,
+.BI fb {0..7} autodetect \fR.

 .TP
 .TP

-.B Miscellaneous
+.B fb{0..7}
+If the framebuffer number 
+.I x 
+is specifed, a group of  
+.BI fb x user {0..7} 
+devices is created.

 .TP
 .TP

-.I sg
+.B 3dfx
+is the 3Dfx Voodoo Graphics device.
+.TP
+.B agpgart
+AGP Graphics Address Remapping Table
+.TP
+.I "video video4linux v4l radio"
+Each of these keywords produces the same result:
+Video capture/overlay devices
+.BI video {0..63} \fR,
+Radio devices
+.BI radio {0..63} \fR,
+Teletext devices 
+.BI vtx {0..31} \fR,
+and Vertical blank interrupt devices
+.BI vbi {0..31} \fR. 
+In addition, the 
+.BR winradio0 " and " winradio1 " devices,"
+and 
+.BR vtx " and " vttuner " devices,"
+and symlinks
+.BR "radio video" " and " vbi
+are created. 
+.TP
+.BI srnd
+miroMEDIA Surround board devices 
+.BR srnd0 " and " srnd1 .
+.TP
+.B fgrab
+Matrox Meteor frame grabber {2.6}. Creates 
+.BR mmetfgrab ,
+.BR wvisfgrab ,
+.BR iscc0 ,
+.BR iscc1 ,
+.BR isccctl0 ,
+.BR isccctl1 ,
+.BR dcxx0 ,
+and
+.BR dcxx1 .
+.SH MISCELLANEOUS DEVICES
+.TP
+.IR sg " or " sg-all

 Generic SCSI devices.  The devices created are 
 Generic SCSI devices.  The devices created are 

-.B sg0 through 
-.BR sg7 .
-These
-allow arbitary commands to be sent to any SCSI device.  This allows for
-querying information about the device, or controlling SCSI devices that
-are not one of disk, tape or CDROM (e.g. scanner, writeable CDROM).
+.B sg0 
+through 
+.BR sg16 .
+These allow arbitary commands to be sent to any SCSI device, to query
+information or control SCSI devices that are not disk, tape or CDROM
+(for example, scanner or writeable CDROM).

 .TP
 .I fd
 To allow an arbitary program to be fed input from file descriptor
 .TP
 .I fd
 To allow an arbitary program to be fed input from file descriptor


@@ -361,17 +860,22 @@ To allow an arbitary program to be fed input from file descriptor
 use
 .BI /dev/fd/ x
 as the file name.  This also creates 
 use
 .BI /dev/fd/ x
 as the file name.  This also creates 

-BR /dev/stdin ,
-BR /dev/stdout ,
+.BR /dev/stdin ,
+.BR /dev/stdout ,

 and
 and

-BR /dev/stderr .
+.BR /dev/stderr .

 (Note, these are just symlinks into /proc/self/fd).
 .TP
 .I ibcs2
 (Note, these are just symlinks into /proc/self/fd).
 .TP
 .I ibcs2

-Devices (and symlinks) needed by the IBCS2 emulation.
+Devices 
+.B socksys spx 
+(and symlinks 
+.BR "nfsd XOR" ) 
+needed by the IBCS2 emulation.

 .TP
 .I apm
 .TP
 .I apm

-Devices for power management.
+.B apm_bios 
+Advanced Power Management BIOS device.

 .TP
 .I dcf
 Driver for DCF-77 radio clock.
 .TP
 .I dcf
 Driver for DCF-77 radio clock.


@@ -379,12 +883,351 @@ Driver for DCF-77 radio clock.
 .I helloworld
 Kernel modules demonstration device.  See the modules source.
 .TP
 .I helloworld
 Kernel modules demonstration device.  See the modules source.
 .TP

+.BR xfs " or " arla
+Arla XFS network file system.
+.TP
+.B capi
+CAPI 2.0 interface ports
+.BI capi20 {01..20} \fR.
+.TP
+.B ubd
+User-mode block devices
+.BI ubd {0..255} \fR.
+.TP
+.BI nb {0..7}
+Network block devices.
+.TP 
+.B raw
+Creates the raw block device interface 
+.B raw
+device, the 
+.B rawctl 
+symlink, and 
+.BI raw {1..8} \fR.
+.TP
+.B raw1394
+IEEE 1394 (Firewire).
+.TP
+.B misc
+This keyword creates all the following devices. You may find the 
+device explanations in other categories in this man page, many 
+under OTHER DEVICES below.
+.BR logibm ,
+.BR psaux ,
+.BR inportbm ,
+.BR atibm ,
+.BR jbm ,
+.BR amigamouse ,
+.BR atarimouse ,
+.BR sunmouse ,
+.BR amigamouse1 ,
+.BR smouse ,
+.BR pc110pad ,
+.BR adbmouse ,
+.BR beep ,
+.BR modreq ,
+.BR watchdog ,
+.BR temperature ,
+.BR hwtrap ,
+.BR exttrp ,
+.BR apm_bios ,
+.BR rtc ,
+.BR openprom ,
+.BR relay8 ,
+.BR relay16 ,
+.BR msr ,
+.BR pciconf ,
+.BR nvram ,
+.BR hfmodem ,
+.BR led ,
+.BR mergemem ,
+.BR pmu .
+.TP

 .B "Network Devices"
 Linux used to have devices in /dev for controlling network devices, but
 that is no longer the case.  To see what network devices are known by the
 kernel, look at /proc/net/dev.
 .B "Network Devices"
 Linux used to have devices in /dev for controlling network devices, but
 that is no longer the case.  To see what network devices are known by the
 kernel, look at /proc/net/dev.

+.SH OTHER DEVICES
+.TP
+Many of these devices are architecture-specific.
+.TP
+.I scc
+Z8530 HDLC driver (HAM radio)
+.TP
+.I bc
+Baycom radio modem (HAM radio)
+.TP
+.IR cfs0 " or " cfs " or " coda
+Coda network file system
+.TP
+.I sunmouse 
+Sun mouse
+.TP
+.I smouse 
+Simple serial mouse driver
+.TP
+.I pc110pad 
+IBM PC-110 digitizer pad
+.TP
+.I vrtpanel 
+Vr41xx embedded touch panel
+.TP
+.I vpcmouse
+Connectix Virtual PC Mouse
+.TP
+.I beep
+Fancy beep device
+.TP
+.I modreq
+Kernel module load request {2.6}
+.TP
+.I watchdog
+Watchdog timer port
+.TP
+.I temperature
+Machine internal temperature
+.TP
+.I hwtrap
+Hardware fault trap
+.TP
+.I exttrp
+External device trap
+.TP
+.I rtc
+Real Time Clock
+.TP
+.I efirtc
+Real Time Clock
+.TP
+.I openprom
+SPARC OpenBoot PROM
+.TP
+.I relay8
+Berkshire Products Octal relay card
+.TP
+.I relay16
+Berkshire Products ISO-16 relay card
+.TP
+.I msr 
+x86 model-specific registers {2.6}
+.TP
+.I pciconf
+PCI configuration space
+.TP
+.I nvram
+Non-volatile configuration RAM
+.TP
+.I hfmodem
+Soundcard shortwave modem control {2.6}
+.TP
+.I graphics
+Linux/SGI graphics device
+.TP
+.I opengl
+Linux/SGI OpenGL pipe
+.TP
+.I gfx
+Linux/SGI graphics effects device
+.TP
+.I lcd
+Front panel LCD display
+.TP
+.I led
+Front panel LEDs
+.TP
+.I mergemem
+Memory merge device
+.TP
+.I pmu
+Macintosh PowerBook power manager
+.TP
+.I isictl
+MultiTech ISICom serial control
+.TP
+.I ac
+Applicom Intl Profibus card
+.TP
+.I nwbutton
+Netwinder external button
+.TP
+.I nwdebug
+Netwinder debug interface
+.TP
+.I nwflash
+Netwinder flash memory
+.TP
+.I userdma
+User-space DMA access
+.TP
+.I smbus
+System Management Bus
+.TP
+.I lik
+Logitech Internet Keyboard
+.TP
+.I ipmo
+Intel Intelligent Platform Management
+.TP
+.I vmmon
+VMWare virtual machine monitor
+.TP
+.I tcldrv
+Technology Concepts serial control
+.TP
+.I specialix_sxctl
+Specialix serial control
+.TP
+.I specialix_rioctl
+Specialix RIO serial control
+.TP
+.IR smapi " or " thinkpad
+IBM Thinkpad 
+.B smapi
+device, and a symlink 
+.BR thinkpad .
+.TP
+.I srripc
+QNX4 API IPC manager
+.TP
+.I usemaclone
+Semaphore clone device
+.TP
+.IR ipmi " or " ipmikcs
+Intelligent Platform Management
+.TP
+.I uctrl
+SPARCbook 3 microcontroller
+.TP
+.I gtrsc
+Gorgy Timing radio clock
+.TP
+.I cbm
+Serial CBM bus
+.TP
+.I jsflash
+JavaStation OS flash SIMM
+.TP
+.I xsvc
+High-speed shared-mem/semaphore service
+.TP
+.I vrbuttons
+Vr41xx button input device
+.TP
+.I toshiba
+Toshiba laptop SMM support
+.TP
+.I perfctr
+Performance-monitoring counters
+.TP
+.I intel_rng
+Intel i8x0 random number generator
+.TP
+.I atomicps
+Atomic shapshot of process state data
+.TP
+.I irnet
+IrNET device
+.TP
+.I smbusbios
+SMBus BIOS
+.TP
+.I ussp_ctl
+User space serial port control
+.TP
+.I crash
+Mission Critical Linux crash dump facility
+.TP
+.I nas_xbus
+NAS xbus LCD/buttons access
+.TP
+.I d7s
+SPARC 7-segment display
+.TP
+.I zkshim
+Zero-Knowledge network shim control
+.TP
+.I sexec
+Signed executable interface
+.TP
+.I kchuid
+Inter-process chuid control
+.TP
+.I mptctl
+Message passing technology (MPT) control
+.TP
+.I button/gulpb
+Transmeta GULP-B buttons
+.TP
+.I compaq/cpqphpc
+Compaq PCI Hot Plug Controller
+.TP
+.I compaq/cpqrid
+Compaq Remote InsightDriver
+.TP
+.I elographics/e2201
+Elographics touchscreen E271-2201
+.TP
+.I fujitsu/apanel
+Fujitsu/Siemens application panel
+.TP
+.I i2o/ctl
+I2O configuration manager
+.TP
+.I impi/bt
+IMPI coprocessor block transfer
+.TP
+.I impi/smic
+IMPI coprocessor stream interface
+.TP
+.I input/mouse
+Linux/SGI Irix emulation mouse
+.TP
+.I input/keyboard
+Linux/SGI Irix emulation keyboard
+.TP
+.I modems/mwave
+MWave modem firmware upload
+.TP
+.I mvista/hssdsi
+Montavista PICMG hot swap system driver
+.TP
+.I mvista/hasi
+Montavista PICMG high availability
+.TP
+.I net/tun
+TAP/TUN network device
+.TP
+.I ni/natmotn
+National Instruments Motion
+.TP
+.I scanners/cuecat 
+:CueCat barcode scanner
+.TP
+.I touchscreen/ucb1x00
+UCB 1x00 touchscreen
+.TP
+.I touchscreen/mk712
+MK712 touchscreen
+.TP
+.I video/em8300
+EM8300 DVD decoder control
+.TP
+.I video/em8300_mv
+EM8300 DVD decoder video
+.TP
+.I video/em8300_ma
+EM8300 DVD decoder audio
+.TP
+.I video/em8300_sp
+EM8300 DVD decoder subpicture
+.TP
+.I watchdogs/{0..3}
+Watchdog devices 0 through 3
+

 .SH "SEE ALSO"
 Linux Allocated Devices, maintained by H.\ Peter Anvin,
 .SH "SEE ALSO"
 Linux Allocated Devices, maintained by H.\ Peter Anvin,

-<Peter.Anvin@linux.org>.
+<Peter.Anvin@linux.org>, and devices.txt in the Linux 
+kernel source.

 .SH AUTHOR
 .SH AUTHOR

-Nick Holloway, <Nick.Hollowa
\ No newline at end of file
+Nick Holloway, rewritten and updated by Chris Tillman
+