Go to main content

man pages section 3: Library Interfaces and Headers

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

Tspi_DecodeBER_TssBlob (3)

Name

Tspi_DecodeBER_TssBlob - encoded TSS blob.

Synopsis

#include <tss/tspi.h>

TSS_RESULT Tspi_DecodeBER_TssBlob(UINT32  berBlobSize, BYTE*   berBlob,
UINT32* blobType,    UINT32* rawBlobSize,
BYTE*   rawBlob);

Description

TCG Software Stack Developer's Reference             Tspi_DecodeBER_TssBlob(3)



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 accor-
       dance 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


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+---------------------------+
       |ATTRIBUTE TYPE |     ATTRIBUTE VALUE       |
       +---------------+---------------------------+
       |Availability   | library/security/trousers |
       +---------------+---------------------------+
       |Stability      | Uncommitted               |
       +---------------+---------------------------+

SEE ALSO
       Tspi_DecodeBER_TssBlob(3).






NOTES
       Source code for open source software components in Oracle  Solaris  can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-
       code-downloads.html.

       This software was built from source available at https://github.com/or-
       acle/solaris-userland.   The  original  community source was downloaded
       from                                                    https://source-
       forge.net/projects/trousers/files/trousers/0.3.15/trousers-0.3.15.tar.gz.

       Further information about this software can be found on the open source
       community website at http://trousers.sourceforge.net/.



TSS 1.2                           2007-06-12         Tspi_DecodeBER_TssBlob(3)