1/pod/urpmq.8.pod

=head1 NAME

urpmq - urpmi database query tool.

=head1 SYNOPSIS

    urpmq [options] [package_names | rpm_files...]

=head1 DESCRIPTION

urpmq is a tool to access and query the urpmi database. It can be used to
list available packages in the various urpmi media, or to list the full
dependencies of a package, or to list the packages that will be installed
if you start urpmi. The output of urpmq has the following format, adjusted
according to the command-line options that were used:

    [group/]package_name[-version][-release][.arch]

=head1 OPTIONS

=over

=item B<--help>

Prints a help message and exit (this is the same as B<-h> or B<-?>).

=item B<--list>

List available packages.

=item B<--list-media> [I<type>]

List available media. You can optionally add a type selector: B<all> to
list all media (the default), B<update> to list the update media, or
B<active> to list only active media.

=item B<--list-url>

List available media and their URLs.

=item B<--list-nodes>

List available nodes for parallel installation (when using B<--parallel>).

=item B<--list-aliases>

List available parallel aliases.

=item B<--update>

Use only update media. This means that urpmq will search and resolve
dependencies only in media marked as containing updates (e.g. which have
been created with C<urpmi.addmedia --update>).

=item B<--media> I<media1,...,mediaN>

Select specific media to be used, instead of defaulting
to all available media (or all update media if B<--update> is used).
No rpm will be found in other media.

=item B<--excludemedia> I<media1,...,mediaN>

Do not use the specified media.

=item B<--searchmedia> I<media>

Use only the specified media to search for packages that are specified on
the command-line, or which are found when using B<--auto-select>.
Dependencies of those packages can still be found in other media.

=item B<--sortmedia> I<media1,...,mediaN>

Sort the specified media. Substrings may be used to simplify grouping.
This way, C<media1> will be taken into account first, then C<media2>, and
so on. Media which aren't listed are taken into account after the others.

=item B<--synthesis> I<file>

Use the specified synthesis file instead of the urpmi database for
searching packages and resolving dependencies.

=item B<--auto-select>

Select all packages that can be upgraded, according to already installed
packages and packages listed in various registered media.

=item B<--auto-orphans>

List orphans.

=item B<--not-available>

List packages that are not available on any media. This can help to find
packages that are still installed but that are now obsolete because they
have been removed from the current version of Mandriva Linux.

=item B<--no-suggests>

With this option, urpmq will not require "suggested" packages. 
By default, urpmq will require (newly) suggested packages.

=item B<--allow-suggests>

With this option, urpmi will install "suggested" packages. 
This is useful if you have C<no-suggests> in urpmi.cfg.

=item B<--keep>

When some dependencies cannot be satisfied,
change the selection of packages to try to keep existing packages instead
of removing them. This behaviour generally rejects the upgrade of packages
given on command line (or when using B<--auto-select>) when a dependency error
occurs.

=item B<--fuzzy>

Disable fast search on exact package name; i.e. it will propose
all packages matching the name partially, even if one of them matches exactly
the specified name (this is the same as B<-y>).

=item B<--src> I<name>

Search a source package
matching I<name> and it will select all dependencies by default.

=item B<--sources>

Prints source URLs (or file names) of all selected
packages. (Can be used by the superuser only.)

=item B<--force>

Continue when requesting packages that are not available.

=item B<--ignorearch>

Allow to search packages whose architecture isn't compatible with the
architecture of the host.

=item B<--parallel> I<alias>

Activate distributed execution of urpmi to other machines (it is mandatory
that urpmi is installed but it is not necessary to have media defined on
any machines). I<alias> defines which extension module to use by urpmi
(currently urpmi-parallel-ka-run or urpmi-parallel-ssh) and which
machines should be updated, this alias is defined in the file
F</etc/urpmi/parallel.cfg> as described below.

=item B<--root> I<directory>

Use the file system tree rooted for rpm install. All operations and
scripts will run after chroot(2). The rpm database in the rooted tree
will be used but urpmi configuration comes from normal system.

=item B<--urpmi-root> I<directory>

Use the file system tree rooted for urpmi database and rpm install. Contrary
to B<--root>, the urpmi configuration comes from the rooted tree.

=item B<--wget>

Use wget for downloading distant files. By default curl
is used if available, or wget instead.

=item B<--curl>

Use curl for downloading distant files. By default curl is used if
available, or wget instead.

=item B<--curl-options> I<'options'>

=item B<--rsync-options> I<'options'>

