Manual Pages for UNIX Operating System command usage for man Tspi_Data_Seal

Introduction to Library Functions               Tspi_Data_Seal(3)



NAME
     Tspi_Data_Seal - encrypt a data blob in  a  mannar  that  is
     only decryptable by Tspi_Data_Unseal on the same system.

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

     TSS_RESULT Tspi_Data_Seal(TSS_HENCDATA hEncData,     TSS_HKEY hEncKey,
                               UINT32       ulDataLength, BYTE*    rgbDataToSeal,
                               TSS_HPCRS    hPcrComposite);



DESCRIPTION
     Tspi_Data_Seal encrypts a data blob in a mannar that is only
     decryptable by Tspi_Data_Unseal on the same system. The data
     blob is encrypted using a public key operation with the non-
     migratable key addressed by the given encryption key object.

PARAMETERS
  hEncData
     Handle of the data object which contains the sealed data  on
     successful completion of the command.

  hEncKey
     Handle to the key object addressing  the  nonmigratable  key
     which is used to encrypt the data.

  ulDataLength
     The Length (in bytes) of the rgbDataToSeal parameter.

  rgbDataToSeal
     Pointer to memory containing the data to be encrypted.

  hPcrComposite
     Handle of the PCR Composite object specifying the PCRs which
     are  part  of  the sealed data blob. Set to NULL, if the en-
     crypted data should only be bound to the system and PCRs are
     not of interest.

RETURN CODES
     Tspi_Data_Seal returns TSS_SUCCESS on success, otherwise one
     of the following values are returned:

     TSS_E_INVALID_HANDLE - One of the following




TSS 1.1              Last change: 2004-05-26                    1






Introduction to Library Functions               Tspi_Data_Seal(3)



     TSS_E_INTERNAL_ERROR - An error occurred internal


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


SEE ALSO
     Tspi_Data_Unseal(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-26                    2