Commit 04c860c188ebdcf396fd50751592fb5a9f51287a

Authored by Alan Cox
Committed by Linus Torvalds
1 parent 5fba0925fd

LANANA: Change of management and resync

Bring the devices.txt back into some relationship with reality. Update the
documentation a bit.

Signed-off-by: Alan Cox <alan@lxorguk.ukuu.org.uk>
Signed-off-by: Linus Torvalds <torvalds@linux-foundation.org>

Showing 1 changed file with 58 additions and 63 deletions Side-by-side Diff

Documentation/devices.txt
1 1  
2 2 LINUX ALLOCATED DEVICES (2.6+ version)
3 3  
4   - Maintained by Torben Mathiasen <device@lanana.org>
  4 + Maintained by Alan Cox <device@lanana.org>
5 5  
6 6 Last revised: 29 November 2006
7 7  
... ... @@ -67,6 +67,11 @@
67 67 in "batch mode", so there is likely additional registrations that
68 68 haven't been listed yet.
69 69  
  70 +Fourth, remember that Linux now has extensive support for dynamic allocation
  71 +of device numbering and can use sysfs and udev to handle the naming needs.
  72 +There are still some exceptions in the serial and boot device area. Before
  73 +asking for a device number make sure you actually need one.
  74 +
70 75 Finally, sometimes I have to play "namespace police." Please don't be
71 76 offended. I often get submissions for /dev names that would be bound
72 77 to cause conflicts down the road. I am trying to avoid getting in a
... ... @@ -101,7 +106,7 @@
101 106 0 = /dev/ram0 First RAM disk
102 107 1 = /dev/ram1 Second RAM disk
103 108 ...
104   - 250 = /dev/initrd Initial RAM disk {2.6}
  109 + 250 = /dev/initrd Initial RAM disk
105 110  
106 111 Older kernels had /dev/ramdisk (1, 1) here.
107 112 /dev/initrd refers to a RAM disk which was preloaded
... ... @@ -340,7 +345,7 @@
340 345 14 = /dev/touchscreen/ucb1x00 UCB 1x00 touchscreen
341 346 15 = /dev/touchscreen/mk712 MK712 touchscreen
342 347 128 = /dev/beep Fancy beep device
343   - 129 = /dev/modreq Kernel module load request {2.6}
  348 + 129 =
344 349 130 = /dev/watchdog Watchdog timer port
345 350 131 = /dev/temperature Machine internal temperature
346 351 132 = /dev/hwtrap Hardware fault trap
347 352  
... ... @@ -350,10 +355,10 @@
350 355 139 = /dev/openprom SPARC OpenBoot PROM
351 356 140 = /dev/relay8 Berkshire Products Octal relay card
352 357 141 = /dev/relay16 Berkshire Products ISO-16 relay card
353   - 142 = /dev/msr x86 model-specific registers {2.6}
  358 + 142 =
354 359 143 = /dev/pciconf PCI configuration space
355 360 144 = /dev/nvram Non-volatile configuration RAM
356   - 145 = /dev/hfmodem Soundcard shortwave modem control {2.6}
  361 + 145 = /dev/hfmodem Soundcard shortwave modem control
357 362 146 = /dev/graphics Linux/SGI graphics device
358 363 147 = /dev/opengl Linux/SGI OpenGL pipe
359 364 148 = /dev/gfx Linux/SGI graphics effects device
... ... @@ -435,6 +440,9 @@
435 440 228 = /dev/hpet HPET driver
436 441 229 = /dev/fuse Fuse (virtual filesystem in user-space)
437 442 230 = /dev/midishare MidiShare driver
  443 + 231 = /dev/snapshot System memory snapshot device
  444 + 232 = /dev/kvm Kernel-based virtual machine (hardware virtualization extensions)
  445 + 233 = /dev/kmview View-OS A process with a view
