Manual Pages for UNIX Operating System command usage for man Tspi_TPM_TakeOwnership

Introduction to Library Functions       Tspi_TPM_TakeOwnership(3)



               TCG Software Stack Developer's Reference

NAME
     Tspi_TPM_TakeOwnership - take ownership of a TPM

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

     TSS_RESULT Tspi_TPM_TakeOwnership(TSS_HTPM hTPM, TSS_HKEY hKeySRK,
                                       TSS_HKEY hEndorsementPubKey);



DESCRIPTION
     Tspi_TPM_TakeOwnership takes ownership of a TPM. Taking own-
     ership  is the process of inserting a shared secret into the
     TPM. The owner of the  TPM  (anyone  who  knows  the  shared
     secret) has the right to perform special operations.


PARAMETERS
  hTPM
     The hTPM parameter is used to specify the handle of the  TPM
     object.

  hKeySRK
     The hKeySRK parameter is the handle to the object represent-
     ing the TPM's Storage Root Key.

  hEndorsementPubKey
     The hEndorsementPubKey parameter is the handle to the object
     representing  the  TPM's endorsement public key. This key is
     required for encrypting the secret of the SRK  and  the  TPM
     owner  secret.  If  NULL, the TSP internally queries the TPM
     for that endorsement public key.


RETURN CODES
     Tspi_TPM_TakeOwnership returns TSS_SUCCESS on success,  oth-
     erwise one of the following values is returned:

     TSS_E_INVALID_HANDLE
          Either the TPM or one of the key handles is not valid.


     TSS_E_INTERNAL_ERROR



TSS 1.1              Last change: 2004-05-25                    1






Introduction to Library Functions       Tspi_TPM_TakeOwnership(3)



          An internal SW error has been detected.


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


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