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.