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, int status)

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.

status

status can be set to 0 or a combination of ARGUS_BAN and LOCAL_BAN.

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.