ttyslot(3C)

NAME

     ttyslot - find the slot of the current  user   in  the  user
     accounting database

SYNOPSIS

     #include <stdlib.h>

     int ttyslot(void);

DESCRIPTION

     The ttyslot() function returns  the  index  of  the  current
     user's    entry    in    the   user   accounting   database,
     /var/adm/utmpx. The current user's entry  is  an  entry  for
     which  the utline member matches the name of a terminal dev-
     ice associated with any of the process's file descriptors 0,
     1  or  2.  The  index  is an ordinal number representing the
     record number in the database of the current  user's  entry.
     The first entry in the database is represented by the return
     value 0.

RETURN VALUES

     Upon successful completion, ttyslot() returns the  index  of
     the current user's entry in the user accounting database. If
     an error was encountered while searching  for  the  terminal
     name or if none of the above file descriptors are associated
     with a terminal device, -1 is returned.

FILES

     /var/adm/utmpx
           user access and accounting information

ATTRIBUTES

     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | MT-Level                    | Safe                        |
    |_____________________________|_____________________________|

SEE ALSO

     getutent(3C), ttyname(3C), utmpx(4), attributes(5)