MSRTOOL(8)

💖 MSRTOOL 💖

okay bestie, so this is msrtool, a System Administration Utilities situation, and she is the girl for dumping chipset-specific MSR registers. no cap. 🎀

✨ NAME ✨

msrtool — dumps chipset-specific MSR registers. that's it, that's the whole personality. 💅

🌸 SYNOPSIS 🌸

msrtool [-hvqrkl] [-c cpu] [-m system] [-t target ...] [-i addr=hi[:]lo]
| [-s file] | [-d [:]file] | addr...

yes the line break and the | are real, she's just like that. ✨

🦋 DESCRIPTION 🦋

Dumps chipset-specific MSR registers.

literally the entire description. short, iconic, to the point. the way that she said one sentence and meant it 🫶

👑 OPTIONS 👑

• -h — shows you this help text. your girl is helpful 💖
• -v — be verbose. spill the tea, tell me everything ✨
• -q — be quiet. and heads up: this one overrides -v, so -q wins the argument, no discussion 😌
• -r — include [Reserved] values. yes bestie, the reserved ones, we're looking at those too 🙈
• -k — list all known systems and targets. the full roster, the whole cast 🌈
• -l — list MSRs and bit fields for the current target(s). and listen: -kl gets you ALL targets. all of them. every single one. go off 👑
• -c — access MSRs on the specified CPU. default is 0. yes, default=0, that's canon
• -m — force a system, e.g: -m linux 🐧
• -t — force a target. you can use this one multiple times, e.g: -t geodelx -t cs5536. stack 'em, she can handle it 💅
• -i — immediate mode decodes hex addr=hi:lo for the target without reading the hw value. e.g: -i 4c00000f=f2f100ff56960004 no hardware, just vibes and decoding ✨
• -s — stream mode reads one MSR address per line and appends the current hw value to the line. use the filename - for stdin/stdout, classic move. and if you use -l -s? it ignores input and will output all MSRs with values. so much output. she's generous like that 🎀
• -d — diff mode reads one address and value per line and compares with the current hw value, printing differences to stdout. use the filename - to read from stdin. use :file or :- to reverse diff — normally hw values are considered new, so this flips that around 🔄 and there's addr.. direct mode: read and decode values for the given MSR address(es) 🔥

quick vibe check: that addr... at the end of the synopsis is the direct mode, where you just hand her addresses and she reads and decodes them for you. main character energy, honestly.

🫶 AUTHORS 🫶

• coresystems GmbH.
• Man page written by Ahmad Khalifa.

so yeah, that's msrtool from November 2024, part of the System Administration Utilities ✨ thank you for coming to my ted talk, go dump some registers bestie, ily, mwah 💖🎀🦋