PKG_GLOB(1) BSD General Commands Manual PKG_GLOB(1)NAMEpkg_glob — a package glob expander with wildcards and dependency recur‐
sion support
SYNOPSISpkg_glob [-haOqrR] [-x pkgname_glob] [pkgname_glob ...]
DESCRIPTION
The pkg_glob command lists the installed packages matching given package
globs, optionally recursing through dependencies. The output list is
sorted in alphabetical order. Use pkg_sort(1) to sort them in dependency
order. (e.g. pkg_glob-a | pkg_sort)
Before reading these instructions, you must understand that a port/pack‐
age can have the following two types of related ports/packages:
required Ports/packages that a port/package needs for it to be built
and/or run. Port Makefiles refer to this type of ports/pack‐
ages using the BUILD_DEPENDS and RUN_DEPENDS macros, respec‐
tively.
dependent Ports/packages that need this port/package.
OPTIONS
The following command line arguments are supported:
pkgname_glob Specify one of these: a full pkgname, a pkgname with‐
out version, or a shell glob pattern to match against
pkgnames or their origins in which you can use wild‐
cards ‘*’, ‘?’, and ‘[..]’, an extended regular
expression preceded by a colon ‘:’ to match against
pkgnames or their origins, or a date range specifica‐
tion preceded by either ‘<’ or ‘>’.
A date range specification must be in the following
form:
{<|<=|>=|>}{date|pkgname_glob}
Which selects packages that had been installed before
or after the date or the package specified. It is
recommended to use the ISO 8601 format to specify a
date, while various formats are accepted.
Here are some pattern examples:
tcl-8.2.3 Specifically ‘tcl-8.2.3’.
tcl Whatever versions of ‘tcl’ installed.
This would not match ‘tcl-sql’ or
‘tcl-thread’.
'ja-*' Everything with a ‘ja-’ prefix.
'*gnome*' Everything having ‘gnome’ in the
name.
'*sh' This would not match anything since
the version part cannot be omitted if
a pattern contains wildcards.
'lang/* Everything installed from the cate‐
gory ‘lang’.
:'sh-[^-]+$' Everything which name ends with ‘sh’.
:'(?i)sql' Everything having ‘sql’ in the name,
ignoring the case.
'>=2001-09-20 08:00'
Everything that was installed after
2001-09-20 08:00:00 (local time).
'<png' Everything that was installed prior
to ‘png’.
-h
--help Show help and exit.
-a
--all List all the installed packages. Equivalent to spec‐
ify '*' as pkgname_glob.
-O
--omit-check Omit sanity checks for dependencies. By default,
pkg_glob checks if all the packages to list have con‐
sistent dependencies, though it takes extra time to
calculate dependencies. If you are sure you have run
“pkgdb -F” in advance, you can specify this option to
omit the sanity checks.
-q
--noconfig Do not read the configuration file. ($PREFIX/etc/pkg‐
tools.conf)
-r
--recursive List all those packages depending on the given pack‐
ages as well.
-R
--upward-recursive List all those packages required by the given pack‐
ages as well.
-x pkgname_glob
--exclude pkgname_glob
Exclude packages matching the specified glob pattern.
Exclusion is performed after recursing dependency in
response to -r and/or -R, which means, for example,
the following command will list all the packages
depending on XFree86 but XFree86 will be excluded:
pkg_glob-rx XFree86 XFree86
ENVIRONMENT
PKG_DBDIR Alternative location for the installed package database.
Default is “/var/db/pkg”.
PKGTOOLS_CONF Configuration file for the pkgtools suite. Default is
“$PREFIX/etc/pkgtools.conf”.
FILES
/var/db/pkg Default location of the installed package
database.
$PREFIX/etc/pkgtools.conf Default location of the pkgtools configuration
file.
SEE ALSOpkg_deinstall(1), pkg_sort(1), pkgdb(1), portinstall(1), ports_glob(1),
portupgrade(1), portversion(1), pkgtools.conf(5), ports(7)AUTHORS
Akinori MUSHA ⟨knu@iDaemons.org⟩
FreeBSD June 13, 2006 FreeBSD
