[PATCH v4 4/9] doc: Add a note about producing 'md.b' output using hexdump

[Simon Glass]

Comparing a hex dump on the U-Boot command line with the contents of a
file on the host system is fairly easy and convenient to do manually if
it is small. But the format used hexdump by default differs from that
shown by U-Boot. Add a note about how to make them the same.

(For large dumps, writing the data to the network with tftpput, or to a
USB stick with ext4save is easiest.)

Signed-off-by: Simon Glass <sjg at chromium.org>
---

Changes in v4:
- Indicate that hd does not show the offset correctly
- Add an xxd + sed example too

Changes in v3:
- Add this to the docs for the md command

 doc/usage/md.rst | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/doc/usage/md.rst b/doc/usage/md.rst
index 3951b0d58f5..4c1073ea354 100644
--- a/doc/usage/md.rst
+++ b/doc/usage/md.rst
@@ -39,6 +39,16 @@ length
     number of values to dump. Defaults to 40 (0d64). Note that this is not
     the same as the number of bytes, unless .b is used.
 
+Note that the format of 'md.b' can be emulated from linux with::
+
+    # This works but requires using sed to get the extra spaces
+    # <addr> is the address, <f> is the filename
+    xxd -o <addr> -g1 <f> |sed 's/  /    /' >bad
+
+    # This uses a single tool but the offset always starts at 0
+    # <f> is the filename
+    hexdump -v -e '"%08.8_ax: " 16/1 "%02x " "    "' -e '16/1 "%_p" "\n" ' <f>
+
 
 Example
 -------
-- 
2.30.0.478.g8a0d178c01-goog