Go to main content

man pages section 3: Library Interfaces and Headers

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

Tspi_TPM_AuthorizeMigrationTicket (3)

Name

Tspi_TPM_AuthorizeMigrationTicket - create the migration ticket required for the migration process.

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_TPM_AuthorizeMigrationTicket(TSS_HTPM           hTPM,            TSS_HKEY hMigrationKey,
TSS_MIGRATE_SCHEME migrationScheme, UINT32*  pulMigTicketLength,
BYTE**             prgbMigTicket);

Description

TCG Software Stack Developer's Reference
                                          Tspi_TPM_AuthorizeMigrationTicket(3)



NAME
       Tspi_TPM_AuthorizeMigrationTicket- create the migration ticket required
       for the migration process.

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_TPM_AuthorizeMigrationTicket(TSS_HTPM           hTPM,            TSS_HKEY hMigrationKey,
                                                    TSS_MIGRATE_SCHEME migrationScheme, UINT32*  pulMigTicketLength,
                                                    BYTE**             prgbMigTicket);



DESCRIPTION
       Tspi_TPM_AuthorizeMigrationTicket is used by the owner to  authorize  a
       target  public  key for migration. This mean sthat when a system is set
       up, the owner can decide that all archives should be done on a particu-
       lar  server.  Then  as keys are created, the user can pick one of these
       servers for the target of the migration of their keys,  if  they  wish.
       This provides one of the two authorizations necessary to migrate a key.

PARAMETERS
   hTPM
       Handle of the TPM object

   hMigrationKey
       Handle of the object representing the migration key.

   migrationScheme
       Flag indiating the migration scheme to be used.

   pulMigTicketLength
       Recieves the length (in bytes) of the prgbMigTicket parameter.

   prgbMigTicket
       Recieves  a  pointer to thememory block containing the migration ticket
       blob.

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

       TSS_E_INVALID_HANDLE
              Either hTPM or hMigrationKey is not a valid handle.

       TSS_E_INTERNAL_ERROR
              An error occurred internal to the TSS.


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


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+---------------------------+
       |ATTRIBUTE TYPE |     ATTRIBUTE VALUE       |
       +---------------+---------------------------+
       |Availability   | library/security/trousers |
       +---------------+---------------------------+
       |Stability      | Uncommitted               |
       +---------------+---------------------------+

SEE ALSO
       (none).






NOTES
       Source code for open source software components in Oracle  Solaris  can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-
       code-downloads.html.

       This software was built from source available at https://github.com/or-
       acle/solaris-userland.   The  original  community source was downloaded
       from                                                    https://source-
       forge.net/projects/trousers/files/trousers/0.3.15/trousers-0.3.15.tar.gz.

       Further information about this software can be found on the open source
       community website at http://trousers.sourceforge.net/.



TSS 1.1                           2004-05-26
                                          Tspi_TPM_AuthorizeMigrationTicket(3)