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)
(added i18n bar; replaced "Package Official" with "Pkg"; updated the "running as a daemon" section to comply with the new style guide)
Line 3: Line 3:
 
[[Category:Kernel (English)]]
 
[[Category:Kernel (English)]]
 
[[Category:Daemons and system services (English)]]
 
[[Category:Daemons and system services (English)]]
 +
 +
{{i18n|MCE Handling}}
  
 
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.
Line 12: Line 14:
 
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==
Line 20: Line 22:
 
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 {{Filename|/etc/mcelog/mcelog.conf}} and set {{Codeline|daemon <nowiki>=</nowiki> yes}}.
  
Finally, {{Codeline|mcelog}} needs to be added to the {{Codeline|DAEMONS}} array in {{Filename|/etc/rc.conf}}.
+
Finally, configure {{Codeline|mcelog}} to start up at boot in {{Filename|/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 {{Codeline|rc.d}} command or via {{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.}}
  
 
===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 04:18, 31 October 2011


This template has only maintenance purposes. For linking to local translations please use interlanguage links, see Help:i18n#Interlanguage links.


Local languages: Català – Dansk – English – Español – Esperanto – Hrvatski – Indonesia – Italiano – Lietuviškai – Magyar – Nederlands – Norsk Bokmål – Polski – Português – Slovenský – Česky – Ελληνικά – Български – Русский – Српски – Українська – עברית – العربية – ไทย – 日本語 – 正體中文 – 简体中文 – 한국어


External languages (all articles in these languages should be moved to the external wiki): Deutsch – Français – Română – Suomi – Svenska – Tiếng Việt – Türkçe – فارسی

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 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 Template:Filename.

Running mcelog as a daemon

It is recommended by upstream to always run mcelog as a daemon, so edit Template:Filename and set Template:Codeline.

Finally, configure Template:Codeline to start up at boot in Template:Filename.

Note: If running mcelog via the Template:Codeline command or via Template:Filename, it is unnecessary to set Template:Codeline in Template:Filename because Template:Filename 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