tspi_key_wrapkey(3) [debian man page]

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

NAME

       Tspi_Key_WrapKey - wrap a key with the key addressed by hWrappingKey.

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_WrapKey(TSS_HKEY  hKey, TSS_HKEY hWrappingKey,
				   TSS_HPCRS hPcrComposite);

DESCRIPTION

       TSS_Key_WrapKey	wraps  the  private  key hKey using the public key addressed by hWrappingKey. If hPcrComposite is not set to NULL (0), the
       created key blob is bound to its PCR values. The key object addressed by hKey must contain the key information needed for the creation.	On
       successful  return from this call, hKey can be loaded into a TPM. hKey must have been created as a migratable key and should have its usage
       and migrations secrets set using Tspi_Policy_SetSecret(3).  Also, hKey should have had its private key set to either RSA private component,
       p or q.

PARAMETERS

   hKey
       The handle of the key object that is wrapped.

   hWrappingKey
       The handle to the key used to wrap the newly created key.

   hPcrComposite
       The handle to an object, if the value of the handle doesn't equal NULL, the newly create key will be bound ot the PCR values described with
       this object.

RETURN CODES

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

       TSS_E_INVALID_HANDLE - Either hKey, hWrappingKey or hPcrComposite are invalid handles.

       TSS_E_INTERNAL_ERROR - An error occurred internal to the TSS.

CONFORMING TO

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

SEE ALSO

       Tspi_Key_CreateKey(3), Tspi_Key_CertifyKey(3), Tspi_Key_RegisterKey(3).

TSS 1.1 							    2004-05-26						       Tspi_Key_WrapKey(3)

Tspi_TPM_CreateEndorsementKey(3)			     Library Functions Manual				  Tspi_TPM_CreateEndorsementKey(3)

						     TCG Software Stack Developer's Reference

NAME

       Tspi_TPM_CreateEndorsementKey - create the endorsement key

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_CreateEndorsementKey(TSS_HTPM	hTPM, TSS_HKEY hKey,
						TSS_VALIDATION* pValidationData);

DESCRIPTION

       Tspi_TPM_CreateEndorsementKey  creates  an  endorsement key. This function is currently not implemented.  Before this method is called, the
       key information for creating the key must be set in the key object by Tspi_SetAttribData. On return, the public endorsement key can be  re-
       trieved by Tspi_GetAttribData from the key object.

PARAMETERS

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

   hKey
       The hKey parameter is the handle of the key specifying the attributes of the endorsement key to create.

   pValidationData
       The  pValidationData parameter is a validation data structure. It provides external information required to compute the signature. Once the
       command is completed, the structure provides a buffer containing the validation data and a buffer containing the data the  validation  data
       was computed from.

RETURN CODES

       Tspi_TPM_CreateEndorsementKey returns TSS_SUCCESS on success, otherwise one of the following values is returned:

       TSS_E_INVALID_HANDLE
	      hTPM or hKey is not a valid handle.

       TSS_E_INTERNAL_ERROR
	      An internal SW error has been detected.

       TSS_E_BAD_PARAMETER
	      One or more parameters is bad.

CONFORMING TO

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

SEE ALSO

       Tspi_TPM_GetPubEndorsementKey(3), Tspi_Key_GetPubKey(3).

TSS 1.1 							    2004-05-25					  Tspi_TPM_CreateEndorsementKey(3)