chiark / gitweb /
bus: make sd_bus_request_name() and sd_bus_release_name() behave more like other...
[elogind.git] / 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>