Manual Pages for UNIX Operating System command usage for man Tspi_DAA_IssueCredential

Introduction to Library Functions     Tspi_DAA_IssueCredential(3)



               TCG Software Stack Developer's Reference

NAME
     Tspi_DAA_IssueCredential - issue a DAA credential for a  TCG
     platform

SYNOPSIS
     #include 
     #include 
     #include 

     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  com-
     ponent.  It's the last function out of 2 in order to issue a
     DAA Credential for a TCG Platform. It detects rogue TPM  ac-
     cording to published rogue TPM DAA keys.  This is an option-
     al 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 Is-
     suer 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.




TSS 1.2              Last change: 2006-09-04                    1






Introduction to Library Functions     Tspi_DAA_IssueCredential(3)



  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 correct-
     ness of the credential 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)


ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:













TSS 1.2              Last change: 2006-09-04                    2






Introduction to Library Functions     Tspi_DAA_IssueCredential(3)



     __________________________________________________
    |   ATTRIBUTE TYPE   |       ATTRIBUTE VALUE      |
    |____________________|_____________________________|_
    | Availability       |  library/security/trousers |
    |____________________|_____________________________|_
    | Interface Stability|  Uncommitted               |
    |____________________|____________________________|

NOTES
     Source for trousers is available  at  http://opensolaris.org
     and at http://sourceforge.net/projects/trousers.  Documenta-
     tion   is   available    at    file:///usr/share/man,    and
     http://sourceforge.net/projects/trousers.










































TSS 1.2              Last change: 2006-09-04                    3