=item B<--wget-options> I<'options'>

Specify additional command-line options to be passed to curl, rsync or
wget when retrieving files. If several options are to be passed, separate
them with spaces and enclose them in quotes.

Note that the rsync options will also be used for ssh media.

=item B<--proxy> I<proxyhost[:port|1080]>

Use specified HTTP proxy.

=item B<--proxy-user> I<user:password>

Use specified user and password to use for proxy authentication.
Specifying B<--proxy-user=ask> will cause urpmq to prompt for a username
and a password.

=item B<--use-distrib> I<directory>

Configure urpmq on the fly from a distribution tree.

=item B<--env> I<directory>

Use a different environment directly from a bug report to replay a bug.
The argument is the same argument given to B<--bug> option.

=item B<--skip> I<pattern,...>

You can specify a list of packages which installation should be skipped.
You can also include patterns between //, just like in
F</etc/urpmi/skip.list> (see urpmi.files(5)).

=item B<--prefer> I<pattern,...>

You can specify a list of packages which installation should be preferred
(especially useful with B<--auto>).
You can also include patterns between //, just like in
F</etc/urpmi/prefer.list> (see urpmi.files(5)).

=item B<--wait-lock>

If the urpmi or rpm db is busy, wait until it is available

=item B<--changelog>

Prints the package changelog.

=item B<--conflicts>

Prints the package conflicts.

=item B<--obsoletes>

Prints the package obsoletes.

=item B<--provides>

Prints the package provides.

=item B<--requires>

Prints the package requires.

=item B<--suggests>

Prints the package suggests.

=item B<--sourcerpm>

Prints the sourcerpm of the package

=item B<--summary>

Prints concise information about the package.

=item B<--verbose>

Activate verbose mode.

=item B<-v>

This is the same as B<--verbose>.

=item B<-d>

This is the same as B<--requires-recursive>.

=item B<-u>

Deselect packages if a better version is already installed.

=item B<-m>

Equivalent to B<-du>.

=item B<-a>

Select all matches on command line; that's useful when one gives an
incomplete package name and when using B<-f> or B<-r>.

=item B<-c>

If maximal closure is used, assume that a package listed may have wrong or
not up-to-date dependencies. This causes more packages to be upgraded and
may correct unresolved dependencies on the rpm database.

=item B<--requires-recursive>

Print dependencies (maximal closure).

=item B<--whatprovides>

Search in provides to find package.

=item B<--whatrequires>

Reverse search to what requires the package given.

=item B<--whatrequires-recursive>

Reverse search to what requires recursively the package given
(looking through virtual packages).

=item B<-S>

Same as B<--summary>.

=item B<-y>

This is the same as B<--fuzzy>.

=item B<-Y>

Like B<-y>, but forces to match case-insensitively.

=item B<-s>

This is the same as B<--src>.

=item B<-p>

This is the same as B<--whatprovides>.

=item B<-i>

Prints useful information in human readable form, as for I<rpm -qi>.

=item B<-g>

Prints groups of each package listed.

=item B<-r>

Prints also version and release of each package listed.

=item B<-f>

Prints also version, release and arch of each package listed.

=item B<-l>

Lists files in packages.

=back

=head1 FILES

See urpmi.files(5).

=head1 SEE ALSO

urpmi.addmedia(8), urpmi.update(8), urpmi.removemedia(8), urpmf(8),
urpmi(8), urpmi.files(5).

=head1 AUTHOR

