repoquery

Section: (1)
Updated: 2005 Oct 17
Index Return to Main Contents
 

NAME

repoquery  

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..
-v, --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 download 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>
Use alternative config file (default is /etc/yum.conf).

 

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 (easier 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})

 

PACKAGE SELECTION OPTIONS

-a, --all
Query all available packages (for rpmquery compatibility / shorthand for repoquery '*')
-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, use both automatic and manual dependencies for the query.
--recursive
When used with --whatrequires, query packages recursively.
--archlist=ARCH1[,ARCH2...]
Limit the query to packages of given architecture(s). Valid values are all architectures known to rpm/yum such as 'i386' and 'src' for source RPMS.
--pkgnarrow=WHAT
Limit what packages are considered for the query. Valid values for WHAT are: installed, available, recent, updates, extras, all and repository (default).
--show-dupes, --show-duplicates
Query all versions of package. By default only newest packages are considered.

 

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 --alldeps openssl
List all package names and the repository they come from, nicely formatted:
repoquery -a --qf "%-20{repoid} %{name}"
List name and summary of all available updates (if any), nicely formatted:
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 following:

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 repositories 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 of course aren't any bugs, but if you find any, they should be sent to the mailing list: yum@lists.baseurl.org or filed in trac.