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