What is the difference between systemd
service Type
oneshot
and simple
?
This link states to use simple
instead of oneshot
for timers. I am not able to understand it correctly.
2 Answers
The Type=oneshot
service unit:
blocks on a start operation until the first process exits, and its state will be reported as "activating";
once the first process exits, transitions from "activating" straight to "inactive", unless
RemainAfterExit=true
is set (in which case it becomes "active" with no processes!);may have any number (0 or more) of
ExecStart=
directives which will be executed sequentially (waiting for each started process to exit before starting the next one);may leave out
ExecStart=
but haveExecStop=
(useful together withRemainAfterExit=true
for arranging things to run on system shutdown).
The Type=simple
service unit:
does not block on a start operation (i. e. becomes "active" immediately after forking off the first process, even if it is still initializing!);
once the first process exits, transitions from "active" to "inactive" (there is no
RemainAfterExit=
option);is generally discouraged because there is no way to distinguish situations like "exited on start because of a configuration error" from "crashed after 500ms of runtime" and suchlike.
Both Type=oneshot
and Type=simple
units:
- ignore any children of the first process, so do not use these modes with forking processes (note: you may use
Type=oneshot
withKillMode=none
, but only do this if you know what you are doing).
-
2intelfx says that the
Type=oneshot
service unit "can have noExecStart=
". This is not true. In fact, services of typeoneshot
can have multipleExecStart=
directives. See any recent man page forsystemd.service
for more information. Oct 22, 2017 at 1:09 -
2@rlandster: Why is this "not true"? systemd.service(5) says under
ExecStart=
: "Unless Type= is oneshot, exactly one command must be given. When Type=oneshot is used, zero or more commands may be specified."– intelfxOct 22, 2017 at 1:22 -
1agree that "can have no" is confusing. that is not true. but i think you can't have
ExecReload
– TonyApr 2, 2018 at 1:43 -
7By "can have no" I assume that @intelfx meant "can have zero or more," or "does not require a," and not "can't have any." However, rewording it for clarity would help future readers.– sehMay 1, 2018 at 18:17
-
1
From systemd's point of view, Type=simple
is kind of fire and forget. Systemd just forks a process defined in ExecStart=
and goes on its way, even if the process fails to start.
-
23
Type=simple
processes are still monitored by systemd, and will be restarted depending on the value of theRestart
setting. Feb 1, 2018 at 16:51