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