NAME

       dpns_getusrbynam - get virtual uid associated with a given user name

SYNOPSIS

       #include <sys/types.h>
       #include "dpns_api.h"

       int dpns_getusrbynam (char *username, uid_t *uid)

DESCRIPTION

       dpns_getusrbynam gets the virtual uid associated with a given user name.

       username
              specifies the user name.  It must be at most 255 characters long.

       uid    specifies the address of a buffer to receive the Virtual User Id.

RETURN VALUE

       This  routine  returns 0 if the operation was successful or -1 if the operation failed. In
       the latter case, serrno is set appropriately.

ERRORS

       EFAULT       username or uid is a NULL pointer.

       EINVAL       This user name does not exist in the internal mapping table or the length  of
                    username exceeds 255.

       SENOSHOST    Host unknown.

       SENOSSERV    Service unknown.

       SECOMERR     Communication error.

       ENSNACT      Name server is not running or is being shutdown.