pam_chauthtok(3PAM) PAM Library Functions pam_chauthtok(3PAM)NAMEpam_chauthtok - perform password related functions within the PAM
framework
SYNOPSIS
cc [ flag ... ] file ... -lpam [ library ... ]
#include <security/pam_appl.h>
int pam_chauthtok(pam_handle_t *pamh, const int flags);
DESCRIPTION
The pam_chauthtok() function is called to change the authentication
token associated with a particular user referenced by the authentica‐
tion handle pamh.
The following flag may be passed in to pam_chauthtok():
PAM_SILENT The password service should not
generate any messages.
PAM_CHANGE_EXPIRED_AUTHTOK The password service should only
update those passwords that have
aged. If this flag is not passed,
all password services should update
their passwords.
Upon successful completion of the call, the authentication token of the
user will be changed in accordance with the password service config‐
ured in the system through pam.conf(4).
RETURN VALUES
Upon successful completion, PAM_SUCCESS is returned. In addition to
the error return values described in pam(3PAM), the following values
may be returned:
PAM_PERM_DENIED No permission.
PAM_AUTHTOK_ERR Authentication token manipulation
error.
PAM_AUTHTOK_RECOVERY_ERR Authentication information cannot
be recovered.
PAM_AUTHTOK_LOCK_BUSY Authentication token lock busy.
PAM_AUTHTOK_DISABLE_AGING Authentication token aging dis‐
abled.
PAM_USER_UNKNOWN User unknown to password service.
PAM_TRY_AGAIN Preliminary check by password ser‐
vice failed.
ATTRIBUTES
See attributes(5) for description of the following attributes:
┌─────────────────────────────┬─────────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├─────────────────────────────┼─────────────────────────────┤
│Interface Stability │ Stable │
├─────────────────────────────┼─────────────────────────────┤
│MT-Level │MT-Safe with exceptions │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSOlogin(1), passwd(1), pam(3PAM), pam_authenticate(3PAM),
pam_start(3PAM), attributes
NOTES
The 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.
The pam_chauthtok() functions performs a preliminary check before
attempting to update passwords. This check is performed for each pass‐
word module in the stack as listed in pam.conf(4). The check may
include pinging remote name services to determine if they are avail‐
able. If pam_chauthtok() returns PAM_TRY_AGAIN, then the check has
failed, and passwords are not updated.
The interfaces in libpam are MT-Safe only if each thread within the
multithreaded application uses its own PAM handle.
SunOS 5.10 13 Oct 1998 pam_chauthtok(3PAM)