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