X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Fudevadm.xml;h=749144dbd4dde3e4c10a74613408ec44012f0234;hp=30a6ac423a2b6360ed01a5e803e1a02433d36bc7;hb=9700d6980f7c212b10a69399e6430b82a6f45587;hpb=72f4d9669c253d5bd7c126bf2e7a0db0198cf2eb diff --git a/man/udevadm.xml b/man/udevadm.xml index 30a6ac423..749144dbd 100644 --- a/man/udevadm.xml +++ b/man/udevadm.xml @@ -20,7 +20,6 @@ udevadm 8 - @@ -72,7 +71,7 @@ - Print debug messages to stderr. + Print debug messages to standard error. @@ -82,6 +81,7 @@ + Print help text. @@ -89,26 +89,28 @@ - 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 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. @@ -121,7 +123,8 @@ - + + The name of the device node or a symlink to query, e.g. /dev/sda. @@ -132,6 +135,7 @@ + Print absolute paths in name or symlink @@ -139,6 +143,7 @@ + Print all sysfs properties of the specified device that can be used @@ -147,31 +152,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 +194,7 @@ + Print help text. @@ -196,19 +207,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 +230,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 +328,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 +358,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 +374,7 @@ + Signal systemd-udevd to stop executing new events. Incoming events @@ -352,12 +382,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 +398,14 @@ + Set a global property for all events. + value Set the maximum number of events, systemd-udevd will handle at the @@ -385,6 +419,7 @@ + Print help text. @@ -400,36 +435,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 +483,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 +494,7 @@ + Query the database with a modalias string, and print the @@ -459,9 +502,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,12 +522,14 @@ Simulate a udev event run for the given device, and print debug output. + The action string. + Specify when udevadm should resolve names of users @@ -489,6 +542,7 @@ + Print help text. @@ -497,10 +551,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 +571,7 @@ See Also udev7 - + , systemd-udevd.service8