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