xref: /aosp_15_r20/external/kmod/man/modinfo.8.xml (revision cc4ad7da8cefe208cb129ac2aa9a357c7c72deb2)

<?xml version='1.0'?>
<!--*-nxml-*-->
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
        "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
<refentry id="modinfo">
  <refentryinfo>
    <title>modinfo</title>
    <productname>kmod</productname>

    <authorgroup>
      <author>
        <contrib>Developer</contrib>
        <firstname>Jon</firstname>
        <surname>Masters</surname>
        <email>[email protected]</email>
      </author>
      <author>
        <contrib>Developer</contrib>
        <firstname>Lucas</firstname>
        <surname>De Marchi</surname>
        <email>[email protected]</email>
      </author>
    </authorgroup>
  </refentryinfo>

  <refmeta>
    <refentrytitle>modinfo</refentrytitle>
    <manvolnum>8</manvolnum>
  </refmeta>

  <refnamediv>
    <refname>modinfo</refname>
    <refpurpose>Show information about a Linux Kernel module</refpurpose>
  </refnamediv>

  <refsynopsisdiv>
    <cmdsynopsis>
      <command>modinfo</command>
      <arg><option>-0</option></arg>
      <arg><option>-F <replaceable>field</replaceable></option></arg>
      <arg><option>-k <replaceable>kernel</replaceable></option></arg>
      <arg rep='repeat'>modulename|filename</arg>
    </cmdsynopsis>
    <cmdsynopsis>
      <command>modinfo -V</command>
    </cmdsynopsis>
    <cmdsynopsis>
      <command>modinfo -h</command>
    </cmdsynopsis>
  </refsynopsisdiv>

  <refsect1><title>DESCRIPTION</title>
    <para>
      <command>modinfo</command> extracts information from the Linux Kernel
      modules given on the command line.  If the module name is not a filename,
      then the
      <filename>@MODULE_DIRECTORY@/</filename><replaceable>version</replaceable>
      directory is searched, as is also done by
      <citerefentry><refentrytitle>modprobe</refentrytitle><manvolnum>8</manvolnum></citerefentry>
      when loading kernel modules.
    </para>
    <para>
      <command>modinfo</command> by default lists each attribute of the module
      in form <replaceable>fieldname</replaceable> :
      <replaceable>value</replaceable>, for easy reading.  The filename is
      listed the same way (although it's not really an attribute).
    </para>
    <para>
      This version of <command>modinfo</command> can understand modules of any
      Linux Kernel architecture.
    </para>
  </refsect1>

  <refsect1><title>OPTIONS</title>
    <variablelist>
      <varlistentry>
        <term>
          <option>-V</option>
        </term>
        <term>
          <option>--version</option>
        </term>
        <listitem>
          <para>
            Print the modinfo version.
          </para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <option>-F</option>
        </term>
        <term>
          <option>--field</option>
        </term>
        <listitem>
          <para>
            Only print this field value, one per line.  This is most useful for
            scripts.  Field names are case-insensitive.  Common fields (which
            may not be in every module) include <literal>author</literal>,
            <literal>description</literal>, <literal>license</literal>,
            <literal>parm</literal>, <literal>depends</literal>, and
            <literal>alias</literal>.  There are often multiple
            <literal>parm</literal>, <literal>alias</literal> and
            <literal>depends</literal> fields.  The special field
            <literal>filename</literal> lists the filename of the module.
          </para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <option>-b <replaceable>basedir</replaceable></option>
        </term>
        <term>
          <option>--basedir <replaceable>basedir</replaceable></option>
        </term>
        <listitem>
          <para>
            Root directory for modules, <filename>/</filename> by default.
          </para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <option>-k <replaceable>kernel</replaceable></option>
        </term>
        <listitem>
          <para>
            Provide information about a kernel other than the running one. This
            is particularly useful for distributions needing to extract
            information from a newly installed (but not yet running) set of
            kernel modules. For example, you wish to find which firmware files
            are needed by various modules in a new kernel for which you must
            make an initrd/initramfs image prior to booting.
          </para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <option>-0</option>
        </term>
        <term>
          <option>--null</option>
        </term>
        <listitem>
          <para>
            Use the ASCII zero character to separate field values, instead of a
            new line.  This is useful for scripts, since a new line can
            theoretically appear inside a field.
          </para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <option>-a</option>
          <option>--author</option>
        </term>
        <term>
          <option>-d</option>
          <option>--description</option>
        </term>
        <term>
          <option>-l</option>
          <option>--license</option>
        </term>
        <term>
          <option>-p</option>
          <option>--parameters</option>
        </term>
        <term>
          <option>-n</option>
          <option>--filename</option>
        </term>
        <listitem>
          <para>
            These are shortcuts for the <option>--field</option> flag's
            <literal>author</literal>, <literal>description</literal>,
            <literal>license</literal>, <literal>parm</literal> and
            <literal>filename</literal> arguments, to ease the transition
            from the old modutils <command>modinfo</command>.
          </para>
        </listitem>
      </varlistentry>
    </variablelist>
  </refsect1>

  <refsect1><title>COPYRIGHT</title>
    <para>
      This manual page originally Copyright 2003, Rusty Russell, IBM
      Corporation. Maintained by Jon Masters and others.
    </para>
  </refsect1>

  <refsect1><title>SEE ALSO</title>
    <para>
      <citerefentry>
        <refentrytitle>modprobe</refentrytitle><manvolnum>8</manvolnum>
      </citerefentry>
    </para>
  </refsect1>
</refentry>