|
|
HP-UX Reference Volume 4 of 5 > ppam_chauthtok(3) |
|
NAMEpam_chauthtok — perform password related functions within the PAM framework SYNOPSIScc [ flag ... ] file ... -lpam [ library ... ] #include <security/pam_appl.h> int pam_chauthtok(pam_handle_t *pamh, int flags, int argc, const char **argv); DESCRIPTIONpam_chauthtok() is called to change the authentication token associated with a particular user referenced by the authentication handle, pamh. The following flag may be passed in to pam_chauthtok():
Upon successful completion of the call, the authentication token of the user will be changed in accordance with the password service configured in the system through pam.conf(4). NOTESThe flag PAM_CHANGE_EXPIRED_AUTHTOK is typically used by a login application which has determined that the user's password has aged or expired. Before allowing the user to login, the login application may invoke pam_chauthtok() with this flag to allow the user to update the password. Typically applications such as passwd(1) should not use this flag. pam_chauthtok() performs a preliminary check before attempting to update passwords. This check is performed for each password module in the stack as listed in pam.conf(4). The check may include pinging remote name services to determine if they are available. If pam_chauthtok() returns PAM_TRY_AGAIN, then the check has failed, and passwords are not updated. RETURN VALUESUpon successful completion, PAM_SUCCESS is returned. In addition to the error return values described in pam(3), the following values may be returned:
|
|