vzpkg list
The
vzpkg list
command is used to list the EZ templates or software packages installed on the server or already added to a particular Container. It has the following syntax:
vzpkg list [
options
] <
CT_ID>
|<
CT_NAME
>
[...]
vzpkg list [
options
] [<
OS_template
>|<
CT_ID
>|<
CT_NAME
> [...]]
If you indicate one or more Container IDs or names, the command will list the EZ templates applied to the specified Containers. If you indicate one or more OS EZ templates,
vzpkg list
will display a list of application EZ templates available for these OS EZ templates. Without the
<
CT_ID
>/<
CT_NAME
>
and <
OS_template
> arguments, the utility lists all EZ templates available for Containers on the server.
The following options can be used with the
vzpkg list
command:
Name
|
Description
|
-p, --package
|
If the
<
CT_ID
>
or
<
CT_NAME
>
argument is given, the command lists all software packages installed inside the Container. If the
<
OS_template
>
argument is given, the command lists all packages included in the OS EZ template. Without the
<
CT_ID
>/<
CT_NAME
>
and
<
OS_template
>
arguments,
vzpkg list
displays all packages available on the server.
|
-O, --os
|
If the
<
CT_ID
>
or
<
CT_NAME
>
argument is given, the command displays the OS EZ template the Container is based on. Without the
<
CT_ID
>
/
<
CT_NAME
>
argument,
vzpkg list
lists all OS EZ templates installed on the server.
|
-A, --app
|
If the
<
CT_ID
>
or
<
CT_NAME
>
argument is given, the command displays the application EZ templates installed inside the Container. If the
<
OS_template
>
is given, the command shows the application EZ templates which can be used with the OS EZ template specified. Without the
<
CT_ID
>/<
CT_NAME
>
and
<
OS_template
>
arguments,
vzpkg list
lists all application EZ templates installed on the server.
|
-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. Without the
<
CT_ID
>/<
CT_NAME
>
and
<
OS_template
>
arguments, the IDs of all EZ templates installed on the server are shown.
|
-S, --with-summary
|
In addition to listing the EZ templates available either inside 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.
|
-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.
|
|