diff options
Diffstat (limited to 'udev-lfs/udevadm.8')
| -rw-r--r-- | udev-lfs/udevadm.8 | 372 |
1 files changed, 0 insertions, 372 deletions
diff --git a/udev-lfs/udevadm.8 b/udev-lfs/udevadm.8 deleted file mode 100644 index 373b65cee..000000000 --- a/udev-lfs/udevadm.8 +++ /dev/null @@ -1,372 +0,0 @@ -'\" t -.TH "UDEVADM" "8" "" "systemd 202" "udevadm" -.\" ----------------------------------------------------------------- -.\" * Define some portability stuff -.\" ----------------------------------------------------------------- -.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.\" http://bugs.debian.org/507673 -.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html -.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.ie \n(.g .ds Aq \(aq -.el .ds Aq ' -.\" ----------------------------------------------------------------- -.\" * set default formatting -.\" ----------------------------------------------------------------- -.\" disable hyphenation -.nh -.\" disable justification (adjust text to left margin only) -.ad l -.\" ----------------------------------------------------------------- -.\" * MAIN CONTENT STARTS HERE * -.\" ----------------------------------------------------------------- -.SH "NAME" -udevadm \- udev management tool -.SH "SYNOPSIS" -.HP \w'\fBudevadm\fR\ 'u -\fBudevadm\fR [\fB\-\-debug\fR] [\fB\-\-version\fR] [\fB\-\-help\fR] -.HP \w'\fBudevadm\ info\ \fR\fB\fIoptions\fR\fR\ 'u -\fBudevadm info \fR\fB\fIoptions\fR\fR -.HP \w'\fBudevadm\ trigger\ \fR\fB[options]\fR\ 'u -\fBudevadm trigger \fR\fB[options]\fR -.HP \w'\fBudevadm\ settle\ \fR\fB[options]\fR\ 'u -\fBudevadm settle \fR\fB[options]\fR -.HP \w'\fBudevadm\ control\ \fR\fB\fIcommand\fR\fR\ 'u -\fBudevadm control \fR\fB\fIcommand\fR\fR -.HP \w'\fBudevadm\ monitor\ \fR\fB[options]\fR\ 'u -\fBudevadm monitor \fR\fB[options]\fR -.HP \w'\fBudevadm\ hwdb\ \fR\fB[options]\fR\ 'u -\fBudevadm hwdb \fR\fB[options]\fR -.HP \w'\fBudevadm\ test\ \fR\fB[options]\fR\fB\ \fR\fB\fIdevpath\fR\fR\ 'u -\fBudevadm test \fR\fB[options]\fR\fB \fR\fB\fIdevpath\fR\fR -.HP \w'\fBudevadm\ test\-builtin\ \fR\fB[options]\fR\fB\ \fR\fB\fIcommand\fR\fR\fB\ \fR\fB\fIdevpath\fR\fR\ 'u -\fBudevadm test\-builtin \fR\fB[options]\fR\fB \fR\fB\fIcommand\fR\fR\fB \fR\fB\fIdevpath\fR\fR -.SH "DESCRIPTION" -.PP -udevadm expects a command and command specific options\&. It controls the runtime behavior of udev, requests kernel events, manages the event queue, and provides simple debugging mechanisms\&. -.SH "OPTIONS" -.PP -\fB\-\-debug\fR -.RS 4 -Print debug messages to stderr\&. -.RE -.PP -\fB\-\-version\fR -.RS 4 -Print version number\&. -.RE -.PP -\fB\-\-help\fR -.RS 4 -Print help text\&. -.RE -.SS "udevadm info \fIoptions\fR" -.PP -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\&. -.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, -\fBproperty\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\fIfile\fR\fR -.RS 4 -The name of the device node or a symlink to query -.RE -.PP -\fB\-\-root\fR -.RS 4 -Print absolute paths in -\fBname\fR -or -\fBsymlink\fR -query\&. -.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\fR -.RS 4 -Print output as key/value pairs\&. Values are enclosed in single quotes\&. -.RE -.PP -\fB\-\-export\-prefix=\fR\fB\fIname\fR\fR -.RS 4 -Add a prefix to the key name of exported values\&. -.RE -.PP -\fB\-\-device\-id\-of\-file=\fR\fB\fIfile\fR\fR -.RS 4 -Print major/minor numbers of the underlying device, where the file lives on\&. -.RE -.PP -\fB\-\-export\-db\fR -.RS 4 -Export the content of the udev database\&. -.RE -.PP -\fB\-\-cleanup\-db\fR -.RS 4 -Cleanup the udev database\&. -.RE -.PP -\fB\-\-version\fR -.RS 4 -Print version\&. -.RE -.PP -\fB\-\-help\fR -.RS 4 -Print help text\&. -.RE -.SS "udevadm trigger [options]" -.PP -Request device events from the kernel\&. Primarily used to replay events at system coldplug time\&. -.PP -\fB\-\-verbose\fR -.RS 4 -Print the list of devices which will be triggered\&. -.RE -.PP -\fB\-\-dry\-run\fR -.RS 4 -Do not actually trigger the event\&. -.RE -.PP -\fB\-\-type=\fR\fB\fItype\fR\fR -.RS 4 -Trigger a specific type of devices\&. Valid types are: -\fBdevices\fR, -\fBsubsystems\fR\&. The default value is -\fBdevices\fR\&. -.RE -.PP -\fB\-\-action=\fR\fB\fIaction\fR\fR -.RS 4 -Type of event to be triggered\&. The default value is -\fBchange\fR\&. -.RE -.PP -\fB\-\-subsystem\-match=\fR\fB\fIsubsystem\fR\fR -.RS 4 -Trigger events for devices which belong to a matching subsystem\&. This option can be specified multiple times and supports shell style pattern matching\&. -.RE -.PP -\fB\-\-subsystem\-nomatch=\fR\fB\fIsubsystem\fR\fR -.RS 4 -Do not trigger events for devices which belong to a matching subsystem\&. This option can be specified multiple times and supports shell style pattern matching\&. -.RE -.PP -\fB\-\-attr\-match=\fR\fB\fIattribute\fR\fR\fB=\fR\fB\fIvalue\fR\fR -.RS 4 -Trigger events for devices with a matching sysfs attribute\&. If a value is specified along with the attribute name, the content of the attribute is matched against the given value using shell style pattern matching\&. If no value is specified, the existence of the sysfs attribute is checked\&. This option can be specified multiple times\&. -.RE -.PP -\fB\-\-attr\-nomatch=\fR\fB\fIattribute\fR\fR\fB=\fR\fB\fIvalue\fR\fR -.RS 4 -Do not trigger events for devices with a matching sysfs attribute\&. If a value is specified along with the attribute name, the content of the attribute is matched against the given value using shell style pattern matching\&. If no value is specified, the existence of the sysfs attribute is checked\&. This option can be specified multiple times\&. -.RE -.PP -\fB\-\-property\-match=\fR\fB\fIproperty\fR\fR\fB=\fR\fB\fIvalue\fR\fR -.RS 4 -Trigger events for devices with a matching property value\&. This option can be specified multiple times and supports shell style pattern matching\&. -.RE -.PP -\fB\-\-tag\-match=\fR\fB\fIproperty\fR\fR -.RS 4 -Trigger events for devices with a matching tag\&. This option can be specified multiple times\&. -.RE -.PP -\fB\-\-sysname\-match=\fR\fB\fIname\fR\fR -.RS 4 -Trigger events for devices with a matching sys device name\&. This option can be specified multiple times and supports shell style pattern matching\&. -.RE -.PP -\fB\-\-parent\-match=\fR\fB\fIsyspath\fR\fR -.RS 4 -Trigger events for all children of a given device\&. -.RE -.SS "udevadm settle [options]" -.PP -Watches the udev event queue, and exits if all current events are handled\&. -.PP -\fB\-\-timeout=\fR\fB\fIseconds\fR\fR -.RS 4 -Maximum number of seconds to wait for the event queue to become empty\&. The default value is 120 seconds\&. A value of 0 will check if the queue is empty and always return immediately\&. -.RE -.PP -\fB\-\-seq\-start=\fR\fB\fIseqnum\fR\fR -.RS 4 -Wait only for events after the given sequence number\&. -.RE -.PP -\fB\-\-seq\-end=\fR\fB\fIseqnum\fR\fR -.RS 4 -Wait only for events before the given sequence number\&. -.RE -.PP -\fB\-\-exit\-if\-exists=\fR\fB\fIfile\fR\fR -.RS 4 -Stop waiting if file exists\&. -.RE -.PP -\fB\-\-quiet\fR -.RS 4 -Do not print any output, like the remaining queue entries when reaching the timeout\&. -.RE -.PP -\fB\-\-help\fR -.RS 4 -Print help text\&. -.RE -.SS "udevadm control \fIcommand\fR" -.PP -Modify the internal state of the running udev daemon\&. -.PP -\fB\-\-exit\fR -.RS 4 -Signal and wait for udevd to exit\&. -.RE -.PP -\fB\-\-log\-priority=\fR\fB\fIvalue\fR\fR -.RS 4 -Set the internal log level of udevd\&. Valid values are the numerical syslog priorities or their textual representations: -\fBerr\fR, -\fBinfo\fR -and -\fBdebug\fR\&. -.RE -.PP -\fB\-\-stop\-exec\-queue\fR -.RS 4 -Signal udevd to stop executing new events\&. Incoming events will be queued\&. -.RE -.PP -\fB\-\-start\-exec\-queue\fR -.RS 4 -Signal udevd to enable the execution of events\&. -.RE -.PP -\fB\-\-reload\fR -.RS 4 -Signal udevd to reload the rules files and other databases like the kernel module index\&. Reloading rules and databases does not apply any changes to already existing devices; the new configuration will only be applied to new events\&. -.RE -.PP -\fB\-\-property=\fR\fB\fIKEY\fR\fR\fB=\fR\fB\fIvalue\fR\fR -.RS 4 -Set a global property for all events\&. -.RE -.PP -\fB\-\-children\-max=\fR\fIvalue\fR -.RS 4 -Set the maximum number of events, udevd will handle at the same time\&. -.RE -.PP -\fB\-\-timeout=\fR\fIseconds\fR -.RS 4 -The maximum number of seconds to wait for a reply from udevd\&. -.RE -.PP -\fB\-\-help\fR -.RS 4 -Print help text\&. -.RE -.SS "udevadm monitor [options]" -.PP -Listens to the kernel uevents and events sent out by a udev rule and prints the devpath of the event to the console\&. It can be used to analyze the event timing, by comparing the timestamps of the kernel uevent and the udev event\&. -.PP -\fB\-\-kernel\fR -.RS 4 -Print the kernel uevents\&. -.RE -.PP -\fB\-\-udev\fR -.RS 4 -Print the udev event after the rule processing\&. -.RE -.PP -\fB\-\-property\fR -.RS 4 -Also print the properties of the event\&. -.RE -.PP -\fB\-\-subsystem\-match=\fR\fB\fIstring[/string]\fR\fR -.RS 4 -Filter events by subsystem[/devtype]\&. Only udev events with a matching subsystem value will pass\&. -.RE -.PP -\fB\-\-tag\-match=\fR\fB\fIstring\fR\fR -.RS 4 -Filter events by property\&. Only udev events with a given tag attached will pass\&. -.RE -.PP -\fB\-\-help\fR -.RS 4 -Print help text\&. -.RE -.SS "udevadm hwdb [options]" -.PP -Maintain the hardware database index in -/etc/udev/hwdb\&.bin\&. -.PP -\fB\-\-update\fR -.RS 4 -Compile the hardware database information located in /usr/lib/udev/hwdb\&.d/, /etc/udev/hwdb\&.d/ and store it in -/etc/udev/hwdb\&.bin\&. This should be done after any update to the source files; it will not be called automatically\&. The running udev daemon will detect a new database on its own and does not need to be notified about it\&. -.RE -.PP -\fB\-\-test=\fR\fB\fIstring\fR\fR -.RS 4 -Query the database with a modalias string, and print the retrieved properties\&. -.RE -.PP -\fB\-\-root=\fR\fB\fIstring\fR\fR -.RS 4 -Alternative root path in the filesystem for reading and writing files\&. -.RE -.SS "udevadm test [options] \fIdevpath\fR" -.PP -Simulate a udev event run for the given device, and print debug output\&. -.PP -\fB\-\-action=\fR\fB\fIstring\fR\fR -.RS 4 -The action string\&. -.RE -.PP -\fB\-\-subsystem=\fR\fB\fIstring\fR\fR -.RS 4 -The subsystem string\&. -.RE -.PP -\fB\-\-help\fR -.RS 4 -Print help text\&. -.RE -.SS "udevadm test\-builtin [options] \fIcommand\fR \fIdevpath\fR" -.PP -Run a built\-in command for the given device, and print debug output\&. -.PP -\fB\-\-help\fR -.RS 4 -Print help text\&. -.RE -.SH "SEE ALSO" -.PP -\fBudev\fR(7) -\fBudevd.service\fR(8) |