struct
ttyent
*
getttyent(
)
struct
ttyent
*
getttynam(
char *name
)
int
setttyent(
void
)
int
setttyentpath(
const char *path
)
int
endttyent(
void
)
),
and
getttynam(
)
functions
each return a pointer to an object, with the following structure,
containing the broken-out fields of a line from the tty description
file.
struct ttyent {
char *ty_name; /* terminal device name */
char *ty_getty; /* command to execute */
char *ty_type; /* terminal type */
#define TTY_ON 0x01 /* enable logins */
#define TTY_SECURE 0x02 /* allow uid of 0 to login */
#define TTY_LOCAL 0x04 /* set 'CLOCAL' on open (dev. specific) */
#define TTY_RTSCTS 0x08 /* set 'CRTSCTS' on open (dev. specific) */
#define TTY_SOFTCAR 0x10 /* ignore hardware carrier (dev. spec.) */
#define TTY_MDMBUF 0x20 /* set 'MDMBUF' on open (dev. specific) */
#define TTY_DTRCTS 0x40 /* set 'CDTRCTS' on open (dev. specific) */
int ty_status; /* flag values */
char *ty_window; /* command for window manager */
char *ty_comment; /* comment field */
char *ty_class; /* category of tty usage */
};
The fields are as follows:
ty_name
ty_getty
ty_type
ty_status
TTY_ON
ty_getty
on this entry).
TTY_SECURE
TTY_LOCAL
TTY_MDMBUF
TTY_RTSCTS
TTY_SOFTCAR
ty_window
ty_comment
ty_class
If any of the fields pointing to character strings are unspecified,
they are returned as null pointers.
The field
ty_status
will be zero if no flag values are specified.
See ttys(5) for a more complete discussion of the meaning and usage of the fields.
The
getttyent()
function
reads the next line from the ttys file, opening the file if necessary.
The
setttyent(
)
function
rewinds the file if open, or opens the file if it is unopened.
The
setttyentpath(
)
function
is equivalent to
setttyent(
)
but accepts an additional argument to read the ttys information from
an alternate file instead of the default location
(defined in
_PATH_TTYS
).
The
endttyent()
function
closes any open files.
The
getttynam()
function
searches from the beginning of the file until a matching
name
is found
(or until
EOF
is encountered).
)
and
getttynam(
)
return a null pointer on
EOF
or error.
The
setttyent(
)
and
setttyentpath(
)
functions
and
endttyent(
)
return 0 on failure and 1 on success.
/etc/ttys
),
getttynam(
),
setttyent(
),
and
endttyent(
)
functions appeared in
4.3BSD.
The
setttyentpath(
)
function appeared in
NetBSD4.0.