'\" t .\" Title: abort_exclusive_wait .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Generator: DocBook XSL Stylesheets v1.78.1 .\" Date: May 2018 .\" Manual: Driver Basics .\" Source: Kernel Hackers Manual 3.16.56 .\" Language: English .\" .TH "ABORT_EXCLUSIVE_WAIT" "9" "May 2018" "Kernel Hackers Manual 3\&.16\&" "Driver Basics" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .\" http://bugs.debian.org/507673 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" ----------------------------------------------------------------- .\" * set default formatting .\" ----------------------------------------------------------------- .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) .ad l .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH "NAME" abort_exclusive_wait \- abort exclusive waiting in a queue .SH "SYNOPSIS" .HP \w'void\ abort_exclusive_wait('u .BI "void abort_exclusive_wait(wait_queue_head_t\ *\ " "q" ", wait_queue_t\ *\ " "wait" ", unsigned\ int\ " "mode" ", void\ *\ " "key" ");" .SH "ARGUMENTS" .PP \fIq\fR .RS 4 waitqueue waited on .RE .PP \fIwait\fR .RS 4 wait descriptor .RE .PP \fImode\fR .RS 4 runstate of the waiter to be woken .RE .PP \fIkey\fR .RS 4 key to identify a wait bit queue or \fBNULL\fR .RE .SH "DESCRIPTION" .PP Sets current thread back to running state and removes the wait descriptor from the given waitqueue if still queued\&. .PP Wakes up the next waiter if the caller is concurrently woken up through the queue\&. .PP This prevents waiter starvation where an exclusive waiter aborts and is woken up concurrently and no one wakes up the next waiter\&. .SH "COPYRIGHT" .br