GETTTYENT(3)GETTTYENT(3)NAME
getttyent, getttynam, setttyent, endttyent - get ttys file entry
SYNOPSIS
#include <ttyent.h>
struct ttyent *getttyent()
struct ttyent *getttynam(name)
char *name;
setttyent()endttyent()DESCRIPTION
Getttyent, and getttynam each return a pointer to an object with the
following structure containing the broken-out fields of a line from the
tty description file.
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 getty(8)) which is invoked by init
to initialize tty line characteristics. In fact, any
arbitrary command can be used; a typical use is to
initiate a terminal emulator in a window system.
ty_type is the name of the default terminal type connected to this
tty line. This is typically a name from the termcap(5)
data base. The environment variable `TERM' is initialized
with this name by getty(8) or login(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., init(8) will start the
specified ``getty" command on this entry).
TTY_SECURE Allows root to login on this terminal. 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 ty_getty entry is executed.
If none is specified, this will be null.
ty_comment is the trailing comment field, if any; a leading delimiter
and white space will be removed.
Getttyent reads the next line from the ttys file, opening the file if
necessary; setttyent rewinds the file; endttyent closes it.
Getttynam searches from the beginning of the file until a matching name
is found (or until EOF is encountered).
FILES
/etc/ttys
SEE ALSOlogin(1), ttyslot(3), ttys(5), gettytab(5), termcap(5), getty(8),
init(8)DIAGNOSTICS
Null pointer (0) returned on EOF or error.
BUGS
All information is contained in a static area so it must be copied if
it is to be saved.
4.3 Berkeley Distribution May 20, 1986 GETTTYENT(3)