---
name: "ras-mc-ctl"
section: "8"
platform: "linux"
package: "rasdaemon"
version: "0.8.3-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/ras-mc-ctl"
---

# ras-mc-ctl(8)

RAS memory controller admin utility

## NAME

ras-mc-ctl - RAS memory controller admin utility

## SYNOPSIS

**ras-mc-ctl** \[*OPTION*\]...

## DESCRIPTION

The **ras-mc-ctl** program is a [**perl**(1)](/perl/1.md) 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.

- **--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*

  Pressents 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 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)](/dmidecode/8.md) utility. Use of this utility will most often require that **ras-mc-ctl** be run as root.

## SEE ALSO

[**rasdaemon**(1)](/rasdaemon/1.md)