Previous page

Next page

Locate page in Contents

Print this page

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.