Scroll to navigation

DPNS_MODIFYGRPMAP(3) DPNS Library Functions DPNS_MODIFYGRPMAP(3)

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

DESCRIPTION

dpns_modifygrpmap modifies the group entry corresponding to a given virtual gid.

specifies the Virtual Group Id.
specifies the new group name. It must be at most 255 characters long.
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

The caller does not have ADMIN privilege.
newname is a NULL pointer.
This group exists already.
This gid does not exist in the internal mapping table or the length of newname exceeds 255.
Host unknown.
Service unknown.
Communication error.
Name server is not running or is being shutdown.
$Date$ DPNS