.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve@ggi-project.org>.
.TH "MOD_FIRMWARE_LOAD" "" "06 October 2005" "" ""

.SH NAME
mod_firmware_load \- load sound driver firmware
.SH SYNOPSIS
"SYNOPSIS"
.sp
\fB
.sp
int mod_firmware_load  (const char * \fIfn\fB, char ** \fIfp\fB);
\fR
.SH "ARGUMENTS"
.TP
\fB\fIfn\fB\fR
filename
.TP
\fB\fIfp\fB\fR
return for the buffer.
.SH "DESCRIPTION"
.PP
Load the firmware for a sound module (up to 128K) into a buffer.
The buffer is returned in *fp. It is allocated with vmalloc so is
virtually linear and not DMAable. The caller should free it with
vfree when finished.
.PP
The length of the buffer is returned on a successful load, the
value zero on a failure.
.SH "CAUTION"
.PP
This API is not recommended. Firmware should be loaded via
an ioctl call and a setup application. This function may disappear
in future.