1DPNS_GETGRPBYNAM(3)          DPNS  Library  Functions         DP‐
2NS_GETGRPBYNAM(3)
3
4
5
6[1mNAME[0m
7       dpns_getgrpbynam ‐ get virtual gid associated with a given
8group name
9
10[1mSYNOPSIS[0m
11       [1m#include <sys/types.h>[0m
12       [1m#include "dpns_api.h"[0m
13
14       [1mint  dpns_getgrpbynam  (char  *[4m[22mgroupname[24m[1m,
15gid_t *[4m[22mgid[24m[1m)[0m
16
17[1mDESCRIPTION[0m
18       [1mdpns_getgrpbynam  [22mgets  the  virtual  gid associat‐
19ed with a given group
20       name.
21
22       [4mgroupname[0m
23              specifies  the  group  name.   It must be  at  most
24255  characters
25              long.
26
27       [4mgid[24m    specifies  the  address of a buffer  to  re‐
28ceive the Virtual Group
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[22mgroupname[24m  or  [4mgid[24m is a
39NULL pointer.
40
41       [1mEINVAL       [22mThis group name does not exist in  the
42internal mapping ta‐
43                    ble or the length of [4mgroupname[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_GETGRPBYNAM(3)
59
60
61
62
63
64
65
66
Impressum