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.
