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

FreeBSD Manual Pages

  
 
  

home | help
PKG_GLOB(1)		     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  pkg-
			 names	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 rec-
			 ommended  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  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 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 data-
				base.

     $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 			  June 13, 2006 		     PKG_GLOB(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=pkg_glob&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help