tpm2_rc_decode(1)

📦
version 5.8 · 10 versions
, in arch rolling

🎀 NAME 🎀

Okay bestie, meet tpm2_rc_decode(1) — yes, from the General Commands Manual — and her whole thing is decoding TPM2 error codes into a human readable format. She’s the friend who translates cryptic TPM feelings into actual words 💖.

✨ SYNOPSIS ✨

tpm2_rc_decode [OPTIONS] [ARGUMENT]

🦋 DESCRIPTION 🦋

tpm2_rc_decode(1) converts an RC_CODE from the TPM or TSS2 software stack into human readable errors. Literally analogous to strerror(3), but for the TPM2 stack. It’s giving “error whisperer, but make it TPM” 🔥.

💅 OPTIONS 💅

This tool takes no tool specific options. Not a drill, she’s minimal like that ✨.

  • ARGUMENT — the command line argument specifies the error code to be parsed. Drop that RC_CODE in and let her cook 🍓.

🌸 References 🌸

(no references are listed here — the heading is just standing there looking pretty 🫶)

💖 COMMON OPTIONS 💖

This collection of options are common to many programs and provide information that many users may expect. Basically the group-chat regulars of the tpm2-tools universe 👑.

  • -h, --help=[man|no-man] — Display the tool’s manpage. By default, it attempts to invoke the manpager for the tool, however, on failure will output a short tool summary. This is the same behavior if the man option argument is specified; however, if explicit man is requested, the tool will provide errors from man on stderr. If the no-man option is specified (yes, the original says “if” twice — she’s quirky 💀), or the manpager fails, the short options will be output to stdout. To successfully use the manpages feature requires the manpages to be installed or on MANPATH, See man(1) for more details.
  • -v, --version — Display version information for this tool, supported tctis and exit. Slay, then bye 👋.
  • -V, --verbose — Increase the information that the tool prints to the console during its execution. When using this option the file and line number are printed. She’s nosy in a helpful way 🔍.
  • -Q, --quiet — Silence normal tool output to stdout. Shhh bestie, she’s in her quiet era 🤫.
  • -Z, --enable-errata — Enable the application of errata fixups. Useful if an errata fixup needs to be applied to commands sent to the TPM. Defining the environment TPM2TOOLS_ENABLE_ERRATA is equivalent. Errata but make it fashion 💅.
  • -z, --pwd-session — Use password session instead of a HMAC session for authentication. A clear text password is passed to the TPM to authorize the action. This option can be used to avoid problems when unsalted sessions are used in OpenSSL FIPS mode. If auth values are used a salted session should be used for authentication. Security tea, sip responsibly 🍵.
  • -R, --autoflush — Enable autoflush for transient objects created by the command. If a parent object is loaded from a context file also the transient parent object will be flushed. Autoflush can also be activated if the environment variable TPM2TOOLS_AUTOFLUSH is is set to yes or true. information many users may expect. Yes, the bullet really ends with information many users may expect. — she left that little garnish there 🍓.

🌈 EXAMPLES 🌈

tpm2_rc_decode 0x1d5
tpm:parameter(1):structure is the wrong size

Look at her go — decoded and cute 💖.

👑 Returns 👑

Tools can return any of the following codes:

  • 0 — Success. Periodt.
  • 1 — General non-specific error.
  • 2 — Options handling error.
  • 3 — Authentication error.
  • 4 — TCTI related error.
  • 5 — Non supported scheme. Applicable to tpm2_testparams.

🐛 BUGS 🐛

Github Issues. That’s it, that’s the section. She’s succinct 💀.

🆘 HELP 🆘

See the Mailing List.

📜 License 📜

This work is licensed under the Creative Commons Attribution 4.0 International License (CC BY 4.0).

Cute sign-off: source/version vibes from the footer are tpm2-tools, the manual page name is tpm2_rc_decode(1), and there’s no date printed in this footer — so she’s timeless, bestie 🧚✨💜.

📦 where this page comes from