1PAM_SM_AUTHENTICATE(3)         Linux-PAM Manual         PAM_SM_AUTHENTICATE(3)
2
3
4

NAME

6       pam_sm_authenticate - PAM service function for user authentication
7

SYNOPSIS

9       #define PAM_SM_AUTH
10
11       #include <security/pam_modules.h>
12
13       PAM_EXTERN int pam_sm_authenticate(pam_handle_t *pamh, int flags,
14                                          int argc, const char **argv);
15

DESCRIPTION

17       The pam_sm_authenticate function is the service module's implementation
18       of the pam_authenticate(3) interface.
19
20       This function performs the task of authenticating the user.
21
22       Valid flags, which may be logically OR'd with PAM_SILENT, are:
23
24       PAM_SILENT
25          Do not emit any messages.
26
27       PAM_DISALLOW_NULL_AUTHTOK
28          Return PAM_AUTH_ERR if the database of authentication tokens for
29          this authentication mechanism has a NULL entry for the user. Without
30          this flag, such a NULL token will lead to a success without the user
31          being prompted.
32

RETURN VALUES

34       PAM_AUTH_ERR
35          Authentication failure.
36
37       PAM_CRED_INSUFFICIENT
38          For some reason the application does not have sufficient credentials
39          to authenticate the user.
40
41       PAM_AUTHINFO_UNAVAIL
42          The modules were not able to access the authentication information.
43          This might be due to a network or hardware failure etc.
44
45       PAM_SUCCESS
46          The authentication token was successfully updated.
47
48       PAM_USER_UNKNOWN
49          The supplied username is not known to the authentication service.
50
51       PAM_MAXTRIES
52          One or more of the authentication modules has reached its limit of
53          tries authenticating the user. Do not try again.
54

SEE ALSO

56       pam(3), pam_authenticate(3), pam_sm_setcred(3), pam_strerror(3), PAM(8)
57
58
59
60Linux-PAM Manual                  06/27/2006            PAM_SM_AUTHENTICATE(3)
Impressum