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