getttyent

Section: C Library Functions (3)
Updated: 2022-12-15
Index Return to Main Contents
 

NAME

getttyent, getttynam, setttyent, endttyent - get ttys file entry  

LIBRARY

Standard C library (libc, -lc)  

SYNOPSIS

#include <ttyent.h>

struct ttyent *getttyent(void);
struct ttyent *getttynam(const char *name);

int setttyent(void);
int endttyent(void);
 

DESCRIPTION

These functions provide an interface to the file _PATH_TTYS (e.g., /etc/ttys).

The function setttyent() opens the file or rewinds it if already open.

The function endttyent() closes the file.

The function getttynam() searches for a given terminal name in the file. It returns a pointer to a ttyent structure (description below).

The function getttyent() opens the file _PATH_TTYS (if necessary) and returns the first entry. If the file is already open, the next entry. The ttyent structure has the form:

struct ttyent {
    char *ty_name;     /* terminal device name */
    char *ty_getty;    /* command to execute, usually getty */
    char *ty_type;     /* terminal type for termcap */
    int   ty_status;   /* status flags */
    char *ty_window;   /* command to start up window manager */
    char *ty_comment;  /* comment field */ };

ty_status can be:

#define TTY_ON 0x01 /* enable logins (start ty_getty program) */ #define TTY_SECURE 0x02 /* allow UID 0 to login */  

ATTRIBUTES

For an explanation of the terms used in this section, see attributes(7).
InterfaceAttributeValue
getttyent(), setttyent(), endttyent(), getttynam() Thread safetyMT-Unsafe race:ttyent

 

STANDARDS

Not in POSIX.1. Present on the BSDs, and perhaps other systems.  

NOTES

Under Linux, the file /etc/ttys, and the functions described above, are not used.  

SEE ALSO

ttyname(3), ttyslot(3)


 

Index

NAME
LIBRARY
SYNOPSIS
DESCRIPTION
ATTRIBUTES
STANDARDS
NOTES
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 14:41:56 GMT, March 28, 2024