pam_sm_chauthtok3
Service module implementation for pam_chauthtok
Usage
#include <sys/types.h>
#include <security/pam_appl.h>
#include <security/pam_modules.h>
int
pam_sm_chauthtok(pam_handle_t *pamh, int flags, int argc, const char **argv);
Overview
The pam_sm_chauthtok() function is the service module's implementation of the pam_chauthtok(3) API function.
When the application calls pam_chauthtok(3), the service function is called twice, first with the PAM_PRELIM_CHECK flag set and then again with the PAM_UPDATE_AUTHTOK flag set.
Return values
The pam_sm_chauthtok() function returns one of the following values:
- [PAM_SUCCESS]
-
Success.
- [PAM_ABORT]
-
General failure.
- [PAM_AUTHTOK_DISABLE_AGING]
-
Authentication token aging disabled.
- [PAM_AUTHTOK_ERR]
-
Authentication token failure.
- [PAM_AUTHTOK_LOCK_BUSY]
-
Authentication token lock busy.
- [PAM_AUTHTOK_RECOVERY_ERR]
-
Failed to recover old authentication token.
- [PAM_BUF_ERR]
-
Memory buffer error.
- [PAM_CONV_ERR]
-
Conversation failure.
- [PAM_IGNORE]
-
Ignore this module.
- [PAM_PERM_DENIED]
-
Permission denied.
- [PAM_SERVICE_ERR]
-
Error in service module.
- [PAM_SYSTEM_ERR]
-
System error.
- [PAM_TRY_AGAIN]
-
Try again.
Releases
56 releases since FreeBSD 5.0-RELEASE; the text changed 15 times.