Manual Pages for UNIX Operating System command usage for man Tspi_TPM_PcrExtend

Introduction to Library Functions           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 
     #include 
     #include 
     #include 
     #include 
     #include 
     #include 

     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



TSS 1.1              Last change: 2004-05-25                    1






Introduction to Library Functions           Tspi_TPM_PcrExtend(3)



     of the prgbPcrValue parameter.

  prgbPcrValue
     The prgbPcrValue receives a pointer to the memory block con-
     taining 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).


ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

     __________________________________________________
    |   ATTRIBUTE TYPE   |       ATTRIBUTE VALUE      |
    |____________________|_____________________________|_
    | Availability       |  library/security/trousers |
    |____________________|_____________________________|_
    | Interface Stability|  Uncommitted               |
    |____________________|____________________________|

NOTES
     Source for trousers is available  at  http://opensolaris.org
     and at http://sourceforge.net/projects/trousers.  Documenta-
     tion   is   available    at    file:///usr/share/man,    and
     http://sourceforge.net/projects/trousers.






TSS 1.1              Last change: 2004-05-25                    2