vzlist - containers listing utility
vzlist [-a|-S] [-n] [-H] [-o
name[,name...]] [-s [-]name] [-h
pattern] [-N pattern] [-d pattern]
[CTID [CTID ...] | -1]
vzlist -L
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.
- -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.
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.
- -L, --list
- list all available format specifiers.
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 |
vzlist -o ctid,kmemsize,kmemsize.l -s kmemsize
Copyright (C) 2000-2011, Parallels, Inc. Licensed under GNU GPL.