DPNS_MODIFYGRPMAP

Section: DPNS Library Functions (3)
Updated: $Date: 2007/12/13 06:52:24 $
Index Return to Main Contents
 

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.