man/systemd-getty-generator.xml

   1 <?xml version="1.0"?>
   2 <!--*-nxml-*-->
   3 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
   4 <!--
   5   This file is part of systemd.
   6
   7   Copyright 2012 Lennart Poettering
   8
   9   systemd is free software; you can redistribute it and/or modify it
  10   under the terms of the GNU Lesser General Public License as published by
  11   the Free Software Foundation; either version 2.1 of the License, or
  12   (at your option) any later version.
  13
  14   systemd is distributed in the hope that it will be useful, but
  15   WITHOUT ANY WARRANTY; without even the implied warranty of
  16   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  17   Lesser General Public License for more details.
  18
  19   You should have received a copy of the GNU Lesser General Public License
  20   along with systemd; If not, see <http://www.gnu.org/licenses/>.
  21 -->
  22 <refentry id="systemd-getty-generator">
  23
  24         <refentryinfo>
  25                 <title>systemd-getty-generator</title>
  26                 <productname>systemd</productname>
  27
  28                 <authorgroup>
  29                         <author>
  30                                 <contrib>Developer</contrib>
  31                                 <firstname>Lennart</firstname>
  32                                 <surname>Poettering</surname>
  33                                 <email>lennart@poettering.net</email>
  34                         </author>
  35                 </authorgroup>
  36         </refentryinfo>
  37
  38         <refmeta>
  39                 <refentrytitle>systemd-getty-generator</refentrytitle>
  40                 <manvolnum>8</manvolnum>
  41         </refmeta>
  42
  43         <refnamediv>
  44                 <refname>systemd-getty-generator</refname>
  45                 <refpurpose>Generator for enabling getty instances on
  46                 the console</refpurpose>
  47         </refnamediv>
  48
  49         <refsynopsisdiv>
  50                 <para><filename>/usr/lib/systemd/system-generators/systemd-getty-generator</filename></para>
  51         </refsynopsisdiv>
  52
  53         <refsect1>
  54                 <title>Description</title>
  55
  56                 <para><filename>systemd-getty-generator</filename> is
  57                 a generator that automatically instantiates
  58                 <filename>serial-getty@.service</filename> on the
  59                 kernel console <filename>/dev/console</filename> if
  60                 that is not directed to the virtual console
  61                 subsystem. It will also instantiate
  62                 <filename>serial-getty@.service</filename> instances
  63                 for virtualizer consoles, if execution in a
  64                 virtualized environment is detected. This should
  65                 ensure that the user is shown a login prompt at the
  66                 right place, regardless in which environment the
  67                 system is started. For example, it is sufficient to
  68                 redirect the kernel console with a kernel command line
  69                 argument such as <varname>console=</varname> to get
  70                 both kernel messages and a getty prompt on a serial
  71                 TTY. See <ulink
  72                 url="https://www.kernel.org/doc/Documentation/kernel-parameters.txt"><filename>kernel-parameters.txt</filename></ulink>
  73                 for more information on the
  74                 <varname>console=</varname> kernel parameter.</para>
  75
  76                 <para><filename>systemd-getty-generator</filename>
  77                 implements the <ulink
  78                 url="http://www.freedesktop.org/wiki/Software/systemd/Generators">generator
  79                 specification</ulink>.</para>
  80
  81                 <para>Further information about configuration of
  82                 gettys you may find in <ulink
  83                 url="http://0pointer.de/blog/projects/serial-console.html">systemd
  84                 for Administrators, Part XVI: Gettys on Serial
  85                 Consoles (and Elsewhere)</ulink>.</para>
  86         </refsect1>
  87
  88         <refsect1>
  89                 <title>See Also</title>
  90                 <para>
  91                         <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
  92                         <citerefentry><refentrytitle>agetty</refentrytitle><manvolnum>8</manvolnum></citerefentry>
  93                 </para>
  94         </refsect1>
  95
  96 </refentry>