PAM_CHAUTHTOK(3)

명칭
pam_chauthtok - 인증 토큰의 갱신

서식
#include <security/pam_appl.h>

int pam_chauthtok(pam_handle_t *pamh, int flags);

해설
pam_chauthtok
이 함수를 사용하면(자), 신청 유저의 인증 토큰 (패스워드 등)을 갱신할 수 있습니다.
어플리케이션으로 유저를 미리 인증해야 하지는 않습니다. 인증은 PAM 체제로 필요에 따라서 실행됩니다.
flags 인수가, 값 PAM_CHANGE_EXPIRED_AUTHTOK (을)를 취하는 것이 있습니다. 이 경우, 기한이 지난 인증 토큰만을, 체제가 갱신할 필요가 있습니다. 이 인수가 없다고 체제는 모든 설정이 끝난 인증 메카니즘에 대해, 새로운 토큰을 취득하려고 합니다. 형태의 상세나 스킴수는, 호출 어플리케이션에 무관계해야 합니다.

반환값
이 함수로부터 문제 없게 돌아오면(자), PAM_SUCCESS 하지만 되돌려집니다.
이 함수를 호출했을 경우에 특히 주의해야 할 에러는 이하대로입니다.
PAM_AUTHTOK_ERROR - 유효한 새로운 토큰을 취득할 수 없었습니다.
PAM_AUTHTOK_RECOVERY_ERR - 낡은 인증 토큰을 사용할 수 없었습니다.
PAM_AUTHTOK_LOCK_BUSY - 토큰의 갱신에 필요한 리소스가 락 되고 있었습니다. 다음에 재차 실행해 주세요.
PAM_AUTHTOK_DISABLE_AGING - 1 개(살) 이상의 인증 모듈이, 인증 토큰의 에이징을 인정하지 않았습니다.
PAM_TRY_AGAIN - 1 개(살) 이상의 인증 메카니즘으로, 토큰의 갱신을 위한 준비가 지금 되어 있지 않습니다.
일반적으로는 그 외의 반환값도 되돌려집니다. 에러를 나타내고 있는 것으로서 취급해 주세요.

에러
pam_strerror(3) 그리고 텍스트로 변환할 수 있습니다.

준거
DCE-RFC 86.0, October 1995.

버그

발견되고 있지 않습니다.

관련 항목
pam_start(3), pam_authenticate(3), pam_setcred(3), pam_get_item(3), pam_strerror(3) pam(8).
시스템관리책임자 , 모듈개발자 , 어플리케이션개발자 용무의 PAM 가이드도 참조해 주세요.