udevtrigger.xml

   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>--action=<replaceable>action</replaceable></option></arg>
  33           <arg><option>--subsystem-match=<replaceable>subsystem</replaceable></option></arg>
  34           <arg><option>--subsystem-nomatch=<replaceable>subsystem</replaceable></option></arg>
  35           <arg><option>--attr-match=<replaceable>attribute=value</replaceable></option></arg>
  36           <arg><option>--attr-nomatch=<replaceable>attribute=value</replaceable></option></arg>
  37         </cmdsynopsis>
  38       </refsynopsisdiv>
  39
  40       <refsect1><title>DESCRIPTION</title>
  41         <para>Trigger kernel device uevents to replay missing events at system coldplug.</para>
  42       </refsect1>
  43
  44       <refsect1><title>OPTIONS</title>
  45         <variablelist>
  46           <varlistentry>
  47             <term><option>--verbose</option></term>
  48             <listitem>
  49               <para>Print the list of devices which will be triggered.</para>
  50             </listitem>
  51           </varlistentry>
  52           <varlistentry>
  53             <term><option>--dry-run</option></term>
  54             <listitem>
  55               <para>Do not actually trigger the event.</para>
  56             </listitem>
  57           </varlistentry>
  58           <varlistentry>
  59             <term><option>--retry-failed</option></term>
  60             <listitem>
  61               <para>Trigger only the events which are failed during a previous run.</para>
  62             </listitem>
  63           </varlistentry>
  64           <varlistentry>
  65             <term><option>--action=<replaceable>action</replaceable></option></term>
  66             <listitem>
  67               <para>Type of event to be triggered. The default value is "add".</para>
  68             </listitem>
  69           </varlistentry>
  70           <varlistentry>
  71             <term><option>--subsystem-match=<replaceable>subsystem</replaceable></option></term>
  72             <listitem>
  73               <para>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>--subsystem-nomatch=<replaceable>subsystem</replaceable></option></term>
  79             <listitem>
  80               <para>Do not trigger events for devices which belong to a matching subsystem. This option
  81               can be specified multiple times and supports shell style pattern matching.</para>
  82             </listitem>
  83           </varlistentry>
  84           <varlistentry>
  85             <term><option>--attr-match=<replaceable>attribute=value</replaceable></option></term>
  86             <listitem>
  87               <para>Trigger events for devices with a matching sysfs attribute. If a value is specified
  88               along with the attribute name, the content of the attribute is matched against the given
  89               value using shell style pattern matching. If no value is specified, the existence of the
  90               sysfs attribute is checked. This option can be specified multiple times.</para>
  91             </listitem>
  92           </varlistentry>
  93           <varlistentry>
  94             <term><option>--attr-nomatch<replaceable>attribute=value</replaceable></option></term>
  95             <listitem>
  96               <para>Do not trigger events for devices with a matching sysfs attribute. If a value is
  97               specified along with the attribute name, the content of the attribute is matched against
  98               the given value using shell style pattern matching. If no value is specified, the existence
  99               of the sysfs attribute is checked. This option can be specified multiple times.</para>
 100             </listitem>
 101           </varlistentry>
 102         </variablelist>
 103       </refsect1>
 104
 105       <refsect1><title>ENVIRONMENT</title>
 106         <variablelist>
 107           <varlistentry>
 108             <term><option>UDEV_LOG</option></term>
 109             <listitem>
 110               <para>Overrides the syslog priority specified in the config file.</para>
 111             </listitem>
 112           </varlistentry>
 113         </variablelist>
 114      </refsect1>
 115
 116       <refsect1><title>AUTHOR</title>
 117         <para>Written by Kay Sievers <email>kay.sievers@vrfy.org</email> and
 118         Hannes Reinecke <email>hare@suse.de</email>.</para>
 119       </refsect1>
 120
 121       <refsect1>
 122         <title>SEE ALSO</title>
 123         <para><citerefentry>
 124             <refentrytitle>udev</refentrytitle><manvolnum>7</manvolnum>
 125         </citerefentry></para>
 126       </refsect1>
 127     </refentry>
 128   </section>
 129 </article>