opensolaris man page for ttyslot

ttyslot(3C)						   Standard C Library Functions 					       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 device 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 attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |Safe			   |
       +-----------------------------+-----------------------------+

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

SunOS 5.11							    27 Oct 1998 						       ttyslot(3C)