xref: /freebsd/contrib/openpam/include/security/pam_appl.h (revision ae83180158c4c937f170e31eff311b18c0286a93)
1 /*-
2  * Copyright (c) 2002 Networks Associates Technology, Inc.
3  * All rights reserved.
4  *
5  * This software was developed for the FreeBSD Project by ThinkSec AS and
6  * Network Associates Laboratories, the Security Research Division of
7  * Network Associates, Inc.  under DARPA/SPAWAR contract N66001-01-C-8035
8  * ("CBOSS"), as part of the DARPA CHATS research program.
9  *
10  * Redistribution and use in source and binary forms, with or without
11  * modification, are permitted provided that the following conditions
12  * are met:
13  * 1. Redistributions of source code must retain the above copyright
14  *    notice, this list of conditions and the following disclaimer.
15  * 2. Redistributions in binary form must reproduce the above copyright
16  *    notice, this list of conditions and the following disclaimer in the
17  *    documentation and/or other materials provided with the distribution.
18  * 3. The name of the author may not be used to endorse or promote
19  *    products derived from this software without specific prior written
20  *    permission.
21  *
22  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
23  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
24  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
25  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
26  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
27  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
28  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
29  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
30  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
31  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
32  * SUCH DAMAGE.
33  *
34  * $P4: //depot/projects/openpam/include/security/pam_appl.h#10 $
35  */
36 
37 #ifndef _PAM_APPL_H_INCLUDED
38 #define _PAM_APPL_H_INCLUDED
39 
40 #include <security/pam_types.h>
41 #include <security/pam_constants.h>
42 
43 #ifdef __cplusplus
44 extern "C" {
45 #endif
46 
47 /*
48  * XSSO 4.2.1, 6
49  */
50 
51 int
52 pam_acct_mgmt(pam_handle_t *_pamh,
53 	int _flags);
54 
55 int
56 pam_authenticate(pam_handle_t *_pamh,
57 	int _flags);
58 
59 int
60 pam_chauthtok(pam_handle_t *_pamh,
61 	int _flags);
62 
63 int
64 pam_close_session(pam_handle_t *_pamh,
65 	int _flags);
66 
67 int
68 pam_end(pam_handle_t *_pamh,
69 	int _status);
70 
71 int
72 pam_get_data(pam_handle_t *_pamh,
73 	const char *_module_data_name,
74 	const void **_data);
75 
76 int
77 pam_get_item(pam_handle_t *_pamh,
78 	int _item_type,
79 	const void **_item);
80 
81 int
82 pam_get_user(pam_handle_t *_pamh,
83 	const char **_user,
84 	const char *_prompt);
85 
86 char *
87 pam_getenv(pam_handle_t *_pamh,
88 	const char *_name);
89 
90 char **
91 pam_getenvlist(pam_handle_t *_pamh);
92 
93 int
94 pam_open_session(pam_handle_t *_pamh,
95 	int _flags);
96 
97 int
98 pam_putenv(pam_handle_t *_pamh,
99 	const char *_namevalue);
100 
101 int
102 pam_set_data(pam_handle_t *_pamh,
103 	const char *_module_data_name,
104 	void *_data,
105 	void (*_cleanup)(pam_handle_t *_pamh,
106 		void *_data,
107 		int _pam_end_status));
108 
109 int
110 pam_set_item(pam_handle_t *_pamh,
111 	int _item_type,
112 	const void *_item);
113 
114 int
115 pam_setcred(pam_handle_t *_pamh,
116 	int _flags);
117 
118 int
119 pam_start(const char *_service,
120 	const char *_user,
121 	const struct pam_conv *_pam_conv,
122 	pam_handle_t **_pamh);
123 
124 const char *
125 pam_strerror(pam_handle_t *_pamh,
126 	int _error_number);
127 
128 /*
129  * Single Sign-On extensions
130  */
131 #if 0
132 int
133 pam_authenticate_secondary(pam_handle_t *_pamh,
134 	char *_target_username,
135 	char *_target_module_type,
136 	char *_target_authn_domain,
137 	char *_target_supp_data,
138 	char *_target_module_authtok,
139 	int _flags);
140 
141 int
142 pam_get_mapped_authtok(pam_handle_t *_pamh,
143 	const char *_target_module_username,
144 	const char *_target_module_type,
145 	const char *_target_authn_domain,
146 	size_t *_target_authtok_len,
147 	unsigned char **_target_module_authtok);
148 
149 int
150 pam_get_mapped_username(pam_handle_t *_pamh,
151 	const char *_src_username,
152 	const char *_src_module_type,
153 	const char *_src_authn_domain,
154 	const char *_target_module_type,
155 	const char *_target_authn_domain,
156 	char **_target_module_username);
157 
158 int
159 pam_set_mapped_authtok(pam_handle_t *_pamh,
160 	const char *_target_module_username,
161 	size_t _target_authtok_len,
162 	unsigned char *_target_module_authtok,
163 	const char *_target_module_type,
164 	const char *_target_authn_domain);
165 
166 int
167 pam_set_mapped_username(pam_handle_t *_pamh,
168 	char *_src_username,
169 	char *_src_module_type,
170 	char *_src_authn_domain,
171 	char *_target_module_username,
172 	char *_target_module_type,
173 	char *_target_authn_domain);
174 #endif /* 0 */
175 
176 #ifdef __cplusplus
177 }
178 #endif
179 
180 #endif
181