4.3BSD-UWisc/man/cat3/getttyent.3
GETTTYENT(3) UNIX Programmer's Manual GETTTYENT(3)
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
_G_e_t_t_t_y_e_n_t, and _g_e_t_t_t_y_n_a_m each return a pointer to an object
with the following structure containing the broken-out
fields of a line from the tty description file.
/*
* RCS Info
* $Header: ttyent.h,v 1.2 86/09/08 09:40:05 tadl Exp $
* $Locker: tadl $
*/
/*
* 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 */
#define TTY_RESTRICTED 0x4 /* terminal restricted list */
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
Printed 12/27/86 May 20, 1986 1
GETTTYENT(3) UNIX Programmer's Manual GETTTYENT(3)
must reside in the directory ``/dev".
ty_getty is the command (usually _g_e_t_t_y(8)) which is
invoked by _i_n_i_t to initialize tty line charac-
teristics. In fact, any arbitrary command can
be used; a typical use is to initiate a termi-
nal emulator in a window system.
ty_type is the name of the default terminal type con-
nected to this tty line. This is typically a
name from the _t_e_r_m_c_a_p(5) data base. The
environment variable `TERM' is initialized with
this name by _g_e_t_t_y(8) or _l_o_g_i_n(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., _i_n_i_t(8) will
start the specified ``getty" com-
mand on this entry).
TTY_SECURE Allows root to login on this ter-
minal. 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 _t_y__g_e_t_t_y entry is executed. If none is
specified, this will be null.
ty_comment is the trailing comment field, if any; a lead-
ing delimiter and white space will be removed.
_G_e_t_t_t_y_e_n_t reads the next line from the ttys file, opening
the file if necessary; _s_e_t_t_t_y_e_n_t rewinds the file; _e_n_d_t_t_y_e_n_t
closes it.
_G_e_t_t_t_y_n_a_m searches from the beginning of the file until a
matching _n_a_m_e 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.
Printed 12/27/86 May 20, 1986 2
GETTTYENT(3) UNIX Programmer's Manual GETTTYENT(3)
BUGS
All information is contained in a static area so it must be
copied if it is to be saved.
Printed 12/27/86 May 20, 1986 3