lfc_getgrpbygids man page

LFC_GETGRPBYGIDS(3)          LFC Library Functions         LFC_GETGRPBYGIDS(3)

      lfc_getgrpbygids - get group names associated with given virtual gids

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

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

      [1mlfc_getgrpbygids  [22mgets  the  group  names associated with given virtual

             specifies the number of gids.

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

             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.

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

      [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.

LFC                      $Date: 2007/03/21 10:24:15 $      LFC_GETGRPBYGIDS(3)