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