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

FreeBSD Manual Pages


home | help
PKG_GLOB(1)		FreeBSD	General	Commands Manual		   PKG_GLOB(1)

     pkg_glob -- a package glob	expander with wildcards	and dependency recur-
     sion 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/pack-
     age 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/pack-
		ages using the BUILD_DEPENDS and RUN_DEPENDS macros, respec-
     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 with-
			 out version, or a shell glob pattern to match against
			 pkgnames or their origins in which you	can use	wild-
			 cards `*', `?', and `[..]', an	extended regular
			 expression preceded by	a colon	`:' to match against
			 pkgnames or their origins, or a date range specifica-
			 tion 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

			 '*sh'		 This would not	match anything since
					 the version part cannot be omitted if
					 a pattern contains wildcards.

			 'lang/*	 Everything installed from the cate-
					 gory `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'.

     --help		 Show help and exit.

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

     --omit-check	 Omit sanity checks for	dependencies.  By default,
			 pkg_glob checks if all	the packages to	list have con-
			 sistent 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. ($PREFIX/etc/pkg-

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

     --upward-recursive	 List all those	packages required by the given pack-
			 ages 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