NAME

       dpns_getusrbyuid - get user name associated with a given virtual uid

SYNOPSIS

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

       int dpns_getusrbyuid (uid_t uid, char *username)

DESCRIPTION

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

       uid    specifies the Virtual User Id.

       username
              points  at  a  buffer  to  receive the associated user name.  The buffer must be at
              least 256 characters long.

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 is a NULL pointer.

       EINVAL       This uid does not exist in the internal mapping table.

       SENOSHOST    Host unknown.

       SENOSSERV    Service unknown.

       SECOMERR     Communication error.

       ENSNACT      Name server is not running or is being shutdown.