asldebug.c revision 1.1.1.1.2.4
1 1.1.1.1.2.2 skrll /****************************************************************************** 2 1.1.1.1.2.2 skrll * 3 1.1.1.1.2.2 skrll * Module Name: asldebug -- Debug output support 4 1.1.1.1.2.2 skrll * 5 1.1.1.1.2.2 skrll *****************************************************************************/ 6 1.1.1.1.2.2 skrll 7 1.1.1.1.2.2 skrll /* 8 1.1.1.1.2.3 skrll * Copyright (C) 2000 - 2017, Intel Corp. 9 1.1.1.1.2.2 skrll * All rights reserved. 10 1.1.1.1.2.2 skrll * 11 1.1.1.1.2.2 skrll * Redistribution and use in source and binary forms, with or without 12 1.1.1.1.2.2 skrll * modification, are permitted provided that the following conditions 13 1.1.1.1.2.2 skrll * are met: 14 1.1.1.1.2.2 skrll * 1. Redistributions of source code must retain the above copyright 15 1.1.1.1.2.2 skrll * notice, this list of conditions, and the following disclaimer, 16 1.1.1.1.2.2 skrll * without modification. 17 1.1.1.1.2.2 skrll * 2. Redistributions in binary form must reproduce at minimum a disclaimer 18 1.1.1.1.2.2 skrll * substantially similar to the "NO WARRANTY" disclaimer below 19 1.1.1.1.2.2 skrll * ("Disclaimer") and any redistribution must be conditioned upon 20 1.1.1.1.2.2 skrll * including a substantially similar Disclaimer requirement for further 21 1.1.1.1.2.2 skrll * binary redistribution. 22 1.1.1.1.2.2 skrll * 3. Neither the names of the above-listed copyright holders nor the names 23 1.1.1.1.2.2 skrll * of any contributors may be used to endorse or promote products derived 24 1.1.1.1.2.2 skrll * from this software without specific prior written permission. 25 1.1.1.1.2.2 skrll * 26 1.1.1.1.2.2 skrll * Alternatively, this software may be distributed under the terms of the 27 1.1.1.1.2.2 skrll * GNU General Public License ("GPL") version 2 as published by the Free 28 1.1.1.1.2.2 skrll * Software Foundation. 29 1.1.1.1.2.2 skrll * 30 1.1.1.1.2.2 skrll * NO WARRANTY 31 1.1.1.1.2.2 skrll * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 32 1.1.1.1.2.2 skrll * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 33 1.1.1.1.2.2 skrll * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR 34 1.1.1.1.2.2 skrll * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT 35 1.1.1.1.2.2 skrll * HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 36 1.1.1.1.2.2 skrll * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 37 1.1.1.1.2.2 skrll * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 38 1.1.1.1.2.2 skrll * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, 39 1.1.1.1.2.2 skrll * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING 40 1.1.1.1.2.2 skrll * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 41 1.1.1.1.2.2 skrll * POSSIBILITY OF SUCH DAMAGES. 42 1.1.1.1.2.2 skrll */ 43 1.1.1.1.2.2 skrll 44 1.1.1.1.2.2 skrll #include "aslcompiler.h" 45 1.1.1.1.2.2 skrll #include "aslcompiler.y.h" 46 1.1.1.1.2.2 skrll 47 1.1.1.1.2.2 skrll 48 1.1.1.1.2.2 skrll #define _COMPONENT ACPI_COMPILER 49 1.1.1.1.2.2 skrll ACPI_MODULE_NAME ("asldebug") 50 1.1.1.1.2.2 skrll 51 1.1.1.1.2.2 skrll 52 1.1.1.1.2.2 skrll /* Local prototypes */ 53 1.1.1.1.2.2 skrll 54 1.1.1.1.2.2 skrll static void 55 1.1.1.1.2.2 skrll UtDumpParseOpName ( 56 1.1.1.1.2.2 skrll ACPI_PARSE_OBJECT *Op, 57 1.1.1.1.2.2 skrll UINT32 Level, 58 1.1.1.1.2.2 skrll UINT32 DataLength); 59 1.1.1.1.2.2 skrll 60 1.1.1.1.2.2 skrll 61 1.1.1.1.2.2 skrll /******************************************************************************* 62 1.1.1.1.2.2 skrll * 63 1.1.1.1.2.4 skrll * FUNCTION: CvDbgPrint 64 1.1.1.1.2.4 skrll * 65 1.1.1.1.2.4 skrll * PARAMETERS: Type - Type of output 66 1.1.1.1.2.4 skrll * Fmt - Printf format string 67 1.1.1.1.2.4 skrll * ... - variable printf list 68 1.1.1.1.2.4 skrll * 69 1.1.1.1.2.4 skrll * RETURN: None 70 1.1.1.1.2.4 skrll * 71 1.1.1.1.2.4 skrll * DESCRIPTION: Print statement for debug messages within the converter. 72 1.1.1.1.2.4 skrll * 73 1.1.1.1.2.4 skrll ******************************************************************************/ 74 1.1.1.1.2.4 skrll 75 1.1.1.1.2.4 skrll void 76 1.1.1.1.2.4 skrll CvDbgPrint ( 77 1.1.1.1.2.4 skrll char *Fmt, 78 1.1.1.1.2.4 skrll ...) 79 1.1.1.1.2.4 skrll { 80 1.1.1.1.2.4 skrll va_list Args; 81 1.1.1.1.2.4 skrll 82 1.1.1.1.2.4 skrll 83 1.1.1.1.2.4 skrll if (!Gbl_CaptureComments || !AcpiGbl_DebugAslConversion) 84 1.1.1.1.2.4 skrll { 85 1.1.1.1.2.4 skrll return; 86 1.1.1.1.2.4 skrll } 87 1.1.1.1.2.4 skrll 88 1.1.1.1.2.4 skrll va_start (Args, Fmt); 89 1.1.1.1.2.4 skrll (void) vfprintf (AcpiGbl_ConvDebugFile, Fmt, Args); 90 1.1.1.1.2.4 skrll va_end (Args); 91 1.1.1.1.2.4 skrll return; 92 1.1.1.1.2.4 skrll } 93 1.1.1.1.2.4 skrll 94 1.1.1.1.2.4 skrll 95 1.1.1.1.2.4 skrll /******************************************************************************* 96 1.1.1.1.2.4 skrll * 97 1.1.1.1.2.2 skrll * FUNCTION: UtDumpIntegerOp 98 1.1.1.1.2.2 skrll * 99 1.1.1.1.2.2 skrll * PARAMETERS: Op - Current parse op 100 1.1.1.1.2.2 skrll * Level - Current output indentation level 101 1.1.1.1.2.2 skrll * IntegerLength - Output length of the integer (2/4/8/16) 102 1.1.1.1.2.2 skrll * 103 1.1.1.1.2.2 skrll * RETURN: None 104 1.1.1.1.2.2 skrll * 105 1.1.1.1.2.2 skrll * DESCRIPTION: Emit formatted debug output for "integer" ops. 106 1.1.1.1.2.2 skrll * Note: IntegerLength must be one of 2,4,8,16. 107 1.1.1.1.2.2 skrll * 108 1.1.1.1.2.2 skrll ******************************************************************************/ 109 1.1.1.1.2.2 skrll 110 1.1.1.1.2.2 skrll void 111 1.1.1.1.2.2 skrll UtDumpIntegerOp ( 112 1.1.1.1.2.2 skrll ACPI_PARSE_OBJECT *Op, 113 1.1.1.1.2.2 skrll UINT32 Level, 114 1.1.1.1.2.2 skrll UINT32 IntegerLength) 115 1.1.1.1.2.2 skrll { 116 1.1.1.1.2.2 skrll 117 1.1.1.1.2.2 skrll /* Emit the ParseOp name, leaving room for the integer */ 118 1.1.1.1.2.2 skrll 119 1.1.1.1.2.2 skrll UtDumpParseOpName (Op, Level, IntegerLength); 120 1.1.1.1.2.2 skrll 121 1.1.1.1.2.2 skrll /* Emit the integer based upon length */ 122 1.1.1.1.2.2 skrll 123 1.1.1.1.2.2 skrll switch (IntegerLength) 124 1.1.1.1.2.2 skrll { 125 1.1.1.1.2.2 skrll case 2: /* Byte */ 126 1.1.1.1.2.2 skrll case 4: /* Word */ 127 1.1.1.1.2.2 skrll case 8: /* Dword */ 128 1.1.1.1.2.2 skrll 129 1.1.1.1.2.2 skrll DbgPrint (ASL_TREE_OUTPUT, 130 1.1.1.1.2.2 skrll "%*.*X", IntegerLength, IntegerLength, Op->Asl.Value.Integer); 131 1.1.1.1.2.2 skrll break; 132 1.1.1.1.2.2 skrll 133 1.1.1.1.2.2 skrll case 16: /* Qword and Integer */ 134 1.1.1.1.2.2 skrll 135 1.1.1.1.2.2 skrll DbgPrint (ASL_TREE_OUTPUT, 136 1.1.1.1.2.2 skrll "%8.8X%8.8X", ACPI_FORMAT_UINT64 (Op->Asl.Value.Integer)); 137 1.1.1.1.2.2 skrll break; 138 1.1.1.1.2.2 skrll 139 1.1.1.1.2.2 skrll default: 140 1.1.1.1.2.2 skrll break; 141 1.1.1.1.2.2 skrll } 142 1.1.1.1.2.2 skrll } 143 1.1.1.1.2.2 skrll 144 1.1.1.1.2.2 skrll 145 1.1.1.1.2.2 skrll /******************************************************************************* 146 1.1.1.1.2.2 skrll * 147 1.1.1.1.2.2 skrll * FUNCTION: UtDumpStringOp 148 1.1.1.1.2.2 skrll * 149 1.1.1.1.2.2 skrll * PARAMETERS: Op - Current parse op 150 1.1.1.1.2.2 skrll * Level - Current output indentation level 151 1.1.1.1.2.2 skrll * 152 1.1.1.1.2.2 skrll * RETURN: None 153 1.1.1.1.2.2 skrll * 154 1.1.1.1.2.2 skrll * DESCRIPTION: Emit formatted debug output for String/Pathname ops. 155 1.1.1.1.2.2 skrll * 156 1.1.1.1.2.2 skrll ******************************************************************************/ 157 1.1.1.1.2.2 skrll 158 1.1.1.1.2.2 skrll void 159 1.1.1.1.2.2 skrll UtDumpStringOp ( 160 1.1.1.1.2.2 skrll ACPI_PARSE_OBJECT *Op, 161 1.1.1.1.2.2 skrll UINT32 Level) 162 1.1.1.1.2.2 skrll { 163 1.1.1.1.2.2 skrll char *String; 164 1.1.1.1.2.2 skrll 165 1.1.1.1.2.2 skrll 166 1.1.1.1.2.2 skrll String = Op->Asl.Value.String; 167 1.1.1.1.2.2 skrll 168 1.1.1.1.2.2 skrll if (Op->Asl.ParseOpcode != PARSEOP_STRING_LITERAL) 169 1.1.1.1.2.2 skrll { 170 1.1.1.1.2.2 skrll /* 171 1.1.1.1.2.2 skrll * For the "path" ops NAMEPATH, NAMESEG, METHODCALL -- if the 172 1.1.1.1.2.2 skrll * ExternalName is valid, it takes precedence. In these cases the 173 1.1.1.1.2.2 skrll * Value.String is the raw "internal" name from the AML code, which 174 1.1.1.1.2.2 skrll * we don't want to use, because it contains non-ascii characters. 175 1.1.1.1.2.2 skrll */ 176 1.1.1.1.2.2 skrll if (Op->Asl.ExternalName) 177 1.1.1.1.2.2 skrll { 178 1.1.1.1.2.2 skrll String = Op->Asl.ExternalName; 179 1.1.1.1.2.2 skrll } 180 1.1.1.1.2.2 skrll } 181 1.1.1.1.2.2 skrll 182 1.1.1.1.2.2 skrll if (!String) 183 1.1.1.1.2.2 skrll { 184 1.1.1.1.2.2 skrll DbgPrint (ASL_TREE_OUTPUT, 185 1.1.1.1.2.2 skrll " ERROR: Could not find a valid String/Path pointer\n"); 186 1.1.1.1.2.2 skrll return; 187 1.1.1.1.2.2 skrll } 188 1.1.1.1.2.2 skrll 189 1.1.1.1.2.2 skrll /* Emit the ParseOp name, leaving room for the string */ 190 1.1.1.1.2.2 skrll 191 1.1.1.1.2.2 skrll UtDumpParseOpName (Op, Level, strlen (String)); 192 1.1.1.1.2.2 skrll DbgPrint (ASL_TREE_OUTPUT, "%s", String); 193 1.1.1.1.2.2 skrll } 194 1.1.1.1.2.2 skrll 195 1.1.1.1.2.2 skrll 196 1.1.1.1.2.2 skrll /******************************************************************************* 197 1.1.1.1.2.2 skrll * 198 1.1.1.1.2.2 skrll * FUNCTION: UtDumpBasicOp 199 1.1.1.1.2.2 skrll * 200 1.1.1.1.2.2 skrll * PARAMETERS: Op - Current parse op 201 1.1.1.1.2.2 skrll * Level - Current output indentation level 202 1.1.1.1.2.2 skrll * 203 1.1.1.1.2.2 skrll * RETURN: None 204 1.1.1.1.2.2 skrll * 205 1.1.1.1.2.2 skrll * DESCRIPTION: Generic formatted debug output for "basic" ops that have no 206 1.1.1.1.2.2 skrll * associated strings or integer values. 207 1.1.1.1.2.2 skrll * 208 1.1.1.1.2.2 skrll ******************************************************************************/ 209 1.1.1.1.2.2 skrll 210 1.1.1.1.2.2 skrll void 211 1.1.1.1.2.2 skrll UtDumpBasicOp ( 212 1.1.1.1.2.2 skrll ACPI_PARSE_OBJECT *Op, 213 1.1.1.1.2.2 skrll UINT32 Level) 214 1.1.1.1.2.2 skrll { 215 1.1.1.1.2.2 skrll 216 1.1.1.1.2.2 skrll /* Just print out the ParseOp name, there is no extra data */ 217 1.1.1.1.2.2 skrll 218 1.1.1.1.2.2 skrll UtDumpParseOpName (Op, Level, 0); 219 1.1.1.1.2.2 skrll } 220 1.1.1.1.2.2 skrll 221 1.1.1.1.2.2 skrll 222 1.1.1.1.2.2 skrll /******************************************************************************* 223 1.1.1.1.2.2 skrll * 224 1.1.1.1.2.2 skrll * FUNCTION: UtDumpParseOpName 225 1.1.1.1.2.2 skrll * 226 1.1.1.1.2.2 skrll * PARAMETERS: Op - Current parse op 227 1.1.1.1.2.2 skrll * Level - Current output indentation level 228 1.1.1.1.2.2 skrll * DataLength - Length of data to appear after the name 229 1.1.1.1.2.2 skrll * 230 1.1.1.1.2.2 skrll * RETURN: None 231 1.1.1.1.2.2 skrll * 232 1.1.1.1.2.2 skrll * DESCRIPTION: Indent and emit the ascii ParseOp name for the op 233 1.1.1.1.2.2 skrll * 234 1.1.1.1.2.2 skrll ******************************************************************************/ 235 1.1.1.1.2.2 skrll 236 1.1.1.1.2.2 skrll static void 237 1.1.1.1.2.2 skrll UtDumpParseOpName ( 238 1.1.1.1.2.2 skrll ACPI_PARSE_OBJECT *Op, 239 1.1.1.1.2.2 skrll UINT32 Level, 240 1.1.1.1.2.2 skrll UINT32 DataLength) 241 1.1.1.1.2.2 skrll { 242 1.1.1.1.2.2 skrll char *ParseOpName; 243 1.1.1.1.2.2 skrll UINT32 IndentLength; 244 1.1.1.1.2.2 skrll UINT32 NameLength; 245 1.1.1.1.2.2 skrll UINT32 LineLength; 246 1.1.1.1.2.2 skrll UINT32 PaddingLength; 247 1.1.1.1.2.2 skrll 248 1.1.1.1.2.2 skrll 249 1.1.1.1.2.2 skrll /* Emit the LineNumber/IndentLevel prefix on each output line */ 250 1.1.1.1.2.2 skrll 251 1.1.1.1.2.2 skrll DbgPrint (ASL_TREE_OUTPUT, 252 1.1.1.1.2.2 skrll "%5.5d [%2d]", Op->Asl.LogicalLineNumber, Level); 253 1.1.1.1.2.2 skrll 254 1.1.1.1.2.2 skrll ParseOpName = UtGetOpName (Op->Asl.ParseOpcode); 255 1.1.1.1.2.2 skrll 256 1.1.1.1.2.2 skrll /* Calculate various lengths for output alignment */ 257 1.1.1.1.2.2 skrll 258 1.1.1.1.2.2 skrll IndentLength = Level * DEBUG_SPACES_PER_INDENT; 259 1.1.1.1.2.2 skrll NameLength = strlen (ParseOpName); 260 1.1.1.1.2.2 skrll LineLength = IndentLength + 1 + NameLength + 1 + DataLength; 261 1.1.1.1.2.2 skrll PaddingLength = (DEBUG_MAX_LINE_LENGTH + 1) - LineLength; 262 1.1.1.1.2.2 skrll 263 1.1.1.1.2.2 skrll /* Parse tree indentation is based upon the nesting/indent level */ 264 1.1.1.1.2.2 skrll 265 1.1.1.1.2.2 skrll if (Level) 266 1.1.1.1.2.2 skrll { 267 1.1.1.1.2.2 skrll DbgPrint (ASL_TREE_OUTPUT, "%*s", IndentLength, " "); 268 1.1.1.1.2.2 skrll } 269 1.1.1.1.2.2 skrll 270 1.1.1.1.2.2 skrll /* Emit the actual name here */ 271 1.1.1.1.2.2 skrll 272 1.1.1.1.2.2 skrll DbgPrint (ASL_TREE_OUTPUT, " %s", ParseOpName); 273 1.1.1.1.2.2 skrll 274 1.1.1.1.2.2 skrll /* Emit extra padding blanks for alignment of later data items */ 275 1.1.1.1.2.2 skrll 276 1.1.1.1.2.2 skrll if (LineLength > DEBUG_MAX_LINE_LENGTH) 277 1.1.1.1.2.2 skrll { 278 1.1.1.1.2.2 skrll /* Split a long line immediately after the ParseOpName string */ 279 1.1.1.1.2.2 skrll 280 1.1.1.1.2.2 skrll DbgPrint (ASL_TREE_OUTPUT, "\n%*s", 281 1.1.1.1.2.2 skrll (DEBUG_FULL_LINE_LENGTH - DataLength), " "); 282 1.1.1.1.2.2 skrll } 283 1.1.1.1.2.2 skrll else 284 1.1.1.1.2.2 skrll { 285 1.1.1.1.2.2 skrll DbgPrint (ASL_TREE_OUTPUT, "%*s", PaddingLength, " "); 286 1.1.1.1.2.2 skrll } 287 1.1.1.1.2.2 skrll } 288
Indexes created Mon Sep 29 03:10:08 GMT 2025