pam_sm_authenticate - PAM service function for user authentication
int flags, int argc,
const char **argv);
The pam_sm_authenticate function is the service module's implementation
of the pam_authenticate(3) interface.
This function performs the task of authenticating the user.
Valid flags, which may be logically OR'd with PAM_SILENT,
Do not emit any messages.
Return PAM_AUTH_ERR if the database of
authentication tokens for this authentication mechanism has a NULL
entry for the user. Without this flag, such a NULL 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
One or more of the authentication modules has reached its
limit of tries authenticating the user. Do not try again.