X-Git-Url: https://jxself.org/git/?a=blobdiff_plain;f=debug%2FREADME;h=08a6996996e63e5c31a6e707ea6001745c073af0;hb=8bbba3f44abed4ad1174032c8e03ee60b2fae2f0;hp=5ddd1021d31adab9f3c025eafd9dca3b01cb596a;hpb=e449c641321a85210ce9f9dee08827fe838459e3;p=b43-tools.git

diff --git a/debug/README b/debug/README
index 5ddd102..08a6996 100644
--- a/debug/README
+++ b/debug/README
@@ -4,7 +4,44 @@ Note that it is licensed under the GNU GPL version 3 ONLY!
 Installing:
 	Run the install.py script as root.
 
-Please be careful when using these tools. They have direct access to the
-hardware, so you can easily crash something.
+*******************************************************************************
+*  b43-fwdump                                                                 *
+*******************************************************************************
+
+b43-fwdump is an utility for dumping the current status of the device firmware
+on a running device. It has some auto-detection mechanisms. So if you have
+only one card in the machine, it will dump the firmware state of that card, if
+called without any parameters.
+Use the --shm option, if you want a Shared Memory dump.
+Use the --binary option, if you want b43-fwdump to automatically dump the
+disassembled code at the current PC. This is convenient for debugging
+firmware crashes.
+
+Note that b43-fwdump _must_ be run as root, as it needs direct access to the
+hardware through debugfs.
+Debugfs must be mounted and you must have a recent driver with support for raw
+hardware access through debugfs.
+If you get error messages about missing debugfs files, make sure to upgrade to
+the latest development snapshot of the b43 driver.
+
+*******************************************************************************
+*  b43-beautifier                                                             *
+*******************************************************************************
+
+b43-beautifier is a tool to replace constant expressions in raw disassembled
+firmware code with human-readable #defined names.
+
+The tool requires either the disassembled source code or a binary (which it
+will disassemble then) to start with. See the --asmfile and --binfile
+parameters.
+It also requires a path to the directory containing the hardware definitions.
+This is the "common" subdirectory found in the b43-ucode GIT repository.
+See the --defs parameter.
+
+
+
+
+Please be careful when using these tools. Some of them have direct access to
+the hardware, so you can easily crash something.
 
 	Michael