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 improving 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 differences 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 number. 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-version(8).
-L limchar, ---not-like limchar: Display only packages unlike the given version status, see pkg-version(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-version(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-version(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-\*

HISTORY

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

AUTHORS

Dominic Fandrey <freebsd@k4m1.org>