'\" -*- 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-02-02 "" ""
.SH NAME
lxc-top \- monitor container statistics 
.SH SYNOPSIS
'nh
.fi
.ad l
\*(T<\fBlxc\-top\fR\*(T> \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)
.SH AUTHOR
Dwight Engen <\*(T<dwight.engen@oracle.com\*(T>>