RAS-MC-CTL(8)

✨ ras-mc-ctl(8) ✨

okay bestie, so this is the manual for ras-mc-ctl, the RAS memory controller admin utility — yes she's a section 8 system admin page and yes she's iconic 💅

---

🌸 NAME 🌸

ras-mc-ctl — RAS memory controller admin utility

---

🦋 SYNOPSIS 🦋

ras-mc-ctl [OPTION]...

---

💖 DESCRIPTION 💖

So like, ras-mc-ctl is a perl(1) script — yep, perl, she's vintage and she ATE — and she does a bunch of genuinely useful RAS admin tasks on EDAC (Error Detection and Correction) drivers. It's giving "little script, big responsibilities" fr fr 🔥

---

🎀 OPTIONS 🎀

• --help — prints a lil brief usage message so you know what's up 🫶
• --mainboard — prints the mainboard vendor and model for this hardware, if it's available. The whole method she uses to sniff out the mainboard vendor and model info for your current system is laid out down below in the MAINBOARD CONFIGURATION section 👀
• --status — prints the status of the EDAC drivers (loaded or unloaded, so you know where you stand) 💫
• --quiet — be less verbose while running an operation. shhh. she's being subtle 🍓
• --register-labels — registers motherboard DIMM labels into the EDAC driver sysfs files. This one takes the detected mainboard manufacturer + model number and pairs it with a "labels database" that lives in any of the files under /etc/ras/dimm_labels.d/*, or in the labels.db file at /etc/ras/dimm_labels.db. ⚠️ An entry for your current hardware must exist in the labels database or this option literally does nothing, no cap.
• --print-labels — shows you the configured labels for the current hardware, plus the labels currently registered with EDAC. side by side, bestie 💅
• --guess-labels — prints DMI labels, when the bank locator is available in the DMI table. Super handy for filling in that labels database at /etc/ras/dimm_labels.d/ ✨
• --labeldb=DB — point her at an alternate location for the labels database.
• --delay=time — sets a delay of time seconds before registering DIMM labels. Only meaningful if you're using it together with --register-labels 🕐
• --layout — prints the memory layout as detected by the EDAC driver. Genuinely useful for checking whether the EDAC driver is properly detecting the memory controller architecture 👑
• --summary — presents a summary of the logged errors.
• --errors — shows the errors stored at the error database.
• --error-count — shows the corrected and uncorrected error counts using sysfs.
• --vendor-errors-summary=platform-id — presents a summary of the vendor-specific logged errors.
• --vendor-errors=platform-id — shows the vendor-specific errors stored in the error database.
• --vendor-platforms — shows the supported platforms with platform-ids for the vendor-specific errors 🌈

---

🧚 MAINBOARD CONFIGURATION 🧚

The ras-mc-ctl script uses this whole method to figure out your current system's mainboard vendor and model information:

1. If the config file /etc/edac/mainboard exists, then it gets parsed by ras-mc-ctl. The mainboard config file has this simple syntax:

vendor = <mainboard vendor string>
model =  <mainboard model string>
script = <script to gather mainboard information>

Anything after a # character on a line counts as a comment. And if the keyword script is specified, then that script or executable gets run by ras-mc-ctl to gather the mainboard vendor and model info. That script should write the resulting information on stdout in the same format as the mainboard config file 📝

2. If there's no mainboard config file, then ras-mc-ctl will attempt to read DMI information from the sysfs files:

/sys/class/dmi/id/board_vendor
/sys/class/dmi/id/board_name

3. If those sysfs files above don't exist, then ras-mc-ctl falls back to parsing the output of the dmidecode(8) utility.

heads up bestie: using that utility will most often require that ras-mc-ctl be run as root 👑

---

💜 SEE ALSO 💜

rasdaemon(1)

---

and that's the whole page, babes 🫶 this was RAS-MC-CTL(8), the RAS memory controller admin utility manual — go forth and check your DIMMs, you're doing amazing sweetie 💖✨