usr/src/man/man1m/getty.1m

   1 '\" te
   2 .\"  Copyright 1989 AT&T  Copyright (c) 1997 Sun Microsystems, Inc.  All Rights Reserved.
   3 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
   4 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
   5 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
   6 .TH GETTY 1M "Sep 14, 1992"
   7 .SH NAME
   8 getty \- set terminal type, modes, speed, and line discipline
   9 .SH SYNOPSIS
  10 .LP
  11 .nf
  12 \fB/usr/lib/saf/ttymon\fR [\fB-h\fR] [\fB-t\fR \fItimeout\fR] \fIline\fR
  13      [\fIspeed\fR [\fItype\fR [\fIlinedisc\fR]]]
  14 .fi
  15
  16 .LP
  17 .nf
  18 \fB/usr/lib/saf/ttymon\fR \fB-c\fR \fIfile\fR
  19 .fi
  20
  21 .SH DESCRIPTION
  22 .sp
  23 .LP
  24 \fBgetty\fR sets terminal type, modes, speed, and line discipline. \fBgetty\fR
  25 is a symbolic link to  \fB/usr/lib/saf/ttymon\fR. It is included for
  26 compatibility with previous releases  for the few applications that still call
  27 \fBgetty\fR directly.
  28 .sp
  29 .LP
  30 \fBgetty\fR can only be executed by the super-user, (a process with the user
  31 \fBID\fR \fBroot\fR). Initially \fBgetty\fR prints the login prompt, waits for
  32 the user's login name, and then invokes the \fBlogin\fR command. \fBgetty\fR
  33 attempts to adapt the system to the terminal speed by using the options and
  34 arguments specified on the command line.
  35 .sp
  36 .LP
  37 Without optional arguments, \fBgetty\fR specifies the following: The
  38 \fIspeed\fR of the interface is set to 300 baud, either parity is allowed,
  39 \fBNEWLINE\fR characters are converted to carriage return-line feed, and tab
  40 expansion is performed on the standard output. \fBgetty\fR types the login
  41 prompt before reading the user's name a character at a time. If a null
  42 character (or framing error)  is received, it is assumed to be the result of
  43 the user pressing the  \fBBREAK\fR key. This will cause \fBgetty\fR to attempt
  44 the next \fIspeed\fR in the series. The series that \fBgetty\fR tries is
  45 determined by what it finds in \fB/etc/ttydefs \fR.
  46 .SH OPTIONS
  47 .sp
  48 .LP
  49 The following options are supported:
  50 .sp
  51 .ne 2
  52 .na
  53 \fB\fB-h\fR\fR
  54 .ad
  55 .RS 14n
  56 If the \fB-h\fR flag is not set, a hangup will be forced by setting the speed
  57 to zero before setting the speed to the default or a specified speed.
  58 .RE
  59
  60 .sp
  61 .ne 2
  62 .na
  63 \fB\fB-t\fR\fI timeout\fR\fR
  64 .ad
  65 .RS 14n
  66 Specifies that \fBgetty\fR should exit if the open on the line succeeds and no
  67 one types anything in  \fItimeout\fR seconds.
  68 .RE
  69
  70 .sp
  71 .ne 2
  72 .na
  73 \fB\fB-c\fR\fI file\fR\fR
  74 .ad
  75 .RS 14n
  76 The \fB-c\fR option is no longer supported. Instead use
  77 \fB/usr/sbin/sttydefs\fR \fB-l\fR to list the contents of the
  78 \fB/etc/ttydefs\fR file and perform a validity check on the file.
  79 .RE
  80
  81 .SH OPERANDS
  82 .sp
  83 .LP
  84 The following operands are supported:
  85 .sp
  86 .ne 2
  87 .na
  88 \fB\fIline\fR\fR
  89 .ad
  90 .RS 21n
  91 The name of a  \fBTTY\fR line in  \fB/dev\fR to which \fBgetty\fR is to attach
  92 itself. \fBgetty\fR uses this string as the name of a file in the \fB/dev\fR
  93 directory to open for reading and writing.
  94 .RE
  95
  96 .sp
  97 .ne 2
  98 .na
  99 \fB\fIspeed\fR\fR
 100 .ad
 101 .RS 21n
 102 The  \fIspeed\fR argument is a label to a speed and  \fBTTY\fR definition in
 103 the file \fB/etc/ttydefs\fR. This definition tells \fBgetty\fR at what speed to
 104 run initially,  what the initial \fBTTY\fR settings are, and what speed to try
 105 next, (should the user press the  \fBBREAK\fR key to indicate that the speed is
 106 inappropriate). The default \fIspeed\fR is 300 baud.
 107 .RE
 108
 109 .sp
 110 .ne 2
 111 .na
 112 \fB\fItype\fR and \fIlinedisc\fR\fR
 113 .ad
 114 .RS 21n
 115 These options are obsolete and will be ignored.
 116 .RE
 117
 118 .SH FILES
 119 .sp
 120 .ne 2
 121 .na
 122 \fB\fB/etc/ttydefs\fR\fR
 123 .ad
 124 .RS 16n
 125
 126 .RE
 127
 128 .SH SEE ALSO
 129 .sp
 130 .LP
 131 \fBct\fR(1C), \fBlogin\fR(1), \fBsttydefs\fR(1M), \fBttymon\fR(1M),
 132 \fBioctl\fR(2), \fBattributes\fR(5), \fBtty\fR(7D)