debian man page for tspi_daa_issuecredential

Tspi_DAA_IssueCredential(3)				     Library Functions Manual				       Tspi_DAA_IssueCredential(3)

						     TCG Software Stack Developer's Reference

NAME
       Tspi_DAA_IssueCredential - issue a DAA credential for a TCG platform

SYNOPSIS
       #include <tss/tss_typedef.h>
       #include <tss/tss_structs.h>
       #include <tss/tspi.h>

       TSPICALL Tspi_DAA_IssueCredential(
	   TSS_HDAA		       hDAA,
	   UINT32		       attributesIssuerLength,
	   BYTE**		       attributesIssuer,
	   TSS_DAA_CREDENTIAL_REQUEST  credentialRequest,
	   TSS_DAA_JOIN_ISSUER_SESSION joinSession,
	   TSS_DAA_CRED_ISSUER*        credIssuer
       );

DESCRIPTION
       Tspi_DAA_IssueCredential  is part of the DAA Issuer component. It's the last function out of 2 in order to issue a DAA Credential for a TCG
       Platform. It detects rogue TPM according to published rogue TPM DAA keys.  This is an optional function and does not require  a	TPM  or  a
       TCS.

PARAMETERS
   hDAA
       The hDAA parameter is used to specify the handle of the DAA object.

   attributesIssuerLength
       The  attributesIssuerLength  parameter  is the length of the attributesIssuer array, which is determined by the DAA Issuer public key (li).
       The length of a single attribute is if/8.

   attributesIssuer
       The attributesIssuer parameter is the array of attributes to be encoded into the DAA Credential visible to the DAA Issuer .

   credentialRequest
       The credentialRequest parameter is the credential request of the Platform, it contains the blinded DAA public key of the platform on  which
       the DAA Issuer will issue the credential the blinded attributes chosen by the Platform.

   joinSession
       The joinSession parameter is the structure containing the DAA Join session information.

   credIssuer
       The  credIssuer	parameter is the structure containing the DAA Credential issued by the DAA Issuer, the proof of correctness of the creden-
       tial and the attributes chosen by the DAA Issuer.

RETURN CODES
       Tspi_DAA_IssueCredential returns TSS_SUCCESS on success, otherwise one of the following values is returned:

       TSS_E_BAD_PARAMETER

       TSS_E_INTERNAL_ERROR
	      An internal SW error has been detected.

       TSS_E_DAA_AUTHENTICATION_ERROR
	      The authentication proof of the TPM is incorrect.

       TSS_E_DAA_PSEUDONYM_ERROR
	      The TPM is rogue.

       TSS_E_DAA_CREDENTIAL_REQUEST_PROOF_ERROR
	      The proof of the credential request is incorrect.

CONFORMING TO
       Tspi_DAA_IssueCredential conforms to the Trusted Computing Group Software Specification version 1.2

SEE ALSO
       Tspi_DAA_IssuerKeyVerification(3)

TSS 1.2 							    2006-09-04					       Tspi_DAA_IssueCredential(3)