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