/* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */ /* * Platform Firmware Runtime Update header * * Copyright(c) 2021 Intel Corporation. All rights reserved. */ #ifndef __PFRUT_H__ #define __PFRUT_H__ #include <linux/ioctl.h> #include <linux/types.h> #define PFRUT_IOCTL_MAGIC … /** * PFRU_IOC_SET_REV - _IOW(PFRUT_IOCTL_MAGIC, 0x01, unsigned int) * * Return: * * 0 - success * * -EFAULT - fail to read the revision id * * -EINVAL - user provides an invalid revision id * * Set the Revision ID for Platform Firmware Runtime Update. */ #define PFRU_IOC_SET_REV … /** * PFRU_IOC_STAGE - _IOW(PFRUT_IOCTL_MAGIC, 0x02, unsigned int) * * Return: * * 0 - success * * -EINVAL - stage phase returns invalid result * * Stage a capsule image from communication buffer and perform authentication. */ #define PFRU_IOC_STAGE … /** * PFRU_IOC_ACTIVATE - _IOW(PFRUT_IOCTL_MAGIC, 0x03, unsigned int) * * Return: * * 0 - success * * -EINVAL - activate phase returns invalid result * * Activate a previously staged capsule image. */ #define PFRU_IOC_ACTIVATE … /** * PFRU_IOC_STAGE_ACTIVATE - _IOW(PFRUT_IOCTL_MAGIC, 0x04, unsigned int) * * Return: * * 0 - success * * -EINVAL - stage/activate phase returns invalid result. * * Perform both stage and activation action. */ #define PFRU_IOC_STAGE_ACTIVATE … /** * PFRU_IOC_QUERY_CAP - _IOR(PFRUT_IOCTL_MAGIC, 0x05, * struct pfru_update_cap_info) * * Return: * * 0 - success * * -EINVAL - query phase returns invalid result * * -EFAULT - the result fails to be copied to userspace * * Retrieve information on the Platform Firmware Runtime Update capability. * The information is a struct pfru_update_cap_info. */ #define PFRU_IOC_QUERY_CAP … /** * struct pfru_payload_hdr - Capsule file payload header. * * @sig: Signature of this capsule file. * @hdr_version: Revision of this header structure. * @hdr_size: Size of this header, including the OemHeader bytes. * @hw_ver: The supported firmware version. * @rt_ver: Version of the code injection image. * @platform_id: A platform specific GUID to specify the platform what * this capsule image support. */ struct pfru_payload_hdr { … }; enum pfru_dsm_status { … }; /** * struct pfru_update_cap_info - Runtime update capability information. * * @status: Indicator of whether this query succeed. * @update_cap: Bitmap to indicate whether the feature is supported. * @code_type: A buffer containing an image type GUID. * @fw_version: Platform firmware version. * @code_rt_version: Code injection runtime version for anti-rollback. * @drv_type: A buffer containing an image type GUID. * @drv_rt_version: The version of the driver update runtime code. * @drv_svn: The secure version number(SVN) of the driver update runtime code. * @platform_id: A buffer containing a platform ID GUID. * @oem_id: A buffer containing an OEM ID GUID. * @oem_info_len: Length of the buffer containing the vendor specific information. */ struct pfru_update_cap_info { … }; /** * struct pfru_com_buf_info - Communication buffer information. * * @status: Indicator of whether this query succeed. * @ext_status: Implementation specific query result. * @addr_lo: Low 32bit physical address of the communication buffer to hold * a runtime update package. * @addr_hi: High 32bit physical address of the communication buffer to hold * a runtime update package. * @buf_size: Maximum size in bytes of the communication buffer. */ struct pfru_com_buf_info { … }; /** * struct pfru_updated_result - Platform firmware runtime update result information. * @status: Indicator of whether this update succeed. * @ext_status: Implementation specific update result. * @low_auth_time: Low 32bit value of image authentication time in nanosecond. * @high_auth_time: High 32bit value of image authentication time in nanosecond. * @low_exec_time: Low 32bit value of image execution time in nanosecond. * @high_exec_time: High 32bit value of image execution time in nanosecond. */ struct pfru_updated_result { … }; /** * struct pfrt_log_data_info - Log Data from telemetry service. * @status: Indicator of whether this update succeed. * @ext_status: Implementation specific update result. * @chunk1_addr_lo: Low 32bit physical address of the telemetry data chunk1 * starting address. * @chunk1_addr_hi: High 32bit physical address of the telemetry data chunk1 * starting address. * @chunk2_addr_lo: Low 32bit physical address of the telemetry data chunk2 * starting address. * @chunk2_addr_hi: High 32bit physical address of the telemetry data chunk2 * starting address. * @max_data_size: Maximum supported size of data of all data chunks combined. * @chunk1_size: Data size in bytes of the telemetry data chunk1 buffer. * @chunk2_size: Data size in bytes of the telemetry data chunk2 buffer. * @rollover_cnt: Number of times telemetry data buffer is overwritten * since telemetry buffer reset. * @reset_cnt: Number of times telemetry services resets that results in * rollover count and data chunk buffers are reset. */ struct pfrt_log_data_info { … }; /** * struct pfrt_log_info - Telemetry log information. * @log_level: The telemetry log level. * @log_type: The telemetry log type(history and execution). * @log_revid: The telemetry log revision id. */ struct pfrt_log_info { … }; /** * PFRT_LOG_IOC_SET_INFO - _IOW(PFRUT_IOCTL_MAGIC, 0x06, * struct pfrt_log_info) * * Return: * * 0 - success * * -EFAULT - fail to get the setting parameter * * -EINVAL - fail to set the log level * * Set the PFRT log level and log type. The input information is * a struct pfrt_log_info. */ #define PFRT_LOG_IOC_SET_INFO … /** * PFRT_LOG_IOC_GET_INFO - _IOR(PFRUT_IOCTL_MAGIC, 0x07, * struct pfrt_log_info) * * Return: * * 0 - success * * -EINVAL - fail to get the log level * * -EFAULT - fail to copy the result back to userspace * * Retrieve log level and log type of the telemetry. The information is * a struct pfrt_log_info. */ #define PFRT_LOG_IOC_GET_INFO … /** * PFRT_LOG_IOC_GET_DATA_INFO - _IOR(PFRUT_IOCTL_MAGIC, 0x08, * struct pfrt_log_data_info) * * Return: * * 0 - success * * -EINVAL - fail to get the log buffer information * * -EFAULT - fail to copy the log buffer information to userspace * * Retrieve data information about the telemetry. The information * is a struct pfrt_log_data_info. */ #define PFRT_LOG_IOC_GET_DATA_INFO … #endif /* __PFRUT_H__ */