DragonFly On-Line Manual Pages

Search: Section:  


PKG-RQUERY(8)	       DragonFly System Manager's Manual	 PKG-RQUERY(8)

NAME

pkg rquery -- query information from remote repositories

SYNOPSIS

pkg rquery -I|<query-format> <pkg-name> pkg rquery [-aU] [-r reponame] -I|<query-format> pkg rquery [-U] -e <evaluation-condition> [-r reponame] -I|<query-format> pkg rquery [-U] [-Cgix] [-r reponame] -I|<query-format> <pattern> <...> pkg rquery --index-line|<query-format> <pkg-name> pkg rquery [--{all,no-repo-update}] [--repository reponame] --index-line|<query-format> pkg rquery [--no-repo-update] --evaluate <evaluation-condition> [--repository reponame] --index-line|<query-format> pkg rquery [--no-repo-update] [--{case-sensitive,glob,case-insensitive,regex}] [--repository reponame] --index-line|<query-format> <pattern> <...>

DESCRIPTION

pkg rquery is used for displaying information about remote packages. Package repository catalogues will be automatically updated whenever pkg rquery is run by a user ID with write access to the package database, unless disabled by the -U flag or setting REPO_AUTOUPDATE to NO in pkg.conf(5).

OPTIONS

The following options are supported by pkg rquery: -a, --all Match all packages from the database. -C, --case-sensitive Make the standard or the regular expression (-x) matching against pkg-name case sensitive. -e, --evaluate Match packages using the given evaluation-condition. See EVALUATION FORMAT for details. -I, --index-line Print out the corresponding line from the ports INDEX file for each matched package. This option is a shorthand <query-format> argument. Only the first query format (including the -I option) on the command line will be inter- preted. -r reponame, --repository reponame Query for data about packages from only the named repository, irrespective of the configured ``active'' status from repo.conf. By default all repository catalogues marked ``active'' are queried. -g, --glob Treat <pattern> as a glob pattern. -i, --case-insensitive Make the standard or regular expression (-x) matching against pkg-name case insensitive. This is the default, unless modi- fied by setting CASE_SENSITIVE_MATCH to true in pkg.conf. -U, --no-repo-update Suppress the automatic update of the local copy of the repos- itory catalogue from remote. Automatic repository catalogue updates are only attempted when the effective UID of the process has write access to the package database. Otherwise they are silently ignored. -x, --regex Treat <pattern> as a regular expression according to the "modern" or "extended" syntax of re_format(7).

QUERY FORMAT

There are two types of keywords for the query format: the multiline and the normal one. Only one type of multiline pattern is accepted for a given query. Normal patterns: %R Name of the repository package is in %n Name of the matched package %v Version of the matched package %o Origin of the matched package %p Prefix of the matched package %m Maintainer of the matched package %c Comment of the matched package %e Description of the matched package %w Home page of the matched package %q Architecture of the matched package %l license logic of the matched package - nothing for single, & for AND, and | for OR %s[bh] The flat size of the matched package, where b is in bytes, and h is in human readable format. %M message contained in the matched package %?[drCOLBbA] Returns 0 if the list is empty and 1 if the list has information to display d for dependencies r for reverse dependencies C for categories O for options L for licenses B for required shared libraries b for provided shared libraries A for annotations %#[drCOLBbA] Returns the number of elements in the list d for dependencies r for reverse dependencies C for categories O for options L for licenses B for required shared libraries b for provided shared libraries A for annotations Multiline patterns: %d[nov] Expands to the list of dependencies for the matched package, where n stands for the package name, o for the package origin, and v for the package version. %r[nov] Expands to the list of reverse dependencies for the matched package, where n stands for the package name, o for the package origin, and v for the package version. %C Expands to the list of categories the matched package belongs to. %O[kvdD] Expands to the list of options of the matched package, where k stands for option key v for option value, d for option default value, and D for option description. Option default values and descriptions are optional metadata and may be blank for certain packages or reposito- ries. %L Expands to the list of license(s) for the matched package. %B Expands to the list of shared libraries used by programs from the matched package. %b Expands to the list of shared libraries provided by the matched pack- age. %A[tv] Expands to the list of annotations associated with the matched pack- age, where t stands for the annotation tag, and v stands for the annotation value.

EVALUATION FORMAT

Variables %n Name of the package (type string) %o Origin of the package (type string) %p Prefix of the package (type string) %m Maintainer of the package (type string) %c Comment of the package (type string) %e Description of the package (type string) %w WWW address of the package (type string) %s Flatsize of the package (type integer) %a Automatic status of the package (type integer) %q Architecture of the package (type string) %M Message of the package (type string) %#[drCOLBbA] Number of elements in the list of information (type integer). See %? above for what information is used. Operators var ~ glob The string value of var matches the given glob pattern. var !~ glob The string value of var does not match the given glob pattern. var >[=] num The numerical value of var is greater than [or equal to] the given number. var <[=] num The numerical value of var is less than [or equal to] the given num- ber. var =[=] num The numerical value of var is equal to the given number. var != num The numerical value of var is not equal to the given number.

ENVIRONMENT

The following environment variables affect the execution of pkg rquery. See pkg.conf(5) for further description. PKG_DBDIR CASE_SENSITIVE_MATCH

FILES

See pkg.conf(5).

EXIT STATUS

The pkg rquery utility exits 0 on success, and >0 if an error occurs.

EXAMPLES

See pkg-query(8) for example usage.

SEE ALSO

pkg_printf(3), pkg_repos(3), pkg-repository(5), pkg.conf(5), pkg(8), pkg-add(8), pkg-annotate(8), pkg-audit(8), pkg-autoremove(8), pkg-backup(8), pkg-check(8), pkg-clean(8), pkg-config(8), pkg-convert(8), pkg-create(8), pkg-delete(8), pkg-fetch(8), pkg-info(8), pkg-install(8), pkg-lock(8), pkg-query(8), pkg-register(8), pkg-repo(8), pkg-search(8), pkg-set(8), pkg-shell(8), pkg-shlib(8), pkg-ssh(8), pkg-stats(8), pkg-update(8), pkg-updating(8), pkg-upgrade(8), pkg-version(8), pkg-which(8) DragonFly 5.5 March 7, 2016 DragonFly 5.5

Search: Section: