tss-esapi 5.0.1

Rust-native wrapper around TSS 2.0 Enhanced System API
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
63
64
65
66
67
68
69
70
71

// Copyright 2021 Contributors to the Parsec project.
// SPDX-License-Identifier: Apache-2.0
use crate::{
    structures::MaxBuffer,
    tss2_esys::{Esys_GetTestResult, Esys_SelfTest},
    Context, Error, Result,
};
use log::error;
use mbox::MBox;
use std::convert::TryFrom;
use std::ptr::null_mut;

impl Context {
    /// Execute the TPM self test and returns the result
    pub fn self_test(&mut self, full_test: bool) -> Result<()> {
        let ret = unsafe {
            Esys_SelfTest(
                self.mut_context(),
                self.optional_session_1(),
                self.optional_session_2(),
                self.optional_session_3(),
                if full_test { 1 } else { 0 },
            )
        };
        let ret = Error::from_tss_rc(ret);

        if ret.is_success() {
            Ok(())
        } else {
            error!("Error in self-test: {}", ret);
            Err(ret)
        }
    }

    // Missing function: incremental_self_test

    /// Get the TPM self test result
    ///
    /// The returned buffer data is manufacturer-specific information.
    pub fn get_test_result(&mut self) -> Result<(MaxBuffer, Result<()>)> {
        let mut out_data = null_mut();
        let mut out_rc: u32 = 0;

        let ret = unsafe {
            Esys_GetTestResult(
                self.mut_context(),
                self.optional_session_1(),
                self.optional_session_2(),
                self.optional_session_3(),
                &mut out_data,
                &mut out_rc,
            )
        };
        let ret = Error::from_tss_rc(ret);

        if ret.is_success() {
            let out_data = unsafe { MBox::from_raw(out_data) };
            let out_data = MaxBuffer::try_from(*out_data)?;
            let out_rc = Error::from_tss_rc(out_rc);
            let out_rc = if out_rc.is_success() {
                Ok(())
            } else {
                Err(out_rc)
            };
            Ok((out_data, out_rc))
        } else {
            error!("Error getting test result: {}", ret);
            Err(ret)
        }
    }
}