]>
Commit | Line | Data |
---|---|---|
225cb03b | 1 | <?xml version='1.0'?> |
63749b1a KS |
2 | <?xml-stylesheet type="text/xsl" href="http://docbook.sourceforge.net/release/xsl/current/xhtml/docbook.xsl"?> |
3 | <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" | |
225cb03b KS |
4 | "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"> |
5 | ||
63749b1a KS |
6 | <refentry id="udevadm"> |
7 | <refentryinfo> | |
225cb03b | 8 | <title>udevadm</title> |
d3a2386d KS |
9 | <productname>systemd</productname> |
10 | <authorgroup> | |
11 | <author> | |
12 | <contrib>Developer</contrib> | |
13 | <firstname>Kay</firstname> | |
14 | <surname>Sievers</surname> | |
15 | <email>kay@vrfy.org</email> | |
16 | </author> | |
17 | </authorgroup> | |
63749b1a | 18 | </refentryinfo> |
225cb03b | 19 | |
63749b1a KS |
20 | <refmeta> |
21 | <refentrytitle>udevadm</refentrytitle> | |
22 | <manvolnum>8</manvolnum> | |
23 | <refmiscinfo class="version"></refmiscinfo> | |
24 | </refmeta> | |
225cb03b | 25 | |
63749b1a KS |
26 | <refnamediv> |
27 | <refname>udevadm</refname><refpurpose>udev management tool</refpurpose> | |
28 | </refnamediv> | |
225cb03b | 29 | |
63749b1a KS |
30 | <refsynopsisdiv> |
31 | <cmdsynopsis> | |
32 | <command>udevadm</command> | |
33 | <arg><option>--debug</option></arg> | |
34 | <arg><option>--version</option></arg> | |
35 | <arg><option>--help</option></arg> | |
36 | </cmdsynopsis> | |
37 | <cmdsynopsis> | |
38 | <command>udevadm info <replaceable>options</replaceable></command> | |
39 | </cmdsynopsis> | |
40 | <cmdsynopsis> | |
41 | <command>udevadm trigger <optional>options</optional></command> | |
42 | </cmdsynopsis> | |
43 | <cmdsynopsis> | |
44 | <command>udevadm settle <optional>options</optional></command> | |
45 | </cmdsynopsis> | |
46 | <cmdsynopsis> | |
47 | <command>udevadm control <replaceable>command</replaceable></command> | |
48 | </cmdsynopsis> | |
49 | <cmdsynopsis> | |
50 | <command>udevadm monitor <optional>options</optional></command> | |
51 | </cmdsynopsis> | |
1ada30ac KS |
52 | <cmdsynopsis> |
53 | <command>udevadm hwdb <optional>options</optional></command> | |
54 | </cmdsynopsis> | |
63749b1a KS |
55 | <cmdsynopsis> |
56 | <command>udevadm test <optional>options</optional> <replaceable>devpath</replaceable></command> | |
57 | </cmdsynopsis> | |
d7867b31 KS |
58 | <cmdsynopsis> |
59 | <command>udevadm test-builtin <optional>options</optional> <replaceable>command</replaceable> <replaceable>devpath</replaceable></command> | |
60 | </cmdsynopsis> | |
63749b1a | 61 | </refsynopsisdiv> |
225cb03b | 62 | |
63749b1a | 63 | <refsect1><title>Description</title> |
124b48b0 ZJS |
64 | <para><command>udevadm</command> expects a command and command |
65 | specific options. It controls the runtime behavior of | |
66 | <command>systemd-udevd</command>, requests kernel events, manages | |
67 | the event queue, and provides simple debugging mechanisms.</para> | |
63749b1a | 68 | </refsect1> |
225cb03b | 69 | |
63749b1a KS |
70 | <refsect1><title>OPTIONS</title> |
71 | <variablelist> | |
72 | <varlistentry> | |
73 | <term><option>--debug</option></term> | |
74 | <listitem> | |
6db27428 | 75 | <para>Print debug messages to standard error.</para> |
63749b1a KS |
76 | </listitem> |
77 | </varlistentry> | |
78 | <varlistentry> | |
79 | <term><option>--version</option></term> | |
80 | <listitem> | |
81 | <para>Print version number.</para> | |
82 | </listitem> | |
83 | </varlistentry> | |
84 | <varlistentry> | |
7643ac9a | 85 | <term><option>-h</option></term> |
63749b1a KS |
86 | <term><option>--help</option></term> |
87 | <listitem> | |
88 | <para>Print help text.</para> | |
89 | </listitem> | |
90 | </varlistentry> | |
91 | </variablelist> | |
225cb03b | 92 | |
7643ac9a | 93 | <refsect2><title>udevadm info <optional><replaceable>OPTIONS</replaceable></optional> <optional><replaceable>DEVPATH</replaceable>|<replaceable>FILE</replaceable></optional></title> |
63749b1a KS |
94 | <para>Queries the udev database for device information |
95 | stored in the udev database. It can also query the properties | |
96 | of a device from its sysfs representation to help creating udev | |
97 | rules that match this device.</para> | |
98 | <variablelist> | |
99 | <varlistentry> | |
7643ac9a ZJS |
100 | <term><option>-q</option></term> |
101 | <term><option>--query=<replaceable>TYPE</replaceable></option></term> | |
63749b1a | 102 | <listitem> |
72f4d966 | 103 | <para>Query the database for the specified type of device |
124b48b0 | 104 | data. It needs the <option>--path</option> or |
7643ac9a ZJS |
105 | <option>--name</option> to identify the specified device. |
106 | Valid <replaceable>TYPE</replaceable>s are: | |
107 | <constant>name</constant>, <constant>symlink</constant>, | |
108 | <constant>path</constant>, <constant>property</constant>, | |
124b48b0 | 109 | <constant>all</constant>.</para> |
63749b1a KS |
110 | </listitem> |
111 | </varlistentry> | |
112 | <varlistentry> | |
7643ac9a ZJS |
113 | <term><option>-p</option></term> |
114 | <term><option>--path=<replaceable>DEVPATH</replaceable></option></term> | |
63749b1a | 115 | <listitem> |
124b48b0 ZJS |
116 | <para>The <filename>/sys</filename> path of the device to |
117 | query, e.g. | |
118 | <filename><optional>/sys</optional>/class/block/sda</filename>. | |
72f4d966 | 119 | Note that this option usually is not very useful, since |
124b48b0 ZJS |
120 | <command>udev</command> can guess the type of the |
121 | argument, so <command>udevadm | |
122 | --devpath=/class/block/sda</command> is equivalent to | |
123 | <command>udevadm /sys/class/block/sda</command>.</para> | |
63749b1a KS |
124 | </listitem> |
125 | </varlistentry> | |
126 | <varlistentry> | |
7643ac9a ZJS |
127 | <term><option>-n</option></term> |
128 | <term><option>--name=<replaceable>FILE</replaceable></option></term> | |
63749b1a | 129 | <listitem> |
124b48b0 ZJS |
130 | <para>The name of the device node or a symlink to query, |
131 | e.g. <filename><optional>/dev</optional>/sda</filename>. | |
72f4d966 | 132 | Note that this option usually is not very useful, since |
124b48b0 ZJS |
133 | <command>udev</command> can guess the type of the |
134 | argument, so <command>udevadm --name=sda</command> is | |
135 | equivalent to <command>udevadm /dev/sda</command>.</para> | |
63749b1a KS |
136 | </listitem> |
137 | </varlistentry> | |
138 | <varlistentry> | |
7643ac9a | 139 | <term><option>-r</option></term> |
63749b1a KS |
140 | <term><option>--root</option></term> |
141 | <listitem> | |
4f5d327a KS |
142 | <para>Print absolute paths in <command>name</command> or <command>symlink</command> |
143 | query.</para> | |
4ec9c3e7 KS |
144 | </listitem> |
145 | </varlistentry> | |
63749b1a | 146 | <varlistentry> |
7643ac9a | 147 | <term><option>-a</option></term> |
63749b1a KS |
148 | <term><option>--attribute-walk</option></term> |
149 | <listitem> | |
150 | <para>Print all sysfs properties of the specified device that can be used | |
151 | in udev rules to match the specified device. It prints all devices | |
152 | along the chain, up to the root of sysfs that can be used in udev rules.</para> | |
153 | </listitem> | |
154 | </varlistentry> | |
dc1791a9 | 155 | <varlistentry> |
7643ac9a | 156 | <term><option>-x</option></term> |
dc1791a9 KS |
157 | <term><option>--export</option></term> |
158 | <listitem> | |
159 | <para>Print output as key/value pairs. Values are enclosed in single quotes.</para> | |
160 | </listitem> | |
161 | </varlistentry> | |
162 | <varlistentry> | |
7643ac9a ZJS |
163 | <term><option>-P</option></term> |
164 | <term><option>--export-prefix=<replaceable>NAME</replaceable></option></term> | |
dc1791a9 KS |
165 | <listitem> |
166 | <para>Add a prefix to the key name of exported values.</para> | |
167 | </listitem> | |
168 | </varlistentry> | |
63749b1a | 169 | <varlistentry> |
7643ac9a ZJS |
170 | <term><option>-d</option></term> |
171 | <term><option>--device-id-of-file=<replaceable>FILE</replaceable></option></term> | |
63749b1a KS |
172 | <listitem> |
173 | <para>Print major/minor numbers of the underlying device, where the file | |
174 | lives on.</para> | |
175 | </listitem> | |
176 | </varlistentry> | |
177 | <varlistentry> | |
7643ac9a | 178 | <term><option>-e</option></term> |
63749b1a KS |
179 | <term><option>--export-db</option></term> |
180 | <listitem> | |
181 | <para>Export the content of the udev database.</para> | |
182 | </listitem> | |
183 | </varlistentry> | |
9ead6627 | 184 | <varlistentry> |
7643ac9a | 185 | <term><option>-c</option></term> |
9ead6627 KS |
186 | <term><option>--cleanup-db</option></term> |
187 | <listitem> | |
188 | <para>Cleanup the udev database.</para> | |
189 | </listitem> | |
190 | </varlistentry> | |
63749b1a KS |
191 | <varlistentry> |
192 | <term><option>--version</option></term> | |
193 | <listitem> | |
194 | <para>Print version.</para> | |
195 | </listitem> | |
196 | </varlistentry> | |
197 | <varlistentry> | |
7643ac9a | 198 | <term><option>-h</option></term> |
63749b1a KS |
199 | <term><option>--help</option></term> |
200 | <listitem> | |
201 | <para>Print help text.</para> | |
202 | </listitem> | |
203 | </varlistentry> | |
204 | </variablelist> | |
205 | </refsect2> | |
225cb03b | 206 | |
63749b1a KS |
207 | <refsect2><title>udevadm trigger <optional>options</optional></title> |
208 | <para>Request device events from the kernel. Primarily used to replay events at system coldplug time.</para> | |
209 | <variablelist> | |
210 | <varlistentry> | |
7643ac9a | 211 | <term><option>-v</option></term> |
63749b1a KS |
212 | <term><option>--verbose</option></term> |
213 | <listitem> | |
214 | <para>Print the list of devices which will be triggered.</para> | |
215 | </listitem> | |
216 | </varlistentry> | |
217 | <varlistentry> | |
7643ac9a | 218 | <term><option>-n</option></term> |
63749b1a KS |
219 | <term><option>--dry-run</option></term> |
220 | <listitem> | |
221 | <para>Do not actually trigger the event.</para> | |
222 | </listitem> | |
223 | </varlistentry> | |
224 | <varlistentry> | |
7643ac9a ZJS |
225 | <term><option>-t</option></term> |
226 | <term><option>--type=<replaceable>TYPE</replaceable></option></term> | |
63749b1a KS |
227 | <listitem> |
228 | <para>Trigger a specific type of devices. Valid types are: | |
864fde8a | 229 | <command>devices</command>, <command>subsystems</command>. |
63749b1a KS |
230 | The default value is <command>devices</command>.</para> |
231 | </listitem> | |
232 | </varlistentry> | |
233 | <varlistentry> | |
7643ac9a ZJS |
234 | <term><option>-c</option></term> |
235 | <term><option>--action=<replaceable>ACTION</replaceable></option></term> | |
63749b1a | 236 | <listitem> |
7643ac9a ZJS |
237 | <para>Type of event to be triggered. The default value is |
238 | <command>change</command>.</para> | |
63749b1a KS |
239 | </listitem> |
240 | </varlistentry> | |
241 | <varlistentry> | |
7643ac9a ZJS |
242 | <term><option>-s</option></term> |
243 | <term><option>--subsystem-match=<replaceable>SUBSYSTEM</replaceable></option></term> | |
63749b1a | 244 | <listitem> |
7643ac9a ZJS |
245 | <para>Trigger events for devices which belong to a |
246 | matching subsystem. This option can be specified multiple | |
247 | times and supports shell style pattern matching.</para> | |
63749b1a KS |
248 | </listitem> |
249 | </varlistentry> | |
250 | <varlistentry> | |
7643ac9a ZJS |
251 | <term><option>-S</option></term> |
252 | <term><option>--subsystem-nomatch=<replaceable>SUBSYSTEM</replaceable></option></term> | |
63749b1a KS |
253 | <listitem> |
254 | <para>Do not trigger events for devices which belong to a matching subsystem. This option | |
255 | can be specified multiple times and supports shell style pattern matching.</para> | |
256 | </listitem> | |
257 | </varlistentry> | |
258 | <varlistentry> | |
7643ac9a ZJS |
259 | <term><option>-a</option></term> |
260 | <term><option>--attr-match=<replaceable>ATTRIBUTE</replaceable>=<replaceable>VALUE</replaceable></option></term> | |
63749b1a | 261 | <listitem> |
7643ac9a ZJS |
262 | <para>Trigger events for devices with a matching sysfs |
263 | attribute. If a value is specified along with the | |
264 | attribute name, the content of the attribute is matched | |
265 | against the given value using shell style pattern | |
266 | matching. If no value is specified, the existence of the | |
267 | sysfs attribute is checked. This option can be specified | |
268 | multiple times.</para> | |
63749b1a KS |
269 | </listitem> |
270 | </varlistentry> | |
271 | <varlistentry> | |
7643ac9a ZJS |
272 | <term><option>-A</option></term> |
273 | <term><option>--attr-nomatch=<replaceable>ATTRIBUTE</replaceable>=<replaceable>VALUE</replaceable></option></term> | |
63749b1a | 274 | <listitem> |
7643ac9a ZJS |
275 | <para>Do not trigger events for devices with a matching |
276 | sysfs attribute. If a value is specified along with the | |
277 | attribute name, the content of the attribute is matched | |
278 | against the given value using shell style pattern | |
279 | matching. If no value is specified, the existence of the | |
280 | sysfs attribute is checked. This option can be specified | |
281 | multiple times.</para> | |
63749b1a KS |
282 | </listitem> |
283 | </varlistentry> | |
284 | <varlistentry> | |
7643ac9a ZJS |
285 | <term><option>-p</option></term> |
286 | <term><option>--property-match=<replaceable>PROPERTY</replaceable>=<replaceable>VALUE</replaceable></option></term> | |
63749b1a | 287 | <listitem> |
7643ac9a ZJS |
288 | <para>Trigger events for devices with a matching property |
289 | value. This option can be specified multiple times and | |
290 | supports shell style pattern matching.</para> | |
63749b1a KS |
291 | </listitem> |
292 | </varlistentry> | |
293 | <varlistentry> | |
7643ac9a ZJS |
294 | <term><option>-g</option></term> |
295 | <term><option>--tag-match=<replaceable>PROPERTY</replaceable></option></term> | |
63749b1a | 296 | <listitem> |
7643ac9a ZJS |
297 | <para>Trigger events for devices with a matching tag. This |
298 | option can be specified multiple times.</para> | |
63749b1a KS |
299 | </listitem> |
300 | </varlistentry> | |
301 | <varlistentry> | |
7643ac9a ZJS |
302 | <term><option>-y</option></term> |
303 | <term><option>--sysname-match=<replaceable>NAME</replaceable></option></term> | |
63749b1a | 304 | <listitem> |
7643ac9a ZJS |
305 | <para>Trigger events for devices with a matching sys |
306 | device name. This option can be specified multiple times | |
307 | and supports shell style pattern matching.</para> | |
63749b1a KS |
308 | </listitem> |
309 | </varlistentry> | |
b05211fa | 310 | <varlistentry> |
7643ac9a ZJS |
311 | <term><option>-b</option></term> |
312 | <term><option>--parent-match=<replaceable>SYSPATH</replaceable></option></term> | |
b05211fa | 313 | <listitem> |
7643ac9a ZJS |
314 | <para>Trigger events for all children of a given |
315 | device.</para> | |
316 | </listitem> | |
317 | </varlistentry> | |
318 | <varlistentry> | |
319 | <term><option>-h</option></term> | |
320 | <term><option>--help</option></term> | |
321 | <listitem> | |
322 | <para>Print help text.</para> | |
b05211fa KS |
323 | </listitem> |
324 | </varlistentry> | |
63749b1a KS |
325 | </variablelist> |
326 | </refsect2> | |
225cb03b | 327 | |
63749b1a KS |
328 | <refsect2><title>udevadm settle <optional>options</optional></title> |
329 | <para>Watches the udev event queue, and exits if all current events are handled.</para> | |
330 | <variablelist> | |
331 | <varlistentry> | |
7643ac9a ZJS |
332 | <term><option>-t</option></term> |
333 | <term><option>--timeout=<replaceable>SECONDS</replaceable></option></term> | |
63749b1a | 334 | <listitem> |
7643ac9a ZJS |
335 | <para>Maximum number of seconds to wait for the event |
336 | queue to become empty. The default value is 120 seconds. A | |
337 | value of 0 will check if the queue is empty and always | |
338 | return immediately.</para> | |
63749b1a KS |
339 | </listitem> |
340 | </varlistentry> | |
341 | <varlistentry> | |
7643ac9a ZJS |
342 | <term><option>-s</option></term> |
343 | <term><option>--seq-start=<replaceable>SEQNUM</replaceable></option></term> | |
63749b1a | 344 | <listitem> |
7643ac9a ZJS |
345 | <para>Wait only for events after the given sequence |
346 | number.</para> | |
63749b1a KS |
347 | </listitem> |
348 | </varlistentry> | |
349 | <varlistentry> | |
7643ac9a ZJS |
350 | <term><option>-e</option></term> |
351 | <term><option>--seq-end=<replaceable>SEQNUM</replaceable></option></term> | |
63749b1a KS |
352 | <listitem> |
353 | <para>Wait only for events before the given sequence number.</para> | |
354 | </listitem> | |
355 | </varlistentry> | |
356 | <varlistentry> | |
7643ac9a ZJS |
357 | <term><option>-E</option></term> |
358 | <term><option>--exit-if-exists=<replaceable>FILE</replaceable></option></term> | |
63749b1a KS |
359 | <listitem> |
360 | <para>Stop waiting if file exists.</para> | |
361 | </listitem> | |
362 | </varlistentry> | |
363 | <varlistentry> | |
7643ac9a | 364 | <term><option>-q</option></term> |
63749b1a KS |
365 | <term><option>--quiet</option></term> |
366 | <listitem> | |
367 | <para>Do not print any output, like the remaining queue entries when reaching the timeout.</para> | |
368 | </listitem> | |
369 | </varlistentry> | |
370 | <varlistentry> | |
7643ac9a | 371 | <term><option>-h</option></term> |
63749b1a KS |
372 | <term><option>--help</option></term> |
373 | <listitem> | |
374 | <para>Print help text.</para> | |
375 | </listitem> | |
376 | </varlistentry> | |
377 | </variablelist> | |
378 | </refsect2> | |
225cb03b | 379 | |
63749b1a KS |
380 | <refsect2><title>udevadm control <replaceable>command</replaceable></title> |
381 | <para>Modify the internal state of the running udev daemon.</para> | |
382 | <variablelist> | |
ff2c503d | 383 | <varlistentry> |
7643ac9a | 384 | <term><option>-x</option></term> |
ff2c503d KS |
385 | <term><option>--exit</option></term> |
386 | <listitem> | |
f13b388f | 387 | <para>Signal and wait for systemd-udevd to exit.</para> |
ff2c503d KS |
388 | </listitem> |
389 | </varlistentry> | |
63749b1a | 390 | <varlistentry> |
7643ac9a | 391 | <term><option>-l</option></term> |
63749b1a KS |
392 | <term><option>--log-priority=<replaceable>value</replaceable></option></term> |
393 | <listitem> | |
f13b388f | 394 | <para>Set the internal log level of systemd-udevd. Valid values are the numerical |
63749b1a KS |
395 | syslog priorities or their textual representations: <option>err</option>, |
396 | <option>info</option> and <option>debug</option>.</para> | |
397 | </listitem> | |
398 | </varlistentry> | |
399 | <varlistentry> | |
7643ac9a | 400 | <term><option>-s</option></term> |
63749b1a KS |
401 | <term><option>--stop-exec-queue</option></term> |
402 | <listitem> | |
f13b388f | 403 | <para>Signal systemd-udevd to stop executing new events. Incoming events |
63749b1a KS |
404 | will be queued.</para> |
405 | </listitem> | |
406 | </varlistentry> | |
407 | <varlistentry> | |
7643ac9a | 408 | <term><option>-S</option></term> |
63749b1a KS |
409 | <term><option>--start-exec-queue</option></term> |
410 | <listitem> | |
f13b388f | 411 | <para>Signal systemd-udevd to enable the execution of events.</para> |
63749b1a KS |
412 | </listitem> |
413 | </varlistentry> | |
414 | <varlistentry> | |
7643ac9a | 415 | <term><option>-R</option></term> |
7c85d636 | 416 | <term><option>--reload</option></term> |
63749b1a | 417 | <listitem> |
f13b388f | 418 | <para>Signal systemd-udevd to reload the rules files and other databases like the kernel |
7c85d636 KS |
419 | module index. Reloading rules and databases does not apply any changes to already |
420 | existing devices; the new configuration will only be applied to new events.</para> | |
63749b1a KS |
421 | </listitem> |
422 | </varlistentry> | |
423 | <varlistentry> | |
7643ac9a | 424 | <term><option>-p</option></term> |
63749b1a KS |
425 | <term><option>--property=<replaceable>KEY</replaceable>=<replaceable>value</replaceable></option></term> |
426 | <listitem> | |
427 | <para>Set a global property for all events.</para> | |
428 | </listitem> | |
429 | </varlistentry> | |
430 | <varlistentry> | |
7643ac9a | 431 | <term><option>-m</option></term> |
87d55ff6 | 432 | <term><option>--children-max=</option><replaceable>value</replaceable></term> |
63749b1a | 433 | <listitem> |
f13b388f | 434 | <para>Set the maximum number of events, systemd-udevd will handle at the |
63749b1a KS |
435 | same time.</para> |
436 | </listitem> | |
437 | </varlistentry> | |
ff2c503d KS |
438 | <varlistentry> |
439 | <term><option>--timeout=</option><replaceable>seconds</replaceable></term> | |
440 | <listitem> | |
7e505069 | 441 | <para>The maximum number of seconds to wait for a reply from systemd-udevd.</para> |
ff2c503d KS |
442 | </listitem> |
443 | </varlistentry> | |
63749b1a | 444 | <varlistentry> |
7643ac9a | 445 | <term><option>-h</option></term> |
63749b1a KS |
446 | <term><option>--help</option></term> |
447 | <listitem> | |
448 | <para>Print help text.</para> | |
449 | </listitem> | |
450 | </varlistentry> | |
451 | </variablelist> | |
452 | </refsect2> | |
225cb03b | 453 | |
63749b1a KS |
454 | <refsect2><title>udevadm monitor <optional>options</optional></title> |
455 | <para>Listens to the kernel uevents and events sent out by a udev rule | |
456 | and prints the devpath of the event to the console. It can be used to analyze the | |
457 | event timing, by comparing the timestamps of the kernel uevent and the udev event. | |
458 | </para> | |
459 | <variablelist> | |
460 | <varlistentry> | |
7643ac9a | 461 | <term><option>-k</option></term> |
63749b1a KS |
462 | <term><option>--kernel</option></term> |
463 | <listitem> | |
464 | <para>Print the kernel uevents.</para> | |
465 | </listitem> | |
466 | </varlistentry> | |
467 | <varlistentry> | |
7643ac9a | 468 | <term><option>-u</option></term> |
63749b1a KS |
469 | <term><option>--udev</option></term> |
470 | <listitem> | |
471 | <para>Print the udev event after the rule processing.</para> | |
472 | </listitem> | |
473 | </varlistentry> | |
474 | <varlistentry> | |
7643ac9a | 475 | <term><option>-p</option></term> |
63749b1a KS |
476 | <term><option>--property</option></term> |
477 | <listitem> | |
478 | <para>Also print the properties of the event.</para> | |
479 | </listitem> | |
480 | </varlistentry> | |
481 | <varlistentry> | |
7643ac9a | 482 | <term><option>-s</option></term> |
63749b1a KS |
483 | <term><option>--subsystem-match=<replaceable>string[/string]</replaceable></option></term> |
484 | <listitem> | |
485 | <para>Filter events by subsystem[/devtype]. Only udev events with a matching subsystem value will pass.</para> | |
486 | </listitem> | |
487 | </varlistentry> | |
488 | <varlistentry> | |
7643ac9a | 489 | <term><option>-t</option></term> |
63749b1a KS |
490 | <term><option>--tag-match=<replaceable>string</replaceable></option></term> |
491 | <listitem> | |
492 | <para>Filter events by property. Only udev events with a given tag attached will pass.</para> | |
493 | </listitem> | |
494 | </varlistentry> | |
495 | <varlistentry> | |
7643ac9a | 496 | <term><option>-h</option></term> |
63749b1a KS |
497 | <term><option>--help</option></term> |
498 | <listitem> | |
499 | <para>Print help text.</para> | |
500 | </listitem> | |
501 | </varlistentry> | |
502 | </variablelist> | |
503 | </refsect2> | |
225cb03b | 504 | |
1ada30ac | 505 | <refsect2><title>udevadm hwdb <optional>options</optional></title> |
1e1954f5 | 506 | <para>Maintain the hardware database index in <filename>/etc/udev/hwdb.bin</filename>.</para> |
1ada30ac KS |
507 | <variablelist> |
508 | <varlistentry> | |
7643ac9a | 509 | <term><option>-u</option></term> |
1ada30ac KS |
510 | <term><option>--update</option></term> |
511 | <listitem> | |
04ba11b2 ED |
512 | <para>Compile the hardware database information located in /usr/lib/udev/hwdb.d/, |
513 | /etc/udev/hwdb.d/ and store it in <filename>/etc/udev/hwdb.bin</filename>. This should be done after | |
514 | any update to the source files; it will not be called automatically. The running | |
1ada30ac KS |
515 | udev daemon will detect a new database on its own and does not need to be |
516 | notified about it.</para> | |
517 | </listitem> | |
518 | </varlistentry> | |
23b72453 | 519 | <varlistentry> |
7643ac9a | 520 | <term><option>-t</option></term> |
23b72453 KS |
521 | <term><option>--test=<replaceable>string</replaceable></option></term> |
522 | <listitem> | |
523 | <para>Query the database with a modalias string, and print the | |
524 | retrieved properties.</para> | |
525 | </listitem> | |
526 | </varlistentry> | |
3e49f2ec | 527 | <varlistentry> |
7643ac9a | 528 | <term><option>-r</option></term> |
3e49f2ec KS |
529 | <term><option>--root=<replaceable>string</replaceable></option></term> |
530 | <listitem> | |
72ebbf34 | 531 | <para>Alternative root path in the file system for reading and writing files.</para> |
3e49f2ec KS |
532 | </listitem> |
533 | </varlistentry> | |
7643ac9a ZJS |
534 | <varlistentry> |
535 | <term><option>-h</option></term> | |
536 | <term><option>--help</option></term> | |
537 | <listitem> | |
538 | <para>Print help text.</para> | |
539 | </listitem> | |
540 | </varlistentry> | |
1ada30ac KS |
541 | </variablelist> |
542 | </refsect2> | |
543 | ||
63749b1a KS |
544 | <refsect2><title>udevadm test <optional>options</optional> <replaceable>devpath</replaceable></title> |
545 | <para>Simulate a udev event run for the given device, and print debug output.</para> | |
546 | <variablelist> | |
547 | <varlistentry> | |
7643ac9a | 548 | <term><option>-a</option></term> |
63749b1a KS |
549 | <term><option>--action=<replaceable>string</replaceable></option></term> |
550 | <listitem> | |
551 | <para>The action string.</para> | |
552 | </listitem> | |
553 | </varlistentry> | |
554 | <varlistentry> | |
7643ac9a | 555 | <term><option>-N</option></term> |
124b48b0 | 556 | <term><option>--resolve-names=<constant>early</constant>|<constant>late</constant>|<constant>never</constant></option></term> |
63749b1a | 557 | <listitem> |
124b48b0 ZJS |
558 | <para>Specify when udevadm should resolve names of users |
559 | and groups. When set to <constant>early</constant> (the | |
72f4d966 JE |
560 | default), names will be resolved when the rules are |
561 | parsed. When set to <constant>late</constant>, names will | |
124b48b0 | 562 | be resolved for every event. When set to |
72f4d966 | 563 | <constant>never</constant>, names will never be resolved |
124b48b0 | 564 | and all devices will be owned by root.</para> |
63749b1a KS |
565 | </listitem> |
566 | </varlistentry> | |
567 | <varlistentry> | |
7643ac9a | 568 | <term><option>-h</option></term> |
63749b1a KS |
569 | <term><option>--help</option></term> |
570 | <listitem> | |
571 | <para>Print help text.</para> | |
572 | </listitem> | |
573 | </varlistentry> | |
574 | </variablelist> | |
575 | </refsect2> | |
d7867b31 | 576 | |
7643ac9a ZJS |
577 | <refsect2><title>udevadm test-builtin <optional>options</optional> <replaceable>COMMAND</replaceable> <replaceable>DEVPATH</replaceable></title> |
578 | <para>Run a built-in command <replaceable>COMMAND</replaceable> | |
579 | for device <replaceable>DEVPATH</replaceable>, and print debug | |
580 | output.</para> | |
d7867b31 KS |
581 | <variablelist> |
582 | <varlistentry> | |
7643ac9a | 583 | <term><option>-h</option></term> |
d7867b31 KS |
584 | <term><option>--help</option></term> |
585 | <listitem> | |
586 | <para>Print help text.</para> | |
587 | </listitem> | |
588 | </varlistentry> | |
589 | </variablelist> | |
590 | </refsect2> | |
63749b1a | 591 | </refsect1> |
225cb03b | 592 | |
63749b1a KS |
593 | <refsect1> |
594 | <title>See Also</title> | |
595 | <para><citerefentry> | |
596 | <refentrytitle>udev</refentrytitle><manvolnum>7</manvolnum> | |
597 | </citerefentry> | |
598 | <citerefentry> | |
b79f817b | 599 | <refentrytitle>systemd-udevd.service</refentrytitle><manvolnum>8</manvolnum> |
63749b1a KS |
600 | </citerefentry></para> |
601 | </refsect1> | |
602 | </refentry> |