man: recreate man pages

[elogind.git] / udevinfo.8

diff --git a/udevinfo.8 b/udevinfo.8
index 67d034aea6f3cb90bd6183d3ea2e1693a9588890..6115f29bbc3996ed2e87963f0b834d7e85342b6d 100644 (file)
--- a/udevinfo.8
+++ b/udevinfo.8
@@ -1,61 +1,82 @@
-.TH UDEVINFO 8 "October 2003" "" "Linux Administrator's Manual"
-.SH NAME
-udevinfo \- retrieve information from udev
-.SH SYNOPSIS
-.B udevinfo
-.RI "[-q " query_type " -p " sysfs_path "] [-drVh]"
+.\"     Title: udevinfo
+.\"    Author: 
+.\" Generator: DocBook XSL Stylesheets v1.73.1 <http://docbook.sf.net/>
+.\"      Date: August 2005
+.\"    Manual: udevinfo
+.\"    Source: udev
+.\"
+.TH "UDEVINFO" "8" "August 2005" "udev" "udevinfo"
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+udevinfo - query udev device information
+.SH "SYNOPSIS"
+.HP 9
+\fBudevinfo\fR [\fB\-\-query=\fR\fB\fIquery\-type\fR\fR] [\fB\-\-path=\fR\fB\fIdevpath\fR\fR] [\fB\-\-name=\fR\fB\fInode\fR\fR] [\fB\-\-root\fR] [\fB\-\-attribute\-walk\fR] [\fB\-\-export\-db\fR] [\fB\-\-version\fR] [\fB\-\-help\fR]
 .SH "DESCRIPTION"
-.B udevinfo
-allows users to query the udev database for information on any of the devices
-currently present in the system.  It also provides a way to query any device
-in the sysfs tree to help in creating
-.B udev
-rule files.
+.PP
+udevinfo 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\.
 .SH "OPTIONS"
-.TP
-.B -V
-Print the version information.
-.TP
-.B -r
-Print the the
-.B udev_root
-directory. When used in conjunction with a query for the node name, the
-.B udev_root
-will be prepended.
-.TP
-.BI -q " query_type"
-Query the database for specified value of a created device node.
-.RB Needs " -p " or " -n " specified.
-.br
-Valid types are:
-.BR name ", " symlink ", " mode " ," owner " , " group " or " path.
-.TP
-.BI -p " sysfs_path"
-Specify the sysfs path of the device to query.
-.TP
-.BI -n " name"
-Specify the name of the node for the device to query.
-.TP
-.B -a
-Print all
-.BI SYSFS{ filename }
-attributes along the device chain. Useful for for finding
-unique attributes to compose a rule.
-.RB Needs " -p " specified.
-.TP
-.B -d
-Dump the whole database.
-.TP
-.B -h
-Print help text.
-.SH "FILES"
-.nf
-/etc/udev/*  udev config files
-.fi
-.LP
+.PP
+\fB\-\-query=\fR\fB\fItype\fR\fR
+.RS 4
+Query the database for specified type of device data\. It needs the
+\fB\-\-path\fR
+or
+\fB\-\-name\fR
+to identify the specified device\. Valid queries are:
+\fBname\fR,
+\fBsymlink\fR,
+\fBpath\fR,
+\fBenv\fR,
+\fBall\fR\.
+.RE
+.PP
+\fB\-\-path=\fR\fB\fIdevpath\fR\fR
+.RS 4
+The devpath of the device to query\.
+.RE
+.PP
+\fB\-\-name=\fR\fB\fInode\fR\fR
+.RS 4
+The name of the device node or a symlink to query
+.RE
+.PP
+\fB\-\-root\fR
+.RS 4
+The udev root directory:
+\fI/dev\fR\. If used in conjunction with a
+\fBname\fR
+or
+\fBsymlink\fR
+query, the query returns the absolute path including the root directory\.
+.RE
+.PP
+\fB\-\-attribute\-walk\fR
+.RS 4
+Print all sysfs properties of the specified device that can be used in udev rules to match the specified device\. It prints all devices along the chain, up to the root of sysfs that can be used in udev rules\.
+.RE
+.PP
+\fB\-\-export\-db\fR
+.RS 4
+Export the content of the udev database\.
+.RE
+.PP
+\fB\-\-version\fR
+.RS 4
+Print version\.
+.RE
+.PP
+\fB\-\-help\fR
+.RS 4
+Print help text\.
+.RE
+.SH "AUTHOR"
+.PP
+Written by Kay Sievers
+<kay\.sievers@vrfy\.org>\.
 .SH "SEE ALSO"
-.BR udev (8)
-.SH AUTHORS
-.B udevinfo
-was developed primarily by Kay Sievers <kay.sievers@vrfy.org>, with help
-from others.
+.PP
+\fBudev\fR(7)