Linux Manuals session 3

TCG Software Stack Developer’s Reference Name Tspi_Hash_VerifySignature – verify the hash value with a given signature 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_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….

TCG Software Stack Developer’s Reference Name Tspi_Hash_UpdateHashValue – update the hash value of a hash object 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_UpdateHashValue(TSS_HHASH hHash, UINT32 ulDataLength, BYTE* rgbData); Description Tspi_Hash_UpdateHashValue updates the hash value of a hash object with new information. If the object was…

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…

TCG Software Stack Developer’s Reference Name Tspi_Hash_SetHashValue – Sets the hash value of a hash object for non-SHA1 hash objects. 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_SetHashValue(TSS_HHASH hHash, UINT32 ulHashValueLength, BYTE* rgbHashValue); Description Tspi_Hash_SetHashValue sets the hash value of a hash object. If the object…

TCG Software Stack Developer’s Reference Name Tspi_Hash_GetHashValue – get the current hash value of a hash object 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_GetHashValue(TSS_HHASH hHash, UINT32* pulHashValueLength, BYTE** prgbHashValue); Description Tspi_Hash_GetHashValue gets the hash value of a hash object. Tspi_Context_FreeMemory must be used to clean…

TCG Software Stack Developers Reference Name Tspi_GetPolicyObject – get a policy object assigned to a working object 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_GetPolicyObject(TSS_HOBJECT hObject, TSS_FLAG policyType, TSS_HPOLICY* phPolicy); Description Tspi_GetPolicyObject returns a policy object currently assigned to a working object. If you determine that…

TCG Software Stack Developers Reference Name Tspi_GetAttribUint32 – get the value of particular attribute associated with a given class or object 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_GetAttribUint32(TSS_HOBJECT hObject, TSS_FLAG attribFlag, TSS_FLAG subFlag, UINT32* pulAttrib); Description Tspi_GetAttribUint32 returns a specified uint32 attribute associated with a…

Tspi_GetAttribData – get a non 32bit attribute of the object. 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_GetAttribData(TSS_HOBJECT hObject, TSS_FLAG attribFlag, TSS_FLAG subFlag, UINT32* pulAttribDataSize, BYTE** prgbAttribData); Description Tspi_GetAttribData is used to get the value of a particular attribute associated iwth a particular object where that…

Tspi_EncodeDER_TssBlob – generate a DER encoded TSS blob. Synopsis #include <tss/tspi.h> TSS_RESULT Tspi_EncodeDER_TssBlob(UINT32 rawBlobSize, BYTE* rawBlob, UINT32 blobType, UINT32* derBlobSize, BYTE* derBlob); Description Tspi_EncodeDER_TssBlob is used to generate a DER-encoded blob in accordance with the ASN.1 data definitions in the Portable Data section of the Trusted Computing Group Software Stack Specification Version 1.2. Parameters rawBlobSize…

Tspi_DecodeBER_TssBlob – unwraps a BER-encoded TSS blob. Synopsis #include <tss/tspi.h> TSS_RESULT Tspi_DecodeBER_TssBlob(UINT32 berBlobSize, BYTE* berBlob, UINT32* blobType, UINT32* rawBlobSize, BYTE* rawBlob); Description Tspi_DecodeBER_TssBlob is used to unwrap a BER-encoded blob in accordance with the ASN.1 data definitions in the Portable Data section of the Trusted Computing Group Software Stack Specification Version 1.2. Parameters berBlobSize Size…

Tspi_Data_Unseal – dencrypt data encrypted by Tspi_Data_Seal() only if it was encrypted on the same platform and under the current configuration. 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_Data_Unseal(TSS_HENCDATA hEncData, TSS_HKEY hKey, UINT32 pulUnsealedDataLength, BYTE** prgbUnsealedData); Description Tspi_Data_Unseal reveals data encrypted by the Tspi_Data_Seal only if…

TCG Software Stack Developer’s Reference Name Tspi_Data_Unbind – Decrypts data that has been bound to a 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_Data_Unbind(TSS_HENCDATA hEncData, TSS_HKEY hEncKey, UINT32* pulUnboundDataLength, BYTE** prgbUnboundData); Description Tspi_Data_Unbind decrypts the encrypted data blob exportedfrom the data object used in Tspi_Data_Bind….

Tspi_Data_Seal – encrypt a data blob in a mannar that is only decryptable by Tspi_Data_Unseal on the same system. 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_Data_Seal(TSS_HENCDATA hEncData, TSS_HKEY hEncKey, UINT32 ulDataLength, BYTE* rgbDataToSeal, TSS_HPCRS hPcrComposite); Description Tspi_Data_Seal encrypts a data blob in a mannar that…

TCG Software Stack Developer’s Reference Name Tspi_Data_Bind – Encrypts a data blob 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_Data_Bind(TSS_HENCDATA hEncData, TSS_HKEY hEncKey, UINT32 ulDataLength, BYTE* rgbDataToBind); Description Tspi_Data_Bind encrypts a data blob in a manner that is decryptable by Tspi_Data_Unbind. The data blob is encrypted…

Tspi_Context_UnregisterKey – unregister a key from the persistent storage device. 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_Context_UnregisterKey(TSS_HCONTEXT hContext, TSS_FLAG persistentStorageType, TSS_UUID uuidKey, TSS_HKEY* phKey); Description TSS_Context_UnregisterKey provides the capabilities of the TSS Core Service or TSS Service Provider Parameters hContext The handle of the context…

TCG Software Stack Developers Reference Name Tspi_Context_RegisterKey – register a key in the TSS Persistent Storage database 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_Context_RegisterKey(TSS_HCONTEXT hContext, TSS_HKEY hKey, TSS_FLAG persistentStorageType, TSS_UUID uuidKey, TSS_FLAG persistentStorageTypeParent, TSS_UUID uuidParentKey); Description Tspi_Context_RegisterKey is the API that registers a key with…

Tspi_Context_LoadKeyByUUID – load a key that’s been registered in persistent storage. 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_Context_LoadKeyByUUID(TSS_HCONTEXT hContext, TSS_FLAG persistentStorageType, TSS_UUID uuidData, TSS_HKEY* phKey); Description TSS_Context_LoadKeyByUUID creates a key object based on the information got from the manager using the UUID and loads the…

TCG Software Stack Developers Reference Name Tspi_Context_LoadKeyByBlob – load a key into the TPM using the key’s blob. 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_Context_LoadKeyByBlob(TSS_HCONTEXT hContext, TSS_HKEY hUnwrappingKey, UINT32 ulBlobLength, BYTE* rgbBlobData, TSS_HKEY* phKey); Description Tspi_Context_LoadKeyByBlob creates a key based on the information gotten by…

TCG Software Stack Developers Reference Name Context_GetTpmObject – get the handle of the TPM object associated with a context. 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_Context_GetTpmObject(TSS_HCONTEXT hContext, TSS_HTPM* phTPM); Description Tspi_Context_GetTpmObject retrieves the TPM object of a context. Only one instance of this object exists…

Tspi_Context_GetRegisteredKeysByUUID2 – get an array of TSS_KM_KEYINFO2 structures based on the state of persistent storage. 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_Context_GetRegisteredKeysByUUID2(TSS_HCONTEXT hContext, TSS_FLAG persistentStorageType, TSS_UUID* pUuidData, UINT32* pulKeyHierarchySize, TSS_KM_KEYINFO2** ppKeyHierarchy); Description TSS_Context_GetRegisteredKeysByUUID2 gets an array of TSS_KM_KEYINFO2 structures. This information reflects the state of…