dpns_modifygrpmap man page

DPNS_MODIFYGRPMAP(3)        DPNS Library Functions        DPNS_MODIFYGRPMAP(3)

[1mNAME[0m
      dpns_modifygrpmap - modify group entry corresponding to a given virtual
      gid

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

      [1mint dpns_modifygrpmap (gid_t [4m[22mgid[24m[1m, char *[4m[22mnewname[24m[1m, int [4m[22mstatus)[0m

[1mDESCRIPTION[0m
      [1mdpns_modifygrpmap [22mmodifies the group entry  corresponding  to  a  given
      virtual gid.

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

      [4mnewname[0m
             specifies the new group name.  It must be at most 255 characters
             long.

      [4mstatus[24m status can be set  to  0  or  a  combination  of  ARGUS_BAN  and
             LOCAL_BAN.

      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.

      [1mEFAULT       [4m[22mnewname[24m is a NULL pointer.

      [1mEEXIST       [22mThis group exists already.

      [1mEINVAL       [22mThis gid does not exist in the internal mapping  table  or
                   the length of [4mnewname[24m exceeds 255.

      [1mSENOSHOST    [22mHost unknown.

      [1mSENOSSERV    [22mService unknown.

      [1mSECOMERR     [22mCommunication error.

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

DPNS         $Date: 2010-08-04 09:58:47 +0200 (Wed, 04 AugD2P0N1S0_)MO$DIFYGRPMAP(3)