Man Linux: Main Page and Category List

NAME

       dpns_modifyusrmap  - modify user entry corresponding to a given virtual
       uid

SYNOPSIS

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

       int dpns_modifyusrmap (uid_t uid, char *newname)

DESCRIPTION

       dpns_modifyusrmap modifies the user  entry  corresponding  to  a  given
       virtual uid.

       uid    specifies the Virtual User Id.

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

       This function requires ADMIN privilege.

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

       EACCES       The caller does not have ADMIN privilege.

       EFAULT       newname is a NULL pointer.

       EEXIST       This user exists already.

       EINVAL       This  uid  does not exist in the internal mapping table or
                    the length of newname exceeds 255.

       SENOSHOST    Host unknown.

       SENOSSERV    Service unknown.

       SECOMERR     Communication error.

       ENSNACT      Name server is not running or is being shutdown.