huschi.net

repoquery(1)                                                      repoquery(1)

NAME
       repoquery - query information from Yum repositories
SYNOPSIS
       repoquery [options] <item ...>
       repoquery -a [options]
DESCRIPTION
       repoquery  is  a program for querying information from YUM repositories
       similarly to rpm queries.
GENERAL OPTIONS
       --querytags
              List valid queryformat tags and exit..
       --version
              Report program version and exit.
       --repoid=<repo>
              Specify which repository to query. Using  this  option  disables
              all  repositories  not  explicitly  enabled with --repoid option
              (can be used multiple times). By default repoquery uses whatever
              repositories are enabled in YUM configuration.
       --enablerepo=<repo>
              In  addition  to  the  default  set,  query the given additional
              repository, even if it is disabled in YUM configuration.  Can be
              used multiple times.
       --disablerepo=<repo>
              Do  not query the given repository, even if it is enabled in YUM
              configuration.  Can be used multiple times.
       --repofrompath=<repoid>,<path/url>
              Specify a path or url  to  a  repository  (same  path  as  in  a
              baseurl)  to add to the repositories for this query. This option
              can be used multiple times. If you want to view  only  the  pkgs
              from  this repository combine this with --repoid. The repoid for
              the repository is specified by <repoid>.
       --plugins
              Enable YUM plugin support.
       -q, --query
              For rpmquery compatibility, doesn't do anything.
       -h, --help
              Help; display a help message and then quit.
       --quiet
              Run quietly: no warnings printed to stderr.
       --verbose
              Produce verbose output.
       -C, --cache
              Tells repoquery to run entirely from YUM cache - does not  down-
              load  any metadata or update the cache. Queries in this mode can
              fail or give partial/incorrect results if the cache isn't  fully
              populated beforehand with eg "yum makecache".
       --tempcache
              Create  and  use  a private cache instead of the main YUM cache.
              This is used by default when run as non-root user.
       -c <config file>, --config=<config file>
              Use alternative config file (default is /etc/yum.conf).
       --releasever=version
              Pretend the current release version is the given string. This is
              very  useful  when combined with --installroot. You can also use
              --releasever=/ to take the releasever information  from  outside
              the  installroot.  Note that with the default upstream cachedir,
              of /var/cache/yum, using this option  will  corrupt  your  cache
              (and  you  can use $releasever in your cachedir configuration to
              stop this).
       --installroot=root
              Specifies an alternative  installroot,  relative  to  which  all
              packages  will  be  installed.  Think of this like doing "chroot
              <root> yum" except using --installroot allows yum to work before
              the  chroot  is  created.   Note:  You  may also want to use the
              option --releasever=/ when creating the installroot as otherwise
              the  $releasever  value  is  taken  from  the  rpmdb  within the
              installroot (and thus. will be empty, before creation).
       --setopt=option=value
              Set any config option in yum config or repo files.  For  options
              in  the  global  config just use: --setopt=option=value for repo
              options use: --setopt=repoid.option=value

PACKAGE QUERY OPTIONS
       -i, --info
              Show general information about package similarly to "rpm -qi"
       -l, --list
              List files in package.
       -R, --requires
              List package dependencies.
       --resolve
              When used with --requires, resolve capabilities  to  originating
              packages.
       --provides
              List capabilities package provides.
       --obsoletes
              List capabilities obsoleted by package.
       --conflicts
              List capabilities conflicting with package.
       --changelog
              List package changelog.
       --location
              Show a location where the package could be downloaded from.  For
              example: wget `repoquery --location yum`
       -s, --source
              Show package source RPM name.
       --srpm Operate on corresponding source RPM.
       --groupmember PACKAGE
              List the repodata groups (yumgroups.xml) belongs to (if any).
       --nvr  Use name-version-release output format (rpm query default)
       --nevra
              Use   name-epoch:version-release.architecture   output    format
              (default)
       --envra
              Use  epoch:name-version-release.architecture output format (eas-
              ier to parse than nevra)
       --qf=FORMAT, --queryformat=FORMAT
              Specify custom output format for queries. You can  add  ":date",
              ":day"  and  ":isodate" to all the tags that are a time, and you
              can add ":k", ":m", ":g", ":t" and ":h" to sizes. You  can  also
              specify field width as in sprintf (Eg. %-20{name})
       --output [text|ascii-tree|dot-tree]
              Output  format  which  can  be  used  with  --requires/--whatre-
              quires/--obsoletes/--conflicts.  Default output is 'text'.
       --level [all|any int]
              In combination with  --output  ascii-tree|dot-tree  this  option
              specifies  the  number  of  level  to print on the tree. Default
              level is 'all'.
