dpns_getgrpbygids man page


dpns_getgrpbygids - get group names associated with given virtual gids

[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

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

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