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

NAME

6       dpns_getgrpbygids - get group names associated with given virtual gids
7

SYNOPSIS

9       #include <sys/types.h>
10       #include "dpns_api.h"
11
12       int dpns_getgrpbygids (int nbgroups, gid_t *gids, char **groupnames)
13

DESCRIPTION

15       dpns_getgrpbygids  gets  the  group names associated with given virtual
16       gids.
17
18       nbgroups
19              specifies the number of gids.
20
21       gids   specifies the Virtual Group Ids.
22
23       groupnames
24              specifies a buffer to receive the  pointers  to  the  associated
25              group  names.   The  buffer  must be big enough to hold nbgroups
26              pointer values.  The client application is responsible for free‐
27              ing the array elements when not needed anymore.
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       ENOMEM       Memory could not be allocated for unmarshalling the reply.
35
36       EFAULT       gids or groupnames is a NULL pointer.
37
38       EINVAL       nbgroups is not strictly positive or one of the gids  does
39                    not exist in the internal mapping table.
40
41       SENOSHOST    Host unknown.
42
43       SENOSSERV    Service unknown.
44
45       SECOMERR     Communication error.
46
47       ENSNACT      Name server is not running or is being shutdown.
48
49
50
51DPNS                     $Date: 2007/03/21 10:24:15 $     DPNS_GETGRPBYGIDS(3)
Impressum