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