XSCOM(8)

📦 version 7.0, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 NAME

okay so hi bestie, welcome to XSCOM, section 8 of the System Manager's Manual — the big-girl sysadmin section, no cap 👑

This page is all about getscom — and yeah, it's part of xscom utils. that's the whole vibe. it's the little tool that goes and asks questions to your chips. we love a nosy queen 🕵️♀️✨

🦋 SYNOPIS

bestie. i need you to know. the og page spells this heading SYNOPIS. not SYNOPSIS. SYNOPIS. i am not fixing it, because rule number one is that i keep every single detail, and apparently that detail is a typo 😭 iconic behaviour honestly. moving on 💅

so here's how you actually call her:

getscom [-c | --chip chip-id] addr

getscom [-l | --list-chips]

getscom [-v | --version]

three moods, one girl. read a register, list the chips, or just check the version. pick your fighter 🌈

🎀 DESCRIPTION

the getscom utility provides an interface to query the registers of the different chipsets of an OpenPower system. that's it, that's the job — it's the interface between you and the registers chilling inside all those different chipsets on an OpenPower box 🧚♀️

like, think of it as sliding into the DMs of your hardware and being like "hey bestie what's in this register". and it answers. slay 💖

✨ Options

  • -c|--chip-id chip-id — specify the chipset where to read the register at addr. so you're telling her which chip you want to hear from, because yes, there's more than one, and they all have opinions 🫶
  • -l|--list-chips — list the chipsets found on the system. pure reconnaissance. it's giving "who's here" energy, and you get the whole guest list 👑
  • -v|--version — display the version of the tool. sometimes you just gotta know which era of getscom you're dealing with, iykyk ⭐
psst — tiny heads-up for my detail-obsessed girlies: the synopsis up there writes the chip flag as --chip, and the option list writes it as --chip-id. both of those are exactly what the original page says, so i'm keeping both, untouched, no edits, no notes 💀🙈

and that's the whole page, bestie!! short, sweet, extremely specific to OpenPower chipsets, and now you know her 🎀

cute little sign-off from the footer: this one's from the System Manager's Manual, dated September 2016, and it lives at XSCOM(8). go read some registers, you absolute main character 💖✨🦋🌸

📦 where this page comes from