debian man page for dpns_getusrbyuid

DPNS_GETUSRBYUID(3)					      DPNS Library Functions					       DPNS_GETUSRBYUID(3)

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.

DPNS
							   $Date: 2005/10/19 11:30:57 $ 				       DPNS_GETUSRBYUID(3)