mingetty.8

   1 .TH MINGETTY 8 "6 Apr 1996" "Debian-Local" "Linux Programmer's Manual"
   2 .SH NAME
   3 mingetty \- minimal getty for consoles
   4 .SH SYNOPSIS
   5 .B mingetty
   6 [\-\-noclear] [\-\-nonewline] [\-\-noissue] [\-\-nohangup] [\-\-nohostname]
   7 [\-\-long\-hostname] [\-\-loginprog=/bin/login] [\-\-nice=10] [\-\-delay=5]
   8 [\-\-chdir=/home] [\-\-chroot=/chroot] [\-\-autologin username]
   9 [\-\-loginpause]
  10 .I tty
  11 .PP
  12 .SH DESCRIPTION
  13 .B mingetty
  14 is a minimal getty for use on virtual consoles.
  15 Unlike
  16 .BR agetty (8),
  17 .B mingetty
  18 is not suitable for serial lines.
  19 I recommend using
  20 .BR mgetty (8)
  21 for this purpose.
  22 .PP
  23 .SH OPTIONS
  24 .TP
  25 .B \-\-noclear
  26 Do not clear the screen before prompting for the login name (the screen
  27 is normally cleared).
  28 .TP
  29 .B \-\-nonewline
  30 Do not print a newline before writing out /etc/issue.
  31 .TP
  32 .B \-\-noissue
  33 Do not output /etc/issue.
  34 .TP
  35 .B \-\-nohangup
  36 Do not call vhangup() to disable writing to this tty by
  37 other applications.
  38 .TP
  39 .B \-\-nohostname
  40 Do not print the hostname before the login prompt.
  41 .TP
  42 .B \-\-long\-hostname
  43 By default the hostname is only printed until the first dot.
  44 With this option enabled, the full text from gethostname() is shown.
  45 .TP
  46 .B \-\-loginprog /bin/login
  47 Change the login app.
  48 .TP
  49 .B \-\-nice 10
  50 Change the priority by calling nice().
  51 .TP
  52 .B \-\-delay 5
  53 Sleep this many seconds after startup of mingetty.
  54 .TP
  55 .B \-\-chdir /home
  56 Change into this directory before calling the login prog.
  57 .TP
  58 .B \-\-chroot /chroot
  59 Call chroot() with this directory name.
  60 .TP
  61 .B \-\-autologin username
  62 Log the specified user automatically in without asking for
  63 a login name and password. Check the \-f option from
  64 .B /bin/login
  65 for this.
  66 .TP
  67 .B \-\-loginpause
  68 Wait for any key before dropping to the login prompt.
  69 Can be combined with \fB\-\-autologin\fR to save memory by lazily spawning
  70 shells.
  71 .PP
  72 .SH "ISSUE ESCAPES"
  73 .B mingetty
  74 recognizes the following escapes sequences which might be embedded in the
  75 .I /etc/issue
  76 file:
  77 .IP \fB\ed\fP
  78 insert current day (localtime),
  79 .IP \fB\el\fP
  80 insert line on which
  81 .B mingetty
  82 is running,
  83 .IP \fB\em\fP
  84 inserts machine architecture (uname -m),
  85 .IP \fB\en\fP
  86 inserts machine's network node hostname (uname -n),
  87 .IP \fB\eo\fP
  88 inserts domain name,
  89 .IP \fB\er\fP
  90 inserts operating system release (uname -r),
  91 .IP \fB\et\fP
  92 insert current time (localtime),
  93 .IP \fB\es\fP
  94 inserts operating system name,
  95 .IP \fB\eu\fP
  96 resp. \fB\eU\fP
  97 the current number of users which are currently logged in.
  98 \\U inserts "\fIn\fP users", where as \\u only inserts "\fIn\fP".
  99 .IP \fB\ev\fP
 100 inserts operating system version (uname -v).
 101 .PP
 102 .SH EXAMPLE
 103 "\fBLinux\ eos\ i386\ #1\ Tue\ Mar\ 19\ 21:54:09\ MET\ 1996\fP" was produced
 104 by putting "\fB\\s\ \\n\ \\m\ \\v\fP" into
 105 .IR /etc/issue .
 106 .PP
 107 .SH FILES
 108 .IR /etc/issue ,
 109 .IR /var/run/utmp .
 110 .PP
 111 .SH "SEE ALSO"
 112 .BR mgetty (8),
 113 .BR agetty (8).
 114 .PP
 115 .SH AUTHOR
 116 Copyright \(co 1996 Florian La Roche <laroche@redhat.com>.
 117 Man-page written by David Frey <David.Frey@eos.lugs.ch> and
 118 Florian La Roche.