dlmconstants.h 4.9 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163
  1. /******************************************************************************
  2. *******************************************************************************
  3. **
  4. ** Copyright (C) Sistina Software, Inc. 1997-2003 All rights reserved.
  5. ** Copyright (C) 2004-2007 Red Hat, Inc. All rights reserved.
  6. **
  7. ** This copyrighted material is made available to anyone wishing to use,
  8. ** modify, copy, or redistribute it subject to the terms and conditions
  9. ** of the GNU General Public License v.2.
  10. **
  11. *******************************************************************************
  12. ******************************************************************************/
  13. #ifndef __DLMCONSTANTS_DOT_H__
  14. #define __DLMCONSTANTS_DOT_H__
  15. /*
  16. * Constants used by DLM interface.
  17. */
  18. #define DLM_LOCKSPACE_LEN 64
  19. #define DLM_RESNAME_MAXLEN 64
  20. /*
  21. * Lock Modes
  22. */
  23. #define DLM_LOCK_IV (-1) /* invalid */
  24. #define DLM_LOCK_NL 0 /* null */
  25. #define DLM_LOCK_CR 1 /* concurrent read */
  26. #define DLM_LOCK_CW 2 /* concurrent write */
  27. #define DLM_LOCK_PR 3 /* protected read */
  28. #define DLM_LOCK_PW 4 /* protected write */
  29. #define DLM_LOCK_EX 5 /* exclusive */
  30. /*
  31. * Flags to dlm_lock
  32. *
  33. * DLM_LKF_NOQUEUE
  34. *
  35. * Do not queue the lock request on the wait queue if it cannot be granted
  36. * immediately. If the lock cannot be granted because of this flag, DLM will
  37. * either return -EAGAIN from the dlm_lock call or will return 0 from
  38. * dlm_lock and -EAGAIN in the lock status block when the AST is executed.
  39. *
  40. * DLM_LKF_CANCEL
  41. *
  42. * Used to cancel a pending lock request or conversion. A converting lock is
  43. * returned to its previously granted mode.
  44. *
  45. * DLM_LKF_CONVERT
  46. *
  47. * Indicates a lock conversion request. For conversions the name and namelen
  48. * are ignored and the lock ID in the LKSB is used to identify the lock.
  49. *
  50. * DLM_LKF_VALBLK
  51. *
  52. * Requests DLM to return the current contents of the lock value block in the
  53. * lock status block. When this flag is set in a lock conversion from PW or EX
  54. * modes, DLM assigns the value specified in the lock status block to the lock
  55. * value block of the lock resource. The LVB is a DLM_LVB_LEN size array
  56. * containing application-specific information.
  57. *
  58. * DLM_LKF_QUECVT
  59. *
  60. * Force a conversion request to be queued, even if it is compatible with
  61. * the granted modes of other locks on the same resource.
  62. *
  63. * DLM_LKF_IVVALBLK
  64. *
  65. * Invalidate the lock value block.
  66. *
  67. * DLM_LKF_CONVDEADLK
  68. *
  69. * Allows the dlm to resolve conversion deadlocks internally by demoting the
  70. * granted mode of a converting lock to NL. The DLM_SBF_DEMOTED flag is
  71. * returned for a conversion that's been effected by this.
  72. *
  73. * DLM_LKF_PERSISTENT
  74. *
  75. * Only relevant to locks originating in userspace. A persistent lock will not
  76. * be removed if the process holding the lock exits.
  77. *
  78. * DLM_LKF_NODLCKWT
  79. *
  80. * Do not cancel the lock if it gets into conversion deadlock.
  81. * Exclude this lock from being monitored due to DLM_LSFL_TIMEWARN.
  82. *
  83. * DLM_LKF_NODLCKBLK
  84. *
  85. * net yet implemented
  86. *
  87. * DLM_LKF_EXPEDITE
  88. *
  89. * Used only with new requests for NL mode locks. Tells the lock manager
  90. * to grant the lock, ignoring other locks in convert and wait queues.
  91. *
  92. * DLM_LKF_NOQUEUEBAST
  93. *
  94. * Send blocking AST's before returning -EAGAIN to the caller. It is only
  95. * used along with the NOQUEUE flag. Blocking AST's are not sent for failed
  96. * NOQUEUE requests otherwise.
  97. *
  98. * DLM_LKF_HEADQUE
  99. *
  100. * Add a lock to the head of the convert or wait queue rather than the tail.
  101. *
  102. * DLM_LKF_NOORDER
  103. *
  104. * Disregard the standard grant order rules and grant a lock as soon as it
  105. * is compatible with other granted locks.
  106. *
  107. * DLM_LKF_ORPHAN
  108. *
  109. * Acquire an orphan lock.
  110. *
  111. * DLM_LKF_ALTPR
  112. *
  113. * If the requested mode cannot be granted immediately, try to grant the lock
  114. * in PR mode instead. If this alternate mode is granted instead of the
  115. * requested mode, DLM_SBF_ALTMODE is returned in the lksb.
  116. *
  117. * DLM_LKF_ALTCW
  118. *
  119. * The same as ALTPR, but the alternate mode is CW.
  120. *
  121. * DLM_LKF_FORCEUNLOCK
  122. *
  123. * Unlock the lock even if it is converting or waiting or has sublocks.
  124. * Only really for use by the userland device.c code.
  125. *
  126. */
  127. #define DLM_LKF_NOQUEUE 0x00000001
  128. #define DLM_LKF_CANCEL 0x00000002
  129. #define DLM_LKF_CONVERT 0x00000004
  130. #define DLM_LKF_VALBLK 0x00000008
  131. #define DLM_LKF_QUECVT 0x00000010
  132. #define DLM_LKF_IVVALBLK 0x00000020
  133. #define DLM_LKF_CONVDEADLK 0x00000040
  134. #define DLM_LKF_PERSISTENT 0x00000080
  135. #define DLM_LKF_NODLCKWT 0x00000100
  136. #define DLM_LKF_NODLCKBLK 0x00000200
  137. #define DLM_LKF_EXPEDITE 0x00000400
  138. #define DLM_LKF_NOQUEUEBAST 0x00000800
  139. #define DLM_LKF_HEADQUE 0x00001000
  140. #define DLM_LKF_NOORDER 0x00002000
  141. #define DLM_LKF_ORPHAN 0x00004000
  142. #define DLM_LKF_ALTPR 0x00008000
  143. #define DLM_LKF_ALTCW 0x00010000
  144. #define DLM_LKF_FORCEUNLOCK 0x00020000
  145. #define DLM_LKF_TIMEOUT 0x00040000
  146. /*
  147. * Some return codes that are not in errno.h
  148. */
  149. #define DLM_ECANCEL 0x10001
  150. #define DLM_EUNLOCK 0x10002
  151. #endif /* __DLMCONSTANTS_DOT_H__ */