1<?xml version='1.0'?>
2<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
3  "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
4
5<article>
6  <section>
7    <title>udevtrigger</title>
8    <refentry>
9      <refentryinfo>
10        <title>udevtrigger</title>
11        <date>March 2006</date>
12        <productname>udev</productname>
13      </refentryinfo>
14
15      <refmeta>
16        <refentrytitle>udevtrigger</refentrytitle>
17        <manvolnum>8</manvolnum>
18        <refmiscinfo class="version"></refmiscinfo>
19      </refmeta>
20
21      <refnamediv>
22        <refname>udevtrigger</refname><refpurpose>request kernel devices events for coldplug</refpurpose>
23      </refnamediv>
24
25      <refsynopsisdiv>
26        <cmdsynopsis>
27          <command>udevtrigger</command>
28          <arg><option>--verbose</option></arg>
29          <arg><option>--dry-run</option></arg>
30          <arg><option>--retry-failed</option></arg>
31          <arg><option>--help</option></arg>
32          <arg><option>--subsystem-match=<replaceable>subsystem</replaceable></option></arg>
33          <arg><option>--subsystem-nomatch=<replaceable>subsystem</replaceable></option></arg>
34          <arg><option>--attr-match=<replaceable>attribute=value</replaceable></option></arg>
35          <arg><option>--attr-nomatch=<replaceable>attribute=value</replaceable></option></arg>
36        </cmdsynopsis>
37      </refsynopsisdiv>
38
39      <refsect1><title>DESCRIPTION</title>
40        <para>Trigger kernel device uevents to replay missing events at system coldplug.</para>
41      </refsect1>
42
43      <refsect1><title>OPTIONS</title>
44        <variablelist>
45          <varlistentry>
46            <term><option>--verbose</option></term>
47            <listitem>
48              <para>Print the list of devices which will be triggered.</para>
49            </listitem>
50          </varlistentry>
51          <varlistentry>
52            <term><option>--dry-run</option></term>
53            <listitem>
54              <para>Do not actually trigger the event.</para>
55            </listitem>
56          </varlistentry>
57          <varlistentry>
58            <term><option>--retry-failed</option></term>
59            <listitem>
60              <para>Trigger only the events which are failed during a previous run.</para>
61            </listitem>
62          </varlistentry>
63          <varlistentry>
64            <term><option>--subsystem-match=<replaceable>subsystem</replaceable></option></term>
65            <listitem>
66              <para>Trigger events for devices which belong to a matching subsystem. This option
67              can be specified multiple times and supports shell style pattern matching.</para>
68            </listitem>
69          </varlistentry>
70          <varlistentry>
71            <term><option>--subsystem-nomatch=<replaceable>subsystem</replaceable></option></term>
72            <listitem>
73              <para>Do not trigger events for devices which belong to a matching subsystem. This option
74              can be specified multiple times and supports shell style pattern matching.</para>
75            </listitem>
76          </varlistentry>
77          <varlistentry>
78            <term><option>--attr-match=<replaceable>attribute=value</replaceable></option></term>
79            <listitem>
80              <para>Trigger events for devices with a matching sysfs attribute. If a value is specified
81              along with the attribute name, the content of the attribute is matched against the given
82              value using shell style pattern matching. If no value is specified, the existence of the
83              sysfs attribute is checked. This option can be specified multiple times.</para>
84            </listitem>
85          </varlistentry>
86          <varlistentry>
87            <term><option>--attr-nomatch<replaceable>attribute=value</replaceable></option></term>
88            <listitem>
89              <para>Do not trigger events for devices with a matching sysfs attribute. If a value is
90              specified along with the attribute name, the content of the attribute is matched against
91              the given value using shell style pattern matching. If no value is specified, the existence
92              of the sysfs attribute is checked. This option can be specified multiple times.</para>
93            </listitem>
94          </varlistentry>
95        </variablelist>
96      </refsect1>
97
98      <refsect1><title>ENVIRONMENT</title>
99        <variablelist>
100          <varlistentry>
101            <term><option>UDEV_LOG</option></term>
102            <listitem>
103              <para>Overrides the syslog priority specified in the config file.</para>
104            </listitem>
105          </varlistentry>
106        </variablelist>
107     </refsect1>
108
109      <refsect1><title>AUTHOR</title>
110        <para>Written by Kay Sievers <email>kay.sievers@vrfy.org</email> and
111        Hannes Reinecke <email>hare@suse.de</email>.</para>
112      </refsect1>
113
114      <refsect1>
115        <title>SEE ALSO</title>
116        <para><citerefentry>
117            <refentrytitle>udev</refentrytitle><manvolnum>7</manvolnum>
118        </citerefentry></para>
119      </refsect1>
120    </refentry>
121  </section>
122</article>
123