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

NAME

6       dpns_getgrpbynam - get virtual gid associated with a given group name
7

SYNOPSIS

9       #include <sys/types.h>
10       #include "dpns_api.h"
11
12       int dpns_getgrpbynam (char *groupname, gid_t *gid)
13

DESCRIPTION

15       dpns_getgrpbynam  gets  the  virtual  gid associated with a given group
16       name.
17
18       groupname
19              specifies the group name.  It must be  at  most  255  characters
20              long.
21
22       gid    specifies  the  address of a buffer to receive the Virtual Group
23              Id.
24

RETURN VALUE

26       This routine returns 0 if the operation was successful  or  -1  if  the
27       operation failed. In the latter case, serrno is set appropriately.
28

ERRORS

30       EFAULT       groupname or gid is a NULL pointer.
31
32       EINVAL       This group name does not exist in the internal mapping ta‐
33                    ble or the length of groupname exceeds 255.
34
35       SENOSHOST    Host unknown.
36
37       SENOSSERV    Service unknown.
38
39       SECOMERR     Communication error.
40
41       ENSNACT      Name server is not running or is being shutdown.
42
43
44
45DPNS                     $Date: 2005/10/19 11:30:57 $      DPNS_GETGRPBYNAM(3)
Impressum