438 446 240-254 Reserved for local use
439 447 255 Reserved for MISC_DYNAMIC_MINOR
440 448  
... ... @@ -466,10 +474,7 @@
466 474 The device names specified are proposed -- if there
467 475 are "standard" names for these devices, please let me know.
468 476  
469   - 12 block MSCDEX CD-ROM callback support {2.6}
470   - 0 = /dev/dos_cd0 First MSCDEX CD-ROM
471   - 1 = /dev/dos_cd1 Second MSCDEX CD-ROM
472   - ...
  477 + 12 block
473 478  
474 479 13 char Input core
475 480 0 = /dev/input/js0 First joystick
... ... @@ -498,7 +503,7 @@
498 503 2 = /dev/midi00 First MIDI port
499 504 3 = /dev/dsp Digital audio
500 505 4 = /dev/audio Sun-compatible digital audio
501   - 6 = /dev/sndstat Sound card status information {2.6}
  506 + 6 =
502 507 7 = /dev/audioctl SPARC audio control device
503 508 8 = /dev/sequencer2 Sequencer -- alternate device
504 509 16 = /dev/mixer1 Second soundcard mixer control
505 510  
... ... @@ -510,15 +515,8 @@
510 515 34 = /dev/midi02 Third MIDI port
511 516 50 = /dev/midi03 Fourth MIDI port
512 517  
513   - 14 block BIOS harddrive callback support {2.6}
514   - 0 = /dev/dos_hda First BIOS harddrive whole disk
515   - 64 = /dev/dos_hdb Second BIOS harddrive whole disk
516   - 128 = /dev/dos_hdc Third BIOS harddrive whole disk
517   - 192 = /dev/dos_hdd Fourth BIOS harddrive whole disk
  518 + 14 block
518 519  
519   - Partitions are handled in the same way as IDE disks
520   - (see major number 3).
521   -
522 520 15 char Joystick
523 521 0 = /dev/js0 First analog joystick
524 522 1 = /dev/js1 Second analog joystick
525 523  
... ... @@ -535,14 +533,14 @@
535 533 16 block GoldStar CD-ROM
536 534 0 = /dev/gscd GoldStar CD-ROM
537 535  
538   - 17 char Chase serial card
  536 + 17 char OBSOLETE (was Chase serial card)
539 537 0 = /dev/ttyH0 First Chase port
540 538 1 = /dev/ttyH1 Second Chase port
541 539 ...
542 540 17 block Optics Storage CD-ROM
543 541 0 = /dev/optcd Optics Storage CD-ROM
544 542  
545   - 18 char Chase serial card - alternate devices
  543 + 18 char OBSOLETE (was Chase serial card - alternate devices)
546 544 0 = /dev/cuh0 Callout device for ttyH0
547 545 1 = /dev/cuh1 Callout device for ttyH1
548 546 ...
... ... @@ -644,8 +642,7 @@
644 642 2 = /dev/sbpcd2 Panasonic CD-ROM controller 0 unit 2
645 643 3 = /dev/sbpcd3 Panasonic CD-ROM controller 0 unit 3
646 644  
647   - 26 char Quanta WinVision frame grabber {2.6}
648   - 0 = /dev/wvisfgrab Quanta WinVision frame grabber
  645 + 26 char
649 646  
650 647 26 block Second Matsushita (Panasonic/SoundBlaster) CD-ROM
651 648 0 = /dev/sbpcd4 Panasonic CD-ROM controller 1 unit 0
... ... @@ -872,7 +869,7 @@
872 869 and "user level packet I/O." This board is also
873 870 accessible as a standard networking "eth" device.
874 871  
875   - 38 block Reserved for Linux/AP+
  872 + 38 block OBSOLETE (was Linux/AP+)
876 873  
877 874 39 char ML-16P experimental I/O board
878 875 0 = /dev/ml16pa-a0 First card, first analog channel
879 876  
880 877  
881 878  
882 879  
883 880  
... ... @@ -892,30 +889,17 @@
892 889 50 = /dev/ml16pb-c1 Second card, second counter/timer
893 890 51 = /dev/ml16pb-c2 Second card, third counter/timer
894 891 ...
895   - 39 block Reserved for Linux/AP+
  892 + 39 block
