1repoquery(1)                                                      repoquery(1)
2
3
4

NAME

6       repoquery - query information from Yum repositories
7

SYNOPSIS

9       repoquery [options] <item ...>
10       repoquery -a [options]
11

DESCRIPTION

13       repoquery  is  a program for querying information from YUM repositories
14       similarly to rpm queries.
15

GENERAL OPTIONS

17       --querytags
18              List valid queryformat tags and exit..
19
20       --version
21              Report program version and exit.
22
23       --repoid=<repo>
24              Specify which repository to query. Using  this  option  disables
25              all  repositories  not  explicitly  enabled with --repoid option
26              (can be used multiple times). By default repoquery uses whatever
27              repositories are enabled in YUM configuration.
28
29       --enablerepo=<repo>
30              In  addition  to  the  default  set,  query the given additional
31              repository, even if it is disabled in YUM configuration.  Can be
32              used multiple times.
33
34       --disablerepo=<repo>
35              Do  not query the given repository, even if it is enabled in YUM
36              configuration.  Can be used multiple times.
37
38       --repofrompath=<repoid>,<path/url>
39              Specify a path or url  to  a  repository  (same  path  as  in  a
40              baseurl)  to add to the repositories for this query. This option
41              can be used multiple times. If you want to view  only  the  pkgs
42              from  this repository combine this with --repoid. The repoid for
43              the repository is specified by <repoid>.
44
45       --plugins
46              Enable YUM plugin support.
47
48       -q, --query
49              For rpmquery compatibility, doesn't do anything.
50
51       -h, --help
52              Help; display a help message and then quit.
53
54       --quiet
55              Run quietly: no warnings printed to stderr.
56
57       --verbose
58              Produce verbose output.
59
60       -C, --cache
61              Tells repoquery to run entirely from YUM cache - does not  down‐
62              load  any metadata or update the cache. Queries in this mode can
63              fail or give partial/incorrect results if the cache isn't  fully
64              populated beforehand with eg "yum makecache".
65
66       --tempcache
67              Create  and  use  a private cache instead of the main YUM cache.
68              This is used by default when run as non-root user.
69
70       -c <config file>, --config=<config file>
71              Use alternative config file (default is /etc/yum.conf).
72
73       --releasever=version
74              Pretend the current release version is the given string. This is
75              very  useful  when combined with --installroot. You can also use
76              --releasever=/ to take the releasever information  from  outside
77              the  installroot.  Note that with the default upstream cachedir,
78              of /var/cache/yum, using this option  will  corrupt  your  cache
79              (and  you  can use $releasever in your cachedir configuration to
80              stop this).
81
82       --installroot=root
83              Specifies an alternative  installroot,  relative  to  which  all
84              packages  will  be  installed.  Think of this like doing "chroot
85              <root> yum" except using --installroot allows yum to work before
86              the  chroot  is  created.   Note:  You  may also want to use the
87              option --releasever=/ when creating the installroot as otherwise
88              the  $releasever  value  is  taken  from  the  rpmdb  within the
89              installroot (and thus. will be empty, before creation).
90
91       --setopt=option=value
92              Set any config option in yum config or repo files.  For  options
93              in  the  global  config just use: --setopt=option=value for repo
94              options use: --setopt=repoid.option=value
95
96

PACKAGE QUERY OPTIONS

98       -i, --info
99              Show general information about package similarly to "rpm -qi"
100
101       -l, --list
102              List files in package.
103
104       -R, --requires
105              List package dependencies.
106
107       --resolve
108              When used with --requires, resolve capabilities  to  originating
109              packages.
110
111       --provides
112              List capabilities package provides.
113
114       --obsoletes
115              List capabilities obsoleted by package.
116
117       --conflicts
118              List capabilities conflicting with package.
119
120       --changelog
121              List package changelog.
122
123       --location
124              Show a location where the package could be downloaded from.  For
125              example: wget `repoquery --location yum`
126
127       -s, --source
128              Show package source RPM name.
129
130       --srpm Operate on corresponding source RPM.
131
132       --groupmember PACKAGE
133              List the repodata groups (yumgroups.xml) belongs to (if any).
134
135       --nvr  Use name-version-release output format (rpm query default)
136
137       --nevra
138              Use   name-epoch:version-release.architecture   output    format
139              (default)
140
141       --envra
142              Use  epoch:name-version-release.architecture output format (eas‐
143              ier to parse than nevra)
144
145       --qf=FORMAT, --queryformat=FORMAT
146              Specify custom output format for queries. You can  add  ":date",
147              ":day"  and  ":isodate" to all the tags that are a time, and you
148              can add ":k", ":m", ":g", ":t" and ":h" to sizes. You  can  also
149              specify field width as in sprintf (Eg. %-20{name})
150
151       --output [text|ascii-tree|dot-tree]
152              Output  format  which  can  be  used  with  --requires/--whatre‐
153              quires/--obsoletes/--conflicts.  Default output is 'text'.
154
155       --level [all|any int]
156              In combination with  --output  ascii-tree|dot-tree  this  option
157              specifies  the  number  of  level  to print on the tree. Default
158              level is 'all'.
159

