1 /* SPDX-License-Identifier: GPL-2.0 */ 2 /* 3 * apei-internal.h - ACPI Platform Error Interface internal 4 * definitions. 5 */ 6 7 #ifndef APEI_INTERNAL_H 8 #define APEI_INTERNAL_H 9 10 #include <linux/acpi.h> 11 12 struct apei_exec_context; 13 14 typedef int (*apei_exec_ins_func_t)(struct apei_exec_context *ctx, 15 struct acpi_whea_header *entry); 16 17 #define APEI_EXEC_INS_ACCESS_REGISTER 0x0001 18 19 struct apei_exec_ins_type { 20 u32 flags; 21 apei_exec_ins_func_t run; 22 }; 23 24 struct apei_exec_context { 25 u32 ip; 26 u64 value; 27 u64 var1; 28 u64 var2; 29 u64 src_base; 30 u64 dst_base; 31 struct apei_exec_ins_type *ins_table; 32 u32 instructions; 33 struct acpi_whea_header *action_table; 34 u32 entries; 35 }; 36 37 void apei_exec_ctx_init(struct apei_exec_context *ctx, 38 struct apei_exec_ins_type *ins_table, 39 u32 instructions, 40 struct acpi_whea_header *action_table, 41 u32 entries); 42 43 static inline void apei_exec_ctx_set_input(struct apei_exec_context *ctx, 44 u64 input) 45 { 46 ctx->value = input; 47 } 48 49 static inline u64 apei_exec_ctx_get_output(struct apei_exec_context *ctx) 50 { 51 return ctx->value; 52 } 53 54 int __apei_exec_run(struct apei_exec_context *ctx, u8 action, bool optional); 55 56 static inline int apei_exec_run(struct apei_exec_context *ctx, u8 action) 57 { 58 return __apei_exec_run(ctx, action, 0); 59 } 60 61 /* It is optional whether the firmware provides the action */ 62 static inline int apei_exec_run_optional(struct apei_exec_context *ctx, u8 action) 63 { 64 return __apei_exec_run(ctx, action, 1); 65 } 66 67 /* Common instruction implementation */ 68 69 /* IP has been set in instruction function */ 70 #define APEI_EXEC_SET_IP 1 71 72 int apei_map_generic_address(struct acpi_generic_address *reg); 73 74 static inline void apei_unmap_generic_address(struct acpi_generic_address *reg) 75 { 76 acpi_os_unmap_generic_address(reg); 77 } 78 79 int apei_read(u64 *val, struct acpi_generic_address *reg); 80 int apei_write(u64 val, struct acpi_generic_address *reg); 81 82 int __apei_exec_read_register(struct acpi_whea_header *entry, u64 *val); 83 int __apei_exec_write_register(struct acpi_whea_header *entry, u64 val); 84 int apei_exec_read_register(struct apei_exec_context *ctx, 85 struct acpi_whea_header *entry); 86 int apei_exec_read_register_value(struct apei_exec_context *ctx, 87 struct acpi_whea_header *entry); 88 int apei_exec_write_register(struct apei_exec_context *ctx, 89 struct acpi_whea_header *entry); 90 int apei_exec_write_register_value(struct apei_exec_context *ctx, 91 struct acpi_whea_header *entry); 92 int apei_exec_noop(struct apei_exec_context *ctx, 93 struct acpi_whea_header *entry); 94 int apei_exec_pre_map_gars(struct apei_exec_context *ctx); 95 int apei_exec_post_unmap_gars(struct apei_exec_context *ctx); 96 97 struct apei_resources { 98 struct list_head iomem; 99 struct list_head ioport; 100 }; 101 102 static inline void apei_resources_init(struct apei_resources *resources) 103 { 104 INIT_LIST_HEAD(&resources->iomem); 105 INIT_LIST_HEAD(&resources->ioport); 106 } 107 108 void apei_resources_fini(struct apei_resources *resources); 109 int apei_resources_add(struct apei_resources *resources, 110 unsigned long start, unsigned long size, 111 bool iomem); 112 int apei_resources_sub(struct apei_resources *resources1, 113 struct apei_resources *resources2); 114 int apei_resources_request(struct apei_resources *resources, 115 const char *desc); 116 void apei_resources_release(struct apei_resources *resources); 117 int apei_exec_collect_resources(struct apei_exec_context *ctx, 118 struct apei_resources *resources); 119 120 struct dentry; 121 struct dentry *apei_get_debugfs_dir(void); 122 123 static inline u32 cper_estatus_len(struct acpi_hest_generic_status *estatus) 124 { 125 if (estatus->raw_data_length) 126 return estatus->raw_data_offset + \ 127 estatus->raw_data_length; 128 else 129 return sizeof(*estatus) + estatus->data_length; 130 } 131 132 int apei_osc_setup(void); 133 #endif 134