summaryrefslogtreecommitdiff
path: root/include/display_options.h
diff options
context:
space:
mode:
authorSimon Glass <sjg@chromium.org>2021-05-08 16:00:05 +0300
committerTom Rini <trini@konsulko.com>2021-06-08 18:39:09 +0300
commit0cceb99ac59b1d383488ea3ce6511ffc01da5332 (patch)
tree67dc9eb75f3aa6a469eb4c57bfd432139a7958aa /include/display_options.h
parent735dd6ef89ebd3e05c1dfaef06aca61046503c63 (diff)
downloadu-boot-0cceb99ac59b1d383488ea3ce6511ffc01da5332.tar.xz
display_options: Split print_buffer() into two functions
At present print_buffer() outputs a hex dump but it is not possible to place this dump in a string. Refactor it into a top-level function which does the printing and a utility function that dumps a line into a string. This makes the code more generally useful. Signed-off-by: Simon Glass <sjg@chromium.org>
Diffstat (limited to 'include/display_options.h')
-rw-r--r--include/display_options.h25
1 files changed, 25 insertions, 0 deletions
diff --git a/include/display_options.h b/include/display_options.h
index 049688e39e..43810cbe22 100644
--- a/include/display_options.h
+++ b/include/display_options.h
@@ -47,6 +47,31 @@ void print_freq(uint64_t freq, const char *suffix);
int print_buffer(ulong addr, const void *data, uint width, uint count,
uint linelen);
+/*
+ * Maximum length of an output line is when width == 1
+ * 9 for address,
+ * a space, two hex digits and an ASCII character for each byte
+ * 2 spaces between the hex and ASCII
+ * \0 terminator
+ */
+#define HEXDUMP_MAX_BUF_LENGTH(bytes) (9 + (bytes) * 4 + 3)
+
+/**
+ * hexdump_line() - Print out a single line of a hex dump
+ *
+ * @addr: Starting address to display at start of line
+ * @data: pointer to data buffer
+ * @width: data value width. May be 1, 2, or 4.
+ * @count: number of values to display
+ * @linelen: Number of values to print per line; specify 0 for default length
+ * @out: Output buffer to hold the dump
+ * @size: Size of output buffer in bytes
+ * @return number of bytes processed, if OK, -ENOSPC if buffer too small
+ *
+ */
+int hexdump_line(ulong addr, const void *data, uint width, uint count,
+ uint linelen, char *out, int size);
+
/**
* display_options() - display the version string / build tag
*