HP-UX Reference (11i v2 03/08) - 3 Library Functions A-M (vol 6)

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 struc-

ture 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