man-pages/man8/systemd-debug-generator.8.html
2021-03-31 01:06:50 +01:00

121 lines
3.1 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of SYSTEMD-DEBUG-GENERATOR</TITLE>
</HEAD><BODY>
<H1>SYSTEMD-DEBUG-GENERATOR</H1>
Section: systemd-debug-generator (8)<BR>Updated: <BR><A HREF="#index">Index</A>
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>
systemd-debug-generator - Generator for enabling a runtime debug shell and masking specific units at boot
<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>
<P>
/lib/systemd/system-generators/systemd-debug-generator
<A NAME="lbAD">&nbsp;</A>
<H2>DESCRIPTION</H2>
<P>
systemd-debug-generator
is a generator that reads the kernel command line and understands three options:
<P>
If the
<B>systemd.mask=</B>
or
<B>rd.systemd.mask=</B>
option is specified and followed by a unit name, this unit is masked for the runtime, similar to the effect of
<B><A HREF="/cgi-bin/man/man2html?1+systemctl">systemctl</A></B>(1)'s
<B>mask</B>
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.
<B>rd.systemd.mask=</B>
is honored only by initial RAM disk (initrd) while
<B>systemd.mask=</B>
is honored only in the main system.
<P>
If the
<B>systemd.wants=</B>
or
<B>rd.systemd.wants=</B>
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.
<B>rd.systemd.wants=</B>
is honored only by initial RAM disk (initrd) while
<B>systemd.wants=</B>
is honored only in the main system.
<P>
If the
<B>systemd.debug_shell</B>
or
<B>rd.systemd.debug_shell</B>
option is specified, the debug shell service
&quot;debug-shell.service&quot;
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
<B><A HREF="/cgi-bin/man/man2html?1+systemctl">systemctl</A></B>(1)'s
<B>enable</B>
command.
<B>rd.systemd.debug_shell=</B>
is honored only by initial RAM disk (initrd) while
<B>systemd.debug_shell</B>
is honored only in the main system.
<P>
systemd-debug-generator
implements
<B><A HREF="/cgi-bin/man/man2html?7+systemd.generator">systemd.generator</A></B>(7).
<A NAME="lbAE">&nbsp;</A>
<H2>SEE ALSO</H2>
<P>
<B><A HREF="/cgi-bin/man/man2html?1+systemd">systemd</A></B>(1),
<B><A HREF="/cgi-bin/man/man2html?1+systemctl">systemctl</A></B>(1),
<B><A HREF="/cgi-bin/man/man2html?7+kernel-command-line">kernel-command-line</A></B>(7)
<P>
<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT id="1"><A HREF="#lbAB">NAME</A><DD>
<DT id="2"><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT id="3"><A HREF="#lbAD">DESCRIPTION</A><DD>
<DT id="4"><A HREF="#lbAE">SEE ALSO</A><DD>
</DL>
<HR>
This document was created by
<A HREF="/cgi-bin/man/man2html">man2html</A>,
using the manual pages.<BR>
Time: 00:06:16 GMT, March 31, 2021
</BODY>
</HTML>