vzpkg list
The
vzpkg list
command is used to list
-
EZ templates installed on the server, in a Container, or available in remote EZ template repositories
-
YUM software groups or individual packages installed in a Container
Syntax
vzpkg list
[
options
] [
OS_template
|
CT_ID
|
CT_name
[...]]
If you indicate a Container ID or name, the command will list all EZ templates applied to the specified Container. If you indicate an OS EZ template,
vzpkg list
will display a list of application EZ templates available for this OS EZ template. Without any options, the utility lists all EZ templates installed on the server.
Options
Name
|
Description
|
-p, --package
|
Lists the software packages installed in the Container or included in the OS EZ template.
|
-g, --groups
|
Lists the YUM software groups installed in the Container or available for the OS EZ template.
The
-g
option works only for Containers running RPM-based Linux distributions.
|
-O, --os
|
Displays the OS EZ template the Container is based on.
|
-A, --app
|
Displays the application EZ templates installed in the Container or included in the OS EZ template.
|
-C, --cache
|
Lists the packages included in the specified EZ template or applied to the specified Container from the local
vzpkg
cache. You can omit this parameter if the elapsed time from the last
vzpkg
cache update does not exceed the value of the
METADATA_EXPIRE
parameter specified in the
/etc/vztt/vztt.conf
file. Should be used along with the
-p
option.
|
-r, --remote
|
If the elapsed time from the last
vzpkg
cache update does not exceed the value of the
METADATA_EXPIRE
parameter specified in the
/etc/vztt/vztt.conf
file, you should use this option to make
vzpkg list
list the packages included in the specified EZ template or applied to the specified Container in the remote repositories. Should be used along with the
-p
option.
|
-u, --custom-pkg
|
Displays a list of packages that are applied to the specified Container but absent from the repository set to handle the EZ template(s) where these packages are included.
|
-i, --pkgid
|
Displays the ID assigned to the EZ template instead of its name; these IDs are unique within the given system. If the
<
CT_ID
>
or
<
CT_name
>
argument is given, the command shows the IDs of the EZ templates available inside the Container. If the
<
OS_template
>
argument is given, the command displays the IDs of the OS EZ template specified and all its EZ application templates.
|
-S, --with-summary
|
In addition to listing the EZ templates available either in the Container (if the
<
CT_ID
>
or
<
CT_name
>
argument is given) or installed on the server (if the
<
CT_ID
>/<
CT_name
>
argument is omitted), this option makes
vzpkg list
display the summary information on the corresponding EZ templates/packages.
|
-c, --cached
|
This option has no effect if the
<
CT_ID
>
or
<
CT_name
>
argument is given. If used for listing the EZ templates available on the server, it makes
vzpkg list
omit all application and OS EZ templates for which the cache has not been created (by running the
vzpkg create cache
command). In other words, with this option on,
vzpkg list
will list only the OS EZ templates ready to be used for the Container creation.
|
appcache
|
Outputs a list of OS EZ template caches with preinstalled applications.
|
-d, --debug
<num>
|
Sets the debugging level to one of the specified values (from 0 to 10). 10 is the highest debug level and 0 sets the debug level to its minimal value.
|
-q, --quiet
|
Disables logging to the screen and to the log file.
|
|