X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=udev.8;h=c4ee23dcc78f8cc2cf6bba275f022c86207434a3;hp=0c461967d2444f6bfc9093f6c804d2c10b5ecaad;hb=958479a0dead606c6e44490a30a7040773654281;hpb=c6c13c31814e9fc7557ca303c331d0cf13664372 diff --git a/udev.8 b/udev.8 index 0c461967d..c4ee23dcc 100644 --- a/udev.8 +++ b/udev.8 @@ -18,7 +18,7 @@ On device creation, .B udev reads the sysfs directory of the given device to collect device attributes like label, serial number or bus device number. -These attributes are treated as a key +These attributes are treated as a key to determine a unique name for device file creation. .B udev maintains a database for devices present on the system. @@ -87,14 +87,14 @@ The rules for udev to use when naming devices may specified at .I /etc/udev/udev.rules or specified by the .I udev_rules -value in the +value in the .I /etc/udev/udev.conf file. .P Every line in the rules file define the mapping between device attributes and the device file name. It starts with a keyword defining the method used to match, followed by one ore more keys to compare and the filename for the -device. Optional the name for a symlink targeting the node may specified. +device. One ore more optional symlinks targeting the node may be specified. .br If no matching configuration is found, the default kernel device name is used. @@ -114,8 +114,7 @@ calling external program, that returns a string to match device label or serial number, like USB serial number, SCSI UUID or file system label .br -.RB "keys: " BUS ", " -.I sysfs_attribute +.RB "keys: " BUS ", " SYSFS_ .TP .B NUMBER device number on the bus, like PCI bus id @@ -130,7 +129,7 @@ device position on bus, like physical port of USB device .B REPLACE string replacement of the kernel device name .br -.RB "key: " KERNEL_NAME +.RB "key: " KERNEL .P The methods are applied in the following order: .BR CALLOUT ", " LABEL ", " NUMBER ", " TOPOLOGY ", " REPLACE "." @@ -158,7 +157,7 @@ The CALLOUT program returned string. .B %D Use the devfs style disk name for this device. For partitions, this will result in 'part%n' -If this is not a partition, it will result in 'disk'. +If this is not a partition, it will result in 'disc'. .P .RI "A sample " udev.rules " might look like this:" .sp @@ -167,7 +166,7 @@ If this is not a partition, it will result in 'disk'. CALLOUT, BUS="scsi", PROGRAM="/sbin/scsi_id", ID="OEM 0815", NAME="disk1" # USB printer to be called lp_color -LABEL, BUS="usb", serial="W09090207101241330", NAME="lp_color" +LABEL, BUS="usb", SYSFS_serial="W09090207101241330", NAME="lp_color" # sound card with PCI bus id 00:0b.0 to be called dsp NUMBER, BUS="pci", ID="00:0b.0", NAME="dsp" @@ -175,11 +174,11 @@ NUMBER, BUS="pci", ID="00:0b.0", NAME="dsp" # USB mouse at third port of the second hub to be called mouse1 TOPOLOGY, BUS="usb", PLACE="2.3", NAME="mouse1" -# ttyUSB1 should always be called pda -REPLACE, KERNEL="ttyUSB1", NAME="pda" +# ttyUSB1 should always be called pda with two additional symlinks +REPLACE, KERNEL="ttyUSB1", NAME="pda", SYMLINK="palmtop handheld" -# USB webcams with symlinks to be called webcam0, webcam1, ... -LABEL, BUS="usb", model="WebCam Version 3", NAME="video%n", SYMLINK="webcam%n" +# multiple USB webcams with symlinks to be called webcam0, webcam1, ... +LABEL, BUS="usb", SYSFS_model="XV3", NAME="video%n", SYMLINK="webcam%n" .fi .P Permissions and ownership for the created device files may specified at