tpm_nvread(8)

💖 tpm_nvread 💖

okay bestie, welcome to the tpm_nvread page — it's the tpm_nvread(8) manual, but make it cute. let's GO ✨

🌸 SYNOPSIS 🌸

tpm_nvread [OPTIONS]

🦋 DESCRIPTION 🦋

so tpm_nvread reads data out of an NVRAM area and then either shows it to you or writes it into a file. that's the whole vibe 💅

you must give it the index of the NVRAM area — non-negotiable, it's the main character requirement 👑

if you also tell it how many bytes to read, that number becomes the maximum number of bytes it'll pull from the NVRAM area. if you don't give a size, it reads the whole NVRAM area. no cap.

heads up: some NVRAM areas only allow read sizes of zero, i.e., an NVRAM area with index 0. that's just how they are, not a bug 🫶

optionally you can hand it an offset into the NVRAM area, which is where the reading starts. and if the NVRAM area has permission bits set that require owner or NVRAM area authentication, then bestie you have to provide the password via the password option. no password, no data, it's giving locked door 🔐

the following options are supported:

✨ OPTIONS ✨

• -h, --help — displays the command usage info. when you're lost, she's there 🧭
• -v, --version — displays the command version info. identity check ⭐
• -l, --log [none|error|info|debug] — sets the logging level. pick your yap volume 🗣️
• -u, --unicode — use TSS UNICODE encoding for passwords, to comply with applications using TSS popup boxes. compatibility queen 🌈
• -z, --well-known — use a secret of all zeros (20 bytes of zeros) as either the NVRAM area or owner secret. yes, literally twenty zeros, that's the whole secret 🙈
• -p, --password — depending on what type of authentication the NVRAM area requires, this has to be either the NVRAM area password or the owner password.

a password may be directly provided, for example by using --password=password or -ppassword. if no password is provided then the program will prompt the user for the password. so either you hand it over or she asks you nicely 💬

• -i, --index — the index of the NVRAM area. the parameter may either be a decimal number or a hexadecimal number starting with 0x. 🔢
• -s, --size — the number of bytes to read from the NVRAM area. the parameter may either be a decimal number or a hexadecimal number starting with 0x. 📏
• -n, --offset (optional parameter) — the offset into the NVRAM area from where to start reading. the parameter may either be a decimal number or a hexadecimal number starting with 0x. ⏩
• -f, --filename (optional parameter) — the name of a file the read data will be written into. if no filename is given the data will be printed to stdout. choose your destiny: file or screen 🎀

👀 SEE ALSO 👀

tpm_nvdefine(8), tpm_nvinfo(8), tpm_nvrelease(8), tpm_nvwrite(8)

the whole NVRAM friend group, they all hang out together, iykyk 💖

🐛 REPORTING BUGS 🐛

found a bug? report bugs to <trousers-users@lists.sourceforge.net> — be nice, be specific, be iconic 🫶

okay that's the whole page!! this was the TPM Management manual, dated 2011-07-11, and honestly? iconic of it. go read your NVRAM bestie, ily, bye 💅✨🎀