From e2f6e178f6cbd8da5cc2250297faa7efbfa4dc9d Mon Sep 17 00:00:00 2001 From: Pablo Saratxaga Date: Wed, 29 Aug 2001 17:20:36 +0000 Subject: changed man page structure to allow translations --- man/C/autoirpm.8 | 51 ++++++++++++++++++ man/C/urpmf.8 | 104 +++++++++++++++++++++++++++++++++++ man/C/urpmi.8 | 135 ++++++++++++++++++++++++++++++++++++++++++++++ man/C/urpmi.addmedia.8 | 114 +++++++++++++++++++++++++++++++++++++++ man/C/urpmi.removemedia.8 | 64 ++++++++++++++++++++++ man/C/urpmi.update.8 | 75 ++++++++++++++++++++++++++ man/C/urpmq.8 | 120 +++++++++++++++++++++++++++++++++++++++++ 7 files changed, 663 insertions(+) create mode 100644 man/C/autoirpm.8 create mode 100644 man/C/urpmf.8 create mode 100644 man/C/urpmi.8 create mode 100644 man/C/urpmi.addmedia.8 create mode 100644 man/C/urpmi.removemedia.8 create mode 100644 man/C/urpmi.update.8 create mode 100644 man/C/urpmq.8 (limited to 'man/C') diff --git a/man/C/autoirpm.8 b/man/C/autoirpm.8 new file mode 100644 index 00000000..5bdce60b --- /dev/null +++ b/man/C/autoirpm.8 @@ -0,0 +1,51 @@ +.TH autoirpm 8 "05 Sep 2000" "Mandrakesoft" "Linux-Mandrake" +.IX autoirpm +.SH NAME +autoirpm \- auto installs the RPM matching your command +.SH SYNOPSIS +.B autoirpm +.SH DESCRIPTION +autoirpm *magically* guesses which package you need and installs it. +Let's imagine that you typed gmix to launch your sound mixer. If it is +not available, you are then asked if you wish to install the package +gnome-media which contains the gmix binary... +.PP +To do so, launch autoirpm.update-all, which scans all packages known by +urpmi for all binary executables. It then creates links in respective binary +directories... +Use autoirpm.uninstall to remove all links created by autoirpm.update. +.PP +use \fBautoirpm.update \fP to update executables contained in packages +of d media. +.PP +use \fBautoirpm.update-all\fP to update executables contained in packages of +all medias known by urpmi. +.PP +use \fBautoirpm.uninstall\fP to remove all links installed by autoirpm. +.PP +This feature may be offered for menu icons installing autoirpm-icons package. +.SH FILES +/etc/urpmi/autoirpm.deny +.br +All binaries contained in packages listed in this file won't lead to an auto install of rpm. +.PP +/etc/urpmi/autoirpm.allow +.br +If present, only binaries of listed packages will offer the feature of +auto-install. + +.SH "SEE ALSO" +urpmi(8) +.SH AUTHOR +Pascal Rigaux, Mandrakesoft +.br +pixel@mandrakesoft.com + + + + + + + + + diff --git a/man/C/urpmf.8 b/man/C/urpmf.8 new file mode 100644 index 00000000..8b49d6ad --- /dev/null +++ b/man/C/urpmf.8 @@ -0,0 +1,104 @@ +.TH urpmf 8 "05 Jul 2001" "MandrakeSoft" "Mandrake Linux" +.IX urpmf +.SH NAME +urpmf \- RPMFind - Finds the RPM package providing the specified file +.SH SYNOPSIS +.B urpmf [\fIoptions\fP] <\fIfile\fP> +.SH DESCRIPTION +urpmf outputs a list of packages providing the file specified as an argument. +.PP +<\fIfile\fP> is the name of the file you wish to know the package providing +it. Note that you may type just a substring of the file you are looking for, +\fBurpmf\fP will then print a list of matching files with their corresponding +packages. +.PP +urpmf searches through installed and uninstalled packages. +.SH OPTIONS +.IP "\fB\--help\fP" +print an help message and exit. +.IP "\fB\--quiet\fP" +do not print tag name (default if no tag given on command line, incompatible +with interactive mode). +.IP "\fB\--all\fP" +print all tags. +.IP "\fB\--name\fP" +print tag name: rpm filename (assumed if no tag given on command line but +without package name). +.IP "\fB\--group\fP" +print tag group: group. +.IP "\fB\--size\fP" +print tag size: size. +.IP "\fB\--serial\fP" +print tag serial: serial. +.IP "\fB\--summary\fP" +print tag summary: summary. +.IP "\fB\--description\fP" +print tag description: description. +.IP "\fB\--provides\fP" +print tag provides: all provides (mutliple lines). +.IP "\fB\--requires\fP" +print tag requires: all requires (multiple lines). +.IP "\fB\--files\fP" +print tag files: all files (multiple lines). +.IP "\fB\--conflicts\fP" +print tag conflicts: all conflicts (multiple lines). +.IP "\fB\--obsoletes\fP" +print tag obsoletes: all obsoletes (multiple lines). +.IP "\fB\--prereqs\fP" +print tag prereqs: all prereqs (multiple lines). +.SH FILES +/usr/bin/urpmf +.br +The \fBurpmf\fP executable (perl script) +.PP +/var/lib/urpmi/list.* +.br +Contains the list of all packages known by urpmi and their location. +There is one filelist per media(*). +.PP +/var/lib/urpmi/hdlist.* +.br +Contain information about all known packages, it's a summary of rpm headers. +There is one filelist per media(*). +.PP +/var/lib/urpmi/synthesis.hdlist.* +.br +Contain synthesis information about all known packages built from hdlist files +that can be used by minimal closure algorithm. If these files are not present +use \fBurpmi.update -a\fP to generate them. These files are not mandatory. +.PP +/etc/urpmi/urpmi.cfg +.br +Contains media description, previous format from older urpmi is accepted. +.PP +/etc/urpmi/skip.list +.br +Contains package names that should be not automatically updated. +.PP +/var/lib/urpmi/depslist.ordered +.br +A simple text file containing all dependencies of all known packages. +.PP +/var/lib/urpmi/provides +.br +A simple text file containning all provides and the list of associated +packages that contains them. +.PP +/var/lib/urpmi/compss +.br +A simple text file containning for each Group used the list of package in +this group. +.SH "SEE ALSO" +urpmi(8), +urpmq(8), +urpmi.addmedia(8), +urpmi.update(8), +urpmi.removemedia(8), +autoirpm(8), +autoirpm-icons(8), +gurpmi(8), +rpmdrake(8) +.SH AUTHOR +Pascal Rigaux, Mandrakesoft +.br +Francois Pons, Mandrakesoft diff --git a/man/C/urpmi.8 b/man/C/urpmi.8 new file mode 100644 index 00000000..d9bb9326 --- /dev/null +++ b/man/C/urpmi.8 @@ -0,0 +1,135 @@ +.TH urpmi 8 "05 Jul 2001" "MandrakeSoft" "Mandrake Linux" +.IX urpmi +.SH NAME +urpmi \- rpm wrapper making installs easier for the user +.SH SYNOPSIS +.B urpmi [\fIoptions\fP] [\fIpackage_names\fP | \fIrpm_files...\fP] +.SH DESCRIPTION +urpmi enables non-superuser install of rpms. In fact, it only authorizes +well-known rpms to be installed. If you want to install local rpm file, you +will have to be root. + +You can compare rpm vs. urpmi with insmod vs. modprobe or dpkg vs apt-get +.PP +All users belonging to group urpmi are allowed to install packages. +.br +Just launch urpmi followed by what you think is the name of the package(s), +and urpmi will: +.br +\- Propose different package names if availables and quit. +.br +\- If only one corresponding package is found, check whether dependencies are +already installed, or not. +.br +\- If not, propose to install the dependencies and then install all required +dependencies and the package. +.PP +Note that urpmi handle installations from various medias (ftp, http, local and +nfs volumes, removable medias such as CDROMs) and is able to install +dependencies from a media different from the package's media. +If necessary, urpmi asks you to insert the required media. +.PP +To add a new media containing rpms run urpmi.addmedia. +.br +To remove a media use urpmi.removemedia. +.br +To update the packages list (for example when the ftp archive changed) use +urpmi.update. +.br +To automatically install a package corresponding to an executable you tried +to launch, use autoirpm. +.br +To install all available menu entries of all known packages, +use autoirpm-icons. +.SH OPTIONS +.IP "\fB\--help\fP" +print an help message and exit. +.IP "\fB\--update\fP" +use only update media. This means \fBurpmi\fP will search and resolve +dependencies only in media marked as update. +.IP "\fB\--auto\fP" +installs all required dependencies without asking. +.IP "\fB\--auto-select\fP" +automatically select all packages that have to be upgraded according to already +installed packages and packages listed in various media registered. +.IP "\fB\--force\fP" +assumes yes on all questions. +.IP "\fB\--X\fP" +use X interface. +.IP "\fB\--best-output\fP" +try to use X interface or if not available the standard text interface (using +rpm). +.IP "\fB\-a\fP" +if multiple packages match the substring given, take them all +.IP "\fB\-m\fP" +choose minimun closure of requires (this is the default). This is a relatively +slow algorithm that tries to minimize the number of package to upgrade +to only what is really necessary. +.IP "\fB\-M\fP" +choose maximal closure of requires. This is the fastest algorithms that try to +upgrade all requires if they can be upgraded. +.IP "\fB\-c\fP" +if maximal closure is used, assume that a package listed mey have wrong or not +up-to-date dependancies. This cause more package to be upgraded and may correct +unresolved dependancies on the rpm database. +.IP "\fB\-p\fP" +allow search in provides to find package. +.IP "\fB\-q\fP" +proposes a quiet mode when calling rpm where no upgrade status are printed. +.IP "\fB\-v\fP" +proposes a verbose mode with various messages. +.SH FILES +/usr/bin/urpmi +.br +The \fBurpmi\fP executable (perl script) +.PP +/var/lib/urpmi/list.* +.br +Contains the list of all packages known by urpmi and their location. +There is one filelist per media(*). +.PP +/var/lib/urpmi/hdlist.* +.br +Contain information about all known packages, it's a summary of rpm headers. +There is one hdlist per media(*). +.PP +/var/lib/urpmi/synthesis.hdlist.* +.br +Contain synthesis information about all known packages built from hdlist files +that can be used by minimal closure algorithm. If these files are not present +use \fBurpmi.update -a\fP to generate them. These files are not mandatory. +.PP +/etc/urpmi/urpmi.cfg +.br +Contains media description, previous format from older urpmi is accepted. +.PP +/etc/urpmi/skip.list +.br +Contains package names that should be not automatically updated. +.PP +/var/lib/urpmi/depslist.ordered +.br +A simple text file containning all dependencies of all known packages. +.PP +/var/lib/urpmi/provides +.br +A simple text file containning all provides and the list of associated +packages that contains them. +.PP +/var/lib/urpmi/compss +.br +A simple text file containning for each Group used the list of package in +this group. +.SH "SEE ALSO" +urpmi.addmedia(8), +urpmi.update(8), +urpmi.removemedia(8), +autoirpm(8), +gurpmi(8), +urpmf(8), +urpmq(8), +rpmdrake(8) +.SH AUTHOR +Pascal Rigaux, Mandrakesoft +.br +Francois Pons, Mandrakesoft diff --git a/man/C/urpmi.addmedia.8 b/man/C/urpmi.addmedia.8 new file mode 100644 index 00000000..57e6de26 --- /dev/null +++ b/man/C/urpmi.addmedia.8 @@ -0,0 +1,114 @@ +.TH urpmi.addmedia 8 "05 Jul 2001" "MandrakeSoft" "Mandrake Linux" +.IX urpmi.addmedia +.SH NAME +urpmi.addmedia \- adds a new rpms media for use with urpmi +.SH SYNOPSIS +.B urpmi.addmedia [\fIoptions\fP] <\fIname\fP> <\fIurl\fP> +.SH DESCRIPTION +urpmi.addmedia tells urpmi that he can find new rpms at the specified +location. Currently supported medias are: local drives, removable drives +(such as cd's), http and ftp. +.PP +All users belonging to group urpmi are allowed to add a new media. +.PP +One of the following modes must be choosen: +.PP +http: +.br +.IP "\fB urpmi.addmedia <\fIname\fP> http://<\fIhost\fP>/<\fIpath\fP> with <\fIrelative path of hdlist\fP>\fP" +Where <\fIname\fP> is your reference for the media (e.g. MandrakeUpdate). +.br +<\fIhost\fP>/<\fIpath\fP> is the location of the rpm directory on the net. +.br +<\fIrelative path of hdlist\fP> is the pathname where to find the hdlist of +the rpms. The location is given relative to <\fIpath\fP>. +.br +Note that \fBwget\fP is used to download files, you may add specific options to +\fBwget\fP by editing \fB/etc/wgetrc\fP file. Please refer to \fBwget\fP +documentation for more information. +.IP "\fB urpmi.addmedia <\fIname\fP> ftp://<\fIlogin\fP>:<\fIuser\fP>@<\fIhost\fP>/<\fIpath\fP> with <\fIrelative path of hdlist\fP>\fP" +The same as for http, just add your login and user if required (Note that +you needn't to specify anonymous as login for anonymous access ftp servers). +.br +Note that \fBwget\fP is used to download files, so if a firewall is used you may +have to add \fBpassive_ftp=on\fP option to \fB/etc/wgetrc\fP. +.nf +eg: urpmi.addmedia ftp ftp://a:a@leia//export/Mandrake/RPMS with ../base/hdlist +.fi +.PP +Local drive or NFS: +.br +.IP "\fB urpmi.addmedia <\fIname\fP> file://<\fIpath\fP>\fP with <\fIrelative path of hdlist\fP>\fP" +Where <\fIname\fP> is your reference for the media (e.g. Myrpms). +.br +<\fIpath\fP> is the location of the rpm directory on your machine. +.PP +Removable device: +.br +.IP "\fB urpmi.addmedia removable_<\fIdevice\fP>://<\fIpath\fP>\fP with <\fIrelative path of hdlist\fP>\fP" +<\fIdevice\fP> is the name of your media as specified in the /dev/ directory +(e.g. cdrom, floppy, zip, ...). +.br +<\fIpath\fP> is the location of the rpm directory on your machine when media +is mounted. +.PP +.SH OPTIONS +.IP "\fB\--update\fP" +add a medium which will be taken into account when updating only update media by +\fBurpmi\fP. +.SH FILES +/usr/bin/urpmi +.br +The \fBurpmi\fP executable (perl script) +.PP +/var/lib/urpmi/list.* +.br +Contains the list of all packages known by urpmi and their location. There +is one filelist per media(*). +.PP +/var/lib/urpmi/hdlist.* +.br +Contain information about all known packages, it's a summary of rpm headers. +There is one filelist per media(*). +.PP +/var/lib/urpmi/synthesis.hdlist.* +.br +Contain synthesis information about all known packages built from hdlist files +that can be used by minimal closure algorithm. If these files are not present +use \fBurpmi.update -a\fP to generate them. These files are not mandatory. +.PP +/etc/urpmi/urpmi.cfg +.br +Contains media description, previous format from older urpmi is accepted. +.PP +/etc/urpmi/skip.list +.br +Contains package names that should be not automatically updated. +.PP +/var/lib/urpmi/depslist.ordered +.br +A simple text file containing all dependencies of all known packages. +.PP +/var/lib/urpmi/provides +.br +A simple text file containning all provides and the list of associated +packages that contains them. +.PP +/var/lib/urpmi/compss +.br +A simple text file containning for each Group used the list of package in +this group. +.SH "SEE ALSO" +urpmi(8), +urpmi.update(8), +urpmi.removemedia(8), +autoirpm(8), +autoirpm-icons(8), +gurpmi(8), +urpmf(8), +urpmq(8), +rpmdrake(8) +.SH AUTHOR +Pascal Rigaux, Mandrakesoft +.br +Francois Pons, Mandrakesoft diff --git a/man/C/urpmi.removemedia.8 b/man/C/urpmi.removemedia.8 new file mode 100644 index 00000000..6b348f44 --- /dev/null +++ b/man/C/urpmi.removemedia.8 @@ -0,0 +1,64 @@ +.TH urpmi.removemedia 8 "05 Jul 2001" "MandrakeSoft" "Mandrake Linux" +.IX urpmi.removemedia +.SH NAME +urpmi.removemedia \- remove a rpms media from the known medias of urpmi +.SH SYNOPSIS +.B urpmi.removemedia [options] <\fInames\fP> +.SH DESCRIPTION +urpmi.removemedia removes from all configuration files all references to +the named media and to rpms from that media. +.PP +<\fInames\fP> is a list of names you first told to urpmi.addmedia + +.SH OPTIONS +.IP "\fB\-a\fP" +Select all media to remove them. +.SH FILES +/usr/bin/urpmi +.br +The \fBurpmi\fP executable (perl script) +.PP +/var/lib/urpmi/list.* +.br +Contains the list of all packages known by urpmi and their location. +There is one filelist per media(*). +.PP +/var/lib/urpmi/hdlist.* +.br +Contain information about all known packages, it's a summary of rpm headers. +There is one filelist per media(*). +.PP +/etc/urpmi/urpmi.cfg +.br +Contains media description, previous format from older urpmi is accepted. +.PP +/etc/urpmi/skip.list +.br +Contains package names that should be not automatically updated. +.PP +/var/lib/urpmi/depslist.ordered +.br +A simple text file containing all dependencies of all known packages. +.PP +/var/lib/urpmi/provides +.br +A simple text file containning all provides and the list of associated +packages that contains them. +.PP +/var/lib/urpmi/compss +.br +A simple text file containning for each Group used the list of package in +this group. +.SH "SEE ALSO" +urpmi(8), +urpmi.addmedia(8), +autoirpm(8), +autoirpm-icons(8), +gurpmi(8), +urpmf(8), +urpmq(8), +rpmdrake(8) +.SH AUTHOR +Pascal Rigaux, Mandrakesoft +.br +Francois Pons, Mandrakesoft diff --git a/man/C/urpmi.update.8 b/man/C/urpmi.update.8 new file mode 100644 index 00000000..ef28a86f --- /dev/null +++ b/man/C/urpmi.update.8 @@ -0,0 +1,75 @@ +.TH urpmi.update 8 "05 Jul 2001" "MandrakeSoft" "Mandrake Linux" +.IX urpmi.update +.SH NAME +urpmi.update \- Updates packages list for specified medias +.SH SYNOPSIS +.B urpmi.update [options] [<\fInames\fP>] +.SH DESCRIPTION +urpmi.update scans all the <\fInames\fP> media to update their packages list. +Usefull for ftp location for example. +.PP +<\fInames\fP> is a list of name you first told to urpmi.addmedia + +.SH OPTIONS +.IP "\fB\-a\fP" +Select all media that are not using a removable device to update them. +.IP "\fB\-c\fP" +Clean /var/cache/urpmi/headers directory on exit. +.IP "\fB\-f\fP" +Force rebuild of hdlist files or base files (/var/lib/urpmi/depslist.ordered, +/var/lib/urpmi/provides and /var/lib/urpmi/compss). +.SH FILES +/usr/bin/urpmi +.br +The \fBurpmi\fP executable (perl script) +.PP +/var/lib/urpmi/list.* +.br +Contains the list of all packages known by urpmi and their location. +There is one filelist per media(*). +.PP +/var/lib/urpmi/hdlist.* +.br +Contain information about all known packages, it's a summary of rpm headers. +There is one filelist per media(*). +.PP +/var/lib/urpmi/synthesis.hdlist.* +.br +Contain synthesis information about all known packages built from hdlist files +that can be used by minimal closure algorithm. If these files are not present +use \fBurpmi.update -a\fP to generate them. These files are not mandatory. +.PP +/etc/urpmi/urpmi.cfg +.br +Contains media description, previous format from older urpmi is accepted. +.PP +/etc/urpmi/skip.list +.br +Contains package names that should be not automatically updated. +.PP +/var/lib/urpmi/depslist.ordered +.br +A simple text file containing all dependencies of all known packages. +.PP +/var/lib/urpmi/provides +.br +A simple text file containning all provides and the list of associated +packages that contains them. +.PP +/var/lib/urpmi/compss +.br +A simple text file containning for each Group used the list of package in +this group. +.SH "SEE ALSO" +urpmi(8), +urpmi.addmedia(8), +urpmf(8), +urpmq(8), +autoirpm(8), +autoirpm-icons(8), +gurpmi(8), +rpmdrake(8) +.SH AUTHOR +Pascal Rigaux, Mandrakesoft +.br +Francois Pons, Mandrakesoft diff --git a/man/C/urpmq.8 b/man/C/urpmq.8 new file mode 100644 index 00000000..b347f2e9 --- /dev/null +++ b/man/C/urpmq.8 @@ -0,0 +1,120 @@ +.TH urpmq 8 "05 Jul 2001" "MandrakeSoft" "Mandrake Linux" +.IX urpmq +.SH NAME +urpmq \- urpmi database query tool. +.SH SYNOPSIS +.B urpmq [\fIoptions\fP] [\fIpackage_names\fP | \fIrpm_files...\fP] +.SH DESCRIPTION +urpmq allows querying the urpmi database. It is for you if want to list +available packages in the various media of urpmi, or list dependancies of +packages or packages that will be installed if you start urpmi. +.PP +Output format of urpmq is the following according to command line options: +.IP +[group/]package_name[-version][-release] +.SH OPTIONS +.IP "\fB\--help\fP" +print an help message and exit. +.IP "\fB\--update\fP" +use only update media. This means \fBurpmq\fP will search and resolve +dependencies only in media marked as update. +.IP "\fB\--auto-select\fP" +automatically select all packages that have to be upgraded according to already +installed packages and packages listed in various media registered. +.IP "\fB\--headers\fP" +extract headers for package selected to standard output. +.IP "\fB\--sources\fP" +print source url (or file) of all packages selected. +.IP "\fB\--force\fP" +ignore error of inexistant packages requested. +.IP "\fB\-v\fP" +activate verbose mode. +.IP "\fB\-d\fP" +select dependancies (maximal closure). +.IP "\fB\-u\fP" +deselect packages if a better version is already installed, this option can be +used with \fB-d\fP to simulate \fB-M\fP mode of \fBurpmi\fP. +.IP "\fB\-m\fP" +choose minimun closure of requires. This is a relatively +slow algorithm that tries to minimize the number of package to upgrade +to only what is really necessary. +.IP "\fB\-M\fP" +disable minimal closure algorithm so both \fB-d\fP and \fB-u\fP are similar to \fB-M\fP +mode of \fBurpmi\fP. +.IP "\fB\-c\fP" +if maximal closure is used, assume that a package listed mey have wrong or not +up-to-date dependancies. This cause more package to be upgraded and may correct +unresolved dependancies on the rpm database. +.IP "\fB\-p\fP" +allow search in provides to find package. +.IP "\fB\-g\fP" +print group of each packages listed. +.IP "\fB\-r\fP" +print version and release of each packages listed. +.IP "\fB\-d\fP" +print closure of required packages needed by requested packages on command +line. +.SH FILES +/usr/bin/urpmq +.br +The \fBurpmq\fP executable (perl script) +.PP +/var/lib/urpmi/list.* +.br +Contains the list of all packages known by urpmi and their location. +There is one filelist per media(*). +.PP +/var/lib/urpmi/hdlist.* +.br +Contain information about all known packages, it's a summary of rpm headers. +There is one filelist per media(*). +.PP +/var/lib/urpmi/synthesis.hdlist.* +.br +Contain synthesis information about all known packages built from hdlist files +that can be used by minimal closure algorithm. If these files are not present +use \fBurpmi.update -a\fP to generate them. These files are not mandatory. +.PP +/etc/urpmi/urpmi.cfg +.br +Contains media description, previous format from older urpmi is accepted. +.PP +/etc/urpmi/skip.list +.br +Contains package names that should be not automatically updated. +.PP +/var/lib/urpmi/depslist.ordered +.br +A simple text file containning all dependencies of all known packages. +.PP +/var/lib/urpmi/provides +.br +A simple text file containning all provides and the list of associated +packages that contains them. +.PP +/var/lib/urpmi/compss +.br +A simple text file containning for each Group used the list of package in +this group. +.SH "SEE ALSO" +urpmi(8), +urpmi.addmedia(8), +urpmi.update(8), +urpmi.removemedia(8), +autoirpm(8), +gurpmi(8), +urpmf(8), +rpmdrake(8) +.SH AUTHOR +Francois Pons, Mandrakesoft +.br +fpons@mandrakesoft.com + + + + + + + + + -- cgit v1.2.1