1.\" Generated from pam_sm_authenticate.c by gendoc.pl
2.\" $Id: pam_sm_authenticate.c 648 2013-03-05 17:54:27Z des $
3.Dd February 19, 2017
4.Dt PAM_SM_AUTHENTICATE 3
5.Os
6.Sh NAME
7.Nm pam_sm_authenticate
8.Nd service module implementation for pam_authenticate
9.Sh SYNOPSIS
10.In sys/types.h
11.In security/pam_appl.h
12.In security/pam_modules.h
13.Ft "int"
14.Fn pam_sm_authenticate "pam_handle_t *pamh" "int flags" "int argc" "const char **argv"
15.Sh DESCRIPTION
16The
17.Fn pam_sm_authenticate
18function is the service module's
19implementation of the
20.Xr pam_authenticate 3
21API function.
22.Sh RETURN VALUES
23The
24.Fn pam_sm_authenticate
25function returns one of the following values:
26.Bl -tag -width 18n
27.It Bq Er PAM_ABORT
28General failure.
29.It Bq Er PAM_AUTHINFO_UNAVAIL
30Authentication information is unavailable.
31.It Bq Er PAM_AUTH_ERR
32Authentication error.
33.It Bq Er PAM_BUF_ERR
34Memory buffer error.
35.It Bq Er PAM_CONV_ERR
36Conversation failure.
37.It Bq Er PAM_CRED_INSUFFICIENT
38Insufficient credentials.
39.It Bq Er PAM_IGNORE
40Ignore this module.
41.It Bq Er PAM_MAXTRIES
42Maximum number of tries exceeded.
43.It Bq Er PAM_PERM_DENIED
44Permission denied.
45.It Bq Er PAM_SERVICE_ERR
46Error in service module.
47.It Bq Er PAM_SYSTEM_ERR
48System error.
49.It Bq Er PAM_USER_UNKNOWN
50Unknown user.
51.El
52.Sh SEE ALSO
53.Xr pam 3 ,
54.Xr pam_authenticate 3 ,
55.Xr pam_strerror 3
56.Sh STANDARDS
57.Rs
58.%T "X/Open Single Sign-On Service (XSSO) - Pluggable Authentication Modules"
59.%D "June 1997"
60.Re
61.Sh AUTHORS
62The
63.Fn pam_sm_authenticate
64function and this manual page were
65developed for the
66.Fx
67Project by ThinkSec AS and Network Associates Laboratories, the
68Security Research Division of Network Associates, Inc.\& under
69DARPA/SPAWAR contract N66001-01-C-8035
70.Pq Dq CBOSS ,
71as part of the DARPA CHATS research program.
72.Pp
73The OpenPAM library is maintained by
74.An Dag-Erling Sm\(/orgrav Aq Mt des@des.no .
75