repoquery man page

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 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".

--nolock

Disable locking the yum cache. This is needed as any yum API caller can alter the repo. metadata cache, unless it is locked. This automatically enables the --cache and --tempcache options, to try to lower the riskiness.

--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.

-R, --weak-requires

List package weak dependencies.

-R, --info-requires

List package informational dependencies.

-R, --weak-reverse-requires

List package weak reverse dependencies.

-R, --info-reverse-requires

List package informational reverse dependencies.

--resolve

When used with --requires/--weak-requires/etc, 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})

--output [text|ascii-tree|ascii-tree+|dot-tree|dot-tree+]

Output format which can be used with --requires/--weak-requires/--whatrequires/--obsoletes/--conflicts. The variants with a + suffix are used for weak dependencies and will merge the stronger variants into the output. Default output is 'text'.

--level [all|any int]

In combination with --output ascii-tree|dot-tree|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 dependencies 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 values 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 "--archlist=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 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 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@lists.baseurl.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.

Referenced By

yum-deprecated(8), yum-utils(1).

17 October 2005 Panu Matilainen