pam_authenticate
- perform authentication within the PAM framework
LIBRARY
Lb libpam
SYNOPSIS
#include <sys/types.h>
#include <security/pam_appl.h> int
pam_authenticate (pam_handle_t *pamh int flags);
DESCRIPTION
The
function attempts to authenticate the user
associated with the pam context specified by the
Fa pamh
argument.
The application is free to call
as many times as it
wishes, but some modules may maintain an internal retry counter and
return
PAM_MAXTRIES
when it exceeds some preset or hardcoded limit.
The
Fa flags
argument is the binary or of zero or more of the following
values:
PAM_SILENT
Do not emit any messages.
PAM_DISALLOW_NULL_AUTHTOK
Fail if the user's authentication token is null.
If any other bits are set,
will return
PAM_SYMBOL_ERR
"X/Open Single Sign-On Service (XSSO) - Pluggable Authentication Modules"
"June 1997"
AUTHORS
The
function and this manual page were developed for the
Fx Project by ThinkSec AS and Network Associates Laboratories, the
Security Research Division of Network Associates, Inc. under
DARPA/SPAWAR contract N66001-01-C-8035
(``CBOSS''
)
as part of the DARPA CHATS research program.
