Merge remote-tracking branches 'asoc/topic/adsp', 'asoc/topic/ak4613', 'asoc/topic...
[sfrench/cifs-2.6.git] / Documentation / driver-api / firmware / lookup-order.rst
1 =====================
2 Firmware lookup order
3 =====================
4
5 Different functionality is available to enable firmware to be found.
6 Below is chronological order of how firmware will be looked for once
7 a driver issues a firmware API call.
8
9 * The ''Built-in firmware'' is checked first, if the firmware is present we
10   return it immediately
11 * The ''Firmware cache'' is looked at next. If the firmware is found we
12   return it immediately
13 * The ''Direct filesystem lookup'' is performed next, if found we
14   return it immediately
15 * If no firmware has been found and the fallback mechanism was enabled
16   the sysfs interface is created. After this either a kobject uevent
17   is issued or the custom firmware loading is relied upon for firmware
18   loading up to the timeout value.