xref: /netbsd-src/external/bsd/openpam/dist/doc/man/pam_sm_chauthtok.3 (revision 0d9d0fd8a30be9a1924e715bbcf67a4a83efd262)
1*0d9d0fd8Schristos.\"	$NetBSD: pam_sm_chauthtok.3,v 1.9 2023/06/30 21:46:20 christos Exp $
244269bb5Schristos.\"
38fa0fefeSchristos.\" Generated from pam_sm_chauthtok.c by gendoc.pl
4*0d9d0fd8Schristos.Dd June 27, 2023
544269bb5Schristos.Dt PAM_SM_CHAUTHTOK 3
644269bb5Schristos.Os
744269bb5Schristos.Sh NAME
844269bb5Schristos.Nm pam_sm_chauthtok
944269bb5Schristos.Nd service module implementation for pam_chauthtok
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_chauthtok "pam_handle_t *pamh" "int flags" "int argc" "const char **argv"
1644269bb5Schristos.Sh DESCRIPTION
1744269bb5SchristosThe
18e1b25b17Schristos.Fn pam_sm_chauthtok
1944269bb5Schristosfunction is the service module's implementation
2044269bb5Schristosof the
2144269bb5Schristos.Xr pam_chauthtok 3
2244269bb5SchristosAPI function.
2344269bb5Schristos.Pp
2444269bb5SchristosWhen the application calls
2544269bb5Schristos.Xr pam_chauthtok 3 ,
2644269bb5Schristosthe service function is
2744269bb5Schristoscalled twice, first with the
2844269bb5Schristos.Dv PAM_PRELIM_CHECK
2944269bb5Schristosflag set and then again
3044269bb5Schristoswith the
3144269bb5Schristos.Dv PAM_UPDATE_AUTHTOK
3244269bb5Schristosflag set.
3344269bb5Schristos.Sh RETURN VALUES
3444269bb5SchristosThe
35e1b25b17Schristos.Fn pam_sm_chauthtok
3644269bb5Schristosfunction returns one of the following values:
3744269bb5Schristos.Bl -tag -width 18n
384cb4af11Schristos.It Bq Er PAM_SUCCESS
394cb4af11SchristosSuccess.
4044269bb5Schristos.It Bq Er PAM_ABORT
4144269bb5SchristosGeneral failure.
4244269bb5Schristos.It Bq Er PAM_AUTHTOK_DISABLE_AGING
4344269bb5SchristosAuthentication token aging disabled.
4444269bb5Schristos.It Bq Er PAM_AUTHTOK_ERR
4544269bb5SchristosAuthentication token failure.
4644269bb5Schristos.It Bq Er PAM_AUTHTOK_LOCK_BUSY
4744269bb5SchristosAuthentication token lock busy.
4844269bb5Schristos.It Bq Er PAM_AUTHTOK_RECOVERY_ERR
4944269bb5SchristosFailed to recover old authentication token.
5044269bb5Schristos.It Bq Er PAM_BUF_ERR
5144269bb5SchristosMemory buffer error.
5244269bb5Schristos.It Bq Er PAM_CONV_ERR
5344269bb5SchristosConversation failure.
5444269bb5Schristos.It Bq Er PAM_IGNORE
5544269bb5SchristosIgnore this module.
5644269bb5Schristos.It Bq Er PAM_PERM_DENIED
5744269bb5SchristosPermission denied.
5844269bb5Schristos.It Bq Er PAM_SERVICE_ERR
5944269bb5SchristosError in service module.
6044269bb5Schristos.It Bq Er PAM_SYSTEM_ERR
6144269bb5SchristosSystem error.
6244269bb5Schristos.It Bq Er PAM_TRY_AGAIN
6344269bb5SchristosTry again.
6444269bb5Schristos.El
6544269bb5Schristos.Sh SEE ALSO
6644269bb5Schristos.Xr pam 3 ,
6744269bb5Schristos.Xr pam_chauthtok 3 ,
6844269bb5Schristos.Xr pam_strerror 3
6944269bb5Schristos.Sh STANDARDS
7044269bb5Schristos.Rs
7144269bb5Schristos.%T "X/Open Single Sign-On Service (XSSO) - Pluggable Authentication Modules"
7244269bb5Schristos.%D "June 1997"
7344269bb5Schristos.Re
7444269bb5Schristos.Sh AUTHORS
7544269bb5SchristosThe
76e1b25b17Schristos.Fn pam_sm_chauthtok
77e1b25b17Schristosfunction and this manual page were
78e1b25b17Schristosdeveloped for the
7944269bb5Schristos.Fx
80e1b25b17SchristosProject by ThinkSec AS and Network Associates Laboratories, the
8144269bb5SchristosSecurity Research Division of Network Associates, Inc.\& under
8244269bb5SchristosDARPA/SPAWAR contract N66001-01-C-8035
8344269bb5Schristos.Pq Dq CBOSS ,
8444269bb5Schristosas part of the DARPA CHATS research program.
858fa0fefeSchristos.Pp
868fa0fefeSchristosThe OpenPAM library is maintained by
874cb4af11Schristos.An Dag-Erling Sm\(/orgrav Aq Mt des@des.no .
88