896 893  
897   - 40 char Matrox Meteor frame grabber {2.6}
898   - 0 = /dev/mmetfgrab Matrox Meteor frame grabber
  894 + 40 char
899 895  
900   - 40 block Syquest EZ135 parallel port removable drive
901   - 0 = /dev/eza Parallel EZ135 drive, whole disk
  896 + 40 block
902 897  
903   - This device is obsolete and will be removed in a
904   - future version of Linux. It has been replaced with
905   - the parallel port IDE disk driver at major number 45.
906   - Partitions are handled in the same way as IDE disks
907   - (see major number 3).
908   -
909 898 41 char Yet Another Micro Monitor
910 899 0 = /dev/yamm Yet Another Micro Monitor
911 900  
912   - 41 block MicroSolutions BackPack parallel port CD-ROM
913   - 0 = /dev/bpcd BackPack CD-ROM
  901 + 41 block
914 902  
915   - This device is obsolete and will be removed in a
916   - future version of Linux. It has been replaced with
917   - the parallel port ATAPI CD-ROM driver at major number 46.
918   -
919 903 42 char Demo/sample use
920 904  
921 905 42 block Demo/sample use
... ... @@ -1681,13 +1665,7 @@
1681 1665 disks (see major number 3) except that the limit on
1682 1666 partitions is 15.
1683 1667  
1684   - 93 char IBM Smart Capture Card frame grabber {2.6}
1685   - 0 = /dev/iscc0 First Smart Capture Card
1686   - 1 = /dev/iscc1 Second Smart Capture Card
1687   - ...
1688   - 128 = /dev/isccctl0 First Smart Capture Card control
1689   - 129 = /dev/isccctl1 Second Smart Capture Card control
1690   - ...
  1668 + 93 char
1691 1669  
1692 1670 93 block NAND Flash Translation Layer filesystem
1693 1671 0 = /dev/nftla First NFTL layer
... ... @@ -1695,10 +1673,7 @@
1695 1673 ...
1696 1674 240 = /dev/nftlp 16th NTFL layer
1697 1675  
1698   - 94 char miroVIDEO DC10/30 capture/playback device {2.6}
1699   - 0 = /dev/dcxx0 First capture card
1700   - 1 = /dev/dcxx1 Second capture card
1701   - ...
  1676 + 94 char
1702 1677  
1703 1678 94 block IBM S/390 DASD block storage
1704 1679 0 = /dev/dasda First DASD device, major
... ... @@ -1791,11 +1766,7 @@
1791 1766 ...
1792 1767 15 = /dev/amiraid/ar?p15 15th partition
1793 1768  
1794   -102 char Philips SAA5249 Teletext signal decoder {2.6}
1795   - 0 = /dev/tlk0 First Teletext decoder
1796   - 1 = /dev/tlk1 Second Teletext decoder
1797   - 2 = /dev/tlk2 Third Teletext decoder
1798   - 3 = /dev/tlk3 Fourth Teletext decoder
  1769 +102 char
1799 1770  
1800 1771 102 block Compressed block device
1801 1772 0 = /dev/cbd/a First compressed block device, whole device
... ... @@ -1916,10 +1887,7 @@
1916 1887 DAC960 (see major number 48) except that the limit on
1917 1888 partitions is 15.
1918 1889  
1919   -111 char Philips SAA7146-based audio/video card {2.6}
1920   - 0 = /dev/av0 First A/V card
1921   - 1 = /dev/av1 Second A/V card
1922   - ...
  1890 +111 char
1923 1891  
1924 1892 111 block Compaq Next Generation Drive Array, eighth controller
1925 1893 0 = /dev/cciss/c7d0 First logical drive, whole disk
... ... @@ -2079,8 +2047,8 @@
2079 2047 ...
2080 2048  
2081 2049 119 char VMware virtual network control
2082   - 0 = /dev/vmnet0 1st virtual network
2083   - 1 = /dev/vmnet1 2nd virtual network
  2050 + 0 = /dev/vnet0 1st virtual network
  2051 + 1 = /dev/vnet1 2nd virtual network
