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_nameis the name of the character-special file in the directory “/dev".  For various reasons, it must reside in the directory “/dev". 

ty_gettyis 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_typeis 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_statusis 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_ONEnables logins (i.e., init(8) will start the specified “getty" command on this entry).

TTY_SECUREAllows root to login on this terminal. Note that ‘TTY_ON’ must be included for this to be useful. 

ty_windowis 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_commentis 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. 

4.3 Berkeley Distribution  —  May 20, 1986