systemd-run-generator(8) — Linux manual page

NAME | SYNOPSIS | DESCRIPTION | EXAMPLE | SEE ALSO | COLOPHON

SYSTEMD-RUN-GENERATOR(8)    systemd-run-generator   SYSTEMD-RUN-GENERATOR(8)

NAME         top

       systemd-run-generator - Generator for invoking commands specified on
       the kernel command line as system service

SYNOPSIS         top

       /usr/lib/systemd/system-generators/systemd-run-generator

DESCRIPTION         top

       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(7) 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).

EXAMPLE         top

       Use a command like the following to add a user to the user database
       inside a container run with systemd-nspawn(7):

           # 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.)

SEE ALSO         top

       systemd(1), systemctl(1), kernel-command-line(7), systemd-nspawn(7),
       systemd.unit(5), systemd.service(5)

COLOPHON         top

       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 2020-06-09.  (At that
       time, the date of the most recent commit that was found in the repos‐
       itory was 2020-06-09.)  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 245                                         SYSTEMD-RUN-GENERATOR(8)

Pages that refer to this page: 30-systemd-environment-d-generator(7)kernel-command-line(7)systemd.directives(7)systemd.index(7)