← Back to branch summary

~ubuntu-branches/debian/jessie/systemd/jessie

« back to all changes in this revision

Viewing changes to man/systemd-cgtop.1

  • Committer: Package Import Robot
  • Author(s): Tollef Fog Heen, Tollef Fog Heen, Michael Biebl
  • Date: 2012-04-03 19:59:17 UTC
  • mfrom: (1.1.10) (6.1.3 experimental)
  • Revision ID: package-import@ubuntu.com-20120403195917-l532urrbg4pkreas
Tags: 44-1
http://bugs.debian.org/664364
http://bugs.debian.org/663219
http://bugs.debian.org/663323
[ Tollef Fog Heen ]
* New upstream version.
  - Backport 3492207: journal: PAGE_SIZE is not known on ppc and other
    archs
  - Backport 5a2a2a1: journal: react with immediate rotation to a couple
    of more errors
  - Backport 693ce21: util: never follow symlinks in rm_rf_children()
    Fixes CVE-2012-1174, closes: #664364
* Drop output message from init-functions hook, it's pointless.
* Only rmdir /lib/init/rw if it exists.
* Explicitly order debian-fixup before sysinit.target to prevent a
  possible race condition with the creation of sockets.  Thanks to
  Michael Biebl for debugging this.
* Always restart the initctl socket on upgrades, to mask sysvinit
  removing it.

[ Michael Biebl ]
* Remove workaround for non-interactive sessions from pam config again.
* Create compat /dev/initctl symlink in case we are upgrading from a system
  running a newer version of sysvinit (using /run/initctl) and sysvinit is
  replaced with systemd-sysv during the upgrade. Closes: #663219
* Install new man pages.
* Build-Depend on valac (>= 0.12) instead of valac-0.12. Closes: #663323

Show diffs side-by-side

added added

removed removed

Lines of Context:
man/systemd-cgtop.1
 
1
'\" t
 
2
.\"     Title: systemd-cgtop
 
3
.\"    Author: Lennart Poettering <lennart@poettering.net>
 
4
.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
 
5
.\"      Date: 03/16/2012
 
6
.\"    Manual: systemd-cgtop
 
7
.\"    Source: systemd
 
8
.\"  Language: English
 
9
.\"
 
10
.TH "SYSTEMD\-CGTOP" "1" "03/16/2012" "systemd" "systemd-cgtop"
 
11
.\" -----------------------------------------------------------------
 
12
.\" * Define some portability stuff
 
13
.\" -----------------------------------------------------------------
 
14
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
15
.\" http://bugs.debian.org/507673
 
16
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
 
