RAS-MC-CTL(8) RAS memory controller admin utility RAS-MC-CTL(8)NAME
ras-mc-ctl - RAS memory controller admin utility
SYNOPSIS
ras-mc-ctl [OPTION]...
DESCRIPTION
The ras-mc-ctl program is a perl(1) script which performs some useful RAS administration tasks on EDAC (Error Detection and Correction)
drivers.
OPTIONS --help Display a brief usage message.
--mainboard
Print mainboard vendor and model for this hardware, if available. The method used by ras-mc-ctl to obtain the mainboard vendor and
model information for the current system is described below in the MAINBOARD CONFIGURATION section.
--status
Print the status of EDAC drivers (loaded or unloaded).
--quiet
Be less verbose when executing an operation.
--register-labels
Register motherboard DIMM labels into EDAC driver sysfs files. This option uses the detected mainboard manufacturer and model num-
ber in combination with a "labels database" found 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 the current hardware must exist in the labels database for this option to do anything.
--print-labels
Display the configured labels for the current hardware, as well as the current labels registered with EDAC.
--guess-labels
Print DMI labels, when bank locator is available at the DMI table. It helps to fill the labels database at /etc/ras/dimm_labels.d/.
--labeldb=DB
Specify an alternate location for the labels database.
--delay=time
Specify a delay of ime seconds before registering dimm labels. Only meaninful if used together with --register-labels.
--layout
Prints the memory layout as detected by the EDAC driver. Useful to check if the EDAC driver is properly detecting the memory con-
troller architecture.
MAINBOARD CONFIGURATION
The ras-mc-ctl script uses the following method to determine the current system's mainboard vendor and model information:
1. If the config file /etc/edac/mainboard exists, then it is parsed by ras-mc-ctl. The mainboard config file has the following simple syn-
tax:
vendor = <mainboard vendor string>
model = <mainboard model string>
script = <script to gather mainboard information>
Where anything after a '#' character on a line is considered a comment. If the keyword script is specified, then that script or exe-
cutable is run by ras-mc-ctl to gather the mainboard vendor and model information. The script should write the resulting information on
stdout in the same format as the mainboard config file.
2. If no mainboard config file exists, 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 the sysfs files above do not exist, then ras-mc-ctl will fall back to parsing output of the dmidecode(8) utility. Use of this util-
ity will most often require that ras-mc-ctl be run as root.
SEE ALSO fBrasdaemon(1)RAS-MC-CTL(8)
Check Out this Related Man Page
EDAC-UTIL(1) EDAC error reporting utility EDAC-UTIL(1)NAME
edac-util - EDAC error reporting utility.
SYNOPSIS
edac-util [OPTION]...
DESCRIPTION
The edac-util program reads information from EDAC (Error Detection and Correction) drivers in the kernel, using files exported by these
drivers in sysfs. With no options, edac-util will report any uncorrected error (UE) or corrected error (CE) information recorded by EDAC,
along with any DIMM label information registered with EDAC.
OPTIONS -h, --help
Display a summary of the command-line options.
-q, --quiet
Quiet mode. For some reports, edac-util will report corrected and uncorrected error counts for all MC, csrow, and channel combina-
tions, even if the current count of errors is zero. The --quiet flag will suppress the display of any locations with zero errors,
thus creating a more terse report. No output will be generated if there are zero total errors currently recorded by EDAC. Addition-
ally, the use of --quiet will suppress all informational and debug messages, displaying only fatal errors.
-v, --verbose
Increase verbosity. Multiple -v's may be used.
-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) found in sysfs. In verbose mode, the MC id and name of each controller will also be printed.
-r, --report=report,...
Specify the report to generate. Currently, the available reports are default, simple, full, ue, and ce. These reports are detailed
in the EDAC REPORTS section below. More than one report may be specified in a comma-separated list.
EDAC REPORTS
default
The default edac-util report is generated when the program is run without any options. If there are no errors logged by EDAC, this
report will display "No errors to report." to stdout. Otherwise, error counts for each MC, csrow, channel combination with attrib-
uted errors are displayed, along with corresponding DIMM labels, if these labels have been registered in sysfs.
The default report will also display any errors that do not have any DIMM information. These errors occur when errors are reported
in the memory controller overflow register, indicating that more than one error occurred during a given EDAC poll cycle. It is usu-
ally obvious from which DIMM locations these errors were generated.
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. With the --quiet option, only non-zero error counts are displayed.
full The full report generates a line of output for every MC, csrow, channel combination found in EDAC sysfs. This includes counts of
errors with no information ("noinfo" errors). 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.
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.
SEE ALSO edac(3), edac-ctl(8)edac-utils-0.16-1 2009-01-30 EDAC-UTIL(1)