54  * @data: pointer to private data
58  * Verify that the firmware data can hold a chunk of bytes with the specified
65 pldm_check_fw_space(struct pldmfw_priv *data, size_t offset, size_t length)  in pldm_check_fw_space()  argument
68 	struct device *dev = data->context->dev;  in pldm_check_fw_space()
70 	if (data->fw->size < expected_size) {  in pldm_check_fw_space()
72 			data->fw->size, expected_size);  in pldm_check_fw_space()
81  * @data: pointer to private data
91 pldm_move_fw_offset(struct pldmfw_priv *data, size_t bytes_to_move)  in pldm_move_fw_offset()  argument
95 	err = pldm_check_fw_space(data, data->offset, bytes_to_move);  in pldm_move_fw_offset()
99 	data->offset += bytes_to_move;  in pldm_move_fw_offset()
106  * @data: pointer to private data
123 static int pldm_parse_header(struct pldmfw_priv *data)  in pldm_parse_header()  argument
126 	struct device *dev = data->context->dev;  in pldm_parse_header()
131 	err = pldm_move_fw_offset(data, sizeof(*header));  in pldm_parse_header()
135 	header = (const struct __pldm_header *)data->fw->data;  in pldm_parse_header()
136 	data->header = header;  in pldm_parse_header()
150 	data->total_header_size = get_unaligned_le16(&header->size);  in pldm_parse_header()
151 	header_size = data->total_header_size - sizeof(*header);  in pldm_parse_header()
153 	err = pldm_check_fw_space(data, data->offset, header_size);  in pldm_parse_header()
157 	data->component_bitmap_len =  in pldm_parse_header()
160 	if (data->component_bitmap_len % 8 != 0) {  in pldm_parse_header()
162 			data->component_bitmap_len);  in pldm_parse_header()
166 	data->bitmap_size = data->component_bitmap_len / 8;  in pldm_parse_header()
168 	err = pldm_move_fw_offset(data, header->version_len);  in pldm_parse_header()
173 	 * PLDM header data.  in pldm_parse_header()
175 	record_area = (const struct __pldmfw_record_area *)(data->fw->data +  in pldm_parse_header()
176 							 data->offset);  in pldm_parse_header()
178 	err = pldm_move_fw_offset(data, sizeof(*record_area));  in pldm_parse_header()
182 	data->record_count = record_area->record_count;  in pldm_parse_header()
183 	data->record_start = record_area->records;  in pldm_parse_header()
190  * @data: pointer to image details
203 pldm_check_desc_tlv_len(struct pldmfw_priv *data, u16 type, u16 size)  in pldm_check_desc_tlv_len()  argument
205 	struct device *dev = data->context->dev;  in pldm_check_desc_tlv_len()
249  * @data: pointer to private data
259 pldm_parse_desc_tlvs(struct pldmfw_priv *data, struct pldmfw_record *record, u8 desc_count)  in pldm_parse_desc_tlvs()  argument
265 	desc_start = data->fw->data + data->offset;  in pldm_parse_desc_tlvs()
272 		err = pldm_move_fw_offset(data, sizeof(*__desc));  in pldm_parse_desc_tlvs()
278 		/* According to DSP0267, this only includes the data field */  in pldm_parse_desc_tlvs()
281 		err = pldm_check_desc_tlv_len(data, type, size);  in pldm_parse_desc_tlvs()
286 		err = pldm_move_fw_offset(data, size);  in pldm_parse_desc_tlvs()
296 		desc->data = __desc->data;  in pldm_parse_desc_tlvs()
306  * @data: pointer to image details
315  * descriptor TLVs, and the length of the package data.
320 pldm_parse_one_record(struct pldmfw_priv *data,  in pldm_parse_one_record()  argument
336 	list_add_tail(&record->entry, &data->records);  in pldm_parse_one_record()
339 	err = pldm_move_fw_offset(data, sizeof(*__record));  in pldm_parse_one_record()
348 	bitmap_ptr = data->fw->data + data->offset;  in pldm_parse_one_record()
351 	err = pldm_move_fw_offset(data, data->bitmap_size);  in pldm_parse_one_record()
355 	record->component_bitmap_len = data->component_bitmap_len;  in pldm_parse_one_record()
361 	for (i = 0; i < data->bitmap_size; i++)  in pldm_parse_one_record()
364 	record->version_string = data->fw->data + data->offset;  in pldm_parse_one_record()
366 	err = pldm_move_fw_offset(data, record->version_len);  in pldm_parse_one_record()
371 	err = pldm_parse_desc_tlvs(data, record, __record->descriptor_count);  in pldm_parse_one_record()
375 	record->package_data = data->fw->data + data->offset;  in pldm_parse_one_record()
377 	err = pldm_move_fw_offset(data, record->package_data_len);  in pldm_parse_one_record()
381 	measured_length = data->offset - ((const u8 *)__record - data->fw->data);  in pldm_parse_one_record()
383 …dev_dbg(data->context->dev, "Unexpected record length. Measured record length is %zu bytes, expect…  in pldm_parse_one_record()
393  * @data: pointer to private data
400 static int pldm_parse_records(struct pldmfw_priv *data)  in pldm_parse_records()  argument
407 	pldm_for_each_record(i, record, data->record_start, data->record_count) {  in pldm_parse_records()
408 		err = pldm_parse_one_record(data, record);  in pldm_parse_records()
414 	 * PLDM device record data.  in pldm_parse_records()
416 	component_area = (const struct __pldmfw_component_area *)(data->fw->data + data->offset);  in pldm_parse_records()
418 	err = pldm_move_fw_offset(data, sizeof(*component_area));  in pldm_parse_records()
422 	data->component_count =  in pldm_parse_records()
424 	data->component_start = component_area->components;  in pldm_parse_records()
431  * @data: pointer to private data
441 static int pldm_parse_components(struct pldmfw_priv *data)  in pldm_parse_components()  argument
444 	struct device *dev = data->context->dev;  in pldm_parse_components()
449 	pldm_for_each_component(i, __component, data->component_start, data->component_count) {  in pldm_parse_components()
453 		err = pldm_move_fw_offset(data, sizeof(*__component));  in pldm_parse_components()
457 		err = pldm_move_fw_offset(data, __component->version_len);  in pldm_parse_components()
464 		err = pldm_check_fw_space(data, offset, size);  in pldm_parse_components()
481 		component->component_data = data->fw->data + offset;  in pldm_parse_components()
484 		if (data->context->mode == PLDMFW_UPDATE_MODE_SINGLE_COMPONENT &&  in pldm_parse_components()
485 		    data->context->component_identifier != component->identifier)  in pldm_parse_components()
488 		list_add_tail(&component->entry, &data->components);  in pldm_parse_components()
491 	if (data->context->mode == PLDMFW_UPDATE_MODE_SINGLE_COMPONENT &&  in pldm_parse_components()
492 	    list_empty(&data->components))  in pldm_parse_components()
495 	header_crc_ptr = data->fw->data + data->offset;  in pldm_parse_components()
497 	err = pldm_move_fw_offset(data, sizeof(data->header_crc));  in pldm_parse_components()
502 	if (data->offset != data->total_header_size) {  in pldm_parse_components()
504 			data->total_header_size, data->offset);  in pldm_parse_components()
508 	data->header_crc = get_unaligned_le32(header_crc_ptr);  in pldm_parse_components()
515  * @data: pointer to private data
522 static int pldm_verify_header_crc(struct pldmfw_priv *data)  in pldm_verify_header_crc()  argument
524 	struct device *dev = data->context->dev;  in pldm_verify_header_crc()
532 	length = data->offset - sizeof(data->header_crc);  in pldm_verify_header_crc()
533 	calculated_crc = crc32_le(~0, data->fw->data, length) ^ ~0;  in pldm_verify_header_crc()
535 	if (calculated_crc != data->header_crc) {  in pldm_verify_header_crc()
537 			calculated_crc, data->header_crc);  in pldm_verify_header_crc()
546  * @data: pointer to the PLDM data structure
551 static void pldmfw_free_priv(struct pldmfw_priv *data)  in pldmfw_free_priv()  argument
557 	list_for_each_entry_safe(component, c_safe, &data->components, entry) {  in pldmfw_free_priv()
562 	list_for_each_entry_safe(record, r_safe, &data->records, entry) {  in pldmfw_free_priv()
580  * @data: pointer to private data
582  * Verify that the firmware file contains valid data for a PLDM firmware
583  * file. Extract useful pointers and data from the firmware file and store
584  * them in the data structure.
587  * should be taken to use get_unaligned_le* when accessing data from the
588  * pointers in data.
592 static int pldm_parse_image(struct pldmfw_priv *data)  in pldm_parse_image()  argument
596 	if (WARN_ON(!(data->context->dev && data->fw->data && data->fw->size)))  in pldm_parse_image()
599 	err = pldm_parse_header(data);  in pldm_parse_image()
603 	err = pldm_parse_records(data);  in pldm_parse_image()
607 	err = pldm_parse_components(data);  in pldm_parse_image()
611 	return pldm_verify_header_crc(data);  in pldm_parse_image()
628  * data provided.
630  * Searches the descriptor TLVs and extracts the relevant descriptor data into
669 		value = get_unaligned_le16(desc->data);  in pldmfw_op_pci_match_record()
693  * @data: pointer to private data
702 static int pldm_find_matching_record(struct pldmfw_priv *data)  in pldm_find_matching_record()  argument
706 	list_for_each_entry(record, &data->records, entry) {  in pldm_find_matching_record()
707 		if (data->context->ops->match_record(data->context, record)) {  in pldm_find_matching_record()
708 			data->matching_record = record;  in pldm_find_matching_record()
717  * pldm_send_package_data - Send firmware the package data for the record
718  * @data: pointer to private data
720  * Send the package data associated with the matching record to the firmware,
726 pldm_send_package_data(struct pldmfw_priv *data)  in pldm_send_package_data()  argument
728 	struct pldmfw_record *record = data->matching_record;  in pldm_send_package_data()
729 	const struct pldmfw_ops *ops = data->context->ops;  in pldm_send_package_data()
731 	return ops->send_package_data(data->context, record->package_data,  in pldm_send_package_data()
737  * @data: pointer to private data
745 pldm_send_component_tables(struct pldmfw_priv *data)  in pldm_send_component_tables()  argument
747 	unsigned long *bitmap = data->matching_record->component_bitmap;  in pldm_send_component_tables()
751 	list_for_each_entry(component, &data->components, entry) {  in pldm_send_component_tables()
761 		if (index == find_first_bit(bitmap, data->component_bitmap_len))  in pldm_send_component_tables()
763 		if (index == find_last_bit(bitmap, data->component_bitmap_len))  in pldm_send_component_tables()
768 		err = data->context->ops->send_component_table(data->context,  in pldm_send_component_tables()
780  * @data: pointer to private data
787 static int pldm_flash_components(struct pldmfw_priv *data)  in pldm_flash_components()  argument
789 	unsigned long *bitmap = data->matching_record->component_bitmap;  in pldm_flash_components()
793 	list_for_each_entry(component, &data->components, entry) {  in pldm_flash_components()
800 		err = data->context->ops->flash_component(data->context, component);  in pldm_flash_components()
810  * @data: pointer to private data
818 static int pldm_finalize_update(struct pldmfw_priv *data)  in pldm_finalize_update()  argument
820 	if (data->context->ops->finalize_update)  in pldm_finalize_update()
821 		return data->context->ops->finalize_update(data->context);  in pldm_finalize_update()
828  * @context: ops and data for firmware update
831  * Parse the data for a given firmware file, verifying that it is a valid PLDM
834  * Extract the device record Package Data and Component Tables and send them
835  * to the device firmware. Extract and write the flash data for each of the
842 	struct pldmfw_priv *data;  in pldmfw_flash_image()  local
845 	data = kzalloc(sizeof(*data), GFP_KERNEL);  in pldmfw_flash_image()
846 	if (!data)  in pldmfw_flash_image()
849 	INIT_LIST_HEAD(&data->records);  in pldmfw_flash_image()
850 	INIT_LIST_HEAD(&data->components);  in pldmfw_flash_image()
852 	data->fw = fw;  in pldmfw_flash_image()
853 	data->context = context;  in pldmfw_flash_image()
855 	err = pldm_parse_image(data);  in pldmfw_flash_image()
859 	err = pldm_find_matching_record(data);  in pldmfw_flash_image()
863 	err = pldm_send_package_data(data);  in pldmfw_flash_image()
867 	err = pldm_send_component_tables(data);  in pldmfw_flash_image()
871 	err = pldm_flash_components(data);  in pldmfw_flash_image()
875 	err = pldm_finalize_update(data);  in pldmfw_flash_image()
878 	pldmfw_free_priv(data);  in pldmfw_flash_image()
879 	kfree(data);  in pldmfw_flash_image()