NAME
getttyent, getttynam, setttyent, endttyent - get ttys file entry

SYNOPSIS
#include <ttyent.h>

struct ttyent *getttyent()

struct ttyent *getttynam(name)
const char *name;

void setttyent()

void 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.

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 libtermcap(3) */
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 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 ALSO
login(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.