Skip to contentSkip to conversation

remove mentionings of devfs in documentation

PATCH In review Adrian Bunk 2 participants 3 messages Jul 11, 2006 – Jul 12, 2006

Subsystems (8)
lore
Share & tools
lore
#0 lore raw

PATCH 1/1 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.

---

 Documentation/ABI/obsolete/devfs                |   13 ---
 Documentation/DocBook/usb.tmpl                  |    3 
 Documentation/DocBook/writing_usb_driver.tmpl   |    7 -
 Documentation/arm/SA1100/serial_UART            |    4 
 Documentation/computone.txt                     |   67 ----------------
 Documentation/feature-list-2.6.txt              |   10 --
 Documentation/filesystems/00-INDEX              |    2 
 Documentation/filesystems/tmpfs.txt             |    2 
 Documentation/input/input.txt                   |    4 
 Documentation/input/joystick.txt                |    2 
 Documentation/ioctl-mess.txt                    |   17 ----
 Documentation/kernel-docs.txt                   |   11 --
 Documentation/s390/3270.txt                     |    4 
 Documentation/scsi/osst.txt                     |    3 
 Documentation/sound/alsa/ALSA-Configuration.txt |   20 ----
 Documentation/uml/UserModeLinux-HOWTO.txt       |   54 ------------
 Documentation/usb/acm.txt                       |   14 ---
 Documentation/usb/usb-serial.txt                |    5 -
 drivers/block/Kconfig                           |    3 
 drivers/char/mwave/README                       |    5 -
 drivers/media/radio/Kconfig                     |    3 
 drivers/media/video/pwc/philips.txt             |    4 
 drivers/sbus/char/cpwatchdog.c                  |    2 
 23 files changed, 19 insertions(+), 240 deletions(-)
Documentation/DocBook/usb.tmpl renamed from Documentation/DocBook/usb.tmpl.old +0 -3
@@ -323,9 +323,6 @@
 	Until relatively recently it was often (confusingly) called
 	<emphasis>usbdevfs</emphasis> although it wasn't solving what
 	<emphasis>devfs</emphasis> was.
-	Every USB device will appear in usbfs, regardless of whether or
-	not it has a kernel driver; but only devices with kernel drivers
-	show up in devfs.
 	</para>
 
 	<sect1>
Documentation/DocBook/writing_usb_driver.tmpl renamed from Documentation/DocBook/writing_usb_driver.tmpl.old +1 -6
@@ -224,13 +224,8 @@
      Conversely, when the device is removed from the USB bus, the disconnect
      function is called with the device pointer. The driver needs to clean any
      private data that has been allocated at this time and to shut down any
-     pending urbs that are in the USB system. The driver also unregisters
-     itself from the devfs subsystem with the call:
+     pending urbs that are in the USB system.
   </para>
-  <programlisting>
-/* remove our devfs node */
-devfs_unregister(skel->devfs);
-  </programlisting>
   <para>
      Now that the device is plugged into the system and the driver is bound to
      the device, any of the functions in the file_operations structure that
Documentation/arm/SA1100/serial_UART renamed from Documentation/arm/SA1100/serial_UART.old +2 -2
@@ -24,8 +24,8 @@
 >                   7 = /dev/cusa2                Callout device for ttySA2
 >
 
-If you're not using devfs, you must create those inodes in /dev
-on the root filesystem used by your SA1100-based device:
+You must create those inodes in /dev on the root filesystem used
+by your SA1100-based device:
 
 	mknod ttySA0 c 204 5
 	mknod ttySA1 c 204 6
Documentation/computone.txt renamed from Documentation/computone.txt.old +2 -65

85 lines not on this page · raw message

Documentation/filesystems/00-INDEX renamed from Documentation/filesystems/00-INDEX.old +0 -2
@@ -26,8 +26,6 @@
 	- info on the cram filesystem for small storage (ROMs etc).
 dentry-locking.txt
 	- info on the RCU-based dcache locking model.
-devfs/
-	- directory containing devfs documentation.
 directory-locking
 	- info about the locking scheme used for directory operations.
 dlmfs.txt
Documentation/filesystems/tmpfs.txt renamed from Documentation/filesystems/tmpfs.txt.old +1 -1
@@ -39,7 +39,7 @@
 	tmpfs	/dev/shm	tmpfs	defaults	0 0
 
    Remember to create the directory that you intend to mount tmpfs on
