Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
PKG-RQUERY(8)		  BSD System Manager's Manual		 PKG-RQUERY(8)

NAME
     pkg rquery	-- query information from remote repositories

SYNOPSIS
     pkg rquery	<query-format> <pkg-name>
     pkg rquery	[-aU] [-r reponame] <query-format>
     pkg rquery	[-U] -e	<evaluation-condition> [-r reponame] <query-format>
     pkg rquery	[-giUx]	[-r reponame] <query-format> <pattern> <...>

DESCRIPTION
     pkg rquery	is used	for displaying information about remote	packages.

     Package repository	catalogues will	be automatically updated whenever
     pkg-update(8) is run, unless disabled by the -U flag.

OPTIONS
     The following options are supported by pkg	rquery:

     -a	 Match all packages from the database

     -e	 Match packages	using the given	evaluation-condition. See EVALUATION
	 FORMAT	for details.

     -r	reponame
	 Fetches packages from the given reponame if multiple repo support is
	 enabled.  See pkg.conf(5).

     -g	 Treat <pattern> as a glob pattern.

     -i	 Make the standard or regular expression (-x) matching against
	 pkg-name case insensitive.

     -U	 Skip updating the repository catalogues with pkg-update(8).  Use the
	 locally cached	copies only.

     -x	 Treat <pattern> as a regular expression according to the "modern" or
	 "extended" syntax of re_format(7).

QUERY FORMAT
     There are two type	of keyword 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 contain 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 an-
	 notation 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
     ~	 String	glob pattern matching

     >[=]
	 Integer comparison

     >[=]
	 Integer comparison

     =[=]
	 Integer or string comparison

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

     PKG_DBDIR

FILES
     See pkg.conf(5).

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

SEE ALSO
     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-stats(8), pkg-update(8),	pkg-updating(8),
     pkg-upgrade(8), pkg-version(8), pkg-which(8)

BSD			       December	5, 2013				   BSD
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | QUERY FORMAT | EVALUATION FORMAT | ENVIRONMENT | FILES | EXIT STATUS | SEE ALSO

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=pkg-rquery&sektion=8&manpath=FreeBSD+10.0-RELEASE>

home | help