DragonFly On-Line Manual Pages
PKG_GLOB(1) DragonFly General Commands Manual PKG_GLOB(1)
NAME
pkg_glob - a package glob expander with wildcards and dependency
recursion support
SYNOPSIS
pkg_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/package 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/packages using the BUILD_DEPENDS and RUN_DEPENDS macros,
respectively.
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
without version, or a shell glob pattern to match
against pkgnames or their origins in which you can
use wildcards `*', `?', and `[..]', an extended
regular expression preceded by a colon `:' to match
against pkgnames or their origins, or a date range
specification 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 category
`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
specify '*' as pkgname_glob.
-O
--omit-check Omit sanity checks for dependencies. By default,
pkg_glob checks if all the packages to list have
consistent 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/pkgtools.conf)
-r
--recursive List all those packages depending on the given
packages as well.
-R
--upward-recursive List all those packages required by the given
packages 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 ALSO
pkg_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