udevinfo.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>udevinfo</title>
   8     <refentry>
   9       <refentryinfo>
  10         <title>udevinfo</title>
  11         <date>August 2005</date>
  12         <productname>udev</productname>
  13       </refentryinfo>
  14
  15       <refmeta>
  16         <refentrytitle>udevinfo</refentrytitle>
  17         <manvolnum>8</manvolnum>
  18         <refmiscinfo class="version"></refmiscinfo>
  19       </refmeta>
  20
  21       <refnamediv>
  22         <refname>udevinfo</refname><refpurpose>query device information from the udev database</refpurpose>
  23       </refnamediv>
  24
  25       <refsynopsisdiv>
  26         <cmdsynopsis>
  27           <command>udevinfo</command>
  28           <arg><option>-q <replaceable>query-type</replaceable></option></arg>
  29           <arg><option>-a </option></arg>
  30           <arg><option>-p <replaceable>devpath</replaceable></option></arg>
  31           <arg><option>-n <replaceable>node</replaceable></option></arg>
  32           <arg><option>-r</option></arg>
  33           <arg><option>-e</option></arg>
  34           <arg><option>-V</option></arg>
  35           <arg><option>-h</option></arg>
  36         </cmdsynopsis>
  37       </refsynopsisdiv>
  38
  39       <refsect1><title>DESCRIPTION</title>
  40         <para>udevinfo queries the udev database for device information
  41         stored in the udev database. It can also query the properties
  42         of a device from its sysfs representation to help creating udev
  43         rules that match this device.</para>
  44       </refsect1>
  45
  46       <refsect1><title>OPTIONS</title>
  47         <variablelist>
  48           <varlistentry>
  49             <term><option>-q</option></term>
  50             <listitem>
  51               <para>Query the database for specified type of device data. It needs the
  52               <option>-p</option> or <option>-n</option> to identify the specified
  53               device. Valid queries are:
  54               <command>name</command>, <command>symlink</command>, <command>path</command>,
  55               <command>env</command>, <command>all</command>.</para>
  56             </listitem>
  57           </varlistentry>
  58
  59           <varlistentry>
  60             <term><option>-a</option></term>
  61             <listitem>
  62               <para>Print all sysfs properties of the specified device that can be used
  63               in udev rules to match the specified device. It prints all devices
  64               along the chain, up to the root of sysfs that can be used in udev rules.</para>
  65             </listitem>
  66           </varlistentry>
  67
  68           <varlistentry>
  69             <term><option>-p <replaceable>devpath</replaceable></option></term>
  70             <listitem>
  71               <para>The devpath of the device to query.</para>
  72             </listitem>
  73           </varlistentry>
  74
  75           <varlistentry>
  76             <term><option>-n <replaceable>node</replaceable></option></term>
  77             <listitem>
  78               <para>The name of the device node or a symlink to query</para>
  79             </listitem>
  80           </varlistentry>
  81
  82           <varlistentry>
  83             <term><option>-r</option></term>
  84             <listitem>
  85               <para>The udev root directory: <filename>/dev</filename>. If used in conjunction
  86               with a <command>name</command> or <command>symlink</command> query, the
  87               query returns the absolute path.</para>
  88             </listitem>
  89           </varlistentry>
  90
  91           <varlistentry>
  92             <term><option>-e</option></term>
  93             <listitem>
  94               <para>Export the content of the udev database.</para>
  95             </listitem>
  96           </varlistentry>
  97
  98           <varlistentry>
  99             <term><option>-h</option></term>
 100             <listitem>
 101               <para>Print help text.</para>
 102             </listitem>
 103           </varlistentry>
 104         </variablelist>
 105       </refsect1>
 106
 107       <refsect1><title>AUTHOR</title>
 108         <para>Written by Kay Sievers <email>kay.sievers@vrfy.org</email>.</para>
 109       </refsect1>
 110
 111       <refsect1>
 112         <title>SEE ALSO</title>
 113         <para><citerefentry>
 114             <refentrytitle>udev</refentrytitle><manvolnum>7</manvolnum>
 115         </citerefentry></para>
 116       </refsect1>
 117     </refentry>
 118   </section>
 119 </article>