17
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
18
.ie \n(.g .ds Aq \(aq
 
19
.el       .ds Aq '
 
20
.\" -----------------------------------------------------------------
 
21
.\" * set default formatting
 
22
.\" -----------------------------------------------------------------
 
23
.\" disable hyphenation
 
24
.nh
 
25
.\" disable justification (adjust text to left margin only)
 
26
.ad l
 
27
.\" -----------------------------------------------------------------
 
28
.\" * MAIN CONTENT STARTS HERE *
 
29
.\" -----------------------------------------------------------------
 
30
.SH "NAME"
 
31
systemd-cgtop \- Show top control groups by their resource usage
 
32
.SH "SYNOPSIS"
 
33
.HP \w'\fBsystemd\-cgtop\ \fR\fB[OPTIONS...]\fR\ 'u
 
34
\fBsystemd\-cgtop \fR\fB[OPTIONS...]\fR
 
35
.SH "DESCRIPTION"
 
36
.PP
 
37
\fBsystemd\-cgtop\fR
 
38
shows the top control groups of the local Linux control group hierarchy, ordered by their CPU, memory and disk I/O load\&. The display is refreshed in regular intervals (by default every 1s), similar in style to
 
39
\fBtop\fR(1)\&.
 
40
.PP
 
41
Resource usage is only accounted for control groups in the relevant hierarchy, i\&.e\&. CPU usage is only accounted for control groups in the
 
42
cpuacct
 
43
hierarchy, memory usage only for those in
 
44
memory
 
45
and disk I/O usage for those in
 
46
blkio\&.
 
47
\fBsystemd\fR(1)
 
48
by default places all services in their own control group in the
 
49
cpuacct
 
50
hierarchy, but not in
 
51
memory
 
52
nor
 
53
blkio\&. If resource monitoring for these resources is required it is recommended to add
 
54
blkio
 
55
and
 
56
memory
 
57
to the
 
58
\fIDefaultControllers=\fR
 
59
setting in
 
60
/etc/systemd/system\&.conf
 
61
(see
 
62
\fBsystemd.conf\fR(5)
 
63
for details)\&. Alternatively, it is possible to enable resource accounting individually for services, by making use of the
 
64
\fIControlGroup=\fR
 
65
option in the unit files (See
 
66
\fBsystemd.exec\fR(5)
 
67
for details)\&.
 
68
.PP
 
69
To emphasize this: unless
 
70
blkio
 
71
and
 
72
memory
 
73
are enabled for the services in question with either of the options suggested above no resource accounting will be available for system services and the data shown by
 
74
\fBsystemd\-cgtop\fR
 
75
will be incomplete\&.
 
76
.SH "OPTIONS"
 
77
.PP
 
78
The following options are understood:
 
79
.PP
 
80
\fB\-h\fR, \fB\-\-help\fR
 
81
.RS 4
 
82
Prints a short help text and exits\&.
 
83
.RE
 
84
.PP
 
85
\fB\-p\fR
 
86
.RS 4
 
87
Order by control group path name\&.
 
88
.RE
 
89
.PP
 
90
\fB\-t\fR
 
91
.RS 4
 
92
Order by number of tasks in control group (i\&.e\&. threads and processes)\&.
 
93
.RE
 
94
.PP
 
95
\fB\-c\fR
 
96
.RS 4
 
97
Order by CPU load\&.
 
98
.RE
 
99
.PP
 
100
\fB\-m\fR
 
101
.RS 4
 
102
Order by memory usage\&.
 
103
.RE
 
104
.PP
 
105
\fB\-i\fR
 
106
.RS 4
 
107
Order by disk I/O load\&.
 
108
.RE
 
109
.PP
 
110
\fB\-d\fR, \fB\-\-delay=\fR
 
111
.RS 4
 
112
Specify refresh delay in seconds (or if one of
 
113
ms,
 
114
us,
 
115
min
 
116
is specified as unit in this time unit)\&.
 
117
.RE
 
118
.PP
 
119
\fB\-\-depth=\fR
 
120
.RS 4
 
121
Maximum control group tree traversal depth\&. Specifies how deep
 
122
\fBsystemd\-cgtop\fR
 
123
shall traverse the control group hierarchies\&. If 0 is specified only the root group is monitored, for 1 only the first level of control groups is monitored, and so on\&. Defaults to 2\&.
 
124
.RE
 
125
.SH "KEYS"
 
126
.PP
 
127
\fBsystemd\-cgtop\fR
 
128
is an interactive tool and may be controlled via user input using the following keys:
 
129
.PP
 
130
h
 
131
.RS 4
 
132
Shows a short help text\&.
 
133
.RE
 
134
.PP
 
135
SPACE
 
136
.RS 4
 
137
Immediately refresh output\&.
 
138
.RE
 
139
.PP
 
140
q
 
141
.RS 4
 
142
Terminate the program\&.
 
143
.RE
 
144
.PP
 
145
p, t, c, m, i
 
146
.RS 4
 
147
Change ordering of control groups by path, number of tasks, CPU load, memory usage resp\&. IO load\&.
 
148
.RE
 
149
.PP
 
150
+, \-
 
151
.RS 4
 
152
Increase, resp\&. decrease refresh delay\&.
 
153
.RE
 
154
.SH "EXIT STATUS"
 
155
.PP
 
156
On success 0 is returned, a non\-zero failure code otherwise\&.
 
157
.SH "SEE ALSO"
 
158
.PP
 
159
 
 
160
\fBsystemd\fR(1),
 
161
\fBsystemctl\fR(1),
 
162
\fBsystemd-cgls\fR(1),
 
163
\fBtop\fR(1)
 
164
.SH "AUTHOR"
 
165
.PP
 
166
\fBLennart Poettering\fR <\&lennart@poettering\&.net\&>
 
167
.RS 4
 
168
Developer
 
169
.RE