Subversion Repositories HelenOS

Rev

Rev 3334 | Rev 3438 | Go to most recent revision | Details | Compare with Previous | Last modification | View Log | RSS feed

Rev Author Line No. Line
954 palkovsky 1
/*
2071 jermar 2
 * Copyright (c) 2006 Ondrej Palkovsky
954 palkovsky 3
 * All rights reserved.
4
 *
5
 * Redistribution and use in source and binary forms, with or without
6
 * modification, are permitted provided that the following conditions
7
 * are met:
8
 *
9
 * - Redistributions of source code must retain the above copyright
10
 *   notice, this list of conditions and the following disclaimer.
11
 * - Redistributions in binary form must reproduce the above copyright
12
 *   notice, this list of conditions and the following disclaimer in the
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
15
 *   derived from this software without specific prior written permission.
16
 *
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
19
 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
20
 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
21
 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
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
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
26
 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
1653 cejka 27
 */
28
 
29
/** @addtogroup libc
30
 * @{
31
 * @}
32
 */
33
 
1866 jermar 34
/** @addtogroup libcipc IPC
1653 cejka 35
 * @brief HelenOS uspace IPC
36
 * @{
37
 * @ingroup libc
38
 */
39
/** @file
954 palkovsky 40
 */
41
 
1352 palkovsky 42
#include <ipc/ipc.h>
954 palkovsky 43
#include <libc.h>
999 palkovsky 44
#include <malloc.h>
45
#include <errno.h>
1352 palkovsky 46
#include <libadt/list.h>
999 palkovsky 47
#include <stdio.h>
48
#include <unistd.h>
1350 palkovsky 49
#include <futex.h>
1365 jermar 50
#include <kernel/synch/synch.h>
1463 palkovsky 51
#include <async.h>
2482 jermar 52
#include <fibril.h>
2522 jermar 53
#include <assert.h>
954 palkovsky 54
 
2490 jermar 55
/**
56
 * Structures of this type are used for keeping track of sent asynchronous calls
57
 * and queing unsent calls.
999 palkovsky 58
 */
59
typedef struct {
60
    link_t list;
61
 
62
    ipc_async_callback_t callback;
63
    void *private;
64
    union {
65
        ipc_callid_t callid;
66
        struct {
1091 palkovsky 67
            ipc_call_t data;
999 palkovsky 68
            int phoneid;
69
        } msg;
2471 jermar 70
    } u;
2482 jermar 71
    fid_t fid;  /**< Fibril waiting for sending this call. */
999 palkovsky 72
} async_call_t;
73
 
74
LIST_INITIALIZE(dispatched_calls);
75
 
2471 jermar 76
/** List of asynchronous calls that were not accepted by kernel.
77
 *
78
 * It is protected by async_futex, because if the call cannot be sent into the
79
 * kernel, the async framework is used automatically.
1463 palkovsky 80
 */
2471 jermar 81
LIST_INITIALIZE(queued_calls);
1463 palkovsky 82
 
1392 palkovsky 83
static atomic_t ipc_futex = FUTEX_INITIALIZER;
1350 palkovsky 84
 
2471 jermar 85
/** Make a fast synchronous call.
86
 *
2615 jermar 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
89
 * is passed directly in registers.
2471 jermar 90
 *
91
 * @param phoneid   Phone handle for the call.
92
 * @param method    Requested method.
93
 * @param arg1      Service-defined payload argument.
2615 jermar 94
 * @param arg2      Service-defined payload argument.
95
 * @param arg3      Service-defined payload argument.
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.
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.
100
 * @param result5   If non-NULL, the return ARG5 will be stored there.
2471 jermar 101
 *
102
 * @return      Negative values represent errors returned by IPC.
103
 *          Otherwise the RETVAL of the answer is returned.
104
 */
2615 jermar 105
int
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,
108
    ipcarg_t *result4, ipcarg_t *result5)
954 palkovsky 109
{
1091 palkovsky 110
    ipc_call_t resdata;
966 palkovsky 111
    int callres;
112
 
2615 jermar 113
    callres = __SYSCALL6(SYS_IPC_CALL_SYNC_FAST, phoneid, method, arg1,
114
        arg2, arg3, (sysarg_t) &resdata);
966 palkovsky 115
    if (callres)
116
        return callres;
2615 jermar 117
    if (result1)
118
        *result1 = IPC_GET_ARG1(resdata);
119
    if (result2)
120
        *result2 = IPC_GET_ARG2(resdata);
121
    if (result3)
122
        *result3 = IPC_GET_ARG3(resdata);
123
    if (result4)
124
        *result4 = IPC_GET_ARG4(resdata);
125
    if (result5)
126
        *result5 = IPC_GET_ARG5(resdata);
127
 
966 palkovsky 128
    return IPC_GET_RETVAL(resdata);
954 palkovsky 129
}
130
 
2615 jermar 131
/** Make a synchronous call transmitting 5 arguments of payload.
2471 jermar 132
 *
133
 * @param phoneid   Phone handle for the call.
134
 * @param method    Requested method.
135
 * @param arg1      Service-defined payload argument.
136
 * @param arg2      Service-defined payload argument.
137
 * @param arg3      Service-defined payload argument.
2615 jermar 138
 * @param arg4      Service-defined payload argument.
139
 * @param arg5      Service-defined payload argument.
2471 jermar 140
 * @param result1   If non-NULL, storage for the first 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.
2615 jermar 143
 * @param result4   If non-NULL, storage for the fourth return argument.
144
 * @param result5   If non-NULL, storage for the fifth return argument.
2471 jermar 145
 *
146
 * @return      Negative value means IPC error.
147
 *          Otherwise the RETVAL of the answer.
148
 */
