Manual Pages for UNIX Operating System command usage for man Tspi_DAA_VerifySignature

Introduction to Library Functions     Tspi_DAA_VerifySignature(3)



               TCG Software Stack Developer's Reference

NAME
     Tspi_DAA_VerifySignature - creates a challenge for  the  TCG
     platform

SYNOPSIS
     #include 
     #include 
     #include 

     TSPICALL Tspi_DAA_VerifySignature(
         TSS_HDAA                    hDAA,
         TSS_DAA_SIGNATURE           daaSignature,
         TSS_HKEY                    hPubKeyIssuer,
         TSS_DAA_SIGN_DATA           signData,
         UINT32                      attributesLength,
         BYTE**                      attributes,
         UINT32                      nonceVerifierLength,
         BYTE*                       nonceVerifier,
         UINT32                      baseNameLength,
         BYTE*                       baseName,
         TSS_BOOL*                   isCorrect
     );



DESCRIPTION
     Tspi_DAA_VerifySignature is part of the  DAA  Verifier  com-
     ponent. It's the last function out of 2 in order to verify a
     DAA Credential of  a  TCG  platform.  It  verifies  the  DAA
     Credential  and  detects  public rogue TPMs.  This is an op-
     tional 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.

  daaSignature
     The daaSignature parameter is  the  DAA  signature  contains
     proof  of ownership of the DAA Credential, as well as a sig-
     nature on either an AIK or a message.

  hPubKeyIssuer
     The hPubKeyIssuer parameter is the handle of the DAA  public
     key of the DAA Issuer of the credential.

  signData
     The signData parameter defines what data is signed  (AIK  or
     message).



TSS 1.2              Last change: 2006-09-04                    1






Introduction to Library Functions     Tspi_DAA_VerifySignature(3)



  attributesLength
     The attributesLength parameter is the Length  of  attributes
     array  that  is  determined  by  the  DAA  Issuer public key
     (lh+li). The length of a single attribute is lf/8.

  attributes
     The attributes parameter is the array  of  attributes  which
     the DAA Credential owner reveals.

  nonceVerifierLength
     The nonceVerifierLength parameter is the length of  nonceVe-
     rifier (20 bytes).

  nonceVerifier
     The nonceVerifier parameter is the nonce that  was  computed
     in the previous function (Tspi_VerifyInit).

  baseNameLength
     The baseNameLength parameter the length of the baseName.

  baseName
     The baseName parameter is the base name that was chosen  for
     the DAA Signature.

  isCorrect
     The isCorrect parameter denotes if the verification  of  the
     DAA Signature was successful.


RETURN CODES
     Tspi_DAA_VerifySignature  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.

     Tspi_DAA_VerifySignature 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_VerifySignature(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