2084 2052 ...
2085 2053  
2086 2054 120-127 char LOCAL/EXPERIMENTAL USE
... ... @@ -2450,7 +2418,7 @@
2450 2418 2 = /dev/raw/raw2 Second raw I/O device
2451 2419 ...
2452 2420  
2453   -163 char UNASSIGNED (was Radio Tech BIM-XXX-RS232 radio modem - see 51)
  2421 +163 char
2454 2422  
2455 2423 164 char Chase Research AT/PCI-Fast serial card
2456 2424 0 = /dev/ttyCH0 AT/PCI-Fast board 0, port 0
... ... @@ -2542,6 +2510,12 @@
2542 2510 1 = /dev/clanvi1 Second cLAN adapter
2543 2511 ...
2544 2512  
  2513 +179 block MMC block devices
  2514 + 0 = /dev/mmcblk0 First SD/MMC card
  2515 + 1 = /dev/mmcblk0p1 First partition on first MMC card
  2516 + 8 = /dev/mmcblk1 Second SD/MMC card
  2517 + ...
  2518 +
2545 2519 179 char CCube DVXChip-based PCI products
2546 2520 0 = /dev/dvxirq0 First DVX device
2547 2521 1 = /dev/dvxirq1 Second DVX device
... ... @@ -2560,6 +2534,9 @@
2560 2534 96 = /dev/usb/hiddev0 1st USB HID device
2561 2535 ...
2562 2536 111 = /dev/usb/hiddev15 16th USB HID device
  2537 + 112 = /dev/usb/auer0 1st auerswald ISDN device
  2538 + ...
  2539 + 127 = /dev/usb/auer15 16th auerswald ISDN device
2563 2540 128 = /dev/usb/brlvgr0 First Braille Voyager device
2564 2541 ...
2565 2542 131 = /dev/usb/brlvgr3 Fourth Braille Voyager device
... ... @@ -2810,6 +2787,16 @@
2810 2787 ...
2811 2788 190 = /dev/ttyUL3 Xilinx uartlite - port 3
2812 2789 191 = /dev/xvc0 Xen virtual console - port 0
  2790 + 192 = /dev/ttyPZ0 pmac_zilog - port 0
  2791 + ...
  2792 + 195 = /dev/ttyPZ3 pmac_zilog - port 3
  2793 + 196 = /dev/ttyTX0 TX39/49 serial port 0
  2794 + ...
  2795 + 204 = /dev/ttyTX7 TX39/49 serial port 7
  2796 + 205 = /dev/ttySC0 SC26xx serial port 0
  2797 + 206 = /dev/ttySC1 SC26xx serial port 1
  2798 + 207 = /dev/ttySC2 SC26xx serial port 2
  2799 + 208 = /dev/ttySC3 SC26xx serial port 3
2813 2800  
2814 2801 205 char Low-density serial ports (alternate device)
2815 2802 0 = /dev/culu0 Callout device for ttyLU0
... ... @@ -3144,6 +3131,14 @@
3144 3131 0 = /dev/blockrom0 First ROM card's translation layer interface
3145 3132 1 = /dev/blockrom1 Second ROM card's translation layer interface
3146 3133 ...
  3134 +
  3135 +259 block Block Extended Major
  3136 + Used dynamically to hold additional partition minor
  3137 + numbers and allow large numbers of partitions per device
  3138 +
  3139 +259 char FPGA configuration interfaces
  3140 + 0 = /dev/icap0 First Xilinx internal configuration
  3141 + 1 = /dev/icap1 Second Xilinx internal configuration
3147 3142  
3148 3143 260 char OSD (Object-based-device) SCSI Device
3149 3144 0 = /dev/osd0 First OSD Device