名称
pam_open_session, pam_close_session ― PAM セッションの作成および終了の操作の実行
構文
cc [ flag ... ] file ... -lpam [ library ... ]
#include <security/pam_appl.h>
int pam_open_session(pam_handle_t *pamh, int flags);
int pam_close_session(pam_handle_t *pamh, int flags);
説明
pam_open_session() は、ユーザーの認証が成功した後で呼び出し pam_authenticate(3) と pam_acct_mgmt(3) を参照)、新しいセッションが開始されたことをセッションモジュールに知らせるために使用します。 pam(3) ライブラリを使用するすべてのプログラムは、新しいセッションを開始するときに pam_open_session() を呼び出さなければなりません。このアクティビティが終了するときは、 pam_close_session() を呼び出して、セッションが終了したことを pam(3) に知らせなければなりません。
pamh 引き数は、以前に pam_start() を呼び出して取得した認証ハンドルです。 pam_open_session() および pam_close_session() の flags フィールドには、以下のフラグを設定できます。
| PAM_SILENT | | セッションサービスのメッセージ作成を禁止します。 |
アプリケーション使用法
PAM インタフェースのスレッドへの対応状況については、 pam(3) を参照してください。
戻り値
正常終了すると、 PAM_SUCCESS が返されます。エラーが発生すると、 pam(3) で定義した戻り値の他に、以下の値が返されることがあります。
| PAM_SESSION_ERR | | 指定されたセッションのためのエントリーを作成 / 削除できません。 |