PACKAGE SELECTION OPTIONS

161       -a, --all
162              Query all  available  packages  (for  rpmquery  compatibility  /
163              shorthand for repoquery '*')
164
165       --show-duplicates
166              Query all versions of packages.
167
168       -f, --file FILE
169              Query package owning FILE.
170
171       --whatobsoletes CAPABILITY
172              Query all packages that obsolete CAPABILITY.
173
174       --whatconflicts CAPABILITY
175              Query all packages that conflict with CAPABILITY.
176
177       --whatprovides CAPABILITY
178              Query all packages that provide CAPABILITY.
179
180       --whatrequires CAPABILITY
181              Query all packages that require CAPABILITY.
182
183       --alldeps
184              When  used  with --whatrequires, look for non-explicit dependen‐
185              cies in addition to explicit ones (e.g. files  and  Provides  in
186              addition to package names).  This is the default.
187
188       --exactdeps
189              When  used  with  --whatrequires,  search  for dependencies only
190              exactly  as  given.   This  is  effectively  the   opposite   of
191              --alldeps.
192
193       --recursive
194              When  used  with --whatrequires, and --requires --resolve, query
195              packages recursively.
196
197       --archlist=ARCH1[,ARCH2...]
198              Limit the query to packages of given architecture(s). Valid val‐
199              ues  are  all  architectures known to rpm/yum such as 'i386' and
200              'src' for source RPMS. Note that repoquery will now change yum's
201              "arch"   to  the  first  value  in  the  archlist.  So  "--arch‐
202              list=i386,i686" will change yum's canonical arch  to  i386,  but
203              allow packages of i386 and i686.
204
205       --pkgnarrow=WHAT
206              Limit  what  packages are considered for the query. Valid values
207              for WHAT are: installed, available, recent, updates, extras, all
208              and repository (default).
209
210       --installed
211              Restrict  query  ONLY to installed pkgs - disables all repos and
212              only acts on rpmdb.
213
214

GROUP QUERY OPTIONS

216       -i, --info
217              Show general information about group.
218
219       -l, --list
220              List packages belonging to (required by) group.
221
222       --grouppkgs=WHAT
223              Specify what type of packages are  queried  from  groups.  Valid
224              values for WHAT are all, mandatory, default, optional.
225
226       --requires
227              List groups required by group.
228

GROUP SELECTION OPTIONS

230       -a     Query all available groups.
231
232       -g, --group
233              Query groups instead of packages.
234

EXAMPLES

236       List all packages whose name contains 'perl':
237              repoquery '*perl*'
238
239       List all packages depending on openssl:
240              repoquery --whatrequires openssl
241
242       List  all  package names and the repository they come from, nicely for‐
243       matted:
244              repoquery -a --qf "%-20{repoid} %{name}"
245
246       List name and summary of all available updates (if any), nicely format‐
247       ted:
248              repoquery -a --pkgnarrow=updates --qf "%{name}:\n%{summary}\n"
249
250       List optional packages in base group:
251              repoquery -g --grouppkgs=optional -l base
252
253       List build requirements from 'anaconda' source rpm:
254              repoquery --requires anaconda.src
255
256       List packages which BuildRequire gail-devel
257              repoquery --archlist=src --whatrequires gail-devel
258                NB:  This  command  will  only  work  if you have repositories
259              enabled which include srpms.
260
261
262

MISC

264       Specifying package names
265              A package can be referred to in all queries with any of the fol‐
266              lowing:
267
268              name
269              name.arch
270              name-ver
271              name-ver-rel
272              name-ver-rel.arch
273              name-epoch:ver-rel.arch
274              epoch:name-ver-rel.arch
275
276              For example: repoquery -l kernel-2.4.1-10.i686
277              Additionally wildcards (shell-style globs) can be used.
278
279

FILES

281       As  repoquery uses YUM libraries for retrieving all the information, it
282       relies on YUM configuration for its default values like which reposito‐
283       ries to use. Consult YUM documentation for details:
284
285       /etc/yum.conf
286       /etc/yum/repos.d/
287       /var/cache/yum/
288
289

SEE ALSO

291       yum.conf (5)
292       http://yum.baseurl.org/
293
294

AUTHORS

296       See the Authors file included with this program.
297
298

BUGS

300       There  are of course no bugs, but should you find any, you should first
301       consult the  FAQ  section  on  http://yum.baseurl.org/wiki/Faq  and  if
302       unsuccessful  in  finding  a  resolution contact the mailing list: yum-
303       devel@lists.baseurl.org.  To file a bug use  http://bugzilla.redhat.com
304       for  Fedora/RHEL/Centos  related bugs and http://yum.baseurl.org/report
305       for all other bugs.
306
307
308
309
310Panu Matilainen                 17 October 2005                   repoquery(1)
Impressum