|
HTML rendering created 2025-09-06 by Michael Kerrisk, author of The Linux Programming Interface. For details of in-depth Linux/UNIX system programming training courses that I teach, look here. Hosting by jambit GmbH. |
|
|
NAME | SYNOPSIS | DESCRIPTION | EXAMPLE | SEE ALSO | COLOPHON |
|
|
|
SYSTEMD-RUN-GENERATOR(8) systemd-run-generator SYSTEMD-RUN-GENERATOR(8)
systemd-run-generator - Generator for invoking commands specified
on the kernel command line as system service
/usr/lib/systemd/system-generators/systemd-run-generator
systemd-run-generator is a generator that reads the kernel command
line and understands three options:
If the systemd.run= option is specified and followed by a command
line, a unit named kernel-command-line.service is generated for it
and booted into. The service has Type=oneshot set, and has
SuccessAction=exit and FailureAction=exit configured by default,
thus ensuring that the system is shut down as soon as the command
completes. The exit status of the command line is propagated to
the invoking container manager, if this applies (which might
propagate this further, to the calling shell — e.g.
systemd-nspawn(1) does this). If this option is used multiple
times the unit file will contain multiple ExecStart= lines, to
execute all commands in order. The command is started as regular
service, i.e. with DefaultDependencies= on.
Use systemd.run_success_action= and systemd.run_failure_action= to
tweak how to react to the process completing. In particular
assigning "none" will leave the system running after the command
completes. For further details on supported arguments, see
systemd.unit(5).
systemd-run-generator implements systemd.generator(7).
Use a command like the following to add a user to the user
database inside a container run with systemd-nspawn(1):
# systemd-nspawn -D mycontainer -b systemd.run='"adduser test"'
(Note the requirement for double quoting in the command line
above. The first level of quoting ('') is processed and removed by
the command shell used to invoke systemd-nspawn. The second level
of quoting ("") is propagated to the kernel command line of the
container and processed and removed by systemd-run-generator. Both
together make sure both words of the specified command line
adduser test end up in the generated unit file together and are
neither split apart by the command shell nor by the generator.)
systemd(1), systemctl(1), kernel-command-line(7),
systemd-nspawn(1), systemd.unit(5), systemd.service(5)
This page is part of the systemd (systemd system and service
manager) project. Information about the project can be found at
⟨http://www.freedesktop.org/wiki/Software/systemd⟩. If you have a
bug report for this manual page, see
⟨http://www.freedesktop.org/wiki/Software/systemd/#bugreports⟩.
This page was obtained from the project's upstream Git repository
⟨https://github.com/systemd/systemd.git⟩ on 2025-08-11. (At that
time, the date of the most recent commit that was found in the
repository was 2025-08-11.) If you discover any rendering
problems in this HTML version of the page, or you believe there is
a better or more up-to-date source for the page, or you have
corrections or improvements to the information in this COLOPHON
(which is not part of the original manual page), send a mail to
man-pages@man7.org
systemd 258~rc2 SYSTEMD-RUN-GENERATOR(8)
Pages that refer to this page: kernel-command-line(7), systemd.directives(7), systemd.index(7)
|
HTML rendering created 2025-09-06 by Michael Kerrisk, author of The Linux Programming Interface. For details of in-depth Linux/UNIX system programming training courses that I teach, look here. Hosting by jambit GmbH. |
|