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 <libcper/base64.h>
11 #include <libcper/Cper.h>
12 #include <libcper/cper-parse.h>
13 #include <libcper/cper-utils.h>
14 #include <libcper/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 json_object *ir = NULL;
160
161 //Find the correct section type, and parse.
162 int section_converted = 0;
163 for (size_t i = 0; i < section_definitions_len; i++) {
164 if (guid_equal(section_definitions[i].Guid,
165 &descriptor->SectionType) &&
166 section_definitions[i].ToCPER != NULL) {
167 ir = json_object_object_get(
168 section, section_definitions[i].ShortName);
169 section_definitions[i].ToCPER(ir, out);
170 section_converted = 1;
171 break;
172 }
173 }
174
175 //If unknown GUID, so read as a base64 unknown section.
176 if (!section_converted) {
177 ir = json_object_object_get(section, "Unknown");
178 json_object *encoded = json_object_object_get(ir, "data");
179
180 int32_t decoded_len = 0;
181
182 UINT8 *decoded = base64_decode(
183 json_object_get_string(encoded),
184 json_object_get_string_len(encoded), &decoded_len);
185 if (decoded == NULL) {
186 printf("Failed to allocate decode output buffer. \n");
187 } else {
188 fwrite(decoded, decoded_len, 1, out);
189 fflush(out);
190 free(decoded);
191 }
192 }
193 }
194
195 //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)196 void ir_section_descriptor_to_cper(json_object *section_descriptor_ir,
197 EFI_ERROR_SECTION_DESCRIPTOR *descriptor)
198 {
199 //Section offset, length.
200 descriptor->SectionOffset = (UINT32)json_object_get_uint64(
201 json_object_object_get(section_descriptor_ir, "sectionOffset"));
202 descriptor->SectionLength = (UINT32)json_object_get_uint64(
203 json_object_object_get(section_descriptor_ir, "sectionLength"));
204
205 //Revision.
206 json_object *revision =
207 json_object_object_get(section_descriptor_ir, "revision");
208 int minor =
209 json_object_get_int(json_object_object_get(revision, "minor"));
210 int major =
211 json_object_get_int(json_object_object_get(revision, "major"));
212 descriptor->Revision = minor + (major << 8);
213
214 //Validation bits, flags.
215 descriptor->SecValidMask = ir_to_bitfield(
216 json_object_object_get(section_descriptor_ir, "validationBits"),
217 2, CPER_SECTION_DESCRIPTOR_VALID_BITFIELD_NAMES);
218 descriptor->SectionFlags = ir_to_bitfield(
219 json_object_object_get(section_descriptor_ir, "flags"), 8,
220 CPER_SECTION_DESCRIPTOR_FLAGS_BITFIELD_NAMES);
221
222 //Section type.
223 json_object *section_type =
224 json_object_object_get(section_descriptor_ir, "sectionType");
225 string_to_guid(&descriptor->SectionType,
226 json_object_get_string(
227 json_object_object_get(section_type, "data")));
228
229 //FRU ID, if present.
230 json_object *fru_id =
231 json_object_object_get(section_descriptor_ir, "fruID");
232 if (fru_id != NULL) {
233 string_to_guid(&descriptor->FruId,
234 json_object_get_string(fru_id));
235 }
236
237 //Severity code.
238 json_object *severity =
239 json_object_object_get(section_descriptor_ir, "severity");
240 descriptor->Severity = (UINT32)json_object_get_uint64(
241 json_object_object_get(severity, "code"));
242
243 //FRU text, if present.
244 json_object *fru_text =
245 json_object_object_get(section_descriptor_ir, "fruText");
246 if (fru_text != NULL) {
247 strncpy(descriptor->FruString, json_object_get_string(fru_text),
248 sizeof(descriptor->FruString) - 1);
249 descriptor->FruString[sizeof(descriptor->FruString) - 1] = '\0';
250 }
251 }
252
253 //Converts IR for a given single section format CPER record into CPER binary.
ir_single_section_to_cper(json_object * ir,FILE * out)254 void ir_single_section_to_cper(json_object *ir, FILE *out)
255 {
256 //Create & write a section descriptor to file.
257 EFI_ERROR_SECTION_DESCRIPTOR *section_descriptor =
258 (EFI_ERROR_SECTION_DESCRIPTOR *)calloc(
259 1, sizeof(EFI_ERROR_SECTION_DESCRIPTOR));
260 ir_section_descriptor_to_cper(
261 json_object_object_get(ir, "sectionDescriptor"),
262 section_descriptor);
263 fwrite(section_descriptor, sizeof(EFI_ERROR_SECTION_DESCRIPTOR), 1,
264 out);
265 fflush(out);
266
267 //Write section to file.
268 ir_section_to_cper(json_object_object_get(ir, "section"),
269 section_descriptor, out);
270
271 //Free remaining resources.
272 free(section_descriptor);
273 }
274