---
name: "Tspi_TPM_CertifySelfTest"
section: "3"
platform: "linux"
package: "libtspi-dev"
version: "0.3.15-0.4"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/Tspi_TPM_CertifySelfTest"
---

# Tspi\_TPM\_CertifySelfTest(3)

## NAME

Tspi\_TPM\_CertifySelfTest- have the TPM sign its self test data

## SYNOPSIS

**#include \<tss/platform.h\>**
 **#include \<tss/tcpa\_defines.h\>**
 **#include \<tss/tcpa\_typedef.h\>**
 **#include \<tss/tcpa\_struct.h\>**
 **#include \<tss/tss\_typedef.h\>**
 **#include \<tss/tss\_structs.h\>**
 **#include \<tss/tspi.h\>**
 **TSS\_RESULT Tspi\_TPM\_CertifySelfTest(TSS\_HTPM**        *hTPM***, TSS\_HKEY** *hKey***,**
                                     **TSS\_VALIDATION\*** *pValidationData* **);**

## DESCRIPTION

**Tspi\_TPM\_CertifySelfTest** performs a self-test of each internal TPM function and returns an authenticated value (signature) if the test has passed.

## PARAMETERS

### hTPM

Handle of the TPM object

### hKey

Handle of the signature key object
 pValidationData
 Validation data structure.
 \[IN\] Provide externalData information required to compute the signature.
 \[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.

## RETURN CODES

**Tspi\_TPM\_CertifySelfTest** returns TSS\_SUCCESS on success, otherwise one of the following values are returned:
 TSS\_E\_INVALID\_HANDLE
 **hTPM** is not a valid handle to a TPM object.
 TSS\_E\_INTERNAL\_ERROR
 An error occurred internal to the TSS.

## CONFORMING TO

**Tspi\_TPM\_CertifySelfTest** conforms to the Trusted Computing Group Software Specification version 1.1 Golden

## SEE ALSO

[**Tspi\_TPM\_SelfTestFull**(3)](/Tspi_TPM_SelfTestFull/3.md).