X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Fudevadm.xml;h=fbfa85a80475272741e94929f67faf2b11e4ee32;hp=a1ffe4219c23c6041f60da14628f1bc8198ba1ce;hb=faae655de3cdbed4be1d472b01ce0c4d81e905ed;hpb=124b48b00d0c59fbbc2a8c3e27dba2cd6877aaa8 diff --git a/man/udevadm.xml b/man/udevadm.xml index a1ffe4219..fbfa85a80 100644 --- a/man/udevadm.xml +++ b/man/udevadm.xml @@ -72,7 +72,7 @@ - Print debug messages to stderr. + Print debug messages to standard error. @@ -82,6 +82,7 @@ + Print help text. @@ -89,31 +90,33 @@ - udevadm info <replaceable>options</replaceable> + udevadm info <optional><replaceable>OPTIONS</replaceable></optional> <optional><replaceable>DEVPATH</replaceable>|<replaceable>FILE</replaceable></optional> Queries the udev database for device information stored in the udev database. It can also query the properties of a device from its sysfs representation to help creating udev rules that match this device. - + + - Query the database for specified type of device + Query the database for the specified type of device data. It needs the or - to identify the specified - device. Valid queries are: name, - symlink, path, - property, + to identify the specified device. + Valid TYPEs are: + name, symlink, + path, property, all. - + + The /sys path of the device to query, e.g. /sys/class/block/sda. - Note that this option usually isn't very useful, since + Note that this option usually is not very useful, since udev can guess the type of the argument, so udevadm --devpath=/class/block/sda is equivalent to @@ -121,17 +124,19 @@ - + + The name of the device node or a symlink to query, e.g. /dev/sda. - Note that this option usually isn't very useful, since + Note that this option usually is not very useful, since udev can guess the type of the argument, so udevadm --name=sda is equivalent to udevadm /dev/sda. + Print absolute paths in name or symlink @@ -139,6 +144,7 @@ + Print all sysfs properties of the specified device that can be used @@ -147,31 +153,36 @@ + Print output as key/value pairs. Values are enclosed in single quotes. - + + Add a prefix to the key name of exported values. - + + Print major/minor numbers of the underlying device, where the file lives on. + Export the content of the udev database. + Cleanup the udev database. @@ -184,6 +195,7 @@ + Print help text. @@ -196,19 +208,22 @@ Request device events from the kernel. Primarily used to replay events at system coldplug time. + Print the list of devices which will be triggered. + Do not actually trigger the event. - + + Trigger a specific type of devices. Valid types are: devices, subsystems. @@ -216,68 +231,95 @@ - + + - Type of event to be triggered. The default value is change. + Type of event to be triggered. The default value is + change. - + + - Trigger events for devices which belong to a matching subsystem. This option - can be specified multiple times and supports shell style pattern matching. + Trigger events for devices which belong to a + matching subsystem. This option can be specified multiple + times and supports shell style pattern matching. - + + Do not trigger events for devices which belong to a matching subsystem. This option can be specified multiple times and supports shell style pattern matching. - + + - Trigger events for devices with a matching sysfs attribute. If a value is specified - along with the attribute name, the content of the attribute is matched against the given - value using shell style pattern matching. If no value is specified, the existence of the - sysfs attribute is checked. This option can be specified multiple times. + Trigger events for devices with a matching sysfs + attribute. If a value is specified along with the + attribute name, the content of the attribute is matched + against the given value using shell style pattern + matching. If no value is specified, the existence of the + sysfs attribute is checked. This option can be specified + multiple times. - + + - Do not trigger events for devices with a matching sysfs attribute. If a value is - specified along with the attribute name, the content of the attribute is matched against - the given value using shell style pattern matching. If no value is specified, the existence - of the sysfs attribute is checked. This option can be specified multiple times. + Do not trigger events for devices with a matching + sysfs attribute. If a value is specified along with the + attribute name, the content of the attribute is matched + against the given value using shell style pattern + matching. If no value is specified, the existence of the + sysfs attribute is checked. This option can be specified + multiple times. - + + - Trigger events for devices with a matching property value. This option can be - specified multiple times and supports shell style pattern matching. + Trigger events for devices with a matching property + value. This option can be specified multiple times and + supports shell style pattern matching. - + + - Trigger events for devices with a matching tag. This option can be - specified multiple times. + Trigger events for devices with a matching tag. This + option can be specified multiple times. - + + - Trigger events for devices with a matching sys device name. This option can be - specified multiple times and supports shell style pattern matching. + Trigger events for devices with a matching sys + device name. This option can be specified multiple times + and supports shell style pattern matching. - + + - Trigger events for all children of a given device. + Trigger events for all children of a given + device. + + + + + + + Print help text. @@ -287,38 +329,24 @@ Watches the udev event queue, and exits if all current events are handled. - + + - Maximum number of seconds to wait for the event queue to become empty. - The default value is 120 seconds. A value of 0 will check if the queue is empty - and always return immediately. + Maximum number of seconds to wait for the event + queue to become empty. The default value is 120 seconds. A + value of 0 will check if the queue is empty and always + return immediately. - - - Wait only for events after the given sequence number. - - - - - - Wait only for events before the given sequence number. - - - - + + Stop waiting if file exists. - - - Do not print any output, like the remaining queue entries when reaching the timeout. - - - + Print help text. @@ -331,12 +359,14 @@ Modify the internal state of the running udev daemon. + Signal and wait for systemd-udevd to exit. + Set the internal log level of systemd-udevd. Valid values are the numerical @@ -345,6 +375,7 @@ + Signal systemd-udevd to stop executing new events. Incoming events @@ -352,12 +383,14 @@ + Signal systemd-udevd to enable the execution of events. + Signal systemd-udevd to reload the rules files and other databases like the kernel @@ -366,12 +399,14 @@ + Set a global property for all events. + value Set the maximum number of events, systemd-udevd will handle at the @@ -385,6 +420,7 @@ + Print help text. @@ -400,36 +436,42 @@ + Print the kernel uevents. + Print the udev event after the rule processing. + Also print the properties of the event. + Filter events by subsystem[/devtype]. Only udev events with a matching subsystem value will pass. + Filter events by property. Only udev events with a given tag attached will pass. + Print help text. @@ -442,6 +484,7 @@ Maintain the hardware database index in /etc/udev/hwdb.bin. + Compile the hardware database information located in /usr/lib/udev/hwdb.d/, @@ -452,6 +495,7 @@ + Query the database with a modalias string, and print the @@ -459,9 +503,17 @@ + - Alternative root path in the filesystem for reading and writing files. + Alternative root path in the file system for reading and writing files. + + + + + + + Print help text. @@ -471,24 +523,27 @@ Simulate a udev event run for the given device, and print debug output. + The action string. + Specify when udevadm should resolve names of users and groups. When set to early (the - default) names will be resolved when the rules are - parsed. When set to late names will + default), names will be resolved when the rules are + parsed. When set to late, names will be resolved for every event. When set to - never names will never be resolved + never, names will never be resolved and all devices will be owned by root. + Print help text. @@ -497,10 +552,13 @@ - udevadm test-builtin <optional>options</optional> <replaceable>command</replaceable> <replaceable>devpath</replaceable> - Run a built-in command for the given device, and print debug output. + udevadm test-builtin <optional>options</optional> <replaceable>COMMAND</replaceable> <replaceable>DEVPATH</replaceable> + Run a built-in command COMMAND + for device DEVPATH, and print debug + output. + Print help text. @@ -514,7 +572,7 @@ See Also udev7 - + , systemd-udevd.service8