FreeBSD Manual Pages
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 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 pack- age • 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. De- faults 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 pack- age. 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-\* 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 14.quarterly 18 November, 2023 PKG_VERSION(8)
NAME | SYNOPSIS | Description | EXAMPLES | SEE ALSO | HISTORY | AUTHORS
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+14.3.quarterly>