GETTTYENT(3) UNIX Programmer's Manual GETTTYENT(3)
getttyent, getttynam, setttyent, endttyent - get ttys file
S
\bSY
\bYN
\bNO
\bOP
\bPS
\bSI
\bIS
\bS
#
\b#i
\bin
\bnc
\bcl
\blu
\bud
\bde
\be <
\b<t
\btt
\bty
\bye
\ben
\bnt
\bt.
\b.h
\bh>
\b>
s
\bst
\btr
\bru
\buc
\bct
\bt t
\btt
\bty
\bye
\ben
\bnt
\bt *
\b*g
\bge
\bet
\btt
\btt
\bty
\bye
\ben
\bnt
\bt(
\b()
\b)
s
\bst
\btr
\bru
\buc
\bct
\bt t
\btt
\bty
\bye
\ben
\bnt
\bt *
\b*g
\bge
\bet
\btt
\btt
\bty
\byn
\bna
\bam
\bm(
\b(n
\bna
\bam
\bme
\be)
\b)
c
\bch
\bha
\bar
\br *
\b*n
\bna
\bam
\bme
\be;
\b;
s
\bse
\bet
\btt
\btt
\bty
\bye
\ben
\bnt
\bt(
\b()
\b)
e
\ben
\bnd
\bdt
\btt
\bty
\bye
\ben
\bnt
\bt(
\b()
\b)
D
\bDE
\bES
\bSC
\bCR
\bRI
\bIP
\bPT
\bTI
\bIO
\bON
\bN
_
\bG_
\be_
\bt_
\bt_
\bt_
\by_
\be_
\bn_
\bt, and _
\bg_
\be_
\bt_
\bt_
\bt_
\by_
\bn_
\ba_
\bm each return a pointer to an object
with the following structure containing the broken-out
fields of a line from the tty description file.
* Copyright (c) 1983 Regents of the University of California.
* All rights reserved. The Berkeley software License Agreement
* specifies the terms and conditions for redistribution.
* @(#)ttyent.h 5.1 (Berkeley) 5/30/85
struct ttyent { /* see getttyent(3) */
char *ty_name; /* terminal device name */
char *ty_getty; /* command to execute, usually getty */
char *ty_type; /* terminal type for termcap (3X) */
int ty_status; /* status flags (see below for defines) */
char *ty_window; /* command to start up window manager */
char *ty_comment; /* usually the location of the terminal */
#define TTY_ON 0x1 /* enable logins (startup getty) */
#define TTY_SECURE 0x2 /* allow root to login */
extern struct ttyent *getttyent();
extern struct ttyent *getttynam();
ty_name is the name of the character-special file in
the directory ``/dev". For various reasons, it
must reside in the directory ``/dev".
ty_getty is the command (usually _
\bg_
\be_
\bt_
\bt_
\by(8)) which is
invoked by _
\bi_
\bn_
\bi_
\bt to initialize tty line charac-
teristics. In fact, any arbitrary command can
be used; a typical use is to initiate a
Printed 7/9/88 May 20, 1986 1
GETTTYENT(3) UNIX Programmer's Manual GETTTYENT(3)
terminal emulator in a window system.
ty_type is the name of the default terminal type con-
nected to this tty line. This is typically a
name from the _
\bt_
\be_
\br_
\bm_
\bc_
\ba_
\bp(5) data base. The
environment variable `TERM' is initialized with
this name by _
\bg_
\be_
\bt_
\bt_
\by(8) or _
\bl_
\bo_
\bg_
\bi_
\bn(1).
ty_status is a mask of bit fields which indicate various
actions to be allowed on this tty line. The
following is a description of each flag.
TTY_ON Enables logins (i.e., _
\bi_
\bn_
\bi_
\bt(8) will
start the specified ``getty" com-
TTY_SECURE Allows root to login on this ter-
minal. Note that `TTY_ON' must be
included for this to be useful.
ty_window is the command to execute for a window system
associated with the line. The window system
will be started before the command specified in
the _
\bt_
\by__
\bg_
\be_
\bt_
\bt_
\by entry is executed. If none is
specified, this will be null.
ty_comment is the trailing comment field, if any; a lead-
ing delimiter and white space will be removed.
_
\bG_
\be_
\bt_
\bt_
\bt_
\by_
\be_
\bn_
\bt reads the next line from the ttys file, opening
the file if necessary; _
\bs_
\be_
\bt_
\bt_
\bt_
\by_
\be_
\bn_
\bt rewinds the file; _
\be_
\bn_
\bd_
\bt_
\bt_
\by_
\be_
\bn_
\bt
_
\bG_
\be_
\bt_
\bt_
\bt_
\by_
\bn_
\ba_
\bm searches from the beginning of the file until a
matching _
\bn_
\ba_
\bm_
\be is found (or until EOF is encountered).
S
\bSE
\bEE
\bE A
\bAL
\bLS
\bSO
\bO
login(1), ttyslot(3), ttys(5), gettytab(5), termcap(5),
D
\bDI
\bIA
\bAG
\bGN
\bNO
\bOS
\bST
\bTI
\bIC
\bCS
\bS
Null pointer (0) returned on EOF or error.
All information is contained in a static area so it must be
copied if it is to be saved.
Printed 7/9/88 May 20, 1986 2