Fapi_VerifyQuote(3)

💅 NAME

Fapi_VerifyQuote — Fapi_VerifyQuote (yes bestie, the name is literally the name, iconic). This page is Fapi_VerifyQuote(3) from the Library Functions Manual, and it's all about invoking VerifyQuote either as a one-call function or in an asynchronous manner. Periodt.

✨ SYNOPSIS

Functions

TSS2_RC Fapi_VerifyQuote (FAPI_CONTEXT *context, char const *publicKeyPath, uint8_t const *qualifyingData, size_t qualifyingDataSize, char const *quoteInfo, uint8_t const *signature, size_t signatureSize, char const *pcrLog)
TSS2_RC Fapi_VerifyQuote_Async (FAPI_CONTEXT *context, char const *publicKeyPath, uint8_t const *qualifyingData, size_t qualifyingDataSize, char const *quoteInfo, uint8_t const *signature, size_t signatureSize, char const *pcrLog)
TSS2_RC Fapi_VerifyQuote_Finish (FAPI_CONTEXT *context)

🌸 Detailed Description

FAPI functions to invoke VerifyQuote either as one-call or in an asynchronous manner. That's the whole vibe: one function for the "do it now" girlies, and a pair for the "start it, then finish it later" besties. 🦋

🔥 Function Documentation

🎀 TSS2_RC Fapi_VerifyQuote (one-call)

TSS2_RC Fapi_VerifyQuote (FAPI_CONTEXT *context, char const *publicKeyPath, uint8_t const *qualifyingData, size_t qualifyingDataSize, char const *quoteInfo, uint8_t const *signature, size_t signatureSize, char const *pcrLog)

One-Call function for Fapi_VerifyQuote. It verifies that the data returned by a quote is valid. No cap, that's the whole job. ✨

Parameters

• context — The FAPI_CONTEXT
• publicKeyPath — The path to the signing key
• qualifyingData — The qualifying data nonce. May be NULL
• qualifyingDataSize — The size of qualifyingData in bytes. Must be 0 if qualifyingData is NULL
• quoteInfo — The quote information
• signature — The quote's signature
• signatureSize — The size of signature in bytes
• pcrLog — The PCR's log. May be NULL

Return values

• TSS2_RC_SUCCESS — if the function call was a success.
• TSS2_FAPI_RC_BAD_REFERENCE — if context, publicKeyPath, quoteInfo, or signature is NULL.
• TSS2_FAPI_RC_BAD_CONTEXT — if context corruption is detected.
• TSS2_FAPI_RC_KEY_NOT_FOUND — if path does not map to a FAPI entity.
• TSS2_FAPI_RC_BAD_KEY — if the entity at path is not a key, or is a key that is unsuitable for the requested operation.
• TSS2_FAPI_RC_BAD_VALUE — if quoteInfo, pcrEventLog, qualifyingData, or signature is invalid.
• TSS2_FAPI_RC_BAD_SEQUENCE — if the context has an asynchronous operation already pending.
• TSS2_FAPI_RC_IO_ERROR — if the data cannot be saved.
• TSS2_FAPI_RC_MEMORY — if the FAPI cannot allocate enough memory for internal operations or return parameters.
• TSS2_FAPI_RC_PATH_NOT_FOUND — if a FAPI object path was not found during authorization.
• TSS2_FAPI_RC_TRY_AGAIN — if an I/O operation is not finished yet and this function needs to be called again.
• TSS2_FAPI_RC_GENERAL_FAILURE — if an internal error occurred.
• TSS2_FAPI_RC_SIGNATURE_VERIFICATION_FAILED — if the signature could not be verified
• TSS2_FAPI_RC_NOT_PROVISIONED — FAPI was not provisioned.
• TSS2_FAPI_RC_BAD_PATH — if the path is used in inappropriate context or contains illegal characters.

🧚 TSS2_RC Fapi_VerifyQuote_Async

