summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorAnthony G. Basile <blueness@gentoo.org>2015-05-30 07:09:14 -0400
committerAnthony G. Basile <blueness@gentoo.org>2015-05-30 07:09:14 -0400
commit71640ee49826a4e7d35dc31564ed2fab1996beae (patch)
tree9ef22b45d87bd04d1bc664dcb29dbee77f39f6a8
parent5803c30ed226a4e5a4ab12e4d873c8a586ca8cf6 (diff)
man: update
Signed-off-by: Anthony G. Basile <blueness@gentoo.org>
-rw-r--r--man/udev.741
-rw-r--r--man/udev.conf.52
-rw-r--r--man/udevadm.837
-rw-r--r--man/udevd.82
4 files changed, 68 insertions, 14 deletions
diff --git a/man/udev.7 b/man/udev.7
index 7aec25193a..b54683dcd0 100644
--- a/man/udev.7
+++ b/man/udev.7
@@ -2,7 +2,7 @@
.\" Title: udev
.\" Author: Greg Kroah-Hartmann <greg@kroah.com>
.\" Generator: DocBook XSL Stylesheets v1.78.0 <http://docbook.sf.net/>
-.\" Date: 11/07/2014
+.\" Date: 05/30/2015
.\" Manual: udev
.\" Source: udev
.\" Language: English
@@ -131,9 +131,10 @@ Match the subsystem of the event device\&.
Match the driver name of the event device\&. Only set this key for devices which are bound to a driver at the time the event is generated\&.
.RE
.PP
-\fIATTR{\fR\fI\fIfilename\fR\fR\fI}\fR
+\fIATTR{\fR\fI\fIfilename\fR\fR\fI}\fR, \fISYSCTL{\fR\fI\fIkernel parameter\fR\fR\fI}\fR
.RS 4
Match sysfs attribute values of the event device\&. Trailing whitespace in the attribute values is ignored unless the specified match value itself contains trailing whitespace\&.
+Match a kernel parameter value\&.
.RE
.PP
\fIKERNELS\fR
@@ -274,6 +275,11 @@ Applies the specified Linux Security Module label to the device node\&.
The value that should be written to a sysfs attribute of the event device\&.
.RE
.PP
+\fISYSCTL{\fR\fI\fIkernel parameter\fR\fR\fI}\fR
+.RS 4
+The value that should be written to kernel parameter\&.
+.RE
+.PP
\fIENV{\fR\fI\fIkey\fR\fR\fI}\fR
.RS 4
Set a device property value\&. Property names with a leading
@@ -566,6 +572,37 @@ The content of all hwdb files is read by
\fBudevadm\fR(8)
and compiled to a binary database located at
/etc/udev/hwdb\&.bin\&. During runtime only the binary database is used\&.
+.SH "HARDWARE DATABASE FILES"
+.PP
+The hwdb files are read from the files located in the system hwdb directory
+/usr/lib/udev/hwdb\&.d, the volatile runtime directory
+/run/udev/hwdb\&.d
+and the local administration directory
+/etc/udev/hwdb\&.d\&. All hwdb files are collectively sorted and processed in lexical order, regardless of the directories in which they live\&. However, files with identical filenames replace each other\&. Files in
+/etc
+have the highest priority, files in
+/run
+take precedence over files with the same name in
+/usr/lib\&. This can be used to override a system\-supplied hwdb file with a local file if needed; a symlink in
+/etc
+with the same name as a hwdb file in
+/usr/lib, pointing to
+/dev/null, disables the hwdb file entirely\&. hwdb files must have the extension
+\&.hwdb; other extensions are ignored\&.
+.PP
+The hwdb file contains data records consisting of matches and associated key\-value pairs\&. Every record in the hwdb starts with one or more match string, specifying a shell glob to compare the database lookup string against\&. Multiple match lines are specified in additional consecutive lines\&. Every match line is compared indivdually, they are combined by OR\&. Every match line must start at the first character of the line\&.
+.PP
+The match lines are followed by one or more key\-value pair lines, which are recognized by a leading space character\&. The key name and value are separated by
+=\&. An empty line signifies the end of a record\&. Lines beginning with
+#
+are ignored\&.
+.PP
+The content of all hwdb files is read by
+\fBudevadm\fR(8)
+and compiled to a binary database located at
+/etc/udev/hwdb\&.bin, or alternatively
+/usr/lib/udev/hwdb\&.bin
+if you want ship the compiled database in an immutable image\&. During runtime only the binary database is used\&.
.SH "SEE ALSO"
.PP
diff --git a/man/udev.conf.5 b/man/udev.conf.5
index be1bba7f0a..81424208aa 100644
--- a/man/udev.conf.5
+++ b/man/udev.conf.5
@@ -2,7 +2,7 @@
.\" Title: udev.conf
.\" Author: Kay Sievers <kay@vrfy.org>
.\" Generator: DocBook XSL Stylesheets v1.78.0 <http://docbook.sf.net/>
-.\" Date: 11/07/2014
+.\" Date: 05/30/2015
.\" Manual: udev.conf
.\" Source: eudev
.\" Language: English
diff --git a/man/udevadm.8 b/man/udevadm.8
index 828830be51..64b56e59ea 100644
--- a/man/udevadm.8
+++ b/man/udevadm.8
@@ -2,7 +2,7 @@
.\" Title: udevadm
.\" Author: Kay Sievers <kay@vrfy.org>
.\" Generator: DocBook XSL Stylesheets v1.78.0 <http://docbook.sf.net/>
-.\" Date: 11/07/2014
+.\" Date: 05/30/2015
.\" Manual: udevadm
.\" Source: eudev
.\" Language: English
@@ -69,7 +69,7 @@ Print version number\&.
.RS 4
Print help text\&.
.RE
-.SS "udevadm info [\fIOPTIONS\fR] [\fIDEVPATH\fR|\fIFILE\fR]"
+.SS "udevadm info [\fIoptions\fR] [\fIdevpath\fR|\fIfile\fR]"
.PP
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\&.
.PP
@@ -160,7 +160,13 @@ Print version\&.
.RS 4
Print help text\&.
.RE
-.SS "udevadm trigger [options]"
+.PP
+In addition an optional positional argument can be used to specify a device name or a sys path\&. It must start with
+/dev
+or
+/sys
+respectively\&.
+.SS "udevadm trigger [\fIoptions\fR] [\fIdevpath\fR|\fIfile\fR...]"
.PP
Request device events from the kernel\&. Primarily used to replay events at system coldplug time\&.
.PP
@@ -218,9 +224,14 @@ Trigger events for devices with a matching property value\&. This option can be
Trigger events for devices with a matching tag\&. This option can be specified multiple times\&.
.RE
.PP
-\fB\-y\fR, \fB\-\-sysname\-match=\fR\fB\fINAME\fR\fR
+\fB\-y\fR, \fB\-\-sysname\-match=\fR\fB\fIPATH\fR\fR
.RS 4
-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 path\&. This option can be specified multiple times and supports shell style pattern matching\&.
+.RE
+.PP
+\fB\-\-name\-match=\fR\fB\fINAME\fR\fR
+.RS 4
+Trigger events for devices with a matching device path\&. This options can be specified multiple times\&.
.RE
.PP
\fB\-b\fR, \fB\-\-parent\-match=\fR\fB\fISYSPATH\fR\fR
@@ -232,7 +243,13 @@ Trigger events for all children of a given device\&.
.RS 4
Print help text\&.
.RE
-.SS "udevadm settle [options]"
+.PP
+In addition optional positional arguments can be used to specify device names or sys paths\&. They must start with
+/dev
+or
+/sys
+respectively\&.
+.SS "udevadm settle [\fIoptions\fR]"
.PP
Watches the udev event queue, and exits if all current events are handled\&.
.PP
@@ -307,7 +324,7 @@ The maximum number of seconds to wait for a reply from udevd\&.
.RS 4
Print help text\&.
.RE
-.SS "udevadm monitor [options]"
+.SS "udevadm monitor [\fIoptions\fR]"
.PP
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\&.
.PP
@@ -340,7 +357,7 @@ Filter events by property\&. Only udev events with a given tag attached will pas
.RS 4
Print help text\&.
.RE
-.SS "udevadm hwdb [options]"
+.SS "udevadm hwdb [\fIoptions\fR]"
.PP
Maintain the hardware database index in
/etc/udev/hwdb\&.bin\&.
@@ -365,7 +382,7 @@ Alternative root path in the file system for reading and writing files\&.
.RS 4
Print help text\&.
.RE
-.SS "udevadm test [options] \fIdevpath\fR"
+.SS "udevadm test [\fIoptions\fR] [\fIdevpath\fR]"
.PP
Simulate a udev event run for the given device, and print debug output\&.
.PP
@@ -387,7 +404,7 @@ Specify when udevadm should resolve names of users and groups\&. When set to
.RS 4
Print help text\&.
.RE
-.SS "udevadm test\-builtin [options] \fICOMMAND\fR \fIDEVPATH\fR"
+.SS "udevadm test\-builtin [\fIoptions\fR] [\fIcommand\fR] [\fIdevpath\fR]"
.PP
Run a built\-in command
\fICOMMAND\fR
diff --git a/man/udevd.8 b/man/udevd.8
index 73aba7576f..fef6eeb934 100644
--- a/man/udevd.8
+++ b/man/udevd.8
@@ -2,7 +2,7 @@
.\" Title: udevd
.\" Author: Kay Sievers <kay@vrfy.org>
.\" Generator: DocBook XSL Stylesheets v1.78.0 <http://docbook.sf.net/>
-.\" Date: 11/07/2014
+.\" Date: 05/30/2015
.\" Manual: udevd
.\" Source: eudev
.\" Language: English