URPMI(1) Mageia Package Management URPMI(1)NAMEurpmi - rpm downloader, installer and dependency solver
SYNOPSISurpmi [options] [package_names | rpm_files...]
urpmi [options] --auto-select
DESCRIPTION
The purpose of urpmi is to install rpm packages, including all their
dependencies. You can also use it to install the build dependencies of
an srpm (an rpm source package), or the build dependencies read from a
plain rpm spec file; or to install a source package itself in order to
rebuild it afterwards.
You can compare rpm vs. urpmi with insmod vs. modprobe or dpkg vs apt-
get. Just run urpmi followed by what you think is the name of the
package(s), and urpmi will:
· Propose different package names if the name was ambiguous, and
quit.
· If only one corresponding package is found, check whether its
dependencies are already installed.
· If not, propose to install the dependencies, and on a positive
answer, proceed.
· Finish by installing the requested package(s).
Note that urpmi handles installations from various types of media (ftp,
http, https, rsync, ssh, local and nfs volumes, and removable media
such as CDROMs or DVDs) and is able to install dependencies from a
medium different from the original package's media. For removable
media, urpmi may ask you to insert the appropriate disk, if necessary.
To add a new medium containing rpms, run "urpmi.addmedia". To remove an
existing medium, use "urpmi.removemedia". To update the package list
(for example when the ftp archive changes) use "urpmi.update".
OPTIONS--help
Prints a help message and exit (this is the same as -h or -?).
--media media1,...,mediaN
Select specific media to be used, instead of defaulting to all
available media (or all update media if --update is used). No rpm
will be fetched from other media.
--excludemedia media1,...,mediaN
Do not use the specified media.
--searchmedia media1,...,mediaN
Use only the specified media to search for packages that are
specified on the command-line, or which are found when using
--auto-select. Dependencies of those packages can still be found
in other media.
--sortmedia media1,...,mediaN
Sort the specified media. Substrings may be used to simplify
grouping. This way, "media1" will be taken into account first,
then "media2", and so on. Media which aren't listed are taken into
account after the others.
--update
Use only update media. This means that urpmi will search packages
and resolve dependencies only in media marked as containing
updates.
--synthesis file
Use the specified synthesis file instead of the urpmi database for
searching packages and resolving dependencies. This option is
mostly designed for internal use.
--auto
Install all required dependencies without asking.
--auto-select
Select all packages that can be upgraded, according to already
installed packages and packages listed in various registered media.
--auto-update
Like --auto-select, but also updates all relevant media before
selection of upgradeable packages is made. This avoids a previous
call to "urpmi.update".
--auto-orphans
Remove all orphans without asking (see also "urpme --auto-orphans")
--no-md5sum
Disable MD5SUM file checking when updating media.
--force-key
Force update of GPG key when updating media.
--no-install
Only download packages, don't install them. After operation, you'll
find them in /var/cache/urpmi/rpms.
--no-uninstall
Never ask to uninstall a package but prefer aborting instead. This
can be safer in auto mode.
--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 --auto-select) when a dependency error
occurs.
--split-level number
Split urpmi's operation in small transactions when the total number
of packages to upgrade is greater than the given number. This
option is activated by default, and the default value of number is
20.
--split-length count
Split urpmi's operation in small transactions of at least count
packages. The default is 8 and setting this value to 0 just
disables splitting in small transactions.
--fuzzy
Disable fast search on exact package name; that means that urpmi
will propose all packages matching part of the name, even if one of
them matches exactly the specified name (this is the same as -y).
--buildrequires
Select all the "BuildRequires" of the wanted source packages. (You
can also install the build dependencies read directly from an rpm
spec file.)
--install-src
Install only the source package (that is, no binary packages will
be installed). You don't need to be root to use this option (if you
have write access to your rpm build top directory).
--clean
Remove all packages from the cache in directory
/var/cache/urpmi/rpms.
--noclean
Do not remove any package from the cache in directory
/var/cache/urpmi/rpms.
--force
Assume yes on all questions.
--quiet
Quiet mode: when calling rpm no upgrade status is printed.
--verbose
Proposes a verbose mode with various messages.
--debug
Proposes a very verbose mode.
--debug-librpm
Proposes a very verbose mode (similar to rpm -vv)
--deploops
Print warnings when packages cannot be ordered properly due to
dependancy loops.
--no-suggests
With this option, urpmi will not install "suggested" packages. By
default, urpmi will install (newly) suggested packages.
--allow-suggests
With this option, urpmi will install "suggested" packages. This is
useful if you have "no-suggests" in urpmi.cfg.
--justdb
Update only the database, not the filesystem.
--downgrade
Force installing the packages even though they are already
installed.
--replacepkgs
Force installing the packages even though they are already
installed.
--allow-nodeps
With this option, urpmi will ask the user on error whether it
should continue the installation without checking dependencies. By
default, urpmi exits immediately in this case.
--allow-force
With this option, urpmi will ask the user on error whether it
should proceed to a forced installation. By default, urpmi exits
immediately in this case.
--allow-medium-change
When used when --auto, do not suppress all questions, but still ask
the user for medium changes (e.g. insertion of CD-ROMs).
--parallel 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). alias defines which extension
module is to be used by urpmi (currently, "urpmi-parallel-ka-run"
or "urpmi-parallel-ssh" are available) and which machines should be
updated. This alias is defined in the file /etc/urpmi/parallel.cfg
as described in the urpmi.files manpage.
--root directory
Use the file system tree rooted for rpm install. All operations and
scripts will run after chroot(2). The rpm database that lies in the
rooted tree will be used, but the urpmi configuration comes from
the normal system.
--urpmi-root directory
Use the file system tree rooted for urpmi database and rpm install.
Contrary to --root, the urpmi configuration comes from the rooted
tree.
--use-distrib directory
Configure urpmi on the fly from a distrib tree, useful to install a
chroot with the --root option. See the description of the --distrib
option in the "urpmi.addmedia" manpage.
--download-all dest-dir
By default, urpmi will download packages when they are needed. This
can be problematic when connection failures happen during a big
upgrade. When this option is set, urpmi will first download all the
needed packages and proceed to install them if it managed to
download them all. You can optionally specify a directory where the
files should be downloaded (default is /var/cache/urpmi which could
be too small to hold all the files).
--downloader program name
Use a specific program for downloading distant files via http or
ftp. By default curl is used if available, or wget instead.
--curl-options 'options'
--rsync-options 'options'
--wget-options '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 (since
it's actually rsync over ssh).
--limit-rate rate
Try to limit the download speed. rate is given in bytes/sec. This
option is not active by default.
--resume
Resume transfer of partially-downloaded files.
--retry times
Retries to download files over FTP or HTTP the specified number of
times.
--proxy proxyhost[:port]
Use specified HTTP proxy.
--proxy-user user:password
Use specified user and password to use for proxy authentication.
Specifying --proxy-user=ask will cause urpmi to prompt for a
username and a password.
--bug directory
Create a bug report in directory. You have to send a compressed
archive of the directory to the urpmi maintainer for the bug being
(probably) reproduced. See "BUG REPORTS" below.
--env directory
Use a different environment directly from a bug report to replay a
bug. The argument is the same argument given to --bug option.
--verify-rpm
--no-verify-rpm
Activate or deactivate rpm signature checking. It's activated by
default, and can be overriden in global configuration.
--test
Test the installation of packages but do not actually install
anything or modify the system. (That's the same as "rpm --test").
--excludepath string
Do not install files of which the names begin with the given string
(same as "rpm --excludepath").
--excludedocs
Do not install documents files (same as "rpm --excludedocs").
--ignorearch
Allow to install packages whose architecture does not match the
architecture of the host. This is equivalent to "rpm --ignorearch".
--ignoresize
Don't check file systems for sufficient disk space before
installation. This is equivalent to "rpm --ignoresize".
--noscripts
Don't execute the scriptlets. This is equivalent to "rpm
--noscripts".
--replacefiles
Ignore file conflicts. This is equivalent to "rpm --replacefiles".
--skip pattern,...
You can specify a list of packages which installation should be
skipped. You can also include patterns between //, just like in
/etc/urpmi/skip.list (see urpmi.files(5)).
--prefer pattern,...
You can specify a list of packages which installation should be
preferred (especially useful with --auto). You can also include
patterns between //, just like in /etc/urpmi/prefer.list (see
urpmi.files(5)).
--more-choices
When several packages are found, propose more choices than the
default.
--nolock
Don't lock urpmi and rpm db. This can be useful in conjunction with
--root.
--wait-lock
If the urpmi or rpm db is busy, wait until it is available
--strict-arch
Upgrade only packages if the newer version has the same
architecture as the one installed. Mostly useful on machines that
support several architectures (32 and 64 bit).
-a If multiple packages match the given substring, install them all.
-p Allow search in provides to find the package (this is the default).
-P Do not search in provides to find package (this is the opposite of
-p).
-y This is the same as --fuzzy.
-q This is the same as --quiet.
-v This is the same as --verbose.
EXAMPLESurpmi ssh://foo@bar.net/home/foo/test.rpm
Fetch /home/foo/test.rpm from server bar.net over ssh using user foo.
You can use a public key or enter your password.
urpmi--media foo- --auto-select
Fetch all the updates from media containing "foo-" in their name.
FILES
See urpmi.files(5).
EXIT CODES
1. Command line inconsistency.
2. Problem registering local packages.
3. Source packages not retrievable.
4. Medium is not selected.
5. Medium already exists.
6. Unable to save configuration.
7. urpmi database locked.
8. Unable to read or create bug report.
9. Unable to open rpmdb.
10. Some files are missing for installation.
11. Some transactions failed but not all.
12. All transactions failed.
13. Some files are missing and some transactions failed but not all.
14. Some files are missing and all transactions failed.
15. No package installed (when using --expect-install)
16. Bad signature
17. Some packages couldn't be installed or upgraded
BUG REPORTS
If you find a bug in urpmi please report it using the command :
urpmi--bug bug_name_as_directory <other arguments>
This will automatically create a directory called bug_name_as_directory
containing necessary files to reproduce it if possible. <other
arguments> represent the command-line arguments you noticed the bug
with (e.g. "--auto-select" or a list of rpm names). Please test the
report using
urpmi--env bug_name_as_directory <other arguments>
to check that the bug is still here. Obviously, only reproducible bugs
can be resolved. For sending the report, make a tarball of this
directory and send it directly to the current maintainer with a
description of what you think is wrong.
AUTHOR
Pascal Rigaux <pixel@mandriva.com> (original author and current
maintainer), Francois Pons, Rafael Garcia-Suarez
SEE ALSOurpmi.addmedia(8), urpmi.update(8), urpmi.removemedia(8), urpme(8),
urpmf(8), urpmq(8), urpmi.cfg(5), urpmi.files(5).
Mageia Linux 2013-11-05 URPMI(1)
