Difference between revisions of "Machine-check exception"

From ArchWiki
Jump to: navigation, search
(Hardware documentation from CPU manufacturers: fixed broken link to the APM, Volume 2; removed link rot tag)
(9 intermediate revisions by 4 users not shown)
Line 1: Line 1:
[[Category:Hardware (English)]]
+
[[Category:Hardware]]
[[Category:CPU (English)]]
+
[[Category:CPU]]
[[Category:Kernel (English)]]
+
[[Category:Kernel]]
[[Category:Daemons and system services (English)]]
+
 
+
 
This article aims to help users implement services to actively monitor, log, and report hardware errors. A machine check exception (MCE) is an error generated by the CPU when the CPU detects that a hardware error or failure has occurred.
 
This article aims to help users implement services to actively monitor, log, and report hardware errors. A machine check exception (MCE) is an error generated by the CPU when the CPU detects that a hardware error or failure has occurred.
  
 
==Introduction==
 
==Introduction==
Machine check exceptions (MCEs) can occur for a variety of reasons ranging from undesired or out-of-spec voltages from the power supply, from cosmic radiation flipping bits in memory DIMMs, or from other miscellaneous faults, including faulty software triggering hardware errors.
+
Machine check exceptions (MCEs) can occur for a variety of reasons ranging from undesired or out-of-spec voltages from the power supply, from cosmic radiation flipping bits in memory DIMMs or the CPU, or from other miscellaneous faults, including faulty software triggering hardware errors.
  
 
==Installing mcelog==
 
==Installing mcelog==
 
The [http://www.mcelog.org/ mcelog] daemon written by Andi Kleen is one of the tools one can use to gather MCE information.
 
The [http://www.mcelog.org/ mcelog] daemon written by Andi Kleen is one of the tools one can use to gather MCE information.
  
You can [[pacman|install]] {{Package Official|mcelog}} from the [[Official Repositories|official repositories]].
+
[[pacman|Install]] the {{Pkg|mcelog}} package from the [[Official Repositories|official repositories]].
  
 
==Configuring mcelog==
 
==Configuring mcelog==
mcelog's configuration file is located at {{Filename|/etc/mcelog/mcelog.conf}}.
+
mcelog's configuration file is located at {{ic|/etc/mcelog/mcelog.conf}}.
  
 
===Running mcelog as a daemon===
 
===Running mcelog as a daemon===
It is recommended by upstream to always run mcelog as a daemon, so edit {{Filename|/etc/mcelog/mcelog.conf}} and set {{Codeline|daemon <nowiki>=</nowiki> yes}}.
+
It is recommended by upstream to always run mcelog as a daemon, so edit {{ic|/etc/mcelog/mcelog.conf}} and set {{ic|daemon <nowiki>=</nowiki> yes}}.
  
Finally, {{Codeline|mcelog}} needs to be added to the {{Codeline|DAEMONS}} array in {{Filename|/etc/rc.conf}}.
+
Finally, use the {{ic|/etc/rc.d/mcelog}} script to start mcelog at boot via {{ic|/etc/[[rc.conf]]}}.
  
{{Note|If running mcelog via the {{Codeline|rc.d}} command or the {{Codeline|DAEMONS}} array in {{Filename|/etc/rc.conf}}, it is unnecessary to set {{Codeline|daemon <nowiki>=</nowiki> yes}} in {{Filename|/etc/mcelog/mcelog.conf}} because {{Filename|/etc/rc.d/mcelog}} starts mcelog in daemon mode by default.}}
+
{{Note|If running mcelog via the {{ic|rc.d}} command or via {{ic|/etc/[[rc.conf]]}}, it is unnecessary to set {{ic|daemon <nowiki>=</nowiki> yes}} in {{ic|/etc/mcelog/mcelog.conf}} because {{ic|/etc/rc.d/mcelog}} starts mcelog in daemon mode by default.}}
  
 
===Additional configuration options===
 
===Additional configuration options===
The following options are probably recommended:
+
The following option is probably recommended:
 
  syslog = yes
 
  syslog = yes
  

Revision as of 11:33, 16 December 2012

This article aims to help users implement services to actively monitor, log, and report hardware errors. A machine check exception (MCE) is an error generated by the CPU when the CPU detects that a hardware error or failure has occurred.

Introduction

Machine check exceptions (MCEs) can occur for a variety of reasons ranging from undesired or out-of-spec voltages from the power supply, from cosmic radiation flipping bits in memory DIMMs or the CPU, or from other miscellaneous faults, including faulty software triggering hardware errors.

Installing mcelog

The mcelog daemon written by Andi Kleen is one of the tools one can use to gather MCE information.

Install the mcelog package from the official repositories.

Configuring mcelog

mcelog's configuration file is located at /etc/mcelog/mcelog.conf.

Running mcelog as a daemon

It is recommended by upstream to always run mcelog as a daemon, so edit /etc/mcelog/mcelog.conf and set daemon = yes.

Finally, use the /etc/rc.d/mcelog script to start mcelog at boot via /etc/rc.conf.

Note: If running mcelog via the rc.d command or via /etc/rc.conf, it is unnecessary to set daemon = yes in /etc/mcelog/mcelog.conf because /etc/rc.d/mcelog starts mcelog in daemon mode by default.

Additional configuration options

The following option is probably recommended:

syslog = yes

Hardware documentation from CPU manufacturers

See Also