cb5d1a9147
jpman project specific RCS keyword (jpman %Id) is obsolete, after manual entries are stored in freefall CVS repository. This old Id is useless and more worse it confuses users and bug reporters. So, this old Id is removed. Submitted by:jpman project <man-jp@jp.FreeBSD.org>
101 lines
2.3 KiB
Groff
101 lines
2.3 KiB
Groff
.\" Hey Emacs! This file is -*- nroff -*- source.
|
|
.\" %Id: pam_open_session.3,v 1.2 1997/02/15 18:49:02 morgan Exp %
|
|
.\" Copyright (c) Andrew G. Morgan 1997 <morgan@parc.power.net>
|
|
.\" $FreeBSD$
|
|
.TH PAM_OPEN_SESSION 3 "1997 Jan 4" "PAM 0.55" "App. Programmers' Manual"
|
|
.SH 名称
|
|
|
|
pam_open/close_session \- PAM セッション管理
|
|
|
|
.SH 書式
|
|
.B #include <security/pam_appl.h>
|
|
.sp
|
|
.BI "int pam_open_session(pam_handle_t " *pamh ", int " flags ");"
|
|
.sp
|
|
.BI "int pam_close_session(pam_handle_t " *pamh ", int " flags ");"
|
|
.sp 2
|
|
.SH 解説
|
|
|
|
PAM には、セッションの初期化と終了を行なう管理ツールがあります。
|
|
|
|
.TP
|
|
.B pam_open_session
|
|
この関数を使用すると、認証されたユーザのセッションが始まったことを
|
|
通知できます。ユーザが
|
|
.BR pam_authenticate "(3)"
|
|
で適切に確認され、
|
|
必要な場合は
|
|
.BR pam_setcred "(3)"
|
|
で証明書を与えられた後で呼び出してください。
|
|
|
|
.br
|
|
セッションの初期化に関連した関数には、システムを監視するための
|
|
ログ作成とディレクトリ(ユーザのホームディレクトリなど)の
|
|
マウントがあります。アプリケーションでこれに関わることはありません。
|
|
アプリケーションの
|
|
.I 有効な
|
|
uid (
|
|
.BR geteuid "(2)"
|
|
)
|
|
に、このようなタスクを実行する権利が必要であることに注意してください。
|
|
|
|
.TP
|
|
.B pam_close_session
|
|
.br
|
|
この関数を使用すると、ユーザセッションが終了したことを通知できます。
|
|
一般的には、初期化関数
|
|
(
|
|
.BR pam_open_session
|
|
)
|
|
と同じアプリケーションにこの関数を配置する必要はありません。
|
|
|
|
.br
|
|
この関数は、
|
|
.BR pam_open_session
|
|
のアクションを取り消します。
|
|
つまり、ユーザセッションの終了に関わる監視情報を記録し、ユーザの
|
|
ホームディレクトリのマウントを解除します。十分な権利があることは別にして、
|
|
セッションの終了の詳細に呼び出しアプリケーションが関わるこはありません。
|
|
しかし、この呼び出しから戻るときにユーザのためにアクションを起こすことは
|
|
止めてください。
|
|
|
|
.SH 戻り値
|
|
このセッション管理関数で問題が発生しなかった場合は、
|
|
.BR PAM_SUCCESS
|
|
が戻されます。
|
|
|
|
.br
|
|
セッションの開閉でエラーが発生した場合は、
|
|
.BR PAM_SESSION_ERR
|
|
が戻されます。
|
|
その他の戻り値が戻された場合は、エラーを示すものとして扱ってください。
|
|
|
|
.SH エラー
|
|
.BR pam_strerror "(3)"
|
|
でテキストに変換できます。
|
|
|
|
.SH 準拠
|
|
OSF-RFC 86.0, October 1995.
|
|
|
|
.SH バグ
|
|
.sp 2
|
|
見つかっていません。
|
|
|
|
.SH 関連項目
|
|
|
|
.BR pam_start "(3), "
|
|
.BR pam_authenticate "(3), "
|
|
.BR pam_setcred "(3), "
|
|
.BR pam_get_item "(3), "
|
|
.BR pam_strerror "(3), "
|
|
.BR pam "(3)."
|
|
|
|
.br
|
|
.BR システム管理者
|
|
、
|
|
.BR モジュール開発者
|
|
、
|
|
.BR アプリケーション開発者
|
|
用の
|
|
.BR Linux-PAM
|
|
ガイドも参照してください。
|