1DPNS_GETGRPMAP(3)            DPNS Library Functions           DP‐
2NS_GETGRPMAP(3)
3
4
5
6[1mNAME[0m
7       dpns_getgrpmap ‐ get all existing groups from virtual  gid
8table
9
10[1mSYNOPSIS[0m
11       [1m#include <sys/types.h>[0m
12       [1m#include "dpns_api.h"[0m
13
14       [1mint       dpns_getgrpmap       (int       *[4m[22mnben‐
15tries[24m[1m,    struct   dpns_groupinfo[0m
16       [1m**[4m[22mgrp_entries[24m[1m)[0m
17
18[1mDESCRIPTION[0m
19       [1mdpns_getgrpmap [22mgets all the  existing  groups  from
20the virtual gid table.
21
22       [4mnbentries[0m
23              will be set to the number of  entries  in  the  ar‐
24ray  of  group
25              infos.
26
27       [4mgrp_entries[0m
28              will  be set to the address  of  an  array  of  dp‐
29ns_groupinfo struc‐
30              tures  allocated by the API. The client application
31is  responsi‐
32              ble for freeing the array when not needed anymore.
33
34       This function requires ADMIN privilege.
35
36[1mRETURN VALUE[0m
37       This  routine  returns  0  if the operation was successful
38or ‐1 if the
39       operation failed. In the latter case, [1mserrno [22mis set
40appropriately.
41
42[1mERRORS[0m
43       [1mEACCES       [22mThe caller does not have ADMIN  privi‐
44lege.
45
46       [1mENOMEM        [22mMemory could not be allocated for un‐
47marshalling the reply.
48
49       [1mEFAULT       [4m[22mnbentries[24m or [4mgrp_entries[24m
50is a NULL pointer.
51
52       [1mSENOSHOST    [22mHost unknown.
53
54       [1mSENOSSERV    [22mService unknown.
55
56       [1mSECOMERR     [22mCommunication error.
57
58       [1mENSNACT      [22mName server is not running or is being
59shutdown.
60
61
62
63DPNS                     $Date: 2007/12/13 06:15:14 $         DP‐
64NS_GETGRPMAP(3)
65
66
Impressum