.\" -*- coding: UTF-8 -*- .if \n(.g .ds T< \\FC .if \n(.g .ds T> \\F[\n[.fam]] .de URL \\$2 \(la\\$1\(ra\\$3 .. .if \n(.g .mso www.tmac .TH lxc-top 1 2024-09-16 "" "" .SH NAME lxc-top \- monitor container statistics .SH SYNOPSIS 'nh .fi .ad l \fBlxc-top\fR \kx .if (\nx>(\n(.l/2)) .nr x (\n(.l/5) 'in \n(.iu+\nxu [--help] [--delay \fIdelay\fR] [--sort \fIsortby\fR] [--reverse] 'in \n(.iu-\nxu .ad b 'hy .SH DESCRIPTION \fBlxc-top\fR displays container statistics. The output is updated every \fIdelay\fR seconds, and is ordered according to the \fIsortby\fR value given. \fBlxc-top\fR will display as many containers as can fit in your terminal. Press 'q' to quit. Press one of the sort key letters to sort by that statistic. Pressing a sort key letter a second time reverses the sort order. .SH OPTIONS .TP \*(T<\fB\-d, \-\-delay \fR\*(T>\fIdelay\fR Amount of time in seconds to delay between screen updates. The default is 3 seconds. .TP \*(T<\fB\-s, \-\-sort \fR\*(T>\fIsortby\fR Sort the containers by name, cpu use, or memory use. The \fIsortby\fR argument should be one of the letters n,c,b,m,k to sort by name, cpu use, block I/O, memory, or kernel memory use respectively. The default is 'n'. .TP \*(T<\fB\-r, \-\-reverse\fR\*(T> Reverse the default sort order. By default, names sort in ascending alphabetical order and values sort in descending amounts (ie. largest value first). .SH EXAMPLE .TP lxc-top --delay 1 --sort m Display containers, updating every second, sorted by memory use. .SH NOTES For performance reasons the kernel does not account kernel memory use unless a kernel memory limit is set. If a limit is not set, \fB lxc-top\fR will display kernel memory use as 0. If no containers are being accounted, the KMem column will not be displayed. A limit can be set by specifying .nf \*(T< lxc.cgroup.memory.kmem.limit_in_bytes = \fInumber\fR \*(T> .fi in your container configuration file, see \fBlxc.conf\fR(5). .SH "SEE ALSO" \fBlxc\fR(7), \fBlxc-create\fR(1), \fBlxc-copy\fR(1), \fBlxc-destroy\fR(1), \fBlxc-start\fR(1), \fBlxc-stop\fR(1), \fBlxc-execute\fR(1), \fBlxc-console\fR(1), \fBlxc-monitor\fR(1), \fBlxc-wait\fR(1), \fBlxc-cgroup\fR(1), \fBlxc-ls\fR(1), \fBlxc-info\fR(1), \fBlxc-freeze\fR(1), \fBlxc-unfreeze\fR(1), \fBlxc-attach\fR(1), \fBlxc.conf\fR(5)