NAME    [Toc]    [Back]

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

SYNOPSIS    [Toc]    [Back]

       #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    [Toc]    [Back]

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

PARAMETERS    [Toc]    [Back]

       The  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 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.

DESCRIPTION    [Toc]    [Back]

   siad_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 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  (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  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    [Toc]    [Back]

       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    [Toc]    [Back]

       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    [Toc]    [Back]

       /etc/group

       /etc/sia/matrix.conf

SEE ALSO    [Toc]    [Back]

       sia_getgroup(3), matrix.conf(4)

       Security



                                                 siad_getgrent(3)