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 number 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 in 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 time 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 controller 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 syntax:
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 executable 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
utility will most often require that ras-mc-ctl be run as root.