From 8efdb18a2d30db87bec6df08110c1f806a65b9be Mon Sep 17 00:00:00 2001 From: Rafael Garcia-Suarez Date: Fri, 25 Nov 2005 17:48:34 +0000 Subject: Small manpage updates --- pod/rurpmi.8.pod | 15 +++++++------ pod/urpme.8.pod | 22 ++++++++++++------- pod/urpmi.files.5.pod | 9 ++++---- pod/urpmi.update.8.pod | 59 +++++++++++++++++++++++++------------------------- 4 files changed, 55 insertions(+), 50 deletions(-) diff --git a/pod/rurpmi.8.pod b/pod/rurpmi.8.pod index 03957cda..aa13f113 100644 --- a/pod/rurpmi.8.pod +++ b/pod/rurpmi.8.pod @@ -9,12 +9,13 @@ rurpmi - restricted urpmi =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>). +intended to be used by users without root privileges but with sudo rights +on it, preventing any abuse of this tool to compromise the system. + +With rurpmi, you can't install arbitrary rpm files; moreoever 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 @@ -32,4 +33,4 @@ Maintained by Rafael Garcia-Suarez, =head1 SEE ALSO -L(8)>. +urpmi(8). diff --git a/pod/urpme.8.pod b/pod/urpme.8.pod index 4ce455a2..e7810263 100644 --- a/pod/urpme.8.pod +++ b/pod/urpme.8.pod @@ -19,19 +19,19 @@ If you want to specify packages more broadly, use the B<-a> option. =item B<--help> -Prints a help message and exit (this is the same as B<-h> or B<-?>). +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. +If multiple packages match the given substring, deinstall them all. =item B<-v> -Proposes a verbose mode with various messages. +Proposes a verbose mode with various messages. =item B<--auto> -Removes packages non-interactively, without asking questions. +Removes packages non-interactively, without asking questions. =item B<--test> @@ -39,7 +39,7 @@ Test deinstallation of packages but do not modify the system. =item B<--force> -Force invocation even if some packages do not exist. +Force invocation even if some packages do not exist. =item B<--parallel> I @@ -48,7 +48,7 @@ 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. +the file F as described below. =item B<--root> I @@ -71,9 +71,15 @@ See urpmi.files(5). =over +=item 0 + +Success; or nothing was found to remove; or the user cancelled the whole +operation. + =item 1 -Command line inconsistency. +Command line inconsistency, invocation failure (you are not root), or +packages not found. =item 2 @@ -89,4 +95,4 @@ Pascal Rigaux, Francois Pons, Rafael Garcia-Suarez =head1 SEE ALSO urpmi.addmedia(8), urpmi.update(8), urpmi.removemedia(8), urpmf(8), -urpmi(8), urpmq(8), urpmi.files(5). +urpmi(8), urpmq(8), urpmi.files(5). diff --git a/pod/urpmi.files.5.pod b/pod/urpmi.files.5.pod index d11385e9..54382b01 100644 --- a/pod/urpmi.files.5.pod +++ b/pod/urpmi.files.5.pod @@ -12,20 +12,20 @@ media). This manual page documents them. =over -=item I> +=item I<< /var/lib/urpmi/list. >> 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> +=item I<< /var/lib/urpmi/hdlist..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> +=item I<< /var/lib/urpmi/synthesis.hdlist..cz >> Contains synthesis information about all known packages built from hdlist files that can be used by minimal closure algorithm. If these files are @@ -34,8 +34,7 @@ not present, hdlist files will be used instead to resolve dependencies =item I -Contains media descriptions. -See urpmi.cfg(5). +Contains media descriptions. See urpmi.cfg(5). =item I diff --git a/pod/urpmi.update.8.pod b/pod/urpmi.update.8.pod index b3545fce..186d8dc5 100644 --- a/pod/urpmi.update.8.pod +++ b/pod/urpmi.update.8.pod @@ -9,71 +9,70 @@ urpmi.update - Updates package lists for specified media =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. +> 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<--force-key> + +Force update of GPG key. + +=item B<--ignore>, B<--no-ignore> + +Don't update media, but mark them as ignored (that is, disables them). +B<--no-ignore> has the reverse behaviour: it marks the media as enabled. + =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<--no-md5sum> + +Disable MD5SUM file checking. + +=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<--proxy> I -Use specified HTTP proxy. +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. +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. +Use only update media. -=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> +=item B<--wget> -Don't update media, but mark them -as ignored (disables them). B<--no-ignore> has the reverse behaviour: it marks -the media as enabled. +Use wget for downloading distant files. By default curl +is used if available, or wget instead. =item B<-a> -Select all media that are not using a removable device to update them. +Select all media that are not using a removable device to update them. =item B<-c> -Clean /var/cache/urpmi/headers directory on exit. +Clean F directory on exit. =item B<-f> -Force rebuild of base files, or of hdlist files when specified twice. +Force rebuild of base files, or of hdlist files when specified twice. =item B<-q> @@ -92,4 +91,4 @@ urpmi(8), urpmi.addmedia(8), urpmi.removemedia(8). =head1 AUTHOR Pascal Rigaux (original author), FranEois Pons, -Rafael Garcia-Suarez, (current maintainer) +Rafael Garcia-Suarez, (current maintainer) -- cgit v1.2.1