tspi_tpm_pcrextend(3) [centos man page]
Tspi_TPM_PcrExtend(3) Library Functions Manual Tspi_TPM_PcrExtend(3) TCG Software Stack Developer's Reference NAME
Tspi_TPM_PcrExtend - extend a PCR register and optionally write the PCR event log. 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_PcrExtend(TSS_HTPM hTPM, UINT32 ulPcrIndex, UINT32 ulPcrDataLength, BYTE* pbPcrData, TSS_PCR_EVENT* pPcrEvent, UINT32* pulPcrValueLength, BYTE** prgbPcrValue); DESCRIPTION
Tspi_TPM_PcrExtend extends a PCR register and writes the PCR event log if one is supplied by the user. PARAMETERS
hTPM The hTPM parameter is used to specify the handle of the TPM object. The command to get the TPM to test itself will be sent here. ulPcrIndex The ulPcrIndex parameter is the index of the PCR to extend. ulPcrDataLength The ulPcrDataLength parameter is the length in bytes of the pbPcrData parameter. pbPcrData The pbPcrData parameter is a pointer to data to be hashed by the TSS, which will be used in the extend operation. pPcrEvent The pPcrEvent parameter is the TSS_PCR_EVENT structure to be passed to the TCS to record the extend event. If pPcrEvent is not NULL, the application should fill out the members of the structure that it cares about. pulPcrValueLength The pulPcrValueLength parameter receives the length in bytes of the prgbPcrValue parameter. prgbPcrValue The prgbPcrValue receives a pointer to the memory block containing the PCR data after the extend operation. RETURN CODES
Tspi_TPM_PcrExtend returns TSS_SUCCESS on success, otherwise one of the following values is returned: TSS_E_INVALID_HANDLE hTPM is not a valid handle. TSS_E_INTERNAL_ERROR An internal SW error has been detected. TSS_E_BAD_PARAMETER One or more parameters is bad. CONFORMING TO
Tspi_TPM_PcrExtend conforms to the Trusted Computing Group Software Specification version 1.1 Golden SEE ALSO
Tspi_TPM_PcrRead(3). TSS 1.1 2004-05-25 Tspi_TPM_PcrExtend(3)
Check Out this Related Man Page
Tspi_TPM_Quote2(3) TCG Software Stack Developer's Reference Tspi_TPM_Quote2(3) NAME
Tspi_TPM_Quote2 - retreive a signed set of PCR values with a more complete view than Tspi_TPM_Quote. 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_Quote2(TSS_HTPM hTPM, TSS_HKEY hIdentKey, TSS_BOOL fAddVersion, TSS_HPCRS hPcrComposite, TSS_VALIDATION* pValidationData, UINT32* versionInfoSize, BYTE** versionInfo); DESCRIPTION
Tspi_TPM_Quote2 quotes a TCG system, providing the requestor with a more complete view of the current platform configuration, than Tspi_TPM_Quote. PARAMETERS
hTPM Handle of the TPM object. hIdentKey Handle of the signature key object. fAddVersion If TRUE, the TPM version is added to the output. If FALSE, the TPM version isn't added to the output. hPcrComposite Handle of the PCR composite object, which contains the PCRs to be quoted. pValidationData Validation data structure [IN] Provide externalData information required to compute the signature. [OUT] On successful completion of the command, the structure provides a buffer containing the validation data and a buffer containing the data the validation data was computed form. versionInfoSize The size of the bytestream returned by versionInfo. If the fAddVersion is False this is zero. versionInfo The version information returned as a byte stream reflecting the data in TSS_CAP_VERSION_INFO if the fAddVersion is TRUE. Else it's NULL. RETURN CODES
Tspi_TPM_Quote returns TSS_SUCCESS on success, otherwise one of the following values are returned: TSS_E_INVALID_HANDLE - hTPM, hIdentKey or hPcrComposite is not a valid handle. TSS_E_BAD_PARAMETER TSS_E_INTERNAL_ERROR - An error occurred internal to the TSS. CONFORMING TO
Tspi_TPM_Quote2 conforms to the Trusted Computing Group Software Specification version 1.2 SEE ALSO
Tspi_TPM_Quote(3). TSS 1.2 2007-04-03 Tspi_TPM_Quote2(3)