1UDEVADM(8) udevadm UDEVADM(8)
2
6 udevadm - udev management tool
7
9 udevadm [--debug] [--version] [--help]
10 udevadm info options
12 udevadm trigger [options]
14 udevadm settle [options]
16 udevadm control command
18 udevadm monitor [options]
20 udevadm test [options] devpath
22
24 udevadm expects a command and command specific options. It controls the
25 runtime behavior of udev, requests kernel events, manages the event
26 queue, and provides simple debugging mechanisms.
27
29 --debug
30 Print debug messages to stderr.
31 --version
33 Print version number.
34 --help
36 Print help text.
37 udevadm info options
39 Queries the udev database for device information stored in the udev
40 database. It can also query the properties of a device from its sysfs
41 representation to help creating udev rules that match this device.
42 --query=type
44 Query the database for specified type of device data. It needs the
45 --path or --name to identify the specified device. Valid queries
46 are: name, symlink, path, property, all.
47 --path=devpath
49 The devpath of the device to query.
50 --name=file
52 The name of the device node or a symlink to query
53 --root
55 The udev root directory: /dev. If used in conjunction with a name
56 or symlink query, the query returns the absolute path including the
57 root directory.
58 --attribute-walk
60 Print all sysfs properties of the specified device that can be used
61 in udev rules to match the specified device. It prints all devices
62 along the chain, up to the root of sysfs that can be used in udev
63 rules.
64 --device-id-of-file=file
66 Print major/minor numbers of the underlying device, where the file
67 lives on.
68 --export-db
70 Export the content of the udev database.
71 --version
73 Print version.
74 --help
76 Print help text.
77 udevadm trigger [options]
79 Request device events from the kernel. Usually used to replay events at
80 system coldplug time.
81 --verbose
83 Print the list of devices which will be triggered.
84 --dry-run
86 Do not actually trigger the event.
87 --type=type
89 Trigger a specific type of devices. Valid types are: devices,
90 subsystems, failed. The default value is devices.
91 --action=action
93 Type of event to be triggered. The default value is add.
94 --subsystem-match=subsystem
96 Trigger events for devices which belong to a matching subsystem.
97 This option can be specified multiple times and supports shell
98 style pattern matching.
99 --subsystem-nomatch=subsystem
101 Do not trigger events for devices which belong to a matching
102 subsystem. This option can be specified multiple times and supports
103 shell style pattern matching.
104 --attr-match=attribute=value
106 Trigger events for devices with a matching sysfs attribute. If a
107 value is specified along with the attribute name, the content of
108 the attribute is matched against the given value using shell style
109 pattern matching. If no value is specified, the existence of the
110 sysfs attribute is checked. This option can be specified multiple
111 times.
112 --attr-nomatch=attribute=value
114 Do not trigger events for devices with a matching sysfs attribute.
115 If a value is specified along with the attribute name, the content
116 of the attribute is matched against the given value using shell
117 style pattern matching. If no value is specified, the existence of
118 the sysfs attribute is checked. This option can be specified
119 multiple times.
120 --property-match=property=value
122 Trigger events for devices with a matching property value. This
123 option can be specified multiple times and supports shell style
124 pattern matching.
125 --sysname-match=name
127 Trigger events for devices with a matching sys device name. This
128 option can be specified multiple times and supports shell style
129 pattern matching.
130 udevadm settle [options]
132 Watches the udev event queue, and exits if all current events are
133 handled.
134 --timeout=seconds
136 Maximum number of seconds to wait for the event queue to become
137 empty. The default value is 180 seconds. A value of 0 will check if
138 the queue is empty and always return immediately.
139 --seq-start=seqnum
141 Wait only for events after the given sequence number.
142 --seq-end=seqnum
144 Wait only for events before the given sequence number.
145 --exit-if-exists=file
147 Stop waiting if file exists.
148 --quiet
150 Do not print any output, like the remaining queue entries when
151 reaching the timeout.
152 --help
154 Print help text.
155 udevadm control command
157 Modify the internal state of the running udev daemon.
158 --log-priority=value
160 Set the internal log level of udevd. Valid values are the numerical
161 syslog priorities or their textual representations: err, info and
162 debug.
163 --stop-exec-queue
165 Signal udevd to stop executing new events. Incoming events will be
166 queued.
167 --start-exec-queue
169 Signal udevd to enable the execution of events.
170 --reload-rules
172 Signal udevd to reload the rules files. The udev daemon detects
173 changes automatically, this option is usually not needed. Reloading
174 rules does not apply any changes to already existing devices.
175 --property=KEY=value
177 Set a global property for all events.
178 --max-childs=value
180 Set the maximum number of events, udevd will handle at the same
181 time.
182 --help
184 Print help text.
185 udevadm monitor [options]
187 Listens to the kernel uevents and events sent out by a udev rule and
188 prints the devpath of the event to the console. It can be used to
189 analyze the event timing, by comparing the timestamps of the kernel
190 uevent and the udev event.
191 --kernel
193 Print the kernel uevents.
194 --udev
196 Print the udev event after the rule processing.
197 --property
199 Also print the properties of the event.
200 --help
202 Print help text.
203 udevadm test [options] devpath
205 Simulate a udev event run for the given device, and print debug output.
206 --action=string
208 The action string.
209 --subsystem=string
211 The subsystem string.
212 --help
214 Print help text.
215
217 Written by Kay Sievers kay.sievers@vrfy.org.
218
220 udev(7) udevd(8)
221udev 11/10/2009 UDEVADM(8)