EN JA
PAM_VPROMPT(3)
PAM_VPROMPT(3) FreeBSD Library Functions Manual PAM_VPROMPT(3)

名称

pam_vprompt会話関数を呼び出す

ライブラリ

Pluggable Authentication Module Library (libpam, -lpam)

書式

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

int
pam_vprompt( const pam_handle_t *pamh, int style, char **resp, const char *fmt, va_list ap);

解説

pam_vprompt() 関数は、 vsnprintf(3) を使用して、 fmtap 引数から文字列を構築して与えられた PAM コンテキストの会話関数にそれを渡します。

style 引数は、要求された相互作用のタイプを指定します、そして次の 1 つでなければなりません:

PAM_PROMPT_ECHO_OFF
メッセージを表示して、応答を表示しないでユーザの応答を取得します。
PAM_PROMPT_ECHO_ON
メッセージを表示して、ユーザの応答を取得します。
PAM_ERROR_MSG
エラーメッセージとしてメッセージを表示し、応答を待ちません。
PAM_TEXT_INFO
通知メッセージとしてメッセージを表示して、応答を待ちません。

応答へのポインタまたは会話関数が応答しなかったなら NULLresp 引数で指された位置に格納されます。

メッセージと応答はそれぞれ PAM_MAX_MSG_SIZEPAM_MAX_RESP_SIZE を超えるべきではありません。そうであるなら、それらは短く切り捨てられます。

戻り値

pam_vprompt() 関数は、次の値の 1 つを返します:
[ PAM_BUF_ERR]
メモリバッファエラー。
[ PAM_CONV_ERR]
会話失敗。
[ PAM_SYSTEM_ERR]
システムエラー。

規格

pam_vprompt() 関数は、OpenPAM の拡張です。

作者

pam_vprompt() 関数とこのマニュアルページは、 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>によって保守されています。

September 7, 2013 FreeBSD