siad_getgrent(3)siad_getgrent(3)NAME
siad_getgrent, siad_getgrgid, siad_getgrnam, siad_setgrent, siad_end‐
grent - group routines for SIA (Security Integration Architecture)
SYNOPSIS
#include <sia.h> #include <siad.h>
int siad_getgrent(
struct group *result,
char *buffer,
int buflen,
FILE **context ); int siad_getgrgid(
gid_t gid,
struct group *result,
char *buffer,
int buflen ); int siad_getgrnam(
char *name,
struct group *result,
char *buffer,
int buflen ); int siad_setgrent(
FILE **context ); int siad_endgrent(
FILE **context );
LIBRARY
Standard C library (libc.so and libc.a)
PARAMETERS
The result parameter is used to provide a result. The actual result
string is placed in the buffer provided and result points to the resul‐
tant struct group in the buffer. Values in the passwd structure may be
changed by the siad_*gr* routines. The buffer parameter is a pointer
to a buffer which holds the resultant struct group. This parameter is
read only. The buflen parameter is the length of the buffer in chars.
This parameter is read only. The gid parameter is the group identifier
(GID) for the request. This parameter is read only. The name parameter
specifies the group name for the request. This parameter is read only.
A pointer to the location that records which I/O stream is to be used.
DESCRIPTIONsiad_getgrent()
The siad_getgrent() routine is called indirectly (by the sia_switch()
function) from the sia_getgroup() routine which is called from the libc
and libc_r routines getgrent() and getgrent_r() respectively. The buf‐
fer 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 (by the sia_switch() function) 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 (by the sia_switch function) from the
sia_getgroup() routine which is called from the libc and libc_r rou‐
tines 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 ini‐
tialize a series of getgrent calls.
siad_endgrent()
This routine is called to close or complete the processing of a get‐
grent() series of calls.
RETURN VALUES
The siad_*gr*() routines return bitmapped values which indicate the
following status: Indicates unconditional success. All bits set to 0.
Indicates conditional failure. Lowest bit set to 1. If other security
mechanism are in place, continue. Indicates 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
SEE ALSOsia_getgroup(3), matrix.conf(4)
Security
siad_getgrent(3)