From: Yu Watanabe Date: Wed, 5 Feb 2025 00:01:28 +0000 (+0900) Subject: man/udevadm: rebreak and reindent lines X-Git-Tag: v258-rc1~1422^2 X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=refs%2Fpull%2F36267%2Fhead;p=thirdparty%2Fsystemd.git man/udevadm: rebreak and reindent lines --- diff --git a/man/udevadm.xml b/man/udevadm.xml index 5104eee12b7..c7097e88ccc 100644 --- a/man/udevadm.xml +++ b/man/udevadm.xml @@ -23,9 +23,9 @@ udevadm - - - + + + udevadm info options devpath @@ -66,7 +66,8 @@ - Description + + Description udevadm expects a command and command specific options. It controls the runtime behavior of systemd-udevd, requests kernel events, manages @@ -95,10 +96,11 @@ - udevadm info + <refsect2> + <title>udevadm info <optional><replaceable>options</replaceable></optional> <optional><replaceable>devpath</replaceable>|<replaceable>file</replaceable>|<replaceable>unit</replaceable></optional> - + Query the udev database for device information. @@ -130,7 +132,7 @@ be a comma-separated list of property names. If not specified, all known properties are shown. - + @@ -244,7 +246,7 @@ Wait for device to be initialized. If argument SECONDS is not specified, the default is to wait forever. - + @@ -254,7 +256,7 @@ When used with , only show devices of or not of the given subsystem respectively. - + @@ -264,7 +266,7 @@ When used with , only show devices matching or not matching the given attribute respectively. - + @@ -273,7 +275,7 @@ When used with , only show devices matching the given property and value. - + @@ -281,7 +283,7 @@ When used with , only show devices with the given tag. - + @@ -290,7 +292,7 @@ When used with , only show devices with the given /sys path. - + @@ -299,7 +301,7 @@ When used with , only show devices with the given name in /dev. - + @@ -308,7 +310,7 @@ When used with , only show devices with the given parent device. - + @@ -406,10 +408,12 @@ - udevadm trigger + <refsect2> + <title>udevadm trigger <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. Takes device specifications as positional arguments. See the description of info @@ -436,7 +440,7 @@ Suppress error logging in triggering events. - + @@ -642,10 +646,13 @@ respectively. - udevadm settle + <refsect2> + <title>udevadm settle <optional><replaceable>options</replaceable></optional> - + + Watches the udev event queue, and exits if all current events are handled. + @@ -673,8 +680,11 @@ for more information. - udevadm control <replaceable>option</replaceable> + + udevadm control <replaceable>option</replaceable> + Modify the internal state of the running udev daemon. + @@ -807,18 +817,19 @@ - - - udevadm monitor + <refsect2> + <title>udevadm monitor <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 event timing, by comparing the timestamps of the kernel uevent and the udev event. + @@ -862,11 +873,14 @@ - udevadm test + <refsect2> + <title>udevadm test <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. + @@ -918,19 +932,20 @@ - - - udevadm test-builtin + <refsect2> + <title>udevadm test-builtin <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 output. + @@ -942,7 +957,7 @@ and unbind. Also, the special value help can be used to list the possible actions. The default value is add. - + @@ -1004,7 +1019,7 @@ Do not show summary. - + @@ -1113,7 +1128,7 @@ there is no udev rules for the specified devices, as the devices will never be considered as initialized in that case. See Initialized Devices section below for more details. - + @@ -1168,61 +1183,69 @@ - Takes a path to a device node of the device to lock. This switch may be used - multiple times (and in combination with ) in order to lock multiple - devices. If a partition block device node is specified the containing "whole" block device is - automatically determined and used for the lock, as per the specification. If multiple devices are - specified, they are deduplicated, sorted by the major/minor of their device nodes and then locked - in order. + + Takes a path to a device node of the device to lock. This switch may be used + multiple times (and in combination with ) in order to lock multiple + devices. If a partition block device node is specified the containing "whole" block device is + automatically determined and used for the lock, as per the specification. If multiple devices are + specified, they are deduplicated, sorted by the major/minor of their device nodes and then locked + in order. - This switch must be used at least once, to specify at least one device to - lock. (Alternatively, use , see below.) + This switch must be used at least once, to specify at least one device to + lock. (Alternatively, use , see below.) - + + - If a path to a device node is specified, identical to - . However, this switch alternatively accepts a path to a regular file or - directory, in which case the block device of the file system the file/directory resides on is - automatically determined and used as if it was specified with - . + + If a path to a device node is specified, identical to + . However, this switch alternatively accepts a path to a regular file or + directory, in which case the block device of the file system the file/directory resides on is + automatically determined and used as if it was specified with + . - + + - Specifies how long to wait at most until all locks can be taken. Takes a value in - seconds, or in the usual supported time units, see - systemd.time7. If - specified as zero the lock is attempted and if not successful the invocation will immediately - fail. If passed as infinity (the default) the invocation will wait indefinitely - until the lock can be acquired. If the lock cannot be taken in the specified time the specified - command will not be executed and the invocation will fail. + + Specifies how long to wait at most until all locks can be taken. Takes a value in + seconds, or in the usual supported time units, see + systemd.time7. If + specified as zero the lock is attempted and if not successful the invocation will immediately + fail. If passed as infinity (the default) the invocation will wait indefinitely + until the lock can be acquired. If the lock cannot be taken in the specified time the specified + command will not be executed and the invocation will fail. - + + - Instead of locking the specified devices and executing a command, just print the - device paths that would be locked, and execute no command. This command is useful to determine - the "whole" block device in case a partition block device is specified. The devices will be sorted - by their device node major number as primary ordering key and the minor number as secondary - ordering key (i.e. they are shown in the order they'd be locked). Note that the number of lines - printed here can be less than the number of and - switches specified in case these resolve to the same "whole" - devices. + + Instead of locking the specified devices and executing a command, just print the + device paths that would be locked, and execute no command. This command is useful to determine + the "whole" block device in case a partition block device is specified. The devices will be sorted + by their device node major number as primary ordering key and the minor number as secondary + ordering key (i.e. they are shown in the order they'd be locked). Note that the number of lines + printed here can be less than the number of and + switches specified in case these resolve to the same "whole" + devices. - + + diff --git a/tools/command_ignorelist b/tools/command_ignorelist index f68577e9375..d868c55b15e 100644 --- a/tools/command_ignorelist +++ b/tools/command_ignorelist @@ -486,16 +486,16 @@ udev.xml /refsect1[title="Rules Files"]/refsect2[title="Keys"]/variablelist[4]/v udev.xml /refsect1[title="Rules Files"]/refsect2[title="Keys"]/variablelist[4]/varlistentry[term="$$"] udevadm.xml /refsect1[title="Options"]/variablelist/varlistentry[term="-d"] udevadm.xml /refsect1[title="Options"]/variablelist/varlistentry[term="-V"] -udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm info\n options\n devpath|file|unit\n "]/variablelist/varlistentry[term="-q"] -udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm info\n options\n devpath|file|unit\n "]/variablelist/varlistentry[term="-p"] -udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm info\n options\n devpath|file|unit\n "]/variablelist/varlistentry[term="-n"] -udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm info\n options\n devpath|file|unit\n "]/variablelist/varlistentry[term="-r"] -udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm info\n options\n devpath|file|unit\n "]/variablelist/varlistentry[term="-a"] -udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm info\n options\n devpath|file|unit\n "]/variablelist/varlistentry[term="-x"] -udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm info\n options\n devpath|file|unit\n "]/variablelist/varlistentry[term="-P"] -udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm info\n options\n devpath|file|unit\n "]/variablelist/varlistentry[term="-d"] -udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm info\n options\n devpath|file|unit\n "]/variablelist/varlistentry[term="-e"] -udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm info\n options\n devpath|file|unit\n "]/variablelist/varlistentry[term="-c"] +udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm info\n options\n devpath|file|unit\n "]/variablelist/varlistentry[term="-q"] +udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm info\n options\n devpath|file|unit\n "]/variablelist/varlistentry[term="-p"] +udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm info\n options\n devpath|file|unit\n "]/variablelist/varlistentry[term="-n"] +udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm info\n options\n devpath|file|unit\n "]/variablelist/varlistentry[term="-r"] +udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm info\n options\n devpath|file|unit\n "]/variablelist/varlistentry[term="-a"] +udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm info\n options\n devpath|file|unit\n "]/variablelist/varlistentry[term="-x"] +udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm info\n options\n devpath|file|unit\n "]/variablelist/varlistentry[term="-P"] +udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm info\n options\n devpath|file|unit\n "]/variablelist/varlistentry[term="-d"] +udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm info\n options\n devpath|file|unit\n "]/variablelist/varlistentry[term="-e"] +udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm info\n options\n devpath|file|unit\n "]/variablelist/varlistentry[term="-c"] udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm trigger\n options\n devpath|file|unit\n "]/variablelist/varlistentry[term="-v"] udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm trigger\n options\n devpath|file|unit\n "]/variablelist/varlistentry[term="-n"] udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm trigger\n options\n devpath|file|unit\n "]/variablelist/varlistentry[term="-t"] @@ -508,8 +508,8 @@ udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm trigger\n op udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm trigger\n options\n devpath|file|unit\n "]/variablelist/varlistentry[term="-g"] udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm trigger\n options\n devpath|file|unit\n "]/variablelist/varlistentry[term="-y"] udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm trigger\n options\n devpath|file|unit\n "]/variablelist/varlistentry[term="-b"] -udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm settle\n options\n "]/variablelist/varlistentry[term="-t"] -udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm settle\n options\n "]/variablelist/varlistentry[term="-E"] +udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm settle\n options\n "]/variablelist/varlistentry[term="-t"] +udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm settle\n options\n "]/variablelist/varlistentry[term="-E"] udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm control option"]/variablelist/varlistentry[term="-e"] udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm control option"]/variablelist/varlistentry[term="-l"] udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm control option"]/variablelist/varlistentry[term="-s"] @@ -518,12 +518,12 @@ udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm control option"]/ udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm control option"]/variablelist/varlistentry[term="-p"] udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm control option"]/variablelist/varlistentry[term="-m"] udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm control option"]/variablelist/varlistentry[term="-t"] -udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm monitor\n options\n "]/variablelist/varlistentry[term="-k"] -udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm monitor\n options\n "]/variablelist/varlistentry[term="-u"] -udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm monitor\n options\n "]/variablelist/varlistentry[term="-p"] -udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm monitor\n options\n "]/variablelist/varlistentry[term="-s"] -udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm monitor\n options\n "]/variablelist/varlistentry[term="-t"] -udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm test\n options\n devpath|file|unit\n "]/variablelist/varlistentry[term="-a"] +udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm monitor\n options\n "]/variablelist/varlistentry[term="-k"] +udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm monitor\n options\n "]/variablelist/varlistentry[term="-u"] +udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm monitor\n options\n "]/variablelist/varlistentry[term="-p"] +udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm monitor\n options\n "]/variablelist/varlistentry[term="-s"] +udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm monitor\n options\n "]/variablelist/varlistentry[term="-t"] +udevadm.xml /refsect1[title="Options"]/refsect2[title="udevadm test\n options\n devpath|file|unit\n "]/variablelist/varlistentry[term="-a"] vconsole.conf.xml /refsect1[title="Options"]/variablelist/varlistentry[term="KEYMAP="] vconsole.conf.xml /refsect1[title="Options"]/variablelist/varlistentry[term="FONT="] file-hierarchy.xml /refsect1[title="General Structure"]/variablelist/varlistentry[term="/"]