Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
Tspi_Hash_Sign(3)	    Library Functions Manual	       Tspi_Hash_Sign(3)

		    TCG Software Stack Developer's Reference

NAME
     Tspi_Hash_Sign - sign the hash data of an object with a signing key

SYNOPSIS
     #include <tss/platform.h>
     #include <tss/tcpa_defines.h>
     #include <tss/tcpa_typedef.h>
     #include <tss/tcpa_struct.h>
     #include <tss/tss_typedef.h>
     #include <tss/tss_structs.h>
     #include <tss/tspi.h>

     TSS_RESULT Tspi_Hash_Sign(TSS_HHASH hHash, 	     TSS_HKEY hKey,
			       UINT32	 pulSignatureLength, BYTE**   prgbSignature);

DESCRIPTION
     Tspi_Hash_Sign  signs  the hash data of an object with a given signing key.
     The data must be set at the hash instance associated with hHash by  calling
     Tspi_Hash_SetHashValue  or  Tspi_Hash_UpdateHashValue.  The  Tspi_Hash_Sign
     method allocates a memory block for the  prgbSignature  data.  This  memory
     must be released using Tspi_Context_FreeMemory.

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 signature.

   pulSignatureLength
     Receives  the  length of the signature data returned at the parameter prgb-
     Signature on successful completion.

   prgbSignature
     Receives a pointer to the signature data on successful completion.

RETURN CODES
     Tspi_Hash_Sign returns TSS_SUCCESS on success, otherwise one of the follow-
     ing values is returned:

     TSS_E_INVALID_HANDLE
	    hKey is not a valid handle.

     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_HASH_NO_IDENTIFIER
	    The hash algorithm identifier is not set.

CONFORMING TO
     Tspi_Hash_Sign conforms to the Trusted Computing Group Software  Specifica-
     tion version 1.1 Golden

SEE ALSO
     Tspi_Hash_UpdateHashValue(3),   Tspi_Hash_SetHashValue(3),  Tspi_Hash_Veri-
     fySignature(3).

TSS 1.1 			   2004-05-25		       Tspi_Hash_Sign(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=Tspi_Hash_Sign&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help