1 .\" Generated from pam_authenticate.c by gendoc.pl
2 .\" $Id: pam_authenticate.c 648 2013-03-05 17:54:27Z des $
8 .Nd perform authentication within the PAM framework
11 .In security/pam_appl.h
13 .Fn pam_authenticate "pam_handle_t *pamh" "int flags"
17 function attempts to authenticate the user
18 associated with the pam context specified by the
22 The application is free to call
25 wishes, but some modules may maintain an internal retry counter and
28 when it exceeds some preset or hardcoded limit.
32 argument is the binary or of zero or more of the following
36 Do not emit any messages.
37 .It Dv PAM_DISALLOW_NULL_AUTHTOK
38 Fail if the user's authentication token is null.
41 If any other bits are set,
48 function returns one of the following values:
52 .It Bq Er PAM_AUTHINFO_UNAVAIL
53 Authentication information is unavailable.
54 .It Bq Er PAM_AUTH_ERR
58 .It Bq Er PAM_CONV_ERR
60 .It Bq Er PAM_CRED_INSUFFICIENT
61 Insufficient credentials.
62 .It Bq Er PAM_MAXTRIES
63 Maximum number of tries exceeded.
64 .It Bq Er PAM_PERM_DENIED
66 .It Bq Er PAM_SERVICE_ERR
67 Error in service module.
68 .It Bq Er PAM_SYMBOL_ERR
70 .It Bq Er PAM_SYSTEM_ERR
72 .It Bq Er PAM_USER_UNKNOWN
80 .%T "X/Open Single Sign-On Service (XSSO) - Pluggable Authentication Modules"
86 function and this manual page were
89 Project by ThinkSec AS and Network Associates Laboratories, the
90 Security Research Division of Network Associates, Inc.\& under
91 DARPA/SPAWAR contract N66001-01-C-8035
93 as part of the DARPA CHATS research program.
95 The OpenPAM library is maintained by
96 .An Dag-Erling Sm\(/orgrav Aq Mt des@des.no .