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. 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. 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. 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. 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. 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