dpns_getgrpbygid man page

DPNS_GETGRPBYGID(3)         DPNS Library Functions         DPNS_GETGRPBYGID(3)

[1mNAME[0m
      dpns_getgrpbygid - get group name associated with a given virtual gid

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

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

[1mDESCRIPTION[0m
      [1mdpns_getgrpbygid  [22mgets  the  group name associated with a given virtual
      gid.

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

      [4mgroupname[0m
             points at a buffer to receive the associated  group  name.   The
             buffer must be at least 256 characters long.

[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
      [1mEFAULT       [4m[22mgroupname[24m is a NULL pointer.

      [1mEINVAL       [22mThis gid 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: 2005/10/19 11:30:57 $      DPNS_GETGRPBYGID(3)