xref: /netbsd-src/crypto/external/cpl/trousers/dist/man/man3/Tspi_TPM_DAA_JoinStoreCredential.3 (revision 2d5f7628c5531eb583b9313ac2fd1cf8582b4479)
Copyright (C) 2006 International Business Machines Corporation
Written by Anthony Bussani based on the Trusted Computing Group Software Stack Specification Version 1.2

\\$1

.. ..

"\\$1" \\$2
..
"Tspi_TPM_DAA_JoinStoreCredential" 3 "2006-09-04" "TSS 1.2"

1 TCG Software Stack Developer's Reference

NAME
Tspi_TPM_DAA_JoinStoreCredential - compute the final DAA Credential
"SYNOPSIS"
 #include <tss/tss_typedef.h>  #include <tss/tss_structs.h>  #include <tss/tspi.h>  "TSS_RESULT Tspi_TPM_DAA_JoinStoreCredential("  " TSS_HDAA " hDAA ","  " TSS_HTPM " hTPM ","  " TSS_DAA_CRED_ISSUER " credIssuer ","  " TSS_DAA_JOIN_SESSION " joinSession ","  " TSS_HKEY* " hDaaCredential  ");" 
"DESCRIPTION"

\Tspi_TPM_DAA_JoinStoreCredential is the last out of 3 functions (after Tspi_TPM_DAA_JoinInit() and Tspi_TPM_DAA_JoinCreateDaaPubKey()) to execute in order to receive a DAA Credential. It verifies the issued credential from the DAA Issuer and computes the final DAA Credential.

"PARAMETERS"

hDAA
The hDAA parameter is used to specify the handle of the DAA object.
hTPM
The hTPM parameter is the handle to the TPM object.
credIssuer
The credIssuer parameter is the DAA Credential issued by the DAA Issuer including proof of correctness.
joinSession
The joinSession parameter is the structure containing the DAA Join session information.
hDaaCredential
The hDaaCredential parameter is the handle of the received DAA Credential.
"RETURN CODES"

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

TSS_E_INVALID_HANDLE Either the DAA or the TPM handler is not valid.

TSS_E_BAD_PARAMETER

TSS_E_INTERNAL_ERROR An internal SW error has been detected. TSS_E_DAA_CREDENTIAL_PROOF_ERROR One of the verification of the issued credential failed

"CONFORMING TO"

Tspi_TPM_DAA_JoinStoreCredential conforms to the Trusted Computing Group Software Specification version 1.2

"SEE ALSO"

Tspi_TPM_DAA_JoinInit(3) Tspi_TPM_DAA_JoinCreateDaaPubKey(3)