Imported Debian patch 2.3.1-86
[debian/makedev] / MAKEDEV.man
1 .\" $Id: MAKEDEV.man,v 3.0 2002/05/17 22:47 toff Exp $
2 .TH MAKEDEV 8 "May 17 2002" Linux "Make Linux Devices"
3 .SH NAME
4 MAKEDEV \- create devices
5 .SH SYNOPSIS
6 .B "cd /dev; ./MAKEDEV [ -n ] [ -v ] [ update ]"
7 .br
8 .B "cd /dev; ./MAKEDEV [ -n ] [ -v ] [ generic ] [ local ] [ group-keyword ... device ... ]"
9 .br
10 .BI "cd /dev; ./MAKEDEV [ -n ] [ -v ] [ -d ]" " device ..."
11 .SH DESCRIPTION
12 .B MAKEDEV
13 is a script that will create the devices in 
14 .B /dev
15 used to interface
16 with drivers in the kernel.
17 .PP
18 Note that programs giving the error ``ENOENT: No such file or
19 directory'' normally means that the device file is missing, whereas
20 ``ENODEV: No such device'' normally means the kernel does not have the
21 driver configured or loaded.
22 .SH OPTIONS
23 .TP
24 .B \-n
25 Do not actually update the devices, just print the actions that would be
26 performed.
27 .TP
28 .B \-d
29 Delete the devices.  The main use for this flag is by
30 .B MAKEDEV
31 itself.
32 .TP
33 .B \-v
34 Be verbose.  Print out the actions as they are performed.  This is the
35 same output as produced by
36 .BR \-n .
37 .SH CUSTOMISATION
38 Since there is currently no standardisation in what names are used for
39 system users and groups, it is possible that you may need to modify
40 .B MAKEDEV
41 to reflect your site's settings.  Near the top of the file is a mapping
42 from device type to user, group and permissions (e.g. all CD-ROM devices
43 are set from the \fC$cdrom\fP variable).  If you wish to change the
44 defaults, this is the section to edit.
45 .SH GENERAL OPTIONS
46 .TP
47 .B update
48 This only works on kernels which have \fC/proc/interrupts\fP (introduced
49 during 1.1.x).  This file is scanned to see what devices are currently
50 configured into the kernel, and this is compared with the previous
51 settings stored in the file called \fCDEVICES\fP.
52 Devices which are new since then or have a different major number are
53 created, and those which are no longer configured are deleted.
54 .TP
55 .B generic
56 Create a generic subset of devices.  This subset consists of the
57 standard devices, plus floppy drives, various hard drives, CD-ROM
58 drives, pseudo-terminals, console devices, basic serial devices,
59 busmice, audio devices, video framebuffers, printer ports, and some
60 specialized devices. The generic subset varies somewhat according to
61 architecture; see the 
62 .B /dev/MAKEDEV
63 script itself for details.
64 .TP 
65 .B local
66 This simply runs 
67 .BR MAKEDEV.local .
68 This is a script that can create any local devices.
69 .SH DEVICE GROUPS 
70 .B MAKEDEV 
71 creates groups of devices when passed keywords for the group.
72 Each listing below shows the 
73 .B MAKEDEV 
74 keyword and then lists the devices which will be created. Many 
75 devices can also be specified individually.
76 .SH STANDARD DEVICES
77 .TP
78 .B std
79 Creates this group of standard devices:
80 .B mem
81 for access to physical memory,
82 .B kmem
83 for access to kernel virtual memory,
84 .B null
85 the null device (infinite sink),
86 .B port
87 for access to I/O ports,
88 .B zero
89 the null byte source (infinite source),
90 .BR core ,
91 a symlink to /proc/kcore (for kernel debugging),
92 .B full
93 which always returns ENOSPACE on write,
94 .BR random " and " urandom
95 random byte generators, and
96 .B tty
97 to access the controlling tty of a process. The
98 loopback disk devices
99 .B loop0 
100 through 
101 .BR loop7 
102 are also created in the 
103 .B std
104 group.  These allow you to use a regular file as a
105 block device. A filesystem image can be mounted,
106 and used as though it were a filesystem on a partition or other 
107 block device.  
108 .B loop
109 may also be used as a separate keyword to create the 8 loop devices. Finally, the
110 .B ram
111 group of memory devices is also created by the 
112 .B std 
113 keyword (see below).
114 .SH MEMORY DEVICES
115 .TP
116 .B ram
117 This is the keyword used to generate the ramdisk devices 
118 .BI ram {0..16}
119 and the 
120 .B ram 
121 symlink. This group does not include 
122 .BR initrd .
123 .TP
124 .B initrd
125 Ramdisk which has been pre-initialized by a bootloader. 
126 .B initrd
127 is not created in the 
128 .B ram
129 group; it must be specifically included 
130 in the command line if you want it to be created.
131 .TP
132 .IR cpu " or " microcode
133 Creates the CPU microcode update interface in the 
134 .B cpu/
135 folder, with devices 
136 .BR microcode ,
137 and subfolders 
138 .BR {0..3}
139 each containing devices 
140 .BR msr " and " cpuid .
141 .TP
142 .B rom
143 Creates the 
144 .BI rom {0..7} " rrom" {0..7} " flaxh" {0..7} 
145 and
146 .BI rflash {0..7}  
147 flash memory card devices. 
148 .BR rrom " and " rflash
149 devices are read-only.
150 .SH CONSOLE DEVICES
151 .TP
152 .B console
153 This keyword creates virtual consoles;
154 .BI tty {0..63}
155 devices, the corresponding 
156 .B vcs
157 and 
158 .B vcsa
159 devices which are used to generate screen-dumps, and the 
160 .B console 
161 device itself plus appropriate symlinks.
162 To create the console device alone, use 
163 .BR consoleonly .
164 The device 
165 .B tty0 
166 is the currently active virtual console. The 
167 .B console
168 device serves the same function.
169 .SH PSEUDO TERMINALS
170 .TP 
171 .B pty
172 This keyword creates the Pseudo-TTY masters 
173 .BI pty {a..e,p..z}
174 and corresponding 
175 .BI tty {a..e,p..z}
176 devices, along with 
177 .BR ptmx . 
178 Each possible argument will create a bank of 16 master and slave pairs.
179 The master pseudo-terminals are 
180 .BR pty{p..s}{0..9a..f} ,
181 and the slaves are
182 .BR tty{p..s}{0..9a..f} .
183 .SH SERIAL DEVICES
184 .TP
185 .I ttyS{0..63}
186 Standard serial ports. There is no group keyword, you must 
187 specify these individually. However 
188 .BI ttyS{0..3}
189 are created under the 
190 .B generic
191 option for most architectures.
192 .TP
193 .BR cyclades " or " ttyC
194 Creates Cyclades ports 
195 .BI ttyC {0..31} \fR.
196 .TP
197 .BR digi " or " ttyD
198 Creates Digiboard serial card ports
199 .BI ttyD {0..15} \fR.
200 .TP
201 .BR stallion " or " ttyE
202 Creates Stallion devices 
203 .BI ttyE {0..255} 
204 and 
205 .BI staliomem {0..3} \fR.
206 .TP
207 .BR computone " or " ttyF
208 Creates CompuTone serial card ports
209 .BI ttyH {0..255} 
210 and special devices 
211 .B ip2ipl{0,4,8,12}
212 and
213 .BR ip2stat{1,5,9,13} \fR.
214 .TP
215 .BR chase " or " ttyH
216 Creates Chase serial card ports
217 .BI ttyH {0..15} \fR.
218 .TP
219 .BR isdnmodem " or " ttyI
220 Creates isdn4linux virtual modem ports
221 .BI ttyI {0..63} \fR.
222 .TP
223 .BR isdn-tty
224 Also creates isdn4linux virtual modem ports
225 .BI ttyI {0..7} \fR.
226 .TP
227 .B isdnbri
228 Creates ISDN BRI driver devices
229 .B isdn{0..63} isdnctrl{0..63} ippp{0..63} 
230 and
231 .BR isdninfo .
232 .TP
233 .B isdn-io
234 Also creates ISDN BRI driver devices
235 .B isdn{0..7} isdnctrl{0..7} ippp{0..7} 
236 and
237 .BR isdninfo .
238 The
239 .B isdn-ippp 
240 keyword can be used separately to create only the 
241 .BI ippp {0..7} 
242 devices.
243 .TP
244 .B ppp
245 Creates a device independent PPP interface.
246 .TP
247 .B dcbri
248 Creates Spellcaster DataComm/BRI ISDN card devices 
249 .BR dcbri{0..3} .
250 .TP
251 .BR riscom " or " ttyL
252 Creates Riscom serial card ports
253 .BI ttyL {0..15} \fR.
254 .TP
255 .BR PAM " or " ttyM
256 Creates PAM multimodem (or ISI serial card) ports 
257 .BI ttyM {0..15} \fR.
258 .TP
259 .BR ESP " or " ttyP
260 Creates ESP ports 
261 .BI ttyP {0..4} \fR.
262 .TP
263 .BR rocketport " or " ttyR
264 Creates Rocketport devices
265 .BI ttyR {0..63} \fR.
266 .TP
267 .BR ttyV
268 Creates Comtrol VS-1000 serial controller ports 
269 .BI ttyV {0..15} \fR.
270 .TP
271 .BR specialixIO8 " or " ttyW
272 Creates Specialix IO8+ ports 
273 .BI ttyW {0..15} \fR.
274 .TP
275 .BR specialix " or " ttyX
276 Creates Specialix ports 
277 .BI ttyX {0..15} \fR.
278 .TP
279 .BI i2c
280 Creates 
281 .BI i2c {0..7}
282 devices for the I2C bus interface.
283 .TP
284 .BI tlk
285 Philips SAA5249 Teletext signal decoder {2.6} ports 
286 .BI tlk {0..3} \fR.
287 .SH PARALLEL PORTS
288 .TP
289 .IR lp
290 Creates the standard parallel ports 
291 .BR lp0 , 
292 .BR lp1 ,
293 and 
294 .BR lp2 
295 normally used for printers.
296 These correspond to ports at 0x3bc, 0x378 and 0x278.
297 Hence, on some machines, the first printer port may actually be
298 .BR lp1 .
299 .TP
300 .I par
301 Alternative to
302 .IR lp .
303 The same ports are created, but are named
304 .BI par {0..2}
305 instead of
306 .BI lp {0..2} \fR.
307 .TP
308 .I parport
309 Creates raw parallel ports
310 .BR parport0 , 
311 .BR parport1 ,
312 and 
313 .BR parport2 .
314 .TP
315 .B slm
316 Creates the Atari SLM ACSI laser printer (68k/Atari) ports
317 .BI slm {0..3} \fR.
318 .TP
319 .B pg
320 Parallel port generic ATAPI interface (devices 
321 .BI pg {0..3} \fR.
322 .TP
323 .B paride
324 Parallel port IDE disk devices 
325 .BI pd {a..d}
326 with 15 partitions on each. Also creates
327 .BR pcd{0..3} " and " pf{0..3} . 
328 .SH OTHER BUS PORTS
329 .TP
330 .BR netlink " or " tap
331 Creates NetLink devices 
332 .B route skip fwmonitor
333 and
334 .BI tap {0..15} 
335 Ethertap devices.
336 The
337 .BI tap x
338 virtual ethernet device was designed as low level kernel support for
339 Ethernet tunneling. Userland application can write Ethernet frame to
340 .BI /dev/tapX
341 and the kernel will receive this frame from tapX interface. 
342 Every frame the kernel writes to a
343 .BI tapX
344 interface can be read by a userland application from the corresponding
345 .BI /dev/tapX
346 device.
347 .TP 
348 .B enskip
349 ENskip kernel encryption package.
350 .TP
351 .B qng
352 ComScire Quantum Noise Generator.
353 .TP
354 .B ipsec
355 The Free S/WAN implementation of IPSEC.
356 .TP 
357 .B adb
358 On powerpc, creates 
359 .B adb
360 for the Apple Data Bus and 
361 .BR adbmouse .
362 On m68k, 
363 .B adb
364 creates the ACSI disk device 
365 .B adb
366 and partitions
367 .B adb1 
368 through 
369 .BR adb15 .
370 .TP
371 .B hamradio
372 Creates the 
373 .BI scc {0..7} 
374 and 
375 .BI bc {0..3} 
376 device groups.
377 .TP 
378 .B comx
379 Creates COMX devices
380 .BI comx {0..4} \fR.
381 .TP
382 .B irda
383 Creates IrCOMM devices (IrDA serial/parallel emulation)
384 .B ircomm0 ircomm1 irlpt0
385 and
386 .BR irlpt1 .
387 .TP
388 .B comedi
389 Control and Measurement devices 
390 .BI comedi {0..3} \fR.
391 .SH MOUSE DEVICES
392 .TP
393 .I busmice
394 This keyword creates the following devices:
395 .B logibm
396 (Logitech bus mouse),
397 .B psaux
398 (PS/2-style mouse),
399 .B inportbm
400 (Microsoft Inport bus mouse) and
401 .B atibm
402 (ATI XL bus mouse) and
403 .B jbm
404 (J-mouse).
405 .TP
406 .I m68k-mice
407 Creates mouse devices for the m68k architecture, including:
408 .BR amigamouse ,
409 .BR amigamouse1 ,
410 .B atarimouse 
411 and
412 .BR adbmouse .
413 .TP
414 .I input
415 On powerpc, this keyword creates the 
416 .I input 
417 folder which groups input devices
418 .BR mice , 
419 .BI mouse {0..3} \fR,
420 .BI event {0..3} \fR,
421 and 
422 .BI js {0..3}
423 (joystick), and creates these devices inside. 
424 .SH JOYSTICK DEVICES
425 .TP
426 .I js
427 Joystick.  Creates 
428 .B js0
429 and 
430 .BR js1 .
431 .TP
432 .I djs
433 Digital joystick. Creates 
434 .B djs0
435 and 
436 .BR djs1 .
437 .SH USB DEVICES
438 .TP
439 .B usb
440 USB is a general purpose I/O bus which can serve many purposes. The
441 .B usb
442 keyword creates a 
443 .B usb
444 folder, and devices in the folder:
445 .BI lp {0..15}
446 (printer),
447 .BI mouse {0..15}
448 (USB connected mice),
449 .BI ez {0..15}
450 (firmware loaders)
451 .BI scanner {0..15}
452 (scanner interfaces),
453 .BI ttyACM {0..15} 
454 and
455 .BI ttyUSB {0..15}
456 (dialout devices),
457 and 
458 .B rio500
459 the Diamond Rio 500 device. 
460 .SH DISK DEVICES
461 .TP
462 .BI fd {0..7}
463 Floppy disk devices.  The device
464 .BI fd x
465 is the device which autodetects the format, 
466 and the additional devices are
467 fixed format (whose size is indicated in the name).
468 The other devices are named as
469 .BI fd x{dqhu}n .
470 The single letter 
471 .RI ( d ,
472 .IR q , 
473 .IR h or 
474 .IR u )
475 signifies the type of drive: 5.25" Double Density (d),
476 5.25" Quad Density (q), 5.25" High Density (h) or 3.5"
477 (any model, u). The number
478 .I n
479 represents the capacity of that format in K.  
480 Thus the standard formats are
481 .BI fd x d360 ,
482 .BI fd x h1200 ,
483 .BI fd x 720 ,
484 .BI fd x 1440 ,
485 and
486 .BI fd x 2880 .
487 .IP
488 For more information see Alain Knaff's fdutils package.
489 .IP
490 Devices
491 .BI fd0 *
492 through
493 .BI fd3 *
494 are floppy disks on the first controller, and devices
495 .BI fd4 *
496 through
497 .BI fd7 *
498 are floppy disks on the second controller.
499 .TP
500 .BI fd {0..7} -bare
501 Creates just the autodetecting floppy device specified, without the fixed 
502 format devices.
503 .TP
504 .BI hd {a..l}
505 AT (ide) hard disks.  The device
506 .BI hd x
507 provides access to the whole disk, with the partitions being
508 .BI hd x {1..63}.
509 For i386, the four primary partitions are
510 .BI hd x 1
511 through
512 .BI hd x 4,
513 with the logical partitions being numbered from
514 .BI hd x 5
515 though
516 .BI hd x 20.
517 (A primary partition can be made into an extended partition, which can
518 hold 4 logical partitions). Other architectures may not differentiate
519 partition types.  By default, devices for 20 logical partitions are
520 made. The kernel supports up to 63 partitions per device.
521 .IP
522 Drives 
523 .B hda 
524 and  
525 .B hdb 
526 are the two on the primary controller
527 .B hdc 
528 and
529 .B hdd 
530 are the two
531 drives on the secondary controller.  These devices can also be used to
532 access IDE CDROMs. Additional devices 
533 .BI hd {e..l} 
534 can be created.
535 .TP
536 .BI xd {a..d} 
537 XT hard disks.  Partitions are the same as IDE disks, except only 8 
538 partitions are created. 
539 .TP
540 .BI sd {a..h}
541 SCSI hard disks.  The partitions are similar to the IDE disks, but there
542 is a limit of 11 logical partitions
543 .BI sd x 5
544 through
545 .BI sd x 15, 
546 to allow there to be 8 SCSI disks on a system 
547 (addresses 0 through 7). 
548 .TP
549 .BI sd {i..z} 
550 and 
551 .BI sd {a..d}{a..z}
552 The kernel (and MAKEDEV) can handle up to 128 SCSI disks (up to 
553 .BR sddx ).
554 15 partition devices are created for each.
555 .TP
556 .B eda edb
557 MCA ESDI hard disk. Partitions are handled the same as hd.
558 .TP
559 .BI dasd {a..z}
560 Direct Access Storage Devices for the s390 architecture. Currently
561 only one device partition is created (for example, 
562 .BR dasda1 ).
563 .TP
564 .BI ada {a..p}
565 ACSI disk (68k/Atari). 15 partitions are created for each.
566 .TP
567 .BI dac960. {0..7} 
568 Mylex DAC960 PCI RAID controller. For this device, an 
569 .B rd
570 directory is created. 32 logical devices
571 .BI c x d {0..31}
572 are created for each unit 
573 .I x
574 specified, each with 7 partitions 
575 .BI c x d {0..31} p {1..7} \fR.
576 The 
577 .B dac960
578 keyword will create all 7 units at once.
579 .TP
580 .BI dpti
581 Adaptec I2O RAID and DPT SmartRAID V I2O controllers. Creates
582 7 devices for handling up to 7 controllers.
583 .TP
584 .BI ataraid. {0..7} 
585 Obsolete, device not in current devices.txt. For this device, an 
586 .B ataraid
587 directory is created. 
588 .BI d x 
589 is created for each unit 
590 .I x
591 specified, and 15 partitions 
592 .BI d x p {1..15} \fR.
593 The 
594 .B ataraid
595 keyword will create all 7 units at once.
596 .TP
597 .BI i2o.hd{a..d}{a..z}
598 I2O based harddisk drives. Device nodes are located in the
599 .B i2o
600 directory. The filename is followed by a number that specifies the partition on
601 each disk. The numbers are handled the same as hd.
602 .TP
603 .BI ida. {0..7} 
604 Compaq Intelligent Drive Array. For this device, an 
605 .B ida
606 directory is created. 16 logical devices
607 .BI c x d {0..15}
608 are created for each unit 
609 .I x
610 specified, each with 15 partitions 
611 .BI c x d {0..15} p {1..15} \fR.
612 The 
613 .B ida
614 keyword will create the first three units.
615 .TP
616 .BI cciss. {0..7} 
617 Compaq Next Generation Drive Array. For this device, a
618 .B cciss
619 directory is created. 16 logical devices
620 .BI c x d {0..15}
621 are created for each unit 
622 .I x
623 specified, each with 15 partitions 
624 .BI c x d {0..15} p {1..15} \fR.
625 The 
626 .B cciss
627 keyword will create the first three units.
628 .TP
629 .BI md
630 Creates Metadisk (RAID) disk array with 16 devices.
631 .SH TAPE DEVICES
632 .TP
633 .I st{0..7}
634 SCSI tape devices.  This creates the rewinding tape device
635 .BI st x
636 and the non-rewinding tape device
637 .BI nst x ,
638 for each of modes 0 through 3.
639 .TP
640 .I qic
641 QIC-11, -24, -120, and -150 tapes.  The devices created are
642 .B ntpqic11 tpqic11 ntpqic24 tpqic24 ntpqic120 tpqic120 ntpqic150
643 and 
644 .B tpqic150
645 tape devices, along with
646 .BR rmt8 ,
647 .BR rmt16 ,
648 .BR tape-d ,
649 and
650 .BR tape-reset .
651 .TP
652 .I ftape                
653 Floppy driver tapes (QIC-117).  There are 4 methods of access depending on
654 the floppy tape drive.  For each of access methods 0, 1, 2 and 3, the
655 devices
656 .BI qft x
657 .BI zqft x
658 and
659 .BI rawqftx
660 (rewinding) and
661 .BI nqft x
662 .BI nzqft x
663 .BI nrawqdt x
664 (non-rewinding) are created.  For compatibility, devices
665 .B ftape
666 and
667 .B nftape
668 are symlinks to
669 .B qft0
670 and
671 .B nqft0
672 respectively.
673 .TP
674 .B ht0
675 Creates IDE tape devices 
676 .B ht0
677 and
678 .BR nht0 .
679 .TP
680 .BI pt {0..3}
681 Creates parallel port ATAPI tape devices
682 .B pt{0..3}
683 and
684 .BR npt{0..3} .
685 .SH CDROM DEVICES
686 .TP
687 .BR sr " or " scd " or " scd-all
688 Creates 
689 .BI scd {0..16}
690 SCSI CD players and 
691 .BI sr {0..16}
692 symlinks for these devices.
693 .B cdrom 
694 is a symlink which can be created by the user to the active CD device.
695 It is not created by 
696 .BR MAKEDEV .
697 .TP
698 .B pktcdvd
699 Provides packet writing devices 
700 .BI pktcdvd {0..3}
701 for CD/DVD.
702 .TP
703 .I pcd{0..3}
704 Parallel port ATAPI CD-ROM devices
705 .TP
706 .I sonycd 
707 Sony CDU-31a CD-ROM
708 .TP
709 .I mcd 
710 Mitsumi CD-ROM
711 .TP
712 .I mcdx
713 Obsolete, device not in current devices.txt.
714 .TP
715 .I cdu535
716 Sony CDU-535 CD-ROM
717 .TP
718 .IR lmscd
719 Philips LMS CM-205 CD-ROM. The newer name for this device is 
720 .IR cm205 ,
721 but MAKEDEV creates only lmscd at this time.
722 .TP
723 .I cm206cd
724 Philips LMS CM-206 CD-ROM
725 .TP
726 .I bpcd
727 MicroSolutions BackPack parallel port CD-ROM (Obsolete - use pcd)
728 .TP
729 .I sbpcd{0..15}
730 Matsushita (Panasonic/SoundBlaster) CD-ROM. Units {0..3} are created with the keyword
731 .BR sbpcd .
732 .TP
733 .I aztcd
734 Aztech/Orchid/Okano/Wearnes CD-ROM
735 .TP
736 .I gscd 
737 GoldStar CD-ROM
738 .TP
739 .I optcd
740 Optics Storage CD-ROM
741 .TP
742 .I sjcd
743 Sanyo CD-ROM
744 .TP
745 .I hitcd
746 Hitachi CD-ROM
747 .SH SCANNERS
748 .TP
749 .I logiscan
750 Logitech ScanMan32 & ScanMan 256.
751 .TP
752 .I m105scan
753 Mustek M105 Handscanner.
754 .TP
755 .I ac4096
756 A4Tek Color Handscanner.
757 .SH AUDIO DEVICES
758 .TP
759 .I audio
760 This creates the audio devices used by the sound driver.  These include
761 .B mixer mixer{1..3}
762 (Mixer controls), 
763 .B sequencer
764 (Audio sequencer),
765 .B dsp dsp{1..3}
766 (Digital audio),
767 .B sndstat
768 (Sound card status information),
769 .B audioctl
770 (SPARC audio control device)
771 and
772 .B audio audio{1..3} 
773 (Sun-compatible digital audio). MIDI devices are 
774 .B midi00
775 through
776 .BR midi03 ,
777 .BI midi {0..3} \fR,
778 .BI rmidi {0..3} \fR,
779 .BI smpte {0..3} \fR.
780 In addition, devices 
781 .B mpu401data
782 and
783 .B mpu401stat
784 are created.
785 .TP
786 .I pcaudio
787 Devices for the PC Speaker sound driver.  These are
788 .BR pcmixer ,
789 .BR pxsp ,
790 and
791 .BR pcaudio .
792 .SH VIDEO DEVICES
793 .TP
794 .B fb
795 Creates framebuffer devices
796 .BI fb {0..7} \fR,
797 .BI fb {0..7} current \fR,
798 .BI fb {0..7} autodetect \fR.
799 .TP
800 .B fb{0..7}
801 If the framebuffer number 
802 .I x 
803 is specifed, a group of  
804 .BI fb x user {0..7} 
805 devices is created.
806 .TP
807 .B 3dfx
808 is the 3Dfx Voodoo Graphics device.
809 .TP
810 .B agpgart
811 AGP Graphics Address Remapping Table
812 .TP
813 .I "video video4linux v4l radio"
814 Each of these keywords produces the same result:
815 Video capture/overlay devices
816 .BI video {0..63} \fR,
817 Radio devices
818 .BI radio {0..63} \fR,
819 Teletext devices 
820 .BI vtx {0..31} \fR,
821 and Vertical blank interrupt devices
822 .BI vbi {0..31} \fR. 
823 In addition, the 
824 .BR winradio0 " and " winradio1 " devices,"
825 and 
826 .BR vtx " and " vttuner " devices,"
827 and symlinks
828 .BR "radio video" " and " vbi
829 are created. 
830 .TP
831 .BI srnd
832 miroMEDIA Surround board devices 
833 .BR srnd0 " and " srnd1 .
834 .TP
835 .B fgrab
836 Matrox Meteor frame grabber {2.6}. Creates 
837 .BR mmetfgrab ,
838 .BR wvisfgrab ,
839 .BR iscc0 ,
840 .BR iscc1 ,
841 .BR isccctl0 ,
842 .BR isccctl1 ,
843 .BR dcxx0 ,
844 and
845 .BR dcxx1 .
846 .SH MISCELLANEOUS DEVICES
847 .TP
848 .IR sg " or " sg-all
849 Generic SCSI devices.  The devices created are 
850 .B sg0 
851 through 
852 .BR sg16 .
853 These allow arbitary commands to be sent to any SCSI device, to query
854 information or control SCSI devices that are not disk, tape or CDROM
855 (for example, scanner or writeable CDROM).
856 .TP
857 .I fd
858 To allow an arbitary program to be fed input from file descriptor
859 .IR x ,
860 use
861 .BI /dev/fd/ x
862 as the file name.  This also creates 
863 .BR /dev/stdin ,
864 .BR /dev/stdout ,
865 and
866 .BR /dev/stderr .
867 (Note, these are just symlinks into /proc/self/fd).
868 .TP
869 .I ibcs2
870 Devices 
871 .B socksys spx 
872 (and symlinks 
873 .BR "nfsd XOR" ) 
874 needed by the IBCS2 emulation.
875 .TP
876 .I apm
877 .B apm_bios 
878 Advanced Power Management BIOS device.
879 .TP
880 .I dcf
881 Driver for DCF-77 radio clock.
882 .TP
883 .I helloworld
884 Kernel modules demonstration device.  See the modules source.
885 .TP
886 .BR xfs " or " arla
887 Arla XFS network file system.
888 .TP
889 .B capi
890 CAPI 2.0 interface ports
891 .BI capi20 {01..20} \fR.
892 .TP
893 .B ubd
894 User-mode block devices
895 .BI ubd {0..255} \fR.
896 .TP
897 .BI nb {0..7}
898 Network block devices.
899 .TP 
900 .B raw
901 Creates the raw block device interface 
902 .B raw
903 device, the 
904 .B rawctl 
905 symlink, and 
906 .BI raw {1..8} \fR.
907 .TP
908 .B raw1394
909 IEEE 1394 (Firewire).
910 .TP
911 .B misc
912 This keyword creates all the following devices. You may find the 
913 device explanations in other categories in this man page, many 
914 under OTHER DEVICES below.
915 .BR logibm ,
916 .BR psaux ,
917 .BR inportbm ,
918 .BR atibm ,
919 .BR jbm ,
920 .BR amigamouse ,
921 .BR atarimouse ,
922 .BR sunmouse ,
923 .BR amigamouse1 ,
924 .BR smouse ,
925 .BR pc110pad ,
926 .BR adbmouse ,
927 .BR beep ,
928 .BR modreq ,
929 .BR watchdog ,
930 .BR temperature ,
931 .BR hwtrap ,
932 .BR exttrp ,
933 .BR apm_bios ,
934 .BR rtc ,
935 .BR openprom ,
936 .BR relay8 ,
937 .BR relay16 ,
938 .BR msr ,
939 .BR pciconf ,
940 .BR nvram ,
941 .BR hfmodem ,
942 .BR led ,
943 .BR mergemem ,
944 .BR pmu .
945 .TP
946 .B "Network Devices"
947 Linux used to have devices in /dev for controlling network devices, but
948 that is no longer the case.  To see what network devices are known by the
949 kernel, look at /proc/net/dev.
950 .SH OTHER DEVICES
951 .TP
952 Many of these devices are architecture-specific.
953 .TP
954 .I scc
955 Z8530 HDLC driver (HAM radio)
956 .TP
957 .I bc
958 Baycom radio modem (HAM radio)
959 .TP
960 .IR cfs0 " or " cfs " or " coda
961 Coda network file system
962 .TP
963 .I sunmouse 
964 Sun mouse
965 .TP
966 .I smouse 
967 Simple serial mouse driver
968 .TP
969 .I pc110pad 
970 IBM PC-110 digitizer pad
971 .TP
972 .I vrtpanel 
973 Vr41xx embedded touch panel
974 .TP
975 .I vpcmouse
976 Connectix Virtual PC Mouse
977 .TP
978 .I beep
979 Fancy beep device
980 .TP
981 .I modreq
982 Kernel module load request {2.6}
983 .TP
984 .I watchdog
985 Watchdog timer port
986 .TP
987 .I temperature
988 Machine internal temperature
989 .TP
990 .I hwtrap
991 Hardware fault trap
992 .TP
993 .I exttrp
994 External device trap
995 .TP
996 .I rtc
997 Real Time Clock
998 .TP
999 .I efirtc
1000 Real Time Clock
1001 .TP
1002 .I openprom
1003 SPARC OpenBoot PROM
1004 .TP
1005 .I relay8
1006 Berkshire Products Octal relay card
1007 .TP
1008 .I relay16
1009 Berkshire Products ISO-16 relay card
1010 .TP
1011 .I msr 
1012 x86 model-specific registers {2.6}
1013 .TP
1014 .I pciconf
1015 PCI configuration space
1016 .TP
1017 .I nvram
1018 Non-volatile configuration RAM
1019 .TP
1020 .I hfmodem
1021 Soundcard shortwave modem control {2.6}
1022 .TP
1023 .I graphics
1024 Linux/SGI graphics device
1025 .TP
1026 .I opengl
1027 Linux/SGI OpenGL pipe
1028 .TP
1029 .I gfx
1030 Linux/SGI graphics effects device
1031 .TP
1032 .I lcd
1033 Front panel LCD display
1034 .TP
1035 .I led
1036 Front panel LEDs
1037 .TP
1038 .I mergemem
1039 Memory merge device
1040 .TP
1041 .I pmu
1042 Macintosh PowerBook power manager
1043 .TP
1044 .I isictl
1045 MultiTech ISICom serial control
1046 .TP
1047 .I ac
1048 Applicom Intl Profibus card
1049 .TP
1050 .I nwbutton
1051 Netwinder external button
1052 .TP
1053 .I nwdebug
1054 Netwinder debug interface
1055 .TP
1056 .I nwflash
1057 Netwinder flash memory
1058 .TP
1059 .I userdma
1060 User-space DMA access
1061 .TP
1062 .I smbus
1063 System Management Bus
1064 .TP
1065 .I lik
1066 Logitech Internet Keyboard
1067 .TP
1068 .I ipmo
1069 Intel Intelligent Platform Management
1070 .TP
1071 .I vmmon
1072 VMWare virtual machine monitor
1073 .TP
1074 .I tcldrv
1075 Technology Concepts serial control
1076 .TP
1077 .I specialix_sxctl
1078 Specialix serial control
1079 .TP
1080 .I specialix_rioctl
1081 Specialix RIO serial control
1082 .TP
1083 .IR smapi " or " thinkpad
1084 IBM Thinkpad 
1085 .B smapi
1086 device, and a symlink 
1087 .BR thinkpad .
1088 .TP
1089 .I srripc
1090 QNX4 API IPC manager
1091 .TP
1092 .I usemaclone
1093 Semaphore clone device
1094 .TP
1095 .IR ipmi " or " ipmikcs
1096 Intelligent Platform Management
1097 .TP
1098 .I uctrl
1099 SPARCbook 3 microcontroller
1100 .TP
1101 .I gtrsc
1102 Gorgy Timing radio clock
1103 .TP
1104 .I cbm
1105 Serial CBM bus
1106 .TP
1107 .I jsflash
1108 JavaStation OS flash SIMM
1109 .TP
1110 .I xsvc
1111 High-speed shared-mem/semaphore service
1112 .TP
1113 .I vrbuttons
1114 Vr41xx button input device
1115 .TP
1116 .I toshiba
1117 Toshiba laptop SMM support
1118 .TP
1119 .I perfctr
1120 Performance-monitoring counters
1121 .TP
1122 .I intel_rng
1123 Intel i8x0 random number generator
1124 .TP
1125 .I atomicps
1126 Atomic shapshot of process state data
1127 .TP
1128 .I irnet
1129 IrNET device
1130 .TP
1131 .I smbusbios
1132 SMBus BIOS
1133 .TP
1134 .I ussp_ctl
1135 User space serial port control
1136 .TP
1137 .I crash
1138 Mission Critical Linux crash dump facility
1139 .TP
1140 .I nas_xbus
1141 NAS xbus LCD/buttons access
1142 .TP
1143 .I d7s
1144 SPARC 7-segment display
1145 .TP
1146 .I zkshim
1147 Zero-Knowledge network shim control
1148 .TP
1149 .I sexec
1150 Signed executable interface
1151 .TP
1152 .I kchuid
1153 Inter-process chuid control
1154 .TP
1155 .I mptctl
1156 Message passing technology (MPT) control
1157 .TP
1158 .I button/gulpb
1159 Transmeta GULP-B buttons
1160 .TP
1161 .I compaq/cpqphpc
1162 Compaq PCI Hot Plug Controller
1163 .TP
1164 .I compaq/cpqrid
1165 Compaq Remote InsightDriver
1166 .TP
1167 .I elographics/e2201
1168 Elographics touchscreen E271-2201
1169 .TP
1170 .I fujitsu/apanel
1171 Fujitsu/Siemens application panel
1172 .TP
1173 .I i2o/ctl
1174 I2O configuration manager
1175 .TP
1176 .I impi/bt
1177 IMPI coprocessor block transfer
1178 .TP
1179 .I impi/smic
1180 IMPI coprocessor stream interface
1181 .TP
1182 .I input/mouse
1183 Linux/SGI Irix emulation mouse
1184 .TP
1185 .I input/keyboard
1186 Linux/SGI Irix emulation keyboard
1187 .TP
1188 .I modems/mwave
1189 MWave modem firmware upload
1190 .TP
1191 .I mvista/hssdsi
1192 Montavista PICMG hot swap system driver
1193 .TP
1194 .I mvista/hasi
1195 Montavista PICMG high availability
1196 .TP
1197 .I net/tun
1198 TAP/TUN network device
1199 .TP
1200 .I ni/natmotn
1201 National Instruments Motion
1202 .TP
1203 .I scanners/cuecat 
1204 :CueCat barcode scanner
1205 .TP
1206 .I touchscreen/ucb1x00
1207 UCB 1x00 touchscreen
1208 .TP
1209 .I touchscreen/mk712
1210 MK712 touchscreen
1211 .TP
1212 .I video/em8300
1213 EM8300 DVD decoder control
1214 .TP
1215 .I video/em8300_mv
1216 EM8300 DVD decoder video
1217 .TP
1218 .I video/em8300_ma
1219 EM8300 DVD decoder audio
1220 .TP
1221 .I video/em8300_sp
1222 EM8300 DVD decoder subpicture
1223 .TP
1224 .I watchdogs/{0..3}
1225 Watchdog devices 0 through 3
1226
1227 .SH "SEE ALSO"
1228 Linux Allocated Devices, maintained by H.\ Peter Anvin,
1229 <Peter.Anvin@linux.org>, and devices.txt in the Linux 
1230 kernel source.
1231 .SH AUTHOR
1232 Nick Holloway, rewritten and updated by Chris Tillman
1233