'\" t .\" Title: request_firmware_nowait .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Generator: DocBook XSL Stylesheets v1.79.1 .\" Date: January 2017 .\" Manual: Device drivers infrastructure .\" Source: Kernel Hackers Manual 4.8.15 .\" Language: English .\" .TH "REQUEST_FIRMWARE_NOW" "9" "January 2017" "Kernel Hackers Manual 4\&.8\&." "Device drivers infrastructure" .\" ----------------------------------------------------------------- .\" * 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" request_firmware_nowait \- asynchronous version of request_firmware .SH "SYNOPSIS" .HP \w'int\ request_firmware_nowait('u .BI "int request_firmware_nowait(struct\ module\ *\ " "module" ", bool\ " "uevent" ", const\ char\ *\ " "name" ", struct\ device\ *\ " "device" ", gfp_t\ " "gfp" ", void\ *\ " "context" ", void\ (*" "cont" ")\ (const\ struct\ firmware\ *fw,\ void\ *context));" .SH "ARGUMENTS" .PP \fImodule\fR .RS 4 module requesting the firmware .RE .PP \fIuevent\fR .RS 4 sends uevent to copy the firmware image if this flag is non\-zero else the firmware copy must be done manually\&. .RE .PP \fIname\fR .RS 4 name of firmware file .RE .PP \fIdevice\fR .RS 4 device for which firmware is being loaded .RE .PP \fIgfp\fR .RS 4 allocation flags .RE .PP \fIcontext\fR .RS 4 will be passed over to \fIcont\fR, and \fIfw\fR may be \fBNULL\fR if firmware request fails\&. .RE .PP \fIcont\fR .RS 4 function will be called asynchronously when the firmware request is over\&. .RE .SH "DESCRIPTION" .PP Caller must hold the reference count of \fIdevice\fR\&. .PP Asynchronous variant of \fBrequest_firmware\fR for user contexts: \- sleep for as small periods as possible since it may increase kernel boot time of built\-in device drivers requesting firmware in their \->\fBprobe\fR methods, if \fIgfp\fR is GFP_KERNEL\&. .PP \- can\*(Aqt sleep at all if \fIgfp\fR is GFP_ATOMIC\&. .SH "COPYRIGHT" .br