URPMI.CFG(1) Mageia Package Management URPMI.CFG(1)NAMEurpmi.cfg - urpmi option and media configuration file format
DESCRIPTION
The urpmi.cfg file is divided in multiple sections: one section to set
global options, and one section per media.
GLOBAL OPTIONS
Some global options can be activated by default. The following sample
shows how to disable signature checking and avoid transaction splits :
{
no-verify-rpm
split-length: 0
}
The following options can be written in this section :
allow-force
Same as specifying --allow-force for urpmi. Disabled by default.
allow-nodeps
Same as specifying --allow-nodeps for urpmi. Disabled by default.
xml-info
For remote media, specify when files.xml.lzma, changelog.xml.lzma
and info.xml.lzma are downloaded:
never
on-demand
(This is the default).
The specific xml info file is downloaded when
urpmq/urpmf/rpmdrake ask for it. urpmi.update will remove
outdated xml info file.
nb: if urpmq/urpmf/rpmdrake is not run by root, the xml info
file is downloaded into /tmp/.urpmi-<uid>/
update-only
urpmi.update will update xml info files already required at
least once by urpmq/urpmf/rpmdrake.
nb: with update-only, urpmi.update will not update
/tmp/.urpmi-<uid>/ xml info files
always
all xml info files are downloaded when doing urpmi.addmedia and
urpmi.update
no-suggests
Same as specifying --no-suggests for urpmi. Disabled by default.
auto
Same as specifying --auto for urpmi. Disabled by default.
compress
Deprecated (use rsync-options)
curl-options
Additional options to pass to curl's command line when downloading
files.
default-media
A comma-separated list of media names. By default, only those media
will be taken into account (that is, when you don't specify an
alternate list of media via the --media command-line option.)
disable-certificate-check
Disables checking of certificates when connecting to a https
medium. By default the certificates are checked and the connection
will fail if the certificate is invalid. This option shouldn't be
used for maximum security.
download-all
Same as --download-all option for urpmi: downloads all packages
before installing into the specified directory. If you want to use
the default location, assign an empty string to it (WARNING! "yes"
or "1" are NOT the options you really want to use here!)
downloader
Specify which download program to use: wget or curl.
excludedocs
Same as specifying --excludedocs for urpmi. Disabled by default.
excludepath
Same as --excludepath for urpmi. This options allows to give a
comma separated list of paths to be excluded on installation. There
is no path exclusion by default.
fuzzy
Same as --fuzzy for urpmi or urpmq. Enable or disable fuzzy search.
Disabled by default. Enabling it can be written in various ways :
"fuzzy" or "fuzzy: yes" or "fuzzy: on" or "fuzzy: 1".
keep
Same as --keep for urpmi or urpmq.
key-ids
This option is not available on the command line. It allows to use
a comma separated list of key ids to be globally accepted (keys
still need to be authorized by rpm) for any medium unless a
specific key-ids option for this medium is given. There is no
default (even Mageia public key id 70771ff3 is not included by
default).
ignoresize
Don't check file systems for sufficient disk space before
installation. Same as specifying --ignoresize for urpmi. Disabled
by default.
limit-rate
Same as --limit-rate for all tools. This option allows to control
download speed; there is no limitation by default. The number is
given in bytes per second, unless a suffix "K" or "M" is added.
max-round-robin-tries
For mirrorlist, the maximum number of mirrors to try before giving
up. (since sometimes all mirrors have the same problem and it is
useless to try more).
days-between-mirrorlist-update
After a number of days, urpmi.update will update the list of
mirrors (to get potential new mirrors).
nopubkey
Don't import pubkeys when updating media.
norebuild
Obsolete. Enabled by default.
pre-clean, post-clean, clean
Control cache management for urpmi, default is only activated as
post-clean.
priority-upgrade
A comma-separated list of package names that must be installed
first, and that trigger an urpmi restart.
prohibit-remove
A comma-separated list of package names that must never be removed
(just like basesystem dependencies).
prozilla-options
Same as --prozilla-options for urpmi, urpmq or urpmi.addmedia.
Additional options to pass to prozilla when downloading files.
resume
Same as specifying --resume for urpmi. Resume transfer of
partially-downloaded files.
retry
Specify how many times the downloader should retry in case of non-
permanent errors.
rsync-options
Additional options to pass to rsync when downloading files. Note
that the rsync options will also be used for ssh media.
split-length
Same as --split-length for urpmi. This option allows to control the
minimal length of splitted transactions. The default value is 8.
Setting this value to 0 disables the splitting of transactions.
split-level
Same as --split-level for urpmi. This option allows to control if
transactions should be splitted depending of the number of packages
to upgrade. The default value is 1.
strict-arch
Same as --strict-arch for urpmi. Boolean option, enabled by
default, meaning that packages can not be upgraded with versions
for another architecture.
verify-rpm
Same as --verify-rpm for urpmi. Enable or disable signature
checking (it's enabled by default). Disabling it can be written in
various ways (as for all the other boolean options) :
"no-verify-rpm" or "verify-rpm: no" or "verify-rpm: off" or
"verify-rpm: 0".
wget-options
Additional options to pass to wget's command line when downloading
files.
MEDIUM DESCRIPTION
A medium is described as follows :
name url {
... list of options, one per line ...
}
where name is the medium name (space characters must be prefixed by a
backslash) and where url is the medium URL.
Most other options like list, media_info_dir, synthesis, removable,
virtual are for internal use and should be changed only by experienced
users.
Options like update, ignore or key-ids can be modified by users to
respectively mark mediums as update sources, to have them being
ignored, or to specify the allowed GPG key ids for packages from the
medium for verification (unless of course signature checking has been
disabled globally). It's also possible to override verify-rpm and
downloader in a medium description.
The noreconfigure flag can be added to specify that the media should
not be reconfigured (by a reconfiguration file present on the mirror).
Media can be marked as static: this means that they will never get
updated by urpmi.update or other means. This is useful for read-only
media such as CDs.
Please note that key-ids is automatically set by urpmi.update or
urpmi.addmedia if a remote pubkey file is available on the mirror. This
file contains all the GPG armor keys that may be used.
BUGS
A "{" should finish a line, as well as a "}" should start it when used.
This means the construction "{ no-verify-rpm }" on a single line is
invalid.
AUTHOR
Pascal Rigaux <pixel@mandriva.com> (original author and current
maintainer), Francois Pons, Rafael Garcia-Suarez
SEE ALSOurpmi(8), urpmi.files(5).
Mageia Linux 2013-09-01 URPMI.CFG(1)
