Subversion Repositories HelenOS

Rev

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

  1. /*
  2.  * Copyright (c) 2007 Jan Hudecek
  3.  * Copyright (c) 2006 Jakub Jermar
  4.  * All rights reserved.
  5.  *
  6.  * Redistribution and use in source and binary forms, with or without
  7.  * modification, are permitted provided that the following conditions
  8.  * are met:
  9.  *
  10.  * - Redistributions of source code must retain the above copyright
  11.  *   notice, this list of conditions and the following disclaimer.
  12.  * - Redistributions in binary form must reproduce the above copyright
  13.  *   notice, this list of conditions and the following disclaimer in the
  14.  *   documentation and/or other materials provided with the distribution.
  15.  * - The name of the author may not be used to endorse or promote products
  16.  *   derived from this software without specific prior written permission.
  17.  *
  18.  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
  19.  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
  20.  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
  21.  * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
  22.  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
  23.  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  24.  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  25.  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  26.  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
  27.  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  28.  */
  29. /** @addtogroup sync
  30.  * @{
  31.  */
  32. /** @file rcu.h
  33.  * @brief declarations for RCU
  34.  */
  35.  
  36. #ifndef KERN_RCU_H_
  37. #define KERN_RCU_H_
  38.  
  39. #include <arch/types.h>
  40. #include <proc/tasklet.h>
  41. #include <arch/barrier.h>
  42. #include <arch.h>
  43. #include <preemption.h>
  44.  
  45.  
  46. /** Structure for callbacks */
  47. typedef struct rcu_callback_list {
  48.     /** next in the list */
  49.     struct rcu_callback_list* next;
  50.     /** pointer to callback function */
  51.     void (*func)(void*);
  52.     /** argument to pass to the callback */
  53.     void* data;
  54. } rcu_callback_list_t;
  55.  
  56.  
  57. /** Read lock for RCU protected pointer */
  58. #define rcu_read_lock() preemption_disable()
  59.  
  60. /** Release of read lock for RCU protected pointer */
  61. #define rcu_read_unlock() preemption_enable()
  62.  
  63. /** Dereferencing of an RCU protected pointer */
  64. #define rcu_dereference_pointer(p) (*(p))
  65.  
  66. /** Assigning a value to an RCU protected pointer */
  67. #define rcu_assign_pointer(p, newp) {write_barrier(); (p)=(newp);}
  68.  
  69. /** RCU sync callback for those who don't need custom allocation */
  70. #define rcu_sync_callback_normal_alloc(func, data) {\
  71.     rcu_callback_list_t* rd = malloc(sizeof(rcu_callback_list_t),0);\
  72.     rcu_sync_callback(func, data, rd);}
  73.  
  74. /** RCU sync callback without custom allocation, default callback (just frees the argument) */
  75. #define rcu_sync_callback_normal_alloc_free(data) rcu_sync_callback_normal_alloc(&rcu_callback_free, data)
  76.  
  77. void rcu_init(void);
  78. void rcu_synchronize(void);
  79. void rcu_synchronize_callback_function(void* waitq);
  80. void rcu_sync_callback(void (*func)(void* data), void* data, rcu_callback_list_t* rcu_struct);
  81. void rcu_tasklet(void* data);  
  82. void rcu_passQS(void);
  83. void rcu_run_callbacks(void);
  84. void rcu_callback_free(void* pointer);
  85.  
  86.  
  87.  
  88.  
  89. #endif
  90.