path: root/templates/man1/systemd-run.1.pot

# SOME DESCRIPTIVE TITLE
# Copyright (C) YEAR Free Software Foundation, Inc.
# This file is distributed under the same license as the PACKAGE package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"POT-Creation-Date: 2024-03-01 17:11+0100\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"Language: \n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"

#. type: TH
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "SYSTEMD-RUN"
msgstr ""

#. type: TH
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#, no-wrap
msgid "systemd 255"
msgstr ""

#. type: TH
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "systemd-run"
msgstr ""

#.  -----------------------------------------------------------------
#.  * MAIN CONTENT STARTS HERE *
#.  -----------------------------------------------------------------
#. type: SH
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "NAME"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"systemd-run - Run programs in transient scope units, service units, or "
"path-, socket-, or timer-triggered service units"
msgstr ""

#. type: SH
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "SYNOPSIS"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "B<systemd-run> [OPTIONS...] I<COMMAND>\\ [ARGS...]"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "B<systemd-run> [OPTIONS...] [PATH\\ OPTIONS...] {I<COMMAND>} [ARGS...]"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"B<systemd-run> [OPTIONS...] [SOCKET\\ OPTIONS...] {I<COMMAND>} [ARGS...]"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "B<systemd-run> [OPTIONS...] [TIMER\\ OPTIONS...] {I<COMMAND>} [ARGS...]"
msgstr ""

#. type: SH
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "DESCRIPTION"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"B<systemd-run> may be used to create and start a transient \\&.service or "
"\\&.scope unit and run the specified I<COMMAND> in it\\&. It may also be "
"used to create and start a transient \\&.path, \\&.socket, or \\&.timer "
"unit, that activates a \\&.service unit when elapsing\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"If a command is run as transient service unit, it will be started and "
"managed by the service manager like any other service, and thus shows up in "
"the output of B<systemctl list-units> like any other unit\\&. It will run in "
"a clean and detached execution environment, with the service manager as its "
"parent process\\&. In this mode, B<systemd-run> will start the service "
"asynchronously in the background and return after the command has begun "
"execution (unless B<--no-block> or B<--wait> are specified, see below)\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"If a command is run as transient scope unit, it will be executed by "
"B<systemd-run> itself as parent process and will thus inherit the execution "
"environment of the caller\\&. However, the processes of the command are "
"managed by the service manager similarly to normal services, and will show "
"up in the output of B<systemctl list-units>\\&. Execution in this case is "
"synchronous, and will return only when the command finishes\\&. This mode is "
"enabled via the B<--scope> switch (see below)\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"If a command is run with path, socket, or timer options such as B<--on-"
"calendar=> (see below), a transient path, socket, or timer unit is created "
"alongside the service unit for the specified command\\&. Only the transient "
"path, socket, or timer unit is started immediately, the transient service "
"unit will be triggered by the path, socket, or timer unit\\&. If the B<--"
"unit=> option is specified, the I<COMMAND> may be omitted\\&. In this case, "
"B<systemd-run> creates only a \\&.path, \\&.socket, or \\&.timer unit that "
"triggers the specified unit\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"By default, services created with B<systemd-run> default to the B<simple> "
"type, see the description of I<Type=> in B<systemd.service>(5)  for "
"details\\&. Note that when this type is used, the service manager (and thus "
"the B<systemd-run> command) considers service start-up successful as soon as "
"the B<fork()> for the main service process succeeded, i\\&.e\\&. before the "
"B<execve()> is invoked, and thus even if the specified command cannot be "
"started\\&. Consider using the B<exec> service type (i\\&.e\\&.  B<--"
"property=Type=exec>) to ensure that B<systemd-run> returns successfully only "
"if the specified command line has been successfully started\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"After B<systemd-run> passes the command to the service manager, the manager "
"performs variable expansion\\&. This means that dollar characters (\"$\") "
"which should not be expanded need to be escaped as \"$$\"\\&. Expansion can "
"also be disabled using I<--expand-environment=no>\\&."
msgstr ""

