1*10b5fe87SSascha Wildner /*-
2*10b5fe87SSascha Wildner * Copyright (c) 2002-2003 Networks Associates Technology, Inc.
3*10b5fe87SSascha Wildner * Copyright (c) 2004-2011 Dag-Erling Smørgrav
4*10b5fe87SSascha Wildner * All rights reserved.
5*10b5fe87SSascha Wildner *
6*10b5fe87SSascha Wildner * This software was developed for the FreeBSD Project by ThinkSec AS and
7*10b5fe87SSascha Wildner * Network Associates Laboratories, the Security Research Division of
8*10b5fe87SSascha Wildner * Network Associates, Inc. under DARPA/SPAWAR contract N66001-01-C-8035
9*10b5fe87SSascha Wildner * ("CBOSS"), as part of the DARPA CHATS research program.
10*10b5fe87SSascha Wildner *
11*10b5fe87SSascha Wildner * Redistribution and use in source and binary forms, with or without
12*10b5fe87SSascha Wildner * modification, are permitted provided that the following conditions
13*10b5fe87SSascha Wildner * are met:
14*10b5fe87SSascha Wildner * 1. Redistributions of source code must retain the above copyright
15*10b5fe87SSascha Wildner * notice, this list of conditions and the following disclaimer.
16*10b5fe87SSascha Wildner * 2. Redistributions in binary form must reproduce the above copyright
17*10b5fe87SSascha Wildner * notice, this list of conditions and the following disclaimer in the
18*10b5fe87SSascha Wildner * documentation and/or other materials provided with the distribution.
19*10b5fe87SSascha Wildner * 3. The name of the author may not be used to endorse or promote
20*10b5fe87SSascha Wildner * products derived from this software without specific prior written
21*10b5fe87SSascha Wildner * permission.
22*10b5fe87SSascha Wildner *
23*10b5fe87SSascha Wildner * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
24*10b5fe87SSascha Wildner * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
25*10b5fe87SSascha Wildner * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
26*10b5fe87SSascha Wildner * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
27*10b5fe87SSascha Wildner * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
28*10b5fe87SSascha Wildner * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
29*10b5fe87SSascha Wildner * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
30*10b5fe87SSascha Wildner * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
31*10b5fe87SSascha Wildner * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
32*10b5fe87SSascha Wildner * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
33*10b5fe87SSascha Wildner * SUCH DAMAGE.
34*10b5fe87SSascha Wildner *
35*10b5fe87SSascha Wildner * $OpenPAM: pam_prompt.c 938 2017-04-30 21:34:42Z des $
36*10b5fe87SSascha Wildner */
37*10b5fe87SSascha Wildner
38*10b5fe87SSascha Wildner #ifdef HAVE_CONFIG_H
39*10b5fe87SSascha Wildner # include "config.h"
40*10b5fe87SSascha Wildner #endif
41*10b5fe87SSascha Wildner
42*10b5fe87SSascha Wildner #include <sys/types.h>
43*10b5fe87SSascha Wildner
44*10b5fe87SSascha Wildner #include <stdarg.h>
45*10b5fe87SSascha Wildner
46*10b5fe87SSascha Wildner #include <security/pam_appl.h>
47*10b5fe87SSascha Wildner #include <security/openpam.h>
48*10b5fe87SSascha Wildner
49*10b5fe87SSascha Wildner /*
50*10b5fe87SSascha Wildner * OpenPAM extension
51*10b5fe87SSascha Wildner *
52*10b5fe87SSascha Wildner * Call the conversation function
53*10b5fe87SSascha Wildner */
54*10b5fe87SSascha Wildner
55*10b5fe87SSascha Wildner int
pam_prompt(const pam_handle_t * pamh,int style,char ** resp,const char * fmt,...)56*10b5fe87SSascha Wildner pam_prompt(const pam_handle_t *pamh,
57*10b5fe87SSascha Wildner int style,
58*10b5fe87SSascha Wildner char **resp,
59*10b5fe87SSascha Wildner const char *fmt,
60*10b5fe87SSascha Wildner ...)
61*10b5fe87SSascha Wildner {
62*10b5fe87SSascha Wildner va_list ap;
63*10b5fe87SSascha Wildner int r;
64*10b5fe87SSascha Wildner
65*10b5fe87SSascha Wildner va_start(ap, fmt);
66*10b5fe87SSascha Wildner r = pam_vprompt(pamh, style, resp, fmt, ap);
67*10b5fe87SSascha Wildner va_end(ap);
68*10b5fe87SSascha Wildner return (r);
69*10b5fe87SSascha Wildner }
70*10b5fe87SSascha Wildner
71*10b5fe87SSascha Wildner /*
72*10b5fe87SSascha Wildner * Error codes:
73*10b5fe87SSascha Wildner *
74*10b5fe87SSascha Wildner * !PAM_SYMBOL_ERR
75*10b5fe87SSascha Wildner * PAM_SYSTEM_ERR
76*10b5fe87SSascha Wildner * PAM_BUF_ERR
77*10b5fe87SSascha Wildner * PAM_CONV_ERR
78*10b5fe87SSascha Wildner */
79*10b5fe87SSascha Wildner
80*10b5fe87SSascha Wildner /**
81*10b5fe87SSascha Wildner * The =pam_prompt function constructs a message from the specified format
82*10b5fe87SSascha Wildner * string and arguments and passes it to the given PAM context's
83*10b5fe87SSascha Wildner * conversation function.
84*10b5fe87SSascha Wildner *
85*10b5fe87SSascha Wildner * A pointer to the response, or =NULL if the conversation function did
86*10b5fe87SSascha Wildner * not return one, is stored in the location pointed to by the =resp
87*10b5fe87SSascha Wildner * argument.
88*10b5fe87SSascha Wildner *
89*10b5fe87SSascha Wildner * See =pam_vprompt for further details.
90*10b5fe87SSascha Wildner *
91*10b5fe87SSascha Wildner * >pam_error
92*10b5fe87SSascha Wildner * >pam_info
93*10b5fe87SSascha Wildner * >pam_vprompt
94*10b5fe87SSascha Wildner */
95