Manual Pages for UNIX Operating System command usage for man Tspi_Hash_VerifySignature

Introduction to Library Functions    Tspi_Hash_VerifySignature(3)



               TCG Software Stack Developer's Reference

NAME
     Tspi_Hash_VerifySignature - verify the  hash  value  with  a
     given signature

SYNOPSIS
     #include 
     #include 
     #include 
     #include 
     #include 
     #include 
     #include 

     TSS_RESULT Tspi_Hash_VerifySignature(TSS_HHASH hHash,             TSS_HKEY hKey,
                                          UINT32    ulSignatureLength, BYTE*    rgbSignature);



DESCRIPTION
     Tspi_Hash_VerifySignature verifies the hash value of a given
     hash  object  with  a  given signature. In order to use this
     command, one must have a hash and a signature  of  the  hash
     that   one  is  trying  to  verify.  The  public  key  which
     corresponds to the private key used to sign the hash is also
     needed.


PARAMETERS
  hHash
     The handle to the hash  object  instance  whose  hash  value
     should be signed.

  hKey
     Handle to the key object which should be used for the signa-
     ture verification.

  ulSignatureLength
     The length of the signature data provided at  the  parameter
     rgbSignature.

  rgbSignature
     A pointer to the signature data.


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

     TSS_E_INVALID_HANDLE
          hKey is not a valid handle.



TSS 1.1              Last change: 2004-05-25                    1






Introduction to Library Functions    Tspi_Hash_VerifySignature(3)



     TSS_E_INTERNAL_ERROR
          An internal SW error has been detected.


     TSS_E_BAD_PARAMETER
          One or more parameters is bad.


     TSS_E_HASH_INVALID_LENGTH
          Hash length is inconsistent with hash algorithm.


     TSS_E_HASH_NO_DATA
          Hash object has no internal hash value.


     TSS_E_INVALID_SIGSCHEME
          Invalid signature scheme.



CONFORMING TO
     Tspi_Hash_VerifySignature conforms to the Trusted  Computing
     Group Software Specification version 1.1 Golden


SEE ALSO
     Tspi_Hash_UpdateHash(3),          Tspi_Hash_SetHashValue(3),
     Tspi_Hash_Sign(3), Tspi_Hash_GetHashValue(3).


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

     __________________________________________________
    |   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.1              Last change: 2004-05-25                    2