1lxc-top(1)                                                          lxc-top(1)
2
3
4

NAME

6       lxc-top - monitor container statistics
7

SYNOPSIS

9       lxc-top [--help] [--delay delay] [--sort sortby] [--reverse]
10

DESCRIPTION

12       lxc-top  displays container statistics. The output is updated every de‐
13       lay seconds, and is ordered according to the sortby value  given.  lxc-
14       top  will display as many containers as can fit in your terminal. Press
15       'q' to quit. Press one of the sort key letters to sort by that  statis‐
16       tic. Pressing a sort key letter a second time reverses the sort order.
17

OPTIONS

19       -d, --delay delay
20              Amount  of time in seconds to delay between screen updates.  The
21              default is 3 seconds.
22
23       -s, --sort sortby
24              Sort the containers by name, cpu use, or memory use. The  sortby
25              argument should be one of the letters n,c,b,m,k to sort by name,
26              cpu use, block I/O, memory, or kernel memory  use  respectively.
27              The default is 'n'.
28
29       -r, --reverse
30              Reverse  the  default  sort order. By default, names sort in as‐
31              cending alphabetical order and values sort in descending amounts
32              (ie. largest value first).
33

EXAMPLE

35       lxc-top --delay 1 --sort m
36              Display containers, updating every second, sorted by memory use.
37

NOTES

39       For  performance  reasons the kernel does not account kernel memory use
40       unless a kernel memory limit is set. If a limit  is  not  set,  lxc-top
41       will  display  kernel  memory  use as 0. If no containers are being ac‐
42       counted, the KMem column will not be displayed. A limit can be  set  by
43       specifying
44
45             lxc.cgroup.memory.kmem.limit_in_bytes = number
46
47
48       in your container configuration file, see lxc.conf(5).
49

SEE ALSO

51       lxc(7),  lxc-create(1), lxc-copy(1), lxc-destroy(1), lxc-start(1), lxc-
52       stop(1), lxc-execute(1), lxc-console(1),  lxc-monitor(1),  lxc-wait(1),
53       lxc-cgroup(1),  lxc-ls(1), lxc-info(1), lxc-freeze(1), lxc-unfreeze(1),
54       lxc-attach(1), lxc.conf(5)
55

AUTHOR

57       Dwight Engen <dwight.engen@oracle.com>
58
59
60
61                                  2021-09-18                        lxc-top(1)
Impressum