fwcutter: Fix type punning
[b43-tools.git] / fwcutter / README
1                         BCM43XX Linux Driver Project
2                         ============================
3
4
5 About this software
6 -------------------
7
8 b43-fwcutter is a tool which can extract firmware from various source files.
9 It's written for BCM43xx driver files.
10
11 The project page is http://bcm43xx.berlios.de/
12
13
14 Usage
15 -----
16
17 b43-fwcutter FILE               extracts the firmware from a source FILE to
18                                 the current directory, creating a directory
19                                 "b43" or "b43legacy" with files in it.
20 b43-fwcutter -i FILE            identify the driver file; print information
21                                 but don't extract.
22 b43-fwcutter -w /tmp FILE       extract and write firmware to /tmp.
23 b43-fwcutter -l                 prints a list of supported driver source files.
24
25 After extraction, copy the "b43" or "b43legacy" directory to your firmware
26 directory (usually /lib/firmware or similar, see below). Alternatively you
27 can use the -w option to b43-fwcutter.
28
29 Different distributions use different directories to load firmware from.
30 If the driver complains about missing firmware files look for the correct
31 directory. For some distributions you have to use /lib/hotplug/firmware
32 or /usr/lib/hotplug/firmware but other directories are also possible.
33
34 Because firmware file are stored in big endian, extraction doesn't depend
35 on the system you're using. You can use extracted firmware from any driver
36 on any system and also copy the extracted files to any other system (e.g.
37 if extraction on the target system isn't feasible.)
38
39
40 Where can I find some driver source files?
41 ------------------------------------------
42
43 Please check the references at
44 http://www.linuxwireless.org/en/users/Drivers/bcm43xx#devicefirmware
45
46 It is recommended that you extract firmware for both b43 and b43legacy in
47 order to support both types of cards on your system.