cachepc-linux

Fork of AMDESE/linux with modifications for CachePC side-channel attack
git clone https://git.sinitax.com/sinitax/cachepc-linux
Log | Files | Refs | README | LICENSE | sfeed.txt

tboot.h (3407B)


      1/* SPDX-License-Identifier: GPL-2.0-only */
      2/*
      3 * tboot.h: shared data structure with tboot and kernel and functions
      4 *          used by kernel for runtime support of Intel(R) Trusted
      5 *          Execution Technology
      6 *
      7 * Copyright (c) 2006-2009, Intel Corporation
      8 */
      9
     10#ifndef _LINUX_TBOOT_H
     11#define _LINUX_TBOOT_H
     12
     13/* these must have the values from 0-5 in this order */
     14enum {
     15	TB_SHUTDOWN_REBOOT = 0,
     16	TB_SHUTDOWN_S5,
     17	TB_SHUTDOWN_S4,
     18	TB_SHUTDOWN_S3,
     19	TB_SHUTDOWN_HALT,
     20	TB_SHUTDOWN_WFS
     21};
     22
     23#ifdef CONFIG_INTEL_TXT
     24#include <linux/acpi.h>
     25/* used to communicate between tboot and the launched kernel */
     26
     27#define TB_KEY_SIZE             64   /* 512 bits */
     28
     29#define MAX_TB_MAC_REGIONS      32
     30
     31struct tboot_mac_region {
     32	u64  start;         /* must be 64 byte -aligned */
     33	u32  size;          /* must be 64 byte -granular */
     34} __packed;
     35
     36/* GAS - Generic Address Structure (ACPI 2.0+) */
     37struct tboot_acpi_generic_address {
     38	u8  space_id;
     39	u8  bit_width;
     40	u8  bit_offset;
     41	u8  access_width;
     42	u64 address;
     43} __packed;
     44
     45/*
     46 * combines Sx info from FADT and FACS tables per ACPI 2.0+ spec
     47 * (https://uefi.org/specifications)
     48 */
     49struct tboot_acpi_sleep_info {
     50	struct tboot_acpi_generic_address pm1a_cnt_blk;
     51	struct tboot_acpi_generic_address pm1b_cnt_blk;
     52	struct tboot_acpi_generic_address pm1a_evt_blk;
     53	struct tboot_acpi_generic_address pm1b_evt_blk;
     54	u16 pm1a_cnt_val;
     55	u16 pm1b_cnt_val;
     56	u64 wakeup_vector;
     57	u32 vector_width;
     58	u64 kernel_s3_resume_vector;
     59} __packed;
     60
     61/*
     62 * shared memory page used for communication between tboot and kernel
     63 */
     64struct tboot {
     65	/*
     66	 * version 3+ fields:
     67	 */
     68
     69	/* TBOOT_UUID */
     70	u8 uuid[16];
     71
     72	/* version number: 5 is current */
     73	u32 version;
     74
     75	/* physical addr of tb_log_t log */
     76	u32 log_addr;
     77
     78	/*
     79	 * physical addr of entry point for tboot shutdown and
     80	 * type of shutdown (TB_SHUTDOWN_*) being requested
     81	 */
     82	u32 shutdown_entry;
     83	u32 shutdown_type;
     84
     85	/* kernel-specified ACPI info for Sx shutdown */
     86	struct tboot_acpi_sleep_info acpi_sinfo;
     87
     88	/* tboot location in memory (physical) */
     89	u32 tboot_base;
     90	u32 tboot_size;
     91
     92	/* memory regions (phys addrs) for tboot to MAC on S3 */
     93	u8 num_mac_regions;
     94	struct tboot_mac_region mac_regions[MAX_TB_MAC_REGIONS];
     95
     96
     97	/*
     98	 * version 4+ fields:
     99	 */
    100
    101	/* symmetric key for use by kernel; will be encrypted on S3 */
    102	u8 s3_key[TB_KEY_SIZE];
    103
    104
    105	/*
    106	 * version 5+ fields:
    107	 */
    108
    109	/* used to 4byte-align num_in_wfs */
    110	u8 reserved_align[3];
    111
    112	/* number of processors in wait-for-SIPI */
    113	u32 num_in_wfs;
    114} __packed;
    115
    116/*
    117 * UUID for tboot data struct to facilitate matching
    118 * defined as {663C8DFF-E8B3-4b82-AABF-19EA4D057A08} by tboot, which is
    119 * represented as {} in the char array used here
    120 */
    121#define TBOOT_UUID	{0xff, 0x8d, 0x3c, 0x66, 0xb3, 0xe8, 0x82, 0x4b, 0xbf,\
    122			 0xaa, 0x19, 0xea, 0x4d, 0x5, 0x7a, 0x8}
    123
    124bool tboot_enabled(void);
    125extern void tboot_probe(void);
    126extern void tboot_shutdown(u32 shutdown_type);
    127extern struct acpi_table_header *tboot_get_dmar_table(
    128				      struct acpi_table_header *dmar_tbl);
    129extern int tboot_force_iommu(void);
    130
    131#else
    132
    133#define tboot_enabled()			0
    134#define tboot_probe()			do { } while (0)
    135#define tboot_shutdown(shutdown_type)	do { } while (0)
    136#define tboot_sleep(sleep_state, pm1a_control, pm1b_control)	\
    137					do { } while (0)
    138#define tboot_get_dmar_table(dmar_tbl)	(dmar_tbl)
    139#define tboot_force_iommu()		0
    140
    141#endif /* !CONFIG_INTEL_TXT */
    142
    143#endif /* _LINUX_TBOOT_H */