Subversion Repositories HelenOS

Rev

Rev 2131 | Blame | Compare with Previous | Last modification | View Log | Download | RSS feed

  1. /*
  2.  * Copyright (c) 2006 Ondrej 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.
  27.  */
  28.  
  29. /** @addtogroup libc
  30.  * @{
  31.  */
  32. /** @file
  33.  */
  34.  
  35. #ifndef LIBC_ASYNC_H_
  36. #define LIBC_ASYNC_H_
  37.  
  38. #include <ipc/ipc.h>
  39. #include <psthread.h>
  40. #include <sys/time.h>
  41. #include <atomic.h>
  42.  
  43. typedef ipc_callid_t aid_t;
  44. typedef void (*async_client_conn_t)(ipc_callid_t callid, ipc_call_t *call);
  45.  
  46. static inline void async_manager(void)
  47. {
  48.     psthread_schedule_next_adv(PS_TO_MANAGER);
  49. }
  50.  
  51. ipc_callid_t async_get_call_timeout(ipc_call_t *call, suseconds_t usecs);
  52. static inline ipc_callid_t async_get_call(ipc_call_t *data)
  53. {
  54.     return async_get_call_timeout(data, 0);
  55. }
  56.  
  57. aid_t async_send_2(int phoneid, ipcarg_t method, ipcarg_t arg1, ipcarg_t arg2,
  58.            ipc_call_t *dataptr);
  59. aid_t async_send_3(int phoneid, ipcarg_t method, ipcarg_t arg1, ipcarg_t arg2,
  60.            ipcarg_t arg3, ipc_call_t *dataptr);
  61. void async_wait_for(aid_t amsgid, ipcarg_t *result);
  62. int async_wait_timeout(aid_t amsgid, ipcarg_t *retval, suseconds_t timeout);
  63.  
  64. /** Pseudo-synchronous message sending
  65.  *
  66.  * Send message through IPC, wait in the event loop, until it is received
  67.  *
  68.  * @return Return code of message
  69.  */
  70. static inline ipcarg_t async_req_2(int phoneid, ipcarg_t method, ipcarg_t arg1, ipcarg_t arg2, ipcarg_t *r1, ipcarg_t *r2)
  71. {
  72.     ipc_call_t result;
  73.     ipcarg_t rc;
  74.  
  75.     aid_t eid = async_send_2(phoneid, method, arg1, arg2, &result);
  76.     async_wait_for(eid, &rc);
  77.     if (r1)
  78.         *r1 = IPC_GET_ARG1(result);
  79.     if (r2)
  80.         *r2 = IPC_GET_ARG2(result);
  81.     return rc;
  82. }
  83. #define async_req(phoneid, method, arg1, r1) async_req_2(phoneid, method, arg1, 0, r1, 0)
  84.  
  85. static inline ipcarg_t async_req_3(int phoneid, ipcarg_t method, ipcarg_t arg1,
  86.                    ipcarg_t arg2, ipcarg_t arg3, ipcarg_t *r1,
  87.                    ipcarg_t *r2, ipcarg_t *r3)
  88. {
  89.     ipc_call_t result;
  90.     ipcarg_t rc;
  91.  
  92.     aid_t eid = async_send_3(phoneid, method, arg1, arg2, arg3, &result);
  93.     async_wait_for(eid, &rc);
  94.     if (r1)
  95.         *r1 = IPC_GET_ARG1(result);
  96.     if (r2)
  97.         *r2 = IPC_GET_ARG2(result);
  98.     if (r3)
  99.         *r3 = IPC_GET_ARG3(result);
  100.     return rc;
  101. }
  102.  
  103.  
  104. pstid_t async_new_connection(ipcarg_t in_phone_hash,ipc_callid_t callid,
  105.                  ipc_call_t *call,
  106.                  void (*cthread)(ipc_callid_t,ipc_call_t *));
  107. void async_usleep(suseconds_t timeout);
  108. void async_create_manager(void);
  109. void async_destroy_manager(void);
  110. void async_set_client_connection(async_client_conn_t conn);
  111. void async_set_interrupt_received(async_client_conn_t conn);
  112. int _async_init(void);
  113.  
  114.  
  115. /* Primitve functions for IPC communication */
  116. void async_msg_3(int phoneid, ipcarg_t method, ipcarg_t arg1, ipcarg_t arg2,
  117.          ipcarg_t arg3);
  118. void async_msg_2(int phoneid, ipcarg_t method, ipcarg_t arg1, ipcarg_t arg2);
  119. #define async_msg(ph, m, a1) async_msg_2(ph, m, a1, 0)
  120.  
  121. static inline void async_serialize_start(void)
  122. {
  123.     psthread_inc_sercount();
  124. }
  125.  
  126. static inline void async_serialize_end(void)
  127. {
  128.     psthread_dec_sercount();
  129. }
  130.  
  131. extern atomic_t async_futex;
  132. #endif
  133.  
  134. /** @}
  135.  */
  136.