From 0ba3128e90ae7f0eb7ab55bd7feb58513c454c82 Mon Sep 17 00:00:00 2001 From: "Anthony G. Basile" Date: Sun, 2 Nov 2014 14:36:05 -0500 Subject: man: update man pages Signed-off-by: Anthony G. Basile --- man/udev.7 | 2 +- man/udev.conf.5 | 4 ++-- man/udevadm.8 | 2 +- man/udevd.8 | 54 ++++++++++++++++++++++++++---------------------- man/udevd.xml | 64 ++++++++++++++++++++++++++++++++++++--------------------- 5 files changed, 75 insertions(+), 51 deletions(-) diff --git a/man/udev.7 b/man/udev.7 index 8b6e90208b..da634fa55d 100644 --- a/man/udev.7 +++ b/man/udev.7 @@ -2,7 +2,7 @@ .\" Title: udev .\" Author: Greg Kroah-Hartmann .\" Generator: DocBook XSL Stylesheets v1.78.0 -.\" Date: 10/31/2014 +.\" Date: 11/02/2014 .\" Manual: udev .\" Source: udev .\" Language: English diff --git a/man/udev.conf.5 b/man/udev.conf.5 index 12a5992ebe..db0fcf492e 100644 --- a/man/udev.conf.5 +++ b/man/udev.conf.5 @@ -2,7 +2,7 @@ .\" Title: udev.conf .\" Author: Kay Sievers .\" Generator: DocBook XSL Stylesheets v1.78.0 -.\" Date: 10/31/2014 +.\" Date: 11/02/2014 .\" Manual: udev.conf .\" Source: eudev .\" Language: English @@ -41,7 +41,7 @@ expects its main configuration file at .PP \fIudev_log\fR .RS 4 -The logging priority\&. Valid values are the numerical syslog priorities or their textual representations: +The log level\&. Valid values are the numerical syslog priorities or their textual representations: \fBerr\fR, \fBinfo\fR and diff --git a/man/udevadm.8 b/man/udevadm.8 index 7ee8e55bf3..a9fe4411a7 100644 --- a/man/udevadm.8 +++ b/man/udevadm.8 @@ -2,7 +2,7 @@ .\" Title: udevadm .\" Author: Kay Sievers .\" Generator: DocBook XSL Stylesheets v1.78.0 -.\" Date: 10/31/2014 +.\" Date: 11/02/2014 .\" Manual: udevadm .\" Source: eudev .\" Language: English diff --git a/man/udevd.8 b/man/udevd.8 index c6251de4d1..69f003d7f6 100644 --- a/man/udevd.8 +++ b/man/udevd.8 @@ -2,12 +2,12 @@ .\" Title: udevd .\" Author: Kay Sievers .\" Generator: DocBook XSL Stylesheets v1.78.0 -.\" Date: 10/31/2014 +.\" Date: 11/02/2014 .\" Manual: udevd -.\" Source: udev +.\" Source: eudev .\" Language: English .\" -.TH "UDEVD" "8" "" "udev" "udevd" +.TH "UDEVD" "8" "" "eudev" "udevd" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -33,16 +33,16 @@ udevd \- Device event managing daemon .PP udevd .HP \w'\fB/sbin/udevd\fR\ 'u -\fB/sbin/udevd\fR [\fB\-\-daemon\fR] [\fB\-\-debug\fR] [\fB\-\-children\-max=\fR] [\fB\-\-exec\-delay=\fR] [\fB\-\-resolve\-names=early|late|never\fR] [\fB\-\-version\fR] [\fB\-\-help\fR] +\fB/sbin/udevd\fR [\fB\-\-daemon\fR] [\fB\-\-debug\fR] [\fB\-\-children\-max=\fR] [\fB\-\-exec\-delay=\fR] [\fB\-\-event\-timeout=\fR] [\fB\-\-resolve\-names=early|late|never\fR] [\fB\-\-version\fR] [\fB\-\-help\fR] .SH "DESCRIPTION" .PP \fBudevd\fR listens to kernel uevents\&. For every event, udevd executes matching instructions specified in udev rules\&. See \fBudev\fR(7)\&. .PP -The behavior of the running daemon can be changed dynamically with -\fBudevadm control\fR, or configured using -\fBudev.conf\fR(5)\&. +The behavior of the daemon can be configured using +\fBudev.conf\fR(5), its command\-line options, environment variables, and on the kernel command\-line, or changed dynamically with +\fBudevadm control\fR\&. .SH "OPTIONS" .PP \fB\-\-daemon\fR @@ -52,7 +52,7 @@ Detach and run in the background\&. .PP \fB\-\-debug\fR .RS 4 -Print debug messages to stderr\&. +Print debug messages to standard error\&. .RE .PP \fB\-\-children\-max=\fR @@ -62,34 +62,33 @@ Limit the number of events executed in parallel\&. .PP \fB\-\-exec\-delay=\fR .RS 4 -Delay the execution of RUN instruction by the given number of seconds\&. This option might be useful when debugging system crashes during coldplug caused by loading non\-working kernel modules\&. +Delay the execution of +\fIRUN\fR +instructions by the given number of seconds\&. This option might be useful when debugging system crashes during coldplug caused by loading non\-working kernel modules\&. .RE .PP -\fB\-\-resolve\-names=\fR +\fB\-\-event\-timeout=\fR .RS 4 -Specify when udevd should resolve names of users and groups\&. When set to -\fBearly\fR -(the default) names will be resolved when the rules are parsed\&. When set to -\fBlate\fR -names will be resolved for every event\&. When set to -\fBnever\fR -names will never be resolved and all devices will be owned by root\&. +Set the number of seconds to wait for events to finish\&. After this time the event will be terminated\&. The default is 30 seconds\&. .RE .PP -\fB\-\-version\fR +\fB\-\-resolve\-names=\fR .RS 4 -Print version number\&. +Specify when udevd should resolve names of users and groups\&. When set to +\fBearly\fR +(the default), names will be resolved when the rules are parsed\&. When set to +\fBlate\fR, names will be resolved for every event\&. When set to +\fBnever\fR, names will never be resolved and all devices will be owned by root\&. .RE .PP \fB\-\-help\fR .RS 4 -Print help text\&. .RE .SH "ENVIRONMENT" .PP \fI$UDEV_LOG=\fR .RS 4 -Set the logging priority\&. +Set the log level\&. .RE .SH "KERNEL COMMAND LINE" .PP @@ -99,7 +98,7 @@ is used in an initrd\&. .PP \fIudev\&.log\-priority=\fR, \fIrd\&.udev\&.log\-priority=\fR .RS 4 -Set the logging priority\&. +Set the log level\&. .RE .PP \fIudev\&.children\-max=\fR, \fIrd\&.udev\&.children\-max=\fR @@ -109,12 +108,19 @@ Limit the number of events executed in parallel\&. .PP \fIudev\&.exec\-delay=\fR, \fIrd\&.udev\&.exec\-delay=\fR .RS 4 -Delay the execution of RUN instruction by the given number of seconds\&. This option might be useful when debugging system crashes during coldplug caused by loading non\-working kernel modules\&. +Delay the execution of +\fIRUN\fR +instructions by the given number of seconds\&. This option might be useful when debugging system crashes during coldplug caused by loading non\-working kernel modules\&. +.RE +.PP +\fIudev\&.event\-timeout=\fR, \fIrd\&.udev\&.event\-timeout=\fR +.RS 4 +Wait for events to finish up to the given number of seconds\&. This option might be useful if events are terminated due to kernel drivers taking too long to initialize\&. .RE .PP \fInet\&.ifnames=\fR .RS 4 -Network interfaces are renamed to give them predictable names when possible\&. It is enabled by default, specifying 0 disables it\&. +Network interfaces are renamed to give them predictable names when possible\&. It is enabled by default; specifying 0 disables it\&. .RE .SH "SEE ALSO" .PP diff --git a/man/udevd.xml b/man/udevd.xml index de670cb578..cfbb798428 100644 --- a/man/udevd.xml +++ b/man/udevd.xml @@ -36,6 +36,7 @@ + @@ -50,10 +51,11 @@ udev7 . - The behavior of the running daemon can be changed - dynamically with udevadm control, or - configured using - udev.conf5. + The behavior of the daemon can be configured using + udev.conf5, + its command-line options, environment variables, and on the kernel + command-line, or changed dynamically with udevadm + control. @@ -65,50 +67,55 @@ Detach and run in the background. + - Print debug messages to stderr. + Print debug messages to standard error. + Limit the number of events executed in parallel. + + Delay the execution of RUN + instructions by the given number of seconds. This option + might be useful when debugging system crashes during + coldplug caused by loading non-working kernel + modules. + + - Delay the execution of RUN instruction by the given - number of seconds. This option might be useful when - debugging system crashes during coldplug caused by loading - non-working kernel modules. + + + + Set the number of seconds to wait for events to finish. After + this time the event will be terminated. The default is 30 seconds. + Specify when udevd should resolve names of users and groups. - When set to (the default) names will be + When set to (the default), names will be resolved when the rules are parsed. When set to - names will be resolved for every event. - When set to names will never be resolved + , names will be resolved for every event. + When set to , names will never be resolved and all devices will be owned by root. - - - - Print version number. - - + - - Print help text. - + @@ -146,20 +153,31 @@ udev.exec-delay= rd.udev.exec-delay= - Delay the execution of RUN instruction by the given + Delay the execution of RUN instructions by the given number of seconds. This option might be useful when debugging system crashes during coldplug caused by loading non-working kernel modules. + + udev.event-timeout= + rd.udev.event-timeout= + + Wait for events to finish up to the given number + of seconds. This option might be useful if events are + terminated due to kernel drivers taking too long to initialize. + + net.ifnames= Network interfaces are renamed to give them predictable names - when possible. It is enabled by default, specifying 0 disables it. + when possible. It is enabled by default; specifying 0 disables it. + -- cgit v1.2.3-54-g00ecf