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=77910282210744bbcc04f1b904d515891b64528e;hb=9ea28c55a2488e6cd4a44ac5786f12b71ad5bc9f;hpb=04ba11b2c4ab69dcae5d623808bed76be825dbac diff --git a/man/udevadm.xml b/man/udevadm.xml index 779102822..fbfa85a80 100644 --- a/man/udevadm.xml +++ b/man/udevadm.xml @@ -61,9 +61,10 @@ Description - udevadm expects a command and command specific options. It - controls the runtime behavior of udev, requests kernel events, - manages the event queue, and provides simple debugging mechanisms. + udevadm expects a command and command + specific options. It controls the runtime behavior of + systemd-udevd, requests kernel events, manages + the event queue, and provides simple debugging mechanisms. OPTIONS @@ -71,7 +72,7 @@ - Print debug messages to stderr. + Print debug messages to standard error. @@ -81,6 +82,7 @@ + Print help text. @@ -88,35 +90,53 @@ - 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 data. It needs the - or to identify the specified - device. Valid queries are: - name, symlink, path, - property, all. + Query the database for the specified type of device + data. It needs the or + to identify the specified device. + Valid TYPEs are: + name, symlink, + path, property, + all. - + + - The devpath of the device to query. + The /sys path of the device to + query, e.g. + /sys/class/block/sda. + 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 + udevadm /sys/class/block/sda. - + + - The name of the device node or a symlink to query + The name of the device node or a symlink to query, + e.g. /dev/sda. + 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 @@ -124,6 +144,7 @@ + Print all sysfs properties of the specified device that can be used @@ -132,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. @@ -169,6 +195,7 @@ + Print help text. @@ -181,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. @@ -201,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. @@ -272,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. - - - - - - Wait only for events after the given sequence number. - - - - + + - Wait only for events before the given sequence number. + 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. - + + Stop waiting if file exists. - - - Do not print any output, like the remaining queue entries when reaching the timeout. - - - + Print help text. @@ -316,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 @@ -330,6 +375,7 @@ + Signal systemd-udevd to stop executing new events. Incoming events @@ -337,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 @@ -351,12 +399,14 @@ + Set a global property for all events. + value Set the maximum number of events, systemd-udevd will handle at the @@ -370,6 +420,7 @@ + Print help text. @@ -385,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. @@ -427,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/, @@ -437,12 +495,27 @@ + Query the database with a modalias string, and print the retrieved properties. + + + + + Alternative root path in the file system for reading and writing files. + + + + + + + Print help text. + + @@ -450,18 +523,27 @@ Simulate a udev event run for the given device, and print debug output. + The action string. - + + - The subsystem 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 + be resolved for every event. When set to + never, names will never be resolved + and all devices will be owned by root. + Print help text. @@ -470,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. @@ -487,7 +572,7 @@ See Also udev7 - + , systemd-udevd.service8