diff options
Diffstat (limited to 'pod/urpmq.8.pod')
-rw-r--r-- | pod/urpmq.8.pod | 257 |
1 files changed, 257 insertions, 0 deletions
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) |