[PATCH] remove udevtest on 'make clean'

[elogind.git] / udev.8

diff --git a/udev.8 b/udev.8
index 9a597276c6fd00165c431523ca779bcb31f3733a..603ca45cbac74a9e5afb0bedd9489d056b85cbfe 100644 (file)
--- a/udev.8
+++ b/udev.8
@@ -3,9 +3,6 @@
 udev \- Linux configurable dynamic device naming support
 .SH SYNOPSIS
 .BI udev " hotplug-subsystem"
-.br
-.B udev
-.RI "[-q " query_type " -p " sysfs_path "] [-drVh]"
 .SH "DESCRIPTION"
 .B udev
 creates or removes device node files usually located in the /dev directory.
@@ -29,40 +26,6 @@ maintains a database for devices present on the system.
 On device removal,
 .B udev
 queries its database for the name of the device file to be deleted.
-.SH "OPTIONS"
-.B udev
-normally is called by
-.B hotplug
-with the subsystem as argument and various environment variables set.
-.br
-It may also called with the following 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.
-Valid types are:
-.BR name ", " symlink ", " 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 -d
-Dump the whole database.
-.TP
-.B -h
-Print help text.
 .SH "CONFIGURATION"
 All
 .B udev
@@ -94,6 +57,11 @@ This is the location of the udev rules file.  The default value for this is
 This is the location of the udev permission file.  The default value for this is
 .I /etc/udev/udev.permissions
 .TP
+.B udev_log
+If you want udev to log some information to the syslog for every node created or
+removed. The default value for this is
+.I yes
+.TP
 .B default_mode
 This is the default mode for all nodes that have no explicit match in the
 permissions file.  The default value for this is
@@ -125,6 +93,9 @@ udev_rules="/etc/udev/udev.rules"
 # udev_permissions - The name and location of the udev permission file
 udev_permissions="/etc/udev/udev.permissions"
 
+# udev_log - set to "yes" if you want logging, else "no"
+udev_log="yes"
+
 # default_mode - set the default mode for all nodes that have no
 #                explicit match in the permissions file
 default_mode="0666"
@@ -173,7 +144,7 @@ Match the device number on the bus, like PCI bus id.
 .B PLACE
 Match the topological position on bus, like physical port of USB device
 .TP
-.BI SYSFS_ filename
+.BI SYSFS{ filename }
 Match sysfs device attribute like label, vendor, USB serial number, SCSI UUID
 or file system label.  Up to 5 different sysfs files can be checked, with
 all of the values being required in order to match the rule.
@@ -191,6 +162,13 @@ call. This key may used in any following rule after a
 .B PROGRAM
 call.
 .P
+The
+.B NAME
+field given with the attribute
+.BR NAME{ all_partitions }
+will  create all 15 partitions of a blockdevice.
+This may be useful for removable media devices.
+.P
 .RB "The " NAME " ," SYMLINK " and " PROGRAM
 fields support simple printf-like string substitution:
 .TP
@@ -217,6 +195,13 @@ returned string.
 (This does not work within the
 .B PROGRAM
 field for the obvious reason.)
+.br
+A single part of the string, separated by the space character
+my be selected by specifying the part number as a attribute:
+.BI %c{ part }
+.TP
+.BI %s{ filename }
+The content of a sysfs attribute.
 .TP
 .B %%
 The '%' char itself.
@@ -228,10 +213,10 @@ The '%' char itself.
 BUS="scsi", PROGRAM="/sbin/scsi_id", RESULT="OEM 0815", NAME="disk1"
 
 # USB printer to be called lp_color
-BUS="usb", SYSFS_serial="W09090207101241330", NAME="lp_color"
+BUS="usb", SYSFS{serial}="W09090207101241330", NAME="lp_color"
 
 # SCSI disk with a specific vendor and model number is to be called boot
-BUS="scsi", SYSFS_vendor="IBM", SYSFS_model="ST336", NAME="boot%n"
+BUS="scsi", SYSFS{vendor}="IBM", SYSFS{model}="ST336", NAME="boot%n"
 
 # sound card with PCI bus id 00:0b.0 to be called dsp
 BUS="pci", ID="00:0b.0", NAME="dsp"
@@ -243,7 +228,7 @@ BUS="usb", PLACE="2.3", NAME="mouse1"
 KERNEL="ttyUSB1", NAME="pda", SYMLINK="palmtop handheld"
 
 # multiple USB webcams with symlinks to be called webcam0, webcam1, ...
-BUS="usb", SYSFS_model="XV3", NAME="video%n", SYMLINK="webcam%n"
+BUS="usb", SYSFS{model}="XV3", NAME="video%n", SYMLINK="webcam%n"
 .fi
 .P
 Permissions and ownership for the created device files may specified at
@@ -296,6 +281,7 @@ following the '[' is a '!' then any character not enclosed is matched.
 .fi
 .LP
 .SH "SEE ALSO"
+.BR udevinfo (8),
 .BR hotplug (8)
 .PP
 The