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