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.
30           Without this flag, such a NULL token will lead to a success without
31           the user 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
39           credentials 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                  03/02/2009            PAM_SM_AUTHENTICATE(3)
Impressum