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>--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>