Manual Pages for UNIX Operating System command usage for man Tspi_TPM_StirRandom

Introduction to Library Functions          Tspi_TPM_StirRandom(3)



               TCG Software Stack Developer's Reference

NAME
     Tspi_TPM_StirRandom - add entropy to the TPM  random  number
     generator

SYNOPSIS
     #include 
     #include 
     #include 
     #include 
     #include 
     #include 
     #include 

     TSS_RESULT Tspi_TPM_StirRandom(TSS_HTPM hTPM, UINT32 ulEntropyDataLength, BYTE* rgbEntropyData



DESCRIPTION
     Tspi_TPM_StirRandom adds entropy to the  TPM  random  number
     generator  for  the  purpose  of  generating  better  random
     numbers. The entropy variable should assigned  an  appropri-
     ately seeded random number before this function is called.


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.

  ulEntropyDataLength
     The ulEntropyDataLength parameter is the length in bytes  of
     the rgbEntropyData parameter.

  rgbEntropyData
     The rgbEntropyData parameter is a  pointer  to  the  entropy
     data.


RETURN CODES
     Tspi_TPM_StirRandom returns TSS_SUCCESS on  success,  other-
     wise 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 1.1              Last change: 2004-05-25                    1






Introduction to Library Functions          Tspi_TPM_StirRandom(3)



     TSS_E_BAD_PARAMETER
          One or more parameters is bad.


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


SEE ALSO
     Tspi_TPM_GetRandom(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