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 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 errors that have been logged.

       --errors
              Shows the errors stored in the error database.

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.

SEE ALSO

       rasdaemon(1)

                                                                                    RAS-MC-CTL(8)