2
2
<a href="systemd.directives.html">Directives </a>·
3
3
<a href="../python-systemd/index.html">Python </a>·
4
4
<a href="../libudev/index.html">libudev </a>·
5
<a href="../libudev/index.html">gudev </a><hr><div class="refentry"><a name="systemd-cgtop"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>systemd-cgtop — Show top control groups by their resource usage</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">systemd-cgtop [OPTIONS...]</code> </p></div></div><div class="refsect1"><a name="idp3908096"></a><h2>Description</h2><p><span class="command"><strong>systemd-cgtop</strong></span> shows the top
5
<a href="../libudev/index.html">gudev </a><span style="float:right">systemd 202</span><hr><div class="refentry"><a name="systemd-cgtop"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>systemd-cgtop — Show top control groups by their resource usage</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">systemd-cgtop</code> [OPTIONS...]</p></div></div><div class="refsect1"><a name="idp85328"></a><h2>Description</h2><p><span class="command"><strong>systemd-cgtop</strong></span> shows the top
6
6
control groups of the local Linux control group
7
hierarchy, ordered by their CPU, memory and disk I/O load. The
7
hierarchy, ordered by their CPU, memory, or disk I/O load. The
8
8
display is refreshed in regular intervals (by default
9
9
every 1s), similar in style to
10
<a href="top.html"><span class="citerefentry"><span class="refentrytitle">top</span>(1)</span></a>.</p><p>Resource usage is only accounted for control
10
<a href="top.html"><span class="citerefentry"><span class="refentrytitle">top</span>(1)</span></a>.
11
If <span class="command"><strong>systemd-cgtop</strong></span> is not connected
12
to a tty, only one iteration is performed and no
13
columns headers are printed. This mode is suitable for
14
scripting.</p><p>Resource usage is only accounted for control
11
15
groups in the relevant hierarchy, i.e. CPU usage is
12
16
only accounted for control groups in the
13
17
<code class="literal">cpuacct</code> hierarchy, memory usage
34
38
of the options suggested above no resource accounting
35
39
will be available for system services and the data shown
36
40
by <span class="command"><strong>systemd-cgtop</strong></span> will be
37
incomplete.</p></div><div class="refsect1"><a name="idp25840"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>Prints a short help
41
incomplete.</p></div><div class="refsect1"><a name="idp26224"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>Prints a short help
38
42
text and exits.</p></dd><dt><span class="term"><code class="option">--version</code></span></dt><dd><p>Prints a version string and
39
43
exits.</p></dd><dt><span class="term"><code class="option">-p</code></span></dt><dd><p>Order by control group
40
44
path name.</p></dd><dt><span class="term"><code class="option">-t</code></span></dt><dd><p>Order by number of
62
66
the root group is monitored, for 1
63
67
only the first level of control groups
64
68
is monitored, and so on. Defaults to
65
3.</p></dd></dl></div></div><div class="refsect1"><a name="idp58448"></a><h2>Keys</h2><p><span class="command"><strong>systemd-cgtop</strong></span> is an
69
3.</p></dd></dl></div></div><div class="refsect1"><a name="idp58832"></a><h2>Keys</h2><p><span class="command"><strong>systemd-cgtop</strong></span> is an
66
70
interactive tool and may be controlled via user input
67
71
using the following keys:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term">h</span></dt><dd><p>Shows a short help text.</p></dd><dt><span class="term">SPACE</span></dt><dd><p>Immediately refresh output.</p></dd><dt><span class="term">q</span></dt><dd><p>Terminate the program.</p></dd><dt><span class="term">p, </span><span class="term">t, </span><span class="term">c, </span><span class="term">m, </span><span class="term">i</span></dt><dd><p>Sort the control groups
68
72
by path, number of tasks, CPU load,
69
73
memory usage, or IO
70
load, respectively.</p></dd><dt><span class="term">+, </span><span class="term">-</span></dt><dd><p>Increase
74
load, respectively.</p></dd><dt><span class="term">%</span></dt><dd><p>Toggle between showing CPU time as
75
time or percentage.</p></dd><dt><span class="term">+, </span><span class="term">-</span></dt><dd><p>Increase
71
76
or decrease refresh
72
delay, respectively.</p></dd></dl></div></div><div class="refsect1"><a name="idp69712"></a><h2>Exit status</h2><p>On success 0 is returned, a non-zero failure
73
code otherwise.</p></div><div class="refsect1"><a name="idp70896"></a><h2>See Also</h2><p>
77
delay, respectively.</p></dd></dl></div></div><div class="refsect1"><a name="idp5039360"></a><h2>Exit status</h2><p>On success 0 is returned, a non-zero failure
78
code otherwise.</p></div><div class="refsect1"><a name="idp5040512"></a><h2>See Also</h2><p>
74
79
<a href="systemd.html"><span class="citerefentry"><span class="refentrytitle">systemd</span>(1)</span></a>,
75
80
<a href="systemctl.html"><span class="citerefentry"><span class="refentrytitle">systemctl</span>(1)</span></a>,
76
81
<a href="systemd-cgls.html"><span class="citerefentry"><span class="refentrytitle">systemd-cgls</span>(1)</span></a>,