名称

pam_set_data — モジュール情報を設定する

ライブラリ

Pluggable Authentication Module Library (libpam, -lpam)

書式

#include < sys/types.h>
#include < security/pam_appl.h>

int
pam_set_data( pam_handle_t *pamh, const char *module_data_name, void *data, void (*cleanup)(pam_handle_t *pamh, void *data, int pam_end_status));

解説

pam_set_data() 関数は、 pamh 引数で指定された PAM コンテクストで、 module_data_name 引数によって指定される任意の文字列で不透明な (訳注: サイズ及び形がわからない) オブジェクトへのポインタを関連付けます。

NULL でないなら、 cleanup 引数は、オブジェクトに関連しているリソースを解放する責任がある関数を指すべきです。

この関数とその対となる片方の pam_get_data(3) は、特定のサービスモジュールだけに重要なデータを管理することに役立ちます。

戻り値

pam_set_data() 関数は、次の値の 1 つを返します:

[ PAM_BUF_ERR]

メモリバッファエラー。

[ PAM_SYSTEM_ERR]

システムエラー。

関連項目

pam(3), pam_get_data(3), pam_strerror(3)

規格

X/Open Single Sign-On Service (XSSO) - Pluggable Authentication Modules, June 1997.

作者

pam_set_data() 関数とこのマニュアルページは、 FreeBSD プロジェクトのために DARPA CHATS 研究プログラムの一環として DARPA/SPAWAR 規約 N66001-01-C-8035 (“CBOSS”) の下で ThinkSec AS と Network Associates Laboratories, the Security Research Division of Network Associates, Inc. によって開発されました。

OpenPAM ライブラリは、 Dag-Erling Smørgrav <des@des.no>によって保守されています。