ifapi_policy_intantiate.3 3.1 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394
  1. .TH "ifapi_policy_intantiate" 3 "Fri Oct 7 2022" "Version 3.2.0" "tpm2-tss" \" -*- nroff -*-
  2. .ad l
  3. .nh
  4. .SH NAME
  5. ifapi_policy_intantiate
  6. .SH SYNOPSIS
  7. .br
  8. .PP
  9. .SS "Functions"
  10. .in +1c
  11. .ti -1c
  12. .RI "TSS2_RC \fBifapi_policyeval_instantiate_async\fP (\fBIFAPI_POLICY_EVAL_INST_CTX\fP *context, \fBTPMS_POLICY\fP *policy, \fBifapi_policyeval_INST_CB\fP *callbacks)"
  13. .br
  14. .ti -1c
  15. .RI "TSS2_RC \fBifapi_policyeval_instantiate_finish\fP (\fBIFAPI_POLICY_EVAL_INST_CTX\fP *context)"
  16. .br
  17. .in -1c
  18. .SH "Detailed Description"
  19. .PP
  20. Provides functions for instantiation of the policies\&. The defaults will be initialized according to the given values\&.
  21. .SH "Function Documentation"
  22. .PP
  23. .SS "TSS2_RC ifapi_policyeval_instantiate_async (\fBIFAPI_POLICY_EVAL_INST_CTX\fP * context, \fBTPMS_POLICY\fP * policy, \fBifapi_policyeval_INST_CB\fP * callbacks)"
  24. Prepare instantiation a policy template\&.
  25. .PP
  26. Parts of policies which are referenced by object paths will be replaced with the appropriate values of the referenced objects\&.
  27. .PP
  28. \fBParameters:\fP
  29. .RS 4
  30. \fIcontext\fP The context storing information for re-entry after try again\&.
  31. .br
  32. \fIpolicy\fP The policy to be instantiated\&.
  33. .br
  34. \fIcallbacks\fP The needed callback functions with the corresponding user data which will be passed to the callback\&.
  35. .RE
  36. .PP
  37. \fBReturn values:\fP
  38. .RS 4
  39. \fITSS2_RC_SUCCESS\fP on success\&.
  40. .br
  41. \fIFAPI\fP error codes on failure
  42. .br
  43. \fITSS2_FAPI_RC_MEMORY\fP if not enough memory can be allocated\&.
  44. .RE
  45. .PP
  46. .SS "TSS2_RC ifapi_policyeval_instantiate_finish (\fBIFAPI_POLICY_EVAL_INST_CTX\fP * context)"
  47. Finalize instantiation a policy template\&.
  48. .PP
  49. All needed asyncroous callbacks will be executed for all policy elements offset The policy\&.
  50. .PP
  51. \fBParameters:\fP
  52. .RS 4
  53. \fIcontext\fP The context storing information for re-entry after try again\&.
  54. .RE
  55. .PP
  56. \fBReturn values:\fP
  57. .RS 4
  58. \fITSS2_RC_SUCCESS\fP on success\&.
  59. .br
  60. \fITSS2_FAPI_RC_BAD_TEMPLATE\fP If the templayte is not complete for instantiation\&.
  61. .br
  62. \fIFAPI\fP error codes on failure
  63. .br
  64. \fITSS2_FAPI_RC_TRY_AGAIN\fP if an I/O operation is not finished yet and this function needs to be called again\&.
  65. .br
  66. \fITSS2_FAPI_RC_BAD_REFERENCE\fP a invalid null pointer is passed\&.
  67. .br
  68. \fITSS2_FAPI_RC_MEMORY\fP if not enough memory can be allocated\&.
  69. .br
  70. \fITSS2_FAPI_RC_BAD_VALUE\fP if an invalid value was passed into the function\&.
  71. .br
  72. \fITSS2_FAPI_RC_GENERAL_FAILURE\fP if an internal error occurred\&.
  73. .br
  74. \fITSS2_FAPI_RC_BAD_SEQUENCE\fP if the context has an asynchronous operation already pending\&.
  75. .br
  76. \fITSS2_FAPI_RC_PATH_NOT_FOUND\fP if a FAPI object path was not found during authorization\&.
  77. .br
  78. \fITSS2_FAPI_RC_KEY_NOT_FOUND\fP if a key was not found\&.
  79. .br
  80. \fITSS2_FAPI_RC_IO_ERROR\fP if an error occurred while accessing the object store\&.
  81. .br
  82. \fITSS2_ESYS_RC_*\fP possible error codes of ESAPI\&.
  83. .br
  84. \fITSS2_FAPI_RC_NOT_PROVISIONED\fP FAPI was not provisioned\&.
  85. .br
  86. \fITSS2_FAPI_RC_BAD_PATH\fP if the path is used in inappropriate context or contains illegal characters\&.
  87. .RE
  88. .PP
  89. .SH "Author"
  90. .PP
  91. Generated automatically by Doxygen for tpm2-tss from the source code\&.