tail head cat sleep
QR code linking to this page

manページ  — PAM_AUTHENTICATE

名称

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


1996 Dec 9 PAM_AUTHENTICATE (3) PAM 0.55

tail head cat sleep
QR code linking to this page


このマニュアルページサービスについてのご意見は Ben Bullock にお知らせください。 Privacy policy.

The last good thing written in C was Franz Schubert's Symphony #9.
— Erwin Dietrich