tjh.dev / kernel
Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux
fork atom

ACPI: Drop unused ACPI_*_COMPONENT definitions and update documentation

Drop the definitions of the following symbols:

ACPI_SBS_COMPONENT
ACPI_FAN_COMPONENT
ACPI_CONTAINER_COMPONENT
ACPI_MEMORY_DEVICE_COMPONENT

that are not used in a meaningful way any more and update the ACPI
debug documentation to avoid confusing users by making the impression
that the ACPICA debug can be used for anything other than ACPICA
itself, which is incorrect.

No functional impact.

Signed-off-by: Rafael J. Wysocki <rafael.j.wysocki@intel.com>
Reviewed-by: Hanjun Guo <guohanjun@huawei.com>

Rafael J. Wysocki 3aadd86e e6a55ccb

+12 -31
+12 -17
Documentation/firmware-guide/acpi/debug.rst
··· 1 1 .. SPDX-License-Identifier: GPL-2.0 2 2 3 - ================= 4 - ACPI Debug Output 5 - ================= 3 + ==================== 4 + ACPI CA Debug Output 5 + ==================== 6 6 7 - The ACPI CA, the Linux ACPI core, and some ACPI drivers can generate debug 8 - output. This document describes how to use this facility. 7 + The ACPI CA can generate debug output. This document describes how to use this 8 + facility. 9 9 10 10 Compile-time configuration 11 11 ========================== 12 12 13 - ACPI debug output is globally enabled by CONFIG_ACPI_DEBUG. If this config 14 - option is turned off, the debug messages are not even built into the 15 - kernel. 13 + The ACPI CA debug output is globally enabled by CONFIG_ACPI_DEBUG. If this 14 + config option is not set, the debug messages are not even built into the kernel. 16 15 17 16 Boot- and run-time configuration 18 17 ================================ ··· 26 27 ======================= 27 28 28 29 The "debug_layer" is a mask that selects components of interest, e.g., a 29 - specific driver or part of the ACPI interpreter. To build the debug_layer 30 - bitmask, look for the "#define _COMPONENT" in an ACPI source file. 30 + specific part of the ACPI interpreter. To build the debug_layer bitmask, look 31 + for the "#define _COMPONENT" in an ACPI source file. 31 32 32 33 You can set the debug_layer mask at boot-time using the acpi.debug_layer 33 34 command line argument, and you can change it after boot by writing values 34 35 to /sys/module/acpi/parameters/debug_layer. 35 36 36 - The possible components are defined in include/acpi/acoutput.h and 37 - include/acpi/acpi_drivers.h. Reading /sys/module/acpi/parameters/debug_layer 38 - shows the supported mask values, currently these:: 37 + The possible components are defined in include/acpi/acoutput.h. 38 + 39 + Reading /sys/module/acpi/parameters/debug_layer shows the supported mask values:: 39 40 40 41 ACPI_UTILITIES 0x00000001 41 42 ACPI_HARDWARE 0x00000002 ··· 51 52 ACPI_CA_DISASSEMBLER 0x00000800 52 53 ACPI_COMPILER 0x00001000 53 54 ACPI_TOOLS 0x00002000 54 - ACPI_SBS_COMPONENT 0x00100000 55 - ACPI_FAN_COMPONENT 0x00200000 56 - ACPI_CONTAINER_COMPONENT 0x01000000 57 - ACPI_MEMORY_DEVICE_COMPONENT 0x08000000 58 55 59 56 debug_level 60 57 ===========
-5
drivers/acpi/sysfs.c
··· 48 48 ACPI_DEBUG_INIT(ACPI_CA_DISASSEMBLER), 49 49 ACPI_DEBUG_INIT(ACPI_COMPILER), 50 50 ACPI_DEBUG_INIT(ACPI_TOOLS), 51 - 52 - ACPI_DEBUG_INIT(ACPI_SBS_COMPONENT), 53 - ACPI_DEBUG_INIT(ACPI_FAN_COMPONENT), 54 - ACPI_DEBUG_INIT(ACPI_CONTAINER_COMPONENT), 55 - ACPI_DEBUG_INIT(ACPI_MEMORY_DEVICE_COMPONENT), 56 51 }; 57 52 58 53 static const struct acpi_dlevel acpi_debug_levels[] = {
-9
include/acpi/acpi_drivers.h
··· 12 12 #define ACPI_MAX_STRING 80 13 13 14 14 /* 15 - * Please update drivers/acpi/debug.c and Documentation/firmware-guide/acpi/debug.rst 16 - * if you add to this list. 17 - */ 18 - #define ACPI_SBS_COMPONENT 0x00100000 19 - #define ACPI_FAN_COMPONENT 0x00200000 20 - #define ACPI_CONTAINER_COMPONENT 0x01000000 21 - #define ACPI_MEMORY_DEVICE_COMPONENT 0x08000000 22 - 23 - /* 24 15 * _HID definitions 25 16 * HIDs must conform to ACPI spec(6.1.4) 26 17 * Linux specific HIDs do not apply to this and begin with LNX: