lfc_getgrpbynam man page

LFC_GETGRPBYNAM(3)           LFC Library Functions          LFC_GETGRPBYNAM(3)

      lfc_getgrpbynam - get virtual gid associated with a given group name

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

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

      [1mlfc_getgrpbynam  [22mgets  the  virtual  gid  associated with a given group

             specifies the group name.  It must be  at  most  255  characters

      [4mgid[24m    specifies  the  address of a buffer to receive the Virtual Group

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

      [1mEFAULT       [4m[22mgroupname[24m or [4mgid[24m is a NULL pointer.

      [1mEINVAL       [22mThis group name does not exist in the internal mapping ta-
                   ble or the length of [4mgroupname[24m exceeds 255.

      [1mSENOSHOST    [22mHost unknown.

      [1mSENOSSERV    [22mService unknown.

      [1mSECOMERR     [22mCommunication error.

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

LFC                      $Date: 2005/10/19 11:30:57 $       LFC_GETGRPBYNAM(3)