Adding upstream version 4.23.0.upstream/4.23.0

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

1 files changed, 61 insertions, 7 deletions

diff --git a/upstream/opensuse-tumbleweed/man1/systemd-run.1 b/upstream/opensuse-tumbleweed/man1/systemd-run.1
index 4127c887..b2792c09 100644
--- a/upstream/opensuse-tumbleweed/man1/systemd-run.1
+++ b/upstream/opensuse-tumbleweed/man1/systemd-run.1
@@ -1,5 +1,5 @@
 '\" t
-.TH "SYSTEMD\-RUN" "1" "" "systemd 254" "systemd-run"
+.TH "SYSTEMD\-RUN" "1" "" "systemd 255" "systemd-run"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------
@@ -111,6 +111,8 @@ The following options are understood:
 \fB\-\-no\-ask\-password\fR
 .RS 4
 Do not query the user for authentication for privileged operations\&.
+.sp
+Added in version 226\&.
 .RE
 .PP
 \fB\-\-scope\fR
@@ -120,11 +122,15 @@ Create a transient
 unit instead of the default transient
 \&.service
 unit (see above)\&.
+.sp
+Added in version 206\&.
 .RE
 .PP
 \fB\-\-unit=\fR, \fB\-u\fR
 .RS 4
 Use this unit name instead of an automatically generated one\&.
+.sp
+Added in version 206\&.
 .RE
 .PP
 \fB\-\-property=\fR, \fB\-p\fR
@@ -133,6 +139,8 @@ Sets a property on the scope or service unit that is created\&. This option take
 \fBsystemctl\fR(1)\*(Aqs
 \fBset\-property\fR
 command\&.
+.sp
+Added in version 211\&.
 .RE
 .PP
 \fB\-\-description=\fR
@@ -141,6 +149,8 @@ Provide a description for the service, scope, path, socket, or timer unit\&. If
 \fIDescription=\fR
 in
 \fBsystemd.unit\fR(5)\&.
+.sp
+Added in version 206\&.
 .RE
 .PP
 \fB\-\-slice=\fR
@@ -156,6 +166,8 @@ system\&.slice
 mode) or the root slice (when running in
 \fB\-\-user\fR
 mode)\&.
+.sp
+Added in version 206\&.
 .RE
 .PP
 \fB\-\-slice\-inherit\fR
@@ -177,6 +189,8 @@ foo\&.slice, and the
 argument is
 bar, the unit will be placed under the
 foo\-bar\&.slice\&.
+.sp
+Added in version 246\&.
 .RE
 .PP
 \fB\-\-expand\-environment=\fR\fB\fIBOOL\fR\fR
@@ -201,6 +215,8 @@ See
 for a description of variable expansion\&. Disabling variable expansion is useful if the specified command includes or may include a
 "$"
 sign\&.
+.sp
+Added in version 254\&.
 .RE
 .PP
 \fB\-r\fR, \fB\-\-remain\-after\-exit\fR
@@ -209,6 +225,8 @@ After the service process has terminated, keep the service around until it is ex
 \fIRemainAfterExit=\fR
 in
 \fBsystemd.service\fR(5)\&.
+.sp
+Added in version 207\&.
 .RE
 .PP
 \fB\-\-send\-sighup\fR
@@ -217,6 +235,8 @@ When terminating the scope or service unit, send a SIGHUP immediately after SIGT
 \fISendSIGHUP=\fR
 in
 \fBsystemd.kill\fR(5)\&.
+.sp
+Added in version 207\&.
 .RE
 .PP
 \fB\-\-service\-type=\fR
@@ -227,6 +247,8 @@ in
 \fBsystemd.service\fR(5)\&. This option has no effect in conjunction with
 \fB\-\-scope\fR\&. Defaults to
 \fBsimple\fR\&.
+.sp
+Added in version 211\&.
 .RE
 .PP
 \fB\-\-uid=\fR, \fB\-\-gid=\fR
@@ -237,6 +259,8 @@ and
 \fIGroup=\fR
 in
 \fBsystemd.exec\fR(5)\&.
+.sp
+Added in version 211\&.
 .RE
 .PP
 \fB\-\-nice=\fR
@@ -245,6 +269,8 @@ Runs the service process with the specified nice level\&. Also see
 \fINice=\fR
 in
 \fBsystemd.exec\fR(5)\&.
+.sp
+Added in version 211\&.
 .RE
 .PP
 \fB\-\-working\-directory=\fR
@@ -253,12 +279,16 @@ Runs the service process with the specified working directory\&. Also see
 \fIWorkingDirectory=\fR
 in
 \fBsystemd.exec\fR(5)\&.
+.sp
+Added in version 240\&.
 .RE
 .PP
 \fB\-\-same\-dir\fR, \fB\-d\fR
 .RS 4
 Similar to
 \fB\-\-working\-directory=\fR, but uses the current working directory of the caller for the service to execute\&.
+.sp
+Added in version 240\&.
 .RE
 .PP
 \fB\-E \fR\fB\fINAME\fR\fR\fB[=\fR\fB\fIVALUE\fR\fR\fB]\fR, \fB\-\-setenv=\fR\fB\fINAME\fR\fR\fB[=\fR\fB\fIVALUE\fR\fR\fB]\fR
@@ -273,6 +303,8 @@ Also see
 \fIEnvironment=\fR
 in
 \fBsystemd.exec\fR(5)\&.
+.sp
+Added in version 211\&.
 .RE
 .PP
 \fB\-\-pty\fR, \fB\-t\fR
