include/linux/ww_mutex.h

78  * ww_mutex_init - initialize the w/w mutex
80  * @ww_class: the w/w class the mutex should belong to
82  * Initialize the w/w mutex to unlocked state and associate it with the given
98  * ww_acquire_init - initialize a w/w acquire context
99  * @ctx: w/w acquire context to initialize
100  * @ww_class: w/w class of the context
102  * Initializes an context to acquire multiple mutexes of the given w/w class.
104  * Context-based w/w mutex acquiring can be done in any order whatsoever within
108  * Mixing of context-based w/w mutex acquiring and single w/w mutex locking can
110  * for the same w/w class when acquiring mutexes can also result in undetected
114  * Nesting of acquire contexts for _different_ w/w classes is possible, subject
150  * Marks the end of the acquire phase, any further w/w mutex lock calls using
153  * Calling this function is optional, it is just useful to document w/w mutex
168  * ww_acquire_fini - releases a w/w acquire context
171  * Releases a w/w acquire context. This must be called _after_ all acquired w/w
195  * ww_mutex_lock - acquire the w/w mutex
197  * @ctx: w/w acquire context, or NULL to acquire only a single lock.
199  * Lock the w/w mutex exclusively for this task.
201  * Deadlocks within a given w/w class of locks are detected and handled with the
208  * In the die case the caller must release all currently held w/w mutexes for
211  * lock and proceed with trying to acquire further w/w mutexes (e.g. when
219  * of the same w/w lock class as was used to initialize the acquire context.
226  * ww_mutex_lock_interruptible - acquire the w/w mutex, interruptible
228  * @ctx: w/w acquire context
230  * Lock the w/w mutex exclusively for this task.
232  * Deadlocks within a given w/w class of locks are detected and handled with the
240  * In the die case the caller must release all currently held w/w mutexes for
243  * not acquire this lock and proceed with trying to acquire further w/w mutexes
251  * of the same w/w lock class as was used to initialize the acquire context.
259  * ww_mutex_lock_slow - slowpath acquiring of the w/w mutex
261  * @ctx: w/w acquire context
263  * Acquires a w/w mutex with the given context after a die case. This function
266  * The caller must have released all w/w mutexes already acquired with the
269  * Afterwards the caller may continue to (re)acquire the other w/w mutexes it
273  * It is forbidden to call this function with any other w/w mutexes associated
278  * ww_mutex_lock directly. This function here is simply to help w/w mutex
293  * ww_mutex_lock_slow_interruptible - slowpath acquiring of the w/w mutex, interruptible
295  * @ctx: w/w acquire context
297  * Acquires a w/w mutex with the given context after a die case. This function
302  * The caller must have released all w/w mutexes already acquired with the
305  * Afterwards the caller may continue to (re)acquire the other w/w mutexes it
309  * It is forbidden to call this function with any other w/w mutexes associated
315  * w/w mutex locking code readability by clearly denoting the slowpath.
330  * ww_mutex_trylock - tries to acquire the w/w mutex without acquire context
342  * ww_mutex_destroy - mark a w/w mutex unusable
355  * ww_mutex_is_locked - is the w/w mutex locked