FreeBSD Manual Pages
Tss2_TctiLdr_GetInfo(3) Library Functions Manual Tss2_TctiLdr_GetInfo(3) NAME Tss2_TctiLdr_GetInfo - Query TctiLdr library for the TSS2_TCTI_INFO structure associated with a TCTI library. SYNOPSIS #include <tss2/tss2_tctildr.h> TSS2_RC Tss2_TctiLdr_GetInfo (constchar *name", TSS2_TCTI_INFO **info); DESCRIPTION The Tss2_TctiLdr_GetInfo() function attempts to instantiate a TSS2_TCTI_INFO structure appropriate for the TCTI library associated with the provided name. The TSS2_TCTI_INFO* reference returned by this function must be freed by the Tss2_TctiLdr_FreeInfo () function. The name parameter is a C string. If this string is NULL then the li- brary will select a default TCTI for the caller. This is the same TCTI library that will be used to initialize the context returned by Tss2_TctiLdr_Initialize when passed a NULL name. If non-NULL, the Tss2_TctiLdr_GetInfo () uses the same algorithm to map the string to the name of an installed TCTI library as the Tss2_TctiLdr_Initialize () function. The info parameter is a reference to a TSS2_TCTI_INFO*. The reference returned will be allocated by the function and must be freed by the caller. RETURN VALUE A successful call to this function will return TSS2_RC_SUCCESS. An un- successful call to this function will return a response code described below in section ERRORS. ERRORS TSS2_TCTI_RC_MEMORY is returned if memory allocation fails TSS2_TCTI_RC_NOT_SUPPORTED is returned when the loader is unable to lo- cate a TCTI library with the provided name TSS2_TCTI_RC_IO_ERROR is returned if a failure occurs in the underlying library loading mechanism TSS2_TCTI_RC_BAD_REFERENCE is returned if the info parameter is NULL EXAMPLE Example code. #include <inttypes.h> #include <stdlib.h> #include <stdio.h> #include <tss2/tss2_tctildr.h> TSS2_TCTI_INFO *info = NULL; TSS2_RC rc = Tss2_TctiLdr_GetInfo (NULL, &info); if (rc != TSS2_RC_SUCCESS) { fprintf (stderr, "Initialization of default TCTI context failed with " "response code: 0x%" PRIx32 "0, rc); exit (EXIT_FAILURE); } if (info != NULL) { Tss2_TctiLdr_FreeInfo (info); info = NULL; } exit (EXIT_SUCCESS); AUTHOR TPM2 Software Project <https://github.com/tpm2-software/tpm2-tss> SEE ALSO Tss2_Tcti_Device_Init(3), Tss2_Tcti_Socket_Init(3), Tss2_TctiLdr_Ini- tialize(3), Tss2_TctiLdr_Finalize(3), tcti-device(7), tcti-socket(7), tcti-tabrmd(7), tpm2-abrmd(8) COLOPHON This page is part of release 4.0.1 of Open Source implementation of the TCG TPM2 Software Stack (TSS2). A description of the project, informa- tion about reporting bugs, and the latest version of this page can be found at https://github.com/tpm2-software/tpm2-tss/. TPM2 Software Stack JUNE 2019 Tss2_TctiLdr_GetInfo(3)
NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | ERRORS | EXAMPLE | AUTHOR | SEE ALSO | COLOPHON
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=Tss2_TctiLdr_GetInfo&sektion=3&manpath=FreeBSD+Ports+14.3.quarterly>