SYNOPSIS

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

--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 (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|dot-tree]

Output format which can be used with --requires/--whatrequires/--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 '*')

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

/etc/yum.conf
/etc/yum/repos.d/
/var/cache/yum/

AUTHORS

See the Authors file included with this program.