dpns_getgrpmap man page

DPNS_GETGRPMAP(3)           DPNS Library Functions           DPNS_GETGRPMAP(3)

[1mNAME[0m
      dpns_getgrpmap - get all existing groups from virtual gid table

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

      [1mint    dpns_getgrpmap    (int    *[4m[22mnbentries[24m[1m,    struct   dpns_groupinfo[0m
      [1m**[4m[22mgrp_entries[24m[1m)[0m

[1mDESCRIPTION[0m
      [1mdpns_getgrpmap [22mgets all the existing groups from the virtual gid table.

      [4mnbentries[0m
             will be set to the number of  entries  in  the  array  of  group
             infos.

      [4mgrp_entries[0m
             will  be set to the address of an array of dpns_groupinfo struc-
             tures allocated by the API. The client application is  responsi-
             ble for freeing the array when not needed anymore.

      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.

      [1mENOMEM       [22mMemory could not be allocated for unmarshalling the reply.

      [1mEFAULT       [4m[22mnbentries[24m or [4mgrp_entries[24m is a NULL pointer.

      [1mSENOSHOST    [22mHost unknown.

      [1mSENOSSERV    [22mService unknown.

      [1mSECOMERR     [22mCommunication error.

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

DPNS                     $Date: 2007/12/13 06:15:14 $        DPNS_GETGRPMAP(3)