Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

tspi_key_createmigrationblob(3) [debian man page]

Tspi_Key_CreateMigrationBlob(3) 		     TCG Software Stack Developer's Reference			   Tspi_Key_CreateMigrationBlob(3)

NAME

       Tspi_Key_CreateMigrationBlob - create a key blob suitable for migrating to another TPM.

SYNOPSIS

       #include <tss/platform.h>
       #include <tss/tcpa_defines.h>
       #include <tss/tcpa_typedef.h>
       #include <tss/tcpa_struct.h>
       #include <tss/tss_typedef.h>
       #include <tss/tss_structs.h>
       #include <tss/tspi.h>

       TSS_RESULT Tspi_Key_CreateMigrationBlob(TSS_HKEY hKeyToMigrate,		TSS_HKEY hParentKey,
					       UINT32	ulMigTicketLength,	BYTE*	 rgbMigTicket,
					       UINT32*	pulRandomLength,	BYTE**	 prgbRandom,
					       UINT32*	pulMigrationBlobLength, BYTE**	 prgbMigrationBlob);

DESCRIPTION

       Tspi_Key_CreateMigrationBlob  returns a key blob containing an encrypted section, which will be different depending on the migration scheme
       indicated within the migration ticket previously created by the method Tspi_TPM_AuthorizeMigrationTicket().

PARAMETERS

   hKeyToMigrate
       Handle of the key object to migrate.

   hParentKey
       Handle to the parent key related to the key addressed by hKeyToMigrate.

   ulMigTicketLength
       The length (in bytes) of the rgbMigTickey parameter.

   rgbMigTicket
       Pointer to memory containing the migration ticket (migration public key and its authorization digest).

   pulRandomLength
       On successful completion this parameter returns the random data length returned at the parameter prgbRandom.

   prgbRandom
       On successful completion this parameter returns the random data.

   pulMigrationBlobLength
       On successful completion this parameter returns the length of the migration blob data returned at the parameter prgbMigrationBlob.

   prgbMigrationBlob
       On successful completion this parameter returns the migration data blob.

RETURN CODES

       Tspi_Key_CreateMigrationBlob returns TSS_SUCCESS on success, otherwise one of the following values are returned:

       TSS_E_INVALID_HANDLE - Either hKeyToMigrate, hParentKey or rgbMigTicket are invalid parameters.

       TSS_E_BAD_PARAMETER - One of the passed parameters is wrong.

       TSS_E_KEY_NO_MIGRATION_POLICY - No migration policy picked.

       TSS_E_INTERNAL_ERROR - An error occurred internal to the TSS.

CONFORMING TO

       Tspi_Key_CreateMigrationBlob conforms to the Trusted Computing Group Software Specification version 1.1 Golden

SEE ALSO

       Tspi_Key_CreateKey(3), Tspi_Key_CertifyKey(3).

TSS 1.1 							    2004-05-26					   Tspi_Key_CreateMigrationBlob(3)

Check Out this Related Man Page

Tspi_Data_Seal(3)				     TCG Software Stack Developer's Reference					 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 <tss/platform.h>
       #include <tss/tcpa_defines.h>
       #include <tss/tcpa_typedef.h>
       #include <tss/tcpa_struct.h>
       #include <tss/tss_typedef.h>
       #include <tss/tss_structs.h>
       #include <tss/tspi.h>

       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 nonmigratable 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  encrypted  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 parameters hEncData, hEncKey, rgbDataToSeal is invalid.

       TSS_E_INTERNAL_ERROR - An error occurred internal to the TSS.

CONFORMING TO

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

SEE ALSO

       Tspi_Data_Unseal(3).

TSS 1.1 							    2004-05-26							 Tspi_Data_Seal(3)
Man Page