Enable EINJv2 support
Subsystems (3)
cover Enable EINJv2 support
The goal of this update is to allow the driver to simultaneously support EINJ and EINJv2. The implementation follows the approved ACPI specs(1)(2) that enables the driver to discover system capabilities through GET_ERROR_TYPE.
Note: The first two ACPICA patches are to be dropped once merged in ACPICA project, see pull request(3).
(1) https://bugzilla.tianocore.org/show_bug.cgi?id=4615
(2) https://bugzilla.tianocore.org/attachment.cgi?id=1521
(3) https://github.com/acpica/acpica/pull/977
Zaid Alali (8):
ACPICA: Update values to hex to follow ACPI specs
ACPICA: Add EINJv2 get error type action
ACPI: APEI: EINJ: Remove redundant calls to
einj_get_available_error_type
ACPI: APEI: EINJ: Enable the discovery of EINJv2 capabilities
ACPI: APEI: EINJ: Add einjv2 extension struct
ACPI: APEI: EINJ: Add debugfs files for EINJv2 support
ACPI: APEI: EINJ: Enable EINJv2 error injections
ACPI: APEI: EINJ: Update the documentation for EINJv2 support
.../firmware-guide/acpi/apei/einj.rst | 46 ++++- drivers/acpi/apei/apei-internal.h | 2 +- drivers/acpi/apei/einj-core.c | 170 +++++++++++++++--- drivers/acpi/apei/einj-cxl.c | 2 +- include/acpi/actbl1.h | 25 +-- 5 files changed, 205 insertions(+), 40 deletions(-)
Signature · 1 line
2.34.1
PATCH 1/8 ACPICA: Update values to hex to follow ACPI specs
ACPI specs(1) define Error Injection Actions in hex values. This commit intends to update values from decimal to hex to be consistent with ACPI specs. This commit and the following one are not to be merged and will come form ACPICA project see pull request(2).
(1) https://uefi.org/specs/ACPI/6.5/18_Platform_Error_Interfaces.html
(2) https://github.com/acpica/acpica/pull/977
--- include/acpi/actbl1.h | 24 ++++++++++++------------ 1 file changed, 12 insertions(+), 12 deletions(-)
include/acpi/actbl1.h +12 -12
@@ -1022,18 +1022,18 @@ struct acpi_einj_entry {/* Values for Action field above */ enum acpi_einj_actions { -ACPI_EINJ_BEGIN_OPERATION =0 , -ACPI_EINJ_GET_TRIGGER_TABLE =1 , -ACPI_EINJ_SET_ERROR_TYPE =2 , -ACPI_EINJ_GET_ERROR_TYPE =3 , -ACPI_EINJ_END_OPERATION =4 , -ACPI_EINJ_EXECUTE_OPERATION =5 , -ACPI_EINJ_CHECK_BUSY_STATUS =6 , -ACPI_EINJ_GET_COMMAND_STATUS =7 , -ACPI_EINJ_SET_ERROR_TYPE_WITH_ADDRESS =8 , -ACPI_EINJ_GET_EXECUTE_TIMINGS =9 , -ACPI_EINJ_ACTION_RESERVED =10 ,/* 10 and greater are reserved */ -ACPI_EINJ_TRIGGER_ERROR =0xFF /* Except for this value */ +ACPI_EINJ_BEGIN_OPERATION =0x0 , +ACPI_EINJ_GET_TRIGGER_TABLE =0x1 , +ACPI_EINJ_SET_ERROR_TYPE =0x2 , +ACPI_EINJ_GET_ERROR_TYPE =0x3 , +ACPI_EINJ_END_OPERATION =0x4 , +ACPI_EINJ_EXECUTE_OPERATION =0x5 , +ACPI_EINJ_CHECK_BUSY_STATUS =0x6 , +ACPI_EINJ_GET_COMMAND_STATUS =0x7 , +ACPI_EINJ_SET_ERROR_TYPE_WITH_ADDRESS =0x8 , +ACPI_EINJ_GET_EXECUTE_TIMINGS =0x9 , +ACPI_EINJ_ACTION_RESERVED =0xA ,/* 0xA and greater are reserved */ +ACPI_EINJ_TRIGGER_ERROR =0xFF /* Except for this value */ };/* Values for Instruction field above */
Signature · 1 line
2.34.1
PATCH 2/8 ACPICA: Add EINJv2 get error type action
In reply to Zaid AlaliAdd EINJV2_GET_ERROR_TYPE as defined in the approved new ACPI specs(1)(2).
Proposed ACPI spces for EINJv2:
(1) https://bugzilla.tianocore.org/show_bug.cgi?id=4615
(2) https://bugzilla.tianocore.org/attachment.cgi?id=1521
This commit is not a direct merge, it will come from ACPICA project, see pull request(3).
(3) https://github.com/acpica/acpica/pull/977
--- include/acpi/actbl1.h | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-)
include/acpi/actbl1.h +2 -1
@@ -1032,7 +1032,8 @@ enum acpi_einj_actions {ACPI_EINJ_GET_COMMAND_STATUS =0x7 ,ACPI_EINJ_SET_ERROR_TYPE_WITH_ADDRESS =0x8 ,ACPI_EINJ_GET_EXECUTE_TIMINGS =0x9 , -ACPI_EINJ_ACTION_RESERVED =0xA ,/* 0xA and greater are reserved */ +ACPI_EINJV2_GET_ERROR_TYPE =0x11 , +ACPI_EINJ_ACTION_RESERVED =0x12 ,/* 0x12 and greater are reserved */ ACPI_EINJ_TRIGGER_ERROR = 0xFF /* Except for this value */ };
Signature · 1 line
2.34.1
PATCH 3/8 ACPI: APEI: EINJ: Remove redundant calls to einj_get_available_error_type
In reply to Zaid AlaliA single call to einj_get_available_error_type in init function is sufficient to save the return value in a global variable to be used later in various places in the code. This commit does not introduce any functional changes, but only removing unnecessary redundant function calls.
--- drivers/acpi/apei/einj-core.c | 22 +++++++++------------- 1 file changed, 9 insertions(+), 13 deletions(-)
drivers/acpi/apei/einj-core.c +9 -13
@@ -83,6 +83,8 @@ static struct debugfs_blob_wrapper vendor_blob;static struct debugfs_blob_wrapper vendor_errors;static char vendor_dev[64 ]; +static u32 available_error_type; +/* * Some BIOSes allow parameters to the SET_ERROR_TYPE entries in the * EINJ table through an unpublished extension. Use with caution as
@@ -648,14 +650,9 @@ static struct { u32 mask; const char *str; } const einj_error_type_string[] = {static int available_error_type_show (struct seq_file *m,void *v) { -int rc; -u32 error_type =0 ; - rc =einj_get_available_error_type (&error_type); -if (rc) -return rc;for (int pos =0 ; pos <ARRAY_SIZE (einj_error_type_string); pos++) -if (error_type & einj_error_type_string[pos].mask) +if (available_error_type & einj_error_type_string[pos].mask)seq_printf (m,"0x%08x\t%s\n" , einj_error_type_string[pos].mask, einj_error_type_string[pos].str);
@@ -678,8 +675,7 @@ bool einj_is_cxl_error_type(u64 type)int einj_validate_error_type (u64 type) { -u32 tval, vendor, available_error_type =0 ; -int rc; +u32 tval, vendor;/* Only low 32 bits for error type are valid */ if (type &GENMASK_ULL (63 ,32 ))
@@ -695,13 +691,9 @@ int einj_validate_error_type(u64 type)/* Only one error type can be specified */ if (tval & (tval -1 ))return -EINVAL ; -if (!vendor) { - rc =einj_get_available_error_type (&available_error_type); -if (rc) -return rc; +if (!vendor)if (!(type & available_error_type))return -EINVAL ; - }return 0 ; }
@@ -777,6 +769,10 @@ static int __init einj_probe(struct platform_device *pdev) goto err_put_table; } + rc =einj_get_available_error_type (&available_error_type); +if (rc) +return rc; + rc = -ENOMEM ; einj_debug_dir =debugfs_create_dir ("einj" ,apei_get_debugfs_dir ());
Signature · 1 line
2.34.1
PATCH 4/8 ACPI: APEI: EINJ: Enable the discovery of EINJv2 capabilities
In reply to Zaid AlaliEnable the driver to show all supported error injections for EINJ and EINJv2 at the same time. EINJv2 capabilities can be discovered by checking the return value of get_error_type, where bit 30 set indicates EINJv2 support.
--- drivers/acpi/apei/apei-internal.h | 2 +- drivers/acpi/apei/einj-core.c | 33 +++++++++++++++++++++++-------- drivers/acpi/apei/einj-cxl.c | 2 +- 3 files changed, 27 insertions(+), 10 deletions(-)
drivers/acpi/apei/apei-internal.h +1 -1
@@ -131,7 +131,7 @@ static inline u32 cper_estatus_len(struct acpi_hest_generic_status *estatus)int apei_osc_setup (void ); -int einj_get_available_error_type (u32 *type); +int einj_get_available_error_type (u32 *type,int version);int einj_error_inject (u32 type,u32 flags,u64 param1,u64 param2,u64 param3,u64 param4); int einj_cxl_rch_error_inject(u32 type, u32 flags, u64 param1, u64 param2,
drivers/acpi/apei/einj-core.c +25 -8
@@ -33,6 +33,7 @@#define SLEEP_UNIT_MAX 5000/* 5ms */ /* Firmware should respond within 1 seconds */ #define FIRMWARE_TIMEOUT (1 * USEC_PER_SEC) +#define ACPI65_EINJV2_SUPP BIT(30)#define ACPI5_VENDOR_BIT BIT(31)#define MEM_ERROR_MASK (ACPI_EINJ_MEMORY_CORRECTABLE | \ ACPI_EINJ_MEMORY_UNCORRECTABLE | \
@@ -84,6 +85,7 @@ static struct debugfs_blob_wrapper vendor_errors;static char vendor_dev[64 ];static u32 available_error_type; +static u32 available_error_type_v2;/* * Some BIOSes allow parameters to the SET_ERROR_TYPE entries in the
@@ -159,13 +161,13 @@ static void einj_exec_ctx_init(struct apei_exec_context *ctx) EINJ_TAB_ENTRY(einj_tab), einj_tab->entries); } -static int __einj_get_available_error_type (u32 *type) +static int __einj_get_available_error_type (u32 *type,int version) {struct apei_exec_context ctx;int rc;einj_exec_ctx_init (&ctx); - rc =apei_exec_run (&ctx,ACPI_EINJ_GET_ERROR_TYPE ); + rc =apei_exec_run (&ctx, version);if (rc)return rc; *type =apei_exec_ctx_get_output (&ctx);
@@ -174,12 +176,12 @@ static int __einj_get_available_error_type(u32 *type) }/* Get error injection capabilities of the platform */ -int einj_get_available_error_type (u32 *type) +int einj_get_available_error_type (u32 *type,int version) {int rc;mutex_lock (&einj_mutex); - rc =__einj_get_available_error_type (type); + rc =__einj_get_available_error_type (type, version);mutex_unlock (&einj_mutex);return rc;
@@ -647,6 +649,11 @@ static struct { u32 mask; const char *str; } const einj_error_type_string[] = { { BIT(11), "Platform Uncorrectable fatal"}, { BIT(31), "Vendor Defined Error Types" }, }; +static struct {u32 mask;const char *str; }const einjv2_error_type_string[] = { + {BIT (0 ),"EINJV2 Processor Error" }, + {BIT (1 ),"EINJV2 Memory Error" }, + {BIT (2 ),"EINJV2 PCI Express Error" }, +};static int available_error_type_show (struct seq_file *m,void *v) {
@@ -654,8 +661,13 @@ static int available_error_type_show(struct seq_file *m, void *v)for (int pos =0 ; pos <ARRAY_SIZE (einj_error_type_string); pos++)if (available_error_type & einj_error_type_string[pos].mask)seq_printf (m,"0x%08x\t%s\n" , einj_error_type_string[pos].mask, - einj_error_type_string[pos].str); - + einj_error_type_string[pos].str); +if (available_error_type &ACPI65_EINJV2_SUPP ) { +for (int pos =0 ; pos <ARRAY_SIZE (einjv2_error_type_string); pos++) +if (available_error_type_v2 & einjv2_error_type_string[pos].mask) +seq_printf (m,"0x%08x\t%s\n" , einjv2_error_type_string[pos].mask, + einjv2_error_type_string[pos].str); + }return 0 ; }
@@ -692,7 +704,7 @@ int einj_validate_error_type(u64 type)if (tval & (tval -1 ))return -EINVAL ;if (!vendor) -if (!(type & available_error_type)) +if (!(type & (available_error_type)))return -EINVAL ;return 0 ;
@@ -769,9 +781,14 @@ static int __init einj_probe(struct platform_device *pdev) goto err_put_table; } - rc =einj_get_available_error_type (&available_error_type); + rc =einj_get_available_error_type (&available_error_type,ACPI_EINJ_GET_ERROR_TYPE );if (rc)return rc; +if (available_error_type &ACPI65_EINJV2_SUPP ) { + rc =einj_get_available_error_type (&available_error_type_v2,ACPI_EINJV2_GET_ERROR_TYPE ); +if (rc) +return rc; + } rc = -ENOMEM ; einj_debug_dir =debugfs_create_dir ("einj" ,apei_get_debugfs_dir ());
drivers/acpi/apei/einj-cxl.c +1 -1
@@ -30,7 +30,7 @@ int einj_cxl_available_error_type_show(struct seq_file *m, void *v)int cxl_err, rc;u32 available_error_type =0 ; - rc =einj_get_available_error_type (&available_error_type); + rc =einj_get_available_error_type (&available_error_type,ACPI_EINJ_GET_ERROR_TYPE );if (rc)return rc;
Signature · 1 line
2.34.1
Tony Luck
reviewerRe: [PATCH 4/8] ACPI: APEI: EINJ: Enable the discovery of EINJv2 capabilities
drivers/acpi/apei/einj-core.c int einj_validate_error_type(u64 type) · line 707
Quoted 6 lines · Zaid Alali
drivers/acpi/apei/einj-core.c +1
-1@@ -692,7 +704,7 @@ int einj_validate_error_type(u64 type)if (tval & (tval -1 ))return -EINVAL ;if (!vendor) -if (!(type & available_error_type)) +if (!(type & (available_error_type)))
Extra parentheses around available_error_type not needed.
-Tony
Re: [PATCH 4/8] ACPI: APEI: EINJ: Enable the discovery of EINJv2 capabilities
In reply to Zaid AlaliQuoted 89 lines · Zaid Alali
Enable the driver to show all supported error injections for EINJ and EINJv2 at the same time. EINJv2 capabilities can be discovered by checking the return value of
get_error_type, where bit 30 set indicates EINJv2 support.Signed-off-by Zaid Alali <[email protected]>--- drivers/acpi/apei/apei-internal.h | 2 +- drivers/acpi/apei/einj-core.c | 33 +++++++++++++++++++++++-------- drivers/acpi/apei/einj-cxl.c | 2 +- 3 files changed, 27 insertions(+), 10 deletions(-)drivers/acpi/apei/apei-internal.h +1
-1@@ -131,7 +131,7 @@ static inline u32 cper_estatus_len(struct acpi_hest_generic_status *estatus)int apei_osc_setup (void ); -int einj_get_available_error_type (u32 *type); +int einj_get_available_error_type (u32 *type,int version);int einj_error_inject (u32 type,u32 flags,u64 param1,u64 param2,u64 param3,u64 param4); int einj_cxl_rch_error_inject(u32 type, u32 flags, u64 param1, u64 param2,drivers/acpi/apei/einj-core.c +11
-4@@ -33,6 +33,7 @@#define SLEEP_UNIT_MAX 5000/* 5ms */ /* Firmware should respond within 1 seconds */ #define FIRMWARE_TIMEOUT (1 * USEC_PER_SEC) +#define ACPI65_EINJV2_SUPP BIT(30)#define ACPI5_VENDOR_BIT BIT(31)#define MEM_ERROR_MASK (ACPI_EINJ_MEMORY_CORRECTABLE | \ ACPI_EINJ_MEMORY_UNCORRECTABLE | \@@ -84,6 +85,7 @@ static struct debugfs_blob_wrapper vendor_errors;static char vendor_dev[64 ];static u32 available_error_type; +static u32 available_error_type_v2;/* * Some BIOSes allow parameters to the SET_ERROR_TYPE entries in the @@ -159,13 +161,13 @@ static void einj_exec_ctx_init(struct apei_exec_context *ctx) EINJ_TAB_ENTRY(einj_tab), einj_tab->entries); } -static int __einj_get_available_error_type (u32 *type) +static int __einj_get_available_error_type (u32 *type,int version) {struct apei_exec_context ctx;int rc;einj_exec_ctx_init (&ctx); - rc =apei_exec_run (&ctx,ACPI_EINJ_GET_ERROR_TYPE ); + rc =apei_exec_run (&ctx, version);if (rc)return rc; *type =apei_exec_ctx_get_output (&ctx);@@ -174,12 +176,12 @@ static int __einj_get_available_error_type(u32 *type) }/* Get error injection capabilities of the platform */ -int einj_get_available_error_type (u32 *type) +int einj_get_available_error_type (u32 *type,int version) {int rc;mutex_lock (&einj_mutex); - rc =__einj_get_available_error_type (type); + rc =__einj_get_available_error_type (type, version);mutex_unlock (&einj_mutex);return rc;@@ -647,6 +649,11 @@ static struct { u32 mask; const char *str; } const einj_error_type_string[] = { { BIT(11), "Platform Uncorrectable fatal"}, { BIT(31), "Vendor Defined Error Types" }, }; +static struct {u32 mask;const char *str; }const einjv2_error_type_string[] = { + {BIT (0 ),"EINJV2 Processor Error" }, + {BIT (1 ),"EINJV2 Memory Error" }, + {BIT (2 ),"EINJV2 PCI Express Error" }, +};static int available_error_type_show (struct seq_file *m,void *v) {
drivers/acpi/apei/einj-core.c static int available_error_type_show(struct seq_file *m, void *v) · line 664
Quoted 6 lines
drivers/acpi/apei/einj-core.c +1
-2@@ -654,8 +661,13 @@ static int available_error_type_show(struct seq_file *m, void *v)for (int pos =0 ; pos <ARRAY_SIZE (einj_error_type_string); pos++)if (available_error_type & einj_error_type_string[pos].mask)seq_printf (m,"0x%08x\t%s\n" , einj_error_type_string[pos].mask, - einj_error_type_string[pos].str); - + einj_error_type_string[pos].str);
This looks like it may have been unintentional. Alignment of the above line should be left alone and the newline kept.
drivers/acpi/apei/einj-core.c static int available_error_type_show(struct seq_file *m, void *v) · line 669
Quoted 5 lines
drivers/acpi/apei/einj-core.c +5
-0+if (available_error_type &ACPI65_EINJV2_SUPP ) { +for (int pos =0 ; pos <ARRAY_SIZE (einjv2_error_type_string); pos++) +if (available_error_type_v2 & einjv2_error_type_string[pos].mask) +seq_printf (m,"0x%08x\t%s\n" , einjv2_error_type_string[pos].mask, + einjv2_error_type_string[pos].str);
Similarly, the above line should be aligned as the other one was previously:
seq_printf(m, "0x%08x\t%s\n", einj_error_type_string[pos].mask, einjv2_error_type_string[pos].str);
drivers/acpi/apei/einj-core.c int einj_validate_error_type(u64 type) · line 707
Quoted 10 lines
drivers/acpi/apei/einj-core.c +2
-1+ }return 0 ; }@@ -692,7 +704,7 @@ int einj_validate_error_type(u64 type)if (tval & (tval -1 ))return -EINVAL ;if (!vendor) -if (!(type & available_error_type)) +if (!(type & (available_error_type)))
Why are these extra parens being added? Is there a reason for this?
drivers/acpi/apei/einj-core.c static int __init einj_probe(struct platform_device *pdev) · line 788
Quoted 13 lines
drivers/acpi/apei/einj-core.c +3
-1return -EINVAL ;return 0 ;@@ -769,9 +781,14 @@ static int __init einj_probe(struct platform_device *pdev) goto err_put_table; } - rc =einj_get_available_error_type (&available_error_type); + rc =einj_get_available_error_type (&available_error_type,ACPI_EINJ_GET_ERROR_TYPE );if (rc)return rc; +if (available_error_type &ACPI65_EINJV2_SUPP ) { + rc =einj_get_available_error_type (&available_error_type_v2,ACPI_EINJV2_GET_ERROR_TYPE );
checkpatch.pl complains about the above line being longer the 100 chars. This should be broken up.
Thanks,
John
Quoted 22 lines
drivers/acpi/apei/einj-core.c +3
-0+if (rc) +return rc; + } rc = -ENOMEM ; einj_debug_dir =debugfs_create_dir ("einj" ,apei_get_debugfs_dir ());drivers/acpi/apei/einj-cxl.c +1
-1@@ -30,7 +30,7 @@ int einj_cxl_available_error_type_show(struct seq_file *m, void *v)int cxl_err, rc;u32 available_error_type =0 ; - rc =einj_get_available_error_type (&available_error_type); + rc =einj_get_available_error_type (&available_error_type,ACPI_EINJ_GET_ERROR_TYPE );if (rc)return rc;Signature · 1 line
2.34.1
PATCH 5/8 ACPI: APEI: EINJ: Add einjv2 extension struct
In reply to Zaid AlaliAdd einjv2 extension struct and EINJv2 error types to prepare the driver for EINJv2 support. ACPI specifications(1) enables EINJv2 by extending set_error_type_with_address strcut.
--- drivers/acpi/apei/einj-core.c | 23 +++++++++++++++++++++++ 1 file changed, 23 insertions(+)
drivers/acpi/apei/einj-core.c +23 -0
@@ -50,6 +50,28 @@*/ static int acpi5; +struct syndrome_array { +union { +u32 acpi_id; +u32 device_id; +u32 pcie_sbdf; +u8 vendor_id[16 ]; + } comp_id; +union { +u32 proc_synd; +u32 mem_synd; +u32 pcie_synd; +u8 vendor_synd[16 ]; + } comp_synd; +}; + +struct einjv2_extension_struct { +u32 length; +u16 revision; +u16 component_arr_count; +struct syndrome_array component_arr[]; +}; +struct set_error_type_with_address {u32 type;u32 vendor_extension;
@@ -58,6 +80,7 @@ struct set_error_type_with_address {u64 memory_address;u64 memory_address_range;u32 pcie_sbdf; +struct einjv2_extension_struct einjv2_struct; };enum {SETWA_FLAGS_APICID =1 ,
Signature · 1 line
2.34.1
Tony Luck
reviewerRe: [PATCH 5/8] ACPI: APEI: EINJ: Add einjv2 extension struct
Quoted 3 lines · Zaid Alali
Add einjv2 extension struct and EINJv2 error types to prepare the driver for EINJv2 support. ACPI specifications(1) enables EINJv2 by extending
set_error_type_with_addressstrcut.
s/strcut/struct/
-Tony
PATCH 6/8 ACPI: APEI: EINJ: Add debugfs files for EINJv2 support
In reply to Zaid AlaliCreate a debugfs blob file to be used for reading the user input for the component array. EINJv2 enables users to inject errors to multiple components/devices at the same time using component array.
--- drivers/acpi/apei/einj-core.c | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+)
drivers/acpi/apei/einj-core.c +18 -0
@@ -33,6 +33,7 @@#define SLEEP_UNIT_MAX 5000/* 5ms */ /* Firmware should respond within 1 seconds */ #define FIRMWARE_TIMEOUT (1 * USEC_PER_SEC) +#define COMP_ARR_SIZE 1024#define ACPI65_EINJV2_SUPP BIT(30)#define ACPI5_VENDOR_BIT BIT(31)#define MEM_ERROR_MASK (ACPI_EINJ_MEMORY_CORRECTABLE | \
@@ -107,6 +108,9 @@ static struct debugfs_blob_wrapper vendor_blob;static struct debugfs_blob_wrapper vendor_errors;static char vendor_dev[64 ]; +static struct debugfs_blob_wrapper einjv2_component_arr; +static u64 component_count; +static void *user_input;static u32 available_error_type;static u32 available_error_type_v2;
@@ -857,6 +861,19 @@ static int __init einj_probe(struct platform_device *pdev) &error_param4);debugfs_create_x32 ("notrigger" ,S_IRUSR |S_IWUSR , einj_debug_dir, ¬rigger); +if (available_error_type &ACPI65_EINJV2_SUPP ) { +debugfs_create_x64 ("einjv2_component_count" ,S_IRUSR |S_IWUSR , + einj_debug_dir, &component_count); + user_input =kzalloc (COMP_ARR_SIZE ,GFP_KERNEL ); +if (!user_input) { + rc = -ENOMEM ; + goto err_release; + } + einjv2_component_arr.data = user_input; + einjv2_component_arr.size =COMP_ARR_SIZE ; +debugfs_create_blob ("einjv2_component_array" ,S_IRUSR |S_IWUSR , + einj_debug_dir, &einjv2_component_arr); + } }if (vendor_dev[0 ]) {
@@ -906,6 +923,7 @@ static void __exit einj_remove(struct platform_device *pdev)apei_resources_fini (&einj_resources);debugfs_remove_recursive (einj_debug_dir);acpi_put_table ((struct acpi_table_header *)einj_tab); +kfree (user_input); }static struct platform_device *einj_dev;
Signature · 1 line
2.34.1
PATCH 7/8 ACPI: APEI: EINJ: Enable EINJv2 error injections
In reply to Zaid AlaliEnable the driver to inject EINJv2 type errors. The component array values are parsed from user_input and expected to contain hex values for component id and syndrome separated by space, and multiple components are separated by new line as follows:
component_id1 component_syndrome1component_id2 component_syndrome2
:component_id(n) component_syndrome(n)
for example:
$comp_arr="0x1 0x2
Quoted 2 lines
0x10x40x20x4"
$cd /sys/kernel/debug/apei/einj/
$echo "$comp_arr" > einjv2_component_array
--- drivers/acpi/apei/einj-core.c | 76 +++++++++++++++++++++++++++++++++-- 1 file changed, 72 insertions(+), 4 deletions(-)
drivers/acpi/apei/einj-core.c +72 -4
@@ -87,6 +87,13 @@ enum {SETWA_FLAGS_APICID =1 ,SETWA_FLAGS_MEM =2 ,SETWA_FLAGS_PCIE_SBDF =4 , + SETWA_FLAGS_EINJV2 = 8, +}; + +enum { +EINJV2_PROCESSOR_ERROR =0x1 , +EINJV2_MEMORY_ERROR =0x2 , +EINJV2_PCIE_ERROR =0x4 , };/*
@@ -111,6 +118,7 @@ static char vendor_dev[64];static struct debugfs_blob_wrapper einjv2_component_arr;static u64 component_count;static void *user_input; +static int nr_components;static u32 available_error_type;static u32 available_error_type_v2;
@@ -287,8 +295,18 @@ static void *einj_get_parameter_address(void) v5param =acpi_os_map_iomem (pa_v5,sizeof (*v5param));if (v5param) { +int offset, len; + acpi5 =1 ;check_vendor_extension (pa_v5, v5param); +if (available_error_type &ACPI65_EINJV2_SUPP ) { + len = v5param->einjv2_struct.length; + offset = offsetof(struct einjv2_extension_struct , component_arr); + nr_components = (len - offset) /32 ; +acpi_os_unmap_iomem (v5param,sizeof (*v5param)); + v5param =acpi_os_map_iomem (pa_v5,sizeof (*v5param) + ( + (nr_components) *sizeof (struct syndrome_array ))); + }return v5param; } }
@@ -496,8 +514,49 @@ static int __einj_error_inject(u32 type, u32 flags, u64 param1, u64 param2, v5param->flags = flags; v5param->memory_address = param1; v5param->memory_address_range = param2; - v5param->apicid = param3; - v5param->pcie_sbdf = param4; + +if (flags &SETWA_FLAGS_EINJV2 ) { +int count =0 , bytes_read, pos =0 ; +unsigned int comp, synd; +struct syndrome_array *component_arr; + +if (component_count > nr_components) + goto err_out; + + v5param->einjv2_struct.component_arr_count = component_count; + component_arr = v5param->einjv2_struct.component_arr; + +while (sscanf (user_input+pos,"%x %x\n%n" , &comp, &synd, + &bytes_read) ==2 ) { + pos += bytes_read; +if (count > component_count) + goto err_out; + +switch (type) { +case EINJV2_PROCESSOR_ERROR : + component_arr[count].comp_id.acpi_id = comp; + component_arr[count].comp_synd.proc_synd = synd; +break ; +case EINJV2_MEMORY_ERROR : + component_arr[count].comp_id.device_id = comp; + component_arr[count].comp_synd.mem_synd = synd; +break ; +case EINJV2_PCIE_ERROR : + component_arr[count].comp_id.pcie_sbdf = comp; + component_arr[count].comp_synd.pcie_synd = synd; +break ; + } + count++; + } +if (count != component_count -1 ) + goto err_out; + +/* clear buffer after user input for next injection */ +memset (user_input,0 ,COMP_ARR_SIZE ); + }else { + v5param->apicid = param3; + v5param->pcie_sbdf = param4; + } }else {switch (type) {case ACPI_EINJ_PROCESSOR_CORRECTABLE :
@@ -570,6 +629,9 @@ static int __einj_error_inject(u32 type, u32 flags, u64 param1, u64 param2, rc =apei_exec_run_optional (&ctx,ACPI_EINJ_END_OPERATION );return rc; +err_out: +memset (user_input,0 ,COMP_ARR_SIZE ); +return -EINVAL ; }/* Inject the specified hardware error */
@@ -581,9 +643,14 @@ int einj_error_inject(u32 type, u32 flags, u64 param1, u64 param2, u64 param3,/* If user manually set "flags", make sure it is legal */ if (flags && (flags & - ~(SETWA_FLAGS_APICID |SETWA_FLAGS_MEM |SETWA_FLAGS_PCIE_SBDF ))) + ~(SETWA_FLAGS_APICID |SETWA_FLAGS_MEM |SETWA_FLAGS_PCIE_SBDF |SETWA_FLAGS_EINJV2 )))return -EINVAL ; +/*check if type is a valid EINJv2 error type*/ +if (flags &SETWA_FLAGS_EINJV2 ) { +if (!(type & available_error_type_v2)) +return -EINVAL ; + }/* * We need extra sanity checks for memory errors. * Other types leap directly to injection.
@@ -913,7 +980,8 @@ static void __exit einj_remove(struct platform_device *pdev) sizeof(struct set_error_type_with_address) :sizeof (struct einj_parameter ); -acpi_os_unmap_iomem (einj_param, size); +acpi_os_unmap_iomem (einj_param, + size + (nr_components *sizeof (struct syndrome_array )));if (vendor_errors.size)acpi_os_unmap_memory (vendor_errors.data, vendor_errors.size); }
Signature · 1 line
2.34.1
kernel test robot
build botRe: [PATCH 7/8] ACPI: APEI: EINJ: Enable EINJv2 error injections
kernel test robot noticed the following build warnings:
Hi Zaid,
kernel test robot noticed the following build warnings:
[auto build test WARNING on rafael-pm/linux-next]
[also build test WARNING on rafael-pm/bleeding-edge linus/master v6.12-rc4 next-20241024] [If your patch is applied to the wrong git tree, kindly drop us a note.
And when submitting patch, we suggest to use '--base' as documented in
https://git-scm.com/docs/git-format-patch#_base_tree_information]
url: https://github.com/intel-lab-lkp/linux/commits/Zaid-Alali/ACPICA-Update-values-to-hex-to-follow-ACPI-specs/20241023-054034 base: https://git.kernel.org/pub/scm/linux/kernel/git/rafael/linux-pm.git linux-next patch link: https://lore.kernel.org/r/20241022213429.1561784-8-zaidal%40os.amperecomputing.com patch subject: [PATCH 7/8] ACPI: APEI: EINJ: Enable EINJv2 error injections config: x86_64-randconfig-121-20241024 (https://download.01.org/0day-ci/archive/20241024/[email protected]/config) compiler: gcc-12 (Debian 12.2.0-14) 12.2.0 reproduce (this is a W=1 build): (https://download.01.org/0day-ci/archive/20241024/[email protected]/reproduce)
If you fix the issue in a separate patch/commit (i.e. not just a new version of the same patch/commit), kindly add following tags
| Reported-by: kernel test robot <[email protected]>
| Closes: https://lore.kernel.org/oe-kbuild-all/[email protected]/
sparse warnings: (new ones prefixed by >>)
drivers/acpi/apei/einj-core.c:261:11: sparse: sparse: incorrect type in assignment (different address spaces) @@ expected struct vendor_error_type_extension *v @@ got void [noderef] __iomem * @@
drivers/acpi/apei/einj-core.c:261:11: sparse: expected struct vendor_error_type_extension *v
drivers/acpi/apei/einj-core.c:261:11: sparse: got void [noderef] __iomem *
drivers/acpi/apei/einj-core.c:270:29: sparse: sparse: incorrect type in argument 1 (different address spaces) @@ expected void [noderef] __iomem *virt @@ got struct vendor_error_type_extension *v @@
drivers/acpi/apei/einj-core.c:270:29: sparse: expected void [noderef] __iomem *virt
drivers/acpi/apei/einj-core.c:270:29: sparse: got struct vendor_error_type_extension *v
drivers/acpi/apei/einj-core.c:296:25: sparse: sparse: incorrect type in assignment (different address spaces) @@ expected struct set_error_type_with_address *v5param @@ got void [noderef] __iomem * @@
drivers/acpi/apei/einj-core.c:296:25: sparse: expected struct set_error_type_with_address *v5param
drivers/acpi/apei/einj-core.c:296:25: sparse: got void [noderef] __iomem *
>> drivers/acpi/apei/einj-core.c:306:53: sparse: sparse: incorrect type in argument 1 (different address spaces) @@ expected void [noderef] __iomem *virt @@ got struct set_error_type_with_address *v5param @@
drivers/acpi/apei/einj-core.c:306:53: sparse: expected void [noderef] __iomem *virt
drivers/acpi/apei/einj-core.c:306:53: sparse: got struct set_error_type_with_address *v5param
drivers/acpi/apei/einj-core.c:307:41: sparse: sparse: incorrect type in assignment (different address spaces) @@ expected struct set_error_type_with_address *v5param @@ got void [noderef] __iomem * @@
drivers/acpi/apei/einj-core.c:307:41: sparse: expected struct set_error_type_with_address *v5param
drivers/acpi/apei/einj-core.c:307:41: sparse: got void [noderef] __iomem *
drivers/acpi/apei/einj-core.c:316:25: sparse: sparse: incorrect type in assignment (different address spaces) @@ expected struct einj_parameter *v4param @@ got void [noderef] __iomem * @@
drivers/acpi/apei/einj-core.c:316:25: sparse: expected struct einj_parameter *v4param
drivers/acpi/apei/einj-core.c:316:25: sparse: got void [noderef] __iomem *
drivers/acpi/apei/einj-core.c:320:45: sparse: sparse: incorrect type in argument 1 (different address spaces) @@ expected void [noderef] __iomem *virt @@ got struct einj_parameter *v4param @@
drivers/acpi/apei/einj-core.c:320:45: sparse: expected void [noderef] __iomem *virt
drivers/acpi/apei/einj-core.c:320:45: sparse: got struct einj_parameter *v4param
drivers/acpi/apei/einj-core.c:387:21: sparse: sparse: incorrect type in assignment (different address spaces) @@ expected struct acpi_einj_trigger *trigger_tab @@ got void [noderef] __iomem * @@
drivers/acpi/apei/einj-core.c:387:21: sparse: expected struct acpi_einj_trigger *trigger_tab
drivers/acpi/apei/einj-core.c:387:21: sparse: got void [noderef] __iomem *
drivers/acpi/apei/einj-core.c:413:17: sparse: sparse: incorrect type in argument 1 (different address spaces) @@ expected void volatile [noderef] __iomem *addr @@ got struct acpi_einj_trigger *trigger_tab @@
drivers/acpi/apei/einj-core.c:413:17: sparse: expected void volatile [noderef] __iomem *addr
drivers/acpi/apei/einj-core.c:413:17: sparse: got struct acpi_einj_trigger *trigger_tab
drivers/acpi/apei/einj-core.c:414:21: sparse: sparse: incorrect type in assignment (different address spaces) @@ expected struct acpi_einj_trigger *trigger_tab @@ got void [noderef] __iomem * @@
drivers/acpi/apei/einj-core.c:414:21: sparse: expected struct acpi_einj_trigger *trigger_tab
drivers/acpi/apei/einj-core.c:414:21: sparse: got void [noderef] __iomem *
drivers/acpi/apei/einj-core.c:477:25: sparse: sparse: incorrect type in argument 1 (different address spaces) @@ expected void volatile [noderef] __iomem *addr @@ got struct acpi_einj_trigger *trigger_tab @@
drivers/acpi/apei/einj-core.c:477:25: sparse: expected void volatile [noderef] __iomem *addr
drivers/acpi/apei/einj-core.c:477:25: sparse: got struct acpi_einj_trigger *trigger_tab
drivers/acpi/apei/einj-core.c:983:37: sparse: sparse: incorrect type in argument 1 (different address spaces) @@ expected void [noderef] __iomem *virt @@ got void *static [assigned] [toplevel] einj_param @@
drivers/acpi/apei/einj-core.c:983:37: sparse: expected void [noderef] __iomem *virt
drivers/acpi/apei/einj-core.c:983:37: sparse: got void *static [assigned] [toplevel] einj_param
vim +306 drivers/acpi/apei/einj-core.c
272
273 static void *einj_get_parameter_address(void)
274 {
275 int i;
276 u64 pa_v4 = 0, pa_v5 = 0;
277 struct acpi_whea_header *entry;
278
279 entry = EINJ_TAB_ENTRY(einj_tab);
280 for (i = 0; i < einj_tab->entries; i++) {
281 if (entry->action == ACPI_EINJ_SET_ERROR_TYPE &&
282 entry->instruction == ACPI_EINJ_WRITE_REGISTER &&
283 entry->register_region.space_id ==
284 ACPI_ADR_SPACE_SYSTEM_MEMORY)
285 pa_v4 = get_unaligned(&entry->register_region.address);
286 if (entry->action == ACPI_EINJ_SET_ERROR_TYPE_WITH_ADDRESS &&
287 entry->instruction == ACPI_EINJ_WRITE_REGISTER &&
288 entry->register_region.space_id ==
289 ACPI_ADR_SPACE_SYSTEM_MEMORY)
290 pa_v5 = get_unaligned(&entry->register_region.address);
291 entry++;
292 }
293 if (pa_v5) {
294 struct set_error_type_with_address *v5param;
295
296 v5param = acpi_os_map_iomem(pa_v5, sizeof(*v5param));
297 if (v5param) {
298 int offset, len;
299
300 acpi5 = 1;
301 check_vendor_extension(pa_v5, v5param);
302 if (available_error_type & ACPI65_EINJV2_SUPP) {
303 len = v5param->einjv2_struct.length;
304 offset = offsetof(struct einjv2_extension_struct, component_arr);
305 nr_components = (len - offset) / 32;
> 306 acpi_os_unmap_iomem(v5param, sizeof(*v5param)); 307 v5param = acpi_os_map_iomem(pa_v5, sizeof(*v5param) + (
308 (nr_components) * sizeof(struct syndrome_array)));
309 }
310 return v5param;
311 }
312 }
313 if (param_extension && pa_v4) {
314 struct einj_parameter *v4param;
315
316 v4param = acpi_os_map_iomem(pa_v4, sizeof(*v4param));
317 if (!v4param)
318 return NULL;
319 if (v4param->reserved1 || v4param->reserved2) {
320 acpi_os_unmap_iomem(v4param, sizeof(*v4param));
321 return NULL;
322 }
323 return v4param;
324 }
325
326 return NULL;
327 }
328
Signature · 2 lines
0-DAY CI Kernel Test Service https://github.com/intel/lkp-tests/wiki
Re: [PATCH 7/8] ACPI: APEI: EINJ: Enable EINJv2 error injections
In reply to Zaid AlaliQuoted 54 lines · Zaid Alali
Enable the driver to inject EINJv2 type errors. The component array values are parsed from
user_inputand expected to contain hex values for component id and syndrome separated by space, and multiple components are separated by new line as follows:
component_id1component_syndrome1component_id2component_syndrome2
:component_id(n)component_syndrome(n)for example:
$comp_arr="0x1
0x2Quoted 2 lines
0x10x40x20x4"$cd
/sys/kernel/debug/apei/einj/
$echo "$comp_arr" >einjv2_component_arraySigned-off-by Zaid Alali <[email protected]>--- drivers/acpi/apei/einj-core.c | 76 +++++++++++++++++++++++++++++++++-- 1 file changed, 72 insertions(+), 4 deletions(-)drivers/acpi/apei/einj-core.c +9
-0@@ -87,6 +87,13 @@ enum {SETWA_FLAGS_APICID =1 ,SETWA_FLAGS_MEM =2 ,SETWA_FLAGS_PCIE_SBDF =4 , + SETWA_FLAGS_EINJV2 = 8, +}; + +enum { +EINJV2_PROCESSOR_ERROR =0x1 , +EINJV2_MEMORY_ERROR =0x2 , +EINJV2_PCIE_ERROR =0x4 , };/* @@ -111,6 +118,7 @@ static char vendor_dev[64];static struct debugfs_blob_wrapper einjv2_component_arr;static u64 component_count;static void *user_input; +static int nr_components;static u32 available_error_type;static u32 available_error_type_v2;@@ -287,8 +295,18 @@ static void *einj_get_parameter_address(void) v5param =acpi_os_map_iomem (pa_v5,sizeof (*v5param));if (v5param) { +int offset, len;
drivers/acpi/apei/einj-core.c static void *einj_get_parameter_address(void) · line 308
Quoted 10 lines
drivers/acpi/apei/einj-core.c +8
-0+ acpi5 =1 ;check_vendor_extension (pa_v5, v5param); +if (available_error_type &ACPI65_EINJV2_SUPP ) { + len = v5param->einjv2_struct.length; + offset = offsetof(struct einjv2_extension_struct , component_arr); + nr_components = (len - offset) /32 ; +acpi_os_unmap_iomem (v5param,sizeof (*v5param)); + v5param =acpi_os_map_iomem (pa_v5,sizeof (*v5param) + ( + (nr_components) *sizeof (struct syndrome_array )));
The way this line is broken up doesn't look quite right. That paren on the top line should get pulled on to the next line and aligned with the beginning of acpi_os_unmap_iomem. See below example.
Also, it's a little awkward here to map the v5param above just to unmap it here in the case of EINJv2. Is there a reason it needs to be done like this or can we do something like this instead?
if (available_error_type & ACPI65_EINJV2_SUPP) {
len = v5param->einjv2_struct.length;
offset = offsetof(struct einjv2_extension_struct, component_arr);
nr_components = (len - offset) / 32;
v5param = acpi_os_map_iomem(pa_v5, sizeof(*v5param) +
((nr_components) * sizeof(struct syndrome_array)));
else {
v5param = acpi_os_map_iomem(pa_v5, sizeof(*v5param));
}
if (v5param) {
acpi5 = 1;
check_vendor_extension(pa_v5, v5param);
return v5param;
}drivers/acpi/apei/einj-core.c static int __einj_error_inject(u32 type, u32 flags, u64 param1, u64 param2, · line 518
Quoted 12 lines
drivers/acpi/apei/einj-core.c +3
-2+ }return v5param; } }@@ -496,8 +514,49 @@ static int __einj_error_inject(u32 type, u32 flags, u64 param1, u64 param2, v5param->flags = flags; v5param->memory_address = param1; v5param->memory_address_range = param2; - v5param->apicid = param3; - v5param->pcie_sbdf = param4; + +if (flags &SETWA_FLAGS_EINJV2 ) {
IMO, moving this chunk inside the conditional here to a helper function would improve readability. As written, there are a couple too many levels of indentation.
drivers/acpi/apei/einj-core.c static int __einj_error_inject(u32 type, u32 flags, u64 param1, u64 param2, · line 529
Quoted 11 lines
drivers/acpi/apei/einj-core.c +11
-0+int count =0 , bytes_read, pos =0 ; +unsigned int comp, synd; +struct syndrome_array *component_arr; + +if (component_count > nr_components) + goto err_out; + + v5param->einjv2_struct.component_arr_count = component_count; + component_arr = v5param->einjv2_struct.component_arr; + + while (sscanf(user_input+pos, "%x %x\n%n", &comp, &synd,
Arithmetic operators should have a single space on each side:user_input + pos
drivers/acpi/apei/einj-core.c static int __einj_error_inject(u32 type, u32 flags, u64 param1, u64 param2, · line 530
Quoted 1 line
drivers/acpi/apei/einj-core.c +1
-0+ &bytes_read) == 2) {
Another alignment issue here. This would be nice to have aligned after the sscanf paren. Like:
while (sscanf(user_input+pos, "%x %x\n%n", &comp, &synd,
&bytes_read) == 2) {Thanks,
John
Quoted 71 lines
drivers/acpi/apei/einj-core.c +40
-2+ pos += bytes_read; +if (count > component_count) + goto err_out; + +switch (type) { +case EINJV2_PROCESSOR_ERROR : + component_arr[count].comp_id.acpi_id = comp; + component_arr[count].comp_synd.proc_synd = synd; +break ; +case EINJV2_MEMORY_ERROR : + component_arr[count].comp_id.device_id = comp; + component_arr[count].comp_synd.mem_synd = synd; +break ; +case EINJV2_PCIE_ERROR : + component_arr[count].comp_id.pcie_sbdf = comp; + component_arr[count].comp_synd.pcie_synd = synd; +break ; + } + count++; + } +if (count != component_count -1 ) + goto err_out; + +/* clear buffer after user input for next injection */ +memset (user_input,0 ,COMP_ARR_SIZE ); + }else { + v5param->apicid = param3; + v5param->pcie_sbdf = param4; + } }else {switch (type) {case ACPI_EINJ_PROCESSOR_CORRECTABLE :@@ -570,6 +629,9 @@ static int __einj_error_inject(u32 type, u32 flags, u64 param1, u64 param2, rc =apei_exec_run_optional (&ctx,ACPI_EINJ_END_OPERATION );return rc; +err_out: +memset (user_input,0 ,COMP_ARR_SIZE ); +return -EINVAL ; }/* Inject the specified hardware error */ @@ -581,9 +643,14 @@ int einj_error_inject(u32 type, u32 flags, u64 param1, u64 param2, u64 param3,/* If user manually set "flags", make sure it is legal */ if (flags && (flags & - ~(SETWA_FLAGS_APICID |SETWA_FLAGS_MEM |SETWA_FLAGS_PCIE_SBDF ))) + ~(SETWA_FLAGS_APICID |SETWA_FLAGS_MEM |SETWA_FLAGS_PCIE_SBDF |SETWA_FLAGS_EINJV2 )))return -EINVAL ; +/*check if type is a valid EINJv2 error type*/ +if (flags &SETWA_FLAGS_EINJV2 ) { +if (!(type & available_error_type_v2)) +return -EINVAL ; + }/* * We need extra sanity checks for memory errors. * Other types leap directly to injection. @@ -913,7 +980,8 @@ static void __exit einj_remove(struct platform_device *pdev) sizeof(struct set_error_type_with_address) :sizeof (struct einj_parameter ); -acpi_os_unmap_iomem (einj_param, size); +acpi_os_unmap_iomem (einj_param, + size + (nr_components *sizeof (struct syndrome_array )));if (vendor_errors.size)acpi_os_unmap_memory (vendor_errors.data, vendor_errors.size); }Signature · 1 line
2.34.1
PATCH 8/8 ACPI: APEI: EINJ: Update the documentation for EINJv2 support
In reply to Zaid AlaliAdd documentation for the updated ACPI specs for EINJv2(1)(2)
(1)https://bugzilla.tianocore.org/show_bug.cgi?id=4615 (2)https://bugzilla.tianocore.org/attachment.cgi?id=1446
--- .../firmware-guide/acpi/apei/einj.rst | 46 ++++++++++++++++++- 1 file changed, 44 insertions(+), 2 deletions(-)
Documentation/firmware-guide/acpi/apei/einj.rst +44 -2
@@ -61,6 +61,14 @@ The following files belong to it: 0x00000800 Platform Uncorrectable fatal ================ =================================== + ================ =================================== + Error Type Value Error Description + ================ =================================== + 0x00000001 EINJV2 Processor Error + 0x00000002 EINJV2 Memory Error + 0x00000004 EINJV2 PCI Express Error + ================ =================================== + The format of the file contents are as above, except present are only the available error types.
@@ -85,9 +93,11 @@ The following files belong to it: Bit 0 Processor APIC field valid (see param3 below). Bit 1 - Memory address and mask valid (param1 and param2). + Memory address and range valid (param1 and param2). Bit 2 PCIe (seg,bus,dev,fn) valid (see param4 below). + Bit 3 + EINJv2 extension structure is valid If set to zero, legacy behavior is mimicked where the type of injection specifies just one bit set, and param1 is multiplexed.
@@ -110,6 +120,7 @@ The following files belong to it: Used when the 0x1 bit is set in "flags" to specify the APIC id - param4 + Used when the 0x4 bit is set in "flags" to specify target PCIe device - notrigger
@@ -122,6 +133,18 @@ The following files belong to it: this actually works depends on what operations the BIOS actually includes in the trigger phase. +- einjv2_component_count + + The value from this file is used to set the "Component Array Count" + field of EINJv2 Extension Structure. + +- einjv2_component_array + + The contents of this file are used to set the "Component Array" field + of the EINJv2 Extension Structure. The expected format is hex values + for component id and syndrome separated by space, and multiple + components are separated by new line. + CXL error types are supported from ACPI 6.5 onwards (given a CXL port is present). The EINJ user interface for CXL error types is at <debugfs mount point>/cxl. The following files belong to it:
@@ -139,7 +162,6 @@ is present). The EINJ user interface for CXL error types is at under <debugfs mount point>/apei/einj, while CXL 1.1/1.0 port injections must use this file. - BIOS versions based on the ACPI 4.0 specification have limited options in controlling where the errors are injected. Your BIOS may support an extension (enabled with the param_extension=1 module parameter, or boot
@@ -194,6 +216,26 @@ An error injection example:: # echo 0x8 > error_type # Choose correctable memory error # echo 1 > error_inject # Inject now +An EINJv2 error injection example:: + + # cd /sys/kernel/debug/apei/einj + # cat available_error_type # See which errors can be injected + 0x00000002 Processor Uncorrectable non-fatal + 0x00000008 Memory Correctable + 0x00000010 Memory Uncorrectable non-fatal + 0x00000001 EINJV2 Processor Error + 0x00000002 EINJV2 Memory Error + + # echo 0x12345000 > param1 # Set memory address for injection + # echo 0xfffffffffffff000 > param2 # Range - anywhere in this page + # comp_arr="0x1 0x2 # Fill in the component array + >0x1 0x4 + >0x2 0x4" + # echo "$comp_arr" > einjv2_component_array + # echo 0x2 > error_type # Choose EINJv2 memory error + # echo 0xa > flags # set flags to indicate EINJv2 + # echo 1 > error_inject # Inject now + You should see something like this in dmesg:: [22715.830801] EDAC sbridge MC3: HANDLING MCE MEMORY ERROR
Signature · 1 line
2.34.1
Tony Luck
reviewerRe: [PATCH 8/8] ACPI: APEI: EINJ: Update the documentation for EINJv2 support
Quoted 15 lines · Zaid Alali
Add documentation for the updated ACPI specs for EINJv2(1)(2)
(1)https://bugzilla.tianocore.org/show_bug.cgi?id=4615 (2)https://bugzilla.tianocore.org/attachment.cgi?id=1446
Signed-off-by Zaid Alali <[email protected]>--- .../firmware-guide/acpi/apei/einj.rst | 46 ++++++++++++++++++- 1 file changed, 44 insertions(+), 2 deletions(-)Documentation/firmware-guide/acpi/apei/einj.rst +0
-0
Documentation/firmware-guide/acpi/apei/einj.rst The following files belong to it: · line 66
Quoted 6 lines
Documentation/firmware-guide/acpi/apei/einj.rst +3
-0@@ -61,6 +61,14 @@ The following files belong to it: 0x00000800 Platform Uncorrectable fatal ================ =================================== + ================ =================================== + Error Type Value Error Description + ================ ===================================
This shows up in the html output as a separate table with the same headers. Why not concatenate this to the existing table?
The example of EINJv2 shows these extra lines just appearing right after the v1 lines.
Quoted 59 lines
Documentation/firmware-guide/acpi/apei/einj.rst +21
-2+ 0x00000001 EINJV2 Processor Error + 0x00000002 EINJV2 Memory Error + 0x00000004 EINJV2 PCI Express Error + ================ =================================== + The format of the file contents are as above, except present are only the available error types.@@ -85,9 +93,11 @@ The following files belong to it: Bit 0 Processor APIC field valid (see param3 below). Bit 1 - Memory address and mask valid (param1 and param2). + Memory address and range valid (param1 and param2). Bit 2 PCIe (seg,bus,dev,fn) valid (see param4 below). + Bit 3 + EINJv2 extension structure is valid If set to zero, legacy behavior is mimicked where the type of injection specifies just one bit set, and param1 is multiplexed.@@ -110,6 +120,7 @@ The following files belong to it: Used when the 0x1 bit is set in "flags" to specify the APIC id - param4 + Used when the 0x4 bit is set in "flags" to specify target PCIe device - notrigger@@ -122,6 +133,18 @@ The following files belong to it: this actually works depends on what operations the BIOS actually includes in the trigger phase. +- einjv2_component_count + + The value from this file is used to set the "Component Array Count" + field of EINJv2 Extension Structure. + +- einjv2_component_array + + The contents of this file are used to set the "Component Array" field + of the EINJv2 Extension Structure. The expected format is hex values + for component id and syndrome separated by space, and multiple + components are separated by new line. + CXL error types are supported from ACPI 6.5 onwards (given a CXL port is present). The EINJ user interface for CXL error types is at <debugfs mount point>/cxl. The following files belong to it:@@ -139,7 +162,6 @@ is present). The EINJ user interface for CXL error types is at under <debugfs mount point>/apei/einj, while CXL 1.1/1.0 port injections must use this file. - BIOS versions based on the ACPI 4.0 specification have limited options in controlling where the errors are injected. Your BIOS may support an extension (enabled with the param_extension=1 module parameter, or boot@@ -194,6 +216,26 @@ An error injection example:: # echo 0x8 > error_type # Choose correctable memory error # echo 1 > error_inject # Inject now
Documentation/firmware-guide/acpi/apei/einj.rst An error injection example:: · line 227
Quoted 10 lines
Documentation/firmware-guide/acpi/apei/einj.rst +9
-0+An EINJv2 error injection example:: + + # cd /sys/kernel/debug/apei/einj + # cat available_error_type # See which errors can be injected + 0x00000002 Processor Uncorrectable non-fatal + 0x00000008 Memory Correctable + 0x00000010 Memory Uncorrectable non-fatal + 0x00000001 EINJV2 Processor Error + 0x00000002 EINJV2 Memory Error
This seems confusing to me. Is 0x00000002 the code for a V1 processor uncorrectable, or a V2 memory error? It seems that the "error_type" file is interpreted differently depending on what is written to the "flags" file.
Documentation/firmware-guide/acpi/apei/einj.rst An error injection example:: · line 233
Quoted 6 lines
Documentation/firmware-guide/acpi/apei/einj.rst +6
-0+ + # echo 0x12345000 > param1 # Set memory address for injection + # echo 0xfffffffffffff000 > param2 # Range - anywhere in this page + # comp_arr="0x1 0x2 # Fill in the component array + >0x1 0x4 + >0x2 0x4"
Default $PS2 prompt in bash doesn't have leading spaces before the ">". So this example looks unnatural to me.
Quoted 10 lines
Documentation/firmware-guide/acpi/apei/einj.rst +5
-0+ # echo "$comp_arr" > einjv2_component_array + # echo 0x2 > error_type # Choose EINJv2 memory error + # echo 0xa > flags # set flags to indicate EINJv2 + # echo 1 > error_inject # Inject now + You should see something like this in dmesg:: [22715.830801] EDAC sbridge MC3: HANDLING MCE MEMORY ERRORSignature · 1 line
2.34.1
-Tony
Tony Luck
reviewerRe: [PATCH 8/8] ACPI: APEI: EINJ: Update the documentation for EINJv2 support
Quoted 9 lines · Tony Luck
Documentation/firmware-guide/acpi/apei/einj.rst An error injection example:: · line 227
Quoted 7 lines · Zaid Alali
Documentation/firmware-guide/acpi/apei/einj.rst +7
-0+ # cd /sys/kernel/debug/apei/einj + # cat available_error_type # See which errors can be injected + 0x00000002 Processor Uncorrectable non-fatal + 0x00000008 Memory Correctable + 0x00000010 Memory Uncorrectable non-fatal + 0x00000001 EINJV2 Processor Error + 0x00000002 EINJV2 Memory Error
Quoted 4 lines
This seems confusing to me. Is
0x00000002the code for a V1 processor uncorrectable, or a V2 memory error? It seems that the "error_type" file is interpreted differently depending on what is written to the "flags" file.
Maybe the confusion would be removed if the "error_type" file is changed from using a hex number to using a string which the einj driver parses.
Hex values are parsed as before as legacy EINJ types. To specify a V2 EINJ type the user does:
# echo V2_0x2 > error_type
and EINJ driver then knows to treat the code as a V2 type (instead of using a bit written to the flags file).
For consistency the available_error_type would show the V2_ prefix
# cat available_error_type # See which errors can be injected 0x00000002 Processor Uncorrectable non-fatal 0x00000008 Memory Correctable 0x00000010 Memory Uncorrectable non-fatal V2_0x00000001 EINJV2 Processor Error V2_0x00000002 EINJV2 Memory Error
-Tony