aa_auid_to_name(3) — DG/UX R4.11MU05



aa_auid_to_name(3)       DG/UX B2 Security R4.12MU02      aa_auid_to_name(3)


NAME
       aaauidtoname - translate an authentication/audit ID to a username

SYNOPSIS
       #include <sys/dgtparms.h>

            char *aa_auid_to_name (auid, name_p, size_p)
            auth_id_t  auid;
            char     **name_p;
            int       *size_p;

DESCRIPTION
       If auid is the AUTHID of a user in the A&A database, aaauidtoname
       allocates a buffer for a null-terminated copy of the corresponding
       username, copies that username into the buffer, places a pointer to
       that buffer in the variable pointed to by namep, and places the
       length of that buffer (including the terminating null character) in
       the variable pointed to be sizep.

       If auid is not the AUTHID of any user, aaauidtoname doesn't
       allocate any memory, sets only errno, and returns NULL.

RETURN VALUE
       If successful, aaauidtoname returns a copy of the pointer to the
       username buffer; otherwise it returns NULL.

EXCEPTIONS
       If aaauidtoname returns NULL, errno is set to one of the
       following.

       EINVAL auid is negative or zero, namep is NULL, or sizep is NULL.

       ENOENT No user has this auid.

       EFAULT The auid-to-username table is corrupted.

       ENOMEM An internal call to calloc(3) failed.


Licensed material--property of copyright holder(s)
Museum
