1DPNS_GETGRPBYGID(3) DPNS Library Functions DP‐
2NS_GETGRPBYGID(3)
3
4
5
6[1mNAME[0m
7 dpns_getgrpbygid ‐ get group name associated with a given
8virtual gid
9
10[1mSYNOPSIS[0m
11 [1m#include <sys/types.h>[0m
12 [1m#include "dpns_api.h"[0m
13
14 [1mint dpns_getgrpbygid (gid_t [4m[22mgid[24m[1m, char
15*[4m[22mgroupname[24m[1m)[0m
16
17[1mDESCRIPTION[0m
18 [1mdpns_getgrpbygid [22mgets the group name associated
19with a given virtual
20 gid.
21
22 [4mgid[24m specifies the Virtual Group Id.
23
24 [4mgroupname[0m
25 points at a buffer to receive the associated group
26name. The
27 buffer must be at least 256 characters long.
28
29[1mRETURN VALUE[0m
30 This routine returns 0 if the operation was successful
31or ‐1 if the
32 operation failed. In the latter case, [1mserrno [22mis set
33appropriately.
34
35[1mERRORS[0m
36 [1mEFAULT [4m[22mgroupname[24m is a NULL pointer.
37
38 [1mEINVAL [22mThis gid does not exist in the inter‐
39nal mapping table.
40
41 [1mSENOSHOST [22mHost unknown.
42
43 [1mSENOSSERV [22mService unknown.
44
45 [1mSECOMERR [22mCommunication error.
46
47 [1mENSNACT [22mName server is not running or is being
48shutdown.
49
50
51
52DPNS $Date: 2005/10/19 11:30:57 $ DP‐
53NS_GETGRPBYGID(3)
54
55
56
57
58
59
60
61
62
63
64
65
66