Gets a group database entry for a name.

    This function is OpenVMS Alpha and Integrity servers only.

    Format

      #include  <types.h>

      #include  <grp.h>

      int getgrnam_r  (const char *name, struct group *grp,
                      char *buffer, size_t bufsize, struct group
                      **result);

1  –  Arguments

 name

    The group name of the group for which the group database entry is
    to be retrieved.

 grp

    Storage area to hold the retrieved group structure.

 buffer

    The working buffer that is able to hold the longest group entry
    in the database.

 bufsize

    The length, in characters, of buffer.

 result

    Upon successful return, result points to the retrieved group
    structure.

    Upon unsuccessful return, result is set to NULL.

2  –  Description

    The getgrnam_r function updates the group structure pointed to
    by grp and stores a pointer to that structure at the location
    pointed to by result. The structure contains an entry from the
    group database with a matching name. Storage referenced by the
    group structure is allocated from the memory provided with the
    buffer argument, which is bufsize characters in size. The maximum
    size needed for this buffer can be determined with the _SC_GETGR_
    R_SIZE_MAX parameter of the sysconf function. On error or if the
    requested entry is not found, a NULL pointer is returned at the
    location pointed to by result.

3  –  Return Values

    0                  Successful completion.
    x                  On error, the function sets the return value
                       to one of the following:

                       o  EACCES - The user process does not have
                          appropriate privileges enabled to access
                          the user authorization file.

                       o  EIO - An I/O error has occurred.

                       o  EINTR - A signal was intercepted during
                          getgrnam.

                       o  EMFILE - OPEN_MAX file descriptors are
                          currently open in the calling process.

                       o  ENFILE - The maximum allowable number of
                          files is currently open in the system.

                       o  ERANGE - Insufficient storage was supplied
                          through the buffer and bufsize arguments
                          to contain the data to be referenced by the
                          resulting group structure.