| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081 |
- '\" t
- .\" Title: pam_prompt
- .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
- .\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
- .\" Date: 09/03/2021
- .\" Manual: Linux-PAM Manual
- .\" Source: Linux-PAM Manual
- .\" Language: English
- .\"
- .TH "PAM_PROMPT" "3" "09/03/2021" "Linux-PAM Manual" "Linux-PAM Manual"
- .\" -----------------------------------------------------------------
- .\" * Define some portability stuff
- .\" -----------------------------------------------------------------
- .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
- .\" http://bugs.debian.org/507673
- .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
- .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
- .ie \n(.g .ds Aq \(aq
- .el .ds Aq '
- .\" -----------------------------------------------------------------
- .\" * set default formatting
- .\" -----------------------------------------------------------------
- .\" disable hyphenation
- .nh
- .\" disable justification (adjust text to left margin only)
- .ad l
- .\" -----------------------------------------------------------------
- .\" * MAIN CONTENT STARTS HERE *
- .\" -----------------------------------------------------------------
- .SH "NAME"
- pam_prompt, pam_vprompt \- interface to conversation function
- .SH "SYNOPSIS"
- .sp
- .ft B
- .nf
- #include <security/pam_ext\&.h>
- .fi
- .ft
- .HP \w'int\ pam_prompt('u
- .BI "int pam_prompt(pam_handle_t\ *" "pamh" ", int\ " "style" ", char\ **" "response" ", const\ char\ *" "fmt" ", " "\&.\&.\&." ");"
- .HP \w'int\ pam_vprompt('u
- .BI "int pam_vprompt(pam_handle_t\ *" "pamh" ", int\ " "style" ", char\ **" "response" ", const\ char\ *" "fmt" ", va_list\ " "args" ");"
- .SH "DESCRIPTION"
- .PP
- The
- \fBpam_prompt\fR
- function constructs a message from the specified format string and arguments and passes it to the conversation function as set by the service\&. Upon successful return,
- \fIresponse\fR
- is set to point to a string returned from the conversation function\&. This string is allocated on heap and should be freed\&.
- .SH "RETURN VALUES"
- .PP
- PAM_BUF_ERR
- .RS 4
- Memory buffer error\&.
- .RE
- .PP
- PAM_CONV_ERR
- .RS 4
- Conversation failure\&.
- .RE
- .PP
- PAM_SUCCESS
- .RS 4
- Conversation succeeded, response is set\&.
- .RE
- .PP
- PAM_SYSTEM_ERR
- .RS 4
- System error\&.
- .RE
- .SH "SEE ALSO"
- .PP
- \fBpam\fR(8),
- \fBpam_conv\fR(3)
- .SH "STANDARDS"
- .PP
- The
- \fBpam_prompt\fR
- and
- \fBpam_vprompt\fR
- functions are Linux\-PAM extensions\&.
|
