.TH urpmq 8 "4 Nov 2005" "Mandriva" "Mandriva Linux"
.IX urpmq
.SH NAME
urpmq \- urpmi database query tool.
.SH SYNOPSIS
.B urpmq [\fIoptions\fP] [\fIpackage_names\fP | \fIrpm_files...\fP]
.SH 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.
.PP
The output of urpmq has the following format, adjusted according to the
command-line options that were used:
.IP
[group/]package_name[-version][-release][.arch]
.PP
.SH OPTIONS
.IP "\fB\--help\fP"
Prints a help message and exit (this is the same as \fB-h\fP or \fB-?\fP).
.IP "\fB\--list\fP"
List available packages.
.IP "\fB\--list-media\fP [\fItype\fP]"
List available media. You can optionally add a type selector: \fBall\fP to list
all media (the default), \fBupdate\fP to list the update media, or \fBactive\fP
to list only active media.
.IP "\fB\--list-url\fP"
List available media and their URLs.
.IP "\fB\--list-nodes\fP"
List available nodes when using \fB--parallel\fP.
.IP "\fB\--list-aliases\fP"
List available parallel aliases.
.IP "\fB\--update\fP"
Use only update media. This means that \fBurpmq\fP will search and resolve
dependencies only in media marked as containing updates.
.IP "\fB\--media\fP \fImedia1,...,mediaN\fP"
Select specific media to be used, instead of all available media (or update
media if \fB--update\fP is used).
.IP "\fB\--excludemedia\fP \fImedia1,...,mediaN\fP"
Do not use the specified media.
.IP "\fB\--searchmedia\fP \fImedia\fP"
Use only the specified medium to search for packages when combined with
\fB\--auto-select\fP.
.IP "\fB\--sortmedia\fP \fImedia1,...,mediaN\fP"
Sort the specified media. Substrings may be used to simplify grouping.
.IP "\fB\--synthesis\fP \fIfile\fP"
Use the specified synthesis file instead of the urpmi database for
searching packages and resolving dependencies.
.IP "\fB\--auto-select\fP"
Automatically select all packages that have to be upgraded, according to already
installed packages and packages listed in various registered media.
.IP "\fB\--keep\fP"
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
\fB--auto-select\fP) when a dependency error occurs.
.IP "\fB\--fuzzy\fP"
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 \fB\-y\fP).
.IP "\fB\--src\fP \fIname\fP"
Search a source package matching \fIname\fP and it will select all
dependencies by default.
.IP "\fB\--headers\fP"
Extract and dump headers of selected packages to standard output.
(Can be used by the superuser only.)
.IP "\fB\--sources\fP"
Prints source URLs (or file names) of all selected packages.
(Can be used by the superuser only.)
.IP "\fB\--force\fP"
Continue when requesting packages that are not available.
.IP "\fB\--parallel\fP \fIalias\fP"
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). \fIalias\fP defines which extension module to use by urpmi (currently
\fBurpmi-parallel-ka-run\fP or \fBurpmi-parallel-ssh\fP) and which machines
should be updated, this alias is defined in the file /etc/urpmi/parallel.cfg as
described below.
.IP "\fB\--root\fP \fIdirectory\fP"
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.
.IP "\fB\--wget\fP"
Use wget only for downloading distant files. By default curl is used if
available or wget instead.
.IP "\fB\--curl\fP"
Use curl only for downloading distant files. By default curl is used if
available or wget instead.
.IP "\fB\--proxy\fP \fIproxyhost[:port|1080]\fP"
Use specified HTTP proxy.
.IP "\fB\--proxy-user\fP \fIuser:password\fP"
Use specified user and password to use for proxy authentication.
Specifying \fB\--proxy-user=ask\fP will cause urpmq to prompt for a username
and a password.
.IP "\fB\--use-distrib\fP \fIdirectory\fP"
Configure urpmq on the fly from a distrib tree. You must be root to use this
option.
.IP "\fB\--env\fP \fIdirectory\fP"
Use a different environment directly from a bug report to replay a bug. The
argument is the same argument given to \fB--bug\fP option.
.IP "\fB\--changelog\fP"
Prints the package changelog.
.IP "\fB\--summary\fP"
Prints concise information about the package.
.IP "\fB\-v\fP"
Activate verbose mode.
.IP "\fB\-d\fP"
Select dependencies (maximal closure).
.IP "\fB\-u\fP"
Deselect packages if a better version is already installed, this option can be
used with \fB-d\fP to simulate \fB-M\fP mode of \fBurpmi\fP.
.IP "\fB\-a\fP"
Select all matches on command line, useful when using \fB-f\fP or \fB-r\fP with
incomplete name given.
.IP "\fB\-c\fP"
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.
.IP "\fB\-p\fP"
Search in provides to find package (this is the opposite of \fB-P\fP).
.IP "\fB\-P\fP"
Do not search in provides to find package (this is the opposite of \fB-p\fP and
is the default).
.IP "\fB\-R\fP"
Reverse search to what requires the package given. If you specify this option
twice, looks also through virtual packages to find the dependencies.
.IP "\fB\-S\fP"
Same as \fB--summary\fP.
.IP "\fB\-y\fP"
This is the same as \fB--fuzzy\fP.
.IP "\fB\-Y\fP"
Like \fB-y\fP, but forces to match case-insensitively.
.IP "\fB\-s\fP" \fIname\fP"
This is the same as \fB--src\fP.
.IP "\fB\-i\fP"
Prints useful information in human readable form, as for \fIrpm -qi\fP.
.IP "\fB\-g\fP"
Prints groups of each package listed.
.IP "\fB\-r\fP"
Prints version and release of each package listed.
.IP "\fB\-f\fP"
Prints version, release and arch of each package listed.
.SH FILES
See \fIurpmi.files\fP(5).
.SH SEE ALSO
\fIurpmi.addmedia\fP(8),
\fIurpmi.update\fP(8),
\fIurpmi.removemedia\fP(8),
\fIurpmf\fP(8),
\fIurpmi\fP(8),
\fIurpmi.files\fP(5).
.SH AUTHOR
Pascal Rigaux (original author),
Francois Pons,
Rafael Garcia-Suarez, 
(current maintainer)