2615 jermar 149
int
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,
152
    ipcarg_t *result2, ipcarg_t *result3, ipcarg_t *result4, ipcarg_t *result5)
954 palkovsky 153
{
1091 palkovsky 154
    ipc_call_t data;
966 palkovsky 155
    int callres;
156
 
157
    IPC_SET_METHOD(data, method);
158
    IPC_SET_ARG1(data, arg1);
159
    IPC_SET_ARG2(data, arg2);
160
    IPC_SET_ARG3(data, arg3);
2615 jermar 161
    IPC_SET_ARG4(data, arg4);
162
    IPC_SET_ARG5(data, arg5);
966 palkovsky 163
 
2615 jermar 164
    callres = __SYSCALL3(SYS_IPC_CALL_SYNC_SLOW, phoneid, (sysarg_t) &data,
2471 jermar 165
        (sysarg_t) &data);
966 palkovsky 166
    if (callres)
167
        return callres;
168
 
169
    if (result1)
170
        *result1 = IPC_GET_ARG1(data);
171
    if (result2)
172
        *result2 = IPC_GET_ARG2(data);
173
    if (result3)
174
        *result3 = IPC_GET_ARG3(data);
2615 jermar 175
    if (result4)
176
        *result4 = IPC_GET_ARG4(data);
177
    if (result5)
178
        *result5 = IPC_GET_ARG5(data);
179
 
966 palkovsky 180
    return IPC_GET_RETVAL(data);
181
}
182
 
2471 jermar 183
/** Syscall to send asynchronous message.
184
 *
185
 * @param phoneid   Phone handle for the call.
186
 * @param data      Call data with the request.
187
 *
188
 * @return      Hash of the call or an error code.
189
 */
190
static ipc_callid_t _ipc_call_async(int phoneid, ipc_call_t *data)
999 palkovsky 191
{
2618 jermar 192
    return __SYSCALL2(SYS_IPC_CALL_ASYNC_SLOW, phoneid, (sysarg_t) data);
999 palkovsky 193
}
194
 
2471 jermar 195
/** Prolog to ipc_call_async_*() functions.
196
 *
197
 * @param private   Argument for the answer/error callback.
198
 * @param callback  Answer/error callback.
199
 *
200
 * @return      New, partially initialized async_call structure or NULL.
201
 */
202
static inline async_call_t *ipc_prepare_async(void *private,
203
    ipc_async_callback_t callback)
966 palkovsky 204
{
999 palkovsky 205
    async_call_t *call;
966 palkovsky 206
 
999 palkovsky 207
    call = malloc(sizeof(*call));
208
    if (!call) {
1443 palkovsky 209
        if (callback)
210
            callback(private, ENOMEM, NULL);
1489 palkovsky 211
        return NULL;
999 palkovsky 212
    }
1463 palkovsky 213
    call->callback = callback;
214
    call->private = private;
215
 
1489 palkovsky 216
    return call;
217
}
218
 
2471 jermar 219
/** Epilogue of ipc_call_async_*() functions.
220
 *
221
 * @param callid    Value returned by the SYS_IPC_CALL_ASYNC_* syscall.
222
 * @param phoneid   Phone handle through which the call was made.
223
 * @param call      async_call structure returned by ipc_prepare_async().
2530 jermar 224
 * @param can_preempt   If non-zero, the current fibril can be preempted in this
225
 *          call.
2471 jermar 226
 */
227
static inline void ipc_finish_async(ipc_callid_t callid, int phoneid,
228
    async_call_t *call, int can_preempt)
1489 palkovsky 229
{
1751 palkovsky 230
    if (!call) { /* Nothing to do regardless if failed or not */
231
        futex_up(&ipc_futex);
232
        return;
233
    }
234
 
966 palkovsky 235
    if (callid == IPC_CALLRET_FATAL) {
1463 palkovsky 236
        futex_up(&ipc_futex);
966 palkovsky 237
        /* Call asynchronous handler with error code */
1489 palkovsky 238
        if (call->callback)
239
            call->callback(call->private, ENOENT, NULL);
999 palkovsky 240
        free(call);
966 palkovsky 241
        return;
242
    }
999 palkovsky 243
 
1463 palkovsky 244
    if (callid == IPC_CALLRET_TEMPORARY) {
245
        futex_up(&ipc_futex);
999 palkovsky 246
 
247
        call->u.msg.phoneid = phoneid;
1518 palkovsky 248
 
1463 palkovsky 249
        futex_down(&async_futex);
999 palkovsky 250
        list_append(&call->list, &queued_calls);
1463 palkovsky 251
 
1518 palkovsky 252
        if (can_preempt) {
2482 jermar 253
            call->fid = fibril_get_id();
2568 jermar 254
            fibril_switch(FIBRIL_TO_MANAGER);
1518 palkovsky 255
            /* Async futex unlocked by previous call */
256
        } else {
2482 jermar 257
            call->fid = 0;
1518 palkovsky 258
            futex_up(&async_futex);
259
        }
966 palkovsky 260
        return;
261
    }
999 palkovsky 262
    call->u.callid = callid;
2471 jermar 263
    /* Add call to the list of dispatched calls */
999 palkovsky 264
    list_append(&call->list, &dispatched_calls);
1350 palkovsky 265
    futex_up(&ipc_futex);
1489 palkovsky 266
 
954 palkovsky 267
}
268
 
