GETTTYENT(3) Linux Programmer's Manual GETTTYENT(3)

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

SYNOPSIS
       #include 

       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 PATHTTYS (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 PATHTTYS (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 *tyname;     /* terminal device name */
               char *tygetty;    /* command to execute, usually getty */
               char *tytype;     /* terminal type for termcap */
               int   tystatus;   /* status flags */
               char *tywindow;   /* command to start up window manager */
               char *tycomment;  /* comment field */
           };

       tystatus can be:

       #define TTYON     0x01  /* enable logins (start tygetty program) */
       #define TTYSECURE 0x02  /* allow UID 0 to login */

ATTRIBUTES
       For   an   explanation   of   the  terms  used  in  this  section,  see
       attributes(7).

       ┌──────────────────────────┬───────────────┬───────────────────────┐
       │Interface                 │ Attribute     │ Value                 │
       ├──────────────────────────┼───────────────┼───────────────────────┤
       │getttyent(), setttyent(), │ Thread safety │ MT-Unsafe race:ttyent │
       │endttyent(), getttynam()  │               │                       │
       └──────────────────────────┴───────────────┴───────────────────────┘
CONFORMING TO
       Not in POSIX.1-2001.  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)

COLOPHON
       This page is part of release 3.53 of the Linux  man-pages  project.   A
       description  of  the project, and information about reporting bugs, can
       be found at http://www.kernel.org/doc/man-pages/.



GNU                               2013-07-22                      GETTTYENT(3)