TSS2_RC Fapi_VerifyQuote_Async (FAPI_CONTEXT *context, char const *publicKeyPath, uint8_t const *qualifyingData, size_t qualifyingDataSize, char const *quoteInfo, uint8_t const *signature, size_t signatureSize, char const *pcrLog)

Asynchronous function for Fapi_VerifyQuote. It verifies that the data returned by a quote is valid. Call Fapi_VerifyQuote_Finish to finish the execution of this command. It's giving "start the mission, then come back for the finale" energy. 💅

Parameters

• context — The FAPI_CONTEXT
• publicKeyPath — The path to the signing key
• qualifyingData — The qualifying data nonce. May be NULL
• qualifyingDataSize — The size of qualifyingData in bytes. Must be 0 if qualifyingData is NULL
• quoteInfo — The quote information
• signature — The quote's signature
• signatureSize — The size of signature in bytes
• pcrLog — The PCR's log. May be NULL

Return values

• TSS2_RC_SUCCESS — if the function call was a success.
• TSS2_FAPI_RC_BAD_REFERENCE — if context, publicKeyPath, quoteInfo, or signature is NULL.
• TSS2_FAPI_RC_BAD_CONTEXT — if context corruption is detected.
• TSS2_FAPI_RC_KEY_NOT_FOUND — if path does not map to a FAPI entity.
• TSS2_FAPI_RC_BAD_KEY — if the entity at path is not a key, or is a key that is unsuitable for the requested operation.
• TSS2_FAPI_RC_BAD_VALUE — if quoteInfo, pcrEventLog, qualifyingData, or signature is invalid.
• TSS2_FAPI_RC_BAD_SEQUENCE — if the context has an asynchronous operation already pending.
• TSS2_FAPI_RC_IO_ERROR — if the data cannot be saved.
• TSS2_FAPI_RC_MEMORY — if the FAPI cannot allocate enough memory for internal operations or return parameters.
• TSS2_FAPI_RC_PATH_NOT_FOUND — if a FAPI object path was not found during authorization.
• TSS2_FAPI_RC_NOT_PROVISIONED — FAPI was not provisioned.
• TSS2_FAPI_RC_BAD_PATH — if the path is used in inappropriate context or contains illegal characters.

🦋 TSS2_RC Fapi_VerifyQuote_Finish

TSS2_RC Fapi_VerifyQuote_Finish (FAPI_CONTEXT *context)

Asynchronous finish function for Fapi_VerifyQuote. This function should be called after a previous Fapi_VerifyQuote_Async. It's the "okay bestie, wrap it up" part of the async situation. 🎀

Parameters

• context — The FAPI_CONTEXT

Return values

• TSS2_RC_SUCCESS — if the function call was a success.
• TSS2_FAPI_RC_BAD_REFERENCE — if context is NULL.
• TSS2_FAPI_RC_BAD_CONTEXT — if context corruption is detected.
• TSS2_FAPI_RC_BAD_SEQUENCE — if the context has an asynchronous operation already pending.
• TSS2_FAPI_RC_IO_ERROR — if the data cannot be saved.
• TSS2_FAPI_RC_MEMORY — if the FAPI cannot allocate enough memory for internal operations or return parameters.
• TSS2_FAPI_RC_TRY_AGAIN — if the asynchronous operation is not yet complete. Call this function again later.
• TSS2_FAPI_RC_BAD_VALUE — if an invalid value was passed into the function.
• TSS2_FAPI_RC_GENERAL_FAILURE — if an internal error occurred.
• TSS2_FAPI_RC_SIGNATURE_VERIFICATION_FAILED — if the signature could not be verified

💖 Author

Generated automatically by Doxygen for tpm2-tss from the source code. Slay, automation. 🤖✨

---

Okay that's the whole page, bestie 🫶 — the footer gives you tpm2-tss, Version 4.1.5, and Fapi_VerifyQuote(3), so that's the official sign-off vibe: source/version/title, no extra date drama. 💅🌸