LXC-TOP(1)                                                        LXC-TOP(1)

NAME         top

       lxc-top - monitor container statistics

SYNOPSIS         top

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

DESCRIPTION         top

       lxc-top displays container statistics. The output is updated every
       delay seconds, and is ordered according to the sortby value given.
       lxc-top 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

OPTIONS         top

       -d, --delay delay
              Amount of time in seconds to delay between screen updates.
              The default is 3 seconds.

       -s, --sort sortby
              Sort the containers by name, cpu use, or memory use. The
              sortby 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'.

       -r, --reverse
              Reverse the default sort order. By default, names sort in
              ascending alphabetical order and values sort in descending
              amounts (ie. largest value first).

EXAMPLE         top

       lxc-top --delay 1 --sort m
              Display containers, updating every second, sorted by memory

NOTES         top

       For performance reasons the kernel does not account kernel memory use
       unless a kernel memory limit is set. If a limit is not set,  lxc-top
       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

             lxc.cgroup.memory.kmem.limit_in_bytes = number

       in your container configuration file, see lxc.conf(5).

SEE ALSO         top

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

AUTHOR         top

       Dwight Engen <>

COLOPHON         top

       This page is part of the lxc (Linux containers) project.  Information
       about the project can be found at ⟨⟩.  If
       you have a bug report for this manual page, send it to  This page was obtained from the
       project's upstream Git repository ⟨git://⟩ on
       2017-03-13.  If you discover any rendering problems in this HTML ver‐
       sion of the page, or you believe there is a better or more up-to-date
       source for the page, or you have corrections or improvements to the
       information in this COLOPHON (which is not part of the original man‐
       ual page), send a mail to

                                 2017-03-13                       LXC-TOP(1)