Rev 2618 | Rev 2620 | Go to most recent revision | Only display areas with differences | Ignore whitespace | Details | Blame | Last modification | View Log | RSS feed
Rev 2618 | Rev 2619 | ||
---|---|---|---|
1 | /* |
1 | /* |
2 | * Copyright (c) 2006 Ondrej Palkovsky |
2 | * Copyright (c) 2006 Ondrej Palkovsky |
3 | * All rights reserved. |
3 | * All rights reserved. |
4 | * |
4 | * |
5 | * Redistribution and use in source and binary forms, with or without |
5 | * Redistribution and use in source and binary forms, with or without |
6 | * modification, are permitted provided that the following conditions |
6 | * modification, are permitted provided that the following conditions |
7 | * are met: |
7 | * are met: |
8 | * |
8 | * |
9 | * - Redistributions of source code must retain the above copyright |
9 | * - Redistributions of source code must retain the above copyright |
10 | * notice, this list of conditions and the following disclaimer. |
10 | * notice, this list of conditions and the following disclaimer. |
11 | * - Redistributions in binary form must reproduce the above copyright |
11 | * - Redistributions in binary form must reproduce the above copyright |
12 | * notice, this list of conditions and the following disclaimer in the |
12 | * notice, this list of conditions and the following disclaimer in the |
13 | * documentation and/or other materials provided with the distribution. |
13 | * documentation and/or other materials provided with the distribution. |
14 | * - The name of the author may not be used to endorse or promote products |
14 | * - The name of the author may not be used to endorse or promote products |
15 | * derived from this software without specific prior written permission. |
15 | * derived from this software without specific prior written permission. |
16 | * |
16 | * |
17 | * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR |
17 | * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR |
18 | * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES |
18 | * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES |
19 | * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. |
19 | * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. |
20 | * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, |
20 | * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, |
21 | * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT |
21 | * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT |
22 | * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, |
22 | * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, |
23 | * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY |
23 | * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY |
24 | * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT |
24 | * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT |
25 | * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF |
25 | * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF |
26 | * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
26 | * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
27 | */ |
27 | */ |
28 | 28 | ||
29 | /** @addtogroup libc |
29 | /** @addtogroup libc |
30 | * @{ |
30 | * @{ |
31 | * @} |
31 | * @} |
32 | */ |
32 | */ |
33 | 33 | ||
34 | /** @addtogroup libcipc IPC |
34 | /** @addtogroup libcipc IPC |
35 | * @brief HelenOS uspace IPC |
35 | * @brief HelenOS uspace IPC |
36 | * @{ |
36 | * @{ |
37 | * @ingroup libc |
37 | * @ingroup libc |
38 | */ |
38 | */ |
39 | /** @file |
39 | /** @file |
40 | */ |
40 | */ |
41 | 41 | ||
42 | #include <ipc/ipc.h> |
42 | #include <ipc/ipc.h> |
43 | #include <libc.h> |
43 | #include <libc.h> |
44 | #include <malloc.h> |
44 | #include <malloc.h> |
45 | #include <errno.h> |
45 | #include <errno.h> |
46 | #include <libadt/list.h> |
46 | #include <libadt/list.h> |
47 | #include <stdio.h> |
47 | #include <stdio.h> |
48 | #include <unistd.h> |
48 | #include <unistd.h> |
49 | #include <futex.h> |
49 | #include <futex.h> |
50 | #include <kernel/synch/synch.h> |
50 | #include <kernel/synch/synch.h> |
51 | #include <async.h> |
51 | #include <async.h> |
52 | #include <fibril.h> |
52 | #include <fibril.h> |
53 | #include <assert.h> |
53 | #include <assert.h> |
54 | 54 | ||
55 | /** |
55 | /** |
56 | * Structures of this type are used for keeping track of sent asynchronous calls |
56 | * Structures of this type are used for keeping track of sent asynchronous calls |
57 | * and queing unsent calls. |
57 | * and queing unsent calls. |
58 | */ |
58 | */ |
59 | typedef struct { |
59 | typedef struct { |
60 | link_t list; |
60 | link_t list; |
61 | 61 | ||
62 | ipc_async_callback_t callback; |
62 | ipc_async_callback_t callback; |
63 | void *private; |
63 | void *private; |
64 | union { |
64 | union { |
65 | ipc_callid_t callid; |
65 | ipc_callid_t callid; |
66 | struct { |
66 | struct { |
67 | ipc_call_t data; |
67 | ipc_call_t data; |
68 | int phoneid; |
68 | int phoneid; |
69 | } msg; |
69 | } msg; |
70 | } u; |
70 | } u; |
71 | fid_t fid; /**< Fibril waiting for sending this call. */ |
71 | fid_t fid; /**< Fibril waiting for sending this call. */ |
72 | } async_call_t; |
72 | } async_call_t; |
73 | 73 | ||
74 | LIST_INITIALIZE(dispatched_calls); |
74 | LIST_INITIALIZE(dispatched_calls); |
75 | 75 | ||
76 | /** List of asynchronous calls that were not accepted by kernel. |
76 | /** List of asynchronous calls that were not accepted by kernel. |
77 | * |
77 | * |
78 | * It is protected by async_futex, because if the call cannot be sent into the |
78 | * It is protected by async_futex, because if the call cannot be sent into the |
79 | * kernel, the async framework is used automatically. |
79 | * kernel, the async framework is used automatically. |
80 | */ |
80 | */ |
81 | LIST_INITIALIZE(queued_calls); |
81 | LIST_INITIALIZE(queued_calls); |
82 | 82 | ||
83 | static atomic_t ipc_futex = FUTEX_INITIALIZER; |
83 | static atomic_t ipc_futex = FUTEX_INITIALIZER; |
84 | 84 | ||
85 | /** Make a fast synchronous call. |
85 | /** Make a fast synchronous call. |
86 | * |
86 | * |
87 | * Only three payload arguments can be passed using this function. However, this |
87 | * Only three payload arguments can be passed using this function. However, this |
88 | * function is faster than the generic ipc_call_sync_slow() because the payload |
88 | * function is faster than the generic ipc_call_sync_slow() because the payload |
89 | * is passed directly in registers. |
89 | * is passed directly in registers. |
90 | * |
90 | * |
91 | * @param phoneid Phone handle for the call. |
91 | * @param phoneid Phone handle for the call. |
92 | * @param method Requested method. |
92 | * @param method Requested method. |
93 | * @param arg1 Service-defined payload argument. |
93 | * @param arg1 Service-defined payload argument. |
94 | * @param arg2 Service-defined payload argument. |
94 | * @param arg2 Service-defined payload argument. |
95 | * @param arg3 Service-defined payload argument. |
95 | * @param arg3 Service-defined payload argument. |
96 | * @param result1 If non-NULL, the return ARG1 will be stored there. |
96 | * @param result1 If non-NULL, the return ARG1 will be stored there. |
97 | * @param result2 If non-NULL, the return ARG2 will be stored there. |
97 | * @param result2 If non-NULL, the return ARG2 will be stored there. |
98 | * @param result3 If non-NULL, the return ARG3 will be stored there. |
98 | * @param result3 If non-NULL, the return ARG3 will be stored there. |
99 | * @param result4 If non-NULL, the return ARG4 will be stored there. |
99 | * @param result4 If non-NULL, the return ARG4 will be stored there. |
100 | * @param result5 If non-NULL, the return ARG5 will be stored there. |
100 | * @param result5 If non-NULL, the return ARG5 will be stored there. |
101 | * |
101 | * |
102 | * @return Negative values represent errors returned by IPC. |
102 | * @return Negative values represent errors returned by IPC. |
103 | * Otherwise the RETVAL of the answer is returned. |
103 | * Otherwise the RETVAL of the answer is returned. |
104 | */ |
104 | */ |
105 | int |
105 | int |
106 | ipc_call_sync_fast(int phoneid, ipcarg_t method, ipcarg_t arg1, ipcarg_t arg2, |
106 | ipc_call_sync_fast(int phoneid, ipcarg_t method, ipcarg_t arg1, ipcarg_t arg2, |
107 | ipcarg_t arg3, ipcarg_t *result1, ipcarg_t *result2, ipcarg_t *result3, |
107 | ipcarg_t arg3, ipcarg_t *result1, ipcarg_t *result2, ipcarg_t *result3, |
108 | ipcarg_t *result4, ipcarg_t *result5) |
108 | ipcarg_t *result4, ipcarg_t *result5) |
109 | { |
109 | { |
110 | ipc_call_t resdata; |
110 | ipc_call_t resdata; |
111 | int callres; |
111 | int callres; |
112 | 112 | ||
113 | callres = __SYSCALL6(SYS_IPC_CALL_SYNC_FAST, phoneid, method, arg1, |
113 | callres = __SYSCALL6(SYS_IPC_CALL_SYNC_FAST, phoneid, method, arg1, |
114 | arg2, arg3, (sysarg_t) &resdata); |
114 | arg2, arg3, (sysarg_t) &resdata); |
115 | if (callres) |
115 | if (callres) |
116 | return callres; |
116 | return callres; |
117 | if (result1) |
117 | if (result1) |
118 | *result1 = IPC_GET_ARG1(resdata); |
118 | *result1 = IPC_GET_ARG1(resdata); |
119 | if (result2) |
119 | if (result2) |
120 | *result2 = IPC_GET_ARG2(resdata); |
120 | *result2 = IPC_GET_ARG2(resdata); |
121 | if (result3) |
121 | if (result3) |
122 | *result3 = IPC_GET_ARG3(resdata); |
122 | *result3 = IPC_GET_ARG3(resdata); |
123 | if (result4) |
123 | if (result4) |
124 | *result4 = IPC_GET_ARG4(resdata); |
124 | *result4 = IPC_GET_ARG4(resdata); |
125 | if (result5) |
125 | if (result5) |
126 | *result5 = IPC_GET_ARG5(resdata); |
126 | *result5 = IPC_GET_ARG5(resdata); |
127 | 127 | ||
128 | return IPC_GET_RETVAL(resdata); |
128 | return IPC_GET_RETVAL(resdata); |
129 | } |
129 | } |
130 | 130 | ||
131 | /** Make a synchronous call transmitting 5 arguments of payload. |
131 | /** Make a synchronous call transmitting 5 arguments of payload. |
132 | * |
132 | * |
133 | * @param phoneid Phone handle for the call. |
133 | * @param phoneid Phone handle for the call. |
134 | * @param method Requested method. |
134 | * @param method Requested method. |
135 | * @param arg1 Service-defined payload argument. |
135 | * @param arg1 Service-defined payload argument. |
136 | * @param arg2 Service-defined payload argument. |
136 | * @param arg2 Service-defined payload argument. |
137 | * @param arg3 Service-defined payload argument. |
137 | * @param arg3 Service-defined payload argument. |
138 | * @param arg4 Service-defined payload argument. |
138 | * @param arg4 Service-defined payload argument. |
139 | * @param arg5 Service-defined payload argument. |
139 | * @param arg5 Service-defined payload argument. |
140 | * @param result1 If non-NULL, storage for the first return argument. |
140 | * @param result1 If non-NULL, storage for the first return argument. |
141 | * @param result2 If non-NULL, storage for the second return argument. |
141 | * @param result2 If non-NULL, storage for the second return argument. |
142 | * @param result3 If non-NULL, storage for the third return argument. |
142 | * @param result3 If non-NULL, storage for the third return argument. |
143 | * @param result4 If non-NULL, storage for the fourth return argument. |
143 | * @param result4 If non-NULL, storage for the fourth return argument. |
144 | * @param result5 If non-NULL, storage for the fifth return argument. |
144 | * @param result5 If non-NULL, storage for the fifth return argument. |
145 | * |
145 | * |
146 | * @return Negative value means IPC error. |
146 | * @return Negative value means IPC error. |
147 | * Otherwise the RETVAL of the answer. |
147 | * Otherwise the RETVAL of the answer. |
148 | */ |
148 | */ |
149 | int |
149 | int |
150 | ipc_call_sync_slow(int phoneid, ipcarg_t method, ipcarg_t arg1, ipcarg_t arg2, |
150 | ipc_call_sync_slow(int phoneid, ipcarg_t method, ipcarg_t arg1, ipcarg_t arg2, |
151 | ipcarg_t arg3, ipcarg_t arg4, ipcarg_t arg5, ipcarg_t *result1, |
151 | ipcarg_t arg3, ipcarg_t arg4, ipcarg_t arg5, ipcarg_t *result1, |
152 | ipcarg_t *result2, ipcarg_t *result3, ipcarg_t *result4, ipcarg_t *result5) |
152 | ipcarg_t *result2, ipcarg_t *result3, ipcarg_t *result4, ipcarg_t *result5) |
153 | { |
153 | { |
154 | ipc_call_t data; |
154 | ipc_call_t data; |
155 | int callres; |
155 | int callres; |
156 | 156 | ||
157 | IPC_SET_METHOD(data, method); |
157 | IPC_SET_METHOD(data, method); |
158 | IPC_SET_ARG1(data, arg1); |
158 | IPC_SET_ARG1(data, arg1); |
159 | IPC_SET_ARG2(data, arg2); |
159 | IPC_SET_ARG2(data, arg2); |
160 | IPC_SET_ARG3(data, arg3); |
160 | IPC_SET_ARG3(data, arg3); |
161 | IPC_SET_ARG4(data, arg4); |
161 | IPC_SET_ARG4(data, arg4); |
162 | IPC_SET_ARG5(data, arg5); |
162 | IPC_SET_ARG5(data, arg5); |
163 | 163 | ||
164 | callres = __SYSCALL3(SYS_IPC_CALL_SYNC_SLOW, phoneid, (sysarg_t) &data, |
164 | callres = __SYSCALL3(SYS_IPC_CALL_SYNC_SLOW, phoneid, (sysarg_t) &data, |
165 | (sysarg_t) &data); |
165 | (sysarg_t) &data); |
166 | if (callres) |
166 | if (callres) |
167 | return callres; |
167 | return callres; |
168 | 168 | ||
169 | if (result1) |
169 | if (result1) |
170 | *result1 = IPC_GET_ARG1(data); |
170 | *result1 = IPC_GET_ARG1(data); |
171 | if (result2) |
171 | if (result2) |
172 | *result2 = IPC_GET_ARG2(data); |
172 | *result2 = IPC_GET_ARG2(data); |
173 | if (result3) |
173 | if (result3) |
174 | *result3 = IPC_GET_ARG3(data); |
174 | *result3 = IPC_GET_ARG3(data); |
175 | if (result4) |
175 | if (result4) |
176 | *result4 = IPC_GET_ARG4(data); |
176 | *result4 = IPC_GET_ARG4(data); |
177 | if (result5) |
177 | if (result5) |
178 | *result5 = IPC_GET_ARG5(data); |
178 | *result5 = IPC_GET_ARG5(data); |
179 | 179 | ||
180 | return IPC_GET_RETVAL(data); |
180 | return IPC_GET_RETVAL(data); |
181 | } |
181 | } |
182 | 182 | ||
183 | /** Syscall to send asynchronous message. |
183 | /** Syscall to send asynchronous message. |
184 | * |
184 | * |
185 | * @param phoneid Phone handle for the call. |
185 | * @param phoneid Phone handle for the call. |
186 | * @param data Call data with the request. |
186 | * @param data Call data with the request. |
187 | * |
187 | * |
188 | * @return Hash of the call or an error code. |
188 | * @return Hash of the call or an error code. |
189 | */ |
189 | */ |
190 | static ipc_callid_t _ipc_call_async(int phoneid, ipc_call_t *data) |
190 | static ipc_callid_t _ipc_call_async(int phoneid, ipc_call_t *data) |
191 | { |
191 | { |
192 | return __SYSCALL2(SYS_IPC_CALL_ASYNC_SLOW, phoneid, (sysarg_t) data); |
192 | return __SYSCALL2(SYS_IPC_CALL_ASYNC_SLOW, phoneid, (sysarg_t) data); |
193 | } |
193 | } |
194 | 194 | ||
195 | /** Prolog to ipc_call_async_*() functions. |
195 | /** Prolog to ipc_call_async_*() functions. |
196 | * |
196 | * |
197 | * @param private Argument for the answer/error callback. |
197 | * @param private Argument for the answer/error callback. |
198 | * @param callback Answer/error callback. |
198 | * @param callback Answer/error callback. |
199 | * |
199 | * |
200 | * @return New, partially initialized async_call structure or NULL. |
200 | * @return New, partially initialized async_call structure or NULL. |
201 | */ |
201 | */ |
202 | static inline async_call_t *ipc_prepare_async(void *private, |
202 | static inline async_call_t *ipc_prepare_async(void *private, |
203 | ipc_async_callback_t callback) |
203 | ipc_async_callback_t callback) |
204 | { |
204 | { |
205 | async_call_t *call; |
205 | async_call_t *call; |
206 | 206 | ||
207 | call = malloc(sizeof(*call)); |
207 | call = malloc(sizeof(*call)); |
208 | if (!call) { |
208 | if (!call) { |
209 | if (callback) |
209 | if (callback) |
210 | callback(private, ENOMEM, NULL); |
210 | callback(private, ENOMEM, NULL); |
211 | return NULL; |
211 | return NULL; |
212 | } |
212 | } |
213 | call->callback = callback; |
213 | call->callback = callback; |
214 | call->private = private; |
214 | call->private = private; |
215 | 215 | ||
216 | return call; |
216 | return call; |
217 | } |
217 | } |
218 | 218 | ||
219 | /** Epilogue of ipc_call_async_*() functions. |
219 | /** Epilogue of ipc_call_async_*() functions. |
220 | * |
220 | * |
221 | * @param callid Value returned by the SYS_IPC_CALL_ASYNC_* syscall. |
221 | * @param callid Value returned by the SYS_IPC_CALL_ASYNC_* syscall. |
222 | * @param phoneid Phone handle through which the call was made. |
222 | * @param phoneid Phone handle through which the call was made. |
223 | * @param call async_call structure returned by ipc_prepare_async(). |
223 | * @param call async_call structure returned by ipc_prepare_async(). |
224 | * @param can_preempt If non-zero, the current fibril can be preempted in this |
224 | * @param can_preempt If non-zero, the current fibril can be preempted in this |
225 | * call. |
225 | * call. |
226 | */ |
226 | */ |
227 | static inline void ipc_finish_async(ipc_callid_t callid, int phoneid, |
227 | static inline void ipc_finish_async(ipc_callid_t callid, int phoneid, |
228 | async_call_t *call, int can_preempt) |
228 | async_call_t *call, int can_preempt) |
229 | { |
229 | { |
230 | if (!call) { /* Nothing to do regardless if failed or not */ |
230 | if (!call) { /* Nothing to do regardless if failed or not */ |
231 | futex_up(&ipc_futex); |
231 | futex_up(&ipc_futex); |
232 | return; |
232 | return; |
233 | } |
233 | } |
234 | 234 | ||
235 | if (callid == IPC_CALLRET_FATAL) { |
235 | if (callid == IPC_CALLRET_FATAL) { |
236 | futex_up(&ipc_futex); |
236 | futex_up(&ipc_futex); |
237 | /* Call asynchronous handler with error code */ |
237 | /* Call asynchronous handler with error code */ |
238 | if (call->callback) |
238 | if (call->callback) |
239 | call->callback(call->private, ENOENT, NULL); |
239 | call->callback(call->private, ENOENT, NULL); |
240 | free(call); |
240 | free(call); |
241 | return; |
241 | return; |
242 | } |
242 | } |
243 | 243 | ||
244 | if (callid == IPC_CALLRET_TEMPORARY) { |
244 | if (callid == IPC_CALLRET_TEMPORARY) { |
245 | futex_up(&ipc_futex); |
245 | futex_up(&ipc_futex); |
246 | 246 | ||
247 | call->u.msg.phoneid = phoneid; |
247 | call->u.msg.phoneid = phoneid; |
248 | 248 | ||
249 | futex_down(&async_futex); |
249 | futex_down(&async_futex); |
250 | list_append(&call->list, &queued_calls); |
250 | list_append(&call->list, &queued_calls); |
251 | 251 | ||
252 | if (can_preempt) { |
252 | if (can_preempt) { |
253 | call->fid = fibril_get_id(); |
253 | call->fid = fibril_get_id(); |
254 | fibril_switch(FIBRIL_TO_MANAGER); |
254 | fibril_switch(FIBRIL_TO_MANAGER); |
255 | /* Async futex unlocked by previous call */ |
255 | /* Async futex unlocked by previous call */ |
256 | } else { |
256 | } else { |
257 | call->fid = 0; |
257 | call->fid = 0; |
258 | futex_up(&async_futex); |
258 | futex_up(&async_futex); |
259 | } |
259 | } |
260 | return; |
260 | return; |
261 | } |
261 | } |
262 | call->u.callid = callid; |
262 | call->u.callid = callid; |
263 | /* Add call to the list of dispatched calls */ |
263 | /* Add call to the list of dispatched calls */ |
264 | list_append(&call->list, &dispatched_calls); |
264 | list_append(&call->list, &dispatched_calls); |
265 | futex_up(&ipc_futex); |
265 | futex_up(&ipc_futex); |
266 | 266 | ||
267 | } |
267 | } |
268 | 268 | ||
269 | /** Make a fast asynchronous call. |
269 | /** Make a fast asynchronous call. |
270 | * |
270 | * |
271 | * This function can only handle four arguments of payload. It is, however, |
271 | * This function can only handle four arguments of payload. It is, however, |
272 | * faster than the more generic ipc_call_async_slow(). |
272 | * faster than the more generic ipc_call_async_slow(). |
273 | * |
273 | * |
274 | * Note that this function is a void function. |
274 | * Note that this function is a void function. |
275 | * During normal opertation, answering this call will trigger the callback. |
275 | * During normal opertation, answering this call will trigger the callback. |
276 | * In case of fatal error, call the callback handler with the proper error code. |
276 | * In case of fatal error, call the callback handler with the proper error code. |
277 | * If the call cannot be temporarily made, queue it. |
277 | * If the call cannot be temporarily made, queue it. |
278 | * |
278 | * |
279 | * @param phoneid Phone handle for the call. |
279 | * @param phoneid Phone handle for the call. |
280 | * @param method Requested method. |
280 | * @param method Requested method. |
281 | * @param arg1 Service-defined payload argument. |
281 | * @param arg1 Service-defined payload argument. |
282 | * @param arg2 Service-defined payload argument. |
282 | * @param arg2 Service-defined payload argument. |
283 | * @param arg3 Service-defined payload argument. |
283 | * @param arg3 Service-defined payload argument. |
284 | * @param arg4 Service-defined payload argument. |
284 | * @param arg4 Service-defined payload argument. |
285 | * @param private Argument to be passed to the answer/error callback. |
285 | * @param private Argument to be passed to the answer/error callback. |
286 | * @param callback Answer or error callback. |
286 | * @param callback Answer or error callback. |
287 | * @param can_preempt If non-zero, the current fibril will be preempted in |
287 | * @param can_preempt If non-zero, the current fibril will be preempted in |
288 | * case the kernel temporarily refuses to accept more |
288 | * case the kernel temporarily refuses to accept more |
289 | * asynchronous calls. |
289 | * asynchronous calls. |
290 | */ |
290 | */ |
291 | void ipc_call_async_fast(int phoneid, ipcarg_t method, ipcarg_t arg1, |
291 | void ipc_call_async_fast(int phoneid, ipcarg_t method, ipcarg_t arg1, |
292 | ipcarg_t arg2, ipcarg_t arg3, ipcarg_t arg4, void *private, |
292 | ipcarg_t arg2, ipcarg_t arg3, ipcarg_t arg4, void *private, |
293 | ipc_async_callback_t callback, int can_preempt) |
293 | ipc_async_callback_t callback, int can_preempt) |
294 | { |
294 | { |
295 | async_call_t *call = NULL; |
295 | async_call_t *call = NULL; |
296 | ipc_callid_t callid; |
296 | ipc_callid_t callid; |
297 | 297 | ||
298 | if (callback) { |
298 | if (callback) { |
299 | call = ipc_prepare_async(private, callback); |
299 | call = ipc_prepare_async(private, callback); |
300 | if (!call) |
300 | if (!call) |
301 | return; |
301 | return; |
302 | } |
302 | } |
303 | 303 | ||
304 | /* |
304 | /* |
305 | * We need to make sure that we get callid before another thread |
305 | * We need to make sure that we get callid before another thread |
306 | * accesses the queue again. |
306 | * accesses the queue again. |
307 | */ |
307 | */ |
308 | futex_down(&ipc_futex); |
308 | futex_down(&ipc_futex); |
309 | callid = __SYSCALL6(SYS_IPC_CALL_ASYNC_FAST, phoneid, method, arg1, |
309 | callid = __SYSCALL6(SYS_IPC_CALL_ASYNC_FAST, phoneid, method, arg1, |
310 | arg2, arg3, arg4); |
310 | arg2, arg3, arg4); |
311 | 311 | ||
312 | if (callid == IPC_CALLRET_TEMPORARY) { |
312 | if (callid == IPC_CALLRET_TEMPORARY) { |
313 | if (!call) { |
313 | if (!call) { |
314 | call = ipc_prepare_async(private, callback); |
314 | call = ipc_prepare_async(private, callback); |
315 | if (!call) |
315 | if (!call) |
316 | return; |
316 | return; |
317 | } |
317 | } |
318 | IPC_SET_METHOD(call->u.msg.data, method); |
318 | IPC_SET_METHOD(call->u.msg.data, method); |
319 | IPC_SET_ARG1(call->u.msg.data, arg1); |
319 | IPC_SET_ARG1(call->u.msg.data, arg1); |
320 | IPC_SET_ARG2(call->u.msg.data, arg2); |
320 | IPC_SET_ARG2(call->u.msg.data, arg2); |
321 | IPC_SET_ARG3(call->u.msg.data, arg3); |
321 | IPC_SET_ARG3(call->u.msg.data, arg3); |
322 | IPC_SET_ARG4(call->u.msg.data, arg4); |
322 | IPC_SET_ARG4(call->u.msg.data, arg4); |
323 | } |
323 | } |
324 | ipc_finish_async(callid, phoneid, call, can_preempt); |
324 | ipc_finish_async(callid, phoneid, call, can_preempt); |
325 | } |
325 | } |
326 | 326 | ||
327 | /** Make an asynchronous call transmitting the entire payload. |
327 | /** Make an asynchronous call transmitting the entire payload. |
328 | * |
328 | * |
329 | * Note that this function is a void function. |
329 | * Note that this function is a void function. |
330 | * During normal opertation, answering this call will trigger the callback. |
330 | * During normal opertation, answering this call will trigger the callback. |
331 | * In case of fatal error, call the callback handler with the proper error code. |
331 | * In case of fatal error, call the callback handler with the proper error code. |
332 | * If the call cannot be temporarily made, queue it. |
332 | * If the call cannot be temporarily made, queue it. |
333 | * |
333 | * |
334 | * @param phoneid Phone handle for the call. |
334 | * @param phoneid Phone handle for the call. |
335 | * @param method Requested method. |
335 | * @param method Requested method. |
336 | * @param arg1 Service-defined payload argument. |
336 | * @param arg1 Service-defined payload argument. |
337 | * @param arg2 Service-defined payload argument. |
337 | * @param arg2 Service-defined payload argument. |
338 | * @param arg3 Service-defined payload argument. |
338 | * @param arg3 Service-defined payload argument. |
339 | * @param arg4 Service-defined payload argument. |
339 | * @param arg4 Service-defined payload argument. |
340 | * @param arg5 Service-defined payload argument. |
340 | * @param arg5 Service-defined payload argument. |
341 | * @param private Argument to be passed to the answer/error callback. |
341 | * @param private Argument to be passed to the answer/error callback. |
342 | * @param callback Answer or error callback. |
342 | * @param callback Answer or error callback. |
343 | * @param can_preempt If non-zero, the current fibril will be preempted in |
343 | * @param can_preempt If non-zero, the current fibril will be preempted in |
344 | * case the kernel temporarily refuses to accept more |
344 | * case the kernel temporarily refuses to accept more |
345 | * asynchronous calls. |
345 | * asynchronous calls. |
346 | * |
346 | * |
347 | */ |
347 | */ |
348 | void ipc_call_async_slow(int phoneid, ipcarg_t method, ipcarg_t arg1, |
348 | void ipc_call_async_slow(int phoneid, ipcarg_t method, ipcarg_t arg1, |
349 | ipcarg_t arg2, ipcarg_t arg3, ipcarg_t arg4, ipcarg_t arg5, void *private, |
349 | ipcarg_t arg2, ipcarg_t arg3, ipcarg_t arg4, ipcarg_t arg5, void *private, |
350 | ipc_async_callback_t callback, int can_preempt) |
350 | ipc_async_callback_t callback, int can_preempt) |
351 | { |
351 | { |
352 | async_call_t *call; |
352 | async_call_t *call; |
353 | ipc_callid_t callid; |
353 | ipc_callid_t callid; |
354 | 354 | ||
355 | call = ipc_prepare_async(private, callback); |
355 | call = ipc_prepare_async(private, callback); |
356 | if (!call) |
356 | if (!call) |
357 | return; |
357 | return; |
358 | 358 | ||
359 | IPC_SET_METHOD(call->u.msg.data, method); |
359 | IPC_SET_METHOD(call->u.msg.data, method); |
360 | IPC_SET_ARG1(call->u.msg.data, arg1); |
360 | IPC_SET_ARG1(call->u.msg.data, arg1); |
361 | IPC_SET_ARG2(call->u.msg.data, arg2); |
361 | IPC_SET_ARG2(call->u.msg.data, arg2); |
362 | IPC_SET_ARG3(call->u.msg.data, arg3); |
362 | IPC_SET_ARG3(call->u.msg.data, arg3); |
363 | IPC_SET_ARG4(call->u.msg.data, arg4); |
363 | IPC_SET_ARG4(call->u.msg.data, arg4); |
364 | IPC_SET_ARG5(call->u.msg.data, arg5); |
364 | IPC_SET_ARG5(call->u.msg.data, arg5); |
365 | /* |
365 | /* |
366 | * We need to make sure that we get callid before another thread |
366 | * We need to make sure that we get callid before another thread |
367 | * accesses the queue again. |
367 | * accesses the queue again. |
368 | */ |
368 | */ |
369 | futex_down(&ipc_futex); |
369 | futex_down(&ipc_futex); |
370 | callid = _ipc_call_async(phoneid, &call->u.msg.data); |
370 | callid = _ipc_call_async(phoneid, &call->u.msg.data); |
371 | 371 | ||
372 | ipc_finish_async(callid, phoneid, call, can_preempt); |
372 | ipc_finish_async(callid, phoneid, call, can_preempt); |
373 | } |
373 | } |
374 | 374 | ||
375 | 375 | ||
376 | /** Answer a received call - fast version. |
376 | /** Answer a received call - fast version. |
377 | * |
377 | * |
378 | * The fast answer makes use of passing retval and first two arguments in |
378 | * The fast answer makes use of passing retval and first four arguments in |
379 | * registers. If you need to return more, use the ipc_answer() instead. |
379 | * registers. If you need to return more, use the ipc_answer_slow() instead. |
380 | * |
380 | * |
381 | * @param callid Hash of the call being answered. |
381 | * @param callid Hash of the call being answered. |
382 | * @param retval Return value. |
382 | * @param retval Return value. |
383 | * @param arg1 First return argument. |
383 | * @param arg1 First return argument. |
384 | * @param arg2 Second return argument. |
384 | * @param arg2 Second return argument. |
- | 385 | * @param arg3 Third return argument. |
|
- | 386 | * @param arg4 Fourth return argument. |
|
385 | * |
387 | * |
386 | * @return Zero on success or a value from @ref errno.h on failure. |
388 | * @return Zero on success or a value from @ref errno.h on failure. |
387 | */ |
389 | */ |
388 | ipcarg_t ipc_answer_fast(ipc_callid_t callid, ipcarg_t retval, ipcarg_t arg1, |
390 | ipcarg_t ipc_answer_fast(ipc_callid_t callid, ipcarg_t retval, ipcarg_t arg1, |
389 | ipcarg_t arg2) |
391 | ipcarg_t arg2, ipcarg_t arg3, ipcarg_t arg4) |
390 | { |
392 | { |
391 | return __SYSCALL4(SYS_IPC_ANSWER_FAST, callid, retval, arg1, arg2); |
393 | return __SYSCALL6(SYS_IPC_ANSWER_FAST, callid, retval, arg1, arg2, arg3, |
- | 394 | arg4); |
|
392 | } |
395 | } |
393 | 396 | ||
394 | /** Answer a received call - full version. |
397 | /** Answer a received call - slow full version. |
395 | * |
398 | * |
396 | * @param callid Hash of the call being answered. |
399 | * @param callid Hash of the call being answered. |
- | 400 | * @param retval Return value. |
|
397 | * @param call Call structure with the answer. |
401 | * @param arg1 First return argument. |
- | 402 | * @param arg2 Second return argument. |
|
- | 403 | * @param arg3 Third return argument. |
|
- | 404 | * @param arg4 Fourth return argument. |
|
398 | * Must be already initialized by the responder. |
405 | * @param arg5 Fifth return argument. |
399 | * |
406 | * |
400 | * @return Zero on success or a value from @ref errno.h on failure. |
407 | * @return Zero on success or a value from @ref errno.h on failure. |
401 | */ |
408 | */ |
402 | ipcarg_t ipc_answer(ipc_callid_t callid, ipc_call_t *call) |
409 | ipcarg_t ipc_answer_slow(ipc_callid_t callid, ipcarg_t retval, ipcarg_t arg1, |
- | 410 | ipcarg_t arg2, ipcarg_t arg3, ipcarg_t arg4, ipcarg_t arg5) |
|
403 | { |
411 | { |
- | 412 | ipc_call_t data; |
|
- | 413 | ||
- | 414 | IPC_SET_RETVAL(data, retval); |
|
- | 415 | IPC_SET_ARG1(data, arg1); |
|
- | 416 | IPC_SET_ARG2(data, arg2); |
|
- | 417 | IPC_SET_ARG3(data, arg3); |
|
- | 418 | IPC_SET_ARG4(data, arg4); |
|
- | 419 | IPC_SET_ARG5(data, arg5); |
|
- | 420 | ||
404 | return __SYSCALL2(SYS_IPC_ANSWER, callid, (sysarg_t) call); |
421 | return __SYSCALL2(SYS_IPC_ANSWER_SLOW, callid, (sysarg_t) &data); |
405 | } |
422 | } |
406 | 423 | ||
407 | 424 | ||
408 | /** Try to dispatch queued calls from the async queue. */ |
425 | /** Try to dispatch queued calls from the async queue. */ |
409 | static void try_dispatch_queued_calls(void) |
426 | static void try_dispatch_queued_calls(void) |
410 | { |
427 | { |
411 | async_call_t *call; |
428 | async_call_t *call; |
412 | ipc_callid_t callid; |
429 | ipc_callid_t callid; |
413 | 430 | ||
414 | /** @todo |
431 | /** @todo |
415 | * Integrate intelligently ipc_futex, so that it is locked during |
432 | * Integrate intelligently ipc_futex, so that it is locked during |
416 | * ipc_call_async_*(), until it is added to dispatched_calls. |
433 | * ipc_call_async_*(), until it is added to dispatched_calls. |
417 | */ |
434 | */ |
418 | futex_down(&async_futex); |
435 | futex_down(&async_futex); |
419 | while (!list_empty(&queued_calls)) { |
436 | while (!list_empty(&queued_calls)) { |
420 | call = list_get_instance(queued_calls.next, async_call_t, list); |
437 | call = list_get_instance(queued_calls.next, async_call_t, list); |
421 | callid = _ipc_call_async(call->u.msg.phoneid, &call->u.msg.data); |
438 | callid = _ipc_call_async(call->u.msg.phoneid, &call->u.msg.data); |
422 | if (callid == IPC_CALLRET_TEMPORARY) { |
439 | if (callid == IPC_CALLRET_TEMPORARY) { |
423 | break; |
440 | break; |
424 | } |
441 | } |
425 | list_remove(&call->list); |
442 | list_remove(&call->list); |
426 | 443 | ||
427 | futex_up(&async_futex); |
444 | futex_up(&async_futex); |
428 | if (call->fid) |
445 | if (call->fid) |
429 | fibril_add_ready(call->fid); |
446 | fibril_add_ready(call->fid); |
430 | 447 | ||
431 | if (callid == IPC_CALLRET_FATAL) { |
448 | if (callid == IPC_CALLRET_FATAL) { |
432 | if (call->callback) |
449 | if (call->callback) |
433 | call->callback(call->private, ENOENT, NULL); |
450 | call->callback(call->private, ENOENT, NULL); |
434 | free(call); |
451 | free(call); |
435 | } else { |
452 | } else { |
436 | call->u.callid = callid; |
453 | call->u.callid = callid; |
437 | futex_down(&ipc_futex); |
454 | futex_down(&ipc_futex); |
438 | list_append(&call->list, &dispatched_calls); |
455 | list_append(&call->list, &dispatched_calls); |
439 | futex_up(&ipc_futex); |
456 | futex_up(&ipc_futex); |
440 | } |
457 | } |
441 | futex_down(&async_futex); |
458 | futex_down(&async_futex); |
442 | } |
459 | } |
443 | futex_up(&async_futex); |
460 | futex_up(&async_futex); |
444 | } |
461 | } |
445 | 462 | ||
446 | /** Handle a received answer. |
463 | /** Handle a received answer. |
447 | * |
464 | * |
448 | * Find the hash of the answer and call the answer callback. |
465 | * Find the hash of the answer and call the answer callback. |
449 | * |
466 | * |
450 | * @todo Make it use hash table. |
467 | * @todo Make it use hash table. |
451 | * |
468 | * |
452 | * @param callid Hash of the received answer. |
469 | * @param callid Hash of the received answer. |
453 | * The answer has the same hash as the request OR'ed with |
470 | * The answer has the same hash as the request OR'ed with |
454 | * the IPC_CALLID_ANSWERED bit. |
471 | * the IPC_CALLID_ANSWERED bit. |
455 | * @param data Call data of the answer. |
472 | * @param data Call data of the answer. |
456 | */ |
473 | */ |
457 | static void handle_answer(ipc_callid_t callid, ipc_call_t *data) |
474 | static void handle_answer(ipc_callid_t callid, ipc_call_t *data) |
458 | { |
475 | { |
459 | link_t *item; |
476 | link_t *item; |
460 | async_call_t *call; |
477 | async_call_t *call; |
461 | 478 | ||
462 | callid &= ~IPC_CALLID_ANSWERED; |
479 | callid &= ~IPC_CALLID_ANSWERED; |
463 | 480 | ||
464 | futex_down(&ipc_futex); |
481 | futex_down(&ipc_futex); |
465 | for (item = dispatched_calls.next; item != &dispatched_calls; |
482 | for (item = dispatched_calls.next; item != &dispatched_calls; |
466 | item = item->next) { |
483 | item = item->next) { |
467 | call = list_get_instance(item, async_call_t, list); |
484 | call = list_get_instance(item, async_call_t, list); |
468 | if (call->u.callid == callid) { |
485 | if (call->u.callid == callid) { |
469 | list_remove(&call->list); |
486 | list_remove(&call->list); |
470 | futex_up(&ipc_futex); |
487 | futex_up(&ipc_futex); |
471 | if (call->callback) |
488 | if (call->callback) |
472 | call->callback(call->private, |
489 | call->callback(call->private, |
473 | IPC_GET_RETVAL(*data), data); |
490 | IPC_GET_RETVAL(*data), data); |
474 | free(call); |
491 | free(call); |
475 | return; |
492 | return; |
476 | } |
493 | } |
477 | } |
494 | } |
478 | futex_up(&ipc_futex); |
495 | futex_up(&ipc_futex); |
479 | } |
496 | } |
480 | 497 | ||
481 | 498 | ||
482 | /** Wait for a first call to come. |
499 | /** Wait for a first call to come. |
483 | * |
500 | * |
484 | * @param call Storage where the incoming call data will be stored. |
501 | * @param call Storage where the incoming call data will be stored. |
485 | * @param usec Timeout in microseconds |
502 | * @param usec Timeout in microseconds |
486 | * @param flags Flags passed to SYS_IPC_WAIT (blocking, nonblocking). |
503 | * @param flags Flags passed to SYS_IPC_WAIT (blocking, nonblocking). |
487 | * |
504 | * |
488 | * @return Hash of the call. Note that certain bits have special |
505 | * @return Hash of the call. Note that certain bits have special |
489 | * meaning. IPC_CALLID_ANSWERED will be set in an answer |
506 | * meaning. IPC_CALLID_ANSWERED will be set in an answer |
490 | * and IPC_CALLID_NOTIFICATION is used for notifications. |
507 | * and IPC_CALLID_NOTIFICATION is used for notifications. |
491 | * |
508 | * |
492 | */ |
509 | */ |
493 | ipc_callid_t ipc_wait_cycle(ipc_call_t *call, uint32_t usec, int flags) |
510 | ipc_callid_t ipc_wait_cycle(ipc_call_t *call, uint32_t usec, int flags) |
494 | { |
511 | { |
495 | ipc_callid_t callid; |
512 | ipc_callid_t callid; |
496 | 513 | ||
497 | callid = __SYSCALL3(SYS_IPC_WAIT, (sysarg_t) call, usec, flags); |
514 | callid = __SYSCALL3(SYS_IPC_WAIT, (sysarg_t) call, usec, flags); |
498 | /* Handle received answers */ |
515 | /* Handle received answers */ |
499 | if (callid & IPC_CALLID_ANSWERED) { |
516 | if (callid & IPC_CALLID_ANSWERED) { |
500 | handle_answer(callid, call); |
517 | handle_answer(callid, call); |
501 | try_dispatch_queued_calls(); |
518 | try_dispatch_queued_calls(); |
502 | } |
519 | } |
503 | 520 | ||
504 | return callid; |
521 | return callid; |
505 | } |
522 | } |
506 | 523 | ||
507 | /** Wait some time for an IPC call. |
524 | /** Wait some time for an IPC call. |
508 | * |
525 | * |
509 | * The call will return after an answer is received. |
526 | * The call will return after an answer is received. |
510 | * |
527 | * |
511 | * @param call Storage where the incoming call data will be stored. |
528 | * @param call Storage where the incoming call data will be stored. |
512 | * @param usec Timeout in microseconds. |
529 | * @param usec Timeout in microseconds. |
513 | * |
530 | * |
514 | * @return Hash of the answer. |
531 | * @return Hash of the answer. |
515 | */ |
532 | */ |
516 | ipc_callid_t ipc_wait_for_call_timeout(ipc_call_t *call, uint32_t usec) |
533 | ipc_callid_t ipc_wait_for_call_timeout(ipc_call_t *call, uint32_t usec) |
517 | { |
534 | { |
518 | ipc_callid_t callid; |
535 | ipc_callid_t callid; |
519 | 536 | ||
520 | do { |
537 | do { |
521 | callid = ipc_wait_cycle(call, usec, SYNCH_FLAGS_NONE); |
538 | callid = ipc_wait_cycle(call, usec, SYNCH_FLAGS_NONE); |
522 | } while (callid & IPC_CALLID_ANSWERED); |
539 | } while (callid & IPC_CALLID_ANSWERED); |
523 | 540 | ||
524 | return callid; |
541 | return callid; |
525 | } |
542 | } |
526 | 543 | ||
527 | /** Check if there is an IPC call waiting to be picked up. |
544 | /** Check if there is an IPC call waiting to be picked up. |
528 | * |
545 | * |
529 | * @param call Storage where the incoming call will be stored. |
546 | * @param call Storage where the incoming call will be stored. |
530 | * @return Hash of the answer. |
547 | * @return Hash of the answer. |
531 | */ |
548 | */ |
532 | ipc_callid_t ipc_trywait_for_call(ipc_call_t *call) |
549 | ipc_callid_t ipc_trywait_for_call(ipc_call_t *call) |
533 | { |
550 | { |
534 | ipc_callid_t callid; |
551 | ipc_callid_t callid; |
535 | 552 | ||
536 | do { |
553 | do { |
537 | callid = ipc_wait_cycle(call, SYNCH_NO_TIMEOUT, |
554 | callid = ipc_wait_cycle(call, SYNCH_NO_TIMEOUT, |
538 | SYNCH_FLAGS_NON_BLOCKING); |
555 | SYNCH_FLAGS_NON_BLOCKING); |
539 | } while (callid & IPC_CALLID_ANSWERED); |
556 | } while (callid & IPC_CALLID_ANSWERED); |
540 | 557 | ||
541 | return callid; |
558 | return callid; |
542 | } |
559 | } |
543 | 560 | ||
544 | /** Ask destination to do a callback connection. |
561 | /** Ask destination to do a callback connection. |
545 | * |
562 | * |
546 | * @param phoneid Phone handle used for contacting the other side. |
563 | * @param phoneid Phone handle used for contacting the other side. |
547 | * @param arg1 Service-defined argument. |
564 | * @param arg1 Service-defined argument. |
548 | * @param arg2 Service-defined argument. |
565 | * @param arg2 Service-defined argument. |
549 | * @param phonehash Storage where the library will store an opaque |
566 | * @param phonehash Storage where the library will store an opaque |
550 | * identifier of the phone that will be used for incoming |
567 | * identifier of the phone that will be used for incoming |
551 | * calls. This identifier can be used for connection |
568 | * calls. This identifier can be used for connection |
552 | * tracking. |
569 | * tracking. |
553 | * |
570 | * |
554 | * @return Zero on success or a negative error code. |
571 | * @return Zero on success or a negative error code. |
555 | */ |
572 | */ |
556 | int ipc_connect_to_me(int phoneid, int arg1, int arg2, ipcarg_t *phonehash) |
573 | int ipc_connect_to_me(int phoneid, int arg1, int arg2, ipcarg_t *phonehash) |
557 | { |
574 | { |
558 | return ipc_call_sync_2_3(phoneid, IPC_M_CONNECT_TO_ME, arg1, arg2, |
575 | return ipc_call_sync_2_3(phoneid, IPC_M_CONNECT_TO_ME, arg1, arg2, |
559 | NULL, NULL, phonehash); |
576 | NULL, NULL, phonehash); |
560 | } |
577 | } |
561 | 578 | ||
562 | /** Ask through phone for a new connection to some service. |
579 | /** Ask through phone for a new connection to some service. |
563 | * |
580 | * |
564 | * @param phoneid Phone handle used for contacting the other side. |
581 | * @param phoneid Phone handle used for contacting the other side. |
565 | * @param arg1 User defined argument. |
582 | * @param arg1 User defined argument. |
566 | * @param arg2 User defined argument. |
583 | * @param arg2 User defined argument. |
567 | * |
584 | * |
568 | * @return New phone handle on success or a negative error code. |
585 | * @return New phone handle on success or a negative error code. |
569 | */ |
586 | */ |
570 | int ipc_connect_me_to(int phoneid, int arg1, int arg2) |
587 | int ipc_connect_me_to(int phoneid, int arg1, int arg2) |
571 | { |
588 | { |
572 | ipcarg_t newphid; |
589 | ipcarg_t newphid; |
573 | int res; |
590 | int res; |
574 | 591 | ||
575 | res = ipc_call_sync_2_3(phoneid, IPC_M_CONNECT_ME_TO, arg1, arg2, NULL, |
592 | res = ipc_call_sync_2_3(phoneid, IPC_M_CONNECT_ME_TO, arg1, arg2, NULL, |
576 | NULL, &newphid); |
593 | NULL, &newphid); |
577 | if (res) |
594 | if (res) |
578 | return res; |
595 | return res; |
579 | return newphid; |
596 | return newphid; |
580 | } |
597 | } |
581 | 598 | ||
582 | /** Hang up a phone. |
599 | /** Hang up a phone. |
583 | * |
600 | * |
584 | * @param phoneid Handle of the phone to be hung up. |
601 | * @param phoneid Handle of the phone to be hung up. |
585 | * |
602 | * |
586 | * @return Zero on success or a negative error code. |
603 | * @return Zero on success or a negative error code. |
587 | */ |
604 | */ |
588 | int ipc_hangup(int phoneid) |
605 | int ipc_hangup(int phoneid) |
589 | { |
606 | { |
590 | return __SYSCALL1(SYS_IPC_HANGUP, phoneid); |
607 | return __SYSCALL1(SYS_IPC_HANGUP, phoneid); |
591 | } |
608 | } |
592 | 609 | ||
593 | /** Register IRQ notification. |
610 | /** Register IRQ notification. |
594 | * |
611 | * |
595 | * @param inr IRQ number. |
612 | * @param inr IRQ number. |
596 | * @param devno Device number of the device generating inr. |
613 | * @param devno Device number of the device generating inr. |
597 | * @param method Use this method for notifying me. |
614 | * @param method Use this method for notifying me. |
598 | * @param ucode Top-half pseudocode handler. |
615 | * @param ucode Top-half pseudocode handler. |
599 | * |
616 | * |
600 | * @return Value returned by the kernel. |
617 | * @return Value returned by the kernel. |
601 | */ |
618 | */ |
602 | int ipc_register_irq(int inr, int devno, int method, irq_code_t *ucode) |
619 | int ipc_register_irq(int inr, int devno, int method, irq_code_t *ucode) |
603 | { |
620 | { |
604 | return __SYSCALL4(SYS_IPC_REGISTER_IRQ, inr, devno, method, |
621 | return __SYSCALL4(SYS_IPC_REGISTER_IRQ, inr, devno, method, |
605 | (sysarg_t) ucode); |
622 | (sysarg_t) ucode); |
606 | } |
623 | } |
607 | 624 | ||
608 | /** Unregister IRQ notification. |
625 | /** Unregister IRQ notification. |
609 | * |
626 | * |
610 | * @param inr IRQ number. |
627 | * @param inr IRQ number. |
611 | * @param devno Device number of the device generating inr. |
628 | * @param devno Device number of the device generating inr. |
612 | * |
629 | * |
613 | * @return Value returned by the kernel. |
630 | * @return Value returned by the kernel. |
614 | */ |
631 | */ |
615 | int ipc_unregister_irq(int inr, int devno) |
632 | int ipc_unregister_irq(int inr, int devno) |
616 | { |
633 | { |
617 | return __SYSCALL2(SYS_IPC_UNREGISTER_IRQ, inr, devno); |
634 | return __SYSCALL2(SYS_IPC_UNREGISTER_IRQ, inr, devno); |
618 | } |
635 | } |
619 | 636 | ||
620 | /** Forward a received call to another destination. |
637 | /** Forward a received call to another destination. |
621 | * |
638 | * |
622 | * @param callid Hash of the call to forward. |
639 | * @param callid Hash of the call to forward. |
623 | * @param phoneid Phone handle to use for forwarding. |
640 | * @param phoneid Phone handle to use for forwarding. |
624 | * @param method New method for the forwarded call. |
641 | * @param method New method for the forwarded call. |
625 | * @param arg1 New value of the first argument for the forwarded call. |
642 | * @param arg1 New value of the first argument for the forwarded call. |
626 | * |
643 | * |
627 | * @return Zero on success or an error code. |
644 | * @return Zero on success or an error code. |
628 | * |
645 | * |
629 | * For non-system methods, the old method and arg1 are rewritten by the new |
646 | * For non-system methods, the old method and arg1 are rewritten by the new |
630 | * values. For system methods, the new method and arg1 are written to the old |
647 | * values. For system methods, the new method and arg1 are written to the old |
631 | * arg1 and arg2, respectivelly. |
648 | * arg1 and arg2, respectivelly. |
632 | */ |
649 | */ |
633 | int ipc_forward_fast(ipc_callid_t callid, int phoneid, int method, ipcarg_t arg1) |
650 | int ipc_forward_fast(ipc_callid_t callid, int phoneid, int method, ipcarg_t arg1) |
634 | { |
651 | { |
635 | return __SYSCALL4(SYS_IPC_FORWARD_FAST, callid, phoneid, method, arg1); |
652 | return __SYSCALL4(SYS_IPC_FORWARD_FAST, callid, phoneid, method, arg1); |
636 | } |
653 | } |
637 | 654 | ||
638 | /** Wrapper for making IPC_M_DATA_SEND calls. |
655 | /** Wrapper for making IPC_M_DATA_SEND calls. |
639 | * |
656 | * |
640 | * @param phoneid Phone that will be used to contact the receiving side. |
657 | * @param phoneid Phone that will be used to contact the receiving side. |
641 | * @param src Address of the beginning of the source buffer. |
658 | * @param src Address of the beginning of the source buffer. |
642 | * @param size Size of the source buffer. |
659 | * @param size Size of the source buffer. |
643 | * |
660 | * |
644 | * @return Zero on success or a negative error code from errno.h. |
661 | * @return Zero on success or a negative error code from errno.h. |
645 | */ |
662 | */ |
646 | int ipc_data_send(int phoneid, void *src, size_t size) |
663 | int ipc_data_send(int phoneid, void *src, size_t size) |
647 | { |
664 | { |
648 | return ipc_call_sync_3_0(phoneid, IPC_M_DATA_SEND, 0, (ipcarg_t) src, |
665 | return ipc_call_sync_3_0(phoneid, IPC_M_DATA_SEND, 0, (ipcarg_t) src, |
649 | (ipcarg_t) size); |
666 | (ipcarg_t) size); |
650 | } |
667 | } |
651 | 668 | ||
652 | /** Wrapper for receiving the IPC_M_DATA_SEND calls. |
669 | /** Wrapper for receiving the IPC_M_DATA_SEND calls. |
653 | * |
670 | * |
654 | * This wrapper only makes it more comfortable to receive IPC_M_DATA_SEND calls |
671 | * This wrapper only makes it more comfortable to receive IPC_M_DATA_SEND calls |
655 | * so that the user doesn't have to remember the meaning of each IPC argument. |
672 | * so that the user doesn't have to remember the meaning of each IPC argument. |
656 | * |
673 | * |
657 | * So far, this wrapper is to be used from within a connection fibril. |
674 | * So far, this wrapper is to be used from within a connection fibril. |
658 | * |
675 | * |
659 | * @param callid Storage where the hash of the IPC_M_DATA_SEND call will |
676 | * @param callid Storage where the hash of the IPC_M_DATA_SEND call will |
660 | * be stored. |
677 | * be stored. |
661 | * @param call Storage where the incoming call will be stored. |
- | |
662 | * @param dst Storage where the suggested destination address will |
678 | * @param dst Storage where the suggested destination address will |
663 | * be stored. May be NULL. |
679 | * be stored. May be NULL. |
664 | * @param size Storage where the suggested size will be stored. May be |
680 | * @param size Storage where the suggested size will be stored. May be |
665 | * NULL |
681 | * NULL |
666 | * |
682 | * |
667 | * @return Non-zero on success, zero on failure. |
683 | * @return Non-zero on success, zero on failure. |
668 | */ |
684 | */ |
669 | int ipc_data_receive(ipc_callid_t *callid, ipc_call_t *call, void **dst, |
685 | int ipc_data_receive(ipc_callid_t *callid, void **dst, size_t *size) |
670 | size_t *size) |
- | |
671 | { |
686 | { |
- | 687 | ipc_call_t data; |
|
- | 688 | ||
672 | assert(callid); |
689 | assert(callid); |
673 | assert(call); |
- | |
674 | 690 | ||
675 | *callid = async_get_call(call); |
691 | *callid = async_get_call(&data); |
676 | if (IPC_GET_METHOD(*call) != IPC_M_DATA_SEND) |
692 | if (IPC_GET_METHOD(data) != IPC_M_DATA_SEND) |
677 | return 0; |
693 | return 0; |
678 | if (dst) |
694 | if (dst) |
679 | *dst = (void *) IPC_GET_ARG1(*call); |
695 | *dst = (void *) IPC_GET_ARG1(data); |
680 | if (size) |
696 | if (size) |
681 | *size = (size_t) IPC_GET_ARG3(*call); |
697 | *size = (size_t) IPC_GET_ARG3(data); |
682 | return 1; |
698 | return 1; |
683 | } |
699 | } |
684 | 700 | ||
685 | /** Wrapper for answering the IPC_M_DATA_SEND calls. |
701 | /** Wrapper for answering the IPC_M_DATA_SEND calls. |
686 | * |
702 | * |
687 | * This wrapper only makes it more comfortable to answer IPC_M_DATA_SEND calls |
703 | * This wrapper only makes it more comfortable to answer IPC_M_DATA_SEND calls |
688 | * so that the user doesn't have to remember the meaning of each IPC argument. |
704 | * so that the user doesn't have to remember the meaning of each IPC argument. |
689 | * |
705 | * |
690 | * @param callid Hash of the IPC_M_DATA_SEND call to answer. |
706 | * @param callid Hash of the IPC_M_DATA_SEND call to answer. |
691 | * @param call Call structure with the request. |
- | |
692 | * @param dst Final destination address for the IPC_M_DATA_SEND call. |
707 | * @param dst Final destination address for the IPC_M_DATA_SEND call. |
693 | * @param size Final size for the IPC_M_DATA_SEND call. |
708 | * @param size Final size for the IPC_M_DATA_SEND call. |
694 | * |
709 | * |
695 | * @return Zero on success or a value from @ref errno.h on failure. |
710 | * @return Zero on success or a value from @ref errno.h on failure. |
696 | */ |
711 | */ |
697 | ipcarg_t ipc_data_deliver(ipc_callid_t callid, ipc_call_t *call, void *dst, |
712 | ipcarg_t ipc_data_deliver(ipc_callid_t callid, void *dst, size_t size) |
698 | size_t size) |
- | |
699 | { |
713 | { |
700 | IPC_SET_RETVAL(*call, EOK); |
- | |
701 | IPC_SET_ARG1(*call, (ipcarg_t) dst); |
- | |
702 | IPC_SET_ARG3(*call, (ipcarg_t) size); |
- | |
703 | return ipc_answer(callid, call); |
714 | return ipc_answer_3(callid, EOK, (ipcarg_t) dst, 0, (ipcarg_t) size); |
704 | } |
715 | } |
705 | 716 | ||
706 | /** @} |
717 | /** @} |
707 | */ |
718 | */ |
708 | 719 |