2471 jermar 269
/** Make a fast asynchronous call.
1489 palkovsky 270
 *
2618 jermar 271
 * This function can only handle four arguments of payload. It is, however,
272
 * faster than the more generic ipc_call_async_slow().
2471 jermar 273
 *
274
 * Note that this function is a void function.
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.
277
 * If the call cannot be temporarily made, queue it.
278
 *
279
 * @param phoneid   Phone handle for the call.
280
 * @param method    Requested method.
281
 * @param arg1      Service-defined payload argument.
282
 * @param arg2      Service-defined payload argument.
2618 jermar 283
 * @param arg3      Service-defined payload argument.
284
 * @param arg4      Service-defined payload argument.
2471 jermar 285
 * @param private   Argument to be passed to the answer/error callback.
286
 * @param callback  Answer or error callback.
2530 jermar 287
 * @param can_preempt   If non-zero, the current fibril will be preempted in
288
 *          case the kernel temporarily refuses to accept more
2471 jermar 289
 *          asynchronous calls.
1489 palkovsky 290
 */
2618 jermar 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,
293
    ipc_async_callback_t callback, int can_preempt)
1489 palkovsky 294
{
1751 palkovsky 295
    async_call_t *call = NULL;
1489 palkovsky 296
    ipc_callid_t callid;
966 palkovsky 297
 
1751 palkovsky 298
    if (callback) {
299
        call = ipc_prepare_async(private, callback);
300
        if (!call)
301
            return;
302
    }
1489 palkovsky 303
 
2471 jermar 304
    /*
305
     * We need to make sure that we get callid before another thread
306
     * accesses the queue again.
307
     */
1489 palkovsky 308
    futex_down(&ipc_futex);
2618 jermar 309
    callid = __SYSCALL6(SYS_IPC_CALL_ASYNC_FAST, phoneid, method, arg1,
310
        arg2, arg3, arg4);
1489 palkovsky 311
 
312
    if (callid == IPC_CALLRET_TEMPORARY) {
1751 palkovsky 313
        if (!call) {
314
            call = ipc_prepare_async(private, callback);
315
            if (!call)
316
                return;
317
        }
1489 palkovsky 318
        IPC_SET_METHOD(call->u.msg.data, method);
319
        IPC_SET_ARG1(call->u.msg.data, arg1);
320
        IPC_SET_ARG2(call->u.msg.data, arg2);
2618 jermar 321
        IPC_SET_ARG3(call->u.msg.data, arg3);
322
        IPC_SET_ARG4(call->u.msg.data, arg4);
2620 jermar 323
        /*
324
         * To achieve deterministic behavior, we always zero out the
325
         * arguments that are beyond the limits of the fast version.
326
         */
327
        IPC_SET_ARG5(call->u.msg.data, 0);
1489 palkovsky 328
    }
1518 palkovsky 329
    ipc_finish_async(callid, phoneid, call, can_preempt);
1489 palkovsky 330
}
331
 
2471 jermar 332
/** Make an asynchronous call transmitting the entire payload.
1489 palkovsky 333
 *
2471 jermar 334
 * Note that this function is a void function.
335
 * During normal opertation, answering this call will trigger the callback.
336
 * In case of fatal error, call the callback handler with the proper error code.
337
 * If the call cannot be temporarily made, queue it.
338
 *
339
 * @param phoneid   Phone handle for the call.
340
 * @param method    Requested method.
341
 * @param arg1      Service-defined payload argument.
342
 * @param arg2      Service-defined payload argument.
343
 * @param arg3      Service-defined payload argument.
2618 jermar 344
 * @param arg4      Service-defined payload argument.
345
 * @param arg5      Service-defined payload argument.
2471 jermar 346
 * @param private   Argument to be passed to the answer/error callback.
347
 * @param callback  Answer or error callback.
2530 jermar 348
 * @param can_preempt   If non-zero, the current fibril will be preempted in
349
 *          case the kernel temporarily refuses to accept more
2471 jermar 350
 *          asynchronous calls.
351
 *
1489 palkovsky 352
 */
2618 jermar 353
void ipc_call_async_slow(int phoneid, ipcarg_t method, ipcarg_t arg1,
354
    ipcarg_t arg2, ipcarg_t arg3, ipcarg_t arg4, ipcarg_t arg5, void *private,
355
    ipc_async_callback_t callback, int can_preempt)
