Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

remove mentionings of devfs in documentation

Now that devfs is removed, there's no longer any need to document how to
do this or that with devfs.

This patch includes some improvements by Joe Perches.

Signed-off-by: Adrian Bunk <bunk@stusta.de>

+19 -203
+1 -2
Documentation/DocBook/usb.tmpl
··· 314 314 <emphasis>usbdevfs</emphasis> although it wasn't solving what 315 315 <emphasis>devfs</emphasis> was. 316 316 Every USB device will appear in usbfs, regardless of whether or 317 - not it has a kernel driver; but only devices with kernel drivers 318 - show up in devfs. 317 + not it has a kernel driver. 319 318 </para> 320 319 321 320 <sect1>
+1 -6
Documentation/DocBook/writing_usb_driver.tmpl
··· 224 224 Conversely, when the device is removed from the USB bus, the disconnect 225 225 function is called with the device pointer. The driver needs to clean any 226 226 private data that has been allocated at this time and to shut down any 227 - pending urbs that are in the USB system. The driver also unregisters 228 - itself from the devfs subsystem with the call: 227 + pending urbs that are in the USB system. 229 228 </para> 230 - <programlisting> 231 - /* remove our devfs node */ 232 - devfs_unregister(skel->devfs); 233 - </programlisting> 234 229 <para> 235 230 Now that the device is plugged into the system and the driver is bound to 236 231 the device, any of the functions in the file_operations structure that
+2 -2
Documentation/arm/SA1100/serial_UART
··· 24 24 > 7 = /dev/cusa2 Callout device for ttySA2 25 25 > 26 26 27 - If you're not using devfs, you must create those inodes in /dev 28 - on the root filesystem used by your SA1100-based device: 27 + You must create those inodes in /dev on the root filesystem used 28 + by your SA1100-based device: 29 29 30 30 mknod ttySA0 c 204 5 31 31 mknod ttySA1 c 204 6
+2 -68
Documentation/computone.txt
··· 199 199 Linux tty naming conventions: ttyF0 - ttyF255 for normal devices, and 200 200 cuf0 - cuf255 for callout devices. 201 201 202 - If you are using devfs, existing devices are automatically created within 203 - the devfs name space. Normal devices will be tts/F0 - tts/F255 and callout 204 - devices will be cua/F0 - cua/F255. With devfs installed, ip2mkdev will 205 - create symbolic links in /dev from the old conventional names to the newer 206 - devfs names as follows: 207 - 208 - /dev/ip2ipl[n] -> /dev/ip2/ipl[n] n = 0 - 3 209 - /dev/ip2stat[n] -> /dev/ip2/stat[n] n = 0 - 3 210 - /dev/ttyF[n] -> /dev/tts/F[n] n = 0 - 255 211 - /dev/cuf[n] -> /dev/cua/F[n] n = 0 - 255 212 - 213 - Only devices for existing ports and boards will be created. 214 - 215 - IMPORTANT NOTE: The naming convention used for devfs by this driver 216 - was changed from 1.2.12 to 1.2.13. The old naming convention was to 217 - use ttf/%d for the tty device and cuf/%d for the cua device. That 218 - has been changed to conform to an agreed-upon standard of placing 219 - all the tty devices under tts. The device names are now tts/F%d for 220 - the tty device and cua/F%d for the cua devices. If you were using 221 - the older devfs names, you must update for the newer convention. 222 - 223 - You do not need to run ip2mkdev if you are using devfs and only want to 224 - use the devfs native device names. 225 - 226 202 227 203 4. USING THE DRIVERS 228 204 ··· 232 256 use the ip2mkdev script, you must have procfs enabled and the proc file 233 257 system mounted on /proc. 234 258 235 - You do not need to run ip2mkdev if you are using devfs and only want to 236 - use the devfs native device names. 237 259 238 - 239 - 6. DEVFS 240 - 241 - DEVFS is the DEVice File System available as an add on package for the 242 - 2.2.x kernels and available as a configuration option in 2.3.46 and higher. 243 - Devfs allows for the automatic creation and management of device names 244 - under control of the device drivers themselves. The Devfs namespace is 245 - hierarchical and reduces the clutter present in the normal flat /dev 246 - namespace. Devfs names and conventional device names may be intermixed. 247 - A userspace daemon, devfsd, exists to allow for automatic creation and 248 - management of symbolic links from the devfs name space to the conventional 249 - names. More details on devfs can be found on the DEVFS home site at 250 - <http://www.atnf.csiro.au/~rgooch/linux/> or in the file kernel 251 - documentation files, .../linux/Documentation/filesystems/devfs/README. 252 - 253 - If you are using devfs, existing devices are automatically created within 254 - the devfs name space. Normal devices will be tts/F0 - tts/F255 and callout 255 - devices will be cua/F0 - cua/F255. With devfs installed, ip2mkdev will 256 - create symbolic links in /dev from the old conventional names to the newer 257 - devfs names as follows: 258 - 259 - /dev/ip2ipl[n] -> /dev/ip2/ipl[n] n = 0 - 3 260 - /dev/ip2stat[n] -> /dev/ip2/stat[n] n = 0 - 3 261 - /dev/ttyF[n] -> /dev/tts/F[n] n = 0 - 255 262 - /dev/cuf[n] -> /dev/cua/F[n] n = 0 - 255 263 - 264 - Only devices for existing ports and boards will be created. 265 - 266 - IMPORTANT NOTE: The naming convention used for devfs by this driver 267 - was changed from 1.2.12 to 1.2.13. The old naming convention was to 268 - use ttf/%d for the tty device and cuf/%d for the cua device. That 269 - has been changed to conform to an agreed-upon standard of placing 270 - all the tty devices under tts. The device names are now tts/F%d for 271 - the tty device and cua/F%d for the cua devices. If you were using 272 - the older devfs names, you must update for the newer convention. 273 - 274 - You do not need to run ip2mkdev if you are using devfs and only want to 275 - use the devfs native device names. 276 - 277 - 278 - 7. NOTES 260 + 6. NOTES 279 261 280 262 This is a release version of the driver, but it is impossible to test it 281 263 in all configurations of Linux. If there is any anomalous behaviour that 282 264 does not match the standard serial port's behaviour please let us know. 283 265 284 266 285 - 8. ip2mkdev shell script 267 + 7. ip2mkdev shell script 286 268 287 269 Previously, this script was simply attached here. It is now attached as a 288 270 shar archive to make it easier to extract the script from the documentation.
-2
Documentation/filesystems/00-INDEX
··· 26 26 - info on the cram filesystem for small storage (ROMs etc). 27 27 dentry-locking.txt 28 28 - info on the RCU-based dcache locking model. 29 - devfs/ 30 - - directory containing devfs documentation. 31 29 directory-locking 32 30 - info about the locking scheme used for directory operations. 33 31 dlmfs.txt
+1 -1
Documentation/filesystems/tmpfs.txt
··· 39 39 tmpfs /dev/shm tmpfs defaults 0 0 40 40 41 41 Remember to create the directory that you intend to mount tmpfs on 42 - if necessary (/dev/shm is automagically created if you use devfs). 42 + if necessary. 43 43 44 44 This mount is _not_ needed for SYSV shared memory. The internal 45 45 mount is used for that. (In the 2.3 kernel versions it was
+2 -2
Documentation/input/input.txt
··· 68 68 69 69 crw-r--r-- 1 root root 13, 63 Mar 28 22:45 mice 70 70 71 - This device has to be created, unless you use devfs, in which case it's 72 - created automatically. The commands to do create it by hand are: 71 + This device has to be created. 72 + The commands to create it by hand are: 73 73 74 74 cd /dev 75 75 mkdir input
+1 -1
Documentation/input/joystick.txt
··· 60 60 61 61 2.2 Device nodes 62 62 ~~~~~~~~~~~~~~~~ 63 - For applications to be able to use the joysticks, in you don't use devfs, 63 + For applications to be able to use the joysticks, 64 64 you'll have to manually create these nodes in /dev: 65 65 66 66 cd /dev
-11
Documentation/kernel-docs.txt
··· 290 290 Description: Very nice 92 pages GPL book on the topic of modules 291 291 programming. Lots of examples. 292 292 293 - * Title: "Device File System (devfs) Overview" 294 - Author: Richard Gooch. 295 - URL: http://www.atnf.csiro.au/people/rgooch/linux/docs/devfs.html 296 - Keywords: filesystem, /dev, devfs, dynamic devices, major/minor 297 - allocation, device management. 298 - Description: Document describing Richard Gooch's controversial 299 - devfs, which allows for dynamic devices, only shows present 300 - devices in /dev, gets rid of major/minor numbers allocation 301 - problems, and allows for hundreds of identical devices (which some 302 - USB systems might demand soon). 303 - 304 293 * Title: "I/O Event Handling Under Linux" 305 294 Author: Richard Gooch. 306 295 URL: http://www.atnf.csiro.au/~rgooch/linux/docs/io-events.html
+1 -3
Documentation/s390/3270.txt
··· 111 111 config3270.sh. Inspect the output script it produces, 112 112 /tmp/mkdev3270, and then run that script. This will create the 113 113 necessary character special device files and make the necessary 114 - changes to /etc/inittab. If you have selected DEVFS, the driver 115 - itself creates the device files, and /tmp/mkdev3270 only changes 116 - /etc/inittab. 114 + changes to /etc/inittab. 117 115 118 116 Then notify /sbin/init that /etc/inittab has changed, by issuing 119 117 the telinit command with the q operand:
+1 -2
Documentation/scsi/osst.txt
··· 56 56 57 57 Now, your osst driver is inside the kernel or available as a module, 58 58 depending on your choice during kernel config. You may still need to create 59 - the device nodes by calling the Makedevs.sh script (see below) manually, 60 - unless you use a devfs kernel, where this won't be needed. 59 + the device nodes by calling the Makedevs.sh script (see below) manually. 61 60 62 61 To load your module, you may use the command 63 62 modprobe osst
-20
Documentation/sound/alsa/ALSA-Configuration.txt
··· 57 57 - Default: 1 58 58 - For auto-loading more than one card, specify this 59 59 option together with snd-card-X aliases. 60 - device_mode 61 - - permission mask for dynamic sound device filesystem 62 - - This is available only when DEVFS is enabled 63 - - Default: 0666 64 - - E.g.: device_mode=0660 65 60 66 61 67 62 Module snd-pcm-oss ··· 1908 1913 1909 1914 Please note that the device mapping above may be varied via the module 1910 1915 options of snd-pcm-oss module. 1911 - 1912 - 1913 - DEVFS support 1914 - ============= 1915 - 1916 - The ALSA driver fully supports the devfs extension. 1917 - You should add lines below to your devfsd.conf file: 1918 - 1919 - LOOKUP snd MODLOAD ACTION snd 1920 - REGISTER ^sound/.* PERMISSIONS root.audio 660 1921 - REGISTER ^snd/.* PERMISSIONS root.audio 660 1922 - 1923 - Warning: These lines assume that you have the audio group in your system. 1924 - Otherwise replace audio word with another group name (root for 1925 - example). 1926 1916 1927 1917 1928 1918 Proc interfaces (/proc/asound)
+2 -52
Documentation/uml/UserModeLinux-HOWTO.txt
··· 157 157 13. What to do when UML doesn't work 158 158 159 159 13.1 Strange compilation errors when you build from source 160 - 13.2 UML hangs on boot after mounting devfs 160 + 13.2 (obsolete) 161 161 13.3 A variety of panics and hangs with /tmp on a reiserfs filesystem 162 162 13.4 The compile fails with errors about conflicting types for 'open', 'dup', and 'waitpid' 163 163 13.5 UML doesn't work when /tmp is an NFS filesystem ··· 377 377 378 378 where 'x' is the version in your pool. Note that you will not get the 379 379 bug fixes and enhancements that have gone into subsequent releases. 380 - 381 - 382 - If you build your own kernel, and want to boot it from one of the 383 - filesystems distributed from this site, then, in nearly all cases, 384 - devfs must be compiled into the kernel and mounted at boot time. The 385 - exception is the SuSE filesystem. For this, devfs must either not be 386 - in the kernel at all, or "devfs=nomount" must be on the kernel command 387 - line. Any disagreement between the kernel and the filesystem being 388 - booted about whether devfs is being used will result in the boot 389 - getting no further than single-user mode. 390 - 391 - 392 - If you don't want to use devfs, you can remove the need for it from a 393 - filesystem by copying /dev from someplace, making a bunch of /dev/ubd 394 - devices: 395 - 396 - 397 - UML# for i in 0 1 2 3 4 5 6 7; do mknod ubd$i b 98 $i; done 398 - 399 - 400 - 401 - 402 - and changing /etc/fstab and /etc/inittab to refer to the non-devfs 403 - devices. 404 - 405 380 406 381 407 382 22..22.. CCoommppiilliinngg aanndd iinnssttaalllliinngg kkeerrnneell mmoodduulleess ··· 814 839 +o None - device=none 815 840 816 841 817 - This causes the device to disappear. If you are using devfs, the 818 - device will not appear in /dev. If not, then attempts to open it 819 - will return -ENODEV. 842 + This causes the device to disappear. 820 843 821 844 822 845 ··· 3868 3895 /usr/src/linux/asm-i386. Then, move your UML pool someplace else and 3869 3896 build it there. Also see below, where a more specific set of symptoms 3870 3897 is described. 3871 - 3872 - 3873 - 3874 - 1133..22.. UUMMLL hhaannggss oonn bboooott aafftteerr mmoouunnttiinngg ddeevvffss 3875 - 3876 - The boot looks like this: 3877 - 3878 - 3879 - VFS: Mounted root (ext2 filesystem) readonly. 3880 - Mounted devfs on /dev 3881 - 3882 - 3883 - 3884 - 3885 - You're probably running a recent distribution on an old machine. I 3886 - saw this with the RH7.1 filesystem running on a Pentium. The shared 3887 - library loader, ld.so, was executing an instruction (cmove) which the 3888 - Pentium didn't support. That instruction was apparently added later. 3889 - If you run UML under the debugger, you'll see the hang caused by one 3890 - instruction causing an infinite SIGILL stream. 3891 - 3892 - 3893 - The fix is to boot UML on an older filesystem. 3894 3898 3895 3899 3896 3900
-14
Documentation/usb/acm.txt
··· 49 49 Unfortunately many modems and most ISDN TAs use proprietary interfaces and 50 50 thus won't work with this drivers. Check for ACM compliance before buying. 51 51 52 - The driver (with devfs) creates these devices in /dev/usb/acm: 53 - 54 - crw-r--r-- 1 root root 166, 0 Apr 1 10:49 0 55 - crw-r--r-- 1 root root 166, 1 Apr 1 10:49 1 56 - crw-r--r-- 1 root root 166, 2 Apr 1 10:49 2 57 - 58 - And so on, up to 31, with the limit being possible to change in acm.c to up 59 - to 256, so you can use up to 256 USB modems with one computer (you'll need 60 - three USB cards for that, though). 61 - 62 - If you don't use devfs, then you can create device nodes with the same 63 - minor/major numbers anywhere you want, but either the above location or 64 - /dev/usb/ttyACM0 is preferred. 65 - 66 52 To use the modems you need these modules loaded: 67 53 68 54 usbcore.ko
-5
Documentation/usb/usb-serial.txt
··· 13 13 Currently the driver can handle up to 256 different serial interfaces at 14 14 one time. 15 15 16 - If you are not using devfs: 17 16 The major number that the driver uses is 188 so to use the driver, 18 17 create the following nodes: 19 18 mknod /dev/ttyUSB0 c 188 0 ··· 24 25 . 25 26 mknod /dev/ttyUSB254 c 188 254 26 27 mknod /dev/ttyUSB255 c 188 255 27 - 28 - If you are using devfs: 29 - The devices supported by this driver will show up as 30 - /dev/usb/tts/{0,1,...} 31 28 32 29 When the device is connected and recognized by the driver, the driver 33 30 will print to the system log, which node(s) the device has been bound
+1 -2
drivers/block/Kconfig
··· 207 207 module will be called umem. 208 208 209 209 The umem driver has not yet been allocated a MAJOR number, so 210 - one is chosen dynamically. Use "devfs" or look in /proc/devices 211 - for the device number 210 + one is chosen dynamically. 212 211 213 212 config BLK_DEV_UBD 214 213 bool "Virtual block device"
+1 -4
drivers/char/mwave/README
··· 41 41 Accessing the driver 42 42 -------------------- 43 43 44 - You must also create a node for the driver. Without devfs: 44 + You must also create a node for the driver: 45 45 mkdir -p /dev/modems 46 46 mknod --mode=660 /dev/modems/mwave c 10 219 47 - With devfs: 48 - mkdir -p /dev/modems 49 - ln -s ../misc/mwave /dev/modems/mwave 50 47
+1 -2
drivers/media/radio/Kconfig
··· 195 195 ---help--- 196 196 Choose Y here if you want to see RDS/RBDS information like 197 197 RadioText, Programme Service name, Clock Time and date, Programme 198 - TYpe and Traffic Announcement/Programme identification. You also 199 - need to say Y to "miroSOUND PCM20 radio" and devfs! 198 + Type and Traffic Announcement/Programme identification. 200 199 201 200 It's not possible to read the raw RDS packets from the device, so 202 201 the driver cant provide an V4L interface for this. But the
+2 -2
drivers/media/video/pwc/philips.txt
··· 175 175 - If a device node is already occupied, registration will fail and 176 176 the webcam is not available. 177 177 - You can have up to 64 video devices; be sure to make enough device 178 - nodes in /dev if you want to spread the numbers (this does not apply 179 - to devfs). After /dev/video9 comes /dev/video10 (not /dev/videoA). 178 + nodes in /dev if you want to spread the numbers. 179 + After /dev/video9 comes /dev/video10 (not /dev/videoA). 180 180 - If a camera does not match any dev_hint, it will simply get assigned 181 181 the first available device node, just as it used to be. 182 182
-2
drivers/sbus/char/cpwatchdog.c
··· 10 10 * timer interrupts. We use a timer to periodically 11 11 * reset 'stopped' watchdogs on affected platforms. 12 12 * 13 - * TODO: DevFS support (/dev/watchdogs/0 ... /dev/watchdogs/2) 14 - * 15 13 * Copyright (c) 2000 Eric Brower (ebrower@usa.net) 16 14 */ 17 15