home | help
PKG_INFO(1)		     General Commands Manual		     PKG_INFO(1)

NAME
     pkg_info -- a utility for displaying information on software packages

SYNOPSIS
     pkg_info [-cdDfgGiIkLmopqrRsvVx] [-e package] [-l prefix] [-t template]
	      [-W filename] [pkg-name ...]
     pkg_info -a [flags]

DESCRIPTION
     The  pkg_info  command is used to dump out information for packages, either
     packed up in files with the pkg_create(1) command or already  installed  on
     the system with the pkg_add(1) command.

OPTIONS
     The following command line options are supported:

     pkg-name ...
	     The named packages are described.	A package name may either be the
	     name  of  an installed package, the pathname to a package distribu-
	     tion file or a URL to an FTP available package.

     -a      Show all currently installed packages.

     -v      Turn on verbose output.

     -p      Show the installation prefix for each package.

     -q      Be "quiet" in emitting report headers and such, just dump	the  raw
	     info (basically, assume a non-human reading).

     -c      Show the (one line) comment field for each package.

     -d      Show the long description field for each package.

     -D      Show the install-message file for each package.

     -f      Show the packing list instructions for each package.

     -g      Show files that don't match the recorded checksum.

     -i      Show the install script (if any) for each package.

     -I      Show  an index line for each package.  This option takes precedence
	     over all other package formatting options.

     -k      Show the de-install script (if any) for each package.

     -r      Show the requirements script (if any) for each package.

     -R      Show the list of installed packages which require each package.

     -m      Show the mtree file (if any) for each package.

     -L      Show the files within each package.  This is  different  from  just
	     viewing  the  packing list, since full pathnames for everything are
	     generated.

     -s      Show the total size occupied by files installed within  each  pack-
	     age.

     -o      Show  the	"origin" path recorded on package generation.  This path
	     intended to give an idea as to  where  the  underlying  port,  from
	     which  package  was generated, is located in the FreeBSD Ports Col-
	     lection.

     -G      Do not try to expand shell glob patterns in the pkg-name  when  se-
	     lecting packages to be displayed (by default pkg_info automatically
	     expands shell glob patterns in the pkg-name).

     -W      For  the  specified filename argument show which package it belongs
	     to.  If the file is not in the current directory, and does not have
	     an absolute path, then the PATH is searched using which(1).

     -x      Treat the pkg-name as a regular expression and display  information
	     only  for packages whose names match that regular expression.  Mul-
	     tiple regular expressions could be provided, in that case	pkg_info
	     displays  information  about  all	packages that match at least one
	     regular expression from the list.

     -e pkg-name
	     If the package identified by pkg-name is currently  installed,  re-
	     turn  0, otherwise return 1.  This option allows you to easily test
	     for the presence of another (perhaps prerequisite) package  from  a
	     script.

     -l str  Prefix  each  information	category header (see -q) shown with str.
	     This is primarily of use to front-end programs who want to  request
	     a	lot  of  different information fields at once for a package, but
	     don't necessary want the output intermingled in  such  a  way  that
	     they  can't  organize it.	This lets you add a special token to the
	     start of each field.

     -t template
	     Use template as the input to mktemp(3)  when  creating  a	"staging
	     area".   By  default, this is the string /tmp/instmp.XXXXXX, but it
	     may be necessary to override it in the  situation	where  space  in
	     your  /tmp  directory  is limited.  Be sure to leave some number of
	     `X' characters for mktemp(3) to fill in with a unique ID.
		   Note:  This should really not be necessary with pkg_info,
		   since very little information is extracted from each package
		   and one would have to have a very small /tmp indeed to over-
		   flow it.

     -V      Show revision number of the packing list format.

TECHNICAL DETAILS
     Package info is either extracted from package files named	on  the  command
     line,    or    from    already    installed    package    information    in
     /var/db/pkg/<pkg-name>.

ENVIRONMENT
     PKG_TMPDIR points to the directory where  pkg_info  creates  its  temporary
     files.   If  this	variable is not set, TMPDIR is used.  If both are unset,
     the builtin defaults are used.

     PKG_DBDIR specifies an alternative location for the installed package data-
     base.

FILES
     /var/tmp	  Used if the environment variables PKG_TMPDIR	and  TMPDIR  are
		  not set, or if the directories named have insufficient space.
     /tmp	  The next choice if /var/tmp does not exist or has insufficient
		  space.
     /usr/tmp	  The last choice if /tmp is unsuitable.
     /var/db/pkg  Default location of the installed package database.

SEE ALSO
     pkg_add(1),   pkg_create(1),   pkg_delete(1),   pkg_version(1),  mktemp(3),
     mtree(8)

AUTHORS
     Jordan Hubbard

CONTRIBUTORS
     John Kohl <jtk@rational.com>

BUGS
     Sure to be some.

FreeBSD 4.6			February 8, 2001		     PKG_INFO(1)

home | help