sgx 0.6.1

Library for Intel SGX
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62

// SPDX-License-Identifier: Apache-2.0

//! Enclave creation parameters
//!
//! This module defines the enclave creation parameters. These parameters
//! control the CPU features available in the enclave as well as how the
//! enclave is identified.
//!
//! These types are typically used by the enclave to communicate to the enclave
//! loader what parameters it requires. It is further used by the enclave
//! loader to pass to the firmware to build an enclave with the correct
//! parameters. Finally, enclave parameters are included in the attestation.

mod attributes;
mod masked;

pub use attributes::{Attributes, Features, Xfrm};
pub use masked::Masked;

bitflags::bitflags! {
    /// Miscelaneous SSA data selector
    ///
    /// This type controls which extra data will be provided in the SSA page
    /// after an AEX.
    #[derive(Copy, Clone, Debug, Default, PartialEq, Eq, PartialOrd, Ord)]
    pub struct MiscSelect: u32 {
        /// Report #PF and #GP information
        const EXINFO = 1 << 0;
    }
}

/// Enclave creation parameters
///
/// This type is not specified in the Intel documentation and exists for
/// convenience in manipulating sets of configuration. However, the inner
/// types are specified in the Intel documentation.
///
/// Note well that this information is used in different ways in different
/// contexts. For example, when creating an `Secs` page, the mask represents
/// the platform-supported features. Likewise, when creating a `Signature`
/// the mask represents the required features for the enclave.
#[repr(C)]
#[derive(Copy, Clone, Debug, Default, PartialEq, Eq)]
pub struct Parameters {
    /// Choose info for the `Misc` section of the `StateSaveArea`
    pub misc: Masked<MiscSelect>,

    /// CPU features for the enclave
    pub attr: Masked<Attributes>,

    /// Extended ISV-defined family identifier
    pub ext_fid: [u8; 16],

    /// Extended ISV-defined product identifier
    pub ext_pid: [u8; 16],

    /// ISV-defined product identifier
    pub pid: u16,

    /// ISV-defined security version number
    pub svn: u16,
}