lxc-top(1)

lxc-top1

Monitor container statistics

Usage

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

Overview

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 order.

Options

FC-d, --delay F[0]delay

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

FC-s, --sort F[0]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'.

FC-r, --reverseF[0]

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

Examples

lxc-top --delay 1 --sort m

Display containers, updating every second, sorted by memory use.

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, 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

FC
      lxc.cgroup.memory.kmem.limit_in_bytes = number
      F[0]

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

Releases

3 releases since Debian 12 (Bookworm); the text changed 2 times.

  1. 12
  2. 13
  3. Arch

From lxc 1:7.0.0-2 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.