mirror of
https://github.com/systemd/systemd
synced 2024-07-21 10:17:21 +00:00
![Lennart Poettering](/assets/img/avatar_default.png)
This part of the copyright blurb stems from the GPL use recommendations: https://www.gnu.org/licenses/gpl-howto.en.html The concept appears to originate in times where version control was per file, instead of per tree, and was a way to glue the files together. Ultimately, we nowadays don't live in that world anymore, and this information is entirely useless anyway, as people are very welcome to copy these files into any projects they like, and they shouldn't have to change bits that are part of our copyright header for that. hence, let's just get rid of this old cruft, and shorten our codebase a bit.
86 lines
3.3 KiB
XML
86 lines
3.3 KiB
XML
<?xml version="1.0"?>
|
|
<!--*-nxml-*-->
|
|
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
|
|
<!--
|
|
SPDX-License-Identifier: LGPL-2.1+
|
|
|
|
Copyright 2012 Lennart Poettering
|
|
-->
|
|
<refentry id="systemd-getty-generator">
|
|
|
|
<refentryinfo>
|
|
<title>systemd-getty-generator</title>
|
|
<productname>systemd</productname>
|
|
|
|
<authorgroup>
|
|
<author>
|
|
<contrib>Developer</contrib>
|
|
<firstname>Lennart</firstname>
|
|
<surname>Poettering</surname>
|
|
<email>lennart@poettering.net</email>
|
|
</author>
|
|
</authorgroup>
|
|
</refentryinfo>
|
|
|
|
<refmeta>
|
|
<refentrytitle>systemd-getty-generator</refentrytitle>
|
|
<manvolnum>8</manvolnum>
|
|
</refmeta>
|
|
|
|
<refnamediv>
|
|
<refname>systemd-getty-generator</refname>
|
|
<refpurpose>Generator for enabling getty instances on the
|
|
console</refpurpose>
|
|
</refnamediv>
|
|
|
|
<refsynopsisdiv>
|
|
<para><filename>/usr/lib/systemd/system-generators/systemd-getty-generator</filename></para>
|
|
</refsynopsisdiv>
|
|
|
|
<refsect1>
|
|
<title>Description</title>
|
|
|
|
<para><filename>systemd-getty-generator</filename> is a generator
|
|
that automatically instantiates
|
|
<filename>serial-getty@.service</filename> on the kernel
|
|
console(s), if they can function as ttys and are not provided by
|
|
the virtual console subsystem. It will also instantiate
|
|
<filename>serial-getty@.service</filename> instances for
|
|
virtualizer consoles, if execution in a virtualized environment is
|
|
detected. If execution in a container environment is detected, it
|
|
will instead enable <filename>console-getty.service</filename> for
|
|
<filename>/dev/console</filename>, and
|
|
<filename>container-getty@.service</filename> instances for
|
|
additional container pseudo TTYs as requested by the container
|
|
manager (see <ulink
|
|
url="https://www.freedesktop.org/wiki/Software/systemd/ContainerInterface/"><filename>Container
|
|
Interface</filename></ulink>). This should ensure that the user is
|
|
shown a login prompt at the right place, regardless of which
|
|
environment the system is started in. For example, it is
|
|
sufficient to redirect the kernel console with a kernel command
|
|
line argument such as <varname>console=</varname> to get both
|
|
kernel messages and a getty prompt on a serial TTY. See <ulink
|
|
url="https://www.kernel.org/doc/Documentation/admin-guide/kernel-parameters.txt"><filename>kernel-parameters.txt</filename></ulink>
|
|
for more information on the <varname>console=</varname> kernel
|
|
parameter.</para>
|
|
|
|
<para><filename>systemd-getty-generator</filename> implements
|
|
<citerefentry><refentrytitle>systemd.generator</refentrytitle><manvolnum>7</manvolnum></citerefentry>.</para>
|
|
|
|
<para>Further information about configuration of gettys can be
|
|
found in
|
|
<ulink url="http://0pointer.de/blog/projects/serial-console.html">systemd
|
|
for Administrators, Part XVI: Gettys on Serial Consoles (and
|
|
Elsewhere)</ulink>.</para>
|
|
</refsect1>
|
|
|
|
<refsect1>
|
|
<title>See Also</title>
|
|
<para>
|
|
<citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
|
|
<citerefentry project='man-pages'><refentrytitle>agetty</refentrytitle><manvolnum>8</manvolnum></citerefentry>
|
|
</para>
|
|
</refsect1>
|
|
|
|
</refentry>
|