1489 palkovsky 356
{
357
    async_call_t *call;
358
    ipc_callid_t callid;
359
 
360
    call = ipc_prepare_async(private, callback);
361
    if (!call)
362
        return;
363
 
364
    IPC_SET_METHOD(call->u.msg.data, method);
365
    IPC_SET_ARG1(call->u.msg.data, arg1);
366
    IPC_SET_ARG2(call->u.msg.data, arg2);
367
    IPC_SET_ARG3(call->u.msg.data, arg3);
2618 jermar 368
    IPC_SET_ARG4(call->u.msg.data, arg4);
369
    IPC_SET_ARG5(call->u.msg.data, arg5);
2471 jermar 370
    /*
2618 jermar 371
     * We need to make sure that we get callid before another thread
372
     * accesses the queue again.
2471 jermar 373
     */
1489 palkovsky 374
    futex_down(&ipc_futex);
375
    callid = _ipc_call_async(phoneid, &call->u.msg.data);
376
 
1518 palkovsky 377
    ipc_finish_async(callid, phoneid, call, can_preempt);
1489 palkovsky 378
}
379
 
380
 
2471 jermar 381
/** Answer a received call - fast version.
1343 jermar 382
 *
2619 jermar 383
 * The fast answer makes use of passing retval and first four arguments in
384
 * registers. If you need to return more, use the ipc_answer_slow() instead.
1343 jermar 385
 *
2471 jermar 386
 * @param callid    Hash of the call being answered.
387
 * @param retval    Return value.
388
 * @param arg1      First return argument.
389
 * @param arg2      Second return argument.
2619 jermar 390
 * @param arg3      Third return argument.
391
 * @param arg4      Fourth return argument.
1343 jermar 392
 *
2471 jermar 393
 * @return      Zero on success or a value from @ref errno.h on failure.
1343 jermar 394
 */
395
ipcarg_t ipc_answer_fast(ipc_callid_t callid, ipcarg_t retval, ipcarg_t arg1,
2619 jermar 396
    ipcarg_t arg2, ipcarg_t arg3, ipcarg_t arg4)
954 palkovsky 397
{
2619 jermar 398
    return __SYSCALL6(SYS_IPC_ANSWER_FAST, callid, retval, arg1, arg2, arg3,
399
        arg4);
954 palkovsky 400
}
401
 
2619 jermar 402
/** Answer a received call - slow full version.
1343 jermar 403
 *
2471 jermar 404
 * @param callid    Hash of the call being answered.
2619 jermar 405
 * @param retval    Return value.
406
 * @param arg1      First return argument.
407
 * @param arg2      Second return argument.
408
 * @param arg3      Third return argument.
409
 * @param arg4      Fourth return argument.
410
 * @param arg5      Fifth return argument.
1343 jermar 411
 *
2471 jermar 412
 * @return      Zero on success or a value from @ref errno.h on failure.
1343 jermar 413
 */
2619 jermar 414
ipcarg_t ipc_answer_slow(ipc_callid_t callid, ipcarg_t retval, ipcarg_t arg1,
415
    ipcarg_t arg2, ipcarg_t arg3, ipcarg_t arg4, ipcarg_t arg5)
1343 jermar 416
{
2619 jermar 417
    ipc_call_t data;
418
 
419
    IPC_SET_RETVAL(data, retval);
420
    IPC_SET_ARG1(data, arg1);
421
    IPC_SET_ARG2(data, arg2);
422
    IPC_SET_ARG3(data, arg3);
423
    IPC_SET_ARG4(data, arg4);
424
    IPC_SET_ARG5(data, arg5);
425
 
426
    return __SYSCALL2(SYS_IPC_ANSWER_SLOW, callid, (sysarg_t) &data);
1343 jermar 427
}
428
 
429
 
2471 jermar 430
/** Try to dispatch queued calls from the async queue. */
999 palkovsky 431
static void try_dispatch_queued_calls(void)
432
{
433
    async_call_t *call;
434
    ipc_callid_t callid;
435
 
2471 jermar 436
    /** @todo
437
     * Integrate intelligently ipc_futex, so that it is locked during
438
     * ipc_call_async_*(), until it is added to dispatched_calls.
1463 palkovsky 439
     */
440
    futex_down(&async_futex);
999 palkovsky 441
    while (!list_empty(&queued_calls)) {
2471 jermar 442
        call = list_get_instance(queued_calls.next, async_call_t, list);
2620 jermar 443
        callid = _ipc_call_async(call->u.msg.phoneid,
444
            &call->u.msg.data);
1463 palkovsky 445
        if (callid == IPC_CALLRET_TEMPORARY) {
999 palkovsky 446
            break;
1463 palkovsky 447
        }
999 palkovsky 448
        list_remove(&call->list);
1350 palkovsky 449
 
1463 palkovsky 450
        futex_up(&async_futex);
2482 jermar 451
        if (call->fid)
452
            fibril_add_ready(call->fid);
1463 palkovsky 453
 
999 palkovsky 454
        if (callid == IPC_CALLRET_FATAL) {
1443 palkovsky 455
            if (call->callback)
456
                call->callback(call->private, ENOENT, NULL);
999 palkovsky 457
            free(call);
458
        } else {
459
            call->u.callid = callid;
1463 palkovsky 460
            futex_down(&ipc_futex);
999 palkovsky 461
            list_append(&call->list, &dispatched_calls);
1463 palkovsky 462
            futex_up(&ipc_futex);
999 palkovsky 463
        }
1463 palkovsky 464
        futex_down(&async_futex);
999 palkovsky 465
    }
1463 palkovsky 466
    futex_up(&async_futex);
999 palkovsky 467
}
468
 
