'\" t .\" Title: wait_on_bit_timeout .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Generator: DocBook XSL Stylesheets v1.79.1 .\" Date: January 2017 .\" Manual: Driver Basics .\" Source: Kernel Hackers Manual 4.8.15 .\" Language: English .\" .TH "WAIT_ON_BIT_TIMEOUT" "9" "January 2017" "Kernel Hackers Manual 4\&.8\&." "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" wait_on_bit_timeout \- wait for a bit to be cleared or a timeout elapses .SH "SYNOPSIS" .HP \w'int\ wait_on_bit_timeout('u .BI "int wait_on_bit_timeout(unsigned\ long\ *\ " "word" ", int\ " "bit" ", unsigned\ " "mode" ", unsigned\ long\ " "timeout" ");" .SH "ARGUMENTS" .PP \fIword\fR .RS 4 the word being waited on, a kernel virtual address .RE .PP \fIbit\fR .RS 4 the bit of the word being waited on .RE .PP \fImode\fR .RS 4 the task state to sleep in .RE .PP \fItimeout\fR .RS 4 timeout, in jiffies .RE .SH "DESCRIPTION" .PP Use the standard hashed waitqueue table to wait for a bit to be cleared\&. This is similar to \fBwait_on_bit\fR, except also takes a timeout parameter\&. .PP Returned value will be zero if the bit was cleared before the \fItimeout\fR elapsed, or non\-zero if the \fItimeout\fR elapsed or process received a signal and the mode permitted wakeup on that signal\&. .SH "COPYRIGHT" .br