|
HTML rendering created 2024-06-26 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 | SYSTEM CREDENTIALS | SEE ALSO | COLOPHON |
|
|
|
SYSTEMD-...GENERATOR(8) systemd-debug-generator SYSTEMD-...GENERATOR(8)
systemd-debug-generator - Generator for enabling a runtime debug
shell and masking specific units at boot
/usr/lib/systemd/system-generators/systemd-debug-generator
systemd-debug-generator is a generator that reads the kernel
command line and understands three options:
If the systemd.mask= or rd.systemd.mask= option is specified and
followed by a unit name, this unit is masked for the runtime
(i.e. for this session — from boot to shutdown), similarly to the
effect of systemctl(1)'s mask command. This is useful to boot
with certain units removed from the initial boot transaction for
debugging system startup. May be specified more than once.
rd.systemd.mask= is honored only by initial RAM disk (initrd)
while systemd.mask= is honored only in the main system.
If the systemd.wants= or rd.systemd.wants= option is specified
and followed by a unit name, a start job for this unit is added
to the initial transaction. This is useful to start one or more
additional units at boot. May be specified more than once.
rd.systemd.wants= is honored only by initial RAM disk (initrd)
while systemd.wants= is honored only in the main system.
If the systemd.debug_shell or rd.systemd.debug_shell option is
specified, the debug shell service "debug-shell.service" is
pulled into the boot transaction and a debug shell will be
spawned during early boot. By default, /dev/tty9 is used, but a
specific tty can also be specified, either with or without the
/dev/ prefix. To set the tty to use without enabling the debug
shell, the systemd.default_debug_tty= option can be used which
also takes a tty with or without the /dev/ prefix. Note that the
shell may also be turned on persistently by enabling it with
systemctl(1)'s enable command. rd.systemd.debug_shell is honored
only by initial RAM disk (initrd) while systemd.debug_shell is
honored only in the main system.
systemd-debug-generator implements systemd.generator(7).
systemd.extra-unit.*
Credentials prefixed with "systemd.extra-unit." specify
additional units to add to the final system. Note that these
additional units are added to both the initrd and the final
system. ConditionPathExists=!/etc/initrd-release can be used
to make sure the unit is conditioned out in the initrd. Note
that this can also be used to mask units, by simply
specifying an empty value.
Added in version 256.
systemd.unit-dropin.*
Credentials prefixed with "systemd.unit-dropin." add
drop-ins for the corresponding units in the final system.
Each credential must be suffixed with the full unit name
including the unit extension. Its contents must be a valid
unit drop-in file. Optionally, the unit name may be followed
with "~", followed by the drop-in name without the ".conf"
suffix. If not specified, the name of the generated drop-in
will be "50-credential.conf". Note that these additional
drop-ins are added to both the initrd and the final system.
Added in version 256.
systemd(1), systemctl(1), kernel-command-line(7)
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 2024-06-14. (At that
time, the date of the most recent commit that was found in the
repository was 2024-06-13.) 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
[email protected]
systemd 257~devel SYSTEMD-...GENERATOR(8)
Pages that refer to this page: kernel-command-line(7), systemd.directives(7), systemd.generator(7), systemd.index(7), systemd.system-credentials(7)
|
HTML rendering created 2024-06-26 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. |
|