2471 jermar 469
/** Handle a received answer.
999 palkovsky 470
 *
2471 jermar 471
 * Find the hash of the answer and call the answer callback.
999 palkovsky 472
 *
2471 jermar 473
 * @todo Make it use hash table.
474
 *
475
 * @param callid    Hash of the received answer.
476
 *          The answer has the same hash as the request OR'ed with
477
 *          the IPC_CALLID_ANSWERED bit.
478
 * @param data      Call data of the answer.
999 palkovsky 479
 */
1091 palkovsky 480
static void handle_answer(ipc_callid_t callid, ipc_call_t *data)
999 palkovsky 481
{
482
    link_t *item;
483
    async_call_t *call;
484
 
485
    callid &= ~IPC_CALLID_ANSWERED;
486
 
1350 palkovsky 487
    futex_down(&ipc_futex);
999 palkovsky 488
    for (item = dispatched_calls.next; item != &dispatched_calls;
2471 jermar 489
        item = item->next) {
999 palkovsky 490
        call = list_get_instance(item, async_call_t, list);
491
        if (call->u.callid == callid) {
492
            list_remove(&call->list);
1350 palkovsky 493
            futex_up(&ipc_futex);
1443 palkovsky 494
            if (call->callback)
495
                call->callback(call->private,
2471 jermar 496
                    IPC_GET_RETVAL(*data), data);
1443 palkovsky 497
            free(call);
999 palkovsky 498
            return;
499
        }
500
    }
1350 palkovsky 501
    futex_up(&ipc_futex);
999 palkovsky 502
}
503
 
504
 
2471 jermar 505
/** Wait for a first call to come.
954 palkovsky 506
 *
2471 jermar 507
 * @param call      Storage where the incoming call data will be stored.
508
 * @param usec      Timeout in microseconds
509
 * @param flags     Flags passed to SYS_IPC_WAIT (blocking, nonblocking).
510
 *
511
 * @return      Hash of the call. Note that certain bits have special
512
 *          meaning. IPC_CALLID_ANSWERED will be set in an answer
513
 *          and IPC_CALLID_NOTIFICATION is used for notifications.
514
 *         
954 palkovsky 515
 */
1392 palkovsky 516
ipc_callid_t ipc_wait_cycle(ipc_call_t *call, uint32_t usec, int flags)
954 palkovsky 517
{
518
    ipc_callid_t callid;
519
 
1392 palkovsky 520
    callid = __SYSCALL3(SYS_IPC_WAIT, (sysarg_t) call, usec, flags);
521
    /* Handle received answers */
1463 palkovsky 522
    if (callid & IPC_CALLID_ANSWERED) {
1392 palkovsky 523
        handle_answer(callid, call);
1463 palkovsky 524
        try_dispatch_queued_calls();
525
    }
999 palkovsky 526
 
954 palkovsky 527
    return callid;
528
}
1028 palkovsky 529
 
1365 jermar 530
/** Wait some time for an IPC call.
531
 *
2471 jermar 532
 * The call will return after an answer is received.
1709 jermar 533
 *
2471 jermar 534
 * @param call      Storage where the incoming call data will be stored.
535
 * @param usec      Timeout in microseconds.
536
 *
537
 * @return      Hash of the answer.
1365 jermar 538
 */
539
ipc_callid_t ipc_wait_for_call_timeout(ipc_call_t *call, uint32_t usec)
540
{
541
    ipc_callid_t callid;
542
 
543
    do {
1503 jermar 544
        callid = ipc_wait_cycle(call, usec, SYNCH_FLAGS_NONE);
1365 jermar 545
    } while (callid & IPC_CALLID_ANSWERED);
546
 
547
    return callid;
548
}
549
 
550
/** Check if there is an IPC call waiting to be picked up.
551
 *
2471 jermar 552
 * @param call      Storage where the incoming call will be stored.
553
 * @return      Hash of the answer.
1365 jermar 554
 */
555
ipc_callid_t ipc_trywait_for_call(ipc_call_t *call)
556
{
557
    ipc_callid_t callid;
558
 
559
    do {
2471 jermar 560
        callid = ipc_wait_cycle(call, SYNCH_NO_TIMEOUT,
561
            SYNCH_FLAGS_NON_BLOCKING);
1365 jermar 562
    } while (callid & IPC_CALLID_ANSWERED);
563
 
564
    return callid;
565
}
566
 
2359 jermar 567
/** Ask destination to do a callback connection.
1091 palkovsky 568
 *
2471 jermar 569
 * @param phoneid   Phone handle used for contacting the other side.
570
 * @param arg1      Service-defined argument.
571
 * @param arg2      Service-defined argument.
2637 cejka 572
 * @param arg3      Service-defined argument.
2471 jermar 573
 * @param phonehash Storage where the library will store an opaque
2359 jermar 574
 *          identifier of the phone that will be used for incoming
2471 jermar 575
 *          calls. This identifier can be used for connection
576
 *          tracking.
577
 *
578
 * @return      Zero on success or a negative error code.
1091 palkovsky 579
 */
2637 cejka 580
int ipc_connect_to_me(int phoneid, int arg1, int arg2, int arg3,
581
    ipcarg_t *phonehash)