PACKAGE SELECTION OPTIONS
       -a, --all
              Query all  available  packages  (for  rpmquery  compatibility  /
              shorthand for repoquery '*')
       --show-duplicates
              Query all versions of packages.
       -f, --file FILE
              Query package owning FILE.
       --whatobsoletes CAPABILITY
              Query all packages that obsolete CAPABILITY.
       --whatconflicts CAPABILITY
              Query all packages that conflict with CAPABILITY.
       --whatprovides CAPABILITY
              Query all packages that provide CAPABILITY.
       --whatrequires CAPABILITY
              Query all packages that require CAPABILITY.
       --alldeps
              When  used  with --whatrequires, look for non-explicit dependen-
              cies in addition to explicit ones (e.g. files  and  Provides  in
              addition to package names).  This is the default.
       --exactdeps
              When  used  with  --whatrequires,  search  for dependencies only
              exactly  as  given.   This  is  effectively  the   opposite   of
              --alldeps.
       --recursive
              When  used  with --whatrequires, and --requires --resolve, query
              packages recursively.
       --archlist=ARCH1[,ARCH2...]
              Limit the query to packages of given architecture(s). Valid val-
              ues  are  all  architectures known to rpm/yum such as 'i386' and
              'src' for source RPMS. Note that repoquery will now change yum's
              "arch"   to  the  first  value  in  the  archlist.  So  "--arch-
              list=i386,i686" will change yum's canonical arch  to  i386,  but
              allow packages of i386 and i686.
       --pkgnarrow=WHAT
              Limit  what  packages are considered for the query. Valid values
              for WHAT are: installed, available, recent, updates, extras, all
              and repository (default).
       --installed
              Restrict  query  ONLY to installed pkgs - disables all repos and
              only acts on rpmdb.

GROUP QUERY OPTIONS
       -i, --info
              Show general information about group.
       -l, --list
              List packages belonging to (required by) group.
       --grouppkgs=WHAT
              Specify what type of packages are  queried  from  groups.  Valid
              values for WHAT are all, mandatory, default, optional.
       --requires
              List groups required by group.
GROUP SELECTION OPTIONS
       -a     Query all available groups.
       -g, --group
              Query groups instead of packages.
EXAMPLES
       List all packages whose name contains 'perl':
              repoquery '*perl*'
       List all packages depending on openssl:
              repoquery --whatrequires openssl
       List  all  package names and the repository they come from, nicely for-
       matted:
              repoquery -a --qf "%-20{repoid} %{name}"
       List name and summary of all available updates (if any), nicely format-
       ted:
              repoquery -a --pkgnarrow=updates --qf "%{name}:\n%{summary}\n"
       List optional packages in base group:
              repoquery -g --grouppkgs=optional -l base
       List build requirements from 'anaconda' source rpm:
              repoquery --requires anaconda.src
       List packages which BuildRequire gail-devel
              repoquery --archlist=src --whatrequires gail-devel
                NB:  This  command  will  only  work  if you have repositories
              enabled which include srpms.

MISC
       Specifying package names
              A package can be referred to in all queries with any of the fol-
              lowing:
              name
              name.arch
              name-ver
              name-ver-rel
              name-ver-rel.arch
              name-epoch:ver-rel.arch
              epoch:name-ver-rel.arch
              For example: repoquery -l kernel-2.4.1-10.i686
              Additionally wildcards (shell-style globs) can be used.

FILES
       As  repoquery uses YUM libraries for retrieving all the information, it
       relies on YUM configuration for its default values like which reposito-
       ries to use. Consult YUM documentation for details:
       /etc/yum.conf
       /etc/yum/repos.d/
       /var/cache/yum/

SEE ALSO
       yum.conf (5)
       http://yum.baseurl.org/

AUTHORS
       See the Authors file included with this program.

BUGS
       There  are of course no bugs, but should you find any, you should first
       consult the  FAQ  section  on  http://yum.baseurl.org/wiki/Faq  and  if
       unsuccessful  in  finding  a  resolution contact the mailing list: yum-
       devel AT lists.org.  To file a bug use  http://bugzilla.redhat.com
       for  Fedora/RHEL/Centos  related bugs and http://yum.baseurl.org/report
       for all other bugs.


Panu Matilainen                 17 October 2005                   repoquery(1)