getauthuid(3)						     Library Functions Manual						     getauthuid(3)

Name
       getauthuid, storeauthent, setauthfile, endauthent - get/set auth entry

Syntax
       #include <sys/types.h>
       #include <auth.h>

       AUTHORIZATION *getauthuid(uid)
       uid_t uid;

       int storeauthent(auth)
       AUTHORIZATION *auth;

       void setauthfile(pathname)
       char *pathname;

       int endauthent()

Description
       The function looks up the auth entry for the specified user ID and returns a pointer to a static area containing it.

       The function will store the specified auth entry into the local auth database, overwriting any existing entry with the same a_uid field.

       The function will set the pathname of the file to be used for the local auth database in all subsequent operations.

       The functions closes the auth database.	Subsequent calls to getauthuid and storeauthent will reopen it.

       The auth database may be distributed via the BIND/Hesiod naming service.

Restrictions
       Only the super-user and members of the group authread may read information from the auth database.

       Only the super-user may modify the auth database.

       The auth databse may not be distributed via the Yellow Pages service.

Return Values
       Functions  which  return a pointer value will return the null pointer (0) on EOF or error.  Other functions will return zero (0) on success
       and a negative value on failure.

Files
See Also
       getpwent(3), auth(5), edauth(8)
       Security Guide for Users and Programmers
       Security Guide for Administrators
       Guide to the BIND/Hesiod Service

																     getauthuid(3)