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

FreeBSD Manual Pages

  
 
  

home | help 
PKG-QUERY(8)		FreeBSD	System Manager's Manual		  PKG-QUERY(8)

NAME
     pkg query -- query	information for	installed packages

SYNOPSIS
     pkg query <query-format> <pkg-name>

     pkg query [-a] <query-format>
     pkg query -F <pkg-file> <query-format>
     pkg query -e <evaluation-condition> <query-format>
     pkg query [-Cgix] <query-format> <pattern>	<...>

     pkg query [--all] <query-format>
     pkg query --file <pkg-file> <query-format>
     pkg query --evaluate <evaluation-condition> <query-format>
     pkg query [--{case-sensitive,glob,case-insensitive,regex}]	<query-format>
	 <pattern> <...>

DESCRIPTION
     pkg query is used for displaying information about	packages.

OPTIONS
     The following options are supported by pkg	query:

     -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.

     -F	pkg-file, --file pkg-file
	       Display information only	for the	package	file pkg-name.

     -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.

     -g, --glob
	       Treat <pattern> as a glob pattern.

     -x, --regex
	       Treat <pattern> as a regular expression according to the	"mod-
	       ern" 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
     %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

     %V	 Returns 0 if the package is not marked	as "vital", and	1 is the pack-
	 age is	marked "vital".

     %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.

     %a	 Returns 1 if the matched package was automatically installed as a de-
	 pendency of another package, 0	otherwise.  The	package	can be auto-
	 matically removed via `pkg autoremove'	when this flag is set and no
	 other package depends on it.

     %Q	 Alternative architecture of the matches package

     %q	 Architecture of the matched package

     %k	 Returns 1 if the matched package is locked against modification or
	 deletion, 0 otherwise

     %M	 message contained in the matched package

     %t	 Timestamp that	the package was	installed

     %R	 The name of the repository from which the package was installed if
	 available, or "unknown-repository" otherwise.

     %X	 Internal package checksum

     %?[drCFODLUGBbA]
	 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

	 F	 for files

	 O	 for options

	 D	 for directories

	 L	 for licenses

	 U	 for users

	 G	 for groups

	 B	 for required shared libraries

	 b	 for provided shared libraries

	 A	 for annotations

     %#[drCFODLUGBbA]
	 Returns the number of elements	in the list

	 d	 for dependencies

	 r	 for reverse dependencies

	 C	 for categories

	 F	 for files

	 O	 for options

	 D	 for directories

	 L	 for licenses

	 U	 for users

	 G	 for groups

	 b	 for shared

	 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.

     %F[ps]
	 Expands to the	list of	files of the matched package, where p stands
	 for path, and s for sum.

     %D	 Expands to the	list of	directories of the matched package.

     %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.

     %L	 Expands to the	list of	license(s) for the matched package.

     %U	 Expands to the	list of	users needed by	the matched package.

     %G	 Expands to the	list of	groups needed by 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 for	the matched package, where t
	 stands	for the	annotation tag,	and v stands for the annotation	value.

EVALUATION FORMAT
     Packages can be selected by using expressions comparing Variables (see
     below) to string or integer values.  The mode of comparison is specified
     by	the Operator (also listed below).  Expressions can be combined using
     &&	(for and) and || (for or).  Parentheses	can be used for	grouping in
     the usual manner.

     String values are either any text not containing whitespace (possibly
     followed by but not including whitespace) or any text enclosed in single
     or	double quotes.

   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)

     %k	 Locking status	of the package (type integer)

     %M	 Message of the	package	(type string)

     %t	 Timestamp that	the package was	installed (type	integer)

     %i	 Additional information	about the package (type	string)

     %#[drCFODLUGBbA]
	 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 query.
     See pkg.conf(5) for further description.

     PKG_DBDIR

     CASE_SENSITIVE_MATCH

FILES
     See pkg.conf(5).

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

EXAMPLES
     List all installed	packages by name-version:
	   $ pkg query %n-%v

     List all dependencies for a package by origin:
	   $ pkg query %do subversion

     List all dependencies by package name-version:
	   $ pkg query %dn-%dv subversion

     List all reverse dependencies for a package:
	   $ pkg query %ro perl

     List all files and	their known checksums for a package:
	   $ pkg query '%Fp %Fs' perl

     List all files for	all packages:
	   $ pkg query '%o: %Fp'

     List all packages with no reverse dependencies:
	   $ pkg query -e '%#r = 0' %o

     List non-automatic	packages:
	   $ pkg query -e '%a =	0' %o

     List automatic packages:
	   $ pkg query -e '%a =	1' %o

     List unmaintained packages:
	   $ pkg query -e '%m =	ports@FreeBSD.org' %o

SEE ALSO
     pkg_printf(3), pkg_repos(3), pkg-lua-script(5), pkg-repository(5),
     pkg-script(5), pkg.conf(5), pkg(8), pkg-add(8), pkg-alias(8),
     pkg-annotate(8), pkg-audit(8), pkg-autoremove(8), pkg-backup(8),
     pkg-check(8), pkg-clean(8), pkg-config(8),	pkg-create(8), pkg-delete(8),
     pkg-fetch(8), pkg-info(8),	pkg-install(8),	pkg-lock(8), pkg-register(8),
     pkg-repo(8), pkg-rquery(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)

FreeBSD	13.0		       November	18, 2016		  FreeBSD 13.0
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | QUERY FORMAT | EVALUATION FORMAT | ENVIRONMENT | FILES | EXIT STATUS | EXAMPLES | SEE ALSO

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

home | help