Esys_LoadExternal.3 4.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102
  1. .TH "Esys_LoadExternal" 3 "Fri Oct 7 2022" "Version 3.2.0" "tpm2-tss" \" -*- nroff -*-
  2. .ad l
  3. .nh
  4. .SH NAME
  5. Esys_LoadExternal
  6. .SH SYNOPSIS
  7. .br
  8. .PP
  9. .SS "Functions"
  10. .in +1c
  11. .ti -1c
  12. .RI "TSS2_RC \fBEsys_LoadExternal_Finish\fP (\fBESYS_CONTEXT\fP *esysContext, \fBESYS_TR\fP *objectHandle)"
  13. .br
  14. .ti -1c
  15. .RI "TSS2_RC \fBEsys_Load_Finish\fP (\fBESYS_CONTEXT\fP *esysContext, \fBESYS_TR\fP *objectHandle)"
  16. .br
  17. .in -1c
  18. .SH "Detailed Description"
  19. .PP
  20. ESAPI function to invoke the TPM2_LoadExternal command either as a one-call or in an asynchronous manner\&.
  21. .SH "Function Documentation"
  22. .PP
  23. .SS "TSS2_RC Esys_Load_Finish (\fBESYS_CONTEXT\fP * esysContext, \fBESYS_TR\fP * objectHandle)"
  24. Asynchronous finish function for TPM2_Load
  25. .PP
  26. This function returns the results of a TPM2_Load command invoked via Esys_Load_Finish\&. All non-simple output parameters are allocated by the function's implementation\&. NULL can be passed for every output parameter if the value is not required\&.
  27. .PP
  28. \fBParameters:\fP
  29. .RS 4
  30. \fIesysContext\fP The \fBESYS_CONTEXT\fP\&.
  31. .br
  32. \fIobjectHandle\fP ESYS_TR handle of ESYS resource for TPM2_HANDLE\&.
  33. .RE
  34. .PP
  35. \fBReturn values:\fP
  36. .RS 4
  37. \fITSS2_RC_SUCCESS\fP on success
  38. .br
  39. \fIESYS_RC_SUCCESS\fP if the function call was a success\&.
  40. .br
  41. \fITSS2_ESYS_RC_BAD_REFERENCE\fP if the esysContext or required input pointers or required output handle references are NULL\&.
  42. .br
  43. \fITSS2_ESYS_RC_BAD_CONTEXT\fP if esysContext corruption is detected\&.
  44. .br
  45. \fITSS2_ESYS_RC_MEMORY\fP if the ESAPI cannot allocate enough memory for internal operations or return parameters\&.
  46. .br
  47. \fITSS2_ESYS_RC_BAD_SEQUENCE\fP if the context has an asynchronous operation already pending\&.
  48. .br
  49. \fITSS2_ESYS_RC_TRY_AGAIN\fP if the timeout counter expires before the TPM response is received\&.
  50. .br
  51. \fITSS2_ESYS_RC_INSUFFICIENT_RESPONSE\fP if the TPM's response does not at least contain the tag, response length, and response code\&.
  52. .br
  53. \fITSS2_ESYS_RC_RSP_AUTH_FAILED\fP if the response HMAC from the TPM did not verify\&.
  54. .br
  55. \fITSS2_ESYS_RC_MALFORMED_RESPONSE\fP if the TPM's response is corrupted\&.
  56. .br
  57. \fITSS2_RCs\fP produced by lower layers of the software stack may be returned to the caller unaltered unless handled internally\&.
  58. .RE
  59. .PP
  60. .SS "TSS2_RC Esys_LoadExternal_Finish (\fBESYS_CONTEXT\fP * esysContext, \fBESYS_TR\fP * objectHandle)"
  61. Asynchronous finish function for TPM2_LoadExternal
  62. .PP
  63. This function returns the results of a TPM2_LoadExternal command invoked via Esys_LoadExternal_Finish\&. All non-simple output parameters are allocated by the function's implementation\&. NULL can be passed for every output parameter if the value is not required\&.
  64. .PP
  65. \fBParameters:\fP
  66. .RS 4
  67. \fIesysContext\fP The \fBESYS_CONTEXT\fP\&.
  68. .br
  69. \fIobjectHandle\fP ESYS_TR handle of ESYS resource for TPM2_HANDLE\&.
  70. .RE
  71. .PP
  72. \fBReturn values:\fP
  73. .RS 4
  74. \fITSS2_RC_SUCCESS\fP on success
  75. .br
  76. \fIESYS_RC_SUCCESS\fP if the function call was a success\&.
  77. .br
  78. \fITSS2_ESYS_RC_BAD_REFERENCE\fP if the esysContext or required input pointers or required output handle references are NULL\&.
  79. .br
  80. \fITSS2_ESYS_RC_BAD_CONTEXT\fP if esysContext corruption is detected\&.
  81. .br
  82. \fITSS2_ESYS_RC_MEMORY\fP if the ESAPI cannot allocate enough memory for internal operations or return parameters\&.
  83. .br
  84. \fITSS2_ESYS_RC_BAD_SEQUENCE\fP if the context has an asynchronous operation already pending\&.
  85. .br
  86. \fITSS2_ESYS_RC_TRY_AGAIN\fP if the timeout counter expires before the TPM response is received\&.
  87. .br
  88. \fITSS2_ESYS_RC_INSUFFICIENT_RESPONSE\fP if the TPM's response does not at least contain the tag, response length, and response code\&.
  89. .br
  90. \fITSS2_ESYS_RC_RSP_AUTH_FAILED\fP if the response HMAC from the TPM did not verify\&.
  91. .br
  92. \fITSS2_ESYS_RC_MALFORMED_RESPONSE\fP if the TPM's response is corrupted\&.
  93. .br
  94. \fITSS2_RCs\fP produced by lower layers of the software stack may be returned to the caller unaltered unless handled internally\&.
  95. .RE
  96. .PP
  97. .SH "Author"
  98. .PP
  99. Generated automatically by Doxygen for tpm2-tss from the source code\&.