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)

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                          July 27, 2001                         FreeBSD

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | ENVIRONMENT | FILES | SEE ALSO | AUTHORS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=pkg_glob&manpath=FreeBSD+6.3-RELEASE+and+Ports>

home | help