1 // SPDX-License-Identifier: BSD-3-Clause OR GPL-2.0
2 /*******************************************************************************
4 * Module Name: utexcep - Exception code support
6 ******************************************************************************/
8 #define EXPORT_ACPI_INTERFACES
10 #define ACPI_DEFINE_EXCEPTION_TABLE
11 #include <acpi/acpi.h>
14 #define _COMPONENT ACPI_UTILITIES
15 ACPI_MODULE_NAME("utexcep")
17 /*******************************************************************************
19 * FUNCTION: acpi_format_exception
21 * PARAMETERS: status - The acpi_status code to be formatted
23 * RETURN: A string containing the exception text. A valid pointer is
26 * DESCRIPTION: This function translates an ACPI exception into an ASCII
27 * string. Returns "unknown status" string for invalid codes.
29 ******************************************************************************/
30 const char *acpi_format_exception(acpi_status status)
32 const struct acpi_exception_info *exception;
34 ACPI_FUNCTION_ENTRY();
36 exception = acpi_ut_validate_exception(status);
39 /* Exception code was not recognized */
42 "Unknown exception code: 0x%8.8X", status));
44 return ("UNKNOWN_STATUS_CODE");
47 return (exception->name);
50 ACPI_EXPORT_SYMBOL(acpi_format_exception)
52 /*******************************************************************************
54 * FUNCTION: acpi_ut_validate_exception
56 * PARAMETERS: status - The acpi_status code to be formatted
58 * RETURN: A string containing the exception text. NULL if exception is
61 * DESCRIPTION: This function validates and translates an ACPI exception into
64 ******************************************************************************/
65 const struct acpi_exception_info *acpi_ut_validate_exception(acpi_status status)
68 const struct acpi_exception_info *exception = NULL;
70 ACPI_FUNCTION_ENTRY();
73 * Status is composed of two parts, a "type" and an actual code
75 sub_status = (status & ~AE_CODE_MASK);
77 switch (status & AE_CODE_MASK) {
78 case AE_CODE_ENVIRONMENTAL:
80 if (sub_status <= AE_CODE_ENV_MAX) {
81 exception = &acpi_gbl_exception_names_env[sub_status];
85 case AE_CODE_PROGRAMMER:
87 if (sub_status <= AE_CODE_PGM_MAX) {
88 exception = &acpi_gbl_exception_names_pgm[sub_status];
92 case AE_CODE_ACPI_TABLES:
94 if (sub_status <= AE_CODE_TBL_MAX) {
95 exception = &acpi_gbl_exception_names_tbl[sub_status];
101 if (sub_status <= AE_CODE_AML_MAX) {
102 exception = &acpi_gbl_exception_names_aml[sub_status];
106 case AE_CODE_CONTROL:
108 if (sub_status <= AE_CODE_CTRL_MAX) {
109 exception = &acpi_gbl_exception_names_ctrl[sub_status];
118 if (!exception || !exception->name) {