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.

Using Unix is the computing equivalent of listening only to music by David Cassidy
— Rob Pike