NAME

siad_getgrent, siad_getgrgid, siad_getgrnam, siad_setgrent, siad_endgrent − group routines for SIA (Security Integration Architecture)

LIBRARY

Standard C library (libc.so and libc.a)

SYNOPSIS

#include <sia.h>
#include <siad.h>

int siad_getgrent(
struct group ∗result,
char ∗buffer,
int buflen,
        struct sia_context ∗context);

int siad_getgrgid(
gid_t   gid,
struct group ∗result,
char ∗buffer,
int buflen,
struct sia_context ∗context);

int siad_getgrnam(
char   ∗name,
struct group ∗result,
char ∗buffer,
int buflen
struct sia_context ∗context);

int siad_setgrent(
        struct sia_context ∗context);

int siad_endgrent(
        struct sia_context ∗context);

PARAMETERS

resultThe result parameter is used to provide a result. The actual result string is placed in the buffer provided and result points to the resultant struct group in the buffer.  Values in the group structure may be changed by the siad_∗gr∗ routines. 

bufferThe buffer parameter is a pointer to a buffer which holds the resultant struct group.  This parameter is read only. 

buflenThe buflen parameter is the length of the buffer in  chars.  This parameter are read only. 

gidThe gid parameter is the group identifier (GID) for the request.  This parameter are read only. 

nameThe name parameter specifies the group name for the request.  This parameter are read only. 

contextA pointer to the strucure used to maintain state. 

DESCRIPTION

siad_getgrent()

The siad_getgrent routine is called indirectly from the sia_getgroup() routine which is called from the libc and libc_r routines getgrent() and getgrent_r() respectively. The buffer for the group information is  preallocated and a thread lock has been taken in the thread safe mode. 

siad_getgrgid()

This routine is called indirectly from the sia_getgroup() routine which is called from the libc and libc_r routines getgrgid and getgrgid_r respectively. The buffer for the group information is preallocated and a thread lock has been taken in the thread safe mode. 

siad_getgrnam()

This routine is called indirectly from the sia_getgroup() routine which is called from the libc and libc_r routines getgrnam and getgrnam_r respectively.  The buffer for the group information is preallocated and a thread lock has been taken in the thread safe mode. 

siad_setgrent()

This routine is called by the sia_getgroup() routine to start or initialize a series of getgrent calls. 

siad_endgrent()

This routine is called to close or complete the processing of a getgrent() series of calls. 

RETURN VALUES

The siad_∗gr∗() routines return bitmapped values which indicate the following status:

SIADSUCCESSIndicates unconditional success.  Lowest bit set to 1. 

SIADFAILIndicates conditional failure.  All bits set to 0.  If other security mechanism are in place, continue. 

SIADSTOPIndicates unconditional failure. Do not continue.  Second lowest bit set to 1. 

ERRORS

The errno values are those returned from the dynamic loader interface, from the (siad_∗) routines, or from malloc.  Possible errors include resource constraints (no memory) and various authentication failures. 

FILES

/etc/group

/etc/sia/matrix.conf

RELATED INFORMATION

sia_getgroup(3), matrix.conf(4)

Security