The pam_authenticate function is used to authenticate the user. The
user is required to provide an authentication token depending upon
the authentication service, usually this is a password, but could
also be a finger print.
The PAM service module may request that the user enter their username
via the conversation mechanism (see pam_start(3) and pam_conv(3)).
The name of the authenticated user will be present in the PAM item
PAM_USER. This item may be recovered with a call to pam_get_item(3).
The pamh argument is an authentication handle obtained by a prior
call to pam_start(). The flags argument is the binary or of zero or
more of the following values:
Do not emit any messages.
The PAM module service should return PAM_AUTH_ERR if the user
does not have a registered authentication token.
The application should exit immediately after calling pam_end(3)
The user was not authenticated.
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
One or more of the authentication modules has reached its limit
of tries authenticating the user. Do not try again.
The user was successfully authenticated.
User unknown to authentication service.
This page is part of the linux-pam (Pluggable Authentication Modules
for Linux) project. Information about the project can be found at
⟨https://fedorahosted.org/linux-pam/⟩. If you have a bug report for
this manual page, see ⟨https://fedorahosted.org/linux-pam/report⟩.
This page was obtained from the tarball Linux-PAM-1.3.0.tar.gz
fetched from ⟨http://www.linux-pam.org/library/⟩ on 2017-03-13. If
you discover any rendering problems in this HTML version of the page,
or you believe there is a better or more up-to-date source for the
page, or you have corrections or improvements to the information in
this COLOPHON (which is not part of the original manual page), send a
mail to firstname.lastname@example.org
Linux-PAM Manual 04/01/2016 PAM_AUTHENTICATE(3)