Manual Pages for UNIX Operating System command usage for man Tspi_DAA_IssueSetup

Introduction to Library Functions          Tspi_DAA_IssueSetup(3)



               TCG Software Stack Developer's Reference

NAME
     Tspi_DAA_IssueSetup -  generate  a  DAA  Issuer  public  and
     private key

SYNOPSIS
     #include 
     #include 
     #include 

     TSPICALL Tspi_DAA_IssueSetup(
         TSS_HDAA                  hDAA,
         UINT32                    issuerBaseNameLength,
         BYTE*                     issuerBaseName,
         UINT32                    numberPlatformAttributes,
         UINT32                    numberIssuerAttributes,
         TSS_HKEY*                 keyPair,
         TSS_DAA_PK_PROOF**        identity_proof
     );



DESCRIPTION
     Tspi_DAA_IssueSetup is part of the DAA Issuer component.  It
     defines  the  generation  of  a DAA Issuer public and secret
     key. Further it defines the generation of a  non-interactive
     proof (using the Fiat-Shamir heuristic) that the public keys
     were chosen correctly. The latter will guarantee the securi-
     ty  requirements  of  the platform (respectively, its user),
     i.e., that the privacy  and  anonymity  of  signatures  will
     hold.   The generation of the authentication keys of the DAA
     Issuer, which are used to  authenticate  (main)  DAA  Issuer
     keys,  is not defined by this function.  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.

  issuerBaseNameLength
     The issuerBaseNameLength parameter is the length of the  is-
     suerBaseName.

  issuerBaseName
     The issuerBaseName parameter is the unique name of  the  DAA
     Issuer.

  numberPlatformAttributes
     The numberPlatformAttributes parameter is the number of  at-



TSS 1.2              Last change: 2006-09-04                    1






Introduction to Library Functions          Tspi_DAA_IssueSetup(3)



     tributes  that the Platform can choose and which will not be
     visible to the Issuer.

  numberIssuerAttributes
     The numberIssuerAttributes parameter is number of attributes
     that the Issuer can choose and which will be visible to both
     the Platform and the Issuer.

  keyPair
     The keyPair parameter is the handle of the main  DAA  Issuer
     key pair (private and public portion).

  publicKeyProof
     The publicKeyProof parameter is the Handle of the  proof  of
     the main DAA Issuer public key.


RETURN CODES
     Tspi_DAA_IssueSetup returns TSS_SUCCESS on  success,  other-
     wise one of the following values is returned:

     TSS_E_INVALID_HANDLE
          Either the DAA is not valid.

     TSS_E_BAD_PARAMETER

     TSS_E_INTERNAL_ERROR
          An internal SW error has been detected.


CONFORMING TO
     Tspi_DAA_IssueSetup 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_IssueSetup(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