mirror of
https://github.com/systemd/systemd.git
synced 2024-10-28 11:55:44 +03:00
[PATCH] udev - man page update
Hey it's not longer the "goal" to provide a dynamic dev directory, we have just arrived. So I change it to more self-confident words :) I've also added the completly missing environment variables to the man pages. To stop the misuse of the PROGRAM= call paramenters, we better mention its limitations.
This commit is contained in:
parent
c472e3c89b
commit
bef370d6eb
33
udev.8
33
udev.8
@ -3,11 +3,34 @@
|
|||||||
udev \- Linux configurable dynamic device naming support
|
udev \- Linux configurable dynamic device naming support
|
||||||
.SH SYNOPSIS
|
.SH SYNOPSIS
|
||||||
.BI udev " hotplug-subsystem"
|
.BI udev " hotplug-subsystem"
|
||||||
|
.P
|
||||||
|
The environment must provide the following variables:
|
||||||
|
.TP
|
||||||
|
.B ACTION
|
||||||
|
.IR add " or " remove
|
||||||
|
signifies the connection or disconnection of a device.
|
||||||
|
.TP
|
||||||
|
.B DEVPATH
|
||||||
|
The sysfs devpath of the device without the mountpoint but a leading slash.
|
||||||
|
.P
|
||||||
|
Additional optional environment variables are:
|
||||||
|
.TP
|
||||||
|
.B UDEV_CONFIG_FILE
|
||||||
|
Overrides the default location of the
|
||||||
|
.B udev
|
||||||
|
config file.
|
||||||
|
.TP
|
||||||
|
.B UDEV_NO_SLEEP
|
||||||
|
The default behavior of
|
||||||
|
.B udev
|
||||||
|
is to wait until all the sysfs files of the device chain are populated. If set
|
||||||
|
.B udev
|
||||||
|
will will continue, regardless of the state of the device representation.
|
||||||
.SH "DESCRIPTION"
|
.SH "DESCRIPTION"
|
||||||
.B udev
|
.B udev
|
||||||
creates or removes device node files usually located in the /dev directory.
|
creates or removes device node files usually located in the /dev directory.
|
||||||
Its goal is to provide a dynamic device directory that contains only the files
|
It provides a dynamic device directory that contains only the files for
|
||||||
for devices that are actually present.
|
devices that are actually present.
|
||||||
.P
|
.P
|
||||||
As part of the
|
As part of the
|
||||||
.B hotplug
|
.B hotplug
|
||||||
@ -159,6 +182,11 @@ all of the values being required in order to match the rule.
|
|||||||
.TP
|
.TP
|
||||||
.B PROGRAM
|
.B PROGRAM
|
||||||
Call external program. This key is valid if the program returns successful.
|
Call external program. This key is valid if the program returns successful.
|
||||||
|
A few command line options may specified, but shell characters like pipe,
|
||||||
|
diversion or similiar options are not available. The environment variables of
|
||||||
|
.B udev
|
||||||
|
are also available for the program.
|
||||||
|
.br
|
||||||
The string returned by the program may additionally matched with the
|
The string returned by the program may additionally matched with the
|
||||||
.B RESULT
|
.B RESULT
|
||||||
key.
|
key.
|
||||||
@ -285,6 +313,7 @@ following the '[' is a '!' then any character not enclosed is matched.
|
|||||||
.LP
|
.LP
|
||||||
.SH "SEE ALSO"
|
.SH "SEE ALSO"
|
||||||
.BR udevinfo (8),
|
.BR udevinfo (8),
|
||||||
|
.BR udevd (8),
|
||||||
.BR hotplug (8)
|
.BR hotplug (8)
|
||||||
.PP
|
.PP
|
||||||
The
|
The
|
||||||
|
19
udevd.8
19
udevd.8
@ -3,6 +3,21 @@
|
|||||||
udevd \- udev event serializer daemon
|
udevd \- udev event serializer daemon
|
||||||
.br
|
.br
|
||||||
udevsend \- sends the event to udevd
|
udevsend \- sends the event to udevd
|
||||||
|
.SH SYNOPSIS
|
||||||
|
.BI udevsend " hotplug-subsystem"
|
||||||
|
.sp
|
||||||
|
The environment must provide the following variables:
|
||||||
|
.TP
|
||||||
|
.B ACTION
|
||||||
|
.IR add " or " remove
|
||||||
|
signifies the connection or disconnection of a device.
|
||||||
|
.TP
|
||||||
|
.B DEVPATH
|
||||||
|
The sysfs devpath of the device without the mountpoint but a leading slash.
|
||||||
|
.TP
|
||||||
|
.B SEQNUM
|
||||||
|
The sequence number of the event provided by the kernel.
|
||||||
|
If unset, the event bypasses the queue and will be executed immediately.
|
||||||
.SH "DESCRIPTION"
|
.SH "DESCRIPTION"
|
||||||
.B udevd
|
.B udevd
|
||||||
allows the serialization of
|
allows the serialization of
|
||||||
@ -33,7 +48,9 @@ isn't already running,
|
|||||||
.B udevsend
|
.B udevsend
|
||||||
will start it.
|
will start it.
|
||||||
.SH "SEE ALSO"
|
.SH "SEE ALSO"
|
||||||
.BR udev (8), " hotplug" (8)
|
.BR udev (8),
|
||||||
|
.BR udevinfo (8),
|
||||||
|
.BR hotplug (8)
|
||||||
.SH AUTHORS
|
.SH AUTHORS
|
||||||
.B udevd
|
.B udevd
|
||||||
was developed primarily by Kay Sievers <kay.sievers@vrfy.org>, with much help
|
was developed primarily by Kay Sievers <kay.sievers@vrfy.org>, with much help
|
||||||
|
Loading…
Reference in New Issue
Block a user