Home Explore Blog CI



man-pages

21th chunk of `systemctl.man`
6ed7e4ad2da7dc0f5fb122bbfd83f0fbb5bd7c673de86bb20000000100000fa2
 operation is successfully enqueued. It will not wait for the sleep/wake-up or hibernate/thaw cycle to complete.

   Parameter Syntax
       Unit commands listed above take either a single unit name (designated as UNIT), or multiple unit specifications (designated as PATTERN...). In the first case, the unit name with or without a suffix must be given. If
       the suffix is not specified (unit name is "abbreviated"), systemctl will append a suitable suffix, ".service" by default, and a type-specific suffix in case of commands which operate only on specific unit types. For
       example,

           # systemctl start sshd

       and

           # systemctl start sshd.service

       are equivalent, as are

           # systemctl isolate default

       and

           # systemctl isolate default.target

       Note that (absolute) paths to device nodes are automatically converted to device unit names, and other (absolute) paths to mount unit names.

           # systemctl status /dev/sda
           # systemctl status /home

       are equivalent to:

           # systemctl status dev-sda.device
           # systemctl status home.mount

       In the second case, shell-style globs will be matched against the primary names of all units currently in memory; literal unit names, with or without a suffix, will be treated as in the first case. This means that
       literal unit names always refer to exactly one unit, but globs may match zero units and this is not considered an error.

       Glob patterns use fnmatch(3), so normal shell-style globbing rules are used, and "*", "?", "[]" may be used. See glob(7) for more details. The patterns are matched against the primary names of units currently in
       memory, and patterns which do not match anything are silently skipped. For example:

           # systemctl stop sshd@*.service

       will stop all sshd@.service instances. Note that alias names of units, and units that aren't in memory are not considered for glob expansion.

       For unit file commands, the specified UNIT should be the name of the unit file (possibly abbreviated, see above), or the absolute path to the unit file:

           # systemctl enable foo.service

       or

           # systemctl link /path/to/foo.service

OPTIONS
       The following options are understood:

       -t, --type=
           The argument is a comma-separated list of unit types such as service and socket. When units are listed with list-units, list-dependencies, show, or status, only units of the specified types will be shown. By
           default, units of all types are shown.

           As a special case, if one of the arguments is help, a list of allowed values will be printed and the program will exit.

       --state=
           The argument is a comma-separated list of unit LOAD, SUB, or ACTIVE states. When listing units with list-units, list-dependencies, show or status, show only those in the specified states. Use --state=failed or
           --failed to show only failed units.

           As a special case, if one of the arguments is help, a list of allowed values will be printed and the program will exit.

       -p, --property=
           When showing unit/job/manager properties with the show command, limit display to properties specified in the argument. The argument should be a comma-separated list of property names, such as "MainPID". Unless
           specified, all known properties are shown. If specified more than once, all properties with the specified names are shown. Shell completion is implemented for property names.

           For the manager itself, systemctl show will show all available properties, most of which are derived or closely match the options described in systemd‐system.conf(5).

           Properties for units vary by unit type, so showing any unit (even a non-existent one) is a way to list properties pertaining to this type. Similarly, showing any job will list properties pertaining to all jobs.

Title: systemctl: Parameter Syntax Details and Options (-t/--type, --state, -p/--property)
Summary
This section expands on `systemctl`'s parameter syntax, explaining how unit names, globs, and paths are interpreted. It also covers options like `-t/--type` to filter units by type, `--state` to filter by state (LOAD, SUB, ACTIVE), and `-p/--property` to show specific unit/job/manager properties.