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. 

/∗
 ∗ $Header: /smsa/bsd:include/ttyent.h:bsd  1.5  $
 ∗ $Source: /smsa/bsd:include/ttyent.h: $
 ∗
 ∗ Copyright (c) 1988 Acorn Computers Ltd., Cambridge, England
 ∗/
/∗
 ∗ 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.h5.1 (Berkeley) 5/30/85
 ∗/
 #ifndef __ttyent_h
#define __ttyent_h
 structttyent { /∗ 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) ∗/
intty_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_ON0x1/∗ enable logins (startup getty) ∗/
#define TTY_SECURE0x2/∗ allow root to login ∗/
 extern struct ttyent ∗getttyent(void);
extern struct ttyent ∗getttynam(char ∗);
 #endif/∗__ttyent_h∗/
 /∗ EOF ttyent.h ∗/

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  —  Revision 1.2 of 19/10/88