dpns_getgrpbygids man page

DPNS_GETGRPBYGIDS(3)        DPNS Library Functions        DPNS_GETGRPBYGIDS(3)

[1mNAME[0m
      dpns_getgrpbygids - get group names associated with given virtual gids

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

      [1mint dpns_getgrpbygids (int [4m[22mnbgroups[24m[1m, gid_t *[4m[22mgids[24m[1m, char **[4m[22mgroupnames[24m[1m)[0m

[1mDESCRIPTION[0m
      [1mdpns_getgrpbygids  [22mgets  the  group names associated with given virtual
      gids.

      [4mnbgroups[0m
             specifies the number of gids.

      [4mgids[24m   specifies the Virtual Group Ids.

      [4mgroupnames[0m
             specifies a buffer to receive the  pointers  to  the  associated
             group  names.   The  buffer  must be big enough to hold [4mnbgroups[0m
             pointer values.  The client application is responsible for free-
             ing the array elements when not needed anymore.

[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
      [1mENOMEM       [22mMemory could not be allocated for unmarshalling the reply.

      [1mEFAULT       [4m[22mgids[24m or [4mgroupnames[24m is a NULL pointer.

      [1mEINVAL       [4m[22mnbgroups[24m is not strictly positive or one of the gids  does
                   not exist in the internal mapping table.

      [1mSENOSHOST    [22mHost unknown.

      [1mSENOSSERV    [22mService unknown.

      [1mSECOMERR     [22mCommunication error.

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

DPNS                     $Date: 2007/03/21 10:24:15 $     DPNS_GETGRPBYGIDS(3)