tpm2_rc_decode.1 2.6 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788
  1. .\" Automatically generated by Pandoc 1.19.2.4
  2. .\"
  3. .TH "tpm2_rc_decode" "1" "" "tpm2\-tools" "General Commands Manual"
  4. .hy
  5. .SH NAME
  6. .PP
  7. \f[B]tpm2_rc_decode\f[](1) \- Decode TPM2 error codes to a human
  8. readable format.
  9. .SH SYNOPSIS
  10. .PP
  11. \f[B]tpm2_rc_decode\f[] [\f[I]OPTIONS\f[]] [\f[I]ARGUMENT\f[]]
  12. .SH DESCRIPTION
  13. .PP
  14. \f[B]tpm2_rc_decode\f[](1) \- Converts an \f[I]RC_CODE\f[] from the TPM
  15. or TSS2 software stack into human readable errors.
  16. Analogous to \f[B]strerror\f[](3), but for the TPM2 stack.
  17. .SH OPTIONS
  18. .PP
  19. This tool takes no tool specific options.
  20. .IP \[bu] 2
  21. \f[B]ARGUMENT\f[] the command line argument specifies the error code to
  22. be parsed.
  23. .SS References
  24. .SH COMMON OPTIONS
  25. .PP
  26. This collection of options are common to many programs and provide
  27. information that many users may expect.
  28. .IP \[bu] 2
  29. \f[B]\-h\f[], \f[B]\-\-help=[man|no\-man]\f[]: Display the tools
  30. manpage.
  31. By default, it attempts to invoke the manpager for the tool, however, on
  32. failure will output a short tool summary.
  33. This is the same behavior if the "man" option argument is specified,
  34. however if explicit "man" is requested, the tool will provide errors
  35. from man on stderr.
  36. If the "no\-man" option if specified, or the manpager fails, the short
  37. options will be output to stdout.
  38. .RS 2
  39. .PP
  40. To successfully use the manpages feature requires the manpages to be
  41. installed or on \f[I]MANPATH\f[], See man(1) for more details.
  42. .RE
  43. .IP \[bu] 2
  44. \f[B]\-v\f[], \f[B]\-\-version\f[]: Display version information for this
  45. tool, supported tctis and exit.
  46. .IP \[bu] 2
  47. \f[B]\-V\f[], \f[B]\-\-verbose\f[]: Increase the information that the
  48. tool prints to the console during its execution.
  49. When using this option the file and line number are printed.
  50. .IP \[bu] 2
  51. \f[B]\-Q\f[], \f[B]\-\-quiet\f[]: Silence normal tool output to stdout.
  52. .IP \[bu] 2
  53. \f[B]\-Z\f[], \f[B]\-\-enable\-errata\f[]: Enable the application of
  54. errata fixups.
  55. Useful if an errata fixup needs to be applied to commands sent to the
  56. TPM.
  57. Defining the environment TPM2TOOLS_ENABLE_ERRATA is equivalent.
  58. information many users may expect.
  59. .SH EXAMPLES
  60. .IP
  61. .nf
  62. \f[C]
  63. tpm2_rc_decode\ 0x1d5
  64. tpm:parameter(1):structure\ is\ the\ wrong\ size
  65. \f[]
  66. .fi
  67. .SH Returns
  68. .PP
  69. Tools can return any of the following codes:
  70. .IP \[bu] 2
  71. 0 \- Success.
  72. .IP \[bu] 2
  73. 1 \- General non\-specific error.
  74. .IP \[bu] 2
  75. 2 \- Options handling error.
  76. .IP \[bu] 2
  77. 3 \- Authentication error.
  78. .IP \[bu] 2
  79. 4 \- TCTI related error.
  80. .IP \[bu] 2
  81. 5 \- Non supported scheme.
  82. Applicable to tpm2_testparams.
  83. .SH BUGS
  84. .PP
  85. Github Issues (https://github.com/tpm2-software/tpm2-tools/issues)
  86. .SH HELP
  87. .PP
  88. See the Mailing List (https://lists.01.org/mailman/listinfo/tpm2)