1DPNS_GETGRPBYGIDS(3)         DPNS  Library  Functions         DP‐
2NS_GETGRPBYGIDS(3)
3
4
5
6[1mNAME[0m
7       dpns_getgrpbygids ‐ get group names associated with  given
8virtual gids
9
10[1mSYNOPSIS[0m
11       [1m#include <sys/types.h>[0m
12       [1m#include "dpns_api.h"[0m
13
14       [1mint   dpns_getgrpbygids   (int  [4m[22mnbgroups[24m[1m,
15gid_t *[4m[22mgids[24m[1m, char **[4m[22mgroupnames[24m[1m)[0m
16
17[1mDESCRIPTION[0m
18       [1mdpns_getgrpbygids  [22mgets  the  group names associat‐
19ed with given virtual
20       gids.
21
22       [4mnbgroups[0m
23              specifies the number of gids.
24
25       [4mgids[24m   specifies the Virtual Group Ids.
26
27       [4mgroupnames[0m
28              specifies  a  buffer  to  receive the  pointers  to
29the  associated
30              group  names.   The  buffer  must be big enough  to
31hold [4mnbgroups[0m
32              pointer  values.  The client application is respon‐
33sible for free‐
34              ing the array elements when not needed anymore.
35
36[1mRETURN VALUE[0m
37       This  routine  returns  0  if the operation was successful
38or ‐1 if the
39       operation failed. In the latter case, [1mserrno [22mis set
40appropriately.
41
42[1mERRORS[0m
43       [1mENOMEM       [22mMemory could not be allocated for  un‐
44marshalling the reply.
45
46       [1mEFAULT        [4m[22mgids[24m or [4mgroupnames[24m is a
47NULL pointer.
48
49       [1mEINVAL       [4m[22mnbgroups[24m is not strictly  posi‐
50tive or one of the gids  does
51                    not exist in the internal mapping table.
52
53       [1mSENOSHOST    [22mHost unknown.
54
55       [1mSENOSSERV    [22mService unknown.
56
57       [1mSECOMERR     [22mCommunication error.
58
59       [1mENSNACT      [22mName server is not running or is being
60shutdown.
61
62
63
64DPNS                     $Date:  2007/03/21  10:24:15  $      DP‐
65NS_GETGRPBYGIDS(3)
66
Impressum