EDAC-UTIL(1)

💖 EDAC-UTIL 💖

okay bestie, welcome to edac-util(1) — the EDAC error reporting utility, and yes it's a section 1 man page so you know it's a command you actually run in your shell. pull up a chair, grab a strawberry 🍓, and let's get into it.

✨ SYNOPSIS ✨

edac-util [OPTION]...

that's it. that's the whole vibe. options, as many as you want, go off. 👑

🌸 DESCRIPTION 🌸

so edac-util is out here reading information from EDAC (that's Error Detection and Correction, for the uninitiated 🧚) drivers living in the kernel. it doesn't poke at hardware directly or anything dramatic — it reads the files those drivers export in sysfs. lowkey elegant ngl.

and when you run it with no options at all? it reports any uncorrected error (UE) or corrected error (CE) information that EDAC has recorded, plus any DIMM label information that's been registered with EDAC. like, the full tea. ☕

💅 OPTIONS 💅

• -h, --help — shows you a lil summary of the command-line options. the "hey what are my choices" option. iconic.
• -q, --quiet — quiet mode, bestie. for some reports, edac-util will normally report corrected and uncorrected error counts for every MC, csrow, and channel combination, even the ones where the current error count is a big fat zero 🥱. the --quiet flag suppresses the display of any locations with zero errors, so the report gets all terse and clean. also: if there are zero total errors currently recorded by EDAC, no output will be generated at all. and one more thing — --quiet also suppresses all informational and debug messages, so only fatal errors make it through. it's giving "don't talk to me unless it's serious." 💀
• -v, --verbose — increase verbosity. and yes you can stack multiple -v's. go crazy. 📈
• -s, --status — displays the current status of EDAC drivers. edac-util will report whether it detects that EDAC drivers are loaded, and the number of memory controllers (MCs) it found in sysfs. and if you're in verbose mode? it also prints the MC id and name of each controller. cute.
• -r, --report=report,... — specify which report to generate. currently the available reports are default, simple, full, ue, and ce. they're all detailed down in the EDAC REPORTS section below ⬇️. and yes, you can ask for more than one — just give them as a comma-separated list.

🦋 EDAC REPORTS 🦋

🌟 default 🌟

the default edac-util report is what you get when the program runs with no options whatsoever. no thoughts, just defaults.

if there are no errors logged by EDAC, this report displays "No errors to report." to stdout. slay, honestly.

otherwise, it displays error counts for each MC, csrow, channel combination that has attributed errors, along with the corresponding DIMM labels — if those labels have been registered in sysfs, that is.

the default report will also display any errors that don't have any DIMM information at all. these happen when errors are reported in the memory controller overflow register, which means more than one error occurred during a given EDAC poll cycle. and ngl, it's usually obvious from which DIMM locations those errors came from. 👀

🌈 simple 🌈

the simple report reports total corrected and uncorrected errors for each MC detected on the system. it also displays a tally of total errors. and with the --quiet option? only non-zero error counts get shown. minimalism. ✨

🔥 full 🔥

the full report generates a line of output for every MC, csrow, channel combination found in EDAC sysfs. and yes, that includes counts of errors with no information at all — the "noinfo" errors. the output is of the form:

MC:(csrow|noinfo):(label|all):(UE|CE):count

with the --quiet option, only non-zero error counts will be displayed.

👑 ue 👑

this report simply displays the total number of Uncorrected Errors (UEs) detected on the system. with the --quiet option, output will be suppressed unless there are 1 or more errors to report. no errors, no talking. 🙈

🎀 ce 🎀

this report simply displays the total number of Corrected Errors (CEs) detected on the system. with the --quiet option, output will be suppressed unless there are 1 or more errors to report. same energy, different error type. 💜

🫶 SEE ALSO 🫶

• edac(3)
• edac-ctl(8)

bestie reminder: this whole thing is edac-utils-0.18-1, dated 2011-11-09, and honestly? still serving. 💖✨🎀🦋🌸💅🫶