Go to main content

man pages section 3: Library Interfaces and Headers

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

Tspi_GetAttribData (3)

Name

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

TCG Software Stack Developer's Reference                 Tspi_GetAttribData(3)



NAME
       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 attribute does not  hap-
       pen  to  be  a UINT32. The structure and size of the attribute data de-
       pends on the attribute.

PARAMETERS
   hObject
       Handle of the object where to retrieve the attribute.

   attribFlag
       Flag indicating the attribute to query.

   subFlag
       Sub flag indicating the attribute to query.

   pulAttribDataSize
       Recieves the length (in bytes) of the prgbAttribData parameter.

   prgbAttribData
       On successful completion of the command, this  parameter  points  to  a
       buffer containing the actual data of the specified attribute.

RETURN CODES
       Tspi_GetAttribData returns TSS_SUCCESS on success, otherwise one of the
       following values are returned:

       TSS_E_INVALID_HANDLE - Either hObject, attribFlag, or subFlag  are  in-
       valid.

       TSS_E_ATTRIB_FLAG

       TSS_E_ATTRIB_SUBFLAG

       TSS_E_ATTRIB_DATA

       TSS_E_BAD_PARAMETER

       TSS_E_INTERNAL_ERROR - An error occurred internal to the TSS.

CONFORMING TO
       Tspi_GetAttribData  conforms  to  the  Trusted Computing Group Software
       Specification version 1.1 Golden


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


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

SEE ALSO
       Tspi_SetAttribData(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.1                           2004-05-26             Tspi_GetAttribData(3)