run_program: log "info" not "error" if program is missing

[thirdparty/systemd.git] / udevtrigger.xml

<?xml version='1.0'?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
  "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">

<article>
  <section>
    <title>udevtrigger</title>
    <refentry>
      <refentryinfo>
        <title>udevtrigger</title>
        <date>March 2006</date>
        <productname>udev</productname>
      </refentryinfo>

      <refmeta>
        <refentrytitle>udevtrigger</refentrytitle>
        <manvolnum>8</manvolnum>
        <refmiscinfo class="version"></refmiscinfo>
      </refmeta>

      <refnamediv>
        <refname>udevtrigger</refname><refpurpose>request kernel devices events for coldplug</refpurpose>
      </refnamediv>

      <refsynopsisdiv>
        <cmdsynopsis>
          <command>udevtrigger</command>
          <arg><option>--verbose</option></arg>
          <arg><option>--dry-run</option></arg>
          <arg><option>--retry-failed</option></arg>
          <arg><option>--help</option></arg>
          <arg><option>--subsystem-match=<replaceable>subsystem</replaceable></option></arg>
          <arg><option>--subsystem-nomatch=<replaceable>subsystem</replaceable></option></arg>
          <arg><option>--attr-match=<replaceable>attribute=value</replaceable></option></arg>
          <arg><option>--attr-nomatch=<replaceable>attribute=value</replaceable></option></arg>
        </cmdsynopsis>
      </refsynopsisdiv>

      <refsect1><title>DESCRIPTION</title>
        <para>Trigger kernel device uevents to replay missing events at system coldplug.</para>
      </refsect1>

      <refsect1><title>OPTIONS</title>
        <variablelist>
          <varlistentry>
            <term><option>--verbose</option></term>
            <listitem>
              <para>Print the list of devices which will be triggered.</para>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term><option>--dry-run</option></term>
            <listitem>
              <para>Do not actually trigger the event.</para>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term><option>--retry-failed</option></term>
            <listitem>
              <para>Trigger only the events which are failed during a previous run.</para>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term><option>--subsystem-match=<replaceable>subsystem</replaceable></option></term>
            <listitem>
              <para>Trigger events for devices which belong to a matching subsystem. This option
              can be specified multiple times and supports shell style pattern matching.</para>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term><option>--subsystem-nomatch=<replaceable>subsystem</replaceable></option></term>
            <listitem>
              <para>Do not trigger events for devices which belong to a matching subsystem. This option
              can be specified multiple times and supports shell style pattern matching.</para>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term><option>--attr-match=<replaceable>attribute=value</replaceable></option></term>
            <listitem>
              <para>Trigger events for devices with a matching sysfs attribute. If a value is specified
              along with the attribute name, the content of the attribute is matched against the given
              value using shell style pattern matching. If no value is specified, the existence of the
              sysfs attribute is checked. This option can be specified multiple times.</para>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term><option>--attr-nomatch<replaceable>attribute=value</replaceable></option></term>
            <listitem>
              <para>Do not trigger events for devices with a matching sysfs attribute. If a value is
              specified along with the attribute name, the content of the attribute is matched against
              the given value using shell style pattern matching. If no value is specified, the existence
              of the sysfs attribute is checked. This option can be specified multiple times.</para>
            </listitem>
          </varlistentry>
        </variablelist>
      </refsect1>

      <refsect1><title>ENVIRONMENT</title>
        <variablelist>
          <varlistentry>
            <term><option>UDEV_LOG</option></term>
            <listitem>
              <para>Overrides the syslog priority specified in the config file.</para>
            </listitem>
          </varlistentry>
        </variablelist>
     </refsect1>

      <refsect1><title>AUTHOR</title>
        <para>Written by Kay Sievers <email>kay.sievers@vrfy.org</email> and
        Hannes Reinecke <email>hare@suse.de</email>.</para>
      </refsect1>

      <refsect1>
        <title>SEE ALSO</title>
        <para><citerefentry>
            <refentrytitle>udev</refentrytitle><manvolnum>7</manvolnum>
        </citerefentry></para>
      </refsect1>
    </refentry>
  </section>
</article>