bogus BUG_ON fix (reported by Anuz Pratap Singh Tomar), connect_port lockup fix
[cor_2_6_31.git] / Documentation / dvb / udev.txt
blob68ee224b6aaee53dda46ed6992bc4d07ffb5cf1d
1 The DVB subsystem currently registers to the sysfs subsystem using the
2 "class_simple" interface.
4 This means that only the basic informations like module loading parameters
5 are presented through sysfs. Other things that might be interesting are
6 currently *not* available.
8 Nevertheless it's now possible to add proper udev rules so that the
9 DVB device nodes are created automatically.
11 We assume that you have udev already up and running and that have been
12 creating the DVB device nodes manually up to now due to the missing sysfs
13 support.
15 0. Don't forget to disable your current method of creating the
16 device nodes manually.
18 1. Unfortunately, you'll need a helper script to transform the kernel
19 sysfs device name into the well known dvb adapter / device naming scheme.
20 The script should be called "dvb.sh" and should be placed into a script
21 dir where udev can execute it, most likely /etc/udev/scripts/
23 So, create a new file /etc/udev/scripts/dvb.sh and add the following:
24 ------------------------------schnipp------------------------------------------------
25 #!/bin/sh
26 /bin/echo $1 | /bin/sed -e 's,dvb\([0-9]\)\.\([^0-9]*\)\([0-9]\),dvb/adapter\1/\2\3,'
27 ------------------------------schnipp------------------------------------------------
29 Don't forget to make the script executable with "chmod".
31 1. You need to create a proper udev rule that will create the device nodes
32 like you know them. All real distributions out there scan the /etc/udev/rules.d
33 directory for rule files. The main udev configuration file /etc/udev/udev.conf
34 will tell you the directory where the rules are, most likely it's /etc/udev/rules.d/
36 Create a new rule file in that directory called "dvb.rule" and add the following line:
37 ------------------------------schnipp------------------------------------------------
38 KERNEL="dvb*", PROGRAM="/etc/udev/scripts/dvb.sh %k", NAME="%c"
39 ------------------------------schnipp------------------------------------------------
41 If you want more control over the device nodes (for example a special group membership)
42 have a look at "man udev".
44 For every device that registers to the sysfs subsystem with a "dvb" prefix,
45 the helper script /etc/udev/scripts/dvb.sh is invoked, which will then
46 create the proper device node in your /dev/ directory.