pam_authenticate − account authentication

#include <security/pam_appl.h>

int pam_authenticate(pam_handle_t *pamh, int flags);


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 vio the 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) first.


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 etc.


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.

(3), pam_setcred(3), pam_chauthtok(3), pam_strerror(3), pam(8)

More Linux Commands

gnutls_transport_get_ptr2(3) - API function - Linux man page
Used to get the arguments of the transport functions (like PUSH and PULL). These should have been set using gnutls_transport_set_ptr2(). REPORTING BUGS Report b

instmodsh(1) - A shell to examine installed modules.........
A little interface to ExtUtils::Installed to examine installed modules, validate your packlists and even create a tarball from an installed module. SEE ALSO Ext

gvfs-mkdir(1) Create directories (Commands - Linux man page)
gvfs-mkdir creates directories. gvfs-mkdir is similar to the traditional mkdir utility, but using gvfs locations instead of local files: for example you can use

pnmmercator(1) - transform a worldmap from rectangular proje
This program is part of Netpbm(1) The pnmmercator utility, converts a rectangular projection worldmap to a Mercator projection format, as used for maps.no_googl

color_content_sp(3ncurses) - curses screen-pointer extension
This implementation can be configured to provide a set of functions which improve the ability to manage multiple screens. This feature can be added to any of th

Tcl_WriteRaw(3) - buffered I/O facilities using channels....
The Tcl channel mechanism provides a device-independent and platform-independent mechanism for performing buffered input and output operations on a variety of f

filter_sp(3ncurses) - curses screen-pointer extension.......
This implementation can be configured to provide a set of functions which improve the ability to manage multiple screens. This feature can be added to any of th

hpsa(4) - HP Smart Array SCSI driver - Linux manual page....
hpsa is a SCSI driver for HP Smart Array RAID controllers. Options hpsa_allow_any=1: This option allows the driver to attempt to operate on any HP Smart Array h

mknodat(2) - create a special or ordinary file relative to a
The system call mknod() creates a filesystem node (file, device special file, or named pipe) named pathname, with attributes specified by mode and dev. The mode

glIndexMask(3gl) - control the writing of individual bits in
glIndexMask controls the writing of individual bits in the color index buffers. The least significant $n$ bits of mask, where $n$ is the number of bits in a col

Tcl_GetChannelBufferSize(3) - procedures for creating and ma
Tcl uses a two-layered channel architecture. It provides a generic upper layer to enable C and Tcl programs to perform input and output using the same APIs for

gnutls_psk_free_server_credentials(3) - API function........
gnutls_psk_free_server_credentials.3 - This structure is complex enough to manipulate directly thus this helper function is provided in order to free (deallocat

We can't live, work or learn in freedom unless the software we use is free.