GENWiki

Premier IT Outsourcing and Support Services within the UK

User Tools

Site Tools


man:getttyent

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

NAME

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

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).
     +--------------------------+---------------+-----------------------+
     |Interface                 | Attribute     | Value                 |
     +--------------------------+---------------+-----------------------+
     |getttyent(), setttyent(), | Thread safety | MT-Unsafe race:ttyent |
     |endttyent(), getttynam()  |               |                       |
     +--------------------------+---------------+-----------------------+

CONFORMING TO

     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)

COLOPHON

     This  page  is  part of release 4.16 of the Linux man-pages project.  A
     description of the project, information about reporting bugs,  and  the
     latest     version     of     this    page,    can    be    found    at
     https://www.kernel.org/doc/man-pages/.

GNU 2017-09-15 GETTTYENT(3)

/data/webs/external/dokuwiki/data/pages/man/getttyent.txt · Last modified: 2019/05/17 09:47 by 127.0.0.1

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki