2013-06-08 00:57:47 +00:00
/******************************************************************************
*
* Module Name : utbuffer - Buffer dump routines
*
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
/*
2017-02-08 11:00:08 +08:00
* Copyright ( C ) 2000 - 2017 , Intel Corp .
2013-06-08 00:57:47 +00:00
* All rights reserved .
*
* Redistribution and use in source and binary forms , with or without
* modification , are permitted provided that the following conditions
* are met :
* 1. Redistributions of source code must retain the above copyright
* notice , this list of conditions , and the following disclaimer ,
* without modification .
* 2. Redistributions in binary form must reproduce at minimum a disclaimer
* substantially similar to the " NO WARRANTY " disclaimer below
* ( " Disclaimer " ) and any redistribution must be conditioned upon
* including a substantially similar Disclaimer requirement for further
* binary redistribution .
* 3. Neither the names of the above - listed copyright holders nor the names
* of any contributors may be used to endorse or promote products derived
* from this software without specific prior written permission .
*
* Alternatively , this software may be distributed under the terms of the
* GNU General Public License ( " GPL " ) version 2 as published by the Free
* Software Foundation .
*
* NO WARRANTY
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
* " AS IS " AND ANY EXPRESS OR IMPLIED WARRANTIES , INCLUDING , BUT NOT
* LIMITED TO , THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR
* A PARTICULAR PURPOSE ARE DISCLAIMED . IN NO EVENT SHALL THE COPYRIGHT
* HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL , EXEMPLARY , OR CONSEQUENTIAL
* DAMAGES ( INCLUDING , BUT NOT LIMITED TO , PROCUREMENT OF SUBSTITUTE GOODS
* OR SERVICES ; LOSS OF USE , DATA , OR PROFITS ; OR BUSINESS INTERRUPTION )
* HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY , WHETHER IN CONTRACT ,
* STRICT LIABILITY , OR TORT ( INCLUDING NEGLIGENCE OR OTHERWISE ) ARISING
* IN ANY WAY OUT OF THE USE OF THIS SOFTWARE , EVEN IF ADVISED OF THE
* POSSIBILITY OF SUCH DAMAGES .
*/
# 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 ;
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 */
acpi_os_printf ( " %6.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 " ,
2016-05-05 12:57:53 +08:00
buffer [ ( acpi_size ) i + j ] ) ;
2013-06-08 00:57:47 +00:00
break ;
case DB_WORD_DISPLAY :
ACPI_MOVE_16_TO_32 ( & temp32 ,
2016-05-05 12:57:53 +08:00
& buffer [ ( acpi_size ) i + j ] ) ;
2013-06-08 00:57:47 +00:00
acpi_os_printf ( " %04X " , temp32 ) ;
break ;
case DB_DWORD_DISPLAY :
ACPI_MOVE_32_TO_32 ( & temp32 ,
2016-05-05 12:57:53 +08:00
& buffer [ ( acpi_size ) i + j ] ) ;
2013-06-08 00:57:47 +00:00
acpi_os_printf ( " %08X " , temp32 ) ;
break ;
case DB_QWORD_DISPLAY :
ACPI_MOVE_32_TO_32 ( & temp32 ,
2016-05-05 12:57:53 +08:00
& buffer [ ( acpi_size ) i + j ] ) ;
2013-06-08 00:57:47 +00:00
acpi_os_printf ( " %08X " , temp32 ) ;
ACPI_MOVE_32_TO_32 ( & temp32 ,
2016-05-05 12:57:53 +08:00
& buffer [ ( acpi_size ) i + j +
2013-06-08 00:57:47 +00:00
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 )
*/
acpi_os_printf ( " " ) ;
for ( j = 0 ; j < 16 ; j + + ) {
if ( i + j > = count ) {
acpi_os_printf ( " \n " ) ;
return ;
}
2015-04-13 11:50:56 +08:00
/*
* Add comment characters so rest of line is ignored when
* compiled
*/
if ( j = = 0 ) {
acpi_os_printf ( " // " ) ;
}
2016-05-05 12:57:53 +08:00
buf_char = buffer [ ( acpi_size ) i + j ] ;
2015-07-01 14:45:11 +08:00
if ( isprint ( buf_char ) ) {
2013-06-08 00:57:47 +00:00
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 ) ;
}
2014-07-08 10:07:52 +08:00
# 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 ) {
2016-08-04 16:45:06 +08:00
fprintf ( file , " Null Buffer Pointer in DumpBuffer! \n " ) ;
2014-07-08 10:07:52 +08:00
return ;
}
if ( ( count < 4 ) | | ( count & 0x01 ) ) {
display = DB_BYTE_DISPLAY ;
}
/* Nasty little dump buffer routine! */
while ( i < count ) {
/* Print current offset */
2016-08-04 16:45:06 +08:00
fprintf ( file , " %6.4X: " , ( base_offset + i ) ) ;
2014-07-08 10:07:52 +08:00
/* Print 16 hex chars */
for ( j = 0 ; j < 16 ; ) {
if ( i + j > = count ) {
/* Dump fill spaces */
2016-08-04 16:45:06 +08:00
fprintf ( file , " %*s " , ( ( display * 2 ) + 1 ) , " " ) ;
2014-07-08 10:07:52 +08:00
j + = display ;
continue ;
}
switch ( display ) {
case DB_BYTE_DISPLAY :
default : /* Default is BYTE display */
2016-08-04 16:45:06 +08:00
fprintf ( file , " %02X " ,
buffer [ ( acpi_size ) i + j ] ) ;
2014-07-08 10:07:52 +08:00
break ;
case DB_WORD_DISPLAY :
ACPI_MOVE_16_TO_32 ( & temp32 ,
2016-05-05 12:57:53 +08:00
& buffer [ ( acpi_size ) i + j ] ) ;
2016-08-04 16:45:06 +08:00
fprintf ( file , " %04X " , temp32 ) ;
2014-07-08 10:07:52 +08:00
break ;
case DB_DWORD_DISPLAY :
ACPI_MOVE_32_TO_32 ( & temp32 ,
2016-05-05 12:57:53 +08:00
& buffer [ ( acpi_size ) i + j ] ) ;
2016-08-04 16:45:06 +08:00
fprintf ( file , " %08X " , temp32 ) ;
2014-07-08 10:07:52 +08:00
break ;
case DB_QWORD_DISPLAY :
ACPI_MOVE_32_TO_32 ( & temp32 ,
2016-05-05 12:57:53 +08:00
& buffer [ ( acpi_size ) i + j ] ) ;
2016-08-04 16:45:06 +08:00
fprintf ( file , " %08X " , temp32 ) ;
2014-07-08 10:07:52 +08:00
ACPI_MOVE_32_TO_32 ( & temp32 ,
2016-05-05 12:57:53 +08:00
& buffer [ ( acpi_size ) i + j +
2014-07-08 10:07:52 +08:00
4 ] ) ;
2016-08-04 16:45:06 +08:00
fprintf ( file , " %08X " , temp32 ) ;
2014-07-08 10:07:52 +08:00
break ;
}
j + = display ;
}
/*
* Print the ASCII equivalent characters but watch out for the bad
* unprintable ones ( printable chars are 0x20 through 0x7E )
*/
2016-08-04 16:45:06 +08:00
fprintf ( file , " " ) ;
2014-07-08 10:07:52 +08:00
for ( j = 0 ; j < 16 ; j + + ) {
if ( i + j > = count ) {
2016-08-04 16:45:06 +08:00
fprintf ( file , " \n " ) ;
2014-07-08 10:07:52 +08:00
return ;
}
2016-05-05 12:57:53 +08:00
buf_char = buffer [ ( acpi_size ) i + j ] ;
2015-07-01 14:45:11 +08:00
if ( isprint ( buf_char ) ) {
2016-08-04 16:45:06 +08:00
fprintf ( file , " %c " , buf_char ) ;
2014-07-08 10:07:52 +08:00
} else {
2016-08-04 16:45:06 +08:00
fprintf ( file , " . " ) ;
2014-07-08 10:07:52 +08:00
}
}
/* Done with that line. */
2016-08-04 16:45:06 +08:00
fprintf ( file , " \n " ) ;
2014-07-08 10:07:52 +08:00
i + = 16 ;
}
return ;
}
# endif
