From 5c9233d5397d0ed370909b719c0f52365098b758 Mon Sep 17 00:00:00 2001 From: Thierry Vignaud Date: Fri, 8 Jun 2012 18:56:44 +0000 Subject: actually rename --- pod/5/urpmi.cfg.pod | 275 ++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 275 insertions(+) create mode 100644 pod/5/urpmi.cfg.pod (limited to 'pod/5/urpmi.cfg.pod') diff --git a/pod/5/urpmi.cfg.pod b/pod/5/urpmi.cfg.pod new file mode 100644 index 00000000..a7eeff26 --- /dev/null +++ b/pod/5/urpmi.cfg.pod @@ -0,0 +1,275 @@ +=head1 NAME + +urpmi.cfg - urpmi option and media configuration file format + +=head1 DESCRIPTION + +The urpmi.cfg file is divided in multiple sections: one section to set +global options, and one section per media. + +=head1 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 : + +=over + +=item B + +Same as specifying B<--allow-force> for urpmi. Disabled by default. + +=item B + +Same as specifying B<--allow-nodeps> for urpmi. Disabled by default. + +=item B + +For remote media, specify when files.xml.lzma, changelog.xml.lzma and info.xml.lzma are downloaded: + +=over + +=item B + +=item B + +(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-/ + +=item B + +urpmi.update will update xml info files already required at least once by urpmq/urpmf/rpmdrake. + +nb: with B, urpmi.update will not update /tmp/.urpmi-/ xml info files + +=item B + +all xml info files are downloaded when doing urpmi.addmedia and urpmi.update + +=back + +=item B + +Same as specifying B<--no-suggests> for urpmi. Disabled by default. + +=item B + +Same as specifying B<--auto> for urpmi. Disabled by default. + +=item B + +Deprecated (use rsync-options) + +=item B + +Additional options to pass to B's command line when downloading files. + +=item B + +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 B<--media> command-line option.) + +=item B + +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. + +=item B + +Same as B<--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!) + +=item B + +Specify which download program to use: B or B. + +=item B + +Same as specifying B<--excludedocs> for urpmi. Disabled by default. + +=item B + +Same as B<--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. + +=item B + +Same as B<--fuzzy> for urpmi or urpmq. Enable or disable fuzzy +search. Disabled by default. Enabling it can be written in various ways : +C or C or C or C. + +=item B + +Same as B<--keep> for urpmi or urpmq. + +=item B + +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 B) for any medium unless a specific B option +for this medium is given. There is no default (even Mageia public key id +70771ff3 is not included by default). + +=item B + +Don't check file systems for sufficient disk space before installation. +Same as specifying B<--ignoresize> for urpmi. Disabled by default. + +=item B + +Same as B<--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 C or C is added. + +=item B + +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). + +=item B + +After a number of days, urpmi.update will update the list of mirrors (to get +potential new mirrors). + +=item B + +Don't import pubkeys when updating media. + +=item B + +Obsolete. Enabled by default. + +=item B + +Control cache management for urpmi, default is only activated as +B. + +=item B + +A comma-separated list of package names that must be installed first, +and that trigger an urpmi restart. + +=item B + +A comma-separated list of package names that must never be removed (just +like B dependencies). + +=item B + +Same as B<--prozilla-options> for urpmi, urpmq or urpmi.addmedia. +Additional options to pass to B when downloading files. + +=item B + +Same as specifying B<--repackage> for urpmi. Disabled by default. +Ignored when it's set globally by urpmi.recover. + +=item B + +Same as specifying B<--resume> for urpmi. Resume transfer of partially-downloaded files. + +=item B + +Specify how many times the downloader should retry in case of non-permanent +errors. + +=item B + +Additional options to pass to B when downloading files. +Note that the rsync options will also be used for ssh media. + +=item B + +Same as B<--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. + +=item B + +Same as B<--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. + +=item B + +Same as B<--strict-arch> for urpmi. Boolean option, enabled by +default, meaning that packages can not be upgraded with versions for another +architecture. + +=item B + +Same as B<--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) : C or C +or C or C. + +=item B + +Additional options to pass to B's command line when downloading files. + +=back + +=head1 MEDIUM DESCRIPTION + +A medium is described as follows : + + name url { + ... list of options, one per line ... + } + +where B is the medium name (space characters must be prefixed by a +backslash) and where B is the medium URL. + +Most other options like B, B, +B, B, B are for internal use and should be +changed only by experienced users. + +Options like B, B or B 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 B and +B in a medium description. + +The B 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 B: 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 B 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. + +=head1 BUGS + +A C<{> should finish a line, as well as a C<}> should start it when used. +This means the construction C<{ no-verify-rpm }> on a single line is +invalid. + +=head1 AUTHOR + +Pascal Rigaux (original author and current maintainer), +FranEois Pons, Rafael Garcia-Suarez + +=head1 SEE ALSO + +urpmi(8), urpmi.files(5). -- cgit v1.2.1