diff options
| -rw-r--r-- | man/C/urpmi.cfg.5 | 129 |
1 files changed, 129 insertions, 0 deletions
diff --git a/man/C/urpmi.cfg.5 b/man/C/urpmi.cfg.5 new file mode 100644 index 00000000..c8f10188 --- /dev/null +++ b/man/C/urpmi.cfg.5 @@ -0,0 +1,129 @@ +.TH urpmi.cfg 5 "28 Aug 2003" "MandrakeSoft" "Mandrake Linux" +.IX urpmi.cfg +.SH NAME +urpmi.cfg \- urpmi option and media configuration file format. +.SH DESCRIPTION +The urpmi.cfg file format is an enhancement of previous version of urpmi.cfg +format. + +The file is divided in multiple section, a section to set global options and as +many sections as needed for the description of media managed. + +.SS Global options + +Some global options can be activated by default. The following sample shows how +to disable signature checking and avoid transaction splits : + +.B "{" +.br +.B " no-verify-rpm" +.br +.B " split-length: 0" +.br +.B "}" + +The following options can be written in this section : + +.TP +.B verify-rpm +Same as \fB--verify-rpm\fP for \fBurpmi\fP. Enable or disable signature +checking should be used, enabled by default. Disabling it can be written +in various ways (as for all the other boolean options) : +\fBno-verify-rpm\fP or \fBverify-rpm: no\fP or \fBverify-rpm: off\fP or +\fBverify-rpm: 0\fP. + +.TP +.B fuzzy +Same as \fB--fuzzy\fP for \fBurpmi\fP or \fBurpmq\fP. Enable or disable +fuzzy search, disabled by default. Enabling it can be written in various ways : +\fBfuzzy\fP or \fBfuzzy: yes\fP or \fBfuzzy: on\fP or \fBfuzzy: 1\fP. + +.TP +.B allow-force +Same as \fB--allow-force\fP for \fBurpmi\fP, disabled by default. + +.TP +.B allow-nodeps +Same as \fB--allow-nodeps\fP for \fBurpmi\fP, disabled by default. + +.TP +.B pre-clean, post-clean, clean +Control cache management for \fBurpmi\fP, default is only \fBpost-clean\fP +activated. + +.TP +.B excludedocs +Same as \fB--excludedocs\fP for \fBurpmi\fP, default is disabled. + +.TP +.B limit-rate +Same as \fB--limit-rate\fP for all tools. This option allows to control download +speed, there is no limitation by default. The number given is in Kilo-bytes per +second unless a suffix \fBK\fP, \fBM\fP is given. + +.TP +.B excludepath +Same as \fB--excludepath\fP for \fBurpmi\fP. This option allow to give comma +separated list of path to be excluded on installationn, there is no path +exlusion by default. + +.TP +.B key-ids +This option is not available on command line. This option allows to use a comma +separated list of \fBkey-ids\fP to be globaly accepted (keys still need to be +authorized by \fBrpm\fP) for any medium unless a specific \fBkey-ids\fP option +for this medium is given. There is no default (even MandrekeSoft key id 70771ff3 +is not by default). + +.TP +.B split-level +Same as \fB--split-level\fP for \fBurpmi\fP. This option allows to control if +transaction should be split depending of the number of packages to upgrade. The +default value is 20. + +.TP +.B split-length +Same as \fB--split-length\fP for \fBurpmi\fP. This option allows to control the +minimal length of split transaction. The default value is 1 (smallest possible +transaction). Setting this value to 0 disable the split of transaction. + +.SS Medium description + +A medium is described as follows : + +.B "name url {" +.br +.B " hdlist: ..." +.br +.B " ..." +.br +.B "}" + +where \fBname\fP is name of medium (space character are prefixed by anti-slash) +and optional \fBurl\fP is url of the medium (if no \fBurl\fP is given, it will +be guessed according to so mandatory list file). + +Most other options like \fBlist\fP, \fBwith_hdlist\fP, \fBsynthesis\fP, +\fBremovable\fP, \fBvirtual\fP are for internal use and should be changed only +for experienced users. + +But options like \fBupdate\fP, \fBignore\fP or \fBkey-ids\fP can be modified by +users to mark medium as an update, to ignore medium or to give allowed GPG key +ids for packages of the medium for verification (unless of course signature +checking has been disabled globaly). + +Please note that \fBkey-ids\fP is automatically set by \fBurpmi.update\fP or +\fBurpmi.addmedia\fP if a remote pubkey file is available on the mirror. This +file contains all the GPG armor keys that may be used. + +.SH BUGS +An \fB{\fP should finish a line, as well as a \fB}\fP should start it when used. + +This means the construction \fB{ no-verify-rpm }\fP on a single line is invalid. +.SH AUTHOR +Pascal Rigaux, Mandrakesoft <pixel@mandrakesoft.com> (original author) +.PP +Francois Pons, Mandrakesoft <fpons@mandrakesoft.com> (current author) +.SH SEE ALSO +\fIurpmi\fP(8), +\fIrpmdrake\fP(8) |