getttyent(3)getttyent(3)Name
getttyent, getttynam, setttyent, endttyent - get ttys file entry
Syntax
#include <ttyent.h>
struct ttyent *getttyent()
struct ttyent *getttynam(name) char *name;
void setttyent()
void endttyent()Arguments
name The name of the terminal's special file in the directory.
Description
These functions allow a program to access data in the file The function
reads the file line by line, opening the file if necessary. rewinds
the file, and closes it. searches from the beginning of the file until
a matching name is found, or until end-of-file is encountered.
The functions and each return a pointer to an object that has the fol‐
lowing structure. Each element of the structure contains one field of
a line in the file.
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_LOCAL 0x4 /* line is local direct connect and
should ignore modem signals */
#define TTY_SHARED 0x8 /* line is shared: it can be use
for both incoming and outgoing
connections. */
#define TTY_TRACK 0x10 /* track modem status changes */
#define TTY_TERMIO 0x20 /* open line with termio defaults */
#define TTY_SU 0x40 /* disallow su to root */
extern struct ttyent *getttyent();
extern struct ttyent *getttynam();
A description of the fields follows:
ty_name
is the name of the terminal's special file in the directory
ty_getty
is the command invoked by to initialize terminal line character‐
istics. This command is usually but 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 data base. The envi‐
ronment variable `TERM' is initialized with this name by
ty_status
is a mask of bit flags that indicate various actions allowed on
this terminal line. The following is a description of each flag.
TTY_ON Enables logins. For instance, will start the specified
command on this entry.
TTY_SECURE
Allows root to login on this terminal. TTY_ON must also
be included for this to work.
TTY_LOCAL
Indicates that the line is to ignore modem signals.
TTY_SHARED
Indicates that the line can be used for both incoming and
outgoing connections.
TTY_TERMIO
Indicates that a line is to be opened with default termi‐
nal attributes which are compliant with System Five
termio defaults. The line discipline will be set to be
TERMIODISC.
TTY_SU Indicates that a user is allowed to su to root on this
terminal. The default if this flag is not set is that a
user cannot su to root on this terminal.
ty_window
is the quoted string of a command to execute for a window system
associated with the line. If no command is specified, this
field is a null string.
ty_comment
Currently unused.
Restrictions
The information returned is in a static area, so you must copy it to
save it.
Return Values
A null pointer (0) is returned on an end-of-file or error.
Files
The file examined by these routines.
See Alsottyname(3), ttys(5), init(8)getttyent(3)