Section: Linux-PAM Manual (3)
pam_sm_authenticate - PAM service function for user authentication
int pam_sm_authenticate(pam_handle_t *pamh, int flags, int argc, const char **argv);
function is the service module's implementation of the
This function performs the task of authenticating the user.
Valid flags, which may be logically OR'd with
Do not emit any messages.
if the database of authentication tokens for this authentication mechanism has a
entry for the user. Without this flag, such a
token will lead to a success without the user being prompted.
For some reason the application does not have sufficient credentials to authenticate the user.
The modules were not able to access the authentication information. This might be due to a network or hardware failure etc.
The authentication token was successfully updated.
The supplied username is not known to the authentication service.
One or more of the authentication modules has reached its limit of tries authenticating the user. Do not try again.