sync0arr.h
上传用户:tsgydb
上传日期:2007-04-14
资源大小:10674k
文件大小:4k
源码类别:

MySQL数据库

开发平台:

Visual C++

  1. /******************************************************
  2. The wait array used in synchronization primitives
  3. (c) 1995 Innobase Oy
  4. Created 9/5/1995 Heikki Tuuri
  5. *******************************************************/
  6. #ifndef sync0arr_h
  7. #define sync0arr_h
  8. #include "univ.i"
  9. #include "ut0lst.h"
  10. #include "ut0mem.h"
  11. #include "os0thread.h"
  12. typedef struct sync_cell_struct         sync_cell_t;
  13. typedef struct sync_array_struct sync_array_t;
  14. #define SYNC_ARRAY_OS_MUTEX 1
  15. #define SYNC_ARRAY_MUTEX 2
  16. /***********************************************************************
  17. Creates a synchronization wait array. It is protected by a mutex
  18. which is automatically reserved when the functions operating on it
  19. are called. */
  20. sync_array_t*
  21. sync_array_create(
  22. /*==============*/
  23. /* out, own: created wait array */
  24. ulint n_cells, /* in: number of cells in the array
  25. to create */
  26. ulint protection); /* in: either SYNC_ARRAY_OS_MUTEX or
  27. SYNC_ARRAY_MUTEX: determines the type
  28. of mutex protecting the data structure */
  29. /**********************************************************************
  30. Frees the resources in a wait array. */
  31. void
  32. sync_array_free(
  33. /*============*/
  34. sync_array_t* arr); /* in, own: sync wait array */
  35. /**********************************************************************
  36. Reserves a wait array cell for waiting for an object.
  37. The event of the cell is reset to nonsignalled state. */
  38. void
  39. sync_array_reserve_cell(
  40. /*====================*/
  41.         sync_array_t* arr, /* in: wait array */
  42.         void*    object, /* in: pointer to the object to wait for */
  43.         ulint type, /* in: lock request type */
  44. #ifdef UNIV_SYNC_DEBUG
  45.         char* file, /* in: in debug version file where
  46.          requested */
  47.         ulint line, /* in: in the debug version line where
  48.          requested */
  49. #endif
  50.         ulint*    index);  /* out: index of the reserved cell */
  51. /**********************************************************************
  52. This function should be called when a thread starts to wait on
  53. a wait array cell. In the debug version this function checks
  54. if the wait for a semaphore will result in a deadlock, in which
  55. case prints info and asserts. */
  56. void
  57. sync_array_wait_event(
  58. /*==================*/
  59.         sync_array_t* arr, /* in: wait array */
  60.         ulint    index);  /* in: index of the reserved cell */
  61. /**********************************************************************
  62. Frees the cell. NOTE! sync_array_wait_event frees the cell
  63. automatically! */
  64. void
  65. sync_array_free_cell(
  66. /*=================*/
  67. sync_array_t* arr, /* in: wait array */
  68.         ulint     index);  /* in: index of the cell in array */
  69. /**************************************************************************
  70. Looks for the cells in the wait array which refer
  71. to the wait object specified,
  72. and sets their corresponding events to the signaled state. In this
  73. way releases the threads waiting for the object to contend for the object.
  74. It is possible that no such cell is found, in which case does nothing. */
  75. void
  76. sync_array_signal_object(
  77. /*=====================*/
  78. sync_array_t* arr, /* in: wait array */
  79. void* object);/* in: wait object */
  80. /************************************************************************
  81. Validates the integrity of the wait array. Checks
  82. that the number of reserved cells equals the count variable. */
  83. void
  84. sync_array_validate(
  85. /*================*/
  86. sync_array_t* arr); /* in: sync wait array */
  87. /**************************************************************************
  88. Prints info of the wait array. */
  89. void
  90. sync_array_print_info(
  91. /*==================*/
  92. sync_array_t* arr); /* in: wait array */
  93. #ifndef UNIV_NONINL
  94. #include "sync0arr.ic"
  95. #endif
  96. #endif