1DPNS_GETUSRBYNAM(3) DPNS Library Functions DP‐
2NS_GETUSRBYNAM(3)
3
4
5
6[1mNAME[0m
7 dpns_getusrbynam ‐ get virtual uid associated with a given
8user name
9
10[1mSYNOPSIS[0m
11 [1m#include <sys/types.h>[0m
12 [1m#include "dpns_api.h"[0m
13
14 [1mint dpns_getusrbynam (char *[4m[22musername[24m[1m,
15uid_t *[4m[22muid[24m[1m)[0m
16
17[1mDESCRIPTION[0m
18 [1mdpns_getusrbynam [22mgets the virtual uid associ‐
19ated with a given user
20 name.
21
22 [4musername[0m
23 specifies the user name. It must be at most
24255 characters
25 long.
26
27 [4muid[24m specifies the address of a buffer to re‐
28ceive the Virtual User
29 Id.
30
31[1mRETURN VALUE[0m
32 This routine returns 0 if the operation was successful or
33‐1 if the
34 operation failed. In the latter case, [1mserrno [22mis set
35appropriately.
36
37[1mERRORS[0m
38 [1mEFAULT [4m[22musername[24m or [4muid[24m is a
39NULL pointer.
40
41 [1mEINVAL [22mThis user name does not exist in the
42internal mapping ta‐
43 ble or the length of [4musername[24m exceeds
44255.
45
46 [1mSENOSHOST [22mHost unknown.
47
48 [1mSENOSSERV [22mService unknown.
49
50 [1mSECOMERR [22mCommunication error.
51
52 [1mENSNACT [22mName server is not running or is being
53shutdown.
54
55
56
57DPNS $Date: 2005/10/19 11:30:57 $ DP‐
58NS_GETUSRBYNAM(3)
59
60
61
62
63
64
65
66