Esys_Clear.3 2.6 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465
  1. .TH "Esys_Clear" 3 "Fri Oct 7 2022" "Version 3.2.0" "tpm2-tss" \" -*- nroff -*-
  2. .ad l
  3. .nh
  4. .SH NAME
  5. Esys_Clear
  6. .SH SYNOPSIS
  7. .br
  8. .PP
  9. .SS "Functions"
  10. .in +1c
  11. .ti -1c
  12. .RI "TSS2_RC \fBEsys_Clear_Async\fP (\fBESYS_CONTEXT\fP *esysContext, \fBESYS_TR\fP authHandle, \fBESYS_TR\fP shandle1, \fBESYS_TR\fP shandle2, \fBESYS_TR\fP shandle3)"
  13. .br
  14. .in -1c
  15. .SH "Detailed Description"
  16. .PP
  17. ESAPI function to invoke the TPM2_Clear command either as a one-call or in an asynchronous manner\&.
  18. .SH "Function Documentation"
  19. .PP
  20. .SS "TSS2_RC Esys_Clear_Async (\fBESYS_CONTEXT\fP * esysContext, \fBESYS_TR\fP authHandle, \fBESYS_TR\fP shandle1, \fBESYS_TR\fP shandle2, \fBESYS_TR\fP shandle3)"
  21. Asynchronous function for TPM2_Clear
  22. .PP
  23. This function invokes the TPM2_Clear command in a asynchronous variant\&. This means the function will return as soon as the command has been sent downwards the stack to the TPM\&. All input parameters are const\&. In order to retrieve the TPM's response call Esys_Clear_Finish\&.
  24. .PP
  25. \fBParameters:\fP
  26. .RS 4
  27. \fIesysContext\fP The \fBESYS_CONTEXT\fP\&.
  28. .br
  29. \fIauthHandle\fP TPM2_RH_LOCKOUT or TPM2_RH_PLATFORM+{PP}\&.
  30. .br
  31. \fIshandle1\fP Session handle for authorization of authHandle
  32. .br
  33. \fIshandle2\fP Second session handle\&.
  34. .br
  35. \fIshandle3\fP Third session handle\&.
  36. .RE
  37. .PP
  38. \fBReturn values:\fP
  39. .RS 4
  40. \fIESYS_RC_SUCCESS\fP if the function call was a success\&.
  41. .br
  42. \fITSS2_ESYS_RC_BAD_REFERENCE\fP if the esysContext or required input pointers or required output handle references are NULL\&.
  43. .br
  44. \fITSS2_ESYS_RC_BAD_CONTEXT\fP if esysContext corruption is detected\&.
  45. .br
  46. \fITSS2_ESYS_RC_MEMORY\fP if the ESAPI cannot allocate enough memory for internal operations or return parameters\&.
  47. .br
  48. \fITSS2_RCs\fP produced by lower layers of the software stack may be returned to the caller unaltered unless handled internally\&.
  49. .br
  50. \fITSS2_ESYS_RC_MULTIPLE_DECRYPT_SESSIONS\fP if more than one session has the 'decrypt' attribute bit set\&.
  51. .br
  52. \fITSS2_ESYS_RC_MULTIPLE_ENCRYPT_SESSIONS\fP if more than one session has the 'encrypt' attribute bit set\&.
  53. .br
  54. \fITSS2_ESYS_RC_BAD_TR\fP if any of the ESYS_TR objects are unknown to the \fBESYS_CONTEXT\fP or are of the wrong type or if required ESYS_TR objects are ESYS_TR_NONE\&.
  55. .br
  56. \fITSS2_ESYS_RC_NO_DECRYPT_PARAM\fP if one of the sessions has the 'decrypt' attribute set and the command does not support encryption of the first command parameter\&.
  57. .br
  58. \fITSS2_ESYS_RC_NO_ENCRYPT_PARAM\fP if one of the sessions has the 'encrypt' attribute set and the command does not support encryption of the first response parameter\&.
  59. .RE
  60. .PP
  61. .SH "Author"
  62. .PP
  63. Generated automatically by Doxygen for tpm2-tss from the source code\&.