add changes entry
[external/systemd.git] / man / systemd-cgls.1
1 '\" t
2 .\"     Title: systemd-cgls
3 .\"    Author: Lennart Poettering <lennart@poettering.net>
4 .\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
5 .\"      Date: 02/15/2012
6 .\"    Manual: systemd-cgls
7 .\"    Source: systemd
8 .\"  Language: English
9 .\"
10 .TH "SYSTEMD\-CGLS" "1" "02/15/2012" "systemd" "systemd-cgls"
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-cgls \- Recursively show control group contents
32 .SH "SYNOPSIS"
33 .HP \w'\fBsystemd\-cgls\ \fR\fB[OPTIONS...]\fR\fB\ \fR\fB[CGROUP...]\fR\ 'u
34 \fBsystemd\-cgls \fR\fB[OPTIONS...]\fR\fB \fR\fB[CGROUP...]\fR
35 .SH "DESCRIPTION"
36 .PP
37 \fBsystemd\-cgls\fR
38 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
39 /sys/fs/cgroup
40 shows the contents of the control group the working directory refers to\&. Otherwise the full systemd control group hierarchy is shown\&.
41 .SH "OPTIONS"
42 .PP
43 The following options are understood:
44 .PP
45 \fB\-h\fR, \fB\-\-help\fR
46 .RS 4
47 Prints a short help text and exits\&.
48 .RE
49 .PP
50 \fB\-\-no\-pager\fR
51 .RS 4
52 Do not pipe output into a pager\&.
53 .RE
54 .PP
55 \fB\-k\fR
56 .RS 4
57 Include kernel threads in output\&.
58 .RE
59 .SH "EXIT STATUS"
60 .PP
61 On success 0 is returned, a non\-zero failure code otherwise\&.
62 .SH "SEE ALSO"
63 .PP
64
65 \fBsystemd\fR(1),
66 \fBsystemctl\fR(1),
67 \fBsystemd-cgtop\fR(1),
68 \fBps\fR(1)
69 .SH "AUTHOR"
70 .PP
71 \fBLennart Poettering\fR <\&lennart@poettering\&.net\&>
72 .RS 4
73 Developer
74 .RE