getttyent, getttynam, setttyent, endttyent - get ttytab 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.

struct	ttyent {
	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 */

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 (that is, init.8 will start the specified ``getty'' command on this entry).

TTY_SECURE

Allows root to login on this terminal. Note: 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 ttytab 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/ttytab

SEE ALSO

DIAGNOSTICS

NULL pointer (0) returned on EOF or error.

BUGS

Created by unroff & hp-tools. © somebody (See intro for details). All Rights Reserved. Last modified 11/5/97