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

FreeBSD Manual Pages

  
 
  

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

NAME
     pkg version -- summarize installed	versions of packages

SYNOPSIS
     pkg version [-IPR]	[-hoqvU] [-l limchar] [-L limchar] [-egix pattern]
	 [-r reponame] [-O origin] [index]
     pkg version -t version1 version2
     pkg version -T pkgname pattern

DESCRIPTION
     pkg version is used for generating	a report of packages installed by
     pkg(8).

     By	default, if a ports tree exists	it is used to compare versions.	 If it
     does not exist, the remote	repository catalogue is	used.  These defaults
     can be overridden by specifying one of -P,	-R or -I.

     When comparing package versions the package name and a comparison charac-
     ter are printed:

     =	     The installed version of the package is current.

     <	     The installed version of the package is older than	the current
	     version.

     >	     The installed version of the package is newer than	the current
	     version.  This situation can arise	with an	out-of-date index
	     file, or when testing new ports.

     ?	     The installed package does	not appear in the index.  This could
	     be	due to an out of date index or a package taken from a PR that
	     has not yet been committed.

     !	     The installed package exists in the index but for some reason,
	     pkg version was unable to compare the version number of the in-
	     stalled package with the corresponding entry in the index.

OPTIONS
     The following options are supported by pkg	version:

     -h	 Displays usage	information

     -I	 Use INDEX file	for determining	if a package is	out of date.

     -P	 Use ports for determining if a	package	is out of date.	 This is the
	 default if a ports tree exists.  The tree used	can be overridden by
	 PORTSDIR, see pkg(5) for more information.

     -R	 Use repository	catalogue for determining if a package is out of date.
	 This is the default if	no ports tree exists.

     -U	 Suppress the automatic	update of the local copy of the	repository
	 catalogue from	remote.	 This only has any effect in combination with
	 the -R	option.

     -r	reponame
	 Use the given reponame	for comparison when using -R

     -o	 Display package origin, instead of package name.

     -q	 Be quiet.  Less output	will be	produced.

     -v	 Be verbose.

     -l	limchar
	 Display only the packages which status	flag matches the one specified
	 by limchar

     -L	limchar
	 Does the opposite of -l flag.	Displays the packages which status
	 flag does not match the one specified by limchar

     -i	 Make the exact	(-e) or	regular	expression (-x)	matching against
	 pattern case insensitive.

     -x	pattern
	 Only display the packages that	match the regular expression.  Uses
	 the "modern" or "extended" syntax of re_format(7).

     -g	pattern
	 Only display the packages that	match the glob expression.

     -e	string
	 Only display the packages that	exactly	match the string.

     -O	origin
	 Display only the packages which origin	matches	origin

     -t	version1 version2
	 Test a	pair of	version	number strings and exit.  The output consists
	 of one	of the single characters = (equal), < (right-hand number
	 greater), or >	(left-hand number greater) on standard output.	This
	 flag is mostly	useful for scripts or for testing.

     -T	pkgname	pattern
	 Compare pkgname against shell glob pattern and	set exit code accord-
	 ingly.	 -T can	also be	used in	`filter	mode': When one	of the argu-
	 ments is `-', standard	input is used, and lines with matching package
	 names/patterns	are echoed to standard output.

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

     PKG_DBDIR

     PORTSDIR

FILES
     See pkg.conf(5).

EXAMPLES
     The following is a	typical	invocation of the pkg version command, which
     checks the	installed packages against the local ports index file:

	   % pkg version -v

     The command below generates a report against the versions in the reposi-
     tory catalogue:

	   % pkg update
	   % pkg version -vR

     The following lists packages needing upgrade, compared to the repository
     catalogue:

	   % pkg update
	   % pkg version -vRL=

     The following command compares two	package	version	strings:

	   % pkg version -t 1.5	1.5.1

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-rquery(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-which(8)

BSD			       February	25, 2013			   BSD

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | ENVIRONMENT | FILES | EXAMPLES | SEE ALSO

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

home | help