Content-type: text/html
Man page of siad_getgrent
siad_getgrent
Section: C Library Functions (3)
Index
Return to Main Contents
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
Index
- NAME
-
- LIBRARY
-
- SYNOPSIS
-
- PARAMETERS
-
- DESCRIPTION
-
- siad_getgrent()
-
- siad_getgrgid()
-
- siad_getgrnam()
-
- siad_setgrent()
-
- siad_endgrent()
-
- RETURN VALUES
-
- ERRORS
-
- FILES
-
- RELATED INFORMATION
-
This document was created by
man2html,
using the manual pages.
Time: 02:42:12 GMT, October 02, 2010