X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;ds=sidebyside;f=docs%2Fwriting_udev_rules%2Findex.html;h=1c5c89b3c91d512dd515f57621bd56aec2954c4a;hb=731f0aec41e3f46f5b630e70166ab384976d52c6;hp=9396184366fee2bc342346bcce292c02a70f308f;hpb=c59a72105d0ff8a47b31f1829dd3c166ebd859d0;p=elogind.git
diff --git a/docs/writing_udev_rules/index.html b/docs/writing_udev_rules/index.html
index 939618436..1c5c89b3c 100644
--- a/docs/writing_udev_rules/index.html
+++ b/docs/writing_udev_rules/index.html
@@ -8,7 +8,7 @@
Writing udev rules
by Daniel Drake (dsd)
-Version 0.55
+Version 0.6
The most recent version of this document can always be found at:
http://www.reactivated.net/udevrules.php
@@ -27,6 +27,8 @@ The most recent version of this document can always be found at:
Key-writing basics
Identifying devices through basic keys
Identifying devices through SYSFS files
+Using multiple SYMLINK style rules
+Controlling ownership and permissions
Example: Writing a rule for my USB printer
Example: Writing a rule for my USB-Storage digital camera
@@ -34,8 +36,7 @@ The most recent version of this document can always be found at:
Example: Writing convenience rules for my CD drives
Example: Writing a rule to name my network interface
Tips for finding the appropriate places in SYSFS
-Using multiple SYMLINK style rules
-udev vs Nvidia's graphics drivers
+Debugging your rules
Author and credits
@@ -53,6 +54,7 @@ This document assumes that you have udev/hotplug installed and running OK with d
History
+May 9th 2005 v0.6: Misc updates, including information about udevinfo, groups and permissions, logging, and udevtest.
June 20th 2004 v0.55: Added info on multiple symlinks, and some minor changes/updates.
April 26th 2004 v0.54: Added some Debian info. Minor corrections. Re-reverted information about what to call your rule file. Added info about naming network interfaces.
April 15th 2004 v0.53: Minor corrections. Added info about NAME{all_partitions}. Added info about other udevinfo tricks.
@@ -66,9 +68,8 @@ February 15th 2004 v0.1: Initial publication.
Software versions used at time of writing
-Linux Kernel 2.6.7
-udev 027
-hotplug 20040401
+Linux Kernel 2.6.11
+udev 056
Terminology: devfs, sysfs, nodes, etc.
@@ -97,6 +98,8 @@ However, if my HP laser printer got named lp_hp (as well as lpX) and my other pr
For external mass-storage devices (e.g. usb hard disks), persistent naming is very helpful in that it allows you to hardcode accurate device paths into your /etc/fstab.
+It is important to understand that writing rules is simply a means of customizing udev behaviour. Writing rules is not a workaround for the problem where no device nodes for your particular device exist. If no matching rules exist, udev will create the node anyway, using the name that was supplied by the kernel.
+
The basics of writing rules
@@ -104,31 +107,32 @@ When populating /dev, udev decides which nodes to include, and how to nam
Default udev rules are stored in /etc/udev/rules.d/50-udev.rules. You may find it interesting to look over this file - it includes a few examples, and then some default rules proving a devfs-style /dev layout. However, you should not write rules into this file directly, to reduce hassle while updating your udev installation in the future.
-Files in /etc/udev/rules.d/ are parsed in lexical order. udev will stop processing rules as soon as it finds a matching rule in a file for the new item of hardware that has been detected. It is important that your own rules get processed before the udev defaults, otherwise your own naming schemes will not take effect! I suggest that you keep your own rules in a file at /etc/udev/rules.d/10-local.rules (this doesn't exist by default - create it). As 10 comes before 50, you know that your rules will be looked at first.
+Files in /etc/udev/rules.d/ are parsed in lexical order. udev will stop processing rules as soon as it finds a matching rule in a file for the new item of hardware that has been detected. It is important that your own rules get processed before the udev defaults, otherwise your own naming schemes will not take effect! I suggest that you keep your own rules in a file at /etc/udev/rules.d/10-local.rules (this doesn't exist by default - create it). As 10 comes before 50, you know that your rules will be looked at first. It is important that the filenames of your rule files end with the .rules suffix, otherwise they will not be used.
As your own rules will effectively mask out the udev defaults which create the base /dev layout, it is recommended that you also specify devfs-style names/symlinks for the rules you write, so that you get the sensible defaults plus your own names.
In rule files, lines starting with a "#" are treated as comments. Every uncommented line in the file corresponds to a rule.
-The basic form for a rule is:
-key,[key,...] name [, symlink]
+Rules are composed of keys. Keys are seperated by commas. Some keys are used for reading and matching information, others are used for assigning information and performing actions. Matches and assignments are carried out with the expected operators (= and ==).
-- At least one key must be specified. Keys are used to identify which devices the rule matches.
-- The name parameter is required. It tells udev what that device should be named as in the /dev tree. It is written in the format NAME="X", where X is what the node will be named. You can specify multiple symlinks here, seperate them with a space.
-- The symlink parameter (optional) allows for you to specify additional places where this node will be linked.
+- At least one identification key should be provided, which will match the rule to any number of devices in the system. These are listed in the later section: Identifying devices through basic keys.
+- At least one assignment key should be provided, to control how the resultant device node is created. These include NAME, SYMLINK, OWNER, GROUP and MODE, all of which are described in this document.
-Remember that udev will only create one node for one device. If you want it to be accessible through multiple nodes, then you have to specify the other nodes in the SYMLINK parameter.
+Common rules will use basic identification keys to determine the device to name, and then have a NAME assignement key to define the device node name. udev will only create one node for one device, so if you want it to be accessible through multiple nodes, then you have to specify the other nodes in the SYMLINK assignment key.
I'll take a slightly modified udev example rule to illustrate this:
-BUS="usb", SYSFS{serial}="HXOLL0012202323480", NAME="lp_epson", SYMLINK="printers/epson_stylus"
+BUS=="usb", SYSFS{serial}=="HXOLL0012202323480", NAME="lp_epson", SYMLINK="printers/epson_stylus"
-The keys here are the BUS and SYSFS{serial} parameters. udev will match this rule against a device that is connected through the USB bus and with a serial number of HXOLL0012202323480. Note that all (as opposed to any) specified keys must be matched for udev to use the rule to name a device.
+The identification keys here are BUS and SYSFS{serial}. The assignment keys here are NAME and SYMLINK. udev will match this rule against a device that is connected through the USB bus and with a serial number of HXOLL0012202323480. Note that all (as opposed to any) specified keys must be matched for udev to use the rule to name a device.
udev will name this node lp_epson, and it will be located at /dev/lp_epson.
udev will also create a symlink to /dev/lp_epson, located at /dev/printers/epson_stylus (the printers directory will be automatically created). You can now print to your Epson printer by sending data to /dev/printers/epson_stylus or /dev/lp_epson.
+Any rules that you have added or modified will not take effect until you notify udev of this. Make sure you remember to run the following every time you modify any rule files:
+# udevstart
+
Additional automated customisation for NAME and SYMLINK parameters
@@ -136,7 +140,7 @@ In the NAME and SYMLINK parameters of your rules, you are able to use basic oper
There are a number of operators which can compose some or all of your NAME/SYMLINK parameters. These operators refer to kernel-data relating to the device. Take this example:
-BUS="usb", SYSFS{vendor}="FUJIFILM", SYSFS{model}="M100", NAME="camera%n"
+BUS=="usb", SYSFS{vendor}=="FUJIFILM", SYSFS{model}=="M100", NAME="camera%n"
The %n operator will be replaced with the "kernel number" for the camera device, to produce a NAME such as camera0, camera1, etc.
@@ -149,7 +153,7 @@ Another common operator is %k. This represents what the kernel would name
You can use shell style pattern matching to provide even more flexibility when writing keys. Taking a default udev rule:
-KERNEL="ts*", NAME="input/%k"
+KERNEL=="ts*", NAME="input/%k"
The * operator is used here, which matches literally anything - zero, one, or more characters of any kind. The rule literally says:
@@ -162,7 +166,7 @@ You can also use square brackets [ ] to match any single character. Direct quote
You can also specify ranges that can be matched, e.g. [0-9] would match any single digit. Using an example rule from a default udev installation:
-KERNEL="fd[0-9]*", NAME="floppy/%n"
+KERNEL=="fd[0-9]*", NAME="floppy/%n"
This rule says:
@@ -187,6 +191,8 @@ You may be wondering, "How do I find the serial number of my printer? What is th
The valid keys are:
follow the class device's "device"
looking at the device chain at '/sys/devices/pci0000:00/0000:00:02.1/usb3/3-3/3-3:1.0/host0/0:0:0:0':
- BUS="scsi"
- ID="0:0:0:0"
- SYSFS{detach_state}="0"
- SYSFS{type}="0"
- SYSFS{max_sectors}="240"
- SYSFS{device_blocked}="0"
- SYSFS{queue_depth}="1"
- SYSFS{scsi_level}="3"
- SYSFS{vendor}=" "
- SYSFS{model}="USB 2.0M DSC "
- SYSFS{rev}="1.00"
- SYSFS{online}="1"
+ BUS=="scsi"
+ ID=="0:0:0:0"
+ SYSFS{detach_state}=="0"
+ SYSFS{type}=="0"
+ SYSFS{max_sectors}=="240"
+ SYSFS{device_blocked}=="0"
+ SYSFS{queue_depth}=="1"
+ SYSFS{scsi_level}=="3"
+ SYSFS{vendor}==" "
+ SYSFS{model}=="USB 2.0M DSC "
+ SYSFS{rev}=="1.00"
+ SYSFS{online}=="1"
looking at the device chain at '/sys/devices/pci0000:00/0000:00:02.1/usb3/3-3':
- BUS="usb"
- ID="3-3"
- SYSFS{detach_state}="0"
- SYSFS{bNumInterfaces}=" 1"
- SYSFS{bConfigurationValue}="1"
- SYSFS{bmAttributes}="c0"
- SYSFS{bMaxPower}=" 0mA"
- SYSFS{idVendor}="052b"
- SYSFS{idProduct}="1514"
- SYSFS{bcdDevice}="0100"
- SYSFS{bDeviceClass}="00"
- SYSFS{bDeviceSubClass}="00"
- SYSFS{bDeviceProtocol}="00"
- SYSFS{bNumConfigurations}="1"
- SYSFS{speed}="12"
- SYSFS{manufacturer}="Tekom Technologies, Inc"
- SYSFS{product}="USB 2.0M DSC"
+ BUS=="usb"
+ ID=="3-3"
+ SYSFS{detach_state}=="0"
+ SYSFS{bNumInterfaces}==" 1"
+ SYSFS{bConfigurationValue}=="1"
+ SYSFS{bmAttributes}=="c0"
+ SYSFS{bMaxPower}==" 0mA"
+ SYSFS{idVendor}=="052b"
+ SYSFS{idProduct}=="1514"
+ SYSFS{bcdDevice}=="0100"
+ SYSFS{bDeviceClass}=="00"
+ SYSFS{bDeviceSubClass}=="00"
+ SYSFS{bDeviceProtocol}=="00"
+ SYSFS{bNumConfigurations}=="1"
+ SYSFS{speed}=="12"
+ SYSFS{manufacturer}=="Tekom Technologies, Inc"
+ SYSFS{product}=="USB 2.0M DSC"
The udevinfo tool provides a lot of information which you can simply copy-paste as udev rules. The reason that I have colour coded the above output is to point out that you generally cannot mix and match information from different parts of the udevinfo output. In the above output, I could not combine information from the different coloured sections - this is because each section of output refers to a different directory in SYSFS. For example, the following rule would not work:
-BUS="scsi", SYSFS{manufacturer}="Tekom Technologies, Inc", NAME="%k"
-This rule would not work because I am combining information found in the section beginning with BUS="scsi" (green) with information only found in the blue section. The rule would work if I used BUS="usb", sticking only to information found in the blue section above.
+BUS=="scsi", SYSFS{manufacturer}=="Tekom Technologies, Inc", NAME="%k"
+This rule would not work because I am combining information found in the section beginning with BUS=="scsi" (green) with information only found in the blue section. The rule would work if I used BUS=="usb", sticking only to information found in the blue section above.
You will notice that a lot of information is not relevant for writing basic rules (there is so much of it!), you should generally be looking for information that you recognise and know will not change (e.g. model name).
@@ -280,6 +288,43 @@ The behaviour of your own rules masking the defaults can be overcome if you writ
+
+Using multiple SYMLINK style rules
+Another recent feature is the ability to write rules that do not specify a NAME, but instead they simply specify SYMLINK keys. This allows you to avoid the issue where your own rules effectively mask the udev defaults.
+
+Take the rule:
+KERNEL=="hdc", SYMLINK="dvd"
+
+When udev finds this rule, it will take a mental note of it. Upon finding another rule matching the same device which also includes a NAME parameter, udev will create the node as specified by the NAME parameter, plus symbolic links as specified by the SYMLINK parameters of both rules.
+To put it into practical terms, when udev is naming nodes for my hdc device, it will use the default rules for block devices as usual, with the addition of my personal symlink "dvd".
+
+Similarly to normal rules, rules of this type will only take effect if udev is able to find them before it finds a rule specifying a NAME parameter.
+
+
+Controlling ownership and permissions
+
+As well as controlling the naming of the device nodes which are created, udev rules also allow you to control ownership and permission attributes on that device node.
+
+The GROUP key allows you to define which unix group should own the device node. Here's an example from the udev defaults, which defines that the video group will own framebuffer (fb) devices:
+
+KERNEL=="fb[0-9]*", NAME="fb/%n", SYMLINK="%k", GROUP="video"
+
+The OWNER key, perhaps less useful, allows you to define which unix user should own the device node. Assuming the slightly odd situation where you would want "john" to own your floppy devices, you could use:
+
+KERNEL=="fd[0-9]*", OWNER="john"
+
+You'll notice in the above rule that we didn't specify any NAME or SYMLINK keys. This is similar to the multiple symlink style where udev will take a mental note that we want john to own floppy nodes, and will apply that ownership once it finds a rule which defines a NAME for the floppy device nodes.
+
+Building on the style mentioned above, you can do even more flashy things. The udev defaults use the following rule to define that all the sound device nodes shall be owned by the "audio" group:
+
+SUBSYSTEM=="sound", GROUP="audio"
+
+This prevents the need to excessively provide a GROUP=="audio" key on every following rule which names sound devices.
+
+udev defaults to creating nodes with unix permissions of 0660 (read/write to owner and group). There may be some situations where you do not want to use the default permissions on your device node. Fortunately, you can easily override the permissions in your rules using the MODE assignment key. As an example, the following rule defines that the inotify node shall be readable and writable to everyone:
+
+KERNEL=="inotify", NAME="misc/%k", SYMLINK="%k", MODE="0666"
+
Example: Writing a rule for my USB printer
@@ -292,14 +337,14 @@ After plugging in my printer, I started looking around some /sys directories for
Running "udevinfo -a -p /sys/class/usb/lp0" provided me with a heap of info, as usual. I picked out the relevant bits for unique device identification:
looking at the device chain at '/sys/devices/pci0000:00/0000:00:02.1/usb3/3-3':
-BUS="usb"
-SYSFS{manufacturer}="EPSON"
-SYSFS{product}="USB Printer"
-SYSFS{serial}="L72010011070626380"
+BUS=="usb"
+SYSFS{manufacturer}=="EPSON"
+SYSFS{product}=="USB Printer"
+SYSFS{serial}=="L72010011070626380"
My udev rule becomes:
-BUS="usb", SYSFS{serial}="L72010011070626380", NAME="%k", SYMLINK="epson_680"
+BUS=="usb", SYSFS{serial}=="L72010011070626380", NAME="%k", SYMLINK="epson_680"
And my printer nodes exist at /dev/lp0 (or /dev/lp1 if another printer was plugged in beforehand) and /dev/epson_680 always points at the device node for that particular printer.
@@ -312,7 +357,7 @@ This one is a bit tricky. Several nodes are created by default when my camera is
sda1 is the node that I would like as my /dev/camera, as that is what gets mounted. udevinfo did not point out any useful differences between sda, sda1, and sg1. I decided that a reliable way to differentiate between these 3 nodes would be to look at the KERNEL name.
-A key such as KERNEL="sd?1" would match KERNEL names such as "sda1", "sdb1", "sdc1", and equally importantly, it will not match KERNEL names such as sda, sdb, or sg1. The purpose of this key is to ignore the /dev/sda and /dev/sg1 nodes. The device is a digital camera - I would not dream of fdisking it or anything like that, so these 2 nodes are pretty useless to me. The key attempts to capture the /dev/sda1 node, which is mountable and therefore useful!
+A key such as KERNEL=="sd?1" would match KERNEL names such as "sda1", "sdb1", "sdc1", and equally importantly, it will not match KERNEL names such as sda, sdb, or sg1. The purpose of this key is to ignore the /dev/sda and /dev/sg1 nodes. The device is a digital camera - I would not dream of fdisking it or anything like that, so these 2 nodes are pretty useless to me. The key attempts to capture the /dev/sda1 node, which is mountable and therefore useful!
As this node (sda1) is treated as a block device, looking in /sys/block would be a good place to start.
@@ -321,10 +366,10 @@ In my /sys/block, I have a directory named sda. In my /sys/bloc
# udevinfo -a -p /sys/block/sda/sda1
In the udevinfo output, I also noticed this bit of useful and understandable information:
-SYSFS{product}="USB 2.0M DSC"
+SYSFS{product}=="USB 2.0M DSC"
So that gives me my rule. For completeness, I also include a BUS key (this was also found in the udevinfo output).
-BUS="usb", SYSFS{product}="USB 2.0M DSC", KERNEL="sd?1", NAME="%k", SYMLINK="camera"
+BUS=="usb", SYSFS{product}=="USB 2.0M DSC", KERNEL=="sd?1", NAME="%k", SYMLINK="camera"
Now, when my camera is plugged in, it will be named /dev/sda1 (or, if sda1 isnt available, it might be called /dev/sdb1) and will always be correctly linked to from /dev/camera. The /dev/sda (or sdb) node still appears as normal, but the important thing is that my custom persistent "camera" symlink points to the mountable partition.
@@ -334,7 +379,7 @@ Now, when my camera is plugged in, it will be named /dev/sda1 (or, if sda
Carl Streeter, the owner of a large USB hard disk, wrote to me and explained that unlike in my digital camera example, the /dev/sda node is useful to him. He pointed out that he does occasionally need to use tools such as fdisk and hdparm on that node.
Carl's rule is:
-BUS="usb", KERNEL="sd*", SYSFS{product}="USB 2.0 Storage Device", NAME="%k", SYMLINK="usbhd%n"
+BUS=="usb", KERNEL=="sd*", SYSFS{product}=="USB 2.0 Storage Device", NAME="%k", SYMLINK="usbhd%n"
This rule creates symlinks such as:
@@ -351,7 +396,7 @@ This problem also applies to other USB disks - e.g. if you create a new partitio
udev provides a solution here - it is able to create nodes for all partitions of a block device. For every rule that you specify, the block device will have all 16 partition nodes created. To achieve this, you can simply modify the NAME key, as shown below:
-BUS="usb", SYSFS{product}="USB 2.0 Storage Device", NAME{all_partitions}="usbhd"
+BUS=="usb", SYSFS{product}=="USB 2.0 Storage Device", NAME{all_partitions}="usbhd"
You will now have nodes named: usbhd, usbhd1, usbhd2, usbhd3, ..., usbhd15.
@@ -362,27 +407,38 @@ I have two CD drives in my PC - a DVD reader, and a CD rewriter. My DVD is hdc a
Still, some people (myself included) like to have nodes such as /dev/dvd and /dev/cdrw for convenience. Since we know the "hdX" values for these drives, writing rules is simple. The examples below should be self explanatory.
-BUS="ide", KERNEL="hdc", NAME="%k", SYMLINK="dvd cdroms/cdrom%n"
-BUS="ide", KERNEL="hdd", NAME="%k", SYMLINK="cdrw cdroms/cdrom%n"
+BUS=="ide", KERNEL=="hdc", NAME="%k", SYMLINK="dvd cdroms/cdrom%n"
+BUS=="ide", KERNEL=="hdd", NAME="%k", SYMLINK="cdrw cdroms/cdrom%n"
You may have noticed that the default 50-udev.rules file contains a rule which runs a script to produces names for block devices. Do not be confused by this - as usual, because your own rules are located in a file which is processed before the default rules, the defaults will not be used when naming the hardware you have written rules for.
+
+Example: Writing a rule for your USB Visor Palm Pilot
+
+These devices work as USB-serial devices, so by default, you only get the ttyUSB1 node. The user-space palm utilities rely on /dev/pilot, so you need to use a rule to create this. The following rule will do the job:
+
+BUS=="usb", SYSFS{product}=="Palm Handheld", KERNEL=="ttyUSB*", SYMLINK="pilot"
+
+This was adapted from Carsten Clasohm's blog entry, which includes a useful discussion of the situation. You may also wish to add ownership and permission keys to the rule to suit your setup.
+
Example: Writing a rule to name my network interface
-An interesting new feature in recent udev versions is the ability to write rules to name your network interfaces. Network interfaces do not show up in /dev, but they are generally referenced by names (e.g. with ifconfig). Despite the differences, the rule writing process is almost identical.
+An interesting new feature in recent udev versions is the ability to rename your network interfaces, like the nameif utility does. Network interfaces do not show up in /dev, but they are generally referenced by names (e.g. with ifconfig). Despite the differences, the rule writing process is almost identical.
As usual, udevinfo comes to our aid in rule-writing. In my example, I wish to rename my "eth0" network device (the following output is snipped):
# udevinfo -a -p /sys/class/net/eth0/
looking at class device '/sys/class/net/eth0':
- SYSFS{address}="00:52:8b:d5:04:48"
+ SYSFS{address}=="00:52:8b:d5:04:48"
-Every network adapter has its own unique MAC-address, so I chose to use this when writing my rule. This will not change, unless you change your network card. An example rule is shown below:
+Every network adapter has its own unique MAC-address, so I chose to use this when writing my rule. This will not change, unless you change your network card. There is one caveat here: make sure you use the MAC address you obtain from udevinfo (as above), because it is case sensitive. Be careful when using utilities such as ifconfig as they will capitalize the letters.
-KERNEL="eth*", SYSFS{address}="00:52:8b:d5:04:48", NAME="lan"
+An example rule is shown below:
+
+KERNEL=="eth*", SYSFS{address}=="00:52:8b:d5:04:48", NAME="lan"
You will need to reload the net driver for this rule to take effect. You can either unload and reload the module, or simply reboot the system. You will also need to reconfigure your system to use "lan" rather than "eth0". I had some troubles getting this going (the interface wasn't being renamed) until I had completely dropped all references to eth0.
After that, you should be able to use "lan" instead of "eth0" in any calls to ifconfig or similar utilities.
@@ -396,69 +452,38 @@ After that, you should be able to use "lan" instead of "eth0" in any calls to Always use udevinfo to assist the rule-writing process. Always use udevinfo to look under /sys/block or /sys/class (it will not start reading a chain from anywhere else).
- If you get totally stuck, use the following command to find all "dev" files under /sys (udevinfo can work on directories containing this file): find /sys -iname dev
- If your device is a flash-card reader, usb flash-drive, or digital camera that acts as usb-storage, that is created as /dev/sdX, then start looking in /sys/block/sdX.
-- If applicable, make sure you identify the difference between sdX and sdX1 in the above situation. This can be done with the key KERNEL="sd?1" to match sdX1, or KERNEL="sd?" to match sdX.
+- If applicable, make sure you identify the difference between sdX and sdX1 in the above situation. This can be done with the key KERNEL="sd?1" to match sdX1, or KERNEL=="sd?" to match sdX.
- For USB printers that are created as /dev/lpX, then you should start looking in /sys/class/usb/lpX.
- The usb scanner driver has recently been removed from the kernel and re-implemented in userspace (as part of the SANE package). You do not (and can not) write rules for this hardware as it does not rely on specific kernel drivers.
- Remember that unfortunately, the kernel does not export information for all devices into sysfs, meaning that you simply can't write rules for some devices yet. On 20/02/04, the udev author stated that there are 162 drivers left to convert to sysfs.
-
-Using multiple SYMLINK style rules
-Another recent feature is the ability to write rules that do not specify a NAME, but instead they simply specify SYMLINK keys. This allows you to avoid the issue where your own rules effectively mask the udev defaults.
+
+Debugging your rules
-Take the rule:
-KERNEL="hdc", SYMLINK="dvd"
+If you have written rules and remembered to run udevstart but they do not appear to be taking effect, there are a couple of ways you can debug them.
-When udev finds this rule, it will take a mental note of it. Upon finding another rule matching the same device which also includes a NAME parameter, udev will create the node as specified by the NAME parameter, plus symbolic links as specified by the SYMLINK parameters of both rules.
-To put it into practical terms, when udev is naming nodes for my hdc device, it will use the default rules for block devices as usual, with the addition of my personal symlink "dvd".
-
-Similarly to normal rules, rules of this type will only take effect if udev is able to find them before it finds a rule specifying a NAME parameter.
-
-
-udev vs Nvidia's graphics drivers
-
-This section isn't really relevant to the purpose of this document, but judging from the hits I get from google, this is a hot topic. I will leave it here for now.
-
-Nvidia's graphics drivers (the closed-source ones, not the ones that come with XFree) do not work with a default installation of udev - you are unable to start X. This is because the nvidia module is loaded by X, but the /dev/nvidia* nodes are not created quick enough, so X bails out.
+The file /etc/udev/udev.conf contains a udev_log option. Setting this option to yes will cause udev to log some useful information about which rules are being applied to which nodes into the system logger. The logs will be included in /var/log/messages for most users.
-The solution to this problem is to autoload the nvidia module on bootup. Yes - you are *supposed* to do this - the NVidia FAQ confirms this! On devfs-based systems, devfs did this automatically at bootup anyway. Your linux distribution will have created a file which you can list modules to be loaded on bootup (e.g. /etc/modules.autoload.d/kernel-2.6 for Gentoo, /etc/modules for Debian).
+Additionally, if you know the path in sysfs for the node you want to create, you can use udevtest to see a rundown on what udev would do with the node. For example:
-This isn't all - you will also need to patch the nvidia kernel interface to export some basic info to SYSFS so that udev will create the devices. Martin Schlemmer has written a patch against the 1.0.5336 version of the nvidia drivers, which can be found here. The Gentoo package nvidia-kernel-1.0.5336-r4 contains this patch.
+# udevtest /sys/class/sound/dsp/
+version 056
+looking at '/class/sound/dsp/'
+opened class_dev->name='dsp'
+configured rule in '/etc/udev/rules.d/50-udev.rules[132]' applied, added symlink '%k'
+configured rule in '/etc/udev/rules.d/50-udev.rules[132]' applied, 'dsp' becomes 'sound/%k'
+creating device node '/dev/sound/dsp', major = '14', minor = '3', mode = '0660', uid = '0', gid = '18'
-Another solution is to simply create the nvidia specific nodes on bootup. X will then load the module when required, and as the nodes are already in existance, you will not run into the problem described above. Place these commands in a file that is automatically executed on bootup (e.g. /etc/conf.d/local.start for Gentoo):
-
-mknod /dev/nvidia0 c 195 0
-mknod /dev/nvidiactl c 195 255
-
-
-You should now be able to get into X with no problems.
+udevtest is only a debugging/testing tool - it does not actually create the device node, even though it says it doing so!
Author and Credits
This document is written by Daniel Drake <dan@reactivated.net>
Please do not hesitate to send feedback!
-Additional thanks to:
-
-- The udev developers!
-- agrippa_cash (usb-storage info)
-- Carl Streeter (usb-storage info)
-- David Watson
-- Decibels
-- Frank Pieczynski
-- Feth Arezki
-- Jim (KDE info)
-- Johannes Jordens
-- Kay Sievers
-- Patrick Dreker
-- Todd Musall
-- Tuna
-- Ueli Schläpfer
-- ...and anyone else who provided information or feedback
-
-
-
Copyright (C) 2003-2004 Daniel Drake
+Copyright (C) 2003-2005 Daniel Drake
This document is licensed under the GNU General Public License, Version 2.