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