NAME

       vzlist - show various information about containers

SYNOPSIS

       vzlist [-a | -S] [-n] [-H] [-t] [-j] [-o name[,name...]|-1] [-s [-]name] [-h pattern] [-N pattern]
              [-d pattern] [CTID [CTID ...]]
       vzlist -L | --list
       vzlist --help

DESCRIPTION

       This utility is used for listing containers and their parameters.  By default only running containers are
       listed.  If one or more CTIDs are specified, only specified containers are displayed.

       For  some fields that can have long values (e.g. ip, hostname, description or features), the value string
       is trimmed to some predefined width (in order not to break the columned layout), unless this field is the
       last one. So, in order to get the full non-trimmed value for such a field, put the field name last in the
       list of fields for -o option. If using vzlist from a script, add -t to disable trimming.

OPTIONS

       -a, --all
              List all containers.

       -S, --stopped
              List only not running containers (including the ones with status shown as mounted or suspended).

       -n, --name
              Display container names instead of hostnames.

       -H, --no-header
              Suppress displaying the header row. Usable for scripts.

       -t, --no-trim
              Suppress trimming long fields. Usable for scripts.

       -j, --json
              Output in JSON format. By default, all possible fields are printed.

       -o, --output field[,field...]
              Display only the specified fields (see Possible fields subsection below).

       -1     Synonym for -H -octid, i.e. only show container IDs, one per line.

       -s, --sort [-]field
              Sort by the value of field (possible arguments are the same as for -o). The  -  before  the  field
              name means sorting in the reverse order.

   Output filters
       List  of  CTs  can  be  further  filtered using the following options.  For patterns one can use the same
       wildcards as in shell (i.e. *, ?, and []).  Note: to avoid expansion of wildcards by the shell, one  have
       to  escape  the  pattern  by  either  putting it into single quotes (like 'a*a') or by adding a backslash
       before the wildcard character (like a\*a).

       -h, --hostname pattern
              List only containers whose hostnames matches the pattern.

       -N, --name_filter pattern
              List only containers whose names matches the pattern.

       -d, --description pattern
              List only containers with descriptions matching the pattern.

   Possible fields
       -L, --list
              list all available format specifiers that can be used for  both  output  (-o,  --output)  and  the
              sorting order (-s, --sort).

       For the user beancounter fields, if suffix is not specified, current usage (a.k.a. "held") value is show.
       One can also use the following suffixes:

       .m     maxheld

       .b     barrier

       .l     limit

       .f     fail counter

       For  the  disk  quota  fields,  if  suffix is not specified, current usage is shown. One can also use the
       following suffixes:

       .s     soft limit

       .h     hard limit

       Note that for JSON output suffixes are not allowed.

EXAMPLES

       vzlist -o ctid,kmemsize,kmemsize.l -s kmemsize
              Show CTIDs, kmemsize usage, and kmemsize limit for all running containers, sorted by the  kmemsize
              usage.

EXIT STATUS

       Returns 0 upon success.

COPYRIGHT

       Copyright (C) 2000-2011, Parallels, Inc. Licensed under GNU GPL.

OpenVZ                                             13 Jun 2012                                         vzlist(8)