PAM_AUTHENTICATE(3)

名称
pam_authenticate - ユーザの認証

書式
#include <security/pam_appl.h>

int pam_authenticate(pam_handle_t *pamh, int flags);

解説
pam_authenticate
この関数を使用すると、申請ユーザを認証できます。この関数は、 PAM で認証モジュールに ダイナミックに リンクされており、 この認証モジュールが認証を行ないます。 アプリケーションが認証の本質に関わることはありません。
認証が問題なく終了すると、認証されたユーザの 名前 が PAM アイテム PAM_USER に入ります。 このアイテムは、 pam_get_item(3) を呼び出して取得できます。
アプリケーション開発者は、認証モジュールが対話メカニズム ( pam_start(3) 参照) でユーザにユーザ名を入力させることがあることに注意する必要があります。 この場合は、ユーザプロンプトストリングを PAM_USER_PROMPT アイテム ( pam_set_item(3) 参照) で設定できます。

戻り値
問題がない場合は PAM_SUCCESS が戻されます。その他の値が戻された場合は、 認証で問題が発生したとみなされ、以前に呼び出した pam_fail_delay(3) で指定された値だけ 遅延 が発生します。 とくに注意が必要なエラーは以下のとおりです。

PAM_ABORT
    アプリケーションをすぐに終了する必要があります。もちろん最初に pam_end(3) を呼び出してください。

PAM_MAXTRIES
    アプリケーションがユーザの認証を何度も繰り返しています。 認証を止めてください。

エラー
pam_strerror(3) でテキストに変換できます。

準拠
DCE-RFC 86.0, October 1995.

バグ

見つかっていません。

関連項目
pam_start(3), pam_get_item(3), pam_fail_delay(3), pam_strerror(3) システム管理者 、 モジュール開発者 、 アプリケーション開発者 用の PAM ガイドも参照してください。