wpkg --list | -l

Short Hand

wpkg -l

Options Comments
--admindir Define the administration directory, where the database of the installed packages resides.
--debug Define a set of flags of things to print out for debug purposes.
--instdir Define the installation directory, where the data files are installed on the target.
--quiet Not used.
--root Define the installation root path.
--verbose Not used.

The --list command lists the names of installed packages along with their status, version, and brief description (70 characters maximum.)

By default, the --list command outputs all the packages installed on a target machine. You may need to specify the target with one of the --admindir or --root options.

wpkg --root ~/target --list

The command accepts one optional parameter: a globbing pattern. The pattern is a fully compatible Unix Shell Pattern.

The command prints out an error message if no packages were installed (no pattern given, or "*" was specified as the pattern,) or no packages matched the globbing pattern.

wpkg --list 'boost*'

Note that when you write a globbing pattern for wpkg on your command line, you want to write it between single or double quotes or the shell will transform it before wpkg sees it. (It is not unlikely to work as in many cases your package patterns will not match anything in your current directory, but it may not always work as expected.)

When installed packages are found, they get listed in the output. In that case, the command shows a set of flags on the left which describe the current status of the package:

Status Verbose Status Comments
pn Purged / Not Installed the package is not installed
rc Removed / Configuration Files the package was removed, but its configuration files are still installed
iU Installed / Unpacked the package was unpacked, it is not currently considered configured
hU Installed / Unpacked / Hold the package was unpacked, it is not currently considered configured, it is on hold
ii Installed / Installed the package is fully installed
hi Installed / Installed / Hold the package is fully installed and it is on hold
un Unknown / Not Installed the package is not installed; this status should never appear in your list
?? <not valid> this package has a status that does not represent a valid state
iw Installing (Working) the packager is installing this package
hw Installing (Working) / Hold the packager is working on this installed package which is on hold
iH Installed / Half-Installed the package installation proces failed
hH Installed / Half-Installed / Hold the package installation process failed and it is on hold
iFc Installed / Half-Configured the package configuration failed
hFc Installed / Half-Configure / Hold the package configuration failed and it is on hold
rw Removing (Working) the packager is removing this package
pw Purging (Working) the packager is purging this package
u* Unknown unexpected status, cannot tell what the status of the package really is

As the process works on the installed packages, if a package cannot be loaded, it signals such with an error and continues with the other packages. In most cases, a package that cannot be loaded should be removed manually because wpkg will always attempt to load a package before working on it.