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

NAME

6       dpns_getgrpmap - get all existing groups from virtual gid table
7

SYNOPSIS

9       #include <sys/types.h>
10       #include "dpns_api.h"
11
12       int    dpns_getgrpmap    (int    *nbentries,    struct   dpns_groupinfo
13       **grp_entries)
14

DESCRIPTION

16       dpns_getgrpmap gets all the existing groups from the virtual gid table.
17
18       nbentries
19              will be set to the number of  entries  in  the  array  of  group
20              infos.
21
22       grp_entries
23              will  be set to the address of an array of dpns_groupinfo struc‐
24              tures allocated by the API. The client application is  responsi‐
25              ble for freeing the array when not needed anymore.
26
27       This function requires ADMIN privilege.
28

RETURN VALUE

30       This  routine  returns  0  if the operation was successful or -1 if the
31       operation failed. In the latter case, serrno is set appropriately.
32

ERRORS

34       EACCES       The caller does not have ADMIN privilege.
35
36       ENOMEM       Memory could not be allocated for unmarshalling the reply.
37
38       EFAULT       nbentries or grp_entries is a NULL pointer.
39
40       SENOSHOST    Host unknown.
41
42       SENOSSERV    Service unknown.
43
44       SECOMERR     Communication error.
45
46       ENSNACT      Name server is not running or is being shutdown.
47
48
49
50DPNS                     $Date: 2007/12/13 06:15:14 $        DPNS_GETGRPMAP(3)
Impressum