#. type: SH
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "OPTIONS"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "The following options are understood:"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "B<--no-ask-password>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "Do not query the user for authentication for privileged operations\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
msgid "Added in version 226\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "B<--scope>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Create a transient \\&.scope unit instead of the default transient \\&."
"service unit (see above)\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
msgid "Added in version 206\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "B<--unit=>, B<-u>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "Use this unit name instead of an automatically generated one\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "B<--property=>, B<-p>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Sets a property on the scope or service unit that is created\\&. This option "
"takes an assignment in the same format as B<systemctl>(1)\\*(Aqs B<set-"
"property> command\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
msgid "Added in version 211\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "B<--description=>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Provide a description for the service, scope, path, socket, or timer "
"unit\\&. If not specified, the command itself will be used as a "
"description\\&. See I<Description=> in B<systemd.unit>(5)\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "B<--slice=>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Make the new \\&.service or \\&.scope unit part of the specified slice, "
"instead of system\\&.slice (when running in B<--system> mode) or the root "
"slice (when running in B<--user> mode)\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "B<--slice-inherit>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Make the new \\&.service or \\&.scope unit part of the inherited slice\\&. "
"This option can be combined with B<--slice=>\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"An inherited slice is located within B<systemd-run> slice\\&. Example: if "
"B<systemd-run> slice is foo\\&.slice, and the B<--slice=> argument is bar, "
"the unit will be placed under the foo-bar\\&.slice\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
msgid "Added in version 246\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "B<--expand-environment=>I<BOOL>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Expand environment variables in command arguments\\&. If enabled, "
"environment variables specified as \"${I<VARIABLE>}\" will be expanded in "
"the same way as in commands specified via I<ExecStart=> in units\\&. With "
"I<--scope>, this expansion is performed by B<systemd-run> itself, and in "
"other cases by the service manager that spawns the command\\&. Note that "
"this is similar to, but not the same as variable expansion in B<bash>(1)  "
"and other shells\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The default is to enable this option in all cases, except for I<--scope> "
"where it is disabled by default, for backward compatibility reasons\\&. Note "
"that this will be changed in a future release, where it will be switched to "
"enabled by default as well\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"See B<systemd.service>(5)  for a description of variable expansion\\&. "
"Disabling variable expansion is useful if the specified command includes or "
"may include a \"$\" sign\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
msgid "Added in version 254\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "B<-r>, B<--remain-after-exit>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"After the service process has terminated, keep the service around until it "
"is explicitly stopped\\&. This is useful to collect runtime information "
"about the service after it finished running\\&. Also see I<RemainAfterExit=> "
"in B<systemd.service>(5)\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
msgid "Added in version 207\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "B<--send-sighup>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"When terminating the scope or service unit, send a SIGHUP immediately after "
"SIGTERM\\&. This is useful to indicate to shells and shell-like processes "
"that the connection has been severed\\&. Also see I<SendSIGHUP=> in "
"B<systemd.kill>(5)\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "B<--service-type=>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Sets the service type\\&. Also see I<Type=> in B<systemd.service>(5)\\&. "
"This option has no effect in conjunction with B<--scope>\\&. Defaults to "
"B<simple>\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "B<--uid=>, B<--gid=>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Runs the service process under the specified UNIX user and group\\&. Also "
"see I<User=> and I<Group=> in B<systemd.exec>(5)\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "B<--nice=>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Runs the service process with the specified nice level\\&. Also see I<Nice=> "
"in B<systemd.exec>(5)\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "B<--working-directory=>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Runs the service process with the specified working directory\\&. Also see "
"I<WorkingDirectory=> in B<systemd.exec>(5)\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
msgid "Added in version 240\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "B<--same-dir>, B<-d>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Similar to B<--working-directory=>, but uses the current working directory "
"of the caller for the service to execute\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "B<-E >I<NAME>B<[=>I<VALUE>B<]>, B<--setenv=>I<NAME>B<[=>I<VALUE>B<]>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Runs the service process with the specified environment variable set\\&. "
"This parameter may be used more than once to set multiple variables\\&. When "
"\"=\" and I<VALUE> are omitted, the value of the variable with the same name "
"in the program environment will be used\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "Also see I<Environment=> in B<systemd.exec>(5)\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "B<--pty>, B<-t>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"When invoking the command, the transient service connects its standard "
"input, output and error to the terminal B<systemd-run> is invoked on, via a "
"pseudo TTY device\\&. This allows running programs that expect interactive "
"user input/output as services, such as interactive command shells\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Note that B<machinectl>(1)\\*(Aqs B<shell> command is usually a better "
"alternative for requesting a new, interactive login session on the local "
"host or a local container\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "See below for details on how this switch combines with B<--pipe>\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
msgid "Added in version 219\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "B<--pipe>, B<-P>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"If specified, standard input, output, and error of the transient service are "
"inherited from the B<systemd-run> command itself\\&. This allows B<systemd-"
"run> to be used within shell pipelines\\&. Note that this mode is not "
"suitable for interactive command shells and similar, as the service process "
"will not become a TTY controller when invoked on a terminal\\&. Use B<--pty> "
"instead in that case\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"When both B<--pipe> and B<--pty> are used in combination the more "
"appropriate option is automatically determined and used\\&. Specifically, "
"when invoked with standard input, output and error connected to a TTY B<--"
"pty> is used, and otherwise B<--pipe>\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"When this option is used the original file descriptors B<systemd-run> "
"receives are passed to the service processes as-is\\&. If the service runs "
"with different privileges than B<systemd-run>, this means the service might "
"not be able to re-open the passed file descriptors, due to normal file "
"descriptor access restrictions\\&. If the invoked process is a shell script "
"that uses the B<echo \"hello\" E<gt>/dev/stderr> 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 B<echo \"hello\" "
"E<gt>&2> instead, which is mostly equivalent and avoids this pitfall\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
msgid "Added in version 235\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "B<--shell>, B<-S>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"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\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "B<--quiet>, B<-q>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Suppresses additional informational output while running\\&. This is "
"particularly useful in combination with B<--pty> when it will suppress the "
"initial message explaining how to terminate the TTY connection\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"B<--on-active=>, B<--on-boot=>, B<--on-startup=>, B<--on-unit-active=>, B<--"
"on-unit-inactive=>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Defines a monotonic timer relative to different starting points for starting "
"the specified command\\&. See I<OnActiveSec=>, I<OnBootSec=>, "
"I<OnStartupSec=>, I<OnUnitActiveSec=> and I<OnUnitInactiveSec=> in B<systemd."
"timer>(5)  for details\\&. These options are shortcuts for B<--timer-"
"property=> with the relevant properties\\&. These options may not be "
"combined with B<--scope> or B<--pty>\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
msgid "Added in version 218\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "B<--on-calendar=>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Defines a calendar timer for starting the specified command\\&. See "
"I<OnCalendar=> in B<systemd.timer>(5)\\&. This option is a shortcut for B<--"
"timer-property=OnCalendar=>\\&. This option may not be combined with B<--"
"scope> or B<--pty>\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "B<--on-clock-change>, B<--on-timezone-change>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Defines a trigger based on system clock jumps or timezone changes for "
"starting the specified command\\&. See I<OnClockChange=> and "
"I<OnTimezoneChange=> in B<systemd.timer>(5)\\&. These options are shortcuts "
"for B<--timer-property=OnClockChange=yes> and B<--timer-"
"property=OnTimezoneChange=yes>\\&. These options may not be combined with "
"B<--scope> or B<--pty>\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
msgid "Added in version 242\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "B<--path-property=>, B<--socket-property=>, B<--timer-property=>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Sets a property on the path, socket, or timer unit that is created\\&. This "
"option is similar to B<--property=>, but applies to the transient path, "
"socket, or timer unit rather than the transient service unit created\\&. "
"This option takes an assignment in the same format as B<systemctl>(1)\\*(Aqs "
"B<set-property> command\\&. These options may not be combined with B<--"
"scope> or B<--pty>\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "B<--no-block>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Do not synchronously wait for the unit start operation to finish\\&. If this "
"option is not specified, the start request for the transient unit will be "
"verified, enqueued and B<systemd-run> 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 B<--wait>\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
msgid "Added in version 220\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "B<--wait>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Synchronously wait for the transient service to terminate\\&. If this option "
"is specified, the start request for the transient unit is verified, "
"enqueued, and waited for\\&. Subsequently the invoked unit is monitored, and "
"it is waited until it is deactivated again (most likely because the "
"specified command completed)\\&. On exit, terse information about the "
"unit\\*(Aqs runtime is shown, including total runtime (as well as CPU usage, "
"if B<--property=CPUAccounting=1> was set) and the exit code and status of "
"the main process\\&. This output may be suppressed with B<--quiet>\\&. This "
"option may not be combined with B<--no-block>, B<--scope> or the various "
"path, socket, or timer options\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
msgid "Added in version 232\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "B<-G>, B<--collect>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Unload the transient unit after it completed, even if it failed\\&. "
"Normally, without this option, all units that ran and failed are kept in "
"memory until the user explicitly resets their failure state with B<systemctl "
"reset-failed> or an equivalent command\\&. On the other hand, units that ran "
"successfully are unloaded immediately\\&. If this option is turned on the "
"\"garbage collection\" of units is more aggressive, and unloads units "
"regardless if they exited successfully or failed\\&. This option is a "
"shortcut for B<--property=CollectMode=inactive-or-failed>, see the "
"explanation for I<CollectMode=> in B<systemd.unit>(5)  for further "
"information\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
msgid "Added in version 236\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "B<--user>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Talk to the service manager of the calling user, rather than the service "
"manager of the system\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "B<--system>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Talk to the service manager of the system\\&. This is the implied default\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "B<-H>, B<--host=>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"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 "
"B<machinectl -H >I<HOST>\\&. Put IPv6 addresses in brackets\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "B<-M>, B<--machine=>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"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\\*(Aqs 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\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "B<-h>, B<--help>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "Print a short help text and exit\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "B<--version>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "Print a short version string and exit\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"All command line arguments after the first non-option argument become part "
"of the command line of the launched process\\&."
msgstr ""

