From 10fab33bd78df1805cfc7cec20674676d66c74d9 Mon Sep 17 00:00:00 2001 From: Rafael Garcia-Suarez Date: Tue, 15 Nov 2005 13:35:58 +0000 Subject: Add pod versions of the manpages, bound to replace the nroff ones --- pod/proxy.cfg.5.pod | 29 +++ pod/rurpmi.8.pod | 35 ++++ pod/urpme.8.pod | 92 ++++++++++ pod/urpmf.8.pod | 255 ++++++++++++++++++++++++++ pod/urpmi.8.pod | 422 ++++++++++++++++++++++++++++++++++++++++++++ pod/urpmi.addmedia.8.pod | 206 +++++++++++++++++++++ pod/urpmi.cfg.5.pod | 169 ++++++++++++++++++ pod/urpmi.files.5.pod | 83 +++++++++ pod/urpmi.removemedia.8.pod | 36 ++++ pod/urpmi.update.8.pod | 95 ++++++++++ pod/urpmq.8.pod | 257 +++++++++++++++++++++++++++ 11 files changed, 1679 insertions(+) create mode 100644 pod/proxy.cfg.5.pod create mode 100644 pod/rurpmi.8.pod create mode 100644 pod/urpme.8.pod create mode 100644 pod/urpmf.8.pod create mode 100644 pod/urpmi.8.pod create mode 100644 pod/urpmi.addmedia.8.pod create mode 100644 pod/urpmi.cfg.5.pod create mode 100644 pod/urpmi.files.5.pod create mode 100644 pod/urpmi.removemedia.8.pod create mode 100644 pod/urpmi.update.8.pod create mode 100644 pod/urpmq.8.pod (limited to 'pod') diff --git a/pod/proxy.cfg.5.pod b/pod/proxy.cfg.5.pod new file mode 100644 index 00000000..660c39d0 --- /dev/null +++ b/pod/proxy.cfg.5.pod @@ -0,0 +1,29 @@ +=head1 NAME + +proxy.cfg - urpmi proxy configuration file format. + +=head1 DESCRIPTION + +The proxy.cfg file contains lines of the form + + [media:]http_proxy=[value] + [media:]ftp_proxy=[value] + [media:]proxy_user=[value] + +where the media part is optional (in this case, the line applies to all +media). ftp_proxy and http_proxy values have the same syntax as the usual +environment variables used by many programs such as curl(1): + + [protocol://][:port] + +proxy_user values are simply a user name, or a user name and a password +separated by a colon (C<:>). + +=head1 AUTHOR + +FranEois Pons, Rafael Garcia-Suarez +(current maintainer) + +=head1 SEE ALSO + +urpmi(8), urpmi.cfg(5), urpmi.files(5). diff --git a/pod/rurpmi.8.pod b/pod/rurpmi.8.pod new file mode 100644 index 00000000..03957cda --- /dev/null +++ b/pod/rurpmi.8.pod @@ -0,0 +1,35 @@ +=head1 NAME + +rurpmi - restricted urpmi + +=head1 SYNOPSIS + + rurpmi [options] [package_names] + +=head1 DESCRIPTION + +rurpmi is similar to urpmi, but has a stripped-down set of features. It's +intended to be used by users with sudo rights on it, preventing them to +abuse it to compromise the system. With it, you can't install arbitrary +rpm files, the B<--keep>, B<--verify-rpm>, and B<--norebuild> options are +forced, and several dangerous options are forbidden (B<--root>, +B<--use-distrib>, B<--env>, B<--nolock>, B<--allow-nodeps>, +B<--allow-force>, B<--force>). + +=head1 CAVEAT + +This software is still experimental. While some operations are forbidden, +there is no guarantee it is actually secure. + +=head1 OPTIONS + +The options are the same than urpmi ones. + +=head1 AUTHOR + +Maintained by Rafael Garcia-Suarez, + + +=head1 SEE ALSO + +L(8)>. diff --git a/pod/urpme.8.pod b/pod/urpme.8.pod new file mode 100644 index 00000000..4ce455a2 --- /dev/null +++ b/pod/urpme.8.pod @@ -0,0 +1,92 @@ +=head1 NAME + +urpme - rpm deinstaller + +=head1 SYNOPSIS + + urpme [options] [package_names] + +=head1 DESCRIPTION + +urpme allow packages to be deinstalled, +including all their dependencies. I must have one of the forms +I, I, I, or I. +If you want to specify packages more broadly, use the B<-a> option. + +=head1 OPTIONS + +=over + +=item B<--help> + +Prints a help message and exit (this is the same as B<-h> or B<-?>). + +=item B<-a> + +If multiple packages match the given substring, deinstall them all. + +=item B<-v> + +Proposes a verbose mode with various messages. + +=item B<--auto> + +Removes packages non-interactively, without asking questions. + +=item B<--test> + +Test deinstallation of packages but do not modify the system. + +=item B<--force> + +Force invocation even if some packages do not exist. + +=item B<--parallel> I + +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). I defines which extension module is to be used by +urpmi (currently, B or B are +available) and which machines should be updated. This alias is defined in +the file F as described below. + +=item B<--root> I + +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. + +=item B<--use-distrib> I + +Configure urpme on the fly from a distribution tree. + +=back + +=head1 FILES + +See urpmi.files(5). + +=head1 EXIT CODES + +=over + +=item 1 + +Command line inconsistency. + +=item 2 + +Removal of packages failed. + +=back + +=head1 AUTHORS + +Pascal Rigaux, Francois Pons, Rafael Garcia-Suarez + (current maintainer) + +=head1 SEE ALSO + +urpmi.addmedia(8), urpmi.update(8), urpmi.removemedia(8), urpmf(8), +urpmi(8), urpmq(8), urpmi.files(5). diff --git a/pod/urpmf.8.pod b/pod/urpmf.8.pod new file mode 100644 index 00000000..5700d8dc --- /dev/null +++ b/pod/urpmf.8.pod @@ -0,0 +1,255 @@ +=head1 NAME + +urpmf - Finds the packages matching some conditions + +=head1 SYNOPSIS + + urpmf [options] + +=head1 DESCRIPTION + +By default, urpmf outputs the list of the known packages that contain a +file whose name or path was specified as an argument on the command-line. +> is the name or part of the name of the file you +want to locate. Perl-style regular expressions are allowed. B will +then print a list of matching files, with their corresponding packages. By +using options, you may format output differently, and search through other +rpm tags. Note that B searches through the urpmi media (B in +the system's rpm database -- for that you should use rpm(8) instead). + +=head1 OPTIONS + +=over + +=item B<--help> + +Prints a help message and exits. + +=item B<--version> + +Prints the version number and exits. + +=item B<--env> I + +Use a different environment directly out of a bug report tarball. + +=item B<--excludemedia> I + +Do not use the given media. + +=item B<--literal> + +Match literally instead of interpreting the argument as a regular +expression. + +=item B<-l> + +Equivalent to B<--literal>. + +=item B<--media> I + +Select specific media to be used, instead of defaulting to all available +media (or all update media if B<--update> is used). + +=item B<--sortmedia> I + +Sort the given media, substrings may be used to simplify grouping. + +=item B<--synthesis> I + +Use the given synthesis file instead of urpmi db for searching packages. + +=item B<--uniq> + +Do not print identical lines twice. + +=item B<--update> + +Use only update media. This means B will only search through media +marked as update. + +=item B<--verbose> + +Verbose mode. B will emit various messages related to the parsing of +hdlist files for your media. + +=item B<-i> + +Ignore case distinctions in any patterns. + +=item B<-F> I + +Change field separator to I for the rest of the output line (it +defaults to ':') + +=item B<--qf> I + +Specify a printf-like output format. + +=item B<--arch> + +Prints the architecture tag. + +=item B<--buildhost> + +Prints the BuildHost tag. + +=item B<--buildtime> + +Prints the +BuildTime tag. + +=item B<--conffiles> + +Prints the list of configuration files contained +in the package. (Might be empty.) + +=item B<--conflicts> + +Prints the Conflicts tags. + +=item B<--description> + +Prints the Description tag. + +=item B<--distribution> + +Prints the Distribution tag. + +=item B<--epoch> + +Prints the Epoch tag. + +=item B<--filename> + +Prints package file names. + +=item B<--files> + +Prints the list of files contained in the rpm (this is the default if you +specify no field). + +=item B<--group> + +Prints the Group tag. + +=item B<--name> + +Prints package names. + +=item B<--obsoletes> + +Prints the Obsoletes tags. + +=item B<--packager> + +Prints the Packager tag. + +=item B<--provides> + +Prints the Provides tags. + +=item B<--requires> + +Prints the Requires tag. + +=item B<--size> + +Prints the Size tag. + +=item B<--sourcerpm> + +Prints the names of source rpms. + +=item B<--summary> + +Prints the Summary tag. + +=item B<--url> + +Prints the packages' URL. + +=item B<--vendor> + +Prints the Vendor tag. + +=item B<-m> + +Print the name of the media in which the +package has been found. + +=item B<-f> + +Print version, release and arch along with name +of package. This modifies the effect of the I<--name> option. + +=item B<-e> + +Include code directly +in the perl search expression. Use it with B<--debug> to look at the generated +perl code. In any cases, use it only if you know perl. + +=item B<-a> + +Binary AND operator, true if both expressions are true. + +=item B<-o> + +Binary OR operator, true if one expression is true. + +=item B + +Unary NOT, true if expression is false. + +=item B<(> + +Left parenthesis to open a group expression. + +=item B<)> + +Right parenthesis to close a group expression. + +=item B<--debug> + +Includes debugging output. + +=back + +=head1 FORMAT + +The options to select tags (B<--arch>, B<--buildhost> and so on) control +the output format of urpmf. If not explicitly specified somewhere else, +the name of the rpm is printed first. Fields are separated by C<:> until +specified otherwise. + +You can also use B<--qf> for that. It takes a format string, where tags to +be replaced are specified as B<%>I<[-][number]>B. The optional +number indicates the length of the space-padding and the B<-> character +its justification (like in printf(3)). + +=head1 EXPRESSIONS + +The boolean operator switches allow you to construct complex expressions +from regexps. Those expressions are then matched against the whole output +line. + +=head1 EXAMPLE + +This command will list all C modules, and list them along +with the media in which they're been found, nicely indented : + + urpmf --qf '%-30name is found in media %media' perl-Apache + +=head1 FILES + +See urpmi.files(5). + +=head1 SEE ALSO + +urpmi.addmedia(8), urpmi.update(8), urpmi.removemedia(8), urpmi(8), +urpmq(8), urpmi.files(5). + +=head1 AUTHOR + +Pascal Rigaux (original author), FranEois Pons, Rafael +Garcia-Suarez (current maintainer) diff --git a/pod/urpmi.8.pod b/pod/urpmi.8.pod new file mode 100644 index 00000000..a253ce34 --- /dev/null +++ b/pod/urpmi.8.pod @@ -0,0 +1,422 @@ +=head1 NAME + +urpmi - rpm downloader, installer and dependency solver + +=head1 SYNOPSIS + + urpmi [options] [package_names | rpm_files...] + +=head1 DESCRIPTION + +urpmi authorizes well-known rpms (or rpm files) to be installed including +all their dependencies. You can use it to install the dependencies of a +source package, or a source package itself. + +You can compare rpm vs. urpmi with insmod vs. modprobe or dpkg vs apt-get. +Just launch 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. + +Note that urpmi handles installations from various types of media (ftp, +http, rsync, local and nfs volumes, and removable media such as CDROMs) +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. + +=head1 OPTIONS + +=over + +=item B<--help> + +Print a help message and exit (this is the same as B<-h> or B<-?>). + +=item B<--update> + +Use only update media. This means that B will search +packages and resolve dependencies only in media marked as containing updates. + +=item B<--media> I + +Select specific media to be used, instead of defaulting +to all available media (or all update media if B<--update> is used). + +=item B<--excludemedia> I + +Do not use the specified media. + +=item B<--searchmedia> I + +Use only the specified media to search for packages when combined with +B<--auto-select>. + +=item B<--sortmedia> I + +Sort the specified media. Substrings may be used +to simplify grouping. + +=item B<--synthesis> I + +Use the specified synthesis file instead +of the urpmi database for searching packages and resolving dependencies. + +=item B<--auto> + +Install all required dependencies without asking. + +=item B<--auto-select> + +Automatically +select all packages that have to be upgraded, according to already installed +packages and packages listed in various registered media. + +=item B<--no-install> + +Only download packages, don't install them. You'll find them in +F. + +=item B<--no-uninstall> + +Never ask to uninstall a package but prefer aborting instead. +This can be safer in auto mode. + +=item B<--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 B<--auto-select>) when a dependency error +occurs. + +=item B<--split-level I> + +Split urpmi's operation in small transactions when +the total number of packages to upgrade is greater than the given I. +This option is activated by default, and the default value of I is +20. + +=item B<--split-length I> + +Split urpmi's operation in small transactions of at +least I packages. The default is 1 and setting this value to 0 just +disables splitting in small transactions. + +=item B<--fuzzy> + +Disable fast search on exact +package name; that means that urpmi will propose all packages matching +the name partially, even if one of them matches exactly the specified name +(this is the same as B<-y>). + +=item B<--src> I + +Search a source package matching I and +select all its dependencies by default, unless B<--install-src> is used in order +to install the source package itself. + +=item B<--install-src> + +Install only the source +package (no binary packages will be installed). + +=item B<--clean> + +Remove all packages from the cache in directory F. + +=item B<--noclean> + +Do not remove any package from the cache in directory +F. + +=item B<--force> + +Assume yes on all questions. + +=item B<--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. + +=item B<--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. + +=item B<--parallel> I + +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). I defines which extension module is to be used by +urpmi (currently, B or B are +available) and which machines should be updated. This alias is defined in +the file F as described below. + +=item B<--root> I + +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. + +=item B<--use-distrib> I + +Configure urpmi on the fly from a distrib tree, useful to install a chroot +with the B<--root> option. + +=item B<--wget> + +Use wget for downloading distant files. By default curl +is used if available, or wget instead. + +=item B<--curl> + +Use curl for downloading distant +files. By default curl is used if available, or wget instead. + +=item B<--limit-rate I> + +Try to limit the download speed, I is given in bytes/sec. This +option is not active by default. + +=item B<--resume> + +Resume transfer of partially-downloaded files. + +=item B<--retry> I + +Retries to download files over FTP or HTTP the specified number +of times. + +=item B<--proxy> I + +Use specified HTTP proxy. + +=item B<--proxy-user> I + +Use +specified user and password to use for proxy authentication. Specifying +B<--proxy-user=ask> will cause urpmi to prompt for a username and a password. + +=item B<--bug> I + +Create a bug report in I. You have to send a compressed +archive of the directory to the urpmi maintainer for the bug being (probably) +reproduced. + +=item B<--env> I + +Use a different environment directly from a bug +report to replay a bug. The argument is the same argument given to B<--bug> option. + +=item B<--verify-rpm> + +=item B<--no-verify-rpm> + +Activate or deactivate rpm signature checking. It's activated +by default. + +=item B<--test> + +Test (same as B) installation of packages but do +not modify the system. + +=item B<--excludepath> I + +Do not install files of which the +names begin with the given I (same as B). + +=item B<--excludedocs> + +Do not install documents files (same as B). + +=item B<--ignoresize> + +Don't check +file systems for sufficient disk space before installation. This is equivalent +to B. + +=item B<--skip> I + +You can specify a list of packages which installation should be skipped. +You can also include patterns between //, just like in +F (see urpmi.files(5)). + +=item B<--more-choices> + +When several packages are found, propose more choices than the default. + +=item B<--norebuild> + +Don't try to rebuild the hdlist files from the RPMs if the original hdlist +wasn't readable or was corrupted. + +=item B<--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). + +=item B<-a> + +If multiple packages match the given substring, install them all. + +=item B<-p> + +Allow search in provides to find package (default). + +=item B<-P> + +Do not search in provides to find package (this +is the opposite of B<-p>). + +=item B<-y> + +This is the same as B<--fuzzy>. + +=item B<-s> + +This is the same as B<--src>. + +=item B<-q> + +Quiet mode: when calling rpm no upgrade status is printed. + +=item B<-v> + +Proposes a verbose mode with various messages. + +=back + +=head1 EXAMPLES + +=over + +=item urpmi ssh://foo@bar.net/home/foo/test.rpm + +Fetch F from server bar.net over ssh using user foo. +You can use a public key or enter your password. + +=item urpmi --media foo- --auto-select + +Fetch all the updates from media containing C in their name. + +=back + +=head1 FILES + +See urpmi.files(5). + +=head1 EXIT CODES + +=over + +=item 1 + +Command line inconsistency. + +=item 2 + +Problem registering local packages. + +=item 3 + +Source packages not retrievable. + +=item 4 + +Medium is not selected. + +=item 5 + +Medium already +exists. + +=item 6 + +Unable to save configuration. + +=item 7 + +Urpmi database locked. + +=item 8 + +Unable to +create bug report. + +=item 9 + +Unable to open rpmdb. + +=item 10 + +Some files are missing for installation. + +=item 11 + +Some transactions failed but not all. + +=item 12 + +All transactions failed. + +=item 13 + +Some files are missing and some transactions failed but not all. + +=item 14 + +Some files are missing and all transactions failed. + +=back + +=head1 BUG REPORTS + +If you find a bug in B please report it using the command : + + urpmi --bug bug_name_as_directory ... + +This will automatically create a directory called F +containing necessary files to reproduce it if possible. Please test the +report using + + urpmi --env bug_name_as_directory ... + +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. + +=head1 BUGS + +When a package is removed, it may not be replaced +with an older version. + +=head1 AUTHOR + +Pascal Rigaux (original author), Francois Pons, +Rafael Garcia-Suarez, (current maintainer) + +=head1 CONTRIBUTORS + +Please mail to authors if you are not belonging to this alphabetically +sorted list after having contributed. Andrej Borsenkow, Guillaume +Cottenceau, Philippe Libat, Bryan Paxton, Guillaume Rousse, Michael +Scherer, Alexander Skwar, Olivier Thauvin, Erwan Velu, Florent Villard. + +=head1 SEE ALSO + +urpmi.addmedia(8), urpmi.update(8), urpmi.removemedia(8), urpmf(8), +urpmq(8), urpmi.cfg(5), urpmi.files(5). diff --git a/pod/urpmi.addmedia.8.pod b/pod/urpmi.addmedia.8.pod new file mode 100644 index 00000000..e5e83493 --- /dev/null +++ b/pod/urpmi.addmedia.8.pod @@ -0,0 +1,206 @@ +=head1 NAME + +urpmi.addmedia - adds a new rpm medium to be used by urpmi + +=head1 SYNOPSIS + + urpmi.addmedia [options] [with ] + +=head1 DESCRIPTION + +urpmi.addmedia is used to add a new media to be used by urpmi, so it can +find new rpms at the specified location. Currently supported media types +are: local drives, removable drives (such as CDs), and networked media via +different protocols (http, ftp, ssh and rsync). One of the following modes +must be chosen: + +=over + +=item B>] > http://>:>@>/> [with >] + +where > is your reference for the medium (e.g. "updates"). +> is optional if B<--distrib> is given in the options list. +>/> is the location of the media directory on the net +(e.g. C). > is the pathname where +to find the hdlist of the rpms. The location is given relative to +>. B is used by default to download files, B may be +used if B is not installed or if or B<--wget> is given in +I. Example: + + urpmi.addmedia http http://jpackage.sf.net/rpm/free with hdlist.cz ftp: + +=item B>] > ftp://>:>@>/> [with >] + +The same as for http. Add your login and password if required (note that +you don't need to specify B as login for anonymous access ftp +servers). If B is used to download files with a firewall you may +have to ensure that the B option is on in B +(that's usually the default). Example: + + urpmi.addmedia ftp ftp://a:a@leia//export/media/main with media_info/hdlist.cz + +=item B>] > ssh://>@>/> [with >] + +The same as for http and ftp; add your login and password if required. It +is strongly recommended to export the public key in order not to have to +type your password all the time. B and B will be used to get +files. Example: + + urpmi.addmedia -h ssh ssh://fpons@bi/c/i586/media/main + +=item B>] > rsync://>@>:>/> [with >] + +The same as for http; you can use the >::> syntax too. Example: + + urpmi.addmedia rsync rsync://ftp.orst.edu::mandrake-devel/contrib/ppc with ../../cooker/ppc/media/media_info/hdlist2.cz + +=item B>] > file://> [with >] + +where > is your reference for the medium (e.g. Myrpms). > +is the location of the media directory on your machine (e.g. C). + +=item B>] > removable://> [with >] + +> is the location of the media directory on your machine when the +removable device is mounted. This works for removable drives, but also for +ISO images mounted on a loop device. urpmi will then be able to re-mount +the ISO image to the specified path (but the ISO image must be mounted +when you run B). + +=back + +=head1 OPTIONS + +=over + +=item B<--wget> + +Use wget only for downloading distant files. By default curl is used if +available. + +=item B<--curl> + +Use curl only for downloading distant files. This is the default if curl +is available. + +=item B<--limit-rate I> + +Try to limit the download speed, I is given in bytes/sec. This option +is not active by default. + +=item B<--proxy> I + +Use specified HTTP proxy. + +=item B<--proxy-user> I + +Use specified user and password to use for proxy authentication. +Specifying B<--proxy-user=ask> will cause urpmi.addmedia to prompt for a +username and a password. + +=item B<--update> + +Add a medium which will be taken into +account by B or by B when looking for updates. + +=item B<--probe-synthesis> + +Try to find and use synthesis file if B is not given. + +=item B<--probe-hdlist> + +Try to find and use hdlist file if B is not given. + +=item B<--no-probe> + +Do not try to find any synthesis or hdlist file. + +=item B<--distrib> + +Retrieve a set of media from a distribution. Typically, the URL provided +to B will represent the parent directory of a directory +B, which in turn will contain various subdirectories for each +medium of the distribution. > is combined with medium names found +to create newer medium names in the urpmi database. The B +option, if provided, is ignored, as hdlists found on the installation +medium are used instead automatically. + +=item B<--from> I + +Use specified URL for list of mirrors. The default is taken from the file +F, or +F if this file doesn't +exist. + +=item B<--version> I + +Use specified distribution version. The default is taken from the version +of the distribution told by the installed mandriva-release package. + +=item B<--virtual> + +Creates a virtual medium. This only works for C and +C protocols, and no files will be created in +F. The medium is always up-to-date and so it does not need +to be updated by B. + +=item B<--norebuild> + +Don't try to rebuild the hdlist files from the RPMs +if the original hdlist wasn't readable or was corrupted. + +=item B<--raw> + +Add the new media +in the urpmi configuration file, but don't update it nor proceed to any +download. The media, to be usable, will need to be updated with B. + +=item B<--nopubkey> + +Don't import pubkey of added media. + +=item B<-c> + +Clean headers cache directory in F. + +=item B<-h> + +Try to find and use synthesis or hdlist file. + +=item B<-f> + +Force rebuild of base files, or of hdlist files when specified twice. + +=back + +=head1 Variables + +Beginning with urpmi 4.6.16, you can use variables in media URLs (for +example F). The variables supported +so far are: + +=over + +=item B<$ARCH> + +The architecture (as given in F) + +=item B<$RELEASE> + +The OS release (as given in F; its value is +B on a cooker system.) + +=item B<$HOST> + +The canonical hostname of the machine urpmi runs on. + +=back + +=head1 SEE ALSO + +urpmi(8), urpmi.update(8), urpmi.removemedia(8), urpmf(8), urpmq(8), urpmi.files(5). + +=head1 Author + +Pascal Rigaux (original author), FranEois Pons, Rafael +Garcia-Suarez, (current maintainer) diff --git a/pod/urpmi.cfg.5.pod b/pod/urpmi.cfg.5.pod new file mode 100644 index 00000000..3b820474 --- /dev/null +++ b/pod/urpmi.cfg.5.pod @@ -0,0 +1,169 @@ +=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 B, disabled by default. + +=item B + +Same as specifying B<--allow-nodeps> for B, disabled by default. + +=item B + +Specify which download program to use: B or B. + +=item B + +Same as specifying B<--excludedocs> for B, disabled by default. + +=item B + +Same as B<--excludepath> for B. 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 B or B. 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 + +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 Mandriva public key id +70771ff3 is not included 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 +kilo-bytes per second, unless a suffix C or C is added. + +=item B + +Don't import pubkeys when updating media. + +=item B + +Specifies that the media should not be reconfigured (by a reconfiguration +file present on the medium). + +=item B + +Same as B<--norebuild> for B, B and +B, disabled by default (meaning that B will try to +rebuild hdlists by default). + +=item B + +Control cache management for B, default is only activated as +B. + +=item B + +A comma-separated list of package names that must never be removed (just +like B dependencies). + +=item B + +Specify how many times the downloader should retry in case of non-permanent +errors. + +=item B + +Same as B<--split-length> for B. 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. + +=item B + +Same as B<--split-level> for B. This option allows to control if +transactions should be splitted depending of the number of packages to +upgrade. The default value is 20. + +=item B + +Same as B<--strict-arch> for B. Boolean option, disabled by +default, meaning that packages can be upgraded with versions for another +architecture. + +=item B + +Same as B<--verify-rpm> for B. 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. + +=back + +=head1 MEDIUM DESCRIPTION + +A medium is described as follows : + + name url { + hdlist: ... + ... list of options, one per line ... + } + +where B is the medium name (space characters must be prefixed by a +backslash) and where the optional B is the medium URL (if no B +is given, it will be guessed according to the mandatory list file). + +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. + +Media can be marked as B: this means that they won't be updated by +B or other means. This is useful for read-only media such as +CDs. + +Please note that B is automatically set by B or +B 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), Francois Pons, Rafael Garcia-Suarez, + (current maintainer) + +=head1 SEE ALSO + +urpmi(8), urpmi.files(5). diff --git a/pod/urpmi.files.5.pod b/pod/urpmi.files.5.pod new file mode 100644 index 00000000..d11385e9 --- /dev/null +++ b/pod/urpmi.files.5.pod @@ -0,0 +1,83 @@ +=head1 NAME + +urpmi.files - files used by the urpmi tools + +=head1 DESCRIPTION + +The urpmi tools (urpmi, urpme, urpmi.addmedia, urpmi.update, etc.) use +several different files to store the state of the RPM repositories (or +media). This manual page documents them. + +=head1 FILES + +=over + +=item I> + +Contains the list of all packages known by urpmi and their location. This +file is used when a password is used to access a distant location (using +a network protocol) or when various directories are used to store the +packages. That's why it's not world-readable. + +=item I.cz> + +Contains information about all known packages; it's a summary of rpm +headers. If an hdlist file is used for a medium, B can operate +completely without accessing this medium (this is almost always the case). + +=item I.cz> + +Contains synthesis information about all known packages built from hdlist +files that can be used by minimal closure algorithm. If these files are +not present, hdlist files will be used instead to resolve dependencies +(but this is much slower). + +=item I + +Contains media descriptions. +See urpmi.cfg(5). + +=item I + +Contains proxy descriptions for http and ftp media. See proxy.cfg(5). + +=item I + +Contains the descriptions of parallel aliases, one per line. Their general +format is B<< :: >> where +B<< >> is a symbolic name to identify the parallel alias, B<< + >> is one of the parallel install methods (can be B or +B), B<< >> is a media list (as given to the B<--media> +parameter), and finally B<< >> is a specific interface +parameter list like C<-c ssh -m node1 -m node2> for B extension or +C (list of node hostnames) for B extension. + +=item I + +The list of packages that should not be automatically +updated when using --auto-select. It contains one package expression per line; +either a package name, or a regular expression (if enclosed in slashes +B) to match the name of packages against. (Actually, it's matched against +the full name of the package, which has the form B.) + +=item I + +The list of packages that should be installed instead of updated. It has +the same format as the skip.list. + +=item I + +This file is optional. If present, it should contain a single line: +B which is the URL of a document that lists the available +mirrors. The default is to use +B. + +=item I + +The urpmi log file. + +=back + +=head1 SEE ALSO + +urpmi.cfg(5), proxy.cfg(5). diff --git a/pod/urpmi.removemedia.8.pod b/pod/urpmi.removemedia.8.pod new file mode 100644 index 00000000..a0de5a6b --- /dev/null +++ b/pod/urpmi.removemedia.8.pod @@ -0,0 +1,36 @@ +=head1 NAME + +urpmi.removemedia - remove a rpm media from the known media of urpmi + +=head1 SYNOPSIS + + urpmi.removemedia [options] names + +=head1 DESCRIPTION + +urpmi.removemedia removes from all configuration files all references to +the named media and to rpms from that media. > is a list of names +you first told to urpmi.addmedia. + +=head1 OPTIONS + +=over + +=item B<-a> + +Select and remove all media. + +=item B<-c> + +Clean header cache directory (F). + +=back + +=head1 SEE ALSO + +urpmi(8), urpmi.addmedia(8), urpmi.update(8). + +=head1 AUTHOR + +Pascal Rigaux (original author), FranEois Pons, +Rafael Garcia-Suarez, (current maintainer) diff --git a/pod/urpmi.update.8.pod b/pod/urpmi.update.8.pod new file mode 100644 index 00000000..b3545fce --- /dev/null +++ b/pod/urpmi.update.8.pod @@ -0,0 +1,95 @@ +=head1 NAME + +urpmi.update - Updates package lists for specified media + +=head1 SYNOPSIS + + urpmi.update [options] [] + +=head1 DESCRIPTION + +urpmi.update scans the specified urpmi media to update their package list. +> is a list of names you first told to urpmi.addmedia. + +=head1 OPTIONS + +=over + +=item B<--wget> + +Use wget for downloading distant files. By default curl +is used if available, or wget instead. + +=item B<--curl> + +Use curl for downloading distant +files. By default curl is used if available, or wget instead. + +=item B<--limit-rate I> + +Try to limit the download speed, I is given in bytes/sec. This +option is not active by default. + +=item B<--proxy> I + +Use specified HTTP proxy. + +=item B<--proxy-user> I + +Use specified user and password to use for proxy authentication. +Specifying B<--proxy-user=ask> will cause urpmi.update to prompt for a +username and a password. + +=item B<--update> + +Use only update media. + +=item B<--no-md5sum> + +Disable MD5SUM file checking. + +=item B<--force-key> + +Force update of GPG key. + +=item B<--norebuild> + +Don't try to rebuild the hdlist files from the RPMs if the original hdlist +wasn't readable or was corrupted. + +=item B<--ignore>, B<--no-ignore> + +Don't update media, but mark them +as ignored (disables them). B<--no-ignore> has the reverse behaviour: it marks +the media as enabled. + +=item B<-a> + +Select all media that are not using a removable device to update them. + +=item B<-c> + +Clean /var/cache/urpmi/headers directory on exit. + +=item B<-f> + +Force rebuild of base files, or of hdlist files when specified twice. + +=item B<-q> + +Quiet mode. + +=item B<-v> + +Verbose mode. + +=back + +=head1 SEE ALSO + +urpmi(8), urpmi.addmedia(8), urpmi.removemedia(8). + +=head1 AUTHOR + +Pascal Rigaux (original author), FranEois Pons, +Rafael Garcia-Suarez, (current maintainer) diff --git a/pod/urpmq.8.pod b/pod/urpmq.8.pod new file mode 100644 index 00000000..6579bec5 --- /dev/null +++ b/pod/urpmq.8.pod @@ -0,0 +1,257 @@ +=head1 NAME + +urpmq - urpmi database query tool. + +=head1 SYNOPSIS + + urpmq [options] [package_names | rpm_files...] + +=head1 DESCRIPTION + +urpmq is a tool to access and query the urpmi database. It can be used to +list available packages in the various urpmi media, or to list the full +dependencies of a package, or to list the packages that will be installed +if you start urpmi. The output of urpmq has the following format, adjusted +according to the command-line options that were used: + + [group/]package_name[-version][-release][.arch] + +=head1 OPTIONS + +=over + +=item B<--help> + +Prints a help message and exit (this is the same as B<-h> or B<-?>). + +=item B<--list> + +List available packages. + +=item B<--list-media> [I] + +List available media. You can optionally add a type selector: B to +list all media (the default), B to list the update media, or +B to list only active media. + +=item B<--list-url> + +List available media and their URLs. + +=item B<--list-nodes> + +List available nodes when using B<--parallel>. + +=item B<--list-aliases> + +List available parallel aliases. + +=item B<--update> + +Use only update +media. This means that B will search and resolve dependencies only in +media marked as containing updates. + +=item B<--media> I + +Select specific +media to be used, instead of all available media (or update media if B<--update> +is used). + +=item B<--excludemedia> I + +Do not use the specified media. + +=item B<--searchmedia> I + +Use only the specified medium to search for packages when combined with +B<--auto-select>. + +=item B<--sortmedia> I + +Sort the specified media. Substrings may be used to simplify grouping. + +=item B<--synthesis> I + +Use the specified synthesis file instead of the urpmi database for +searching packages and resolving dependencies. + +=item B<--auto-select> + +Automatically select all packages that have to be +upgraded, according to already installed packages and packages listed in +various registered media. + +=item B<--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 B<--auto-select>) when a dependency error +occurs. + +=item B<--fuzzy> + +Disable fast search on exact package name; i.e. it will propose +all packages matching the name partially, even if one of them matches exactly +the specified name (this is the same as B<-y>). + +=item B<--src> I + +Search a source package +matching I and it will select all dependencies by default. + +=item B<--headers> + +Extract +and dump headers of selected packages to standard output. (Can be used by +the superuser only.) + +=item B<--sources> + +Prints source URLs (or file names) of all selected +packages. (Can be used by the superuser only.) + +=item B<--force> + +Continue when requesting +packages that are not available. + +=item B<--parallel> I + +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). I defines which extension module to use by urpmi +(currently B or B) and which +machines should be updated, this alias is defined in the file +F as described below. + +=item B<--root> I + +Use the file system tree rooted for rpm install. All operations and +scripts will run after chroot(2). The rpm database in the rooted tree +will be used but urpmi configuration comes from normal system. + +=item B<--wget> + +Use wget for downloading distant files. By default curl +is used if available, or wget instead. + +=item B<--curl> + +Use curl for downloading distant files. By default curl is used if +available, or wget instead. + +=item B<--proxy> I + +Use specified HTTP proxy. + +=item B<--proxy-user> I + +Use specified user and password to use for proxy authentication. +Specifying B<--proxy-user=ask> will cause urpmq to prompt for a username +and a password. + +=item B<--use-distrib> I + +Configure urpmq on the fly from a distrib tree. You must be root to use +this option. + +=item B<--env> I + +Use a different environment directly from a bug report to replay a bug. +The argument is the same argument given to B<--bug> option. + +=item B<--changelog> + +Prints the package changelog. + +=item B<--summary> + +Prints concise information about the package. + +=item B<-v> + +Activate verbose mode. + +=item B<-d> + +Select dependencies (maximal closure). + +=item B<-u> + +Deselect packages if a better version is already installed, this option +can be used with B<-d> to simulate B<-M> mode of B. + +=item B<-a> + +Select all matches on command line, useful when using B<-f> or B<-r> with +incomplete name given. + +=item B<-c> + +If maximal closure is used, assume that a package listed may have wrong or +not up-to-date dependencies. This causes more packages to be upgraded and +may correct unresolved dependencies on the rpm database. + +=item B<-p> + +Search in provides to find package (this is the opposite of B<-P>). + +=item B<-P> + +Do not search in provides to find package (this is the opposite +of B<-p> and is the default). + +=item B<-R> + +Reverse search to what requires the package given. If you specify this +option twice, looks also through virtual packages to find the +dependencies. + +=item B<-S> + +Same as B<--summary>. + +=item B<-y> + +This is the same as B<--fuzzy>. + +=item B<-Y> + +Like B<-y>, but forces to match case-insensitively. + +=item B<-s> + +This is the same as B<--src>. +=item B<-i> + +Prints useful information in human readable form, as for I. + +=item B<-g> + +Prints groups of each package listed. + +=item B<-r> + +Prints version and release of each package listed. + +=item B<-f> + +Prints version, release and arch of each package listed. + +=back + +=head1 FILES + +See urpmi.files(5). + +=head1 SEE ALSO + +urpmi.addmedia(8), urpmi.update(8), urpmi.removemedia(8), urpmf(8), +urpmi(8), urpmi.files(5). + +=head1 AUTHOR + +Pascal Rigaux (original author), FranEois Pons, +Rafael Garcia-Suarez, (current maintainer) -- cgit v1.2.1