From c3649a2def02c41d837ae1f79dda729ccb91e677 Mon Sep 17 00:00:00 2001 From: Igor Pashev Date: Sun, 25 Nov 2012 14:36:20 +0000 Subject: Imported Upstream version 0.3.9 --- man/man3/Tspi_Key_CreateMigrationBlob.3 | 97 +++++++++++++++++++++++++++++++++ 1 file changed, 97 insertions(+) create mode 100644 man/man3/Tspi_Key_CreateMigrationBlob.3 (limited to 'man/man3/Tspi_Key_CreateMigrationBlob.3') diff --git a/man/man3/Tspi_Key_CreateMigrationBlob.3 b/man/man3/Tspi_Key_CreateMigrationBlob.3 new file mode 100644 index 0000000..9753849 --- /dev/null +++ b/man/man3/Tspi_Key_CreateMigrationBlob.3 @@ -0,0 +1,97 @@ +.\" Copyright (C) 2004 International Business Machines Corporation +.\" Written by Kathy Robertson based on the Trusted Computing Group Software Stack Specification Version 1.1 Golden +.\" +.de Sh \" Subsection +.br +.if t .Sp +.ne 5 +.PP +\fB\\$1\fR +.PP +.. +.de Sp \" Vertical space (when we can't use .PP) +.if t .sp .5v +.if n .sp +.. +.de Ip \" List item +.br +.ie \\n(.$>=3 .ne \\$3 +.el .ne 3 +.IP "\\$1" \\$2 +.. +.TH "Tspi_Key_CreateMigrationBlob" 3 "2004-05-26" "TSS 1.1" "TCG Software Stack Developer's Reference" +.SH NAME +Tspi_Key_CreateMigrationBlob \- create a key blob suitable for migrating to another TPM. +.SH "SYNOPSIS" +.ad l +.hy 0 +.nf +.B #include +.B #include +.B #include +.B #include +.B #include +.B #include +.B #include +.sp +.BI "TSS_RESULT Tspi_Key_CreateMigrationBlob(TSS_HKEY " hKeyToMigrate ", TSS_HKEY " hParentKey "," +.BI " UINT32 " ulMigTicketLength ", BYTE* " rgbMigTicket "," +.BI " UINT32* " pulRandomLength ", BYTE** " prgbRandom "," +.BI " UINT32* " pulMigrationBlobLength ", BYTE** " prgbMigrationBlob ");" +.fi +.sp +.ad +.hy +.SH "DESCRIPTION" +.PP +\fBTspi_Key_CreateMigrationBlob\fR 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(). +.SH "PARAMETERS" +.PP +.SS hKeyToMigrate +Handle of the key object to migrate. +.PP +.SS hParentKey +Handle to the parent key related to the key addressed by hKeyToMigrate. +.PP +.SS ulMigTicketLength +The length (in bytes) of the rgbMigTickey parameter. +.PP +.SS rgbMigTicket +Pointer to memory containing the migration ticket (migration public key and its authorization digest). +.PP +.SS pulRandomLength +On successful completion this parameter returns the random data length returned at the parameter prgbRandom. +.PP +.SS prgbRandom +On successful completion this parameter returns the random data. +.PP +.SS pulMigrationBlobLength +On successful completion this parameter returns the length of the migration blob data returned at the parameter prgbMigrationBlob. +.PP +.SS prgbMigrationBlob +On successful completion this parameter returns the migration data blob. +.PP +.SH "RETURN CODES" +.PP +\fBTspi_Key_CreateMigrationBlob\fR returns TSS_SUCCESS on success, otherwise one of the following values are returned: +.TP +.SM TSS_E_INVALID_HANDLE - Either \fIhKeyToMigrate\fR, \fIhParentKey\fR or \fIrgbMigTicket\fR are invalid parameters. +.TP +.SM TSS_E_BAD_PARAMETER - One of the passed parameters is wrong. +.TP +.SM TSS_E_KEY_NO_MIGRATION_POLICY - No migration policy picked. +.TP +.SM TSS_E_INTERNAL_ERROR - An error occurred internal to the TSS. + +.SH "CONFORMING TO" + +.PP +\fBTspi_Key_CreateMigrationBlob\fR conforms to the Trusted Computing Group Software Specification version 1.1 Golden +.SH "SEE ALSO" + +.PP +\fBTspi_Key_CreateKey\fR(3), \fBTspi_Key_CertifyKey\fR(3). + + + + -- cgit v1.2.3