PAM_START(3)

名称
pam_start, pam_end - PAM の起動

書式
#include <security/pam_appl.h>

int pam_start(const char *service, const char *user, const struct pam_conv *conv, pam_handle_t **pamh_p);

int pam_end(pam_handle_t *pamh, int pam_status);

解説

pam_start
    PAM ライブラリを初期化し、特定の サービス 名でアプリケーション を確認します。インタフェースを初期化するときにユーザ名が分かっていない 場合は、 ユーザ 名を NULL にできます。 conv 引数では、対話構造をライブラリに渡せます (これとその他の構造の詳細については、 PAM アプリケーションの 開発者用ガイドを参照してください)。初期化が問題なく終了すると、 ライブラリに後でアクセスするための不透明なポインタハンドルが pamh_p ポインタで戻されます。

pam_end
    PAM ライブラリを終了します。 pamh ハンドルが関連するサービスアプリケーションが終了します。 pam_status 引数は、ライブラリからアプリケーションに戻された最新の値を渡します。 これは、ライブラリの終了方法を示します。この引数は戻り値を運ぶ他に、 PAM_DATA_SILENT と論理和を取り、モジュールがこの呼び出しを重大に扱わないことを 示すことがあります。 一般的には、現在のライブラリの終了処理が fork(2) を実行したプロセスで実行されること、 および現行プロセスのスペース以外に存在するもの(ファイルなど) を親がクリーンアップすることを示します。

戻り値

pam_start

pam_end
    問題がない場合は PAM_SUCCESS が戻されます。

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

準拠
DCE-RFC 86.0, October 1995.

PAM_DATA_SILENT フラグは、1996 年 12 月 4 日現在、DCE での受け入れが保留されています。

バグ

見つかっていません。

関連項目
fork(2), pam_authenticate(3), pam_acct_mgmt(3), pam_open_session(3), pam_chauthtok(3). システム管理者 、 モジュール開発者 、 アプリケーション開発者 用の Linux-PAM ガイドも参照してください。