systemd-getty-generator.xml revision 12b42c76672a66c2d4ea7212c14f8f1b5a62b78d
0N/A<?xml version="1.0"?>
0N/A<!--*-nxml-*-->
0N/A<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
0N/A<!--
0N/A This file is part of systemd.
0N/A
0N/A Copyright 2012 Lennart Poettering
0N/A
0N/A systemd is free software; you can redistribute it and/or modify it
0N/A under the terms of the GNU Lesser General Public License as published by
0N/A the Free Software Foundation; either version 2.1 of the License, or
0N/A (at your option) any later version.
0N/A
0N/A systemd is distributed in the hope that it will be useful, but
0N/A WITHOUT ANY WARRANTY; without even the implied warranty of
0N/A MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
0N/A Lesser General Public License for more details.
0N/A
0N/A You should have received a copy of the GNU Lesser General Public License
0N/A along with systemd; If not, see <http://www.gnu.org/licenses/>.
0N/A-->
0N/A<refentry id="systemd-getty-generator">
0N/A
0N/A <refentryinfo>
0N/A <title>systemd-getty-generator</title>
0N/A <productname>systemd</productname>
0N/A
0N/A <authorgroup>
0N/A <author>
0N/A <contrib>Developer</contrib>
0N/A <firstname>Lennart</firstname>
0N/A <surname>Poettering</surname>
0N/A <email>lennart@poettering.net</email>
0N/A </author>
0N/A </authorgroup>
0N/A </refentryinfo>
0N/A
0N/A <refmeta>
0N/A <refentrytitle>systemd-getty-generator</refentrytitle>
0N/A <manvolnum>8</manvolnum>
0N/A </refmeta>
0N/A
0N/A <refnamediv>
0N/A <refname>systemd-getty-generator</refname>
0N/A <refpurpose>Generator for enabling getty instances on the
0N/A console</refpurpose>
0N/A </refnamediv>
0N/A
0N/A <refsynopsisdiv>
0N/A <para><filename>/usr/lib/systemd/system-generators/systemd-getty-generator</filename></para>
0N/A </refsynopsisdiv>
0N/A
0N/A <refsect1>
0N/A <title>Description</title>
0N/A
0N/A <para><filename>systemd-getty-generator</filename> is a generator
0N/A that automatically instantiates
0N/A <filename>serial-getty@.service</filename> on the kernel console
0N/A <filename>/dev/console</filename> if that is not directed to the
0N/A virtual console subsystem. It will also instantiate
0N/A <filename>serial-getty@.service</filename> instances for
0N/A virtualizer consoles, if execution in a virtualized environment is
0N/A detected. Finally, it will instantiate
0N/A <filename>container-getty@.service</filename> instances for
0N/A additional container pseudo TTYs as requested by the container
0N/A manager (see <ulink
0N/A url="http://www.freedesktop.org/wiki/Software/systemd/ContainerInterface/"><filename>Container
0N/A Interface</filename></ulink>). This should ensure that the user is
0N/A shown a login prompt at the right place, regardless of which
0N/A environment the system is started in. For example, it is
0N/A sufficient to redirect the kernel console with a kernel command
0N/A line argument such as <varname>console=</varname> to get both
0N/A kernel messages and a getty prompt on a serial TTY. See <ulink
0N/A url="https://www.kernel.org/doc/Documentation/kernel-parameters.txt"><filename>kernel-parameters.txt</filename></ulink>
0N/A for more information on the <varname>console=</varname> kernel
0N/A parameter.</para>
0N/A
0N/A <para><filename>systemd-getty-generator</filename> implements
0N/A <citerefentry><refentrytitle>systemd.generator</refentrytitle><manvolnum>7</manvolnum></citerefentry>.</para>
0N/A
0N/A <para>Further information about configuration of gettys you may
0N/A find in
0N/A <ulink url="http://0pointer.de/blog/projects/serial-console.html">systemd
0N/A for Administrators, Part XVI: Gettys on Serial Consoles (and
0N/A Elsewhere)</ulink>.</para>
0N/A </refsect1>
0N/A
0N/A <refsect1>
0N/A <title>See Also</title>
0N/A <para>
0N/A <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
0N/A <citerefentry project='man-pages'><refentrytitle>agetty</refentrytitle><manvolnum>8</manvolnum></citerefentry>
0N/A </para>
0N/A </refsect1>
0N/A
0N/A</refentry>
0N/A