udevd: add --debug-trace option

[elogind.git] / udevd.8

diff --git a/udevd.8 b/udevd.8
index 9d0127b6bcd79c5c422ac5e40785e073caaba8d9..cc724dceda78db1f4818caae1cbc8f2f3176c1bb 100644 (file)
--- a/udevd.8
+++ b/udevd.8
@@ -1,56 +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
-.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.
+.\"     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 them.
-.br
-.B udevd
-takes care of the kernel supplied sequence number and arranges the events for
-execution in the correct order. Missing sequences delay 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 there will never be more
-than one instance running 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),
-.BR udevinfo (8),
-.BR 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)