123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307 |
- // SPDX-License-Identifier: BSD-3-Clause OR GPL-2.0
- /******************************************************************************
- *
- * Module Name: utbuffer - Buffer dump routines
- *
- * Copyright (C) 2000 - 2022, Intel Corp.
- *
- *****************************************************************************/
- #include <acpi/acpi.h>
- #include "accommon.h"
- #define _COMPONENT ACPI_UTILITIES
- ACPI_MODULE_NAME("utbuffer")
- /*******************************************************************************
- *
- * FUNCTION: acpi_ut_dump_buffer
- *
- * PARAMETERS: buffer - Buffer to dump
- * count - Amount to dump, in bytes
- * display - BYTE, WORD, DWORD, or QWORD display:
- * DB_BYTE_DISPLAY
- * DB_WORD_DISPLAY
- * DB_DWORD_DISPLAY
- * DB_QWORD_DISPLAY
- * base_offset - Beginning buffer offset (display only)
- *
- * RETURN: None
- *
- * DESCRIPTION: Generic dump buffer in both hex and ascii.
- *
- ******************************************************************************/
- void acpi_ut_dump_buffer(u8 *buffer, u32 count, u32 display, u32 base_offset)
- {
- u32 i = 0;
- u32 j;
- u32 temp32;
- u8 buf_char;
- u32 display_data_only = display & DB_DISPLAY_DATA_ONLY;
- display &= ~DB_DISPLAY_DATA_ONLY;
- if (!buffer) {
- acpi_os_printf("Null Buffer Pointer in DumpBuffer!\n");
- return;
- }
- if ((count < 4) || (count & 0x01)) {
- display = DB_BYTE_DISPLAY;
- }
- /* Nasty little dump buffer routine! */
- while (i < count) {
- /* Print current offset */
- if (!display_data_only) {
- acpi_os_printf("%8.4X: ", (base_offset + i));
- }
- /* Print 16 hex chars */
- for (j = 0; j < 16;) {
- if (i + j >= count) {
- /* Dump fill spaces */
- acpi_os_printf("%*s", ((display * 2) + 1), " ");
- j += display;
- continue;
- }
- switch (display) {
- case DB_BYTE_DISPLAY:
- default: /* Default is BYTE display */
- acpi_os_printf("%02X ",
- buffer[(acpi_size)i + j]);
- break;
- case DB_WORD_DISPLAY:
- ACPI_MOVE_16_TO_32(&temp32,
- &buffer[(acpi_size)i + j]);
- acpi_os_printf("%04X ", temp32);
- break;
- case DB_DWORD_DISPLAY:
- ACPI_MOVE_32_TO_32(&temp32,
- &buffer[(acpi_size)i + j]);
- acpi_os_printf("%08X ", temp32);
- break;
- case DB_QWORD_DISPLAY:
- ACPI_MOVE_32_TO_32(&temp32,
- &buffer[(acpi_size)i + j]);
- acpi_os_printf("%08X", temp32);
- ACPI_MOVE_32_TO_32(&temp32,
- &buffer[(acpi_size)i + j +
- 4]);
- acpi_os_printf("%08X ", temp32);
- break;
- }
- j += display;
- }
- /*
- * Print the ASCII equivalent characters but watch out for the bad
- * unprintable ones (printable chars are 0x20 through 0x7E)
- */
- if (!display_data_only) {
- acpi_os_printf(" ");
- for (j = 0; j < 16; j++) {
- if (i + j >= count) {
- acpi_os_printf("\n");
- return;
- }
- /*
- * Add comment characters so rest of line is ignored when
- * compiled
- */
- if (j == 0) {
- acpi_os_printf("// ");
- }
- buf_char = buffer[(acpi_size)i + j];
- if (isprint(buf_char)) {
- acpi_os_printf("%c", buf_char);
- } else {
- acpi_os_printf(".");
- }
- }
- /* Done with that line. */
- acpi_os_printf("\n");
- }
- i += 16;
- }
- return;
- }
- /*******************************************************************************
- *
- * FUNCTION: acpi_ut_debug_dump_buffer
- *
- * PARAMETERS: buffer - Buffer to dump
- * count - Amount to dump, in bytes
- * display - BYTE, WORD, DWORD, or QWORD display:
- * DB_BYTE_DISPLAY
- * DB_WORD_DISPLAY
- * DB_DWORD_DISPLAY
- * DB_QWORD_DISPLAY
- * component_ID - Caller's component ID
- *
- * RETURN: None
- *
- * DESCRIPTION: Generic dump buffer in both hex and ascii.
- *
- ******************************************************************************/
- void
- acpi_ut_debug_dump_buffer(u8 *buffer, u32 count, u32 display, u32 component_id)
- {
- /* Only dump the buffer if tracing is enabled */
- if (!((ACPI_LV_TABLES & acpi_dbg_level) &&
- (component_id & acpi_dbg_layer))) {
- return;
- }
- acpi_ut_dump_buffer(buffer, count, display, 0);
- }
- #ifdef ACPI_APPLICATION
- /*******************************************************************************
- *
- * FUNCTION: acpi_ut_dump_buffer_to_file
- *
- * PARAMETERS: file - File descriptor
- * buffer - Buffer to dump
- * count - Amount to dump, in bytes
- * display - BYTE, WORD, DWORD, or QWORD display:
- * DB_BYTE_DISPLAY
- * DB_WORD_DISPLAY
- * DB_DWORD_DISPLAY
- * DB_QWORD_DISPLAY
- * base_offset - Beginning buffer offset (display only)
- *
- * RETURN: None
- *
- * DESCRIPTION: Generic dump buffer in both hex and ascii to a file.
- *
- ******************************************************************************/
- void
- acpi_ut_dump_buffer_to_file(ACPI_FILE file,
- u8 *buffer, u32 count, u32 display, u32 base_offset)
- {
- u32 i = 0;
- u32 j;
- u32 temp32;
- u8 buf_char;
- if (!buffer) {
- fprintf(file, "Null Buffer Pointer in DumpBuffer!\n");
- return;
- }
- if ((count < 4) || (count & 0x01)) {
- display = DB_BYTE_DISPLAY;
- }
- /* Nasty little dump buffer routine! */
- while (i < count) {
- /* Print current offset */
- fprintf(file, "%8.4X: ", (base_offset + i));
- /* Print 16 hex chars */
- for (j = 0; j < 16;) {
- if (i + j >= count) {
- /* Dump fill spaces */
- fprintf(file, "%*s", ((display * 2) + 1), " ");
- j += display;
- continue;
- }
- switch (display) {
- case DB_BYTE_DISPLAY:
- default: /* Default is BYTE display */
- fprintf(file, "%02X ",
- buffer[(acpi_size)i + j]);
- break;
- case DB_WORD_DISPLAY:
- ACPI_MOVE_16_TO_32(&temp32,
- &buffer[(acpi_size)i + j]);
- fprintf(file, "%04X ", temp32);
- break;
- case DB_DWORD_DISPLAY:
- ACPI_MOVE_32_TO_32(&temp32,
- &buffer[(acpi_size)i + j]);
- fprintf(file, "%08X ", temp32);
- break;
- case DB_QWORD_DISPLAY:
- ACPI_MOVE_32_TO_32(&temp32,
- &buffer[(acpi_size)i + j]);
- fprintf(file, "%08X", temp32);
- ACPI_MOVE_32_TO_32(&temp32,
- &buffer[(acpi_size)i + j +
- 4]);
- fprintf(file, "%08X ", temp32);
- break;
- }
- j += display;
- }
- /*
- * Print the ASCII equivalent characters but watch out for the bad
- * unprintable ones (printable chars are 0x20 through 0x7E)
- */
- fprintf(file, " ");
- for (j = 0; j < 16; j++) {
- if (i + j >= count) {
- fprintf(file, "\n");
- return;
- }
- buf_char = buffer[(acpi_size)i + j];
- if (isprint(buf_char)) {
- fprintf(file, "%c", buf_char);
- } else {
- fprintf(file, ".");
- }
- }
- /* Done with that line. */
- fprintf(file, "\n");
- i += 16;
- }
- return;
- }
- #endif
|