X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fudevadm.xml;h=b85d9a9249733aa7e6b709b8ac99de0836396097;hb=9ff8af5460d57dfab78a1137ec743b539715e82a;hp=015980a63b67b6315df234d33981645b79d2753c;hpb=23b7245397ac3d21b2386e7b33d9e4ae3db3c8a1;p=elogind.git
diff --git a/man/udevadm.xml b/man/udevadm.xml
index 015980a63..b85d9a924 100644
--- a/man/udevadm.xml
+++ b/man/udevadm.xml
@@ -20,7 +20,6 @@
udevadm8
-
@@ -61,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
@@ -71,7 +71,7 @@
- Print debug messages to stderr.
+ Print debug messages to standard error.
@@ -81,6 +81,7 @@
+ Print help text.
@@ -88,35 +89,53 @@
- udevadm info options
+ udevadm info OPTIONSDEVPATH|FILEQueries 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 +143,7 @@
+ Print all sysfs properties of the specified device that can be used
@@ -132,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.
@@ -169,6 +194,7 @@
+ Print help text.
@@ -181,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.
@@ -201,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.
@@ -272,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.
@@ -316,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
@@ -330,6 +374,7 @@
+ Signal systemd-udevd to stop executing new events. Incoming events
@@ -337,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
@@ -351,12 +398,14 @@
+ Set a global property for all events.
+ valueSet the maximum number of events, systemd-udevd will handle at the
@@ -370,6 +419,7 @@
+ Print help text.
@@ -385,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.
@@ -424,25 +480,50 @@
udevadm hwdb options
- Maintain the hardware database index in /etc/udev/hwdb.bin.
+ Maintain the hardware database index in /etc/udev/hwdb.bin.
+
- Compile the hardware dabase information located in /usr/lib/udev/hwdb.d/,
- /etc/udev/hwdb.d/ and store it in /etc/udev/hwdb.bin. This should be done with
- any update to the source files, it will not be called automatically. The running
+ 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.
+
+
@@ -450,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.
@@ -470,10 +560,13 @@
- udevadm test-builtin optionscommanddevpath
- Run a built-in command for the given device, and print debug output.
+ udevadm test-builtin optionsCOMMANDDEVPATH
+ Run a built-in command COMMAND
+ for device DEVPATH, and print debug
+ output.
+ Print help text.
@@ -487,7 +580,7 @@
See Alsoudev7
-
+ ,
systemd-udevd.service8