1
.\" Copyright (C) 2004 International Business Machines Corporation
2
.\" Written by Kathy Robertson based on the Trusted Computing Group Software Stack Specification Version 1.1 Golden
12
.de Sp \" Vertical space (when we can't use .PP)
18
.ie \\n(.$>=3 .ne \\$3
22
.TH "Tspi_TPM_CertifySelfTest" 3 "2004-05-26" "TSS 1.1" "TCG Software Stack Developer's Reference"
24
Tspi_TPM_CertifySelfTest\- have the TPM sign its self test data
29
.B #include <tss/platform.h>
30
.B #include <tss/tcpa_defines.h>
31
.B #include <tss/tcpa_typedef.h>
32
.B #include <tss/tcpa_struct.h>
33
.B #include <tss/tss_typedef.h>
34
.B #include <tss/tss_structs.h>
35
.B #include <tss/tspi.h>
37
.BI "TSS_RESULT Tspi_TPM_CertifySelfTest(TSS_HTPM " hTPM ", TSS_HKEY " hKey ","
38
.BI " TSS_VALIDATION* " pValidationData " );"
46
\fBTspi_TPM_CertifySelfTest\fR performs a self-test of each internal TPM function and returns an authenticated value (signature) if the test has passed.
50
Handle of the TPM object
53
Handle of the signature key object
57
Validation data structure.
58
[IN] Provide externalData information required to compute the signature.
59
[OUT] On successful completion of the ocmmand, the structure provides a buffer containing the validation data and a buffer containing the data the validation data was computed from.
62
\fBTspi_TPM_CertifySelfTest\fR returns TSS_SUCCESS on success, otherwise one of the following values are returned:
64
.SM TSS_E_INVALID_HANDLE
65
\fBhTPM\fR is not a valid handle to a TPM object.
67
.SM TSS_E_INTERNAL_ERROR
68
An error occurred internal to the TSS.
73
\fBTspi_TPM_CertifySelfTest\fR conforms to the Trusted Computing Group Software Specification version 1.1 Golden
77
\fBTspi_TPM_SelfTestFull\fR(3).