ras-mc-ctl - RAS memory controller admin utility
The ras-mc-ctl program is a perl(1) script which
performs some useful RAS administration tasks on EDAC (Error Detection and
Correction) drivers.
- --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.
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.