1.\" Generated from pam_sm_chauthtok.c by gendoc.pl 2.\" $OpenPAM: pam_sm_chauthtok.c 938 2017-04-30 21:34:42Z des $ 3.Dd April 30, 2017 4.Dt PAM_SM_CHAUTHTOK 3 5.Os 6.Sh NAME 7.Nm pam_sm_chauthtok 8.Nd service module implementation for pam_chauthtok 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_chauthtok "pam_handle_t *pamh" "int flags" "int argc" "const char **argv" 15.Sh DESCRIPTION 16The 17.Fn pam_sm_chauthtok 18function is the service module's implementation 19of the 20.Xr pam_chauthtok 3 21API function. 22.Pp 23When the application calls 24.Xr pam_chauthtok 3 , 25the service function is 26called twice, first with the 27.Dv PAM_PRELIM_CHECK 28flag set and then again 29with the 30.Dv PAM_UPDATE_AUTHTOK 31flag set. 32.Sh RETURN VALUES 33The 34.Fn pam_sm_chauthtok 35function returns one of the following values: 36.Bl -tag -width 18n 37.It Bq Er PAM_SUCCESS 38Success. 39.It Bq Er PAM_ABORT 40General failure. 41.It Bq Er PAM_AUTHTOK_DISABLE_AGING 42Authentication token aging disabled. 43.It Bq Er PAM_AUTHTOK_ERR 44Authentication token failure. 45.It Bq Er PAM_AUTHTOK_LOCK_BUSY 46Authentication token lock busy. 47.It Bq Er PAM_AUTHTOK_RECOVERY_ERR 48Failed to recover old authentication token. 49.It Bq Er PAM_BUF_ERR 50Memory buffer error. 51.It Bq Er PAM_CONV_ERR 52Conversation failure. 53.It Bq Er PAM_IGNORE 54Ignore this module. 55.It Bq Er PAM_PERM_DENIED 56Permission denied. 57.It Bq Er PAM_SERVICE_ERR 58Error in service module. 59.It Bq Er PAM_SYSTEM_ERR 60System error. 61.It Bq Er PAM_TRY_AGAIN 62Try again. 63.El 64.Sh SEE ALSO 65.Xr pam 3 , 66.Xr pam_chauthtok 3 , 67.Xr pam_strerror 3 68.Sh STANDARDS 69.Rs 70.%T "X/Open Single Sign-On Service (XSSO) - Pluggable Authentication Modules" 71.%D "June 1997" 72.Re 73.Sh AUTHORS 74The 75.Fn pam_sm_chauthtok 76function and this manual page were 77developed for the 78.Fx 79Project by ThinkSec AS and Network Associates Laboratories, the 80Security Research Division of Network Associates, Inc.\& under 81DARPA/SPAWAR contract N66001-01-C-8035 82.Pq Dq CBOSS , 83as part of the DARPA CHATS research program. 84.Pp 85The OpenPAM library is maintained by 86.An Dag-Erling Sm\(/orgrav Aq Mt des@des.no . 87