TPMLIB_DecodeBlob man page

TPMLIB_DecodeBlob — Decode a base64-encode TPM blob

Synopsis

#include <libtpms/tpm_types.h>

#include <libtpms/tpm_library.h>

TPM_RESULT TPMLIB_DecodeBlob(const char *buffer,
enum TPMLIB_BlobType type,
unsigned char **result
size_t *result_len);

Description

The TPMLIB_DecodeBlob() function is used to decode a base64-encoded TPM state blob. The caller must pass what type of blob is expected to be decoded and following that the function will look for the start and end markers of the data.

The following types of blobs are supported along with their start and end markers:

BLOB_TYPE_INITSTATE
'-----BEGIN INITSTATE-----' marks the beginning of the base64-encoded blob.

'-----END INITSTATE-----' marks the end of the base64-encoded blob.

This function is useful when passing state to the TPM inside the callback that is invoked to get the TPM's state blob. See TPMLIB_RegisterCallbacks(3).

Errors

TPM_SUCCESS
The function completed sucessfully.
TPM_SIZE
The size of a requested buffer exceeds the limit or the system is out of memory.
TPM_FAIL
An error occurred while attempting to decode the blob.

For a complete list of TPM error codes please consult the include file libtpms/tpm_error.h

See Also

TPMLIB_MainInit(3), TPMLIB_RegisterCallbacks(3)

Referenced By

TPMLIB_MainInit(3).

2011-08-30 libtpms-0.5.1 libtpms documentation