media: docs: get rid of obsoleted udev documentation
authorMauro Carvalho Chehab <mchehab+huawei@kernel.org>
Tue, 10 Mar 2020 12:42:41 +0000 (13:42 +0100)
committerMauro Carvalho Chehab <mchehab+huawei@kernel.org>
Wed, 15 Apr 2020 13:51:23 +0000 (15:51 +0200)
This file is very old, and doesn't match the current udev
behavior.

I wanted to preserve it, because we'll need some udev
description some day about how to keep names unique,
but there's nothing here to help with that...

So, be it: let's just discard this document, as it doesn't
provide anything useful anymore.

Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>
Documentation/admin-guide/media/bt8xx.rst
Documentation/admin-guide/media/index.rst
Documentation/admin-guide/media/udev.rst [deleted file]

index 707919f29c86a98d53e23d796c5f1eca9d7085bc..a55f4f5af042abe336177665e26ce14d0fb09eb8 100644 (file)
@@ -74,8 +74,6 @@ Exceptions are:
 - Old TwinHan DST cards or clones with or without CA slot and not
   containing an Eeprom.
 
-People running udev please see :doc:`udev`.
-
 In the following cases overriding the PCI type detection for bttv and
 for dvb-bt8xx drivers by passing modprobe parameters may be necessary.
 
index 11d01d681b57f8cf01d6f08a57afc95d3391bccd..04bc259f3325edd193c1aa6ffe7d41f337bce5f6 100644 (file)
@@ -84,7 +84,6 @@ Linux Digital TV driver-specific documentation
        opera-firmware
        technisat
        ttusb-dec
-       udev
        zr364xx
 
 #################################
diff --git a/Documentation/admin-guide/media/udev.rst b/Documentation/admin-guide/media/udev.rst
deleted file mode 100644 (file)
index ca6c9c2..0000000
+++ /dev/null
@@ -1,63 +0,0 @@
-.. SPDX-License-Identifier: GPL-2.0
-
-UDEV rules for DVB
-==================
-
-.. note::
-
-   #) This documentation is outdated. Udev on modern distributions auto-detect
-      the DVB devices.
-
-   #) **TODO:** change this document to explain how to make DVB devices
-      persistent, as, when a machine has multiple devices, they may be detected
-      on different orders, which could cause apps that relies on the device
-      numbers to fail.
-
-The DVB subsystem currently registers to the sysfs subsystem using the
-"class_simple" interface.
-
-This means that only the basic information like module loading parameters
-are presented through sysfs. Other things that might be interesting are
-currently **not** available.
-
-Nevertheless it's now possible to add proper udev rules so that the
-DVB device nodes are created automatically.
-
-We assume that you have udev already up and running and that have been
-creating the DVB device nodes manually up to now due to the missing sysfs
-support.
-
-0. Don't forget to disable your current method of creating the
-device nodes manually.
-
-1. Unfortunately, you'll need a helper script to transform the kernel
-sysfs device name into the well known dvb adapter / device naming scheme.
-The script should be called "dvb.sh" and should be placed into a script
-dir where udev can execute it, most likely /etc/udev/scripts/
-
-So, create a new file /etc/udev/scripts/dvb.sh and add the following:
-
-.. code-block:: none
-
-       #!/bin/sh
-       /bin/echo $1 | /bin/sed -e 's,dvb\([0-9]\)\.\([^0-9]*\)\([0-9]\),dvb/adapter\1/\2\3,'
-
-Don't forget to make the script executable with "chmod".
-
-1. You need to create a proper udev rule that will create the device nodes
-like you know them. All real distributions out there scan the /etc/udev/rules.d
-directory for rule files. The main udev configuration file /etc/udev/udev.conf
-will tell you the directory where the rules are, most likely it's /etc/udev/rules.d/
-
-Create a new rule file in that directory called "dvb.rule" and add the following line:
-
-.. code-block:: none
-
-       KERNEL="dvb*", PROGRAM="/etc/udev/scripts/dvb.sh %k", NAME="%c"
-
-If you want more control over the device nodes (for example a special group membership)
-have a look at "man udev".
-
-For every device that registers to the sysfs subsystem with a "dvb" prefix,
-the helper script /etc/udev/scripts/dvb.sh is invoked, which will then
-create the proper device node in your /dev/ directory.