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 re-
       cursion support

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

DESCRIPTION
       The pkg_glob command lists the installed	packages matching given	 pack-
       age  globs, optionally recursing	through	dependencies.  The output list
       is sorted in alphabetical order.	 Use pkg_sort(1) to sort them  in  de-
       pendency	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/pack-
       ages:
       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 be-
			   fore	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'   in-
					   stalled.    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
			   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.	($PRE-
			   FIX/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 pack-
			   ages	as well.

       -x pkgname_glob
       --exclude pkgname_glob
			   Exclude  packages  matching the specified glob pat-
			   tern.  Exclusion is performed after	recursing  de-
			   pendency  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  configura-
				  tion 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+14.3.quarterly>

home | help