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.