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=455ce80ca9c69840bd073fcbe5963856d5cf2581;hb=33488f19793dc0a86fdee27266c5319b5b78d695;hpb=3e2147858f21943d5f4a781c60f33ac22c6096ed diff --git a/man/udevadm.xml b/man/udevadm.xml index 455ce80ca..b85d9a924 100644 --- a/man/udevadm.xml +++ b/man/udevadm.xml @@ -6,13 +6,20 @@ udevadm - udev + systemd + + + Developer + Kay + Sievers + kay@vrfy.org + + udevadm 8 - @@ -41,6 +48,9 @@ udevadm monitor options + + udevadm hwdb options + udevadm test options devpath @@ -50,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 @@ -60,7 +71,7 @@ - Print debug messages to stderr. + Print debug messages to standard error. @@ -70,6 +81,7 @@ + Print help text. @@ -77,49 +89,61 @@ - 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. + - The udev root directory: /dev. If used in conjunction - with a name or symlink query, the - query returns the absolute path including the root directory. - - - - - - The udev runtime directory: /run/udev. + Print absolute paths in name or symlink + query. + Print all sysfs properties of the specified device that can be used @@ -128,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. @@ -165,6 +194,7 @@ + Print help text. @@ -177,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. @@ -197,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. @@ -268,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. @@ -312,60 +358,68 @@ Modify the internal state of the running udev daemon. + - Signal and wait for udevd to exit. + Signal and wait for systemd-udevd to exit. + - Set the internal log level of udevd. Valid values are the numerical + Set the internal log level of systemd-udevd. Valid values are the numerical syslog priorities or their textual representations: , and . + - Signal udevd to stop executing new events. Incoming events + Signal systemd-udevd to stop executing new events. Incoming events will be queued. + - Signal udevd to enable the execution of events. + Signal systemd-udevd to enable the execution of events. + - Signal udevd to reload the rules files and other databases like the kernel + Signal systemd-udevd to reload the rules files and other databases like the kernel module index. Reloading rules and databases does not apply any changes to already existing devices; the new configuration will only be applied to new events. + Set a global property for all events. + value - Set the maximum number of events, udevd will handle at the + Set the maximum number of events, systemd-udevd will handle at the same time. seconds - The maximum number seconds to wait for a reply from udevd. + The maximum number of seconds to wait for a reply from systemd-udevd. + Print help text. @@ -381,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. @@ -423,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. @@ -443,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. @@ -456,17 +576,13 @@ - Author - Written by Kay Sievers kay.sievers@vrfy.org. - - See Also udev7 - + , - udevd8 + systemd-udevd.service8