1PAM_SM_AUTHENTICATE(3) Linux-PAM Manual PAM_SM_AUTHENTICATE(3)
2
3
4
6 pam_sm_authenticate - PAM service function for user authentication
7
9 #include <security/pam_modules.h>
10
11 int pam_sm_authenticate(pam_handle_t *pamh, int flags, int argc,
12 const char **argv);
13
15 The pam_sm_authenticate function is the service module's implementation
16 of the pam_authenticate(3) interface.
17
18 This function performs the task of authenticating the user.
19
20 Valid flags, which may be logically OR'd with PAM_SILENT, are:
21
22 PAM_SILENT
23 Do not emit any messages.
24
25 PAM_DISALLOW_NULL_AUTHTOK
26 Return PAM_AUTH_ERR if the database of authentication tokens for
27 this authentication mechanism has a NULL entry for the user.
28 Without this flag, such a NULL token will lead to a success without
29 the user being prompted.
30
32 PAM_AUTH_ERR
33 Authentication failure.
34
35 PAM_CRED_INSUFFICIENT
36 For some reason the application does not have sufficient
37 credentials to authenticate the user.
38
39 PAM_AUTHINFO_UNAVAIL
40 The modules were not able to access the authentication information.
41 This might be due to a network or hardware failure etc.
42
43 PAM_SUCCESS
44 The authentication token was successfully updated.
45
46 PAM_USER_UNKNOWN
47 The supplied username is not known to the authentication service.
48
49 PAM_MAXTRIES
50 One or more of the authentication modules has reached its limit of
51 tries authenticating the user. Do not try again.
52
54 pam(3), pam_authenticate(3), pam_sm_setcred(3), pam_strerror(3), PAM(8)
55
56
57
58Linux-PAM Manual 11/25/2020 PAM_SM_AUTHENTICATE(3)