1 /******************************************************************************* 2 * 3 * Module Name: uterror - Various internal error/warning output functions 4 * 5 ******************************************************************************/ 6 7 /* 8 * Copyright (C) 2000 - 2017, Intel Corp. 9 * All rights reserved. 10 * 11 * Redistribution and use in source and binary forms, with or without 12 * modification, are permitted provided that the following conditions 13 * are met: 14 * 1. Redistributions of source code must retain the above copyright 15 * notice, this list of conditions, and the following disclaimer, 16 * without modification. 17 * 2. Redistributions in binary form must reproduce at minimum a disclaimer 18 * substantially similar to the "NO WARRANTY" disclaimer below 19 * ("Disclaimer") and any redistribution must be conditioned upon 20 * including a substantially similar Disclaimer requirement for further 21 * binary redistribution. 22 * 3. Neither the names of the above-listed copyright holders nor the names 23 * of any contributors may be used to endorse or promote products derived 24 * from this software without specific prior written permission. 25 * 26 * Alternatively, this software may be distributed under the terms of the 27 * GNU General Public License ("GPL") version 2 as published by the Free 28 * Software Foundation. 29 * 30 * NO WARRANTY 31 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 32 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 33 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR 34 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT 35 * HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 36 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 37 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 38 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, 39 * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING 40 * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 41 * POSSIBILITY OF SUCH DAMAGES. 42 */ 43 44 #include <contrib/dev/acpica/include/acpi.h> 45 #include <contrib/dev/acpica/include/accommon.h> 46 #include <contrib/dev/acpica/include/acnamesp.h> 47 48 49 #define _COMPONENT ACPI_UTILITIES 50 ACPI_MODULE_NAME ("uterror") 51 52 53 /* 54 * This module contains internal error functions that may 55 * be configured out. 56 */ 57 #if !defined (ACPI_NO_ERROR_MESSAGES) 58 59 /******************************************************************************* 60 * 61 * FUNCTION: AcpiUtPredefinedWarning 62 * 63 * PARAMETERS: ModuleName - Caller's module name (for error output) 64 * LineNumber - Caller's line number (for error output) 65 * Pathname - Full pathname to the node 66 * NodeFlags - From Namespace node for the method/object 67 * Format - Printf format string + additional args 68 * 69 * RETURN: None 70 * 71 * DESCRIPTION: Warnings for the predefined validation module. Messages are 72 * only emitted the first time a problem with a particular 73 * method/object is detected. This prevents a flood of error 74 * messages for methods that are repeatedly evaluated. 75 * 76 ******************************************************************************/ 77 78 void ACPI_INTERNAL_VAR_XFACE 79 AcpiUtPredefinedWarning ( 80 const char *ModuleName, 81 UINT32 LineNumber, 82 char *Pathname, 83 UINT8 NodeFlags, 84 const char *Format, 85 ...) 86 { 87 va_list ArgList; 88 89 90 /* 91 * Warning messages for this method/object will be disabled after the 92 * first time a validation fails or an object is successfully repaired. 93 */ 94 if (NodeFlags & ANOBJ_EVALUATED) 95 { 96 return; 97 } 98 99 AcpiOsPrintf (ACPI_MSG_WARNING "%s: ", Pathname); 100 101 va_start (ArgList, Format); 102 AcpiOsVprintf (Format, ArgList); 103 ACPI_MSG_SUFFIX; 104 va_end (ArgList); 105 } 106 107 108 /******************************************************************************* 109 * 110 * FUNCTION: AcpiUtPredefinedInfo 111 * 112 * PARAMETERS: ModuleName - Caller's module name (for error output) 113 * LineNumber - Caller's line number (for error output) 114 * Pathname - Full pathname to the node 115 * NodeFlags - From Namespace node for the method/object 116 * Format - Printf format string + additional args 117 * 118 * RETURN: None 119 * 120 * DESCRIPTION: Info messages for the predefined validation module. Messages 121 * are only emitted the first time a problem with a particular 122 * method/object is detected. This prevents a flood of 123 * messages for methods that are repeatedly evaluated. 124 * 125 ******************************************************************************/ 126 127 void ACPI_INTERNAL_VAR_XFACE 128 AcpiUtPredefinedInfo ( 129 const char *ModuleName, 130 UINT32 LineNumber, 131 char *Pathname, 132 UINT8 NodeFlags, 133 const char *Format, 134 ...) 135 { 136 va_list ArgList; 137 138 139 /* 140 * Warning messages for this method/object will be disabled after the 141 * first time a validation fails or an object is successfully repaired. 142 */ 143 if (NodeFlags & ANOBJ_EVALUATED) 144 { 145 return; 146 } 147 148 AcpiOsPrintf (ACPI_MSG_INFO "%s: ", Pathname); 149 150 va_start (ArgList, Format); 151 AcpiOsVprintf (Format, ArgList); 152 ACPI_MSG_SUFFIX; 153 va_end (ArgList); 154 } 155 156 157 /******************************************************************************* 158 * 159 * FUNCTION: AcpiUtPredefinedBiosError 160 * 161 * PARAMETERS: ModuleName - Caller's module name (for error output) 162 * LineNumber - Caller's line number (for error output) 163 * Pathname - Full pathname to the node 164 * NodeFlags - From Namespace node for the method/object 165 * Format - Printf format string + additional args 166 * 167 * RETURN: None 168 * 169 * DESCRIPTION: BIOS error message for predefined names. Messages 170 * are only emitted the first time a problem with a particular 171 * method/object is detected. This prevents a flood of 172 * messages for methods that are repeatedly evaluated. 173 * 174 ******************************************************************************/ 175 176 void ACPI_INTERNAL_VAR_XFACE 177 AcpiUtPredefinedBiosError ( 178 const char *ModuleName, 179 UINT32 LineNumber, 180 char *Pathname, 181 UINT8 NodeFlags, 182 const char *Format, 183 ...) 184 { 185 va_list ArgList; 186 187 188 /* 189 * Warning messages for this method/object will be disabled after the 190 * first time a validation fails or an object is successfully repaired. 191 */ 192 if (NodeFlags & ANOBJ_EVALUATED) 193 { 194 return; 195 } 196 197 AcpiOsPrintf (ACPI_MSG_BIOS_ERROR "%s: ", Pathname); 198 199 va_start (ArgList, Format); 200 AcpiOsVprintf (Format, ArgList); 201 ACPI_MSG_SUFFIX; 202 va_end (ArgList); 203 } 204 205 206 /******************************************************************************* 207 * 208 * FUNCTION: AcpiUtNamespaceError 209 * 210 * PARAMETERS: ModuleName - Caller's module name (for error output) 211 * LineNumber - Caller's line number (for error output) 212 * InternalName - Name or path of the namespace node 213 * LookupStatus - Exception code from NS lookup 214 * 215 * RETURN: None 216 * 217 * DESCRIPTION: Print error message with the full pathname for the NS node. 218 * 219 ******************************************************************************/ 220 221 void 222 AcpiUtNamespaceError ( 223 const char *ModuleName, 224 UINT32 LineNumber, 225 const char *InternalName, 226 ACPI_STATUS LookupStatus) 227 { 228 ACPI_STATUS Status; 229 UINT32 BadName; 230 char *Name = NULL; 231 232 233 ACPI_MSG_REDIRECT_BEGIN; 234 AcpiOsPrintf (ACPI_MSG_ERROR); 235 236 if (LookupStatus == AE_BAD_CHARACTER) 237 { 238 /* There is a non-ascii character in the name */ 239 240 ACPI_MOVE_32_TO_32 (&BadName, ACPI_CAST_PTR (UINT32, InternalName)); 241 AcpiOsPrintf ("[0x%.8X] (NON-ASCII)", BadName); 242 } 243 else 244 { 245 /* Convert path to external format */ 246 247 Status = AcpiNsExternalizeName ( 248 ACPI_UINT32_MAX, InternalName, NULL, &Name); 249 250 /* Print target name */ 251 252 if (ACPI_SUCCESS (Status)) 253 { 254 AcpiOsPrintf ("[%s]", Name); 255 } 256 else 257 { 258 AcpiOsPrintf ("[COULD NOT EXTERNALIZE NAME]"); 259 } 260 261 if (Name) 262 { 263 ACPI_FREE (Name); 264 } 265 } 266 267 AcpiOsPrintf (" Namespace lookup failure, %s", 268 AcpiFormatException (LookupStatus)); 269 270 ACPI_MSG_SUFFIX; 271 ACPI_MSG_REDIRECT_END; 272 } 273 274 275 /******************************************************************************* 276 * 277 * FUNCTION: AcpiUtMethodError 278 * 279 * PARAMETERS: ModuleName - Caller's module name (for error output) 280 * LineNumber - Caller's line number (for error output) 281 * Message - Error message to use on failure 282 * PrefixNode - Prefix relative to the path 283 * Path - Path to the node (optional) 284 * MethodStatus - Execution status 285 * 286 * RETURN: None 287 * 288 * DESCRIPTION: Print error message with the full pathname for the method. 289 * 290 ******************************************************************************/ 291 292 void 293 AcpiUtMethodError ( 294 const char *ModuleName, 295 UINT32 LineNumber, 296 const char *Message, 297 ACPI_NAMESPACE_NODE *PrefixNode, 298 const char *Path, 299 ACPI_STATUS MethodStatus) 300 { 301 ACPI_STATUS Status; 302 ACPI_NAMESPACE_NODE *Node = PrefixNode; 303 304 305 ACPI_MSG_REDIRECT_BEGIN; 306 AcpiOsPrintf (ACPI_MSG_ERROR); 307 308 if (Path) 309 { 310 Status = AcpiNsGetNode (PrefixNode, Path, 311 ACPI_NS_NO_UPSEARCH, &Node); 312 if (ACPI_FAILURE (Status)) 313 { 314 AcpiOsPrintf ("[Could not get node by pathname]"); 315 } 316 } 317 318 AcpiNsPrintNodePathname (Node, Message); 319 AcpiOsPrintf (", %s", AcpiFormatException (MethodStatus)); 320 321 ACPI_MSG_SUFFIX; 322 ACPI_MSG_REDIRECT_END; 323 } 324 325 #endif /* ACPI_NO_ERROR_MESSAGES */ 326