1028 palkovsky 582
{
2637 cejka 583
    return ipc_call_sync_3_5(phoneid, IPC_M_CONNECT_TO_ME, arg1, arg2,
584
        arg3, NULL, NULL, NULL, NULL, phonehash);
1028 palkovsky 585
}
1061 palkovsky 586
 
2359 jermar 587
/** Ask through phone for a new connection to some service.
1091 palkovsky 588
 *
2471 jermar 589
 * @param phoneid   Phone handle used for contacting the other side.
2359 jermar 590
 * @param arg1      User defined argument.
591
 * @param arg2      User defined argument.
2635 cejka 592
 * @param arg3      User defined argument.
2359 jermar 593
 *
2471 jermar 594
 * @return      New phone handle on success or a negative error code.
1091 palkovsky 595
 */
2635 cejka 596
int ipc_connect_me_to(int phoneid, int arg1, int arg2, int arg3)
1061 palkovsky 597
{
1092 palkovsky 598
    ipcarg_t newphid;
1091 palkovsky 599
    int res;
600
 
2635 cejka 601
    res = ipc_call_sync_3_5(phoneid, IPC_M_CONNECT_ME_TO, arg1, arg2, arg3,
2636 jermar 602
        NULL, NULL, NULL, NULL, &newphid);
1091 palkovsky 603
    if (res)
604
        return res;
605
    return newphid;
1061 palkovsky 606
}
607
 
2471 jermar 608
/** Hang up a phone.
609
 *
610
 * @param phoneid   Handle of the phone to be hung up.
611
 *
612
 * @return      Zero on success or a negative error code.
613
 */
1089 palkovsky 614
int ipc_hangup(int phoneid)
615
{
616
    return __SYSCALL1(SYS_IPC_HANGUP, phoneid);
617
}
1259 palkovsky 618
 
1923 jermar 619
/** Register IRQ notification.
620
 *
2471 jermar 621
 * @param inr       IRQ number.
622
 * @param devno     Device number of the device generating inr.
623
 * @param method    Use this method for notifying me.
624
 * @param ucode     Top-half pseudocode handler.
1923 jermar 625
 *
2471 jermar 626
 * @return      Value returned by the kernel.
1923 jermar 627
 */
628
int ipc_register_irq(int inr, int devno, int method, irq_code_t *ucode)
1259 palkovsky 629
{
2471 jermar 630
    return __SYSCALL4(SYS_IPC_REGISTER_IRQ, inr, devno, method,
631
        (sysarg_t) ucode);
1259 palkovsky 632
}
633
 
1923 jermar 634
/** Unregister IRQ notification.
635
 *
2471 jermar 636
 * @param inr       IRQ number.
637
 * @param devno     Device number of the device generating inr.
1923 jermar 638
 *
2471 jermar 639
 * @return      Value returned by the kernel.
1923 jermar 640
 */
641
int ipc_unregister_irq(int inr, int devno)
1259 palkovsky 642
{
1923 jermar 643
    return __SYSCALL2(SYS_IPC_UNREGISTER_IRQ, inr, devno);
1259 palkovsky 644
}
1330 palkovsky 645
 
2471 jermar 646
/** Forward a received call to another destination.
647
 *
648
 * @param callid    Hash of the call to forward.
649
 * @param phoneid   Phone handle to use for forwarding.
650
 * @param method    New method for the forwarded call.
651
 * @param arg1      New value of the first argument for the forwarded call.
2635 cejka 652
 * @param arg2      New value of the second argument for the forwarded call.
2622 jermar 653
 * @param mode      Flags specifying mode of the forward operation.
2471 jermar 654
 *
655
 * @return      Zero on success or an error code.
656
 *
2636 jermar 657
 * For non-system methods, the old method, arg1 and arg2 are rewritten by the
658
 * new values. For system methods, the new method, arg1 and arg2 are written
2635 cejka 659
 * to the old arg1, arg2 and arg3, respectivelly. Calls with immutable
660
 * methods are forwarded verbatim.
2471 jermar 661
 */
2620 jermar 662
int ipc_forward_fast(ipc_callid_t callid, int phoneid, int method,
2635 cejka 663
    ipcarg_t arg1, ipcarg_t arg2, int mode)
1336 jermar 664
{
2635 cejka 665
    return __SYSCALL6(SYS_IPC_FORWARD_FAST, callid, phoneid, method, arg1,
2636 jermar 666
        arg2, mode);
1336 jermar 667
}
668
 
2677 jermar 669
/** Wrapper for making IPC_M_SHARE_IN calls.
670
 *
671
 * @param phoneid   Phone that will be used to contact the receiving side.
672
 * @param dst       Destination address space area base.
673
 * @param size      Size of the destination address space area.
674
 * @param arg       User defined argument.
675
 * @param flags     Storage where the received flags will be stored. Can be
676
 *          NULL.
677
 *
678
 * @return      Zero on success or a negative error code from errno.h.
679
 */
2678 jermar 680
int ipc_share_in_start(int phoneid, void *dst, size_t size, ipcarg_t arg,
2677 jermar 681
    int *flags)
682
{
683
    int res;
684
    sysarg_t tmp_flags;
3344 jermar 685
    res = async_req_3_2(phoneid, IPC_M_SHARE_IN, (ipcarg_t) dst,
2677 jermar 686
        (ipcarg_t) size, arg, NULL, &tmp_flags);
687
    if (flags)
688
        *flags = tmp_flags;
689
    return res;
690
}
691
 
