Previous page

Next page

Locate page in Contents

Print this page

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.