X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=udev%2Fudevadm.xml;h=7860efe9672558a54fa33b90901ac0b182f560fb;hp=093dd21428400dbfcba802cc0bfea85c319cbce0;hb=b466e9ab3951207a3c0c8d2ba6167be1eac1e41a;hpb=0254b2118f123504c268edb0b382c587ac15aaa3
diff --git a/udev/udevadm.xml b/udev/udevadm.xml
index 093dd2142..7860efe96 100644
--- a/udev/udevadm.xml
+++ b/udev/udevadm.xml
@@ -1,396 +1,452 @@
-
+
-
-
+
+ udevadm
-
-
- udevd
- November 2007
- udev
-
+ udev
+
-
- udevadm
- 8
-
-
+
+ udevadm
+ 8
+
+
-
- udevadmudev management tool
-
+
+ udevadmudev management tool
+
-
-
- udevadm
-
-
-
-
-
- udevadm info options
-
-
- udevadm trigger options
-
-
- udevadm settle options
-
-
- udevadm control command
-
-
- udevadm monitor options
-
-
- udevadm test optionsdevpath
-
-
+
+
+ udevadm
+
+
+
+
+
+ udevadm info options
+
+
+ udevadm trigger options
+
+
+ udevadm settle options
+
+
+ udevadm control command
+
+
+ udevadm monitor options
+
+
+ udevadm test optionsdevpath
+
+
- 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.
-
+ 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.
+
- OPTIONS
-
-
-
-
- Print debug messages to stderr.
-
-
-
-
-
- Print version number.
-
-
-
-
-
- Print help text.
-
-
-
+ OPTIONS
+
+
+
+
+ Print debug messages to stderr.
+
+
+
+
+
+ Print version number.
+
+
+
+
+
+ Print help text.
+
+
+
- udevadm info <replaceable>options</replaceable>
- 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.
-
-
-
-
-
- The devpath of the device to query.
-
-
-
-
-
- The name of the device node or a symlink to query
-
-
-
-
-
- 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.
-
-
-
-
-
- Print all sysfs properties of the specified device that can be used
- in udev rules to match the specified device. It prints all devices
- along the chain, up to the root of sysfs that can be used in udev rules.
-
-
-
-
-
- Print major/minor numbers of the underlying device, where the file
- lives on.
-
-
-
-
-
- Export the content of the udev database.
-
-
-
-
-
- Print version.
-
-
-
-
-
- Print help text.
-
-
-
-
+ udevadm info <replaceable>options</replaceable>
+ 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.
+
+
+
+
+
+ The devpath of the device to query.
+
+
+
+
+
+ The name of the device node or a symlink to query
+
+
+
+
+
+ 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 all sysfs properties of the specified device that can be used
+ in udev rules to match the specified device. It prints all devices
+ along the chain, up to the root of sysfs that can be used in udev rules.
+
+
+
+
+
+ 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.
+
+
+
+
+
+ Print version.
+
+
+
+
+
+ Print help text.
+
+
+
+
- udevadm trigger <optional>options</optional>
- Request device events from the kernel. Usually 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, failed.
- The default value is devices.
-
-
-
-
-
- Type of event to be triggered. The default value is add.
-
-
-
-
-
- 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.
-
-
-
-
-
- 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 propery value. This option can be
- specified multiple times and supports shell style pattern matching.
-
-
-
-
+ udevadm trigger <optional>options</optional>
+ 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.
+ The default value is devices.
+
+
+
+
+
+ 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.
+
+
+
+
+
+ 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.
+
+
+
+
+
+ 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 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.
+
+
+
+
- udevadm settle <optional>options</optional>
- 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 180 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.
-
-
-
-
+ udevadm settle <optional>options</optional>
+ 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 180 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.
+
+
+
+
- udevadm control <replaceable>command</replaceable>
- Modify the internal state of the running udev daemon.
-
-
-
-
- Set the internal log level of udevd. Valid values are the numerical
- syslog priorities or their textual representations: ,
- and .
-
-
-
-
-
- Signal udevd to stop executing new events. Incoming events
- will be queued.
-
-
-
-
-
- Signal udevd to enable the execution of events.
-
-
-
-
-
- Signal udevd to reload the rules files.
- The udev daemon detects changes automatically, this option is
- usually not needed. Reloading rules does not apply any changes
- to already existing devices.
-
-
-
-
-
- Set global variable.
-
-
-
- value
-
- Set the maximum number of events, udevd will handle at the
- same time.
-
-
-
-
-
- Print help text.
-
-
-
-
+ udevadm control <replaceable>command</replaceable>
+ Modify the internal state of the running udev daemon.
+
+
+
+
+ Signal and wait for udevd to exit.
+
+
+
+
+
+ Set the internal log level of udevd. Valid values are the numerical
+ syslog priorities or their textual representations: ,
+ and .
+
+
+
+
+
+ Signal udevd to stop executing new events. Incoming events
+ will be queued.
+
+
+
+
+
+ Signal udevd to enable the execution of events.
+
+
+
+
+
+ Signal udevd to reload the rules files.
+ The udev daemon detects changes automatically, this option is
+ usually not needed. Reloading rules does not apply any changes
+ to already existing devices.
+
+
+
+
+
+ Set a global property for all events.
+
+
+
+ value
+
+ Set the maximum number of events, udevd will handle at the
+ same time.
+
+
+
+ seconds
+
+ The maximum number seonds to wait for a reply from udevd.
+
+
+
+
+
+ Print help text.
+
+
+
+
- udevadm monitor <optional>options</optional>
- Listens to the kernel uevents and events sent out by a udev rule
- and prints the devpath of the event to the console. It can be used to analyze the
- event timing, by comparing the timestamps of the kernel uevent and the udev event.
-
-
-
-
-
- Print the complete environment for all events. Can be used to compare the
- kernel supplied and the udev added environment values.
-
-
-
-
-
- Print the kernel uevents.
-
-
-
-
-
- Print the udev event after the rule processing.
-
-
-
-
-
- Print help text.
-
-
-
-
+ udevadm monitor <optional>options</optional>
+ Listens to the kernel uevents and events sent out by a udev rule
+ and prints the devpath of the event to the console. It can be used to analyze the
+ event timing, by comparing the timestamps of the kernel uevent and the udev event.
+
+
+
+
+
+ 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 test <optional>options</optional> <replaceable>devpath</replaceable>
- Simulate a udev event run for the given device, and print debug output.
-
-
-
-
- The action string.
-
-
-
-
-
- The subsystem string.
-
-
-
-
-
- Print help text.
-
-
-
-
-
+ udevadm test <optional>options</optional> <replaceable>devpath</replaceable>
+ Simulate a udev event run for the given device, and print debug output.
+
+
+
+
+ The action string.
+
+
+
+
+
+ The subsystem string.
+
+
+
+
+
+ Print help text.
+
+
+
+
+
- AUTHOR
- Written by Kay Sievers kay.sievers@vrfy.org.
-
+ Author
+ Written by Kay Sievers kay.sievers@vrfy.org.
+
-
- SEE ALSO
-
- udev7
-
-
- udevd8
-
-
-
-
-
+
+ See Also
+
+ udev7
+
+
+ udevd8
+
+
+