123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123 |
- // SPDX-License-Identifier: BSD-3-Clause OR GPL-2.0
- /*******************************************************************************
- *
- * Module Name: utexcep - Exception code support
- *
- ******************************************************************************/
- #define EXPORT_ACPI_INTERFACES
- #define ACPI_DEFINE_EXCEPTION_TABLE
- #include <acpi/acpi.h>
- #include "accommon.h"
- #define _COMPONENT ACPI_UTILITIES
- ACPI_MODULE_NAME("utexcep")
- /*******************************************************************************
- *
- * FUNCTION: acpi_format_exception
- *
- * PARAMETERS: status - The acpi_status code to be formatted
- *
- * RETURN: A string containing the exception text. A valid pointer is
- * always returned.
- *
- * DESCRIPTION: This function translates an ACPI exception into an ASCII
- * string. Returns "unknown status" string for invalid codes.
- *
- ******************************************************************************/
- const char *acpi_format_exception(acpi_status status)
- {
- const struct acpi_exception_info *exception;
- ACPI_FUNCTION_ENTRY();
- exception = acpi_ut_validate_exception(status);
- if (!exception) {
- /* Exception code was not recognized */
- ACPI_ERROR((AE_INFO,
- "Unknown exception code: 0x%8.8X", status));
- return ("UNKNOWN_STATUS_CODE");
- }
- return (exception->name);
- }
- ACPI_EXPORT_SYMBOL(acpi_format_exception)
- /*******************************************************************************
- *
- * FUNCTION: acpi_ut_validate_exception
- *
- * PARAMETERS: status - The acpi_status code to be formatted
- *
- * RETURN: A string containing the exception text. NULL if exception is
- * not valid.
- *
- * DESCRIPTION: This function validates and translates an ACPI exception into
- * an ASCII string.
- *
- ******************************************************************************/
- const struct acpi_exception_info *acpi_ut_validate_exception(acpi_status status)
- {
- u32 sub_status;
- const struct acpi_exception_info *exception = NULL;
- ACPI_FUNCTION_ENTRY();
- /*
- * Status is composed of two parts, a "type" and an actual code
- */
- sub_status = (status & ~AE_CODE_MASK);
- switch (status & AE_CODE_MASK) {
- case AE_CODE_ENVIRONMENTAL:
- if (sub_status <= AE_CODE_ENV_MAX) {
- exception = &acpi_gbl_exception_names_env[sub_status];
- }
- break;
- case AE_CODE_PROGRAMMER:
- if (sub_status <= AE_CODE_PGM_MAX) {
- exception = &acpi_gbl_exception_names_pgm[sub_status];
- }
- break;
- case AE_CODE_ACPI_TABLES:
- if (sub_status <= AE_CODE_TBL_MAX) {
- exception = &acpi_gbl_exception_names_tbl[sub_status];
- }
- break;
- case AE_CODE_AML:
- if (sub_status <= AE_CODE_AML_MAX) {
- exception = &acpi_gbl_exception_names_aml[sub_status];
- }
- break;
- case AE_CODE_CONTROL:
- if (sub_status <= AE_CODE_CTRL_MAX) {
- exception = &acpi_gbl_exception_names_ctrl[sub_status];
- }
- break;
- default:
- break;
- }
- if (!exception || !exception->name) {
- return (NULL);
- }
- return (exception);
- }
|