udevd: add --debug-trace option

[elogind.git] / udevd.8

diff --git a/udevd.8 b/udevd.8
index ab13a311070b506cd4641b7e69981e38343f4897..cc724dceda78db1f4818caae1cbc8f2f3176c1bb 100644 (file)
--- a/udevd.8
+++ b/udevd.8
@@ -1,40 +1,59 @@
-.TH UDEVD 8 "February 2004" "" "Linux Administrator's Manual"
-.SH NAME
-udevd \- udev event serializer daemon
-.br
-udevsend \- sends the event to udevd
+.\"     Title: udevd
+.\"    Author: 
+.\" Generator: DocBook XSL Stylesheets v1.70.1 <http://docbook.sf.net/>
+.\"      Date: August 2005
+.\"    Manual: udevd, udevcontrol
+.\"    Source: udev
+.\"
+.TH "UDEVD" "8" "August 2005" "udev" "udevd, udevcontrol"
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+udevd \- event managing daemon
+.SH "SYNOPSIS"
+.HP 6
+\fBudevd\fR [\fB\-\-daemon\fR] [\fB\-\-debug\-trace\fR] [\fB\-\-verbose\fR] [\fB\-\-help\fR]
+.HP 20
+\fBudevcontrol \fR\fB\fIcommand\fR\fR
 .SH "DESCRIPTION"
-.B udevd
-allows the serialization of
-.BR hotplug (8)
-events. The events generated by the kernel may arrive in random order
-in userspace, that makes it neccessary to reorder it.
-.br
-.B udevd
-takes care of the kernel supplied sequence number and arranges the events for
-execution in the correct order. Missing sequences are delaying the
-execution of the following events until a timeout of a maximum of 5 seconds
-is reached.
-.br
-For each event a
-.BR udev (8)
-instance is executed in the background. All further events for the same device
-are delayed until the execution is finished. This way it will never run more
-than one instance for a single device at the same time.
-.br
-.B udevd
-receives the events from
-.B udevsend
-which is called by
-.BR hotplug (8).
-If
-.B udevd
-isn't already running,
-.B udevsend
-will start it.
+.PP
+udevd listens to kernel uevents and passes the incoming events to udev. It ensures the right event order and takes care, that events for child devices are delayed until the parent has finished the device handling.
+.SH "OPTIONS"
+.TP 3n
+\fB\-\-daemon\fR
+Detach and run in the background.
+.TP 3n
+\fB\-\-debug\-trace\fR
+Run all events completely serialized. This may be useful if udev triggers actions or loads kernel modules which cause problems and a slow but continiuous operation is needed, where no events are processed in parallel.
+.TP 3n
+\fB\-\-verbose\fR
+Print log messages to stdout.
+.TP 3n
+\fB\-\-help\fR
+Print usage.
+.TP 3n
+\fBlog_priority=\fR\fB\fIvalue\fR\fR
+udevcontrol can dynamically set the log level of udevd. Valid values are the numerical syslog priorities or their textual representations:
+\fBerr\fR,
+\fBinfo\fR
+and
+\fBdebug\fR.
+.TP 3n
+\fBstop_exec_queue\fR
+udevcontrol stops the execution of events from udevd.
+.TP 3n
+\fBstart_exec_queue\fR
+udevcontrol starts the execution of events from udevd.
+.SH "ENVIRONMENT"
+.TP 3n
+\fBUDEV_LOG\fR
+Overrides the syslog priority specified in the config file.
+.SH "AUTHOR"
+.PP
+Written by Kay Sievers
+<kay.sievers@vrfy.org>.
 .SH "SEE ALSO"
-.BR udev (8), " hotplug" (8)
-.SH AUTHORS
-.B udevd
-was developed primarily by Kay Sievers <kay.sievers@vrfy.org>, with much help
-from others.
+.PP
+\fBudev\fR(7)