manページ  — PAM_CHAUTHTOK

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 つ以上の認証メカニズムで、トークンの更新のための準備が今できていません。

一般的にはその他の戻り値も戻されます。エラーを示しているものとして 扱ってください。

DCE-RFC 86.0, October 1995.

見つかっていません。