Manual Pages for UNIX Operating System command usage for man Tspi_TPM_ClearOwner

Introduction to Library Functions          Tspi_TPM_ClearOwner(3)



               TCG Software Stack Developer's Reference

NAME
     Tspi_TPM_ClearOwner - clear TPM ownership

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

     TSS_RESULT Tspi_TPM_ClearOwner(TSS_HTPM hTPM, TSS_BOOL fForcedClear);



DESCRIPTION
     Tspi_TPM_ClearOwner wipes the TPM of everything but its  en-
     dorsement  key.  It will wipe the SRK, so anything locked to
     the SRK will also disappear when this command  is  executed.
     This is the only way to be certain that keys are gone, as it
     is the only way to guarantee that nothing can keep a copy of
     the  key.  You must assert either physical presence or owner
     authorization in order to use this command.


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

  fForcedClear
     The fForcedClear parameter is used to tell whether this com-
     mand is being executed with owner authorization or with phy-
     sical presence. If FALSE, then TPM  owner  authorization  is
     used.  If  TRUE, then physical presence is required to clear
     the TPM.


RETURN CODES
     Tspi_TPM_ClearOwner 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_ClearOwner(3)



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


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