1 // SPDX-License-Identifier: GPL-2.0-only
3 * APEI Hardware Error Souce Table support
5 * HEST describes error sources in detail; communicates operational
6 * parameters (i.e. severity levels, masking bits, and threshold
7 * values) to Linux as necessary. It also allows the BIOS to report
8 * non-standard error sources to Linux (for example, chipset-specific
11 * For more information about HEST, please refer to ACPI Specification
12 * version 4.0, section 17.3.2.
14 * Copyright 2009 Intel Corp.
15 * Author: Huang Ying <ying.huang@intel.com>
18 #include <linux/kernel.h>
19 #include <linux/module.h>
20 #include <linux/init.h>
21 #include <linux/acpi.h>
22 #include <linux/kdebug.h>
23 #include <linux/highmem.h>
25 #include <linux/platform_device.h>
26 #include <acpi/apei.h>
27 #include <acpi/ghes.h>
29 #include "apei-internal.h"
31 #define HEST_PFX "HEST: "
34 EXPORT_SYMBOL_GPL(hest_disable
);
36 /* HEST table parsing */
38 static struct acpi_table_hest
*__read_mostly hest_tab
;
40 static const int hest_esrc_len_tab
[ACPI_HEST_TYPE_RESERVED
] = {
41 [ACPI_HEST_TYPE_IA32_CHECK
] = -1, /* need further calculation */
42 [ACPI_HEST_TYPE_IA32_CORRECTED_CHECK
] = -1,
43 [ACPI_HEST_TYPE_IA32_NMI
] = sizeof(struct acpi_hest_ia_nmi
),
44 [ACPI_HEST_TYPE_AER_ROOT_PORT
] = sizeof(struct acpi_hest_aer_root
),
45 [ACPI_HEST_TYPE_AER_ENDPOINT
] = sizeof(struct acpi_hest_aer
),
46 [ACPI_HEST_TYPE_AER_BRIDGE
] = sizeof(struct acpi_hest_aer_bridge
),
47 [ACPI_HEST_TYPE_GENERIC_ERROR
] = sizeof(struct acpi_hest_generic
),
48 [ACPI_HEST_TYPE_GENERIC_ERROR_V2
] = sizeof(struct acpi_hest_generic_v2
),
49 [ACPI_HEST_TYPE_IA32_DEFERRED_CHECK
] = -1,
52 static int hest_esrc_len(struct acpi_hest_header
*hest_hdr
)
54 u16 hest_type
= hest_hdr
->type
;
57 if (hest_type
>= ACPI_HEST_TYPE_RESERVED
)
60 len
= hest_esrc_len_tab
[hest_type
];
62 if (hest_type
== ACPI_HEST_TYPE_IA32_CORRECTED_CHECK
) {
63 struct acpi_hest_ia_corrected
*cmc
;
64 cmc
= (struct acpi_hest_ia_corrected
*)hest_hdr
;
65 len
= sizeof(*cmc
) + cmc
->num_hardware_banks
*
66 sizeof(struct acpi_hest_ia_error_bank
);
67 } else if (hest_type
== ACPI_HEST_TYPE_IA32_CHECK
) {
68 struct acpi_hest_ia_machine_check
*mc
;
69 mc
= (struct acpi_hest_ia_machine_check
*)hest_hdr
;
70 len
= sizeof(*mc
) + mc
->num_hardware_banks
*
71 sizeof(struct acpi_hest_ia_error_bank
);
72 } else if (hest_type
== ACPI_HEST_TYPE_IA32_DEFERRED_CHECK
) {
73 struct acpi_hest_ia_deferred_check
*mc
;
74 mc
= (struct acpi_hest_ia_deferred_check
*)hest_hdr
;
75 len
= sizeof(*mc
) + mc
->num_hardware_banks
*
76 sizeof(struct acpi_hest_ia_error_bank
);
83 int apei_hest_parse(apei_hest_func_t func
, void *data
)
85 struct acpi_hest_header
*hest_hdr
;
88 if (hest_disable
|| !hest_tab
)
91 hest_hdr
= (struct acpi_hest_header
*)(hest_tab
+ 1);
92 for (i
= 0; i
< hest_tab
->error_source_count
; i
++) {
93 len
= hest_esrc_len(hest_hdr
);
95 pr_warn(FW_WARN HEST_PFX
96 "Unknown or unused hardware error source "
97 "type: %d for hardware error source: %d.\n",
98 hest_hdr
->type
, hest_hdr
->source_id
);
101 if ((void *)hest_hdr
+ len
>
102 (void *)hest_tab
+ hest_tab
->header
.length
) {
103 pr_warn(FW_BUG HEST_PFX
104 "Table contents overflow for hardware error source: %d.\n",
105 hest_hdr
->source_id
);
109 rc
= func(hest_hdr
, data
);
113 hest_hdr
= (void *)hest_hdr
+ len
;
118 EXPORT_SYMBOL_GPL(apei_hest_parse
);
121 * Check if firmware advertises firmware first mode. We need FF bit to be set
122 * along with a set of MC banks which work in FF mode.
124 static int __init
hest_parse_cmc(struct acpi_hest_header
*hest_hdr
, void *data
)
126 if (hest_hdr
->type
!= ACPI_HEST_TYPE_IA32_CORRECTED_CHECK
)
129 if (!acpi_disable_cmcff
)
130 return !arch_apei_enable_cmcff(hest_hdr
, data
);
136 struct platform_device
**ghes_devs
;
140 static int __init
hest_parse_ghes_count(struct acpi_hest_header
*hest_hdr
, void *data
)
144 if (hest_hdr
->type
== ACPI_HEST_TYPE_GENERIC_ERROR
||
145 hest_hdr
->type
== ACPI_HEST_TYPE_GENERIC_ERROR_V2
)
150 static int __init
hest_parse_ghes(struct acpi_hest_header
*hest_hdr
, void *data
)
152 struct platform_device
*ghes_dev
;
153 struct ghes_arr
*ghes_arr
= data
;
156 if (hest_hdr
->type
!= ACPI_HEST_TYPE_GENERIC_ERROR
&&
157 hest_hdr
->type
!= ACPI_HEST_TYPE_GENERIC_ERROR_V2
)
160 if (!((struct acpi_hest_generic
*)hest_hdr
)->enabled
)
162 for (i
= 0; i
< ghes_arr
->count
; i
++) {
163 struct acpi_hest_header
*hdr
;
164 ghes_dev
= ghes_arr
->ghes_devs
[i
];
165 hdr
= *(struct acpi_hest_header
**)ghes_dev
->dev
.platform_data
;
166 if (hdr
->source_id
== hest_hdr
->source_id
) {
167 pr_warn(FW_WARN HEST_PFX
"Duplicated hardware error source ID: %d.\n",
172 ghes_dev
= platform_device_alloc("GHES", hest_hdr
->source_id
);
176 rc
= platform_device_add_data(ghes_dev
, &hest_hdr
, sizeof(void *));
180 rc
= platform_device_add(ghes_dev
);
183 ghes_arr
->ghes_devs
[ghes_arr
->count
++] = ghes_dev
;
187 platform_device_put(ghes_dev
);
191 static int __init
hest_ghes_dev_register(unsigned int ghes_count
)
194 struct ghes_arr ghes_arr
;
197 ghes_arr
.ghes_devs
= kmalloc_array(ghes_count
, sizeof(void *),
199 if (!ghes_arr
.ghes_devs
)
202 rc
= apei_hest_parse(hest_parse_ghes
, &ghes_arr
);
206 rc
= ghes_estatus_pool_init(ghes_count
);
211 kfree(ghes_arr
.ghes_devs
);
214 for (i
= 0; i
< ghes_arr
.count
; i
++)
215 platform_device_unregister(ghes_arr
.ghes_devs
[i
]);
219 static int __init
setup_hest_disable(char *str
)
221 hest_disable
= HEST_DISABLED
;
225 __setup("hest_disable", setup_hest_disable
);
227 void __init
acpi_hest_init(void)
231 unsigned int ghes_count
= 0;
234 pr_info(HEST_PFX
"Table parsing disabled.\n");
238 status
= acpi_get_table(ACPI_SIG_HEST
, 0,
239 (struct acpi_table_header
**)&hest_tab
);
240 if (status
== AE_NOT_FOUND
) {
241 hest_disable
= HEST_NOT_FOUND
;
243 } else if (ACPI_FAILURE(status
)) {
244 const char *msg
= acpi_format_exception(status
);
245 pr_err(HEST_PFX
"Failed to get table, %s\n", msg
);
250 rc
= apei_hest_parse(hest_parse_cmc
, NULL
);
255 rc
= apei_hest_parse(hest_parse_ghes_count
, &ghes_count
);
260 rc
= hest_ghes_dev_register(ghes_count
);
265 pr_info(HEST_PFX
"Table parsing has been initialized.\n");
268 hest_disable
= HEST_DISABLED
;