1 /******************************************************************************* 2 * 3 * Module Name: utxferror - Various error/warning output functions 4 * 5 ******************************************************************************/ 6 7 /* 8 * Copyright (C) 2000 - 2016, 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 #define EXPORT_ACPI_INTERFACES 45 46 #include "acpi.h" 47 #include "accommon.h" 48 49 50 #define _COMPONENT ACPI_UTILITIES 51 ACPI_MODULE_NAME ("utxferror") 52 53 /* 54 * This module is used for the in-kernel ACPICA as well as the ACPICA 55 * tools/applications. 56 */ 57 58 #ifndef ACPI_NO_ERROR_MESSAGES /* Entire module */ 59 60 /******************************************************************************* 61 * 62 * FUNCTION: AcpiError 63 * 64 * PARAMETERS: ModuleName - Caller's module name (for error output) 65 * LineNumber - Caller's line number (for error output) 66 * Format - Printf format string + additional args 67 * 68 * RETURN: None 69 * 70 * DESCRIPTION: Print "ACPI Error" message with module/line/version info 71 * 72 ******************************************************************************/ 73 74 void ACPI_INTERNAL_VAR_XFACE 75 AcpiError ( 76 const char *ModuleName, 77 UINT32 LineNumber, 78 const char *Format, 79 ...) 80 { 81 va_list ArgList; 82 83 84 ACPI_MSG_REDIRECT_BEGIN; 85 AcpiOsPrintf (ACPI_MSG_ERROR); 86 87 va_start (ArgList, Format); 88 AcpiOsVprintf (Format, ArgList); 89 ACPI_MSG_SUFFIX; 90 va_end (ArgList); 91 92 ACPI_MSG_REDIRECT_END; 93 } 94 95 ACPI_EXPORT_SYMBOL (AcpiError) 96 97 98 /******************************************************************************* 99 * 100 * FUNCTION: AcpiException 101 * 102 * PARAMETERS: ModuleName - Caller's module name (for error output) 103 * LineNumber - Caller's line number (for error output) 104 * Status - Status to be formatted 105 * Format - Printf format string + additional args 106 * 107 * RETURN: None 108 * 109 * DESCRIPTION: Print "ACPI Exception" message with module/line/version info 110 * and decoded ACPI_STATUS. 111 * 112 ******************************************************************************/ 113 114 void ACPI_INTERNAL_VAR_XFACE 115 AcpiException ( 116 const char *ModuleName, 117 UINT32 LineNumber, 118 ACPI_STATUS Status, 119 const char *Format, 120 ...) 121 { 122 va_list ArgList; 123 124 125 ACPI_MSG_REDIRECT_BEGIN; 126 127 /* For AE_OK, just print the message */ 128 129 if (ACPI_SUCCESS (Status)) 130 { 131 AcpiOsPrintf (ACPI_MSG_EXCEPTION); 132 133 } 134 else 135 { 136 AcpiOsPrintf (ACPI_MSG_EXCEPTION "%s, ", 137 AcpiFormatException (Status)); 138 } 139 140 va_start (ArgList, Format); 141 AcpiOsVprintf (Format, ArgList); 142 ACPI_MSG_SUFFIX; 143 va_end (ArgList); 144 145 ACPI_MSG_REDIRECT_END; 146 } 147 148 ACPI_EXPORT_SYMBOL (AcpiException) 149 150 151 /******************************************************************************* 152 * 153 * FUNCTION: AcpiWarning 154 * 155 * PARAMETERS: ModuleName - Caller's module name (for error output) 156 * LineNumber - Caller's line number (for error output) 157 * Format - Printf format string + additional args 158 * 159 * RETURN: None 160 * 161 * DESCRIPTION: Print "ACPI Warning" message with module/line/version info 162 * 163 ******************************************************************************/ 164 165 void ACPI_INTERNAL_VAR_XFACE 166 AcpiWarning ( 167 const char *ModuleName, 168 UINT32 LineNumber, 169 const char *Format, 170 ...) 171 { 172 va_list ArgList; 173 174 175 ACPI_MSG_REDIRECT_BEGIN; 176 AcpiOsPrintf (ACPI_MSG_WARNING); 177 178 va_start (ArgList, Format); 179 AcpiOsVprintf (Format, ArgList); 180 ACPI_MSG_SUFFIX; 181 va_end (ArgList); 182 183 ACPI_MSG_REDIRECT_END; 184 } 185 186 ACPI_EXPORT_SYMBOL (AcpiWarning) 187 188 189 /******************************************************************************* 190 * 191 * FUNCTION: AcpiInfo 192 * 193 * PARAMETERS: ModuleName - Caller's module name (for error output) 194 * LineNumber - Caller's line number (for error output) 195 * Format - Printf format string + additional args 196 * 197 * RETURN: None 198 * 199 * DESCRIPTION: Print generic "ACPI:" information message. There is no 200 * module/line/version info in order to keep the message simple. 201 * 202 * TBD: ModuleName and LineNumber args are not needed, should be removed. 203 * 204 ******************************************************************************/ 205 206 void ACPI_INTERNAL_VAR_XFACE 207 AcpiInfo ( 208 const char *Format, 209 ...) 210 { 211 va_list ArgList; 212 213 214 ACPI_MSG_REDIRECT_BEGIN; 215 AcpiOsPrintf (ACPI_MSG_INFO); 216 217 va_start (ArgList, Format); 218 AcpiOsVprintf (Format, ArgList); 219 AcpiOsPrintf ("\n"); 220 va_end (ArgList); 221 222 ACPI_MSG_REDIRECT_END; 223 } 224 225 ACPI_EXPORT_SYMBOL (AcpiInfo) 226 227 228 /******************************************************************************* 229 * 230 * FUNCTION: AcpiBiosError 231 * 232 * PARAMETERS: ModuleName - Caller's module name (for error output) 233 * LineNumber - Caller's line number (for error output) 234 * Format - Printf format string + additional args 235 * 236 * RETURN: None 237 * 238 * DESCRIPTION: Print "ACPI Firmware Error" message with module/line/version 239 * info 240 * 241 ******************************************************************************/ 242 243 void ACPI_INTERNAL_VAR_XFACE 244 AcpiBiosError ( 245 const char *ModuleName, 246 UINT32 LineNumber, 247 const char *Format, 248 ...) 249 { 250 va_list ArgList; 251 252 253 ACPI_MSG_REDIRECT_BEGIN; 254 AcpiOsPrintf (ACPI_MSG_BIOS_ERROR); 255 256 va_start (ArgList, Format); 257 AcpiOsVprintf (Format, ArgList); 258 ACPI_MSG_SUFFIX; 259 va_end (ArgList); 260 261 ACPI_MSG_REDIRECT_END; 262 } 263 264 ACPI_EXPORT_SYMBOL (AcpiBiosError) 265 266 267 /******************************************************************************* 268 * 269 * FUNCTION: AcpiBiosWarning 270 * 271 * PARAMETERS: ModuleName - Caller's module name (for error output) 272 * LineNumber - Caller's line number (for error output) 273 * Format - Printf format string + additional args 274 * 275 * RETURN: None 276 * 277 * DESCRIPTION: Print "ACPI Firmware Warning" message with module/line/version 278 * info 279 * 280 ******************************************************************************/ 281 282 void ACPI_INTERNAL_VAR_XFACE 283 AcpiBiosWarning ( 284 const char *ModuleName, 285 UINT32 LineNumber, 286 const char *Format, 287 ...) 288 { 289 va_list ArgList; 290 291 292 ACPI_MSG_REDIRECT_BEGIN; 293 AcpiOsPrintf (ACPI_MSG_BIOS_WARNING); 294 295 va_start (ArgList, Format); 296 AcpiOsVprintf (Format, ArgList); 297 ACPI_MSG_SUFFIX; 298 va_end (ArgList); 299 300 ACPI_MSG_REDIRECT_END; 301 } 302 303 ACPI_EXPORT_SYMBOL (AcpiBiosWarning) 304 305 #endif /* ACPI_NO_ERROR_MESSAGES */ 306