/* SPDX-License-Identifier: GPL-2.0 */ /* * Copyright (C) 2022 IBM Corporation * Author: Nayna Jain * * Platform keystore for pseries LPAR(PLPKS). */ #ifndef _PSERIES_PLPKS_H #define _PSERIES_PLPKS_H #include #include // Object policy flags from supported_policies #define PLPKS_OSSECBOOTAUDIT PPC_BIT32(1) // OS secure boot must be audit/enforce #define PLPKS_OSSECBOOTENFORCE PPC_BIT32(2) // OS secure boot must be enforce #define PLPKS_PWSET PPC_BIT32(3) // No access without password set #define PLPKS_WORLDREADABLE PPC_BIT32(4) // Readable without authentication #define PLPKS_IMMUTABLE PPC_BIT32(5) // Once written, object cannot be removed #define PLPKS_TRANSIENT PPC_BIT32(6) // Object does not persist through reboot #define PLPKS_SIGNEDUPDATE PPC_BIT32(7) // Object can only be modified by signed updates #define PLPKS_HVPROVISIONED PPC_BIT32(28) // Hypervisor has provisioned this object // Signature algorithm flags from signed_update_algorithms #define PLPKS_ALG_RSA2048 PPC_BIT(0) #define PLPKS_ALG_RSA4096 PPC_BIT(1) // Object label OS metadata flags #define PLPKS_VAR_LINUX 0x02 #define PLPKS_VAR_COMMON 0x04 // Flags for which consumer owns an object is owned by #define PLPKS_FW_OWNER 0x1 #define PLPKS_BOOTLOADER_OWNER 0x2 #define PLPKS_OS_OWNER 0x3 // Flags for label metadata fields #define PLPKS_LABEL_VERSION 0 #define PLPKS_MAX_LABEL_ATTR_SIZE 16 #define PLPKS_MAX_NAME_SIZE 239 #define PLPKS_MAX_DATA_SIZE 4000 // Timeouts for PLPKS operations #define PLPKS_MAX_TIMEOUT (5 * USEC_PER_SEC) #define PLPKS_FLUSH_SLEEP 10000 // usec struct plpks_var { char *component; u8 *name; u8 *data; u32 policy; u16 namelen; u16 datalen; u8 os; }; struct plpks_var_name { u8 *name; u16 namelen; }; struct plpks_var_name_list { u32 varcount; struct plpks_var_name varlist[]; }; /** * Writes the specified var and its data to PKS. * Any caller of PKS driver should present a valid component type for * their variable. */ int plpks_write_var(struct plpks_var var); /** * Removes the specified var and its data from PKS. */ int plpks_remove_var(char *component, u8 varos, struct plpks_var_name vname); /** * Returns the data for the specified os variable. */ int plpks_read_os_var(struct plpks_var *var); /** * Returns the data for the specified firmware variable. */ int plpks_read_fw_var(struct plpks_var *var); /** * Returns the data for the specified bootloader variable. */ int plpks_read_bootloader_var(struct plpks_var *var); #endif