X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;ds=sidebyside;f=udev.8.in;h=7bdf560970ff46ddd830fb80f3d1ba26da67fb83;hb=e1b7e62a2676bf679f3eae8997caf0ea703e573d;hp=9c22f8aa633a9e78fb78717a031bfa230427d130;hpb=0a8dd7f37c6f788c74aa528949c45aca66638e5a;p=elogind.git diff --git a/udev.8.in b/udev.8.in index 9c22f8aa6..7bdf56097 100644 --- a/udev.8.in +++ b/udev.8.in @@ -4,29 +4,24 @@ udev \- Linux configurable dynamic device naming support .SH SYNOPSIS .BI udev " hotplug-subsystem" .P -The environment must provide the following variables: +The following variables are read from the environment: .TP .B ACTION .IR add " or " remove -signifies the connection or disconnection of a device. -.TP +signifies the addition or the removal of a device. +.P .B DEVPATH The sysfs devpath of the device without the mountpoint but a leading slash. .P -Additional optional environment variables: -.TP +.B SUBSYSTEM +The subsystem the device belongs to. Alternatively the subsystem may +be passed as the first argument. +.P .B UDEV_CONFIG_FILE Overrides the default location of the .B udev config file. -.TP -.B UDEV_NO_SLEEP -The default behavior of -.B udev -is to wait until all the sysfs files of the device chain are populated. If set, -.B udev -will continue, regardless of the state of the device representation. -.TP +.P .B UDEV_NO_DEVD The default behavior of .B udev @@ -41,7 +36,6 @@ provides a dynamic device directory containing only the files for actually present devices. It creates or removes device node files usually located in the /dev directory, or it renames network interfaces. .br - .P As part of the .B hotplug @@ -81,7 +75,7 @@ value is .TP .B udev_db The name and location of the udev database. The default value is -.IR @udevdir@/.udev.tdb . +.IR @udevdir@/.udevdb . .TP .B udev_rules The name of the udev rules file or directory to look for files with the suffix @@ -124,7 +118,7 @@ file. The default value is udev_root="/udev" # udev_db - The name and location of the udev database -udev_db="/udev/.udev.tdb" +udev_db="/udev/.udevdb" # udev_rules - The name of the udev rules file or directory to look for files with the suffix .rules @@ -178,6 +172,12 @@ Match the bus type of the device. .B KERNEL Match the kernel device name. .TP +.B SUBSYSTEM +Match the kernel subsystem name. +.TP +.B DRIVER +Match the kernel driver name. +.TP .B ID Match the device number on the bus, like PCI bus id. .TP @@ -217,6 +217,13 @@ If given with the attribute .BR NAME{ all_partitions } it will create all 15 partitions of a blockdevice. This may be useful for removable media devices. +.br +If given with the attribute +.BR NAME{ ignore_remove } +it will will ignore any later remove event for this device. +This may be useful as a workaround for broken device drivers. +.sp +Multiple attributes may be separated by comma. .TP .B SYMLINK The name of a symlink targeting the node. Multiple symlinks may be @@ -342,17 +349,6 @@ video*:root:video:0660 dsp1:::0666 .fi .P -The value -.I $local -can be used instead of a specific username. In that case, udev will determine -the current local user at the time of device node creation and substitute -that username as the owner of the new device node. This is useful, for -example, to let hot-plugged devices, such as cameras, be owned by the user at -the current console. Note that if no user is currently logged in, or if udev -otherwise fails to determine a current user, the -.I default_owner -value is used in lieu. -.P A number of different fields in the above configuration files support a simple form of shell style pattern matching. It supports the following pattern characters: .TP @@ -378,9 +374,12 @@ The name of a program must end with suffix, to be recognized. .br In addition to the hotplug environment variables, +.B UDEV_LOG +is set if udev is configured to use the syslog facility. Executed programs may +want to follow that setting. .B DEVNAME is exported to make the name of the created node, or the name the network -device is renamed to, available to the executed program. The programs in every +device is renamed to, available to the executed program. The programs in every directory are sorted in lexical order, while the directories are searched in the following order: .sp