xref: /netbsd-src/external/bsd/openpam/dist/doc/man/pam_sm_authenticate.3 (revision 0d9d0fd8a30be9a1924e715bbcf67a4a83efd262)
1*0d9d0fd8Schristos.\"	$NetBSD: pam_sm_authenticate.3,v 1.9 2023/06/30 21:46:20 christos Exp $
244269bb5Schristos.\"
38fa0fefeSchristos.\" Generated from pam_sm_authenticate.c by gendoc.pl
4*0d9d0fd8Schristos.Dd June 27, 2023
544269bb5Schristos.Dt PAM_SM_AUTHENTICATE 3
644269bb5Schristos.Os
744269bb5Schristos.Sh NAME
844269bb5Schristos.Nm pam_sm_authenticate
944269bb5Schristos.Nd service module implementation for pam_authenticate
1044269bb5Schristos.Sh SYNOPSIS
1144269bb5Schristos.In sys/types.h
1244269bb5Schristos.In security/pam_appl.h
1344269bb5Schristos.In security/pam_modules.h
1444269bb5Schristos.Ft "int"
1544269bb5Schristos.Fn pam_sm_authenticate "pam_handle_t *pamh" "int flags" "int argc" "const char **argv"
1644269bb5Schristos.Sh DESCRIPTION
1744269bb5SchristosThe
18e1b25b17Schristos.Fn pam_sm_authenticate
1944269bb5Schristosfunction is the service module's
2044269bb5Schristosimplementation of the
2144269bb5Schristos.Xr pam_authenticate 3
2244269bb5SchristosAPI function.
2344269bb5Schristos.Sh RETURN VALUES
2444269bb5SchristosThe
25e1b25b17Schristos.Fn pam_sm_authenticate
2644269bb5Schristosfunction returns one of the following values:
2744269bb5Schristos.Bl -tag -width 18n
284cb4af11Schristos.It Bq Er PAM_SUCCESS
294cb4af11SchristosSuccess.
3044269bb5Schristos.It Bq Er PAM_ABORT
3144269bb5SchristosGeneral failure.
3244269bb5Schristos.It Bq Er PAM_AUTHINFO_UNAVAIL
3344269bb5SchristosAuthentication information is unavailable.
3444269bb5Schristos.It Bq Er PAM_AUTH_ERR
3544269bb5SchristosAuthentication error.
3644269bb5Schristos.It Bq Er PAM_BUF_ERR
3744269bb5SchristosMemory buffer error.
3844269bb5Schristos.It Bq Er PAM_CONV_ERR
3944269bb5SchristosConversation failure.
4044269bb5Schristos.It Bq Er PAM_CRED_INSUFFICIENT
4144269bb5SchristosInsufficient credentials.
4244269bb5Schristos.It Bq Er PAM_IGNORE
4344269bb5SchristosIgnore this module.
4444269bb5Schristos.It Bq Er PAM_MAXTRIES
4544269bb5SchristosMaximum number of tries exceeded.
4644269bb5Schristos.It Bq Er PAM_PERM_DENIED
4744269bb5SchristosPermission denied.
4844269bb5Schristos.It Bq Er PAM_SERVICE_ERR
4944269bb5SchristosError in service module.
5044269bb5Schristos.It Bq Er PAM_SYSTEM_ERR
5144269bb5SchristosSystem error.
5244269bb5Schristos.It Bq Er PAM_USER_UNKNOWN
5344269bb5SchristosUnknown user.
5444269bb5Schristos.El
5544269bb5Schristos.Sh SEE ALSO
5644269bb5Schristos.Xr pam 3 ,
5744269bb5Schristos.Xr pam_authenticate 3 ,
5844269bb5Schristos.Xr pam_strerror 3
5944269bb5Schristos.Sh STANDARDS
6044269bb5Schristos.Rs
6144269bb5Schristos.%T "X/Open Single Sign-On Service (XSSO) - Pluggable Authentication Modules"
6244269bb5Schristos.%D "June 1997"
6344269bb5Schristos.Re
6444269bb5Schristos.Sh AUTHORS
6544269bb5SchristosThe
66e1b25b17Schristos.Fn pam_sm_authenticate
67e1b25b17Schristosfunction and this manual page were
68e1b25b17Schristosdeveloped for the
6944269bb5Schristos.Fx
70e1b25b17SchristosProject by ThinkSec AS and Network Associates Laboratories, the
7144269bb5SchristosSecurity Research Division of Network Associates, Inc.\& under
7244269bb5SchristosDARPA/SPAWAR contract N66001-01-C-8035
7344269bb5Schristos.Pq Dq CBOSS ,
7444269bb5Schristosas part of the DARPA CHATS research program.
758fa0fefeSchristos.Pp
768fa0fefeSchristosThe OpenPAM library is maintained by
774cb4af11Schristos.An Dag-Erling Sm\(/orgrav Aq Mt des@des.no .
78