apk-tools

the small and simple package manager

home : downloads : project :

Name

apk_version — summarize installed version of packages

Synopsis

apk_version [-huqv] [-l limchar] [-L limchar] [-s string] [index]

apk_version -t version1 version2

DESCRIPTION

The apk_version command is used to produce a report of installed software packages. Each package's version number is checked against the package repository index and printed along with a one-character status flag:

=

The installed version of the package is current.

<

The installed version of the package is older than the version in index.

>

The installed version of the package is newer than the version in index.

?

The installed package does not appear in the index.

!

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

OPTIONS

The following command line arguments are supported:

-h

Show help and exit.

-l

Limit the output to those packages whose status flag matches the character(s) in limchar. More than one character can be specified in limchar. Note that because some of the status flag characters are also special to the shell, it is best to quote limchar with single quotes.

-L

Limit the output to those packages whose status flag does not match limchar. You may specify more than one character to match in limchar. Note that because some of the status flag characters are also special to the shell, it is best to quote limchar with single quotes.

-q

Enable quiet output. Quiet output precludes printing the limchar when used with -l or -L.

-s

Limit the output to those packages whose names match a given string.

-t

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.

-u

Update the package repository index before comparing.

-v

Enable verbose output. Verbose output includes some English-text interpretations of the version number comparisons, as well as the version numbers compared for each package.

index

Specify the index to be used as a basis of comparison. This index can be specified as a filename (in the local file system) or a URL. Any URL understandable by apk_fetch(1) can be used here. If no index file is specified on the command line, /var/lib/apk/INDEX.md5.gz is used.

ENVIRONMENT

APK_CACHE

Alternative location for the package repository index. Default is $ROOT/var/lib/apk.

APK_DBDIR

Alternative location for the installed package database. Default is $ROOT/var/db/apk.

APK_PATH

List of URI's to remote package repository mirrors. The URI's are separated by a semicolon (;). Index will be fetched from here if it is not present in $APK_CACHE

APKTOOLS_CONF

Configuration file for the apk-tools suite. Default is /etc/apk.conf.

INDEX_URI

URI from where the index is downloaded from if no index is cached in $APK_CACHE.

ROOT

Base directory for apk-tools. It is unset by default which means that / is the base directory.

FILES

$ROOT/var/lib/apk

Default location to save downloaded index into.

$ROOT/var/db/apk

Default location for the installed package database.

/etc/apk.conf

Default location of the apk-tools configuration file.

SEE ALSO

apk_add (1), apk_delete (1), apk_info(1)

SourceForge.net Logo