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)