From 78e9bb837c258ac0ec7712b3d612cc2f407e731e Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Wed, 12 Jun 2024 05:50:42 +0200 Subject: Merging upstream version 256. Signed-off-by: Daniel Baumann --- man/udevadm.xml | 109 +++++++++++++++++++++++++++++++++++++++----------------- 1 file changed, 77 insertions(+), 32 deletions(-) (limited to 'man/udevadm.xml') diff --git a/man/udevadm.xml b/man/udevadm.xml index 76c54c3..b515f3c 100644 --- a/man/udevadm.xml +++ b/man/udevadm.xml @@ -1,6 +1,6 @@ + "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> udevadm info - <arg choice="opt"><replaceable>options</replaceable></arg> - <arg choice="opt" rep="repeat"><replaceable>devpath</replaceable>|<replaceable>file</replaceable>|<replaceable>unit</replaceable></arg> + <optional><replaceable>options</replaceable></optional> + <optional><replaceable>devpath</replaceable>|<replaceable>file</replaceable>|<replaceable>unit</replaceable></optional> Query the udev database for device information. @@ -382,8 +382,8 @@ udevadm trigger - <arg choice="opt"><replaceable>options</replaceable></arg> - <arg choice="opt"><replaceable>devpath</replaceable>|<replaceable>file</replaceable>|<replaceable>unit</replaceable></arg> + <optional><replaceable>options</replaceable></optional> + <optional><replaceable>devpath</replaceable>|<replaceable>file</replaceable>|<replaceable>unit</replaceable></optional> Request device events from the kernel. Primarily used to replay events at system coldplug time. @@ -550,14 +550,16 @@ Typically, it is essential that applications which intend to use such a match, make sure a suitable udev rule is installed that sets at least one property on devices that shall be matched. See also Initialized Devices section below for more details. - WARNING: can potentially save a significant - amount of time compared to re-triggering all devices in the system and e.g. can be used to - optimize boot time. However, this is not safe to be used in a boot sequence in general. - Especially, when udev rules for a device depend on its parent devices (e.g. - ATTRS or IMPORT{parent} keys, see - udev7 - for more details), the final state of the device becomes easily unstable with this option. - + + can potentially save a significant + amount of time compared to re-triggering all devices in the system and e.g. can be used to + optimize boot time. However, this is not safe to be used in a boot sequence in general. + Especially, when udev rules for a device depend on its parent devices (e.g. + ATTRS or IMPORT{parent} keys, see + udev7 + for more details), the final state of the device becomes easily unstable with this option. + + @@ -607,7 +609,7 @@ udevadm settle - <arg choice="opt"><replaceable>options</replaceable></arg> + <optional><replaceable>options</replaceable></optional> Watches the udev event queue, and exits if all current events are handled. @@ -702,7 +704,7 @@ - value + Set the maximum number of events, systemd-udevd will handle at the same time. When 0 is specified, then the maximum is determined based on the system resources. @@ -719,18 +721,59 @@ - seconds + The maximum number of seconds to wait for a reply from systemd-udevd. + + + + When specified, the following credentials are used when passed in: + + + + udev.conf.* + + These credentials should contain valid + udev.conf5 + configuration data. From each matching credential a separate file is created. Example: a + passed credential udev.conf.50-foobar will be copied into a + configuration file /run/udev/udev.conf.d/50-foobar.conf. + + + + + + udev.rules.* + + These credentials should contain valid + udev7 + rules. From each matching credential a separate file is created. Example: a passed credential + udev.rules.50-foobar will be copied into a configuration file + /run/udev/rules.d/50-foobar.rules. + + + + + + + Note, this does not imply option. So, if + systemd-udevd is already running, please consider to also specify + to make the copied udev rules files used by + systemd-udevd. + + + + + udevadm monitor - <arg choice="opt"><replaceable>options</replaceable></arg> + <optional><replaceable>options</replaceable></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 @@ -782,8 +825,8 @@ udevadm test - <arg choice="opt"><replaceable>options</replaceable></arg> - <arg choice="opt"><replaceable>devpath</replaceable>|<replaceable>file</replaceable>|<replaceable>unit</replaceable></arg> + <optional><replaceable>options</replaceable></optional> + <optional><replaceable>devpath</replaceable>|<replaceable>file</replaceable>|<replaceable>unit</replaceable></optional> Simulate a udev event run for the given device, and print debug output. @@ -819,9 +862,9 @@ udevadm test-builtin - <arg choice="opt"><replaceable>options</replaceable></arg> - <arg><replaceable>command</replaceable></arg> - <arg choice="opt"><replaceable>devpath</replaceable>|<replaceable>file</replaceable>|<replaceable>unit</replaceable></arg> + <optional><replaceable>options</replaceable></optional> + <replaceable>command</replaceable> + <optional><replaceable>devpath</replaceable>|<replaceable>file</replaceable>|<replaceable>unit</replaceable></optional> Run a built-in command COMMAND for device DEVPATH, and print debug @@ -848,8 +891,8 @@ udevadm verify - <arg choice="opt"><replaceable>options</replaceable></arg> - <arg choice="opt" rep="repeat"><replaceable>file</replaceable></arg> + <optional><replaceable>options</replaceable></optional> + <optional><replaceable>file</replaceable></optional> … @@ -913,8 +956,8 @@ udevadm wait - <arg choice="opt"><replaceable>options</replaceable></arg> - <arg choice="opt"><replaceable>device|syspath</replaceable></arg> + <optional><replaceable>options</replaceable></optional> + <optional><replaceable>device|syspath</replaceable></optional> … @@ -977,8 +1020,8 @@ udevadm lock - <arg choice="opt"><replaceable>options</replaceable></arg> - <arg choice="opt"><replaceable>command</replaceable></arg> + <optional><replaceable>options</replaceable></optional> + <optional><replaceable>command</replaceable></optional> … @@ -1111,11 +1154,13 @@ See Also - + + udev7 - , - + + systemd-udevd.service8 - + + -- cgit v1.2.3