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 recur-
     sion 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/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-
		tively.
     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 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
			 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 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'.

     -h
     --help		 Show help and exit.

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

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

     -q
     --noconfig		 Do not	read the configuration file. ($PREFIX/etc/pkg-
			 tools.conf)

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

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

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:
<http://www.freebsd.org/cgi/man.cgi?query=pkg_glob&sektion=1&manpath=FreeBSD+Ports>

home | help