:man| Alphabetical   Categories   About us 
 
PAM_AUTHENTICATE (3) | C library functions | Unix Manual Pages | :man

NAME

pam_authenticate - perform authentication within the PAM framework

CONTENTS

Library
Synopsis
Description
Return Values
See Also
Standards
Authors

LIBRARY


.Lb libpam

SYNOPSIS


.In sys/types.h
.In security/pam_appl.h "int" pam_authenticate "pam_handle_t *pamh" "int flags"

DESCRIPTION

The pam_authenticate function attempts to authenticate the user associated with the pam context specified by the pamh argument.

The application is free to call pam_authenticate as many times as it wishes, but some modules may maintain an internal retry counter and return PAM_MAXTRIES when it exceeds some preset or hardcoded limit.

The flags argument is the binary or of zero or more of the following values:

PAM_SILENT
Do not emit any messages.
PAM_DISALLOW_NULL_AUTHTOK
Fail if the user’s authentication token is null.

If any other bits are set, pam_authenticate will return PAM_SYMBOL_ERR.

RETURN VALUES

The pam_authenticate function returns one of the following values:
[PAM_ABORT]
General failure.
[PAM_AUTHINFO_UNAVAIL]
Authentication information is unavailable.
[PAM_AUTH_ERR]
Authentication error.
[PAM_BUF_ERR]
Memory buffer error.
[PAM_CONV_ERR]
Conversation failure.
[PAM_CRED_INSUFFICIENT]
Insufficient credentials.
[PAM_MAXTRIES]
Maximum number of tries exceeded.
[PAM_PERM_DENIED]
Permission denied.
[PAM_SERVICE_ERR]
Error in service module.
[PAM_SYMBOL_ERR]
Invalid symbol.
[PAM_SYSTEM_ERR]
System error.
[PAM_USER_UNKNOWN]
Unknown user.

SEE ALSO

pam(3), pam_strerror(3)

STANDARDS

AUTHORS


Share this page

     Follow us

Facebook Twitter Google+ LinkedIn


 
Created by Blin Media, 2008-2013