Poster of Linux kernelThe best gift for a Linux geek
vzlist

vzlist

Section: Containers (8) Updated: 26 May 2010
Local index Up
 

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 stopped containers.
-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).
SuffixDescription


 .m
maxheld

 .b
barrier

 .l
limit

 .f
failcnt

 .s
softlimit

 .h
hardlimit
ValueHeader

ctidCTID
hostnameHOSTNAME
nameNAME
descriptionDESCRIPTION
ostemplateOSTEMPLATE
ipIP_ADDR
statusSTATUS
kmemsizeKMEMSIZE
kmemsize.mKMEMSIZE.M
kmemsize.bKMEMSIZE.B
kmemsize.lKMEMSIZE.L
kmemsize.fKMEMSIZE.F
lockedpagesLOCKEDP
lockedpages.mLOCKEDP.M
lockedpages.bLOCKEDP.B
lockedpages.lLOCKEDP.L
lockedpages.fLOCKEDP.F
privvmpagesPRIVVMP
privvmpages.mPRIVVMP.M
privvmpages.bPRIVVMP.B
privvmpages.lPRIVVMP.L
privvmpages.fPRIVVMP.F
shmpagesSHMP
shmpages.mSHMP.M
shmpages.bSHMP.B
shmpages.lSHMP.L
shmpages.fSHMP.F
numprocNPROC
numproc.mNPROC.M
numproc.bNPROC.B
numproc.lNPROC.L
numproc.fNPROC.F
physpagesPHYSP
physpages.mPHYSP.M
physpages.bPHYSP.B
physpages.lPHYSP.L
physpages.fPHYSP.F
vmguarpagesVMGUARP
vmguarpages.mVMGUARP.M
vmguarpages.bVMGUARP.B
vmguarpages.lVMGUARP.L
vmguarpages.fVMGUARP.F
oomguarpagesOOMGUARP
oomguarpages.mOOMGUARP.M
oomguarpages.bOOMGUARP.B
oomguarpages.lOOMGUARP.L
oomguarpages.fOOMGUARP.F
numtcpsockNTCPSOCK
numtcpsock.mNTCPSOCK.M
numtcpsock.bNTCPSOCK.B
numtcpsock.lNTCPSOCK.L
numtcpsock.fNTCPSOCK.F
numflockNFLOCK
numflock.mNFLOCK.M
numflock.bNFLOCK.B
numflock.lNFLOCK.L
numflock.fNFLOCK.F
numptyNPTY
numpty.mNPTY.M
numpty.bNPTY.B
numpty.lNPTY.L
numpty.fNPTY.F
numsiginfoNSIGINFO
numsiginfo.mNSIGINFO.M
numsiginfo.bNSIGINFO.B
numsiginfo.lNSIGINFO.L
numsiginfo.fNSIGINFO.F
tcpsndbufTCPSNDB
tcpsndbuf.mTCPSNDB.M
tcpsndbuf.bTCPSNDB.B
tcpsndbuf.lTCPSNDB.L
tcpsndbuf.fTCPSNDB.F
tcprcvbufTCPRCVB
tcprcvbuf.mTCPRCVB.M
tcprcvbuf.bTCPRCVB.B
tcprcvbuf.lTCPRCVB.L
tcprcvbuf.fTCPRCVB.F
othersockbufOTHSOCKB
othersockbuf.mOTHSOCKB.M
othersockbuf.bOTHSOCKB.B
othersockbuf.lOTHSOCKB.L
othersockbuf.fOTHSOCKB.F
dgramrcvbufDGRAMRRB
dgramrcvbuf.mDGRAMRRB.M
dgramrcvbuf.bDGRAMRRB.B
dgramrcvbuf.lDGRAMRRB.L
dgramrcvbuf.fDGRAMRRB.F
numothersockNOTHSOCK
numothersock.mNOTHSOCK.M
numothersock.bNOTHSOCK.B
numothersock.lNOTHSOCK.L
numothersock.fNOTHSOCK.F
dcachesizeDCACHESZ
dcachesize.mDCACHESZ.M
dcachesize.bDCACHESZ.B
dcachesize.lDCACHESZ.L
dcachesize.fDCACHESZ.F
numfileNFILE
numfile.mNFILE.M
numfile.bNFILE.B
numfile.lNFILE.L
numfile.fNFILE.F
numiptentNIPTENT
numiptent.mNIPTENT.M
numiptent.bNIPTENT.B
numiptent.lNIPTENT.L
numiptent.fNIPTENT.F
swappagesSWAPP
swappages.mSWAPP.M
swappages.bSWAPP.B
swappages.lSWAPP.L
swappages.fSWAPP.F
diskspaceDSPACE
diskspace.sDSPACE.S
diskspace.hDSPACE.H
diskinodesDINODES
diskinodes.sDINODES.S
diskinodes.hDINODES.H
laverageLAVERAGE
cpulimitCPULIM
cpuunitsCPUUNI
ioprioIOP
onbootONBOOT
bootorderBOOTORDER
 

EXAMPLES

       vzlist -o ctid,kmemsize,kmemsize.l -s kmemsize
 

RETURN CODE

Returns 0 upon success.  

COPYRIGHT

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


 

Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
Output filters
Possible fields
STANDARD FIELDS
EXAMPLES
RETURN CODE
COPYRIGHT

This document was created by man2html, using the manual pages.
Time: 22:02:37 GMT, April 16, 2011