692
/** Wrapper for receiving the IPC_M_SHARE_IN calls.
693
 *
694
 * This wrapper only makes it more comfortable to receive IPC_M_SHARE_IN calls
695
 * so that the user doesn't have to remember the meaning of each IPC argument.
696
 *
697
 * So far, this wrapper is to be used from within a connection fibril.
698
 *
699
 * @param callid    Storage where the hash of the IPC_M_SHARE_IN call will
700
 *          be stored.
701
 * @param size      Destination address space area size.   
702
 *
703
 * @return      Non-zero on success, zero on failure.
704
 */
705
int ipc_share_in_receive(ipc_callid_t *callid, size_t *size)
706
{
707
    ipc_call_t data;
708
 
709
    assert(callid);
710
    assert(size);
711
 
712
    *callid = async_get_call(&data);
713
    if (IPC_GET_METHOD(data) != IPC_M_SHARE_IN)
714
        return 0;
715
    *size = (size_t) IPC_GET_ARG2(data);
716
    return 1;
717
}
718
 
719
/** Wrapper for answering the IPC_M_SHARE_IN calls.
720
 *
721
 * This wrapper only makes it more comfortable to answer IPC_M_DATA_READ calls
722
 * so that the user doesn't have to remember the meaning of each IPC argument.
723
 *
724
 * @param callid    Hash of the IPC_M_DATA_READ call to answer.
725
 * @param src       Source address space base.
726
 * @param flags     Flags to be used for sharing. Bits can be only cleared.
727
 *
728
 * @return      Zero on success or a value from @ref errno.h on failure.
729
 */
2678 jermar 730
int ipc_share_in_finalize(ipc_callid_t callid, void *src, int flags)
2677 jermar 731
{
732
    return ipc_answer_2(callid, EOK, (ipcarg_t) src, (ipcarg_t) flags);
733
}
734
 
735
/** Wrapper for making IPC_M_SHARE_OUT calls.
736
 *
737
 * @param phoneid   Phone that will be used to contact the receiving side.
738
 * @param src       Source address space area base address.
739
 * @param flags     Flags to be used for sharing. Bits can be only cleared.
740
 *
741
 * @return      Zero on success or a negative error code from errno.h.
742
 */
2678 jermar 743
int ipc_share_out_start(int phoneid, void *src, int flags)
2677 jermar 744
{
3344 jermar 745
    return async_req_3_0(phoneid, IPC_M_SHARE_OUT, (ipcarg_t) src, 0,
2677 jermar 746
        (ipcarg_t) flags);
747
}
748
 
749
/** Wrapper for receiving the IPC_M_SHARE_OUT calls.
750
 *
751
 * This wrapper only makes it more comfortable to receive IPC_M_SHARE_OUT calls
752
 * so that the user doesn't have to remember the meaning of each IPC argument.
753
 *
754
 * So far, this wrapper is to be used from within a connection fibril.
755
 *
756
 * @param callid    Storage where the hash of the IPC_M_SHARE_OUT call will
757
 *          be stored.
758
 * @param size      Storage where the source address space area size will be
759
 *          stored.
760
 * @param flags     Storage where the sharing flags will be stored.
761
 *
762
 * @return      Non-zero on success, zero on failure.
763
 */
764
int ipc_share_out_receive(ipc_callid_t *callid, size_t *size, int *flags)
765
{
766
    ipc_call_t data;
767
 
768
    assert(callid);
769
    assert(size);
770
    assert(flags);
771
 
772
    *callid = async_get_call(&data);
2820 decky 773
    if (IPC_GET_METHOD(data) != IPC_M_SHARE_OUT)
2677 jermar 774
        return 0;
775
    *size = (size_t) IPC_GET_ARG2(data);
776
    *flags = (int) IPC_GET_ARG3(data);
777
    return 1;
778
}
779
 
780
/** Wrapper for answering the IPC_M_SHARE_OUT calls.
781
 *
782
 * This wrapper only makes it more comfortable to answer IPC_M_SHARE_OUT calls
783
 * so that the user doesn't have to remember the meaning of each IPC argument.
784
 *
785
 * @param callid    Hash of the IPC_M_DATA_WRITE call to answer.
786
 * @param dst       Destination address space area base address.   
787
 *
788
 * @return      Zero on success or a value from @ref errno.h on failure.
789
 */
2678 jermar 790
int ipc_share_out_finalize(ipc_callid_t callid, void *dst)
2677 jermar 791
{
792
    return ipc_answer_1(callid, EOK, (ipcarg_t) dst);
793
}
794
 
795
 
2662 jermar 796
/** Wrapper for making IPC_M_DATA_READ calls.
797
 *
798
 * @param phoneid   Phone that will be used to contact the receiving side.
799
 * @param dst       Address of the beginning of the destination buffer.
800
 * @param size      Size of the destination buffer.
801
 *
802
 * @return      Zero on success or a negative error code from errno.h.
803
 */
2678 jermar 804
int ipc_data_read_start(int phoneid, void *dst, size_t size)
2662 jermar 805
{
3334 jermar 806
    return async_req_2_0(phoneid, IPC_M_DATA_READ, (ipcarg_t) dst,
2662 jermar 807
        (ipcarg_t) size);
808
}
809
 
