GETTTYENT(3-BSD) RISC/os Reference Manual GETTTYENT(3-BSD)
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.
#ifndef BSD43_
# include <bsd43/bsd43_.h>
#endif BSD43_
struct bsd43_(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 BSD43_TTY_ON 0x1 /* enable logins (startup getty) */
#define BSD43_TTY_SECURE 0x2 /* allow root to login */
extern struct bsd43_(ttyent) *bsd43_(getttyent)();
extern struct bsd43_(ttyent) *bsd43_(getttynam)();
/*----- NUMIPS: STRIP MACRO PREFIXES (BEGIN) ------------------------*/
/*
* Strip off "BSD43_" and "bsd43_" for use with standard BSD code.
* (GENERATED AUTOMATICALLY -- DON'T EDIT BY HAND)
*/
#ifdef SYSTYPE_BSD43
# define TTY_ON BSD43_TTY_ON
# define TTY_SECURE BSD43_TTY_SECURE
#endif SYSTYPE_BSD43
/*----- NUMIPS: STRIP MACRO PREFIXES (END) --------------------------*/
Printed 11/19/92 Page 1
GETTTYENT(3-BSD) RISC/os Reference Manual GETTTYENT(3-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(1M)) which is
invoked by init 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 termcap(5) data base. The
environment variable 'TERM' is initialized with
this name by getty(1M) 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(1M) will
start the specified ``getty" command
on this entry).
TTY_SECURE
Allows root to login on this termi-
nal. 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 lead-
ing 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
ttyname(3), termcap(5), ttys(5).
login(1) in the User's Reference Manual.
getty(1M), init(1M) in the System Administrator's Reference
Page 2 Printed 11/19/92
GETTTYENT(3-BSD) RISC/os Reference Manual GETTTYENT(3-BSD)
Manual.
DIAGNOSTICS
Null pointer (0) returned on EOF or error.
ERRORS
All information is contained in a static area so it must be
copied if it is to be saved.
Printed 11/19/92 Page 3