GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  PKG_GLOB (1)

NAME

pkg_glob - a package glob expander with wildcards and dependency recursion support

CONTENTS

Synopsis
Description
Options
Environment
Files
See Also
Authors

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

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 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 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. ($PREFIX/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 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 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


.An Akinori MUSHA Aq knu@iDaemons.org
Search for    or go to Top of page |  Section 1 |  Main Index


Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.