NAME
dpns_modifygrpmap - modify group entry corresponding to a given virtual
gid
SYNOPSIS
#include <sys/types.h>
#include "dpns_api.h"
int dpns_modifygrpmap (gid_t gid, char *newname)
DESCRIPTION
dpns_modifygrpmap modifies the group entry corresponding to a given
virtual gid.
gid specifies the Virtual Group Id.
newname
specifies the new group 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 group exists already.
EINVAL This gid 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.