1Tspi_TPM_StirRandom(3)     Library Functions Manual     Tspi_TPM_StirRandom(3)
2
3
4
5                   TCG Software Stack Developer's Reference
6

NAME

8       Tspi_TPM_StirRandom - add entropy to the TPM random number generator
9

SYNOPSIS

11       #include <tss/platform.h>
12       #include <tss/tcpa_defines.h>
13       #include <tss/tcpa_typedef.h>
14       #include <tss/tcpa_struct.h>
15       #include <tss/tss_typedef.h>
16       #include <tss/tss_structs.h>
17       #include <tss/tspi.h>
18
19       TSS_RESULT Tspi_TPM_StirRandom(TSS_HTPM hTPM, UINT32 ulEntropyDataLength, BYTE* rgbEntropyData);
20
21
22

DESCRIPTION

24       Tspi_TPM_StirRandom adds entropy to the TPM random number generator for
25       the purpose of generating better random numbers. The  entropy  variable
26       should assigned an appropriately seeded random number before this func‐
27       tion is called.
28
29

PARAMETERS

31   hTPM
32       The hTPM parameter is used to specify the handle of the TPM object. The
33       command to get the TPM to test itself will be sent here.
34
35   ulEntropyDataLength
36       The  ulEntropyDataLength parameter is the length in bytes of the rgbEn‐
37       tropyData parameter.
38
39   rgbEntropyData
40       The rgbEntropyData parameter is a pointer to the entropy data.
41
42

RETURN CODES

44       Tspi_TPM_StirRandom returns TSS_SUCCESS on success,  otherwise  one  of
45       the following values is returned:
46
47       TSS_E_INVALID_HANDLE
48              hTPM is not a valid handle.
49
50
51       TSS_E_INTERNAL_ERROR
52              An internal SW error has been detected.
53
54
55       TSS_E_BAD_PARAMETER
56              One or more parameters is bad.
57
58

CONFORMING TO

60       Tspi_TPM_StirRandom  conforms  to  the Trusted Computing Group Software
61       Specification version 1.1 Golden
62
63

SEE ALSO

65       Tspi_TPM_GetRandom(3).
66
67
68
69
70TSS 1.1                           2004-05-25            Tspi_TPM_StirRandom(3)