getuts.3c (2010 09)

getuts(3C) getuts(3C)

RETURN VALUE

getutsent(), getutsid(), getutsline(), pututsline()

, and getutspid() return a

pointer to static

utmps structure on success. On failure they return NULL.

ERRORS

[EINVAL] The size parameter passed to the

getuts functions does not match any of the structure

sizes supported by the server.

WARNINGS

If the size of a member of the

utmps structure changes in a future release, applications compiled with

older version of the

utmps structure will get truncated information for the structure ﬁelds that have

expanded. To get the complete information, the applications have to be re-compiled.

The value returned by

getutsent(), getutsid(),

getutsline(), pututsline(), and

getutspid() points to a single static area that is overwritten by each call to any of the functions, so it

must be copied if it is to be saved.

AUTHOR

The

getuts() routines were developed by Hewlett-Packard Company.

FILES

/etc/utmps