tpm_setpresence(8)

πŸ“¦
version 1.3.9.2 Β· 2 versions
, in debian bookworm, debian trixie, fedora 43, fedora 44, nixos 26.05, nixpkgs unstable, opensuse-leap 16.0, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

πŸ’– tpm_setpresence β€” bestie's guide to TPM physical presence πŸ’–

okay so this is tpm_setpresence(8) from the System Manager's Manual, aka the little tool that tells your TPM who's actually standing at the machine 🫢


✨ NAME ✨

tpm_setpresence β€” change TPM physical presence states or settings


✨ SYNOPSIS ✨

tpm_setpresence [OPTION]

✨ DESCRIPTION ✨

so like, tpm_setpresence reports the status of the TPM's flags regarding physical presence. that's the default behavior, no cap, and you can also get there with the --status option. heads up tho: asking for a report of this status prompts for the owner password πŸ”

then we got the vibe-switchers:

  • --assert changes the TPM to the physically present state βœ…
  • --clear changes the TPM to the not present state ❌
  • --lock locks the TPM to the current physical presence state for the current boot cycle πŸ”’
  • --enable-cmd lets the TPM accept local commands to toggle physical presence states
  • --disable-cmd stops the TPM from accepting local commands to toggle physical presence states
  • --enable-hw lets the TPM accept hardware signals to toggle physical presence states
  • --disable-hw stops the TPM from accepting hardware signals to toggle physical presence states
  • --set-lifetime-lock locks the Command and Hardware enablement flags in their current state permanently. this option can never be undone. πŸ’€

before it does the thing, the system will attempt to use the owner password to display the current states β€” unless you pass --yes to answer yes to all questions.

and fr, all changes are made with the TSC_Physical Presence API. periodt.


✨ OPTIONS ✨

  • -h, --help β€” display command usage info πŸ™‹
  • -v, --version β€” display command version info 🏷️
  • -l, --log [none|error|info|debug] β€” set logging level πŸ“
  • -u, --unicode β€” use TSS UNICODE encoding for passwords, so it plays nice with applications using TSS popup boxes 🌈
  • -s, --status β€” report current physical presence states πŸ“Š
  • -a, --assert β€” assert that an admin is physically present at the machine πŸ™‹β™€οΈ
  • -c, --clear β€” remove the assertion that an admin is physically present at the machine 🧹
  • --lock β€” lock the assertions of physical presence in there current states until a reboot πŸ”’
  • --enable-cmd β€” allow use of commands to signal an admin is physically present πŸ’¬
  • --disable-cmd β€” disallow use of commands to signal an admin is physically present 🚫
  • --enable-hw β€” allow use of hardware signals to signal an admin is physically present πŸ”Œ
  • --disable-hw β€” disallow use of hardware signals to signal an admin is physically present β›”
  • --set-lifetime-lock β€” allow no further changes to the flags controling how physical presence can be signaled. this is PERMANENT. πŸ‘‘
  • -y, --yes β€” answer yes to all questions. only applicable with --set-lifetime-lock 🫑
  • -z, --well-known β€” authenticate using 20 bytes of zeros as owner password (the default TSS Well Known Secret), instead of prompting for an owner password πŸŽ€
bestie, real talk: --set-lifetime-lock is forever. like, no undo button, no take-backs, nothing. read twice, run once. πŸ’…

🌸 SEE ALSO 🌸

tpm_version(1), tpm_setenable(8), tpm_setactive(8), tpm_setownable(8), tcsd(8)


πŸ’œ REPORTING BUGS πŸ’œ

report bugs to <trousers-users@lists.sourceforge.net> β€” they wanna hear from you πŸ›


k bye bestie, go assert your presence (physically) ✨ this was TPM Management, dated 2005-05-06, serving absolute tpm_setpresence(8) realness. slay. πŸ’–