X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Fudevadm.xml;h=b85d9a9249733aa7e6b709b8ac99de0836396097;hp=accf70129e31a790f9ed3276d37dbb4bb1c56f23;hb=33488f19793dc0a86fdee27266c5319b5b78d695;hpb=7e505069d2eac61406cb0e7a9e5ef54a3c1ec38d diff --git a/man/udevadm.xml b/man/udevadm.xml index accf70129..b85d9a924 100644 --- a/man/udevadm.xml +++ b/man/udevadm.xml @@ -20,7 +20,6 @@ udevadm 8 - @@ -49,6 +48,9 @@ udevadm monitor options + + udevadm hwdb options + udevadm test options devpath @@ -58,9 +60,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 @@ -68,7 +71,7 @@ - Print debug messages to stderr. + Print debug messages to standard error. @@ -78,6 +81,7 @@ + Print help text. @@ -85,35 +89,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 @@ -121,6 +143,7 @@ + Print all sysfs properties of the specified device that can be used @@ -129,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. @@ -166,6 +194,7 @@ + Print help text. @@ -178,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. @@ -198,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. @@ -269,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. - - - - - - 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. @@ -313,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 @@ -327,6 +374,7 @@ + Signal systemd-udevd to stop executing new events. Incoming events @@ -334,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 @@ -348,12 +398,14 @@ + Set a global property for all events. + value Set the maximum number of events, systemd-udevd will handle at the @@ -367,6 +419,7 @@ + Print help text. @@ -382,36 +435,90 @@ + 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. + + + + + + udevadm hwdb <optional>options</optional> + Maintain the hardware database index in /etc/udev/hwdb.bin. + + + + + + Compile the hardware database information located in /usr/lib/udev/hwdb.d/, + /etc/udev/hwdb.d/ and store it in /etc/udev/hwdb.bin. This should be done after + any update to the source files; it will not be called automatically. The running + udev daemon will detect a new database on its own and does not need to be + notified about it. + + + + + + Put the compiled database into /usr/lib/udev/hwdb.bin instead. + Use this if you want to ship a pre-compiled database in immutable system images, or + don't use /etc/udev/hwdb.d and want to avoid large binary files in + /etc. + + + + + + + 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. @@ -424,18 +531,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. @@ -444,10 +560,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. @@ -461,7 +580,7 @@ See Also udev7 - + , systemd-udevd.service8