#. type: SH
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "EXIT STATUS"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"On success, 0 is returned\\&. If B<systemd-run> failed to start the service, "
"a non-zero return value will be returned\\&. If B<systemd-run> waits for the "
"service to terminate, the return value will be propagated from the "
"service\\&. 0 will be returned on success, including all the cases where "
"systemd considers a service to have exited cleanly, see the discussion of "
"I<SuccessExitStatus=> in B<systemd.service>(5)\\&."
msgstr ""

#. type: SH
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "EXAMPLES"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"B<Example\\ \\&1.\\ \\&Logging environment variables provided by systemd to "
"services>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid ""
"# systemd-run env\n"
"Running as unit: run-19945\\&.service\n"
"# journalctl -u run-19945\\&.service\n"
"Sep 08 07:37:21 bupkis systemd[1]: Starting /usr/bin/env\\&.\\&.\\&.\n"
"Sep 08 07:37:21 bupkis systemd[1]: Started /usr/bin/env\\&.\n"
"Sep 08 07:37:21 bupkis env[19948]: PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin\n"
"Sep 08 07:37:21 bupkis env[19948]: LANG=en_US\\&.UTF-8\n"
"Sep 08 07:37:21 bupkis env[19948]: BOOT_IMAGE=/vmlinuz-3\\&.11\\&.0-0\\&.rc5\\&.git6\\&.2\\&.fc20\\&.x86_64\n"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "B<Example\\ \\&2.\\ \\&Limiting resources available to a command>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "# systemd-run -p IOWeight=10 updatedb\n"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"This command invokes the B<updatedb>(8)  tool, but lowers the block I/O "
"weight for it to 10\\&. See B<systemd.resource-control>(5)  for more "
"information on the I<IOWeight=> property\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "B<Example\\ \\&3.\\ \\&Running commands at a specified time>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "The following command will touch a file after 30 seconds\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid ""
"# date; systemd-run --on-active=30 --timer-property=AccuracySec=100ms /bin/touch /tmp/foo\n"
"Mon Dec  8 20:44:24 KST 2014\n"
"Running as unit: run-71\\&.timer\n"
"Will run service as unit: run-71\\&.service\n"
"# journalctl -b -u run-71\\&.timer\n"
"-- Journal begins at Fri 2014-12-05 19:09:21 KST, ends at Mon 2014-12-08 20:44:54 KST\\&. --\n"
"Dec 08 20:44:38 container systemd[1]: Starting /bin/touch /tmp/foo\\&.\n"
"Dec 08 20:44:38 container systemd[1]: Started /bin/touch /tmp/foo\\&.\n"
"# journalctl -b -u run-71\\&.service\n"
"-- Journal begins at Fri 2014-12-05 19:09:21 KST, ends at Mon 2014-12-08 20:44:54 KST\\&. --\n"
"Dec 08 20:44:48 container systemd[1]: Starting /bin/touch /tmp/foo\\&.\\&.\\&.\n"
"Dec 08 20:44:48 container systemd[1]: Started /bin/touch /tmp/foo\\&.\n"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "B<Example\\ \\&4.\\ \\&Allowing access to the tty>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The following command invokes B<bash>(1)  as a service passing its standard "
"input, output and error to the calling TTY\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "# systemd-run -t --send-sighup bash\n"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "B<Example\\ \\&5.\\ \\&Start screen as a user service>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid ""
"$ systemd-run --scope --user screen\n"
"Running scope as unit run-r14b0047ab6df45bfb45e7786cc839e76\\&.scope\\&.\n"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid ""
"$ screen -ls\n"
"There is a screen on:\n"
"        492\\&.\\&.laptop     (Detached)\n"
"1 Socket in /var/run/screen/S-fatima\\&.\n"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"This starts the B<screen> process as a child of the B<systemd --user> "
"process that was started by user@\\&.service, in a scope unit\\&. A "
"B<systemd.scope>(5)  unit is used instead of a B<systemd.service>(5)  unit, "
"because B<screen> will exit when detaching from the terminal, and a service "
"unit would be terminated\\&. Running B<screen> as a user unit has the "
"advantage that it is not part of the session scope\\&. If "
"I<KillUserProcesses=yes> is configured in B<logind.conf>(5), the default, "
"the session scope will be terminated when the user logs out of that "
"session\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The user@\\&.service is started automatically when the user first logs in, "
"and stays around as long as at least one login session is open\\&. After the "
"user logs out of the last session, user@\\&.service and all services "
"underneath it are terminated\\&. This behavior is the default, when "
"\"lingering\" is not enabled for that user\\&. Enabling lingering means that "
"user@\\&.service is started automatically during boot, even if the user is "
"not logged in, and that the service is not terminated when the user logs "
"out\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Enabling lingering allows the user to run processes without being logged in, "
"for example to allow B<screen> to persist after the user logs out, even if "
"the session scope is terminated\\&. In the default configuration, users can "
"enable lingering for themselves:"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "$ loginctl enable-linger\n"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "B<Example\\ \\&6.\\ \\&Variable expansion by the manager>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid ""
"$ systemd-run -t echo \"E<lt>${INVOCATION_ID}E<gt>\" \\*(AqE<lt>${INVOCATION_ID}E<gt>\\*(Aq\n"
"      E<lt>E<gt> E<lt>5d0149bfa2c34b79bccb13074001eb20E<gt>\n"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
msgid ""
"The first argument is expanded by the shell (double quotes), but the second "
"one is not expanded by the shell (single quotes)\\&.  B<echo>(1)  is called "
"with [\"/usr/bin/echo\", \"E<lt>E<gt>\", \"E<lt>${INVOCATION_ID}E<gt>\"] as "
"the argument array, and then B<systemd>(1)  generates I<${INVOCATION_ID}> "
"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\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"B<Example\\ \\&7.\\ \\&Variable expansion and output redirection using a "
"shell>"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
msgid ""
"Variable expansion by B<systemd>(1)  can be disabled with I<--expand-"
"environment=no>\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Disabling variable expansion can be useful if the command to execute "
"contains dollar characters and escaping them would be inconvenient\\&. For "
"example, when a shell is used:"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid ""
"$ systemd-run --expand-environment=no -t bash \\e\n"
"      -c \\*(Aqecho $SHELL $$ E<gt>/dev/stdout\\*(Aq\n"
"/bin/bash 12345\n"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
msgid ""
"The last argument is passed verbatim to the B<bash>(1)  shell which is "
"started by the service unit\\&. The shell expands \"$SHELL\" to the path of "
"the shell, and \"$$\" to its process number, and then those strings are "
"passed to the B<echo> built-in and printed to standard output (which in this "
"case is connected to the calling terminal)\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "B<Example\\ \\&8.\\ \\&Return value>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid ""
"$ systemd-run --user --wait true\n"
"$ systemd-run --user --wait -p SuccessExitStatus=11 bash -c \\*(Aqexit 11\\*(Aq\n"
"$ systemd-run --user --wait -p SuccessExitStatus=SIGUSR1 --expand-environment=no \\e\n"
"      bash -c \\*(Aqkill -SIGUSR1 $$\\*(Aq\n"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Those three invocations will succeed, i\\&.e\\&. terminate with an exit code "
"of 0\\&."
msgstr ""

