man7.org > Linux > man-pages

Linux/UNIX system programming training

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

NAME | SYNOPSIS | DESCRIPTION | SEE ALSO | COLOPHON 

SYSTEMD-DEBUG-GENERATOR(8)ystemd-debug-generatorSTEMD-DEBUG-GENERATOR(8)

NAME         top

       systemd-debug-generator - Generator for enabling a runtime debug
       shell and masking specific units at boot

SYNOPSIS         top

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

DESCRIPTION         top

       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 set, either 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).

SEE ALSO         top

       systemd(1), systemctl(1), kernel-command-line(7)

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 2023-06-23.  (At that
       time, the date of the most recent commit that was found in the
       repository was 2023-06-23.)  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 253                                   SYSTEMD-DEBUG-GENERATOR(8)

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

HTML rendering created 2023-06-24 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.

Cover of TLPI