Home • Explore • Blog • CI
☰



man-pages
1st chunk of `systemctl.man`
ac5931b68fd784afdf53eb1f9718425f5fbe54ebd8b295760000000100000fa4
SYSTEMCTL(1)                                                                                                systemctl                                                                                               SYSTEMCTL(1)

NAME
       systemctl - Control the systemd system and service manager

SYNOPSIS

       systemctl [OPTIONS...] COMMAND [UNIT...]

DESCRIPTION
       systemctl may be used to introspect and control the state of the "systemd" system and service manager. Please refer to systemd(1) for an introduction into the basic concepts and functionality this tool manages.

COMMANDS
       The following commands are understood:

   Unit Commands (Introspection and Modification)
       list-units [PATTERN...]
           List units that systemd currently has in memory. This includes units that are either referenced directly or through a dependency, units that are pinned by applications programmatically, or units that were active
           in the past and have failed. By default only units which are active, have pending jobs, or have failed are shown; this can be changed with option --all. If one or more PATTERNs are specified, only units matching
           one of them are shown. The units that are shown are additionally filtered by --type= and --state= if those options are specified.

           Note that this command does not show unit templates, but only instances of unit templates. Units templates that aren't instantiated are not runnable, and will thus never show up in the output of this command.
           Specifically this means that foo@.service will never be shown in this list — unless instantiated, e.g. as foo@bar.service. Use list-unit-files (see below) for listing installed unit template files.

           Produces output similar to

                 UNIT                         LOAD   ACTIVE SUB     DESCRIPTION
                 sys-module-fuse.device       loaded active plugged /sys/module/fuse
                 -.mount                      loaded active mounted Root Mount
                 boot-efi.mount               loaded active mounted /boot/efi
                 systemd-journald.service     loaded active running Journal Service
                 systemd-logind.service       loaded active running Login Service
               ● user@1000.service            loaded failed failed  User Manager for UID 1000
                 ...
                 systemd-tmpfiles-clean.timer loaded active waiting Daily Cleanup of Temporary Directories

               LOAD   = Reflects whether the unit definition was properly loaded.
               ACTIVE = The high-level unit activation state, i.e. generalization of SUB.
               SUB    = The low-level unit activation state, values depend on unit type.

               123 loaded units listed. Pass --all to see loaded but inactive units, too.
               To show all installed unit files use 'systemctl list-unit-files'.

           The header and the last unit of a given type are underlined if the terminal supports that. A colored dot is shown next to services which were masked, not found, or otherwise failed.

           The LOAD column shows the load state, one of loaded, not-found, bad-setting, error, masked. The ACTIVE columns shows the general unit state, one of active, reloading, inactive, failed, activating, deactivating.
           The SUB column shows the unit-type-specific detailed state of the unit, possible values vary by unit type. The list of possible LOAD, ACTIVE, and SUB states is not constant and new systemd releases may both add
           and remove values.

               systemctl --state=help

           command maybe be used to display the current set of possible values.

           This is the default command.

       list-automounts [PATTERN...]
           List automount units currently in memory, ordered by mount path. If one or more PATTERNs are specified, only automount units matching one of them are shown. Produces output similar to
Title: systemctl - System and Service Manager Control
Summary
The `systemctl` command is used to inspect and control the state of the systemd system and service manager. It provides various commands for managing units, including listing active units with details on their load state, active state, and sub-state. The `list-units` command displays units that are loaded, active, or have failed, and can be filtered by patterns, types, and states. Other commands like `list-automounts` list specific types of units.