Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

sia_getgroup(3) [osf1 man page]

sia_getpasswd(3)					     Library Functions Manual						  sia_getpasswd(3)

NAME
sia_getpasswd, sia_getgroup - interface to the getpw* and getgr* routines for SIA (Security Integration Architecture) LIBRARY
Standard C library (libc.so and libc.a) SYNOPSIS
#include <sia.h> #include <siad.h> int sia_getpasswd( int function, int reentrant, union sia_get_params *params); int sia_getgroup( int function, int reentrant, union sia_get_params *params); PARAMETERS
function The function parameter is a subfunction selection code as defined by P_SET in the siad.h file. reentrant The reentrant parameter is a flag which is either REENTRANT (1) or NON_REENTRANT (0). NON_REENTRANT indicates that the result and buffer pointers passed in the params arguments will be returned pointing to static data. REENTRANT indicates that result and buffer are used as passed (caller provided storage). params The sia_get_params is defined as follows: typedef struct { char *name; gid_t gid; struct group *result; char *buffer; int len; int pkgind; } group_params; typedef struct { char *name; uid_t uid; struct passwd *result; char *buffer; int len; int pkgind; } passwd_params; union sia_get_params { group_params group; passwd_params passwd; }; DESCRIPTION
The sia_getpasswd() routine provides thread locking for the libc_r routines (-D_THREAD_SAFE), provides static storage for non reentrant getpw* routines, and calls the appropriate siad_getpw* routine. This routine is called by getpwnam(), getpwnam_r(), getpwuid(), getp- wuid_r(), getpwent(), and getpwent_r(). The sia_getgroup() routine provides thread locking for libc_r routines (-D_THREAD_SAFE), provide static storage for non reentrant getgr* routines, and calls the appropriate siad_getgr* routine. This routine is called by getgrnam(), getgrnam_r(), getgrgid(), getgrgid_r(), getgrent(), and getgrent_r(). RETURN VALUES
The sia_getgroup() and sia_getpasswd() routines return either SIASUCCESS or SIAFAIL. ERRORS
The errno value is not (normally) set explicitly by sia_* routines. The errno values are those returned from the dynamic loader interface, from dependent (siad_*) routines, or from malloc. Possible errors include resource constraints (no memory) and various authentication failures. FILES
/etc/group /etc/passwd /etc/sia/matrix.conf RELATED INFORMATION
getgrent(3), getpwent(3), matrix.conf(4) Security delim off sia_getpasswd(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)
Man Page