Linux Certif

Toute la documentation sur la certification Linux LPI

urpmi.cfg

NAME

urpmi.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.

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.)

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 Mandriva 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 kilo-bytes per second, unless a suffix "K" or "M" is added.

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.

repackage

Same as specifying --repackage for urpmi. Disabled by default. Ignored when it's set globally by urpmi.recover.

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 1 (smallest possible transaction). 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 20.

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, with_hdlist, 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 ALSO

urpmi(8), urpmi.files(5).