Go to main content

man pages section 3: Library Interfaces and Headers

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

Tspi_PcrComposite_GetPcrValue (3)

Name

Tspi_PcrComposite_GetPcrValue - get the digest value of a given PCR index inside a PCR composite object.

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_PcrComposite_GetPcrValue(TSS_HPCRS hPcrComposite,    UINT32 ulPcrIndex,
UINT32*   ulPcrValueLength, BYTE** rgbPcrValue);

Description

TCG Software Stack Developer's Reference
                                              Tspi_PcrComposite_GetPcrValue(3)



NAME
       Tspi_PcrComposite_GetPcrValue  -  get  the  digest value of a given PCR
       index inside a PCR composite object.

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_PcrComposite_GetPcrValue(TSS_HPCRS hPcrComposite,    UINT32 ulPcrIndex,
                                                UINT32*   ulPcrValueLength, BYTE** rgbPcrValue);



DESCRIPTION
       Tspi_PcrComposite_GetPcrValue returns the digest value of a  given  PCR
       index inside a PCR composite object.

PARAMETERS
   hPcrComposite
       Handle of the PCR composite object instance where a PCR value should be
       returned.

   ulPcrIndex
       This parameter indicates the index of the PCR to read.

   ulPcrValueLength
       The length (in bytes) of the rgbPcrValue parameter.

   rgbPcrValue
       After successful completion this parameter recieves a  pointer  to  the
       memory  block  containing  the  PCR  value  of  the  PCR  indicated  by
       ulPcrIndex.

RETURN CODES
       Tspi_PcrComposite_GetPcrValue returns TSS_SUCCESS on success, otherwise
       one of the following values are returned:

       TSS_E_INVALID_HANDLE - Either hPcrComposite or ulPcrIndex is an invalid
       parameter.

       TSS_E_INTERNAL_ERROR - An error occurred internal to the TSS.


CONFORMING TO
       Tspi_PcrComposite_GetPcrValue conforms to the Trusted  Computing  Group
       Software Specification version 1.1 Golden


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+---------------------------+
       |ATTRIBUTE TYPE |     ATTRIBUTE VALUE       |
       +---------------+---------------------------+
       |Availability   | library/security/trousers |
       +---------------+---------------------------+
       |Stability      | Uncommitted               |
       +---------------+---------------------------+

SEE ALSO
       Tspi_PcrComposite_SelectPcrIndex(3), Tspi_PcrComposite_SetPcrValue(3).





NOTES
       Source  code  for open source software components in Oracle Solaris can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-
       code-downloads.html.

       This software was built from source available at https://github.com/or-
       acle/solaris-userland.  The original community  source  was  downloaded
       from                                                    https://source-
       forge.net/projects/trousers/files/trousers/0.3.15/trousers-0.3.15.tar.gz.

       Further information about this software can be found on the open source
       community website at http://trousers.sourceforge.net/.



TSS 1.1                           2004-05-26
                                              Tspi_PcrComposite_GetPcrValue(3)