-   if necessary (/dev/shm is automagically created if you use devfs).
+   if necessary.
 
    This mount is _not_ needed for SYSV shared memory. The internal
    mount is used for that. (In the 2.3 kernel versions it was
Documentation/input/input.txt renamed from Documentation/input/input.txt.old +2 -2
@@ -68,8 +68,8 @@
 
 	crw-r--r--   1 root     root      13,  63 Mar 28 22:45 mice
 
-  This device has to be created, unless you use devfs, in which case it's
-created automatically. The commands to do create it by hand are:
+  This device has to be created.
+  The commands to do create it by hand are:
 
 	cd /dev
 	mkdir input
Documentation/input/joystick.txt renamed from Documentation/input/joystick.txt.old +1 -1
@@ -61,7 +61,7 @@
 
 2.2 Device nodes
 ~~~~~~~~~~~~~~~~
-For applications to be able to use the joysticks, in you don't use devfs,
+For applications to be able to use the joysticks,
 you'll have to manually create these nodes in /dev:
 
 cd /dev
Documentation/kernel-docs.txt renamed from Documentation/kernel-docs.txt.old +0 -11
@@ -290,17 +290,6 @@
        Description: Very nice 92 pages GPL book on the topic of modules
        programming. Lots of examples.
        
-     * Title: "Device File System (devfs) Overview"
-       Author: Richard Gooch.
-       URL: http://www.atnf.csiro.au/people/rgooch/linux/docs/devfs.html
-       Keywords: filesystem, /dev, devfs, dynamic devices, major/minor
-       allocation, device management.
-       Description: Document describing Richard Gooch's controversial
-       devfs, which allows for dynamic devices, only shows present
-       devices in /dev, gets rid of major/minor numbers allocation
-       problems, and allows for hundreds of identical devices (which some
-       USB systems might demand soon).
-       
      * Title: "I/O Event Handling Under Linux"
        Author: Richard Gooch.
        URL: http://www.atnf.csiro.au/~rgooch/linux/docs/io-events.html
Documentation/s390/3270.txt renamed from Documentation/s390/3270.txt.old +1 -3
@@ -111,9 +111,7 @@
 	config3270.sh.	Inspect the output script it produces,
 	/tmp/mkdev3270, and then run that script.  This will create the
 	necessary character special device files and make the necessary
-	changes to /etc/inittab.  If you have selected DEVFS, the driver
-	itself creates the device files, and /tmp/mkdev3270 only changes
-	/etc/inittab.
+	changes to /etc/inittab.
 
 	Then notify /sbin/init that /etc/inittab has changed, by issuing
 	the telinit command with the q operand:
Documentation/scsi/osst.txt renamed from Documentation/scsi/osst.txt.old +1 -2
@@ -56,8 +56,7 @@
 
 Now, your osst driver is inside the kernel or available as a module,
 depending on your choice during kernel config. You may still need to create
-the device nodes by calling the Makedevs.sh script (see below) manually,
-unless you use a devfs kernel, where this won't be needed.
+the device nodes by calling the Makedevs.sh script (see below) manually.
 
 To load your module, you may use the command 
 modprobe osst
Documentation/sound/alsa/ALSA-Configuration.txt renamed from Documentation/sound/alsa/ALSA-Configuration.txt.old +0 -20
@@ -57,11 +57,6 @@
 		- Default: 1
 		- For auto-loading more than one card, specify this
 		  option together with snd-card-X aliases.
-    device_mode
-		- permission mask for dynamic sound device filesystem
-		- This is available only when DEVFS is enabled
-		- Default: 0666
-		- E.g.: device_mode=0660
 
   
   Module snd-pcm-oss
@@ -1881,21 +1876,6 @@
 options of snd-pcm-oss module.
 
 
-DEVFS support
-=============
-
-The ALSA driver fully supports the devfs extension.
-You should add lines below to your devfsd.conf file:
-
-LOOKUP snd MODLOAD ACTION snd
-REGISTER ^sound/.* PERMISSIONS root.audio 660
-REGISTER ^snd/.* PERMISSIONS root.audio 660
-
-Warning: These lines assume that you have the audio group in your system.
-         Otherwise replace audio word with another group name (root for
-         example).
-
-
 Proc interfaces (/proc/asound)
 ==============================
 
Documentation/uml/UserModeLinux-HOWTO.txt renamed from Documentation/uml/UserModeLinux-HOWTO.txt.old +2 -52

78 lines not on this page · raw message

Documentation/usb/acm.txt renamed from Documentation/usb/acm.txt.old +0 -14
@@ -49,20 +49,6 @@
   Unfortunately many modems and most ISDN TAs use proprietary interfaces and
 thus won't work with this drivers. Check for ACM compliance before buying.
 
-  The driver (with devfs) creates these devices in /dev/usb/acm:
-
-	crw-r--r--   1 root     root     166,   0 Apr  1 10:49 0
-	crw-r--r--   1 root     root     166,   1 Apr  1 10:49 1
-	crw-r--r--   1 root     root     166,   2 Apr  1 10:49 2
-
-  And so on, up to 31, with the limit being possible to change in acm.c to up
-to 256, so you can use up to 256 USB modems with one computer (you'll need
-three USB cards for that, though).
-
-  If you don't use devfs, then you can create device nodes with the same
-minor/major numbers anywhere you want, but either the above location or
-/dev/usb/ttyACM0 is preferred.
-
   To use the modems you need these modules loaded:
 
 	usbcore.ko
Documentation/usb/usb-serial.txt renamed from Documentation/usb/usb-serial.txt.old +0 -5
@@ -13,7 +13,6 @@
   Currently the driver can handle up to 256 different serial interfaces at
   one time. 
 
-  If you are not using devfs:
     The major number that the driver uses is 188 so to use the driver,
     create the following nodes:
 	mknod /dev/ttyUSB0 c 188 0
@@ -26,10 +25,6 @@
 	mknod /dev/ttyUSB254 c 188 254
 	mknod /dev/ttyUSB255 c 188 255
 
-  If you are using devfs:
-    The devices supported by this driver will show up as
-    /dev/usb/tts/{0,1,...}
-
   When the device is connected and recognized by the driver, the driver
   will print to the system log, which node(s) the device has been bound
   to.
Documentation/feature-list-2.6.txt renamed from Documentation/feature-list-2.6.txt.old +1 -9
@@ -91,7 +91,7 @@
 
 Deprecated/obsolete features.
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-- devfs will be obsoleted in favour of udev (http://www.kernel.org/pub/linux/utils/kernel/hotplug/)
+- devfs was obsoleted in favour of udev (http://www.kernel.org/pub/linux/utils/kernel/hotplug/)
 - boot time root= parsing changed.
   ramdisks are now ram<n> instead of rd<n> and cm206 is cm206cd (instead of
   cm206).
@@ -683,14 +683,6 @@
 
 
 
-devfs.
-~~~~~~
-- devfs was somewhat stripped down and a lot of duplicate functionality
-  was removed. You now need to enable CONFIG_DEVPTS_FS=y and mount
-  the devpts filesystem in the same manner you would if you were not
-  using devfs.
-
-
 EXT2.
 ~~~~~
 - 2.5.49 included an extension to ext2 which will cause it to not attach
Documentation/ioctl-mess.txt renamed from Documentation/ioctl-mess.txt.old +0 -17
@@ -1109,23 +1109,6 @@
 DECODER_SET_OUTPUT
 DECODER_SET_PICTURE
 DECODER_SET_VBI_BYPASS
-
-N: DEVFSDIOC_GET_PROTO_REV
-I: -
-O: int
-
-N: DEVFSDIOC_RELEASE_EVENT_QUEUE
-I: -
-O: -
-
-N: DEVFSDIOC_SET_DEBUG_MASK
-I: int
-O: -
-
-N: DEVFSDIOC_SET_EVENT_MASK
-I: (int) arg
-O: -
-
 DMX_GET_CAPS
 DMX_GET_EVENT
 DMX_GET_PES_PIDS
drivers/block/Kconfig renamed from drivers/block/Kconfig.old +1 -2
@@ -205,8 +205,7 @@
 	  module will be called umem.
 
 	  The umem driver has not yet been allocated a MAJOR number, so
-	  one is chosen dynamically.  Use "devfs" or look in /proc/devices
-	  for the device number
+	  one is chosen dynamically.
 
 config BLK_DEV_UBD
 	bool "Virtual block device"
drivers/char/mwave/README renamed from drivers/char/mwave/README.old +1 -4
@@ -41,10 +41,7 @@
 Accessing the driver
 --------------------
 
-You must also create a node for the driver.  Without devfs:
+You must also create a node for the driver:
   mkdir -p /dev/modems
   mknod --mode=660 /dev/modems/mwave c 10 219
-With devfs:
-  mkdir -p /dev/modems
-  ln -s ../misc/mwave /dev/modems/mwave
 
drivers/media/radio/Kconfig renamed from drivers/media/radio/Kconfig.old +1 -2
@@ -195,8 +195,7 @@
 	---help---
 	  Choose Y here if you want to see RDS/RBDS information like
 	  RadioText, Programme Service name, Clock Time and date, Programme
-	  TYpe and Traffic Announcement/Programme identification.  You also
-	  need to say Y to "miroSOUND PCM20 radio" and devfs!
+	  TYpe and Traffic Announcement/Programme identification.
 
 	  It's not possible to read the raw RDS packets from the device, so
 	  the driver cant provide an V4L interface for this.  But the
drivers/media/video/pwc/philips.txt renamed from drivers/media/video/pwc/philips.txt.old +2 -2
@@ -175,8 +175,8 @@
    - If a device node is already occupied, registration will fail and
      the webcam is not available.
    - You can have up to 64 video devices; be sure to make enough device
-     nodes in /dev if you want to spread the numbers (this does not apply
-     to devfs). After /dev/video9 comes /dev/video10 (not /dev/videoA).
+     nodes in /dev if you want to spread the numbers.
+     After /dev/video9 comes /dev/video10 (not /dev/videoA).
    - If a camera does not match any dev_hint, it will simply get assigned
      the first available device node, just as it used to be.
 
drivers/sbus/char/cpwatchdog.c renamed from drivers/sbus/char/cpwatchdog.c.old +0 -2
@@ -10,8 +10,6 @@
  * 			timer interrupts.  We use a timer to periodically 
  * 			reset 'stopped' watchdogs on affected platforms.
  *
- * TODO:	DevFS support (/dev/watchdogs/0 ... /dev/watchdogs/2)
- *
  * Copyright (c) 2000 Eric Brower ([email protected])
  */
 
Documentation/ABI/obsolete/devfs deleted +0 -13
@@ -1,13 +0,0 @@
-What:		devfs
-Date:		July 2005
-Contact:	Greg Kroah-Hartman <[email protected]>
-Description:
-	devfs has been unmaintained for a number of years, has unfixable
-	races, contains a naming policy within the kernel that is
-	against the LSB, and can be replaced by using udev.
-	The files fs/devfs/*, include/linux/devfs_fs*.h will be removed,
-	along with the the assorted devfs function calls throughout the
-	kernel tree.
-
-Users:
-
#1 lore raw

Hi Adrian,

Adrian Bunk:

Quoted 6 lines

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

---

[snip]

Quoted 6 lines
Documentation/ABI/obsolete/devfs deleted +0 -3
@@ -1,13 +0,0 @@
-What:		devfs
-Date:		July 2005
-Contact:	Greg Kroah-Hartman <[email protected]>

Documentation/ABI/obsolete/devfs line 13

Quoted 10 lines
Documentation/ABI/obsolete/devfs deleted +0 -10
-Description:
-	devfs has been unmaintained for a number of years, has unfixable
-	races, contains a naming policy within the kernel that is
-	against the LSB, and can be replaced by using udev.
-	The files fs/devfs/*, include/linux/devfs_fs*.h will be removed,
-	along with the the assorted devfs function calls throughout the
-	kernel tree.
-
-Users:
-

According to Documentation/ABI/README
" removed/
This directory contains a list of the old interfaces that have been removed from the kernel.
"

we should add devfs to removed/

Regards,
Michal

Signature · 23 lines
Michal K. K. Piotrowski
LTG - Linux Testers Group
(http://www.stardust.webpages.pl/ltg/wiki/)

Signed-off-by: Michal Piotrowski <[email protected]>

diff -uprN -X linux-work-clean/Documentation/dontdiff linux-work-clean/Documentation/ABI/removed/devfs linux-work5/Documentation/ABI/removed/devfs
--- linux-work-clean/Documentation/ABI/removed/devfs	1970-01-01 01:00:00.000000000 +0100
+++ linux-work5/Documentation/ABI/removed/devfs	2006-07-11 17:35:30.000000000 +0200
@@ -0,0 +1,13 @@
+What:		devfs
+Date:		July 2005
+Contact:	Greg Kroah-Hartman <[email protected]>
+Description:
+	devfs has been unmaintained for a number of years, has unfixable
+	races, contains a naming policy within the kernel that is
+	against the LSB, and can be replaced by using udev.
+	The files fs/devfs/*, include/linux/devfs_fs*.h will be removed,
+	along with the the assorted devfs function calls throughout the
+	kernel tree.
+
+Users:
+
#2 lore raw
Quoted 33 lines · Michal Piotrowski

Hi Adrian,

Adrian Bunk:

Quoted 6 lines

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

---

[snip]

Quoted 6 lines
Documentation/ABI/obsolete/devfs deleted +0 -3
@@ -1,13 +0,0 @@
-What:		devfs
-Date:		July 2005
-Contact:	Greg Kroah-Hartman <[email protected]>

Documentation/ABI/obsolete/devfs line 13

Quoted 10 lines
Documentation/ABI/obsolete/devfs deleted +0 -10
-Description:
-	devfs has been unmaintained for a number of years, has unfixable
-	races, contains a naming policy within the kernel that is
-	against the LSB, and can be replaced by using udev.
-	The files fs/devfs/*, include/linux/devfs_fs*.h will be removed,
-	along with the the assorted devfs function calls throughout the
-	kernel tree.
-
-Users:
-

According to Documentation/ABI/README
" removed/
This directory contains a list of the old interfaces that have been removed from the kernel.
"

Quoted 1 line

we should add devfs to removed/

Thanks, agreed.

Quoted 3 lines

Regards,
Michal
...

cu
Adrian

Signature · 4 lines
       "Is there not promise of rain?" Ling Tan asked suddenly out
        of the darkness. There had been need of rain for many days.
       "Only a promise," Lao Er said.
                                       Pearl S. Buck - Dragon Seed