810
/** Wrapper for receiving the IPC_M_DATA_READ calls.
811
 *
812
 * This wrapper only makes it more comfortable to receive IPC_M_DATA_READ calls
813
 * so that the user doesn't have to remember the meaning of each IPC argument.
814
 *
815
 * So far, this wrapper is to be used from within a connection fibril.
816
 *
817
 * @param callid    Storage where the hash of the IPC_M_DATA_READ call will
818
 *          be stored.
2663 jermar 819
 * @param size      Storage where the maximum size will be stored. Can be
820
 *          NULL.
2662 jermar 821
 *
822
 * @return      Non-zero on success, zero on failure.
823
 */
824
int ipc_data_read_receive(ipc_callid_t *callid, size_t *size)
825
{
826
    ipc_call_t data;
827
 
828
    assert(callid);
829
 
830
    *callid = async_get_call(&data);
831
    if (IPC_GET_METHOD(data) != IPC_M_DATA_READ)
832
        return 0;
2663 jermar 833
    if (size)
834
        *size = (size_t) IPC_GET_ARG2(data);
2662 jermar 835
    return 1;
836
}
837
 
838
/** Wrapper for answering the IPC_M_DATA_READ calls.
839
 *
840
 * This wrapper only makes it more comfortable to answer IPC_M_DATA_READ calls
841
 * so that the user doesn't have to remember the meaning of each IPC argument.
842
 *
843
 * @param callid    Hash of the IPC_M_DATA_READ call to answer.
844
 * @param src       Source address for the IPC_M_DATA_READ call.
845
 * @param size      Size for the IPC_M_DATA_READ call. Can be smaller than
846
 *          the maximum size announced by the sender.
847
 *
848
 * @return      Zero on success or a value from @ref errno.h on failure.
849
 */
2678 jermar 850
int ipc_data_read_finalize(ipc_callid_t callid, void *src, size_t size)
2662 jermar 851
{
852
    return ipc_answer_2(callid, EOK, (ipcarg_t) src, (ipcarg_t) size);
853
}
854
 
2660 jermar 855
/** Wrapper for making IPC_M_DATA_WRITE calls.
2522 jermar 856
 *
2531 jermar 857
 * @param phoneid   Phone that will be used to contact the receiving side.
858
 * @param src       Address of the beginning of the source buffer.
859
 * @param size      Size of the source buffer.
860
 *
861
 * @return      Zero on success or a negative error code from errno.h.
862
 */
2678 jermar 863
int ipc_data_write_start(int phoneid, void *src, size_t size)
2531 jermar 864
{
3334 jermar 865
    return async_req_2_0(phoneid, IPC_M_DATA_WRITE, (ipcarg_t) src,
2615 jermar 866
        (ipcarg_t) size);
2531 jermar 867
}
868
 
2660 jermar 869
/** Wrapper for receiving the IPC_M_DATA_WRITE calls.
2531 jermar 870
 *
2660 jermar 871
 * This wrapper only makes it more comfortable to receive IPC_M_DATA_WRITE calls
2522 jermar 872
 * so that the user doesn't have to remember the meaning of each IPC argument.
873
 *
874
 * So far, this wrapper is to be used from within a connection fibril.
875
 *
2660 jermar 876
 * @param callid    Storage where the hash of the IPC_M_DATA_WRITE call will
2522 jermar 877
 *          be stored.
878
 * @param size      Storage where the suggested size will be stored. May be
879
 *          NULL
880
 *
881
 * @return      Non-zero on success, zero on failure.
882
 */
2676 jermar 883
int ipc_data_write_receive(ipc_callid_t *callid, size_t *size)
2522 jermar 884
{
2619 jermar 885
    ipc_call_t data;
886
 
2522 jermar 887
    assert(callid);
888
 
2619 jermar 889
    *callid = async_get_call(&data);
2660 jermar 890
    if (IPC_GET_METHOD(data) != IPC_M_DATA_WRITE)
2522 jermar 891
        return 0;
892
    if (size)
2676 jermar 893
        *size = (size_t) IPC_GET_ARG2(data);
2522 jermar 894
    return 1;
895
}
896
 
2660 jermar 897
/** Wrapper for answering the IPC_M_DATA_WRITE calls.
2522 jermar 898
 *
2660 jermar 899
 * This wrapper only makes it more comfortable to answer IPC_M_DATA_WRITE calls
2522 jermar 900
 * so that the user doesn't have to remember the meaning of each IPC argument.
901
 *
2660 jermar 902
 * @param callid    Hash of the IPC_M_DATA_WRITE call to answer.
903
 * @param dst       Final destination address for the IPC_M_DATA_WRITE call.
904
 * @param size      Final size for the IPC_M_DATA_WRITE call.
2522 jermar 905
 *
906
 * @return      Zero on success or a value from @ref errno.h on failure.
907
 */
2678 jermar 908
int ipc_data_write_finalize(ipc_callid_t callid, void *dst, size_t size)
2522 jermar 909
{
2676 jermar 910
    return ipc_answer_2(callid, EOK, (ipcarg_t) dst, (ipcarg_t) size);
2522 jermar 911
}
912
 
1866 jermar 913
/** @}
1653 cejka 914
 */