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

FreeBSD Manual Pages

  
 
  

home | help
PKG_VERSION(8)		     System Manager's Manual		  PKG_VERSION(8)

NAME
     pkg_version -- summarise installed versions of packages

SYNOPSIS
     pkg_version [-coqUv] [-j jobs] [-l limchar] [-L limchar]
		 [-a | [-CdgiOrx] pkg-name ...]
     pkg_version -P [-coqv] [-j jobs] [-l limchar] [-L limchar]
		 [-a | [-CdgiOrx] pkg-name ...]
     pkg_version -I [index] [-coqv] [-j jobs] [-l limchar] [-L limchar]
		 [-a | [-CdgiOrx] pkg-name ...]
     pkg_version -R [-coqUv] [-j jobs] [-l limchar] [-L limchar]
		 [-a | [-CdgiOrx] pkg-name ...]
     pkg_version -h

Description
     The  pkg_version  script is a pkg-version(8) wrapper capable of greatly im-
     proving the performance of using the ports(7) tree as the version source by
     querying version numbers in parallel.

     For most of the behaviour pkg-version(8) can be consulted. Noteworthy  dif-
     ferences are:

     *	 Multiple package arguments can be provided
     *	 Origins (if -o is used) contain the flavour of the installed package
     *	 If -l limchar and -q are given, only package identifiers are output
     *	 The -t and -T arguments are not supported

   Arguments
     The following arguments are accepted:

     index   The  index  file to compare installed package versions to. Defaults
	     to /usr/ports/INDEX-N with N being the major FreeBSD  version  num-
	     ber. See pkg-version(8).

     jobs    The  number  of  processes to use in parallel to run pkg-version(8)
	     queries.

     limchar
	     A single character constraining which packages are output.

     pkg-name
	     Packages are package names or shell glob patterns	matching  these.
	     Whatever works with pkg-info(8) is an acceptable package.

   Options
     The following options are available:

     -a, --all
	     Check  all packages. This is the default action in case no pkg-name
	     has been specified.

     -C, --case-sensitive
	     See pkg-info(8).

     -c, --clean
	     Create clean output without status messages.

     -d, --dependencies
	     Also operate on the dependencies of the provided pkg-name.

     -g, --glob
	     See pkg-info(8).

     -h, --help
	     Displays the available options.

     -i, --case-insensitive
	     See pkg-info(8).

     -I [index], --index [index]
	     Use index file to determine if a package is out of date.  See  pkg-
	     version(8).

     -j jobs, --jobs jobs
	     Specify  the  amount  of parallel jobs the script will attempt run.
	     The default is number of detected cores.

     -l limchar, ---like limchar
	     Display only packages with the given version status,  see	pkg-ver-
	     sion(8).

     -L limchar, ---not-like limchar
	     Display only packages unlike the given version status, see pkg-ver-
	     sion(8).

     -O, --by-origin
	     See pkg-info(8).

     -o, --origin
	     Instead  of  the  package	name  and version the package origin and
	     flavour is printed.

     -P, --ports
	     Use ports(7) to determine if a package is out of date. See pkg-ver-
	     sion(8).

     -q, --quiet
	     Produce less output, see pkg-version(8).  In combination with -l it
	     suppresses printing limchar behind matched packages.

     -R, --remote
	     Use repository catalogue to determine if a package is out of  date.
	     See pkg-version(8).

     -r, --required-by
	     Also check packages that depend on the provided packages.

     -U, --no-repo-update
	     Disable  automatic update of the repository catalogue. See pkg-ver-
	     sion(8).

     -v, --verbose
	     Be verbose, see pkg-version(8).  Use twice to be extra verbose.

     -x, --regex
	     See pkg-info(8).

EXAMPLES
     Check all packages whether they are out of date:

	   pkg_version

     List all out of date GPU firmware packages, without any visual clutter:

	   pkg_version -ql\< gpu-firmware-\*

SEE ALSO
     pkg-info(8), pkg-version(8), ports(7)

HISTORY
     The pkg_version script first appeared in the bsda2-0.5.0 collection.

AUTHORS
     Dominic Fandrey <freebsd@k4m1.org>

FreeBSD ports 15.quarterly	18 November, 2023		  PKG_VERSION(8)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=pkg_version&sektion=8&manpath=FreeBSD+Ports+15.1.quarterly>

home | help