1LFC_GETGRPBYNAM(3)                LFC      Library      Functions
2LFC_GETGRPBYNAM(3)
3
4
5
6[1mNAME[0m
7       lfc_getgrpbynam ‐ get virtual gid associated with a  given
8group name
9
10[1mSYNOPSIS[0m
11       [1m#include <sys/types.h>[0m
12       [1m#include "lfc_api.h"[0m
13
14       [1mint   lfc_getgrpbynam  (char  *[4m[22mgroupname[24m[1m,
15gid_t *[4m[22mgid[24m[1m)[0m
16
17[1mDESCRIPTION[0m
18       [1mlfc_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
57LFC                         $Date:    2005/10/19    11:30:57    $
58LFC_GETGRPBYNAM(3)
59
60
61
62
63
64
65
66
Impressum