siad_endgrent(3) [osf1 man page]

siad_getgrent(3)					     Library Functions Manual						  siad_getgrent(3)

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,
	       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);

PARAMETERS

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

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

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

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

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

       context	 A pointer to the location that records which I/O stream is to be used.

DESCRIPTION

   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

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

       SIADSUCCESS     Indicates unconditional success. All bits set to 0.

       SIADFAIL        Indicates conditional failure. Lowest bit set to 1.  If other security mechanism are in place, continue.

       SIADSTOP        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

RELATED INFORMATION

       sia_getgroup(3), matrix.conf(4)

       Security delim off

																  siad_getgrent(3)

Check Out this Related Man Page

siad_getpwent(3)					     Library Functions Manual						  siad_getpwent(3)

NAME

       siad_getpwent, siad_getpwuid, siad_getpwnam, siad_setpwent, siad_endpwent - password routines for SIA (Security Integration Architecture)

LIBRARY

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

SYNOPSIS

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

       int siad_getpwent(
	    struct passwd *result,
	    char *buffer,
	    int buflen,
	    FILE **context);

       int siad_getpwuid(
	    uid_t   uid,
	    struct passwd *result,
	    char *buffer,
	    int buflen);

       int siad_getpwnam(
	    char   *name,
	    struct passwd *result,
	    char *buffer,
	    int buflen);

       int siad_setpwent(
	    FILE **context);

       int siad_endpwent(
	    FILE **context);

PARAMETERS

       result	 The result parameter points to the location of the result.

       buffer	 The buffer parameter is a pointer to a buffer which holds the resultant struct passwd.  This parameter is read only.

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

       uid	 The uid parameter is the user identifier (UID) for the request.  This parameter are read only.

       name	 The name parameter is the user name for the request.  This parameter are read only.

       context	 A pointer to the location that records which I/O stream is to be used.

DESCRIPTION

       This series of mechanism dependent routines is used access the corresponding getpw* series of calls.  The actual result string is placed in
       the buffer provided and result points to the resultant struct passwd in the buffer.  Values in the passwd structure may be changed  by  the
       siad_*pw* routines.

   siad_getpwent()
       The  siad_getpwent  routine is called indirectly (by the sia_switch function) from the sia_getpass() routine to do libc and libc_r getpwent
       and getpwent_r processing.  The result buffer is always allocated and a lock is taken out when thread safety is required.

   siad_getpwuid()
       This routine is called indirectly (by the sia_switch function) by sia_getpass() to process libc	and  libc_r  getpwuid()  and  getpwuid_r()
       requests.

   siad_getpwnam()
       This  routine  is  called indirectly (by the sia_switch function) by sia_getpass to process the libc and libc_r getpwnam() and getpwnam_r()
       requests.

   siad_setpwent()
       This routine is called to initialize a series of getpwent calls.  Such initialization might be the opening of a file or the contacting of a
       service.

   siad_endpwent()
       This routine is called to free up or release resources associated with the completion of a series of getpwent calls.

RETURN VALUES

       The siad_*pw*() routines return bitmapped values which indicate the following status:

       SIADSUCCESS     Indicates unconditional success. All bits set to 0.

       SIADFAIL        Indicates conditional failure. Lowest bit set to 1.  If other security mechanism are in place, continue.

       SIADSTOP        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/passwd

       /etc/sia/matrix.conf

RELATED INFORMATION

       getpwent(3), matrix.conf(4)

       Security delim off

																  siad_getpwent(3)

Linux and UNIX Man Pages

siad_endgrent(3) [osf1 man page]

Check Out this Related Man Page