@@ -288,6 +320,8 @@ command is usually a better alternative for requesting a new, interactive login
 .sp
 See below for details on how this switch combines with
 \fB\-\-pipe\fR\&.
+.sp
+Added in version 219\&.
 .RE
 .PP
 \fB\-\-pipe\fR, \fB\-P\fR
@@ -317,12 +351,16 @@ receives are passed to the service processes as\-is\&. If the service runs with
 construct for writing messages to stderr, this might cause problems, as this only works if stderr can be re\-opened\&. To mitigate this use the construct
 \fBecho "hello" >&2\fR
 instead, which is mostly equivalent and avoids this pitfall\&.
+.sp
+Added in version 235\&.
 .RE
 .PP
 \fB\-\-shell\fR, \fB\-S\fR
 .RS 4
 A shortcut for
 "\-\-pty \-\-same\-dir \-\-wait \-\-collect \-\-service\-type=exec $SHELL", i\&.e\&. requests an interactive shell in the current working directory, running in service context, accessible with a single switch\&.
+.sp
+Added in version 240\&.
 .RE
 .PP
 \fB\-\-quiet\fR, \fB\-q\fR
@@ -330,6 +368,8 @@ A shortcut for
 Suppresses additional informational output while running\&. This is particularly useful in combination with
 \fB\-\-pty\fR
 when it will suppress the initial message explaining how to terminate the TTY connection\&.
+.sp
+Added in version 219\&.
 .RE
 .PP
 \fB\-\-on\-active=\fR, \fB\-\-on\-boot=\fR, \fB\-\-on\-startup=\fR, \fB\-\-on\-unit\-active=\fR, \fB\-\-on\-unit\-inactive=\fR
@@ -349,6 +389,8 @@ with the relevant properties\&. These options may not be combined with
 \fB\-\-scope\fR
 or
 \fB\-\-pty\fR\&.
+.sp
+Added in version 218\&.
 .RE
 .PP
 \fB\-\-on\-calendar=\fR
@@ -361,6 +403,8 @@ in
 \fB\-\-scope\fR
 or
 \fB\-\-pty\fR\&.
+.sp
+Added in version 218\&.
 .RE
 .PP
 \fB\-\-on\-clock\-change\fR, \fB\-\-on\-timezone\-change\fR
@@ -377,6 +421,8 @@ and
 \fB\-\-scope\fR
 or
 \fB\-\-pty\fR\&.
+.sp
+Added in version 242\&.
 .RE
 .PP
 \fB\-\-path\-property=\fR, \fB\-\-socket\-property=\fR, \fB\-\-timer\-property=\fR
@@ -389,6 +435,8 @@ command\&. These options may not be combined with
 \fB\-\-scope\fR
 or
 \fB\-\-pty\fR\&.
+.sp
+Added in version 218\&.
 .RE
 .PP
 \fB\-\-no\-block\fR
@@ -397,6 +445,8 @@ Do not synchronously wait for the unit start operation to finish\&. If this opti
 \fBsystemd\-run\fR
 will wait until the unit\*(Aqs start\-up is completed\&. By passing this argument, it is only verified and enqueued\&. This option may not be combined with
 \fB\-\-wait\fR\&.
+.sp
+Added in version 220\&.
 .RE
 .PP
 \fB\-\-wait\fR
@@ -408,6 +458,8 @@ was set) and the exit code and status of the main process\&. This output may be
 \fB\-\-no\-block\fR,
 \fB\-\-scope\fR
 or the various path, socket, or timer options\&.
+.sp
+Added in version 232\&.
 .RE
 .PP
 \fB\-G\fR, \fB\-\-collect\fR
@@ -420,6 +472,8 @@ or an equivalent command\&. On the other hand, units that ran successfully are u
 in
 \fBsystemd.unit\fR(5)
 for further information\&.
+.sp
+Added in version 236\&.
 .RE
 .PP
 \fB\-\-user\fR
@@ -633,11 +687,11 @@ $ systemd\-run \-t echo "<${INVOCATION_ID}>" \*(Aq<${INVOCATION_ID}>\*(Aq
 .\}
 .PP
 The first argument is expanded by the shell (double quotes), but the second one is not expanded by the shell (single quotes)\&.
-\fBecho\fR
+\fBecho\fR(1)
 is called with ["/usr/bin/echo",
-"[]",
-"[${INVOCATION_ID}]"] as the argument array, and then
-\fBsystemd\fR
+"<>",
+"<${INVOCATION_ID}>"] as the argument array, and then
+\fBsystemd\fR(1)
 generates
 \fI${INVOCATION_ID}\fR
 and substitutes it in the command\-line\&. This substitution could not be done on the client side, because the target ID that will be set for the service isn\*(Aqt known before the call is made\&.
@@ -645,7 +699,7 @@ and substitutes it in the command\-line\&. This substitution could not be done o
 \fBExample\ \&7.\ \&Variable expansion and output redirection using a shell\fR
 .PP
 Variable expansion by
-\fBsystemd\fR
+\fBsystemd\fR(1)
 can be disabled with
 \fI\-\-expand\-environment=no\fR\&.
 .PP
@@ -665,7 +719,7 @@ $ systemd\-run \-\-expand\-environment=no \-t bash \e
 .\}
 .PP
 The last argument is passed verbatim to the
-\fBbash\fR
+\fBbash\fR(1)
 shell which is started by the service unit\&. The shell expands
 "$SHELL"
 to the path of the shell, and