aboutsummaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorMattias Andrée <maandree@member.fsf.org>2015-12-19 01:23:49 +0100
committerMattias Andrée <maandree@member.fsf.org>2015-12-19 01:23:49 +0100
commitcfdbf7143ce83290b00aef9f2d001def55bdbbd7 (patch)
tree089215b53b02ed4eaac1f30ee861566ed679a58f /doc
parentm (diff)
downloadsleeping-getty-cfdbf7143ce83290b00aef9f2d001def55bdbbd7.tar.gz
sleeping-getty-cfdbf7143ce83290b00aef9f2d001def55bdbbd7.tar.bz2
sleeping-getty-cfdbf7143ce83290b00aef9f2d001def55bdbbd7.tar.xz
add man page
Signed-off-by: Mattias Andrée <maandree@member.fsf.org>
Diffstat (limited to 'doc')
-rw-r--r--doc/man/sleeping-getty.859
1 files changed, 59 insertions, 0 deletions
diff --git a/doc/man/sleeping-getty.8 b/doc/man/sleeping-getty.8
new file mode 100644
index 0000000..d344903
--- /dev/null
+++ b/doc/man/sleeping-getty.8
@@ -0,0 +1,59 @@
+.TH SLEEPING-GETTY 8 SLEEPING-GETTY
+.SH NAME
+sleeping\-getty \- Do not start a fullblow getty before it is necessary
+.SH SYNOPSIS
+.B sleeping\-getty
+.I VTNO
+.IR GETTY_COMMAND ...
+.SH DESCRIPTION
+.B sleeping\-getty
+shall wait until
+.I VTNO
+(a number of a virtual terminal) becomes the foreground console.
+Then, it shall
+.BR execv (3)
+to
+.IR GETTY_COMMAND ,
+with
+.I GETTY_COMMAND
+and all following arguments as the command line arguments.
+.PP
+Note that
+.B sleeping-getty
+works on VT:s, not TTY:s. It cannot wait for a serial console to
+become, active, only virtual terminals.
+.SH EXAMPLE
+.nf
+/sbin/\fBsleeping-getty\fP \fI15\fP /sbin/got tty\fI15\fP TERM=linux
+/sbin/\fBsleeping-getty\fP \fI16\fP /sbin/got tty\fI16\fP TERM=linux
+/sbin/\fBsleeping-getty\fP \fI20\fP /sbin/agetty -8 -s 38400 tty\fI20\fP linux
+.fi
+.SH RATIONALE
+It is nice to have a score or two of TTY:s available. However,
+starting them, can require some unnecessary CPU time and will
+was memory until they are actually used. This becomes extra
+important on resource contained machines.
+.SH "SEE ALSO"
+.BR getty (8),
+.BR mingetty (8),
+.BR agetty (8),
+.BR got (8),
+.BR vtchs (1),
+.BR inittab (5)
+.SH LICENSE
+Copyright \(co 2015 Mattias Andrée
+.br
+License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
+.br
+This is free software: you are free to change and redistribute it.
+.br
+There is NO WARRANTY, to the extent permitted by law.
+.SH
+.PP
+Copying and distribution of this manual, with or without modification,
+are permitted in any medium without royalty provided the copyright
+notice and this notice are preserved. This file is offered as-is,
+without any warranty.
+.SH BUGS
+Please report bugs to <https://github.com/maandree/sleeping-getty/issues>
+or to <maandree@member.fsf.org>.