.TH urpmf 8 "07 Jan 2003" "MandrakeSoft" "Mandrake Linux"
.IX urpmf
.SH NAME
urpmf \- RPMFind - Finds the RPM package providing the specified file
.SH SYNOPSIS
.B urpmf [\fIoptions\fP] <\fIpattern\fP>
.SH DESCRIPTION
urpmf outputs a list of packages providing the file specified as an argument.
.PP
\fIpattern\fP is the name or part of the name of the file you wish to know which
packages are providing it. \fBurpmf\fP will then print a list of matching files
with their corresponding packages.
.PP
Using options you may search though other packages parameters.
\fBurpmf\fP searches through installed and uninstalled packages.
.SH OPTIONS
.IP "\fB\--help\fP"
print an help message and exit.
.IP "\fB\--update\fP"
Use only update media. This means \fBurpmi\fP will search and resolve
dependencies only in media marked as update.
.IP "\fB\--media\fP \fImedium1,...,mediumN\fP"
Select specific media to use instead of all media available (or update media is
\fB--update\fP is used).
.IP "\fB\--synthesis\fP \fIfile\fP"
Use the given synthesis\fIfile\fP instead of urpmi db for searching packages and
resolving dependencies.
.IP "\fB\--verbose\fP"
Proposes a verbose mode with various messages.
.IP "\fB\--quiet\fP"
Do not print tag name (default if no tag given on command line, incompatible
with interactive mode).
.IP "\fB\--all\fP"
Searches through all parameters listed below.
.IP "\fB\--group\fP"
Searches through group.
.IP "\fB\--size\fP"
Searches through size.
.IP "\fB\--epoch\fP"
Searches through epoch.
.IP "\fB\--summary\fP"
Searches through summary.
.IP "\fB\--description\fP"
Searches through description.
.IP "\fB\--provides\fP"
Searches through provides.
.IP "\fB\--requires\fP"
Searches through requires.
.IP "\fB\--files\fP"
Searches through files, this is the default.
.IP "\fB\--conflicts\fP"
Searches through conflicts.
.IP "\fB\--obsoletes\fP"
Searches through obsoletes.
.IP "\fB-c\fP"
Ignore case distinctions in any patterns.
.IP "\fB-f\fP"
Print version, release and arch along with name of package.
.IP "\fB-e\fP"
Include code directly in generated perl expression. Use it with \fB--verbose\fP
to look at perl code generated. But in any cases, use it only if you know perl.
.IP "\fB-a\fP"
Binary AND operator, true if both expression are true.
.IP "\fB-o\fP"
Binary OR operator, true if one expression is true.
.IP "\fB!\fP"
Unary NOT, true if expression is false.
.IP "\fB(\fP"
Left parenthesis to open group expression.
.IP "\fB)\fP"
Right parenthesis to close group expression.
.SH FILES
.de FN
\fI\|\\$1\|\fP
..
.TP
.FN /usr/bin/urpmf
The \fBurpmf\fP executable (perl script).
.TP
.FN /var/lib/urpmi/list.*
Contains the list of all packages known by urpmi and their location only
if a password is used to access distant location (using network protocol) or
various directory are used to store packages.
.TP
.FN /var/lib/urpmi/hdlist.*
Contains information about all known packages, it's a summary of rpm headers.
If an hdlist file is used for a medium \fBurpmf\fP can operate completely which
is almost always the case (please refer to \fBurpmf\fP man page for more
informations on this topic).
.TP
.FN /var/lib/urpmi/synthesis.hdlist.*
Contains synthesis information about all known packages built from hdlist files
that can be used by minimal closure algorithm. If these files are not present
hdlist files will be used instead but this is much slower.
.TP
.FN /etc/urpmi/urpmi.cfg
Contains media description, previous format from older urpmi is still accepted.
.TP
.FN /etc/urpmi/parallel.cfg
Contains parallel alias description, format is
\fB<alias>:<interface[(media)]>:<interface_parameter>\fP where \fB<alias>\fP is
a symbolic name, \fB<interface>\fP can be \fBka-run\fP or \fBssh\fP,
\fB<media>\fP is a media list (as \fB--media\fP parameter),
\fB<interface_parameter>\fP is a specific interface parameter list like "-c ssh
-m node1 -m node2" for \fBka-run\fP extension or "node1:node2" for \fBssh\fP
extension.
.TP
.FN /etc/urpmi/skip.list
Contains package expressions that should not be automatically updated. The
format is a list of provide of package (or regular expression if bounded by
slashes \fB/\fP) with optional operator and version string, or regular
expression to match the fullname of packages too.
.TP
.FN /etc/urpmi/inst.list
Contains package names that should be installed instead of updated.
.SH "SEE ALSO"
\fIurpmi.addmedia\fP(8),
\fIurpmi.update\fP(8),
\fIurpmi.removemedia\fP(8),
\fIgurpmi\fP(8),
\fIurpmi\fP(8),
\fIurpmq\fP(8),
\fIrpmdrake\fP(8)
.SH AUTHOR
Pascal Rigaux, Mandrakesoft <pixel@mandrakesoft.com> (original author)
.PP
Francois Pons, Mandrakesoft <fpons@mandrakesoft.com> (current author)