summaryrefslogtreecommitdiffstats
path: root/upstream/fedora-rawhide/man8/udevadm.8
diff options
context:
space:
mode:
Diffstat (limited to 'upstream/fedora-rawhide/man8/udevadm.8')
-rw-r--r--upstream/fedora-rawhide/man8/udevadm.874
1 files changed, 63 insertions, 11 deletions
diff --git a/upstream/fedora-rawhide/man8/udevadm.8 b/upstream/fedora-rawhide/man8/udevadm.8
index 234da89e..13c69e52 100644
--- a/upstream/fedora-rawhide/man8/udevadm.8
+++ b/upstream/fedora-rawhide/man8/udevadm.8
@@ -1,5 +1,5 @@
'\" t
-.TH "UDEVADM" "8" "" "systemd 255" "udevadm"
+.TH "UDEVADM" "8" "" "systemd 256~rc3" "udevadm"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
@@ -64,7 +64,7 @@ commands\&.
.RS 4
Print a short help text and exit\&.
.RE
-.SS "udevadm info [\fIoptions\fR] [\fIdevpath\fR|\fIfile\fR|\fIunit\fR...]"
+.SS "udevadm info [\fIoptions\fR] [\fIdevpath\fR|\fIfile\fR|\fIunit\fR]"
.PP
Query the udev database for device information\&.
.PP
@@ -260,7 +260,7 @@ When used with
Added in version 255\&.
.RE
.PP
-\fB\-\-json=\fR\fIMODE\fR
+\fB\-\-json=\fR\fB\fIMODE\fR\fR
.RS 4
Shows output formatted as JSON\&. Expects one of
"short"
@@ -504,8 +504,18 @@ is specified, trigger events for devices that are not initialized by
yet, and skip devices that are already initialized\&.
.sp
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\&.
+.if n \{\
.sp
-WARNING:
+.\}
+.RS 4
+.it 1 an-trap
+.nr an-no-space-flag 1
+.nr an-break-flag 1
+.br
+.ps +1
+\fBWarning\fR
+.ps -1
+.br
\fB\-\-initialized\-nomatch\fR
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"
@@ -514,7 +524,8 @@ or
keys, see
\fBudev\fR(7)
for more details), the final state of the device becomes easily unstable with this option\&.
-.sp
+.sp .5v
+.RE
Added in version 251\&.
.RE
.PP
@@ -640,7 +651,7 @@ Signal systemd\-udevd to reload the rules files and other databases like the ker
Set a global property for all events\&.
.RE
.PP
-\fB\-m\fR, \fB\-\-children\-max=\fR\fIvalue\fR
+\fB\-m\fR, \fB\-\-children\-max=\fR\fB\fIvalue\fR\fR
.RS 4
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\&.
.RE
@@ -652,11 +663,53 @@ Send a ping message to systemd\-udevd and wait for the reply\&. This may be usef
Added in version 241\&.
.RE
.PP
-\fB\-t\fR, \fB\-\-timeout=\fR\fIseconds\fR
+\fB\-t\fR, \fB\-\-timeout=\fR\fB\fIseconds\fR\fR
.RS 4
The maximum number of seconds to wait for a reply from systemd\-udevd\&.
.RE
.PP
+\fB\-\-load\-credentials\fR
+.RS 4
+When specified, the following credentials are used when passed in:
+.PP
+\fIudev\&.conf\&.*\fR
+.RS 4
+These credentials should contain valid
+\fBudev.conf\fR(5)
+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\&.
+.sp
+Added in version 256\&.
+.RE
+.PP
+\fIudev\&.rules\&.*\fR
+.RS 4
+These credentials should contain valid
+\fBudev\fR(7)
+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\&.
+.sp
+Added in version 256\&.
+.RE
+.sp
+Note, this
+\fIdoes not\fR
+imply
+\fB\-\-reload\fR
+option\&. So, if
+\fBsystemd\-udevd\fR
+is already running, please consider to also specify
+\fB\-reload\fR
+to make the copied udev rules files used by
+\fBsystemd\-udevd\fR\&.
+.sp
+Added in version 256\&.
+.RE
+.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
Print a short help text and exit\&.
@@ -729,7 +782,7 @@ Added in version 209\&.
.RS 4
Print a short help text and exit\&.
.RE
-.SS "udevadm test\-builtin [\fIoptions\fR] [\fIcommand\fR] [\fIdevpath\fR|\fIfile\fR|\fIunit\fR]"
+.SS "udevadm test\-builtin [\fIoptions\fR] \fIcommand\fR [\fIdevpath\fR|\fIfile\fR|\fIunit\fR]"
.PP
Run a built\-in command
\fICOMMAND\fR
@@ -763,7 +816,7 @@ Print a short help text and exit\&.
.RS 4
Print a short version string and exit\&.
.RE
-.SS "udevadm verify [\fIoptions\fR] [\fIfile\fR...] \&..."
+.SS "udevadm verify [\fIoptions\fR] [\fIfile\fR] \&..."
.PP
Verify syntactic, semantic, and stylistic correctness of udev rules files\&.
.PP
@@ -984,8 +1037,7 @@ doesn\*(Aqt probe or announce the new superblock before it is fully written:
.\}
.SH "SEE ALSO"
.PP
-\fBudev\fR(7),
-\fBsystemd-udevd.service\fR(8)
+\fBudev\fR(7), \fBsystemd-udevd.service\fR(8)
.SH "NOTES"
.IP " 1." 4
Locking Block Device Access