Skip site navigation (1)Skip section navigation (2)

FreeBSD Man Pages

Man Page or Keyword Search:
Man Architecture
Apropos Keyword Search (all sections) Output format
home | help
PKG_GLOB(1)             FreeBSD General Commands Manual            PKG_GLOB(1)

     pkg_glob - a package glob expander with wildcards and dependency
     recursion support

     pkg_glob [-haOqrR] [-x pkgname_glob] [pkgname_glob ...]

     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,
     dependent  Ports/packages that need this port/package.

     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


                         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

                         '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

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

     --help              Show help and exit.

     --all               List all the installed packages.  Equivalent to
                         specify '*' as pkgname_glob.

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

     --noconfig          Do not read the configuration file.

     --recursive         List all those packages depending on the given
                         packages as well.

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

     PKG_DBDIR      Alternative location for the installed package database.
                    Default is ``/var/db/pkg''.

     PKGTOOLS_CONF  Configuration file for the pkgtools suite.  Default is

     /var/db/pkg                Default location of the installed package

     $PREFIX/etc/pkgtools.conf  Default location of the pkgtools configuration

     pkg_deinstall(1), pkg_sort(1), pkgdb(1), portinstall(1), ports_glob(1),
     portupgrade(1), portversion(1), pkgtools.conf(5), ports(7)

     Akinori MUSHA <>

FreeBSD                          June 13, 2006                         FreeBSD


Want to link to this manual page? Use this URL:

home | help