1*0d9d0fd8Schristos.\" $NetBSD: pam_chauthtok.3,v 1.9 2023/06/30 21:46:20 christos Exp $ 244269bb5Schristos.\" 38fa0fefeSchristos.\" Generated from pam_chauthtok.c by gendoc.pl 4*0d9d0fd8Schristos.Dd June 27, 2023 544269bb5Schristos.Dt PAM_CHAUTHTOK 3 644269bb5Schristos.Os 744269bb5Schristos.Sh NAME 844269bb5Schristos.Nm pam_chauthtok 944269bb5Schristos.Nd perform password related functions within the PAM framework 1044269bb5Schristos.Sh SYNOPSIS 1144269bb5Schristos.In sys/types.h 1244269bb5Schristos.In security/pam_appl.h 1344269bb5Schristos.Ft "int" 1444269bb5Schristos.Fn pam_chauthtok "pam_handle_t *pamh" "int flags" 1544269bb5Schristos.Sh DESCRIPTION 1644269bb5SchristosThe 17e1b25b17Schristos.Fn pam_chauthtok 1844269bb5Schristosfunction attempts to change the authentication token 1944269bb5Schristosfor the user associated with the pam context specified by the 2044269bb5Schristos.Fa pamh 2144269bb5Schristosargument. 2244269bb5Schristos.Pp 2344269bb5SchristosThe 2444269bb5Schristos.Fa flags 2544269bb5Schristosargument is the binary or of zero or more of the following 2644269bb5Schristosvalues: 2744269bb5Schristos.Bl -tag -width 18n 2844269bb5Schristos.It Dv PAM_SILENT 2944269bb5SchristosDo not emit any messages. 3044269bb5Schristos.It Dv PAM_CHANGE_EXPIRED_AUTHTOK 3144269bb5SchristosChange only those authentication tokens that have expired. 3244269bb5Schristos.El 3344269bb5Schristos.Pp 3444269bb5SchristosIf any other bits are set, 35e1b25b17Schristos.Fn pam_chauthtok 3644269bb5Schristoswill return 374cb4af11Schristos.Dv PAM_BAD_CONSTANT . 3844269bb5Schristos.Sh RETURN VALUES 3944269bb5SchristosThe 40e1b25b17Schristos.Fn pam_chauthtok 4144269bb5Schristosfunction returns one of the following values: 4244269bb5Schristos.Bl -tag -width 18n 434cb4af11Schristos.It Bq Er PAM_SUCCESS 444cb4af11SchristosSuccess. 4544269bb5Schristos.It Bq Er PAM_ABORT 4644269bb5SchristosGeneral failure. 4744269bb5Schristos.It Bq Er PAM_AUTHTOK_DISABLE_AGING 4844269bb5SchristosAuthentication token aging disabled. 4944269bb5Schristos.It Bq Er PAM_AUTHTOK_ERR 5044269bb5SchristosAuthentication token failure. 5144269bb5Schristos.It Bq Er PAM_AUTHTOK_LOCK_BUSY 5244269bb5SchristosAuthentication token lock busy. 5344269bb5Schristos.It Bq Er PAM_AUTHTOK_RECOVERY_ERR 5444269bb5SchristosFailed to recover old authentication token. 554cb4af11Schristos.It Bq Er PAM_BAD_CONSTANT 564cb4af11SchristosBad constant. 5744269bb5Schristos.It Bq Er PAM_BUF_ERR 5844269bb5SchristosMemory buffer error. 5944269bb5Schristos.It Bq Er PAM_CONV_ERR 6044269bb5SchristosConversation failure. 6144269bb5Schristos.It Bq Er PAM_PERM_DENIED 6244269bb5SchristosPermission denied. 6344269bb5Schristos.It Bq Er PAM_SERVICE_ERR 6444269bb5SchristosError in service module. 6544269bb5Schristos.It Bq Er PAM_SYSTEM_ERR 6644269bb5SchristosSystem error. 6744269bb5Schristos.It Bq Er PAM_TRY_AGAIN 6844269bb5SchristosTry again. 6944269bb5Schristos.El 7044269bb5Schristos.Sh SEE ALSO 7144269bb5Schristos.Xr pam 3 , 7244269bb5Schristos.Xr pam_strerror 3 7344269bb5Schristos.Sh STANDARDS 7444269bb5Schristos.Rs 7544269bb5Schristos.%T "X/Open Single Sign-On Service (XSSO) - Pluggable Authentication Modules" 7644269bb5Schristos.%D "June 1997" 7744269bb5Schristos.Re 7844269bb5Schristos.Sh AUTHORS 7944269bb5SchristosThe 80e1b25b17Schristos.Fn pam_chauthtok 81e1b25b17Schristosfunction and this manual page were 82e1b25b17Schristosdeveloped for the 8344269bb5Schristos.Fx 84e1b25b17SchristosProject by ThinkSec AS and Network Associates Laboratories, the 8544269bb5SchristosSecurity Research Division of Network Associates, Inc.\& under 8644269bb5SchristosDARPA/SPAWAR contract N66001-01-C-8035 8744269bb5Schristos.Pq Dq CBOSS , 8844269bb5Schristosas part of the DARPA CHATS research program. 898fa0fefeSchristos.Pp 908fa0fefeSchristosThe OpenPAM library is maintained by 914cb4af11Schristos.An Dag-Erling Sm\(/orgrav Aq Mt des@des.no . 92