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 2017-03-13.  If you dis‐
       cover 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 improvements to the information in this
       COLOPHON (which is not part of the original manual page), send a mail

systemd 233                                                  SYSTEMD-CGLS(1)