Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
PAM_VPROMPT(3)	       FreeBSD Library Functions Manual		PAM_VPROMPT(3)

NAME
     pam_vprompt -- call the conversation function

SYNOPSIS
     #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);

DESCRIPTION
     The pam_vprompt() function	constructs a string from the fmt and ap	argu-
     ments using vsnprintf(3), and passes it to	the given PAM context's	con-
     versation function.

     The style argument	specifies the type of interaction requested, and must
     be	one of the following:

     PAM_PROMPT_ECHO_OFF
			 Display the message and obtain	the user's response
			 without displaying it.

     PAM_PROMPT_ECHO_ON	 Display the message and obtain	the user's response.

     PAM_ERROR_MSG	 Display the message as	an error message, and do not
			 wait for a response.

     PAM_TEXT_INFO	 Display the message as	an informational message, and
			 do not	wait for a response.

     A pointer to the response,	or NULL	if the conversation function did not
     return one, is stored in the location pointed to by the resp argument.

     The message and response should not exceed	PAM_MAX_MSG_SIZE or
     PAM_MAX_RESP_SIZE,	respectively.  If they do, they	may be truncated.

RETURN VALUES
     The pam_vprompt() function	returns	one of the following values:

     [PAM_SUCCESS]	 Success.

     [PAM_BUF_ERR]	 Memory	buffer error.

     [PAM_CONV_ERR]	 Conversation failure.

     [PAM_SYSTEM_ERR]	 System	error.

SEE ALSO
     pam(3), pam_error(3), pam_info(3),	pam_prompt(3), pam_strerror(3),
     pam_verror(3), pam_vinfo(3), vsnprintf(3)

STANDARDS
     The pam_vprompt() function	is an OpenPAM extension.

AUTHORS
     The pam_vprompt() function	and this manual	page were developed for	the
     FreeBSD Project by	ThinkSec AS and	Network	Associates Laboratories, the
     Security Research Division	of Network Associates, Inc. under DARPA/SPAWAR
     contract N66001-01-C-8035 (``CBOSS''), as part of the DARPA CHATS
     research program.

     The OpenPAM library is maintained by Dag-Erling Smorgrav <des@des.no>.

FreeBSD	Ports 11.2		April 30, 2017		    FreeBSD Ports 11.2

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUES | SEE ALSO | STANDARDS | AUTHORS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=pam_vprompt&sektion=3&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help