include/linux/ww_mutex.h

88  * ww_mutex_init - initialize the w/w mutex
90  * @ww_class: the w/w class the mutex should belong to
92  * Initialize the w/w mutex to unlocked state and associate it with the given
93  * class. Static define macro for w/w mutex is not provided and this function
94  * is the only way to properly initialize the w/w mutex.
109  * ww_acquire_init - initialize a w/w acquire context
110  * @ctx: w/w acquire context to initialize
111  * @ww_class: w/w class of the context
113  * Initializes an context to acquire multiple mutexes of the given w/w class.
115  * Context-based w/w mutex acquiring can be done in any order whatsoever within
119  * Mixing of context-based w/w mutex acquiring and single w/w mutex locking can
121  * for the same w/w class when acquiring mutexes can also result in undetected
125  * Nesting of acquire contexts for _different_ w/w classes is possible, subject
161  * Marks the end of the acquire phase, any further w/w mutex lock calls using
164  * Calling this function is optional, it is just useful to document w/w mutex
179  * ww_acquire_fini - releases a w/w acquire context
182  * Releases a w/w acquire context. This must be called _after_ all acquired w/w
206  * ww_mutex_lock - acquire the w/w mutex
208  * @ctx: w/w acquire context, or NULL to acquire only a single lock.
210  * Lock the w/w mutex exclusively for this task.
212  * Deadlocks within a given w/w class of locks are detected and handled with the
219  * In the die case the caller must release all currently held w/w mutexes for
222  * lock and proceed with trying to acquire further w/w mutexes (e.g. when
230  * of the same w/w lock class as was used to initialize the acquire context.
237  * ww_mutex_lock_interruptible - acquire the w/w mutex, interruptible
239  * @ctx: w/w acquire context
241  * Lock the w/w mutex exclusively for this task.
243  * Deadlocks within a given w/w class of locks are detected and handled with the
251  * In the die case the caller must release all currently held w/w mutexes for
254  * not acquire this lock and proceed with trying to acquire further w/w mutexes
262  * of the same w/w lock class as was used to initialize the acquire context.
270  * ww_mutex_lock_slow - slowpath acquiring of the w/w mutex
272  * @ctx: w/w acquire context
274  * Acquires a w/w mutex with the given context after a die case. This function
277  * The caller must have released all w/w mutexes already acquired with the
280  * Afterwards the caller may continue to (re)acquire the other w/w mutexes it
284  * It is forbidden to call this function with any other w/w mutexes associated
289  * ww_mutex_lock directly. This function here is simply to help w/w mutex
304  * ww_mutex_lock_slow_interruptible - slowpath acquiring of the w/w mutex, interruptible
306  * @ctx: w/w acquire context
308  * Acquires a w/w mutex with the given context after a die case. This function
313  * The caller must have released all w/w mutexes already acquired with the
316  * Afterwards the caller may continue to (re)acquire the other w/w mutexes it
320  * It is forbidden to call this function with any other w/w mutexes associated
326  * w/w mutex locking code readability by clearly denoting the slowpath.
344  * ww_mutex_destroy - mark a w/w mutex unusable
359  * ww_mutex_is_locked - is the w/w mutex locked