debian man page for dpns_modifygrpmap

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.

       gid    specifies the Virtual Group Id.

       newname
	      specifies the new group 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 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.

DPNS
					       $Date: 2010-08-04 09:58:47 +0200 (Wed, 04 Aug 2010) $			      DPNS_MODIFYGRPMAP(3)