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

NAME

8       Tspi_TPM_TakeOwnership - take ownership of a TPM
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_TakeOwnership(TSS_HTPM hTPM, TSS_HKEY hKeySRK,
20                                         TSS_HKEY hEndorsementPubKey);
21
22
23

DESCRIPTION

25       Tspi_TPM_TakeOwnership  takes  ownership  of a TPM. Taking ownership is
26       the process of inserting a shared secret into the TPM. The owner of the
27       TPM  (anyone who knows the shared secret) has the right to perform spe‐
28       cial operations.
29
30

PARAMETERS

32   hTPM
33       The hTPM parameter is used to specify the handle of the TPM object.
34
35   hKeySRK
36       The hKeySRK parameter is the handle  to  the  object  representing  the
37       TPM's Storage Root Key.
38
39   hEndorsementPubKey
40       The hEndorsementPubKey parameter is the handle to the object represent‐
41       ing the TPM's endorsement public key. This key is required for encrypt‐
42       ing  the  secret  of the SRK and the TPM owner secret. If NULL, the TSP
43       internally queries the TPM for that endorsement public key.
44
45

RETURN CODES

47       Tspi_TPM_TakeOwnership returns TSS_SUCCESS on success, otherwise one of
48       the following values is returned:
49
50       TSS_E_INVALID_HANDLE
51              Either the TPM or one of the key handles is not valid.
52
53
54       TSS_E_INTERNAL_ERROR
55              An internal SW error has been detected.
56
57

CONFORMING TO

59       Tspi_TPM_TakeOwnership conforms to the Trusted Computing Group Software
60       Specification version 1.1 Golden
61
62

SEE ALSO

64       Tspi_TPM_ClearOwner(3)
65
66TSS 1.1                           2004-05-25         Tspi_TPM_TakeOwnership(3)
Impressum