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-VERSION(8)          FreeBSD System Manager's Manual         PKG-VERSION(8)

NAME
     pkg version - summarize installed versions of packages

SYNOPSIS
     pkg version [-IPR] [-hoqvU] [-l limchar] [-L limchar] [-egix pattern]
                 [-r reponame] [-O origin] [index]
     pkg version -t version1 version2
     pkg version -T pkgname pattern

DESCRIPTION
     pkg version is used for generating a report of packages installed by
     pkg(8).

     By default, if a ports tree exists it is used to compare versions.  If it
     does not exist, the remote repository catalogue is used.  These defaults
     can be overridden by specifying one of -P, -R or -I.

     When comparing package versions the package name and a comparison
     character are printed:

     =       The installed version of the package is current.

     <       The installed version of the package is older than the current
             version.

     >       The installed version of the package is newer than the current
             version.  This situation can arise with an out-of-date index
             file, or when testing new ports.

     ?       The installed package does not appear in the index.  This could
             be due to an out of date index or a package taken from a PR that
             has not yet been committed.

     !       The installed package exists in the index but for some reason,
             pkg version was unable to compare the version number of the
             installed package with the corresponding entry in the index.

OPTIONS
     The following options are supported by pkg version:

     -h  Displays usage information

     -I  Use INDEX file for determining if a package is out of date.

     -P  Use ports for determining if a package is out of date.  This is the
         default if a ports tree exists.  The tree used can be overridden by
         PORTSDIR, see pkg(5) for more information.

     -R  Use repository catalogue for determining if a package is out of date.
         This is the default if no ports tree exists.

     -U  Suppress the automatic update of the local copy of the repository
         catalogue from remote.  This only has any effect in combination with
         the -R option.

     -r reponame
         Use the given reponame for comparison when using -R

     -o  Display package origin, instead of package name.

     -q  Be quiet.  Less output will be produced.

     -v  Be verbose.

     -l limchar
         Display only the packages which status flag matches the one specified
         by limchar

     -L limchar
         Does the opposite of -l flag.  Displays the packages which status
         flag does not match the one specified by limchar

     -i  Make the exact (-e) or regular expression (-x) matching against
         pattern case insensitive.

     -x pattern
         Only display the packages that match the regular expression.  Uses
         the "modern" or "extended" syntax of re_format(7).

     -g pattern
         Only display the packages that match the glob expression.

     -e string
         Only display the packages that exactly match the string.

     -O origin
         Display only the packages which origin matches origin

     -t version1 version2
         Test a pair of version number strings and exit.  The output consists
         of one of the single characters = (equal), < (right-hand number
         greater), or > (left-hand number greater) on standard output.  This
         flag is mostly useful for scripts or for testing.

     -T pkgname pattern
         Compare pkgname against shell glob pattern and set exit code
         accordingly.  -T can also be used in `filter mode': When one of the
         arguments is `-', standard input is used, and lines with matching
         package names/patterns are echoed to standard output.

ENVIRONMENT
     The following environment variables affect the execution of pkg version.
     See pkg.conf(5) for further description.

     PKG_DBDIR

     PORTSDIR

FILES
     See pkg.conf(5).

EXAMPLES
     The following is a typical invocation of the pkg version command, which
     checks the installed packages against the local ports index file:

           % pkg version -v

     The command below generates a report against the versions in the
     repository catalogue:

           % pkg update
           % pkg version -vR

     The following lists packages needing upgrade, compared to the repository
     catalogue:

           % pkg update
           % pkg version -vRL=

     The following command compares two package version strings:

           % pkg version -t 1.5 1.5.1

SEE ALSO
     pkg.conf(5), pkg(8), pkg-add(8), pkg-annotate(8), pkg-audit(8),
     pkg-autoremove(8), pkg-backup(8), pkg-check(8), pkg-clean(8),
     pkg-config(8), pkg-convert(8), pkg-create(8), pkg-delete(8),
     pkg-fetch(8), pkg-info(8), pkg-install(8), pkg-lock(8), pkg-query(8),
     pkg-register(8), pkg-repo(8), pkg-rquery(8), pkg-search(8), pkg-set(8),
     pkg-shell(8), pkg-shlib(8), pkg-stats(8), pkg-update(8), pkg-updating(8),
     pkg-upgrade(8), pkg-which(8)

FreeBSD 11.0-PRERELEASE        February 25, 2013       FreeBSD 11.0-PRERELEASE

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | ENVIRONMENT | FILES | EXAMPLES | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=pkg-version&sektion=8&manpath=FreeBSD+10.0-RELEASE>

home | help