Option

Description

-a, --all

Lists all the Containers existing on the server. By default, only running Containers are shown.

-S, --stopped

Lists only stopped Containers.

-o parameter [. specifier ]

This option is used to display only particular information about the Containers. The parameters and their specifiers that can be used after the -o option are listed in the following subsection. To display a number of parameters in a single output, they should be separated with commas, as is shown in the synopsis above.

-s, --sort

[-] parameter [ .specifier ]

Sorts the Containers in the list by the specified parameter. If " - " is given before the name of the parameter, the sorting order is reversed.

-h, --hosthame

hostname_pattern

Displays only those Containers that correspond to the specified hostname pattern. The following wildcards can be used: * , ? , and [] .

Note: The last wildcard should be escaped to avoid shell interpretation.

-H, --no-header

Do not display column headers.

CT_ID

Displays only the Container with the specified ID. Several Container IDs separated with a space can be specified. If -1 is given as the Container ID, the utility lists only IDs of the Containers existing on the server, with no additional information.

-n, --name

If used without any parameters, displays information on all the Containers on the server together with their names. If you indicate the Container ID after this option, displays information including the Container name on the specified Container only.

-N, --name_filter name_pattern

Displays only the Container that corresponds to the specified name pattern.

-i, --netif < interface_name >

Displays the Container whose veth virtual Ethernet interface name on the server corresponds to the specified name pattern.

-d, --description
desc_pattern

Displays only the Container whose description corresponds to the specified pattern.

-L, --list

Lists all the parameters available to be used with the -o option.