xref: /netbsd-src/crypto/external/cpl/trousers/dist/man/man3/Tspi_DecodeBER_TssBlob.3 (revision 2d5f7628c5531eb583b9313ac2fd1cf8582b4479)
Copyright (C) 2007 International Business Machines Corporation
Written by Tom Lendacky based on the Trusted Computing Group Software Stack Specification Version 1.2

\\$1

.. ..

"\\$1" \\$2
..
"Tspi_DecodeBER_TssBlob" 3 "2007-06-12" "TSS 1.2" "TCG Software Stack Developer's Reference"
NAME
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 of the BER-encoded blob.

berBlob
Pointer to the BER-encoded blob.

blobType
Pointer to the type of blob being unwrapped (refer to the TSS_BLOB_TYPE_* constants).

rawBlobSize
Pointer to the size of the rawBlob buffer. On input this parameter contains a pointer to the maximum size of the supplied rawBlob buffer. On output this parameter contains a pointer to the actual size of the unwrapped blob. On input, if this parameter points to a value of 0, then this function will return the size of the buffer required to hold the unwrapped blob without writing to the rawBlob buffer. Note: The output data must be shorter than the BER-encoding, so berBlobSize is a useful upper limit on rawBlob buffer size.

rawBlob
Pointer to a buffer to hold the unwrapped blob.
"RETURN CODES"

Tspi_EncodeDER_TssBlob returns TSS_SUCCESS on success, otherwise one of the following values are returned:

TSS_E_BAD_PARAMETER

TSS_E_INTERNAL_ERROR - An error occurred internal to the TSS.

"CONFORMING TO"

Tspi_DecodeBER_TssBlob conforms to the Trusted Computing Group Software Specification Version 1.2

"SEE ALSO"

Tspi_DecodeBER_TssBlob(3).