diff options
| -rw-r--r-- | pod/proxy.cfg.5.pod | 29 | ||||
| -rw-r--r-- | pod/rurpmi.8.pod | 35 | ||||
| -rw-r--r-- | pod/urpme.8.pod | 92 | ||||
| -rw-r--r-- | pod/urpmf.8.pod | 255 | ||||
| -rw-r--r-- | pod/urpmi.8.pod | 422 | ||||
| -rw-r--r-- | pod/urpmi.addmedia.8.pod | 206 | ||||
| -rw-r--r-- | pod/urpmi.cfg.5.pod | 169 | ||||
| -rw-r--r-- | pod/urpmi.files.5.pod | 83 | ||||
| -rw-r--r-- | pod/urpmi.removemedia.8.pod | 36 | ||||
| -rw-r--r-- | pod/urpmi.update.8.pod | 95 | ||||
| -rw-r--r-- | pod/urpmq.8.pod | 257 |
11 files changed, 1679 insertions, 0 deletions
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://]<host>[:port] + +proxy_user values are simply a user name, or a user name and a password +separated by a colon (C<:>). + +=head1 AUTHOR + +FranE<ccedil>ois Pons, Rafael Garcia-Suarez <rgarciasuarez@mandriva.com> +(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, +<rgarciasuarez@mandriva.com> + +=head1 SEE ALSO + +L<I<urpmi>(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<package_names> must have one of the forms +I<name>, I<name-version>, I<name-version-release>, or I<name-version-release.architecture>. +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<alias> + +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<alias> defines which extension module is to be used by +urpmi (currently, B<urpmi-parallel-ka-run> or B<urpmi-parallel-ssh> are +available) and which machines should be updated. This alias is defined in +the file F</etc/urpmi/parallel.cfg> as described below. + +=item B<--root> I<directory> + +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<directory> + +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 +<rgarciasuarez@mandriva.com> (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] <pattern-expression> + +=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. +<I<pattern-expression>> is the name or part of the name of the file you +want to locate. Perl-style regular expressions are allowed. B<urpmf> 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<urpmf> searches through the urpmi media (B<not> 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<directory> + +Use a different environment directly out of a bug report tarball. + +=item B<--excludemedia> I<medium1,...,mediumN> + +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<medium1,...,mediumN> + +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<medium1,...,mediumN> + +Sort the given media, substrings may be used to simplify grouping. + +=item B<--synthesis> I<file> + +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<urpmf> will only search through media +marked as update. + +=item B<--verbose> + +Verbose mode. B<urpmf> 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<string> + +Change field separator to I<string> for the rest of the output line (it +defaults to ':') + +=item B<--qf> I<format-string> + +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<tagname>. 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<perl-Apache> 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), FranE<ccedil>ois Pons, Rafael +Garcia-Suarez <rgarciasuarez@mandriva.com> (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<urpmi> will search +packages and resolve dependencies only in media marked as containing updates. + +=item B<--media> I<media1,...,mediaN> + +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<media1,...,mediaN> + +Do not use the specified media. + +=item B<--searchmedia> I<media> + +Use only the specified media to search for packages when combined with +B<--auto-select>. + +=item B<--sortmedia> I<media1,...,mediaN> + +Sort the specified media. Substrings may be used +to simplify grouping. + +=item B<--synthesis> I<file> + +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</var/cache/urpmi/rpms>. + +=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<number>> + +Split urpmi's operation in small transactions when +the total number of packages to upgrade is greater than the given I<number>. +This option is activated by default, and the default value of I<number> is +20. + +=item B<--split-length I<count>> + +Split urpmi's operation in small transactions of at +least I<count> 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<name> + +Search a source package matching I<name> 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</var/cache/urpmi/rpms>. + +=item B<--noclean> + +Do not remove any package from the cache in directory +F</var/cache/urpmi/rpms>. + +=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<alias> + +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<alias> defines which extension module is to be used by +urpmi (currently, B<urpmi-parallel-ka-run> or B<urpmi-parallel-ssh> are +available) and which machines should be updated. This alias is defined in +the file F</etc/urpmi/parallel.cfg> as described below. + +=item B<--root> I<directory> + +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<directory> + +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<rate>> + +Try to limit the download speed, I<rate> 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<times> + +Retries to download files over FTP or HTTP the specified number +of times. + +=item B<--proxy> I<proxyhost[:port|1080]> + +Use specified HTTP proxy. + +=item B<--proxy-user> I<user:password> + +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<directory> + +Create a bug report in I<directory>. You have to send a compressed +archive of the directory to the urpmi maintainer for the bug being (probably) +reproduced. + +=item B<--env> I<directory> + +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<rpm --test>) installation of packages but do +not modify the system. + +=item B<--excludepath> I<string> + +Do not install files of which the +names begin with the given I<string> (same as B<rpm --excludepath>). + +=item B<--excludedocs> + +Do not install documents files (same as B<rpm --excludedocs>). + +=item B<--ignoresize> + +Don't check +file systems for sufficient disk space before installation. This is equivalent +to B<rpm --ignoresize>. + +=item B<--skip> I<pattern,...> + +You can specify a list of packages which installation should be skipped. +You can also include patterns between //, just like in +F</etc/urpmi/skip.list> (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</home/foo/test.rpm> 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<foo-> 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<urpmi> please report it using the command : + + urpmi --bug bug_name_as_directory ... + +This will automatically create a directory called F<bug_name_as_directory> +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, <rgarciasuarez@mandriva.com> (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] <name> <url> [with <hdlist>] + +=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<urpmi.addmedia [I<options>>] <I<name>> http://<I<login>>:<I<pass>>@<I<host>>/<I<path>> [with <I<relative path of synthesis|hdlist>>] + +where <I<name>> is your reference for the medium (e.g. "updates"). +<I<name>> is optional if B<--distrib> is given in the options list. +<I<host>>/<I<path>> is the location of the media directory on the net +(e.g. C<media/main>). <I<relative path of hdlist>> is the pathname where +to find the hdlist of the rpms. The location is given relative to +<I<path>>. B<curl> is used by default to download files, B<wget> may be +used if B<curl> is not installed or if or B<--wget> is given in +I<options>. Example: + + urpmi.addmedia http http://jpackage.sf.net/rpm/free with hdlist.cz ftp: + +=item B<urpmi.addmedia [I<options>>] <I<name>> ftp://<I<login>>:<I<pass>>@<I<host>>/<I<path>> [with <I<relative path of synthesis|hdlist>>] + +The same as for http. Add your login and password if required (note that +you don't need to specify B<anonymous> as login for anonymous access ftp +servers). If B<wget> is used to download files with a firewall you may +have to ensure that the B<passive_ftp> option is on in B</etc/wgetrc> +(that's usually the default). Example: + + urpmi.addmedia ftp ftp://a:a@leia//export/media/main with media_info/hdlist.cz + +=item B<urpmi.addmedia [I<options>>] <I<name>> ssh://<I<login>>@<I<host>>/<I<path>> [with <I<relative path of synthesis|hdlist>>] + +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<scp> and B<rsync> will be used to get +files. Example: + + urpmi.addmedia -h ssh ssh://fpons@bi/c/i586/media/main + +=item B<urpmi.addmedia [I<options>>] <I<name>> rsync://<I<login>>@<I<host>>:<I<port>>/<I<path>> [with <I<relative path of synthesis|hdlist>>] + +The same as for http; you can use the <I<host>>::<I<path>> syntax too. Example: + + urpmi.addmedia rsync rsync://ftp.orst.edu::mandrake-devel/contrib/ppc with ../../cooker/ppc/media/media_info/hdlist2.cz + +=item B<urpmi.addmedia [I<options>>] <I<name>> file://<I<path>> [with <I<relative path of synthesis|hdlist>>] + +where <I<name>> is your reference for the medium (e.g. Myrpms). <I<path>> +is the location of the media directory on your machine (e.g. C<media/main>). + +=item B<urpmi.addmedia [I<options>>] <I<name>> removable://<I<path>> [with <I<relative path of synthesis|hdlist>>] + +<I<path>> 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<urpmi.addmedia>). + +=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<rate>> + +Try to limit the download speed, I<rate> is given in bytes/sec. This option +is not active by default. + +=item B<--proxy> I<proxyhost[:port|1080]> + +Use specified HTTP proxy. + +=item B<--proxy-user> I<user:password> + +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<MandrivaUpdate> or by B<urpmi --update> when looking for updates. + +=item B<--probe-synthesis> + +Try to find and use synthesis file if B<with ...> is not given. + +=item B<--probe-hdlist> + +Try to find and use hdlist file if B<with ...> 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<urpmi.addmedia> will represent the parent directory of a directory +B<media>, which in turn will contain various subdirectories for each +medium of the distribution. <I<name>> is combined with medium names found +to create newer medium names in the urpmi database. The B<with ...> +option, if provided, is ignored, as hdlists found on the installation +medium are used instead automatically. + +=item B<--from> I<url> + +Use specified URL for list of mirrors. The default is taken from the file +F</etc/urpmi/mirror.config>, or +F<http://www.mandrivalinux.com/mirrorsfull.list> if this file doesn't +exist. + +=item B<--version> I<version> + +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<file://> and +C<removable://> protocols, and no files will be created in +F</var/lib/urpmi>. The medium is always up-to-date and so it does not need +to be updated by B<urpmi.update>. + +=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<urpmi.update>. + +=item B<--nopubkey> + +Don't import pubkey of added media. + +=item B<-c> + +Clean headers cache directory in F</var/cache/urpmi/headers>. + +=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</mnt/mirror/$RELEASE/$ARCH/media/main>). The variables supported +so far are: + +=over + +=item B<$ARCH> + +The architecture (as given in F</etc/mandriva-release>) + +=item B<$RELEASE> + +The OS release (as given in F</etc/mandriva-release>; its value is +B<cooker> 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), FranE<ccedil>ois Pons, Rafael +Garcia-Suarez, <rgarciasuarez@mandriva.com> (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<allow-force> + +Same as specifying B<--allow-force> for B<urpmi>, disabled by default. + +=item B<allow-nodeps> + +Same as specifying B<--allow-nodeps> for B<urpmi>, disabled by default. + +=item B<downloader> + +Specify which download program to use: B<wget> or B<curl>. + +=item B<excludedocs> + +Same as specifying B<--excludedocs> for B<urpmi>, disabled by default. + +=item B<excludepath> + +Same as B<--excludepath> for B<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<fuzzy> + +Same as B<--fuzzy> for B<urpmi> or B<urpmq>. Enable or disable fuzzy +search, disabled by default. Enabling it can be written in various ways : +C<fuzzy> or C<fuzzy: yes> or C<fuzzy: on> or C<fuzzy: 1>. + +=item B<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 B<rpm>) for any medium unless a specific B<key-ids> option +for this medium is given. There is no default (even Mandriva public key id +70771ff3 is not included by default). + +=item B<limit-rate> + +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<K> or C<M> is added. + +=item B<nopubkey> + +Don't import pubkeys when updating media. + +=item B<noreconfigure> + +Specifies that the media should not be reconfigured (by a reconfiguration +file present on the medium). + +=item B<norebuild> + +Same as B<--norebuild> for B<urpmi>, B<urpmi.update> and +B<urpmi.addmedia>, disabled by default (meaning that B<urpmi> will try to +rebuild hdlists by default). + +=item B<pre-clean, post-clean, clean> + +Control cache management for B<urpmi>, default is only activated as +B<post-clean>. + +=item B<prohibit-remove> + +A comma-separated list of package names that must never be removed (just +like B<basesystem> dependencies). + +=item B<retry> + +Specify how many times the downloader should retry in case of non-permanent +errors. + +=item B<split-length> + +Same as B<--split-length> for B<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. + +=item B<split-level> + +Same as B<--split-level> for B<urpmi>. 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<strict-arch> + +Same as B<--strict-arch> for B<urpmi>. Boolean option, disabled by +default, meaning that packages can be upgraded with versions for another +architecture. + +=item B<verify-rpm> + +Same as B<--verify-rpm> for B<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<no-verify-rpm> or C<verify-rpm: no> +or C<verify-rpm: off> or C<verify-rpm: 0>. + +=back + +=head1 MEDIUM DESCRIPTION + +A medium is described as follows : + + name url { + hdlist: ... + ... list of options, one per line ... + } + +where B<name> is the medium name (space characters must be prefixed by a +backslash) and where the optional B<url> is the medium URL (if no B<url> +is given, it will be guessed according to the mandatory list file). + +Most other options like B<list>, B<with_hdlist>, B<synthesis>, +B<removable>, B<virtual> are for internal use and should be changed only +by experienced users. + +Options like B<update>, B<ignore> or B<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 B<verify-rpm> and +B<downloader> in a medium description. + +Media can be marked as B<static>: this means that they won't be updated by +B<urpmi.update> or other means. This is useful for read-only media such as +CDs. + +Please note that B<key-ids> is automatically set by B<urpmi.update> or +B<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), Francois Pons, Rafael Garcia-Suarez, +<rgarciasuarez@mandriva.com> (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</var/lib/urpmi/list.<media_name>> + +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</var/lib/urpmi/hdlist.<media_name>.cz> + +Contains information about all known packages; it's a summary of rpm +headers. If an hdlist file is used for a medium, B<urpmf> can operate +completely without accessing this medium (this is almost always the case). + +=item I</var/lib/urpmi/synthesis.hdlist.<media_name>.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</etc/urpmi/urpmi.cfg> + +Contains media descriptions. +See urpmi.cfg(5). + +=item I</etc/urpmi/proxy.cfg> + +Contains proxy descriptions for http and ftp media. See proxy.cfg(5). + +=item I</etc/urpmi/parallel.cfg> + +Contains the descriptions of parallel aliases, one per line. Their general +format is B<< <alias>:<interface[(media)]>:<interface_parameter> >> where +B<< <alias> >> is a symbolic name to identify the parallel alias, B<< +<interface> >> is one of the parallel install methods (can be B<ka-run> or +B<ssh>), B<< <media> >> is a media list (as given to the B<--media> +parameter), and finally B<< <interface_parameter> >> is a specific interface +parameter list like C<-c ssh -m node1 -m node2> for B<ka-run> extension or +C<node1:node2> (list of node hostnames) for B<ssh> extension. + +=item I</etc/urpmi/skip.list> + +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<name-version-release.arch>.) + +=item I</etc/urpmi/inst.list> + +The list of packages that should be installed instead of updated. It has +the same format as the skip.list. + +=item I</etc/urpmi/mirror.config> + +This file is optional. If present, it should contain a single line: +B<url=http://....> which is the URL of a document that lists the available +mirrors. The default is to use +B<http://www.mandrivalinux.com/mirrorsfull.list>. + +=item I</var/log/urpmi.log> + +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. <I<names>> 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</var/cache/urpmi/headers>). + +=back + +=head1 SEE ALSO + +urpmi(8), urpmi.addmedia(8), urpmi.update(8). + +=head1 AUTHOR + +Pascal Rigaux (original author), FranE<ccedil>ois Pons, +Rafael Garcia-Suarez, <rgarciasuarez@mandriva.com> (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] [<names>] + +=head1 DESCRIPTION + +urpmi.update scans the specified urpmi media to update their package list. +<I<names>> 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<rate>> + +Try to limit the download speed, I<rate> is given in bytes/sec. This +option is not active by default. + +=item B<--proxy> I<proxyhost[:port|1080]> + +Use specified HTTP proxy. + +=item B<--proxy-user> I<user:password> + +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), FranE<ccedil>ois Pons, +Rafael Garcia-Suarez, <rgarciasuarez@mandriva.com> (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<type>] + +List available media. You can optionally add a type selector: B<all> to +list all media (the default), B<update> to list the update media, or +B<active> 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<urpmq> will search and resolve dependencies only in +media marked as containing updates. + +=item B<--media> I<media1,...,mediaN> + +Select specific +media to be used, instead of all available media (or update media if B<--update> +is used). + +=item B<--excludemedia> I<media1,...,mediaN> + +Do not use the specified media. + +=item B<--searchmedia> I<media> + +Use only the specified medium to search for packages when combined with +B<--auto-select>. + +=item B<--sortmedia> I<media1,...,mediaN> + +Sort the specified media. Substrings may be used to simplify grouping. + +=item B<--synthesis> I<file> + +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<name> + +Search a source package +matching I<name> 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<alias> + +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<alias> defines which extension module to use by urpmi +(currently B<urpmi-parallel-ka-run> or B<urpmi-parallel-ssh>) and which +machines should be updated, this alias is defined in the file +F</etc/urpmi/parallel.cfg> as described below. + +=item B<--root> I<directory> + +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<proxyhost[:port|1080]> + +Use specified HTTP proxy. + +=item B<--proxy-user> I<user:password> + +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<directory> + +Configure urpmq on the fly from a distrib tree. You must be root to use +this option. + +=item B<--env> I<directory> + +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<urpmi>. + +=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<rpm -qi>. + +=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), FranE<ccedil>ois Pons, +Rafael Garcia-Suarez, <rgarciasuarez@mandriva.com> (current maintainer) |