systemd-cgls(1) — Linux manual page


SYSTEMD-CGLS(1)                 systemd-cgls                 SYSTEMD-CGLS(1)

NAME         top

       systemd-cgls - Recursively show control group contents

SYNOPSIS         top

       systemd-cgls [OPTIONS...] [CGROUP...]

       systemd-cgls [OPTIONS...] --unit|--user-unit [UNIT...]

DESCRIPTION         top

       systemd-cgls 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.

       By default, empty control groups are not shown.

OPTIONS         top

       The following options are understood:

           Do not hide empty control groups in the output.

       -l, --full
           Do not ellipsize process tree members.

       -u, --unit
           Show cgroup subtrees for the specified units.

           Show cgroup subtrees for the specified user units.

           Include kernel threads in output.

       -M MACHINE, --machine=MACHINE
           Limit control groups shown to the part corresponding to the
           container MACHINE.

       -h, --help
           Print a short help text and exit.

           Print a short version string and exit.

           Do not pipe output into a pager.

EXIT STATUS         top

       On success, 0 is returned, a non-zero failure code otherwise.

SEE ALSO         top

       systemd(1), systemctl(1), systemd-cgtop(1), systemd-nspawn(1), ps(1)

COLOPHON         top

       This page is part of the systemd (systemd system and service manager)
       project.  Information about the project can be found at 
       ⟨⟩.  If you have a bug
       report for this manual page, see
       ⟨⟩.  This
       page was obtained from the project's upstream Git repository
       ⟨⟩ on 2020-11-01.  (At that
       time, the date of the most recent commit that was found in the repos‐
       itory was 2020-11-01.)  If you discover any rendering problems in
       this HTML version of the page, or you believe there is a better or
       more up-to-date source for the page, or you have corrections or im‐
       provements to the information in this COLOPHON (which is not part of
       the original manual page), send a mail to

systemd 247                                                  SYSTEMD-CGLS(1)

Pages that refer to this page: init(1)systemd(1)systemd-cgtop(1)30-systemd-environment-d-generator(7)cgroups(7)systemd.directives(7)systemd.index(7)systemd-machined(8)systemd-machined.service(8)