DragonFly On-Line Manual Pages

Search: Section:  

Tspi_TPM_Quote2(3)                    TCG Software Stack Developer's Reference


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)

Search: Section: