vzlist(8)                         Containers                         vzlist(8)



NAME
       vzlist - containers listing utility

SYNOPSIS
       vzlist [-a|-S] [-n] [-H] [-o name[,name...]] [-s [-]name] [-h pattern]
       [-N pattern] [-d pattern] [CTID [CTID ...] | -1]

       vzlist -L

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. CTID of -1 is used
       to output CT IDs only, one per line.

       For the fields that can have many values (e.g. ip), all the values are
       displayed only for the last (i.e. leftmost) column; otherwise, only the
       first value is shown.

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.

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

       -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.


   Standard fields
       These may be used to control both output (-o, --output) and the sorting
       order (-s, --sort).

                            ┌─────────────┬─────────────┐
                            │Value        │ Header      │
                            ├─────────────┼─────────────┤
                            ├─────────────┼─────────────┤
                            │ctid         │ CTID        │
                            ├─────────────┼─────────────┤
                            │hostname     │ HOSTNAME    │
                            ├─────────────┼─────────────┤
                            │name         │ NAME        │
                            ├─────────────┼─────────────┤
                            │description  │ DESCRIPTION │
                            ├─────────────┼─────────────┤
                            │ostemplate   │ OSTEMPLATE  │
                            ├─────────────┼─────────────┤
                            │ip           │ IP_ADDR     │
                            ├─────────────┼─────────────┤
                            │status       │ STATUS      │
                            ├─────────────┼─────────────┤
                            │kmemsize     │ KMEMSIZE    │
                            ├─────────────┼─────────────┤
                            │lockedpages  │ LOCKEDP     │
                            ├─────────────┼─────────────┤
                            │privvmpages  │ PRIVVMP     │
                            ├─────────────┼─────────────┤
                            │shmpages     │ SHMP        │
                            ├─────────────┼─────────────┤
                            │numproc      │ NPROC       │
                            ├─────────────┼─────────────┤
                            │physpages    │ PHYSP       │
                            ├─────────────┼─────────────┤
                            │vmguarpages  │ VMGUARP     │
                            ├─────────────┼─────────────┤
                            │oomguarpages │ OOMGUARP    │
                            ├─────────────┼─────────────┤
                            │numtcpsock   │ NTCPSOCK    │
                            ├─────────────┼─────────────┤
                            │numflock     │ NFLOCK      │
                            ├─────────────┼─────────────┤
                            │numpty       │ NPTY        │
                            ├─────────────┼─────────────┤
                            │numsiginfo   │ NSIGINFO    │
                            ├─────────────┼─────────────┤
                            │tcpsndbuf    │ TCPSNDB     │
                            ├─────────────┼─────────────┤
                            │tcprcvbuf    │ TCPRCVB     │
                            ├─────────────┼─────────────┤
                            │othersockbuf │ OTHSOCKB    │
                            ├─────────────┼─────────────┤
                            │dgramrcvbuf  │ DGRAMRRB    │
                            ├─────────────┼─────────────┤
                            │numothersock │ NOTHSOCK    │
                            ├─────────────┼─────────────┤
                            │dcachesize   │ DCACHESZ    │
                            ├─────────────┼─────────────┤
                            │numfile      │ NFILE       │
                            ├─────────────┼─────────────┤
                            │numiptent    │ NIPTENT     │
                            ├─────────────┼─────────────┤
                            │swappages    │ SWAPP       │
                            ├─────────────┼─────────────┤
                            │diskspace    │ DSPACE      │
                            ├─────────────┼─────────────┤
                            │diskinodes   │ DINODES     │
                            ├─────────────┼─────────────┤
                            │laverage     │ LAVERAGE    │
                            ├─────────────┼─────────────┤
                            │uptime       │ UPTIME      │
                            ├─────────────┼─────────────┤
                            │cpulimit     │ CPULIM      │
                            ├─────────────┼─────────────┤
                            │cpuunits     │ CPUUNI      │
                            ├─────────────┼─────────────┤
                            │ioprio       │ IOP         │
                            ├─────────────┼─────────────┤
                            │onboot       │ ONBOOT      │
                            ├─────────────┼─────────────┤
                            │bootorder    │ BOOTORDER   │
                            └─────────────┴─────────────┘
       For the user beancounter fields above, one can use the following
       suffixes:

                           ┌───────┬────────┬─────────────┐
                           │Suffix │ Header │ Description │
                           ├───────┼────────┼─────────────┤
                           ├───────┼────────┼─────────────┤
                           │ .m    │ .M     │ maxheld     │
                           ├───────┼────────┼─────────────┤
                           │ .b    │ .B     │ barrier     │
                           ├───────┼────────┼─────────────┤
                           │ .l    │ .L     │ limit       │
                           ├───────┼────────┼─────────────┤
                           │ .f    │ .F     │ failcnt     │
                           └───────┴────────┴─────────────┘
       For the disk quota fields above, one can use the following suffixes:

                   ┌────────────────────────────┬────┬───────────┐
                   │Suffix  Header  Description │    │           │
                   ├────────────────────────────┼────┼───────────┤
                   ├────────────────────────────┼────┼───────────┤
                   │ .s                         │ .S │ softlimit │
                   ├────────────────────────────┼────┼───────────┤
                   │ .h                         │ .H │ hardlimit │
                   └────────────────────────────┴────┴───────────┘
EXAMPLES
       vzlist -o ctid,kmemsize,kmemsize.l -s kmemsize

RETURN CODE
       Returns 0 upon success.

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



OpenVZ                            7 Feb 2011                         vzlist(8)