man/systemd-debug-generator.8

   1 '\" t
   2 .TH "SYSTEMD\-DEBUG\-GENERATOR" "8" "" "systemd 219" "systemd-debug-generator"
   3 .\" -----------------------------------------------------------------
   4 .\" * Define some portability stuff
   5 .\" -----------------------------------------------------------------
   6 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
   7 .\" http://bugs.debian.org/507673
   8 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
   9 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  10 .ie \n(.g .ds Aq \(aq
  11 .el       .ds Aq '
  12 .\" -----------------------------------------------------------------
  13 .\" * set default formatting
  14 .\" -----------------------------------------------------------------
  15 .\" disable hyphenation
  16 .nh
  17 .\" disable justification (adjust text to left margin only)
  18 .ad l
  19 .\" -----------------------------------------------------------------
  20 .\" * MAIN CONTENT STARTS HERE *
  21 .\" -----------------------------------------------------------------
  22 .SH "NAME"
  23 systemd-debug-generator \- Generator for enabling a runtime debug shell and masking specific units at boot
  24 .SH "SYNOPSIS"
  25 .PP
  26 /usr/lib/systemd/system\-generators/systemd\-debug\-generator
  27 .SH "DESCRIPTION"
  28 .PP
  29 systemd\-debug\-generator
  30 is a generator that reads the kernel command line and understands three options:
  31 .PP
  32 If the
  33 \fBsystemd\&.mask=\fR
  34 option is specified and followed by a unit name, this unit is masked for the runtime, similar to the effect of
  35 \fBsystemctl\fR(1)\*(Aqs
  36 \fBmask\fR
  37 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\&.
  38 .PP
  39 If the
  40 \fBsystemd\&.wants=\fR
  41 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\&.
  42 .PP
  43 If the
  44 \fBsystemd\&.debug\-shell\fR
  45 option is specified, the debug shell service
  46 "debug\-shell\&.service"
  47 is pulled into the boot transaction\&. It will spawn a debug shell on tty9 during early system startup\&. Note that the shell may also be turned on persistently by enabling it with
  48 \fBsystemctl\fR(1)\*(Aqs
  49 \fBenable\fR
  50 command\&.
  51 .PP
  52 systemd\-debug\-generator
  53 implements the
  54 \m[blue]\fBgenerator specification\fR\m[]\&\s-2\u[1]\d\s+2\&.
  55 .SH "SEE ALSO"
  56 .PP
  57 \fBsystemd\fR(1),
  58 \fBsystemctl\fR(1),
  59 \fBkernel-command-line\fR(7)
  60 .SH "NOTES"
  61 .IP " 1." 4
  62 generator specification
  63 .RS 4
  64 \%http://www.freedesktop.org/wiki/Software/systemd/Generators
  65 .RE