1DPNS_ENTERUSRMAP(3)         DPNS Library Functions         DPNS_ENTERUSRMAP(3)
2
3
4

NAME

6       dpns_enterusrmap - define a new user entry in Virtual Id table
7

SYNOPSIS

9       #include <sys/types.h>
10       #include "dpns_api.h"
11
12       int dpns_enterusrmap (uid_t uid, char *username)
13

DESCRIPTION

15       dpns_enterusrmap defines a new user entry in Virtual Id table.
16
17       uid    specifies  the  Virtual  User  Id.  If the value is -1, the next
18              available id is allocated.
19
20       username
21              specifies the user name.
22
23       This function requires ADMIN privilege.
24

RETURN VALUE

26       This routine returns 0 if the operation was successful  or  -1  if  the
27       operation failed. In the latter case, serrno is set appropriately.
28

ERRORS

30       EACCES       The caller does not have ADMIN privilege.
31
32       EFAULT       username is a NULL pointer.
33
34       EEXIST       User exists already.
35
36       EINVAL       The length of username exceeds 255.
37
38       SENOSHOST    Host unknown.
39
40       SENOSSERV    Service unknown.
41
42       SECOMERR     Communication error.
43
44       ENSNACT      Name server is not running or is being shutdown.
45
46
47
48DPNS                     $Date: 2006/01/13 16:22:46 $      DPNS_ENTERUSRMAP(3)