diff --git a/man/systemd.service.xml b/man/systemd.service.xml index 047fb912e9..56ff4577ce 100644 --- a/man/systemd.service.xml +++ b/man/systemd.service.xml @@ -386,27 +386,23 @@ ExecStart= - Commands that are executed when this service is started. The value is split into zero - or more command lines according to the rules described in the section "Command Lines" below. + Commands that are executed when this service is started. - Unless Type= is , exactly one command must be given. When - Type=oneshot is used, zero or more commands may be specified. Commands may be specified by - providing multiple command lines in the same directive, or alternatively, this directive may be specified more - than once with the same effect. If the empty string is assigned to this option, the list of commands to start - is reset, prior assignments of this option will have no effect. If no ExecStart= is - specified, then the service must have RemainAfterExit=yes and at least one - ExecStop= line set. (Services lacking both ExecStart= and - ExecStop= are not valid.) + Unless Type= is , exactly one command must be + given. When Type=oneshot is used, this setting may be used multiple times to + define multiple commands to execute. If the empty string is assigned to this option, the list of + commands to start is reset, prior assignments of this option will have no effect. If no + ExecStart= is specified, then the service must have + RemainAfterExit=yes and at least one ExecStop= line + set. (Services lacking both ExecStart= and ExecStop= are not + valid.) - If more than one command is specified, the commands are - invoked sequentially in the order they appear in the unit - file. If one of the commands fails (and is not prefixed with - -), other lines are not executed, and the - unit is considered failed. + If more than one command is configured, the commands are invoked sequentially in the order they + appear in the unit file. If one of the commands fails (and is not prefixed with + -), other lines are not executed, and the unit is considered failed. - Unless Type=forking is set, the - process started via this command line will be considered the - main process of the daemon. + Unless Type=forking is set, the process started via this command line will + be considered the main process of the daemon. @@ -1354,9 +1350,7 @@ ExecStopPost=, and ExecCondition= options. - Multiple command lines may be concatenated in a single directive by separating them with semicolons - (these semicolons must be passed as separate words). Lone semicolons may be escaped as - \;. + Multiple command lines may be specified by using the relevant setting multiple times. Each command line is unquoted using the rules described in "Quoting" section in systemd.syntax7. The @@ -1434,17 +1428,17 @@ For each command, the first argument must be either an absolute path to an executable or a simple file name without any slashes. If the command is not a full (absolute) path, it will be resolved to a full path using a fixed search path determined at compilation time. Searched directories include - /usr/local/bin/, /usr/bin/, /bin/ on - systems using split /usr/bin/ and /bin/ directories, and their - sbin/ counterparts on systems using split bin/ and - sbin/. It is thus safe to use just the executable name in case of executables - located in any of the "standard" directories, and an absolute path must be used in other cases. - Hint: this search path may be queried using systemd-path search-binaries-default. - + /usr/local/bin/, /usr/bin/, and their + sbin/ counterparts (only on systems using split bin/ and + sbin/). It is thus safe to use just the executable name in case of executables + located in any of the "standard" directories, and an absolute path must be used in other cases. Hint: + this search path may be queried using systemd-path search-binaries-default. The command line accepts % specifiers as described in systemd.unit5. + An argument solely consisting of ; must be escaped, i.e. specified as \; + Basic environment variable substitution is supported. Use ${FOO} as part of a word, or as a word of its own, on the command line, in which case it will be erased and replaced @@ -1499,7 +1493,8 @@ ExecStart=/bin/echo $ONE $TWO $THREE Example: - ExecStart=echo one ; echo "two two" + ExecStart=echo one +ExecStart=echo "two two" This will execute echo two times, each time with one argument: one and @@ -1509,7 +1504,9 @@ ExecStart=/bin/echo $ONE $TWO $THREE Example: Type=oneshot -ExecStart=:echo $USER ; -false ; +:@true $TEST +ExecStart=:echo $USER +ExecStart=-false +ExecStart=+:@true $TEST This will execute /usr/bin/echo with the literal argument $USER (: suppresses variable expansion), and then diff --git a/src/core/load-fragment.c b/src/core/load-fragment.c index e49276eae5..6e0762d7a2 100644 --- a/src/core/load-fragment.c +++ b/src/core/load-fragment.c @@ -920,7 +920,11 @@ int config_parse_exec( if (r <= 0) return 0; - /* A lone ";" is a separator. Let's make sure we don't treat it as an executable name. */ + /* A lone ";" is a separator. Let's make sure we don't treat it as an executable name. + * + * SOFT DEPRECATION: We support multiple command lines in one ExecStart= line for + * compatibility with older versions, but we no longer document this exists, it's deprecated + * in a soft way. New unit files, should not use this feature. */ if (streq(firstword, ";")) { semicolon = true; continue;