patch-2.3.99-pre1 linux/drivers/sound/sound_firmware.c

• Lines: 25
• Date: Tue Mar 14 17:54:42 2000
• Orig file: v2.3.51/linux/drivers/sound/sound_firmware.c
• Orig date: Mon Jan 4 11:37:30 1999

diff -u --recursive --new-file v2.3.51/linux/drivers/sound/sound_firmware.c linux/drivers/sound/sound_firmware.c
@@ -47,6 +47,24 @@
 	return (int) l;
 }
 
+/**
+ *	mod_firmware_load - load sound driver firmware
+ *	@fn: filename
+ *	@fp: return for the buffer.
+ *
+ *	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.
+ *
+ *	The length of the buffer is returned on a successful load, the
+ *	value zero on a failure.
+ *
+ *	Caution: This API is not recommended. Firmware should be loaded via
+ *	an ioctl call and a setup application. This function may disappear
+ *	in future.
+ */
+ 
 int mod_firmware_load(const char *fn, char **fp)
 {
 	int r;