rpm-guide rpm-guide-command-reference-en.xml,NONE,1.1

[Stuart Ellis (elliss)]

Author: elliss

Update of /cvs/docs/rpm-guide
In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv376

Added Files:
	rpm-guide-command-reference-en.xml 
Log Message:



--- NEW FILE rpm-guide-command-reference-en.xml ---
<!-- $Id: --> 
<chapter id="ch-command-reference">
<title>RPM Command Reference</title>

  <para>
    In This Appendix
  </para>

  <para>
    *rpm command
  </para>

  <para>
    *rpmbuild command
  </para>

  <para>
    This appendix covers the syntax of the command-line options for the
    rpm and rpmbuild commands.
  </para>

  <sect1>
    <title>The rpm Command</title>
    <para>
      The rpm command is the workhorse of the RPM system. The following
      sections cover options for the major operations with the rpm
      command.
    </para>
    <para>
      Table A-1 lists the query options for the rpm command.
    </para>
    <para>
      Table A-1 rpm query options with –q or --query
    </para>
    <informaltable frame="all">
      <tgroup cols="2">
        <tbody>
          <row>
            <entry>
              <para>
                Option
              </para>
            </entry>
            <entry>
              <para>
                Usage
              </para>
            </entry>
          </row>
          <row>
            <entry>
              <para>
                -a, --all
              </para>
            </entry>
            <entry>
              <para>
                Query all packages
              </para>
            </entry>
          </row>
          <row>
            <entry>
              <para>
                -c, --configfiles
              </para>
            </entry>
            <entry>
              <para>
                List configuration files
              </para>
            </entry>
          </row>
          <row>
            <entry>
              <para>
                --changelog
              </para>
            </entry>
            <entry>
              <para>
                List changelog entries
              </para>
            </entry>
          </row>
          <row>
            <entry>
              <para>
                --conflicts
              </para>
            </entry>
            <entry>
              <para>
                List capabilities this package conflicts with
              </para>
            </entry>
          </row>
          <row>
            <entry>
              <para>
                -d, --docfiles
              </para>
            </entry>
            <entry>
              <para>
                List documentation files
              </para>
            </entry>
          </row>
          <row>
            <entry>
              <para>
                --dump
              </para>
            </entry>
            <entry>
              <para>
                Dump out extra information on files.
              </para>
            </entry>
          </row>
          <row>
            <entry>
              <para>
                -f, --file filename
              </para>
            </entry>
            <entry>
              <para>
                Query for packages owning given file
              </para>
            </entry>
          </row>
          <row>
            <entry>
              <para>
                --filesbypapkg
              </para>
            </entry>
            <entry>
              <para>
                List all files in each selected package
              </para>
            </entry>
          </row>
          <row>
            <entry>
              <para>
                --fileid md5_id
              </para>
            </entry>
            <entry>
              <para>
                Query for the package with the given MD5 digest
              </para>
            </entry>
          </row>
          <row>
            <entry>
              <para>
                -g, --group group_name
              </para>
            </entry>
            <entry>
              <para>
                Query packages in the given group
              </para>
            </entry>
          </row>
          <row>
            <entry>
              <para>
                --hdrid sha1_header_id
              </para>
            </entry>
            <entry>
              <para>
                Query for the package with the given header identifier
                number, in SHA1 format
              </para>
            </entry>
          </row>
          <row>
            <entry>
              <para>
                -i, --info
              </para>
            </entry>
            <entry>
              <para>
                Display a lot of package information including
                description
              </para>
            </entry>
          </row>
          <row>
            <entry>
              <para>
                --last
[...1918 lines suppressed...]
              </entry>
              <entry>
                <para>
                  Read the given colon-separated files as the macro
                  files to define RPM macros; only the first file must
                  exist
                </para>
              </entry>
            </row>
            <row>
              <entry>
                <para>
                  --nobuild
                </para>
              </entry>
              <entry>
                <para>
                  Don't really build anything, which really tests the
                  spec file
                </para>
              </entry>
            </row>
            <row>
              <entry>
                <para>
                  --pipe command
                </para>
              </entry>
              <entry>
                <para>
                  Pipe the output of the rpm command to the given
                  command
                </para>
              </entry>
            </row>
            <row>
              <entry>
                <para>
                  --quiet
                </para>
              </entry>
              <entry>
                <para>
                  Provide less output, normally show only errors
                </para>
              </entry>
            </row>
            <row>
              <entry>
                <para>
                  --rcfile file:file:file
                </para>
              </entry>
              <entry>
                <para>
                  Read the given colon-separated files as the rc files
                  to define RPM settings; only the first file must exist
                </para>
              </entry>
            </row>
            <row>
              <entry>
                <para>
                  --rmsource
                </para>
              </entry>
              <entry>
                <para>
                  Remove the sources after the build
                </para>
              </entry>
            </row>
            <row>
              <entry>
                <para>
                  --rmspec
                </para>
              </entry>
              <entry>
                <para>
                  Remove the spec file after the build
                </para>
              </entry>
            </row>
            <row>
              <entry>
                <para>
                  --root directory
                </para>
              </entry>
              <entry>
                <para>
                  Use directory as the top-level directory instead of /
                </para>
              </entry>
            </row>
            <row>
              <entry>
                <para>
                  --short-circuit
                </para>
              </entry>
              <entry>
                <para>
                  With the -bc or -bi options, jumps directly to the
                  given stage and just executes that stage
                </para>
              </entry>
            </row>
            <row>
              <entry>
                <para>
                  --showrc
                </para>
              </entry>
              <entry>
                <para>
                  Print the rpmrc and macro configuration and exit
                </para>
              </entry>
            </row>
            <row>
              <entry>
                <para>
                  --sign
                </para>
              </entry>
              <entry>
                <para>
                  Sign the package with a GPG signature
                </para>
              </entry>
            </row>
            <row>
              <entry>
                <para>
                  --target platform
                </para>
              </entry>
              <entry>
                <para>
                  Build for the given platform. May not work if you
                  don't have the other platform build commands, such as
                  cross compilers, set up. Can work for Intel platforms
                  with i386, i686, and so on.
                </para>
              </entry>
            </row>
            <row>
              <entry>
                <para>
                  -v, --verbose
                </para>
              </entry>
              <entry>
                <para>
                  Provide more verbose output
                </para>
              </entry>
            </row>
            <row>
              <entry>
                <para>
                  -vv
                </para>
              </entry>
              <entry>
                <para>
                  Provide even more verbose output, including debugging
                  information
                </para>
              </entry>
            </row>
            <row>
              <entry>
                <para>
                  --version
                </para>
              </entry>
              <entry>
                <para>
                  Print the RPM version and exit
                </para>
              </entry>
            </row>
          </tbody>
        </tgroup>
      </informaltable>
      <para/>
    </sect2>
  </sect1>
</chapter>
<!--
Local variables:
mode: xml
sgml-parent-document:("rpm-guide-en.xml" "book" "chapter")
fill-column: 72
End:
-->