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 in which you can use wildcards ‘*’, ‘’?, and ‘[..]’, an extended regular expression preceded by a colon ‘’:, or a date range specification preceded by either ‘<’ or ‘>’.

    A date range specification must be in the following form:

        {<|<=|>=|>}{date|pkgname_glob}

    Which selects pacakges 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.

    :'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’.

    '<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>