Pascal Rigaux <pixel@mandriva.com> (original author and current maintainer), 
FranE<ccedil>ois Pons, Rafael Garcia-Suarez 
1	=head1 NAME
2
3	urpmq - urpmi database query tool.
4
5	=head1 SYNOPSIS
6
7	urpmq [options] [package_names \| rpm_files...]
8
9	=head1 DESCRIPTION
10
11	urpmq is a tool to access and query the urpmi database. It can be used to
12	list available packages in the various urpmi media, or to list the full
13	dependencies of a package, or to list the packages that will be installed
14	if you start urpmi. The output of urpmq has the following format, adjusted
15	according to the command-line options that were used:
16
17	[group/]package_name[-version][-release][.arch]
18
19	=head1 OPTIONS
20
21	=over
22
23	=item B<--help>
24
25	Prints a help message and exit (this is the same as B<-h> or B<-?>).
26
27	=item B<--list>
28
29	List available packages.
30
31	=item B<--list-media> [I<type>]
32
33	List available media. You can optionally add a type selector: B<all> to
34	list all media (the default), B<update> to list the update media, or
35	B<active> to list only active media.
36
37	=item B<--list-url>
38
39	List available media and their URLs.
40
41	=item B<--list-nodes>
42
43	List available nodes for parallel installation (when using B<--parallel>).
44
45	=item B<--list-aliases>
46
47	List available parallel aliases.
48
49	=item B<--update>
50
51	Use only update media. This means that urpmq will search and resolve
52	dependencies only in media marked as containing updates (e.g. which have
53	been created with C<urpmi.addmedia --update>).
54
55	=item B<--media> I<media1,...,mediaN>
56
57	Select specific media to be used, instead of defaulting
58	to all available media (or all update media if B<--update> is used).
59	No rpm will be found in other media.
60
61	=item B<--excludemedia> I<media1,...,mediaN>
62
63	Do not use the specified media.
64
65	=item B<--searchmedia> I<media>
66
67	Use only the specified media to search for packages that are specified on
68	the command-line, or which are found when using B<--auto-select>.
69	Dependencies of those packages can still be found in other media.
70
71	=item B<--sortmedia> I<media1,...,mediaN>
72
73	Sort the specified media. Substrings may be used to simplify grouping.
74	This way, C<media1> will be taken into account first, then C<media2>, and
75	so on. Media which aren't listed are taken into account after the others.
76
77	=item B<--synthesis> I<file>
78
79	Use the specified synthesis file instead of the urpmi database for
80	searching packages and resolving dependencies.
81
82	=item B<--auto-select>
83
84	Select all packages that can be upgraded, according to already installed
85	packages and packages listed in various registered media.
86
87	=item B<--auto-orphans>
88
89	List orphans.
90
91	=item B<--not-available>
92
93	List packages that are not available on any media. This can help to find
94	packages that are still installed but that are now obsolete because they
95	have been removed from the current version of Mandriva Linux.
96
97	=item B<--no-suggests>
98
99	With this option, urpmq will not require "suggested" packages.
100	By default, urpmq will require (newly) suggested packages.
101
102	=item B<--allow-suggests>
103
104	With this option, urpmi will install "suggested" packages.
105	This is useful if you have C<no-suggests> in urpmi.cfg.
106
107	=item B<--keep>
108
109	When some dependencies cannot be satisfied,
110	change the selection of packages to try to keep existing packages instead
111	of removing them. This behaviour generally rejects the upgrade of packages
112	given on command line (or when using B<--auto-select>) when a dependency error
113	occurs.
114
115	=item B<--fuzzy>
116
117	Disable fast search on exact package name; i.e. it will propose
118	all packages matching the name partially, even if one of them matches exactly
119	the specified name (this is the same as B<-y>).
120
121	=item B<--src> I<name>
122
123	Search a source package
124	matching I<name> and it will select all dependencies by default.
125
126	=item B<--sources>
127
128	Prints source URLs (or file names) of all selected
129	packages. (Can be used by the superuser only.)
130
131	=item B<--force>
132
133	Continue when requesting packages that are not available.
134
135	=item B<--ignorearch>
136
137	Allow to search packages whose architecture isn't compatible with the
138	architecture of the host.
139
140	=item B<--parallel> I<alias>
141
142	Activate distributed execution of urpmi to other machines (it is mandatory
143	that urpmi is installed but it is not necessary to have media defined on
144	any machines). I<alias> defines which extension module to use by urpmi
145	(currently urpmi-parallel-ka-run or urpmi-parallel-ssh) and which
146	machines should be updated, this alias is defined in the file
147	F</etc/urpmi/parallel.cfg> as described below.
148
149	=item B<--root> I<directory>
150
151	Use the file system tree rooted for rpm install. All operations and
152	scripts will run after chroot(2). The rpm database in the rooted tree
153	will be used but urpmi configuration comes from normal system.
154
155	=item B<--urpmi-root> I<directory>
156
157	Use the file system tree rooted for urpmi database and rpm install. Contrary
158	to B<--root>, the urpmi configuration comes from the rooted tree.
159
160	=item B<--wget>
161
162	Use wget for downloading distant files. By default curl
163	is used if available, or wget instead.
164
165	=item B<--curl>
166
167	Use curl for downloading distant files. By default curl is used if
168	available, or wget instead.
169
170	=item B<--curl-options> I<'options'>
171
172	=item B<--rsync-options> I<'options'>
173
174	=item B<--wget-options> I<'options'>
175
176	Specify additional command-line options to be passed to curl, rsync or
177	wget when retrieving files. If several options are to be passed, separate
178	them with spaces and enclose them in quotes.
179
180	Note that the rsync options will also be used for ssh media.
181
182	=item B<--proxy> I<proxyhost[:port\|1080]>
183
184	Use specified HTTP proxy.
185
186	=item B<--proxy-user> I<user:password>
187
188	Use specified user and password to use for proxy authentication.
189	Specifying B<--proxy-user=ask> will cause urpmq to prompt for a username
190	and a password.
191
192	=item B<--use-distrib> I<directory>
193
194	Configure urpmq on the fly from a distribution tree.
195
196	=item B<--env> I<directory>
197
198	Use a different environment directly from a bug report to replay a bug.
199	The argument is the same argument given to B<--bug> option.
200
201	=item B<--skip> I<pattern,...>
202
203	You can specify a list of packages which installation should be skipped.
204	You can also include patterns between //, just like in
205	F</etc/urpmi/skip.list> (see urpmi.files(5)).
206
207	=item B<--prefer> I<pattern,...>
208
209	You can specify a list of packages which installation should be preferred
210	(especially useful with B<--auto>).
211	You can also include patterns between //, just like in
212	F</etc/urpmi/prefer.list> (see urpmi.files(5)).
213
214	=item B<--wait-lock>
215
216	If the urpmi or rpm db is busy, wait until it is available
217
218	=item B<--changelog>
219
220	Prints the package changelog.
221
222	=item B<--conflicts>
223
224	Prints the package conflicts.
225
226	=item B<--obsoletes>
227
228	Prints the package obsoletes.
229
230	=item B<--provides>
231
232	Prints the package provides.
233
234	=item B<--requires>
235
236	Prints the package requires.
237
238	=item B<--suggests>
239
240	Prints the package suggests.
241
242	=item B<--sourcerpm>
243
244	Prints the sourcerpm of the package
245
246	=item B<--summary>
247
248	Prints concise information about the package.
249
250	=item B<--verbose>
251
252	Activate verbose mode.
253
254	=item B<-v>
255
256	This is the same as B<--verbose>.
257
258	=item B<-d>
259
260	This is the same as B<--requires-recursive>.
261
262	=item B<-u>
263
264	Deselect packages if a better version is already installed.
265
266	=item B<-m>
267
268	Equivalent to B<-du>.
269
270	=item B<-a>
271
272	Select all matches on command line; that's useful when one gives an
273	incomplete package name and when using B<-f> or B<-r>.
274
275	=item B<-c>
276
277	If maximal closure is used, assume that a package listed may have wrong or
278	not up-to-date dependencies. This causes more packages to be upgraded and
279	may correct unresolved dependencies on the rpm database.
280
281	=item B<--requires-recursive>
282
283	Print dependencies (maximal closure).
284
285	=item B<--whatprovides>
286
287	Search in provides to find package.
288
289	=item B<--whatrequires>
290
291	Reverse search to what requires the package given.
292
293	=item B<--whatrequires-recursive>
294
295	Reverse search to what requires recursively the package given
296	(looking through virtual packages).
297
298	=item B<-S>
299
300	Same as B<--summary>.
301
302	=item B<-y>
303
304	This is the same as B<--fuzzy>.
305
306	=item B<-Y>
307
308	Like B<-y>, but forces to match case-insensitively.
309
310	=item B<-s>
311
312	This is the same as B<--src>.
313
314	=item B<-p>
315
316	This is the same as B<--whatprovides>.
317
318	=item B<-i>
319
320	Prints useful information in human readable form, as for I<rpm -qi>.
321
322	=item B<-g>
323
324	Prints groups of each package listed.
325
326	=item B<-r>
327
328	Prints also version and release of each package listed.
329
330	=item B<-f>
331
332	Prints also version, release and arch of each package listed.
333
334	=item B<-l>
335
336	Lists files in packages.
337
338	=back
339
340	=head1 FILES
341
342	See urpmi.files(5).
343
344	=head1 SEE ALSO
345
346	urpmi.addmedia(8), urpmi.update(8), urpmi.removemedia(8), urpmf(8),
347	urpmi(8), urpmi.files(5).
348
349	=head1 AUTHOR
350
351	Pascal Rigaux <pixel@mandriva.com> (original author and current maintainer),
352	FranE<ccedil>ois Pons, Rafael Garcia-Suarez