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) を使用して、 fmt と ap 引数から文字列を構築して与えられた PAM コンテキストの会話関数にそれを渡します。style 引数は、要求された相互作用のタイプを指定します、そして次の 1 つでなければなりません:
- PAM_PROMPT_ECHO_OFF
- メッセージを表示して、応答を表示しないでユーザの応答を取得します。
- PAM_PROMPT_ECHO_ON
- メッセージを表示して、ユーザの応答を取得します。
- PAM_ERROR_MSG
- エラーメッセージとしてメッセージを表示し、応答を待ちません。
- PAM_TEXT_INFO
- 通知メッセージとしてメッセージを表示して、応答を待ちません。
応答へのポインタまたは会話関数が応答しなかったなら NULL が resp 引数で指された位置に格納されます。
メッセージと応答はそれぞれ PAM_MAX_MSG_SIZE か PAM_MAX_RESP_SIZE を超えるべきではありません。そうであるなら、それらは短く切り捨てられます。
戻り値
pam_vprompt() 関数は、次の値の 1 つを返します:- [ PAM_BUF_ERR]
- メモリバッファエラー。
- [ PAM_CONV_ERR]
- 会話失敗。
- [ PAM_SYSTEM_ERR]
- システムエラー。
関連項目
pam(3), pam_error(3), pam_info(3), pam_prompt(3), pam_strerror(3), pam_verror(3), pam_vinfo(3), vsnprintf(3)規格
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 ライブラリは、
<des@des.no>によって保守されています。September 7, 2013 | FreeBSD |