NAME

SYNOPSIS

DESCRIPTION

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

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

AUTHORS