The following options are understood:
--system
Operates on the system systemd instance. This is the implied
default.
--user
Operates on the user systemd instance.
--global
Operates on the system-wide configuration for user systemd
instance.
--order
, --require
When used in conjunction with the dot
command (see above),
selects which dependencies are shown in the dependency graph.
If --order
is passed, only dependencies of type After= or
Before= are shown. If --require
is passed, only dependencies
of type Requires=, Requisite=, Wants= and Conflicts= are
shown. If neither is passed, this shows dependencies of all
these types.
--from-pattern=
, --to-pattern=
When used in conjunction with the dot
command (see above),
this selects which relationships are shown in the dependency
graph. Both options require a glob(7) pattern as an argument,
which will be matched against the left-hand and the
right-hand, respectively, nodes of a relationship.
Each of these can be used more than once, in which case the
unit name must match one of the values. When tests for both
sides of the relation are present, a relation must pass both
tests to be shown. When patterns are also specified as
positional arguments, they must match at least one side of
the relation. In other words, patterns specified with those
two options will trim the list of edges matched by the
positional arguments, if any are given, and fully determine
the list of edges shown otherwise.
--fuzz=
timespan
When used in conjunction with the critical-chain
command (see
above), also show units, which finished timespan earlier,
than the latest unit in the same level. The unit of timespan
is seconds unless specified with a different unit, e.g.
"50ms".
--man=no
Do not invoke man(1) to verify the existence of man pages
listed in Documentation=.
--generators
Invoke unit generators, see systemd.generator(7). Some
generators require root privileges. Under a normal user,
running with generators enabled will generally result in some
warnings.
--recursive-errors=
MODE
Control verification of units and their dependencies and
whether systemd-analyze verify
exits with a non-zero process
exit status or not. With yes
, return a non-zero process exit
status when warnings arise during verification of either the
specified unit or any of its associated dependencies. This is
the default. With no
, return a non-zero process exit status
when warnings arise during verification of only the specified
unit. With one
, return a non-zero process exit status when
warnings arise during verification of either the specified
unit or its immediate dependencies.
--root=
PATH
With cat-files
and verify
, operate on files underneath the
specified root path PATH.
--image=
PATH
With cat-files
and verify
, operate on files inside the
specified image path PATH.
--offline=
BOOL
With security
, perform an offline security review of the
specified unit file(s), i.e. does not have to rely on PID 1
to acquire security information for the files like the
security
verb when used by itself does. This means that
--offline=
can be used with --root=
and --image=
as well. If
a unit's overall exposure level is above that set by
--threshold=
(default value is 100), --offline=
will return
an error.
--threshold=
NUMBER
With security
, allow the user to set a custom value to
compare the overall exposure level with, for the specified
unit file(s). If a unit's overall exposure level, is greater
than that set by the user, security
will return an error.
--threshold=
can be used with --offline=
as well and its
default value is 100.
--iterations=
NUMBER
When used with the calendar
command, show the specified
number of iterations the specified calendar expression will
elapse next. Defaults to 1.
--base-time=
TIMESTAMP
When used with the calendar
command, show next iterations
relative to the specified point in time. If not specified
defaults to the current time.
-H
, --host=
Execute the operation remotely. Specify a hostname, or a
username and hostname separated by "@", to connect to. The
hostname may optionally be suffixed by a port ssh is
listening on, separated by ":", and then a container name,
separated by "/", which connects directly to a specific
container on the specified host. This will use SSH to talk to
the remote machine manager instance. Container names may be
enumerated with machinectl -H
HOST. Put IPv6 addresses in
brackets.
-M
, --machine=
Execute operation on a local container. Specify a container
name to connect to, optionally prefixed by a user name to
connect as and a separating "@" character. If the special
string ".host" is used in place of the container name, a
connection to the local system is made (which is useful to
connect to a specific user's user bus: "--user
--machine=lennart@.host"). If the "@" syntax is not used, the
connection is made as root user. If the "@" syntax is used
either the left hand side or the right hand side may be
omitted (but not both) in which case the local user name and
".host" are implied.
-h
, --help
Print a short help text and exit.
--version
Print a short version string and exit.
--no-pager
Do not pipe output into a pager.