1 /**
2 * Describes functions for parsing JSON IR CPER data into binary CPER format.
3 *
4 * Author: Lawrence.Tang@arm.com
5 **/
6
7 #include <stdio.h>
8 #include <string.h>
9 #include <json.h>
10 #include "base64.h"
11 #include "edk/Cper.h"
12 #include "cper-parse.h"
13 #include "cper-utils.h"
14 #include "sections/cper-section.h"
15
16 //Private pre-declarations.
17 void ir_header_to_cper(json_object *header_ir,
18 EFI_COMMON_ERROR_RECORD_HEADER *header);
19 void ir_section_descriptor_to_cper(json_object *section_descriptor_ir,
20 EFI_ERROR_SECTION_DESCRIPTOR *descriptor);
21 void ir_section_to_cper(json_object *section,
22 EFI_ERROR_SECTION_DESCRIPTOR *descriptor, FILE *out);
23
24 //Converts the given JSON IR CPER representation into CPER binary format, piped to the provided file stream.
25 //This function performs no validation of the IR against the CPER-JSON specification. To ensure a safe call,
26 //use validate_schema() from json-schema.h before attempting to call this function.
ir_to_cper(json_object * ir,FILE * out)27 void ir_to_cper(json_object *ir, FILE *out)
28 {
29 //Create the CPER header.
30 EFI_COMMON_ERROR_RECORD_HEADER *header =
31 (EFI_COMMON_ERROR_RECORD_HEADER *)calloc(
32 1, sizeof(EFI_COMMON_ERROR_RECORD_HEADER));
33 ir_header_to_cper(json_object_object_get(ir, "header"), header);
34 fwrite(header, sizeof(EFI_COMMON_ERROR_RECORD_HEADER), 1, out);
35 fflush(out);
36
37 //Create the CPER section descriptors.
38 json_object *section_descriptors =
39 json_object_object_get(ir, "sectionDescriptors");
40 int amt_descriptors = json_object_array_length(section_descriptors);
41 EFI_ERROR_SECTION_DESCRIPTOR *descriptors[amt_descriptors];
42 for (int i = 0; i < amt_descriptors; i++) {
43 descriptors[i] = (EFI_ERROR_SECTION_DESCRIPTOR *)calloc(
44 1, sizeof(EFI_ERROR_SECTION_DESCRIPTOR));
45 ir_section_descriptor_to_cper(
46 json_object_array_get_idx(section_descriptors, i),
47 descriptors[i]);
48 fwrite(descriptors[i], sizeof(EFI_ERROR_SECTION_DESCRIPTOR), 1,
49 out);
50 fflush(out);
51 }
52
53 //Run through each section in turn.
54 json_object *sections = json_object_object_get(ir, "sections");
55 int amt_sections = json_object_array_length(sections);
56 if (amt_sections == amt_descriptors) {
57 for (int i = 0; i < amt_sections; i++) {
58 //Get the section itself from the IR.
59 json_object *section =
60 json_object_array_get_idx(sections, i);
61
62 //Convert.
63 ir_section_to_cper(section, descriptors[i], out);
64 }
65 }
66
67 //Free all remaining resources.
68 free(header);
69 for (int i = 0; i < amt_descriptors; i++) {
70 free(descriptors[i]);
71 }
72 }
73
74 //Converts a CPER-JSON IR header to a CPER header structure.
ir_header_to_cper(json_object * header_ir,EFI_COMMON_ERROR_RECORD_HEADER * header)75 void ir_header_to_cper(json_object *header_ir,
76 EFI_COMMON_ERROR_RECORD_HEADER *header)
77 {
78 header->SignatureStart = 0x52455043; //CPER
79
80 //Revision.
81 json_object *revision = json_object_object_get(header_ir, "revision");
82 int minor =
83 json_object_get_int(json_object_object_get(revision, "minor"));
84 int major =
85 json_object_get_int(json_object_object_get(revision, "major"));
86 header->Revision = minor + (major << 8);
87
88 header->SignatureEnd = 0xFFFFFFFF;
89
90 //Section count.
91 int section_count = json_object_get_int(
92 json_object_object_get(header_ir, "sectionCount"));
93 header->SectionCount = (UINT16)section_count;
94
95 //Error severity.
96 json_object *severity = json_object_object_get(header_ir, "severity");
97 header->ErrorSeverity = (UINT32)json_object_get_uint64(
98 json_object_object_get(severity, "code"));
99
100 //Validation bits.
101 header->ValidationBits = ir_to_bitfield(
102 json_object_object_get(header_ir, "validationBits"), 3,
103 CPER_HEADER_VALID_BITFIELD_NAMES);
104
105 //Record length.
106 header->RecordLength = (UINT32)json_object_get_uint64(
107 json_object_object_get(header_ir, "recordLength"));
108
109 //Timestamp, if present.
110 json_object *timestamp = json_object_object_get(header_ir, "timestamp");
111 if (timestamp != NULL) {
112 string_to_timestamp(&header->TimeStamp,
113 json_object_get_string(timestamp));
114 header->TimeStamp.Flag = json_object_get_boolean(
115 json_object_object_get(header_ir,
116 "timestampIsPrecise"));
117 }
118
119 //Various GUIDs.
120 json_object *platform_id =
121 json_object_object_get(header_ir, "platformID");
122 json_object *partition_id =
123 json_object_object_get(header_ir, "partitionID");
124 if (platform_id != NULL) {
125 string_to_guid(&header->PlatformID,
126 json_object_get_string(platform_id));
127 }
128 if (partition_id != NULL) {
129 string_to_guid(&header->PartitionID,
130 json_object_get_string(partition_id));
131 }
132 string_to_guid(&header->CreatorID,
133 json_object_get_string(
134 json_object_object_get(header_ir, "creatorID")));
135
136 //Notification type.
137 json_object *notification_type =
138 json_object_object_get(header_ir, "notificationType");
139 string_to_guid(&header->NotificationType,
140 json_object_get_string(json_object_object_get(
141 notification_type, "guid")));
142
143 //Record ID, persistence info.
144 header->RecordID = json_object_get_uint64(
145 json_object_object_get(header_ir, "recordID"));
146 header->PersistenceInfo = json_object_get_uint64(
147 json_object_object_get(header_ir, "persistenceInfo"));
148
149 //Flags.
150 json_object *flags = json_object_object_get(header_ir, "flags");
151 header->Flags = (UINT32)json_object_get_uint64(
152 json_object_object_get(flags, "value"));
153 }
154
155 //Converts a single given IR section into CPER, outputting to the given stream.
ir_section_to_cper(json_object * section,EFI_ERROR_SECTION_DESCRIPTOR * descriptor,FILE * out)156 void ir_section_to_cper(json_object *section,
157 EFI_ERROR_SECTION_DESCRIPTOR *descriptor, FILE *out)
158 {
159 //Find the correct section type, and parse.
160 int section_converted = 0;
161 for (size_t i = 0; i < section_definitions_len; i++) {
162 if (guid_equal(section_definitions[i].Guid,
163 &descriptor->SectionType) &&
164 section_definitions[i].ToCPER != NULL) {
165 section_definitions[i].ToCPER(section, out);
166 section_converted = 1;
167 break;
168 }
169 }
170
171 //If unknown GUID, so read as a base64 unknown section.
172 if (!section_converted) {
173 json_object *encoded = json_object_object_get(section, "data");
174
175 int32_t decoded_len = 0;
176
177 UINT8 *decoded = base64_decode(
178 json_object_get_string(encoded),
179 json_object_get_string_len(encoded), &decoded_len);
180 if (decoded == NULL) {
181 printf("Failed to allocate decode output buffer. \n");
182 } else {
183 fwrite(decoded, decoded_len, 1, out);
184 fflush(out);
185 free(decoded);
186 }
187 }
188 }
189
190 //Converts a single CPER-JSON IR section descriptor into a CPER structure.
ir_section_descriptor_to_cper(json_object * section_descriptor_ir,EFI_ERROR_SECTION_DESCRIPTOR * descriptor)191 void ir_section_descriptor_to_cper(json_object *section_descriptor_ir,
192 EFI_ERROR_SECTION_DESCRIPTOR *descriptor)
193 {
194 //Section offset, length.
195 descriptor->SectionOffset = (UINT32)json_object_get_uint64(
196 json_object_object_get(section_descriptor_ir, "sectionOffset"));
197 descriptor->SectionLength = (UINT32)json_object_get_uint64(
198 json_object_object_get(section_descriptor_ir, "sectionLength"));
199
200 //Revision.
201 json_object *revision =
202 json_object_object_get(section_descriptor_ir, "revision");
203 int minor =
204 json_object_get_int(json_object_object_get(revision, "minor"));
205 int major =
206 json_object_get_int(json_object_object_get(revision, "major"));
207 descriptor->Revision = minor + (major << 8);
208
209 //Validation bits, flags.
210 descriptor->SecValidMask = ir_to_bitfield(
211 json_object_object_get(section_descriptor_ir, "validationBits"),
212 2, CPER_SECTION_DESCRIPTOR_VALID_BITFIELD_NAMES);
213 descriptor->SectionFlags = ir_to_bitfield(
214 json_object_object_get(section_descriptor_ir, "flags"), 8,
215 CPER_SECTION_DESCRIPTOR_FLAGS_BITFIELD_NAMES);
216
217 //Section type.
218 json_object *section_type =
219 json_object_object_get(section_descriptor_ir, "sectionType");
220 string_to_guid(&descriptor->SectionType,
221 json_object_get_string(
222 json_object_object_get(section_type, "data")));
223
224 //FRU ID, if present.
225 json_object *fru_id =
226 json_object_object_get(section_descriptor_ir, "fruID");
227 if (fru_id != NULL) {
228 string_to_guid(&descriptor->FruId,
229 json_object_get_string(fru_id));
230 }
231
232 //Severity code.
233 json_object *severity =
234 json_object_object_get(section_descriptor_ir, "severity");
235 descriptor->Severity = (UINT32)json_object_get_uint64(
236 json_object_object_get(severity, "code"));
237
238 //FRU text, if present.
239 json_object *fru_text =
240 json_object_object_get(section_descriptor_ir, "fruText");
241 if (fru_text != NULL) {
242 strncpy(descriptor->FruString, json_object_get_string(fru_text),
243 sizeof(descriptor->FruString) - 1);
244 descriptor->FruString[sizeof(descriptor->FruString) - 1] = '\0';
245 }
246 }
247
248 //Converts IR for a given single section format CPER record into CPER binary.
ir_single_section_to_cper(json_object * ir,FILE * out)249 void ir_single_section_to_cper(json_object *ir, FILE *out)
250 {
251 //Create & write a section descriptor to file.
252 EFI_ERROR_SECTION_DESCRIPTOR *section_descriptor =
253 (EFI_ERROR_SECTION_DESCRIPTOR *)calloc(
254 1, sizeof(EFI_ERROR_SECTION_DESCRIPTOR));
255 ir_section_descriptor_to_cper(
256 json_object_object_get(ir, "sectionDescriptor"),
257 section_descriptor);
258 fwrite(section_descriptor, sizeof(EFI_ERROR_SECTION_DESCRIPTOR), 1,
259 out);
260 fflush(out);
261
262 //Write section to file.
263 ir_section_to_cper(json_object_object_get(ir, "section"),
264 section_descriptor, out);
265
266 //Free remaining resources.
267 free(section_descriptor);
268 }
269