dpns_rmgrpmap man page

DPNS_RMGRPMAP(3)            DPNS Library Functions            DPNS_RMGRPMAP(3)

[1mNAME[0m
      dpns_rmgrpmap  -  suppress group entry corresponding to a given virtual
      gid or group name

[1mSYNOPSIS[0m
      [1m#include <sys/types.h>[0m
      [1m#include "dpns_api.h"[0m

      [1mint dpns_rmgrpmap (gid_t [4m[22mgid[24m[1m, char *[4m[22mgroupname[24m[1m)[0m

[1mDESCRIPTION[0m
      [1mdpns_rmgrpmap [22msuppresses the group entry corresponding to a given  vir-
      tual  gid or group name.  If both are specified, they must point at the
      same entry.

      [4mgid[24m    specifies the Virtual Group Id.

      [4mgroupname[0m
             specifies the group name.

      This function requires ADMIN privilege.

[1mRETURN VALUE[0m
      This routine returns 0 if the operation was successful  or  -1  if  the
      operation failed. In the latter case, [1mserrno [22mis set appropriately.

[1mERRORS[0m
      [1mEACCES       [22mThe caller does not have ADMIN privilege.

      [1mEINVAL       [22mThis group does not exist in the internal mapping table or
                   the length of [4mgroupname[24m exceeds 255 or [4mgid[24m  and  [4mgroupname[0m
                   do not point at the same entry.

      [1mSENOSHOST    [22mHost unknown.

      [1mSENOSSERV    [22mService unknown.

      [1mSECOMERR     [22mCommunication error.

      [1mENSNACT      [22mName server is not running or is being shutdown.

DPNS                     $Date: 2006/01/12 16:29:33 $         DPNS_RMGRPMAP(3)