xref: /titanic_50/usr/src/lib/udapl/libdat/common/udat_api.c (revision d2ec54f7875f7e05edd56195adbeb593c947763f)
1 /*
2  * CDDL HEADER START
3  *
4  * The contents of this file are subject to the terms of the
5  * Common Development and Distribution License, Version 1.0 only
6  * (the "License").  You may not use this file except in compliance
7  * with the License.
8  *
9  * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
10  * or http://www.opensolaris.org/os/licensing.
11  * See the License for the specific language governing permissions
12  * and limitations under the License.
13  *
14  * When distributing Covered Code, include this CDDL HEADER in each
15  * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
16  * If applicable, add the following below this CDDL HEADER, with the
17  * fields enclosed by brackets "[]" replaced with your own identifying
18  * information: Portions Copyright [yyyy] [name of copyright owner]
19  *
20  * CDDL HEADER END
21  */
22 /*
23  * Copyright (c) 2002-2003, Network Appliance, Inc. All rights reserved.
24  */
25 
26 /*
27  * Copyright 2004 Sun Microsystems, Inc.  All rights reserved.
28  * Use is subject to license terms.
29  */
30 
31 #pragma ident	"%Z%%M%	%I%	%E% SMI"
32 
33 
34 /*
35  *
36  * MODULE: udat_api.c
37  *
38  * PURPOSE: DAT Provider and Consumer registry functions.
39  *
40  */
41 
42 #include "dat_osd.h"
43 #include <dat/dat_registry.h>
44 
45 DAT_RETURN dat_lmr_create(
46 	IN	DAT_IA_HANDLE		ia_handle,
47 	IN	DAT_MEM_TYPE		mem_type,
48 	IN	DAT_REGION_DESCRIPTION	region_description,
49 	IN	DAT_VLEN		length,
50 	IN	DAT_PZ_HANDLE		pz_handle,
51 	IN	DAT_MEM_PRIV_FLAGS	privileges,
52 	OUT	DAT_LMR_HANDLE		*lmr_handle,
53 	OUT	DAT_LMR_CONTEXT		*lmr_context,
54 	OUT	DAT_RMR_CONTEXT		*rmr_context,
55 	OUT	DAT_VLEN 		*registered_length,
56 	OUT	DAT_VADDR 		*registered_address)
57 {
58 	if (DAT_BAD_HANDLE(ia_handle)) {
59 		return (DAT_ERROR(DAT_INVALID_HANDLE, DAT_INVALID_HANDLE_IA));
60 	}
61 	return DAT_LMR_CREATE(ia_handle,
62 			    mem_type,
63 			    region_description,
64 			    length,
65 			    pz_handle,
66 			    privileges,
67 			    lmr_handle,
68 			    lmr_context,
69 			    rmr_context,
70 			    registered_length,
71 			    registered_address);
72 }
73 
74 
75 DAT_RETURN dat_evd_create(
76 	IN	DAT_IA_HANDLE		ia_handle,
77 	IN	DAT_COUNT		evd_min_qlen,
78 	IN	DAT_CNO_HANDLE		cno_handle,
79 	IN	DAT_EVD_FLAGS		evd_flags,
80 	OUT	DAT_EVD_HANDLE		*evd_handle)
81 {
82 	if (DAT_BAD_HANDLE(ia_handle)) {
83 		return (DAT_ERROR(DAT_INVALID_HANDLE, DAT_INVALID_HANDLE_IA));
84 	}
85 	return DAT_EVD_CREATE(ia_handle,
86 			    evd_min_qlen,
87 			    cno_handle,
88 			    evd_flags,
89 			    evd_handle);
90 }
91 
92 
93 DAT_RETURN dat_evd_modify_cno(
94 	IN	DAT_EVD_HANDLE		evd_handle,
95 	IN	DAT_CNO_HANDLE		cno_handle)
96 {
97 	if (DAT_BAD_HANDLE(evd_handle)) {
98 		return (DAT_ERROR(DAT_INVALID_HANDLE, DAT_INVALID_HANDLE1));
99 	}
100 	return DAT_EVD_MODIFY_CNO(evd_handle,
101 				cno_handle);
102 }
103 
104 
105 DAT_RETURN dat_cno_create(
106 	IN 	DAT_IA_HANDLE		ia_handle,
107 	IN 	DAT_OS_WAIT_PROXY_AGENT agent,
108 	OUT	DAT_CNO_HANDLE		*cno_handle)
109 {
110 	if (DAT_BAD_HANDLE(ia_handle)) {
111 		return (DAT_ERROR(DAT_INVALID_HANDLE, DAT_INVALID_HANDLE_IA));
112 	}
113 	return DAT_CNO_CREATE(ia_handle,
114 			    agent,
115 			    cno_handle);
116 }
117 
118 
119 DAT_RETURN dat_cno_modify_agent(
120 	IN 	DAT_CNO_HANDLE		 cno_handle,
121 	IN 	DAT_OS_WAIT_PROXY_AGENT	 agent)
122 {
123 	if (DAT_BAD_HANDLE(cno_handle)) {
124 		return (DAT_ERROR(DAT_INVALID_HANDLE, DAT_INVALID_HANDLE_CNO));
125 	}
126 	return DAT_CNO_MODIFY_AGENT(cno_handle,
127 				agent);
128 }
129 
130 
131 DAT_RETURN dat_cno_query(
132 	IN	DAT_CNO_HANDLE		cno_handle,
133 	IN	DAT_CNO_PARAM_MASK	cno_param_mask,
134 	OUT	DAT_CNO_PARAM		*cno_param)
135 {
136 	if (DAT_BAD_HANDLE(cno_handle)) {
137 		return (DAT_ERROR(DAT_INVALID_HANDLE, DAT_INVALID_HANDLE_CNO));
138 	}
139 	return DAT_CNO_QUERY(cno_handle,
140 			cno_param_mask,
141 			cno_param);
142 }
143 
144 
145 DAT_RETURN dat_cno_free(
146 	IN DAT_CNO_HANDLE		cno_handle)
147 {
148 	if (DAT_BAD_HANDLE(cno_handle)) {
149 		return (DAT_ERROR(DAT_INVALID_HANDLE, DAT_INVALID_HANDLE_CNO));
150 	}
151 	return (DAT_CNO_FREE(cno_handle));
152 }
153 
154 
155 DAT_RETURN dat_cno_wait(
156 	IN  	DAT_CNO_HANDLE		cno_handle,
157 	IN  	DAT_TIMEOUT		timeout,
158 	OUT 	DAT_EVD_HANDLE		*evd_handle)
159 {
160 	if (DAT_BAD_HANDLE(cno_handle)) {
161 		return (DAT_ERROR(DAT_INVALID_HANDLE, DAT_INVALID_HANDLE_CNO));
162 	}
163 	return DAT_CNO_WAIT(cno_handle,
164 			timeout,
165 			evd_handle);
166 }
167 
168 
169 DAT_RETURN dat_evd_enable(
170 	IN	DAT_EVD_HANDLE		evd_handle)
171 {
172 	if (DAT_BAD_HANDLE(evd_handle)) {
173 		return (DAT_ERROR(DAT_INVALID_HANDLE, DAT_INVALID_HANDLE1));
174 	}
175 	return (DAT_EVD_ENABLE(evd_handle));
176 }
177 
178 
179 DAT_RETURN dat_evd_wait(
180 	IN  	DAT_EVD_HANDLE		evd_handle,
181 	IN  	DAT_TIMEOUT		Timeout,
182 	IN  	DAT_COUNT		Threshold,
183 	OUT 	DAT_EVENT		*event,
184 	OUT 	DAT_COUNT		*n_more_events)
185 {
186 	if (DAT_BAD_HANDLE(evd_handle)) {
187 		return (DAT_ERROR(DAT_INVALID_HANDLE, DAT_INVALID_HANDLE1));
188 	}
189 	return DAT_EVD_WAIT(evd_handle,
190 			Timeout,
191 			Threshold,
192 			event,
193 			n_more_events);
194 }
195 
196 
197 DAT_RETURN dat_evd_disable(
198 	IN	DAT_EVD_HANDLE		evd_handle)
199 {
200 	if (DAT_BAD_HANDLE(evd_handle)) {
201 		return (DAT_ERROR(DAT_INVALID_HANDLE, DAT_INVALID_HANDLE1));
202 	}
203 	return (DAT_EVD_DISABLE(evd_handle));
204 }
205 
206 
207 DAT_RETURN dat_evd_set_unwaitable(
208 	IN 	DAT_EVD_HANDLE		 evd_handle)
209 {
210 	if (DAT_BAD_HANDLE(evd_handle)) {
211 		return (DAT_ERROR(DAT_INVALID_HANDLE, DAT_INVALID_HANDLE1));
212 	}
213 	return (DAT_EVD_SET_UNWAITABLE(evd_handle));
214 }
215 
216 DAT_RETURN dat_evd_clear_unwaitable(
217 	IN 	DAT_EVD_HANDLE		 evd_handle)
218 {
219 	if (DAT_BAD_HANDLE(evd_handle)) {
220 		return (DAT_ERROR(DAT_INVALID_HANDLE, DAT_INVALID_HANDLE1));
221 	}
222 	return (DAT_EVD_CLEAR_UNWAITABLE(evd_handle));
223 }
224 
225 DAT_RETURN dat_cr_handoff(
226 	IN	DAT_CR_HANDLE		cr_handle,
227 	IN	DAT_CONN_QUAL		handoff)
228 {
229 	if (DAT_BAD_HANDLE(cr_handle)) {
230 		return (DAT_ERROR(DAT_INVALID_HANDLE, DAT_INVALID_HANDLE_CR));
231 	}
232 	return DAT_CR_HANDOFF(cr_handle,
233 			handoff);
234 }
235 
236 
237 DAT_RETURN dat_psp_create_any(
238 	IN	DAT_IA_HANDLE		ia_handle,
239 	OUT	DAT_CONN_QUAL		*conn_qual,
240 	IN	DAT_EVD_HANDLE		evd_handle,
241 	IN	DAT_PSP_FLAGS		psp_flags,
242 	OUT	DAT_PSP_HANDLE		*psp_handle)
243 {
244 	if (DAT_BAD_HANDLE(ia_handle)) {
245 		return (DAT_ERROR(DAT_INVALID_HANDLE, DAT_INVALID_HANDLE_IA));
246 	}
247 	return DAT_PSP_CREATE_ANY(ia_handle,
248 			    conn_qual,
249 			    evd_handle,
250 			    psp_flags,
251 			    psp_handle);
252 }
253 
254 
255 DAT_RETURN dat_ia_query(
256 	IN	DAT_IA_HANDLE		ia_handle,
257 	OUT	DAT_EVD_HANDLE		*async_evd_handle,
258 	IN	DAT_IA_ATTR_MASK	ia_attr_mask,
259 	OUT	DAT_IA_ATTR		*ia_attr,
260 	IN	DAT_PROVIDER_ATTR_MASK	provider_attr_mask,
261 	OUT	DAT_PROVIDER_ATTR 	*provider_attr)
262 {
263 	if (DAT_BAD_HANDLE(ia_handle)) {
264 		return (DAT_ERROR(DAT_INVALID_HANDLE, DAT_INVALID_HANDLE_IA));
265 	}
266 	return DAT_IA_QUERY(ia_handle,
267 			async_evd_handle,
268 			ia_attr_mask,
269 			ia_attr,
270 			provider_attr_mask,
271 			provider_attr);
272 }
273 
274 
275 DAT_RETURN dat_evd_query(
276 	IN	DAT_EVD_HANDLE		evd_handle,
277 	IN	DAT_EVD_PARAM_MASK	evd_param_mask,
278 	OUT	DAT_EVD_PARAM		*evd_param)
279 {
280 	if (DAT_BAD_HANDLE(evd_handle)) {
281 		return (DAT_ERROR(DAT_INVALID_HANDLE, DAT_INVALID_HANDLE1));
282 	}
283 	return DAT_EVD_QUERY(evd_handle,
284 			evd_param_mask,
285 			evd_param);
286 }
287 
288 
289 DAT_RETURN dat_lmr_query(
290 	IN	DAT_LMR_HANDLE		lmr_handle,
291 	IN	DAT_LMR_PARAM_MASK	lmv_param_mask,
292 	OUT	DAT_LMR_PARAM		*lmr_param)
293 {
294 	if (DAT_BAD_HANDLE(lmr_handle)) {
295 		return (DAT_ERROR(DAT_INVALID_HANDLE, DAT_INVALID_HANDLE_LMR));
296 	}
297 	return DAT_LMR_QUERY(lmr_handle,
298 		    lmv_param_mask,
299 		    lmr_param);
300 }
301