#. type: SH
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "SEE ALSO"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"B<systemd>(1), B<systemctl>(1), B<systemd.unit>(5), B<systemd.service>(5), "
"B<systemd.scope>(5), B<systemd.slice>(5), B<systemd.exec>(5), B<systemd."
"resource-control>(5), B<systemd.timer>(5), B<systemd-mount>(1), "
"B<machinectl>(1)"
msgstr ""

#. type: TH
#: debian-bookworm opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "systemd 254"
msgstr ""

#. type: Plain text
#: debian-bookworm opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The first argument is expanded by the shell (double quotes), but the second "
"one is not expanded by the shell (single quotes)\\&.  B<echo> is called with "
"[\"/usr/bin/echo\", \"[]\", \"[${INVOCATION_ID}]\"] as the argument array, "
"and then B<systemd> generates I<${INVOCATION_ID}> 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\\&."
msgstr ""

#. type: Plain text
#: debian-bookworm opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Variable expansion by B<systemd> can be disabled with I<--expand-"
"environment=no>\\&."
msgstr ""

#. type: Plain text
#: debian-bookworm opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The last argument is passed verbatim to the B<bash> shell which is started "
"by the service unit\\&. The shell expands \"$SHELL\" to the path of the "
"shell, and \"$$\" to its process number, and then those strings are passed "
"to the B<echo> built-in and printed to standard output (which in this case "
"is connected to the calling terminal)\\&."
msgstr ""