folkslinux
/
eudev
mirror of https://github.com/eudev-project/eudev.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

man: update 

Signed-off-by: Anthony G. Basile <blueness@gentoo.org>
This commit is contained in:
Anthony G. Basile 2015-05-30 07:09:14 -04:00
parent 5803c30ed2
commit 71640ee498
4 changed files with 68 additions and 14 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

41
man/udev.7
View File

@ -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

2
man/udev.conf.5
View File

@ -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

37
man/udevadm.8
View File

@ -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

2
man/udevd.8
View File

@ -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