./_Man_NeXT_html/html3/getttyent.3.html

Manual page for GETTTYENT(3)

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.

/*
 * 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 */

#ifdef __STRICT_BSD__
extern struct ttyent *getttyent();
extern struct ttyent *getttynam();
#else
extern struct ttyent *getttyent(void);
extern struct ttyent *getttynam(char *name);
void setttyent(void);
void endttyent(void);
#endif __STRICT_BSD__

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

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.