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(7) for descriptions of the following attributes:


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

SEE ALSO

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


October 27, 1998 TTYSLOT(3C)