Manual Pages for UNIX Operating System command usage for man Tspi_TPM_GetRandom

Introduction to Library Functions           Tspi_TPM_GetRandom(3)



               TCG Software Stack Developer's Reference

NAME
     Tspi_TPM_GetRandom - generate a random number on the TPM

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

     TSS_RESULT Tspi_TPM_GetRandom(TSS_HTPM hTPM, UINT32 size, BYTE** random


DESCRIPTION
     Tspi_TPM_GetRandom gets a good random number for the purpose
     of  generating  symmetric  keys, nonces, or seeding a random
     number generator.


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.

  size
     The size parameter is the number of random bytes requested.

  random
     The random parameter is a pointer to memory  containing  the
     random  data.  This  is where the generated number goes. Be-
     cause      this      internally      allocates       memory,
     Tspi_Context_FreeMemory should also be used.


RETURN CODES
     Tspi_TPM_GetRandom 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



TSS 1.1              Last change: 2004-05-25                    1






Introduction to Library Functions           Tspi_TPM_GetRandom(3)



          One or more parameters is bad.


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


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