1 files changed, 116 insertions, 0 deletions
diff --git a/upstream/mageia-cauldron/man1/systemd-cgls.1 b/upstream/mageia-cauldron/man1/systemd-cgls.1
new file mode 100644
index 00000000..781d9307
--- /dev/null
+++ b/upstream/mageia-cauldron/man1/systemd-cgls.1
@@ -0,0 +1,116 @@
+'\" t
+.TH "SYSTEMD\-CGLS" "1" "" "systemd 255" "systemd-cgls"
+.\" -----------------------------------------------------------------
+.\" * Define some portability stuff
+.\" -----------------------------------------------------------------
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.\" http://bugs.debian.org/507673
+.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.ie \n(.g .ds Aq \(aq
+.el       .ds Aq '
+.\" -----------------------------------------------------------------
+.\" * set default formatting
+.\" -----------------------------------------------------------------
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.\" -----------------------------------------------------------------
+.\" * MAIN CONTENT STARTS HERE *
+.\" -----------------------------------------------------------------
+.SH "NAME"
+systemd-cgls \- Recursively show control group contents
+.SH "SYNOPSIS"
+.HP \w'\fBsystemd\-cgls\fR\ 'u
+\fBsystemd\-cgls\fR [OPTIONS...] [CGROUP...]
+.HP \w'\fBsystemd\-cgls\fR\ 'u
+\fBsystemd\-cgls\fR [OPTIONS...] \fB\-\-unit\fR|\fB\-\-user\-unit\fR [UNIT...]
+.SH "DESCRIPTION"
+.PP
+\fBsystemd\-cgls\fR
+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
+/sys/fs/cgroup/, shows the contents of the control group the working directory refers to\&. Otherwise, the full systemd control group hierarchy is shown\&.
+.PP
+By default, empty control groups are not shown\&.
+.SH "OPTIONS"
+.PP
+The following options are understood:
+.PP
+\fB\-\-all\fR
+.RS 4
+Do not hide empty control groups in the output\&.
+.RE
+.PP
+\fB\-l\fR, \fB\-\-full\fR
+.RS 4
+Do not ellipsize process tree members\&.
+.sp
+Added in version 198\&.
+.RE
+.PP
+\fB\-u\fR, \fB\-\-unit\fR
+.RS 4
+Show cgroup subtrees for the specified units\&.
+.sp
+Added in version 233\&.
+.RE
+.PP
+\fB\-\-user\-unit\fR
+.RS 4
+Show cgroup subtrees for the specified user units\&.
+.sp
+Added in version 233\&.
+.RE
+.PP
+\fB\-k\fR
+.RS 4
+Include kernel threads in output\&.
+.RE
+.PP
+\fB\-M \fR\fB\fIMACHINE\fR\fR, \fB\-\-machine=\fR\fB\fIMACHINE\fR\fR
+.RS 4
+Limit control groups shown to the part corresponding to the container
+\fIMACHINE\fR\&.
+.sp
+Added in version 203\&.
+.RE
+.PP
+\fB\-x\fR, \fB\-\-xattr=\fR
+.RS 4
+Controls whether to include information about extended attributes of the listed control groups in the output\&. With the long option, expects a boolean value\&. Defaults to no\&.
+.sp
+Added in version 250\&.
+.RE
+.PP
+\fB\-c\fR, \fB\-\-cgroup\-id=\fR
+.RS 4
+Controls whether to include the numeric ID of the listed control groups in the output\&. With the long option, expects a boolean value\&. Defaults to no\&.
+.sp
+Added in version 250\&.
+.RE
+.PP
+\fB\-h\fR, \fB\-\-help\fR
+.RS 4
+Print a short help text and exit\&.
+.RE
+.PP
+\fB\-\-version\fR
+.RS 4
+Print a short version string and exit\&.
+.RE
+.PP
+\fB\-\-no\-pager\fR
+.RS 4
+Do not pipe output into a pager\&.
+.RE
+.SH "EXIT STATUS"
+.PP
+On success, 0 is returned, a non\-zero failure code otherwise\&.
+.SH "SEE ALSO"
+.PP
+\fBsystemd\fR(1),
+\fBsystemctl\fR(1),
+\fBsystemd-cgtop\fR(1),
+\fBsystemd-nspawn\fR(1),
+\fBps\fR(1)