Debian Codegraph @

upstream/debian-unstable/man1/systemd-cgls.1

raw
1 '\" t
2 .TH "SYSTEMD\-CGLS" "1" "" "systemd 261~rc3" "systemd-cgls"
3 .\" -----------------------------------------------------------------
4 .\" * Define some portability stuff
5 .\" -----------------------------------------------------------------
6 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
7 .\" http://bugs.debian.org/507673
8 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
9 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
10 .ie \n(.g .ds Aq \(aq
11 .el .ds Aq '
12 .\" -----------------------------------------------------------------
13 .\" * set default formatting
14 .\" -----------------------------------------------------------------
15 .\" disable hyphenation
16 .nh
17 .\" disable justification (adjust text to left margin only)
18 .ad l
19 .\" -----------------------------------------------------------------
20 .\" * MAIN CONTENT STARTS HERE *
21 .\" -----------------------------------------------------------------
22 .SH "NAME"
23 systemd-cgls \- Recursively show control group contents
24 .SH "SYNOPSIS"
25 .HP \w'\fBsystemd\-cgls\fR\ 'u
26 \fBsystemd\-cgls\fR [OPTIONS...] [CGROUP...]
27 .HP \w'\fBsystemd\-cgls\fR\ 'u
28 \fBsystemd\-cgls\fR [OPTIONS...] \fB\-\-unit\fR|\fB\-\-user\-unit\fR [UNIT...]
29 .SH "DESCRIPTION"
30 .PP
31 \fBsystemd\-cgls\fR
32 recursively shows the contents of the selected Linux control group hierarchy in a tree\&. If arguments are specified, shows all member processes of the specified control groups plus all their subgroups and their members\&. The control groups may either be specified by their full file paths or are assumed in the systemd control group hierarchy\&. If no argument is specified and the current working directory is beneath the control group mount point
33 /sys/fs/cgroup/, shows the contents of the control group the working directory refers to\&. Otherwise, the full systemd control group hierarchy is shown\&.
34 .PP
35 By default, empty control groups are not shown\&.
36 .SH "OPTIONS"
37 .PP
38 The following options are understood:
39 .PP
40 \fB\-\-all\fR
41 .RS 4
42 Do not hide empty control groups in the output\&.
43 .RE
44 .PP
45 \fB\-l\fR, \fB\-\-full\fR
46 .RS 4
47 Do not ellipsize process tree members\&.
48 .sp
49 Added in version 198\&.
50 .RE
51 .PP
52 \fB\-u\fR, \fB\-\-unit\fR
53 .RS 4
54 Show cgroup subtrees for the specified units\&.
55 .sp
56 Added in version 233\&.
57 .RE
58 .PP
59 \fB\-\-user\-unit\fR
60 .RS 4
61 Show cgroup subtrees for the specified user units\&.
62 .sp
63 Added in version 233\&.
64 .RE
65 .PP
66 \fB\-k\fR
67 .RS 4
68 Include kernel threads in output\&.
69 .RE
70 .PP
71 \fB\-M \fR\fB\fIMACHINE\fR\fR, \fB\-\-machine=\fR\fB\fIMACHINE\fR\fR
72 .RS 4
73 Limit control groups shown to the part corresponding to the container
74 \fIMACHINE\fR\&.
75 .sp
76 Added in version 203\&.
77 .RE
78 .PP
79 \fB\-\-xattr[=BOOL]\fR, \fB\-x\fR
80 .RS 4
81 Controls whether to include information about extended attributes of the listed control groups in the output\&. With the long option only, optionally accepts a boolean value\&. Defaults to no\&.
82 .sp
83 Added in version 250\&.
84 .RE
85 .PP
86 \fB\-\-cgroup\-id[=BOOL]\fR, \fB\-c\fR
87 .RS 4
88 Controls whether to include the numeric ID of the listed control groups in the output\&. With the long option only, optionally accepts a boolean value\&. Defaults to no\&.
89 .sp
90 Added in version 250\&.
91 .RE
92 .PP
93 \fB\-h\fR, \fB\-\-help\fR
94 .RS 4
95 Print a short help text and exit\&.
96 .RE
97 .PP
98 \fB\-\-version\fR
99 .RS 4
100 Print a short version string and exit\&.
101 .RE
102 .PP
103 \fB\-\-no\-pager\fR
104 .RS 4
105 Do not pipe output into a pager\&.
106 .RE
107 .SH "EXIT STATUS"
108 .PP
109 On success, 0 is returned, a non\-zero failure code otherwise\&.
110 .SH "SEE ALSO"
111 .PP
112 \fBsystemd\fR(1), \fBsystemctl\fR(1), \fBsystemd-cgtop\fR(1), \fBsystemd-nspawn\fR(1), \fBps\fR(1)