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 ガイドも参照してください。