Difference between revisions of "Machine-check exception"

From ArchWiki
Jump to: navigation, search
m (add ja link)
 
(16 intermediate revisions by 6 users not shown)
Line 1: Line 1:
[[Category:Hardware]]
 
 
[[Category:CPU]]
 
[[Category:CPU]]
 
[[Category:Kernel]]
 
[[Category:Kernel]]
 +
[[ja:マシンチェック例外]]
 
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==
 
 
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.
 
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==
+
== Installation ==
The [http://www.mcelog.org/ mcelog] daemon written by Andi Kleen is one of the tools one can use to gather MCE information.
+
  
[[pacman|Install]] the {{Pkg|mcelog}} package from the [[Official Repositories|official repositories]].
+
[[Install]] the {{Pkg|mcelog}} package. [http://www.mcelog.org/ mcelog] written by Andi Kleen is one of the tools to gather MCE information.
  
==Configuring mcelog==
+
== Configuration ==
mcelog's configuration file is located at {{ic|/etc/mcelog/mcelog.conf}}.
+
  
===Running mcelog as a daemon===
+
mcelog's configuration file is located at {{ic|/etc/mcelog/mcelog.conf}}. See {{ic|man mcelog}}, {{ic|man mcelog.conf}} and {{ic|man mcelog.triggers}} for more information.
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, use the {{ic|/etc/rc.d/mcelog}} script to start mcelog at boot via {{ic|/etc/[[rc.conf]]}}.
+
[[Start]] and enable {{ic|mcelog.service}}. By default, the service runs ''mcelog'' as a daemon.
  
{{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.}}
+
== See also ==
  
===Additional configuration options===
+
* [[Wikipedia:Machine_Check_Exception]]
The following option is probably recommended:
+
* [[Wikipedia:Machine_check_architecture]]
syslog = yes
+
* [http://www.mcelog.org/ mcelog Home]
 +
* [http://www.mcelog.org/references.html mcelog References]
 +
 
 +
=== Hardware documentation ===
  
==Hardware documentation from CPU manufacturers==
 
 
* [http://support.amd.com/us/Processor_TechDocs/APM_v2_24593.pdf AMD64 Architecture Programmer's Manual, Volume 2: System Programming]
 
* [http://support.amd.com/us/Processor_TechDocs/APM_v2_24593.pdf AMD64 Architecture Programmer's Manual, Volume 2: System Programming]
 
* [http://support.amd.com/us/Processor_TechDocs/26094.PDF BIOS and Kernel Developer's Guide for AMD Athlon™ 64 and AMD Opteron™ Processors]
 
* [http://support.amd.com/us/Processor_TechDocs/26094.PDF BIOS and Kernel Developer's Guide for AMD Athlon™ 64 and AMD Opteron™ Processors]
 
==See Also==
 
* [http://en.wikipedia.org/wiki/Machine_Check_Exception Wikipedia's article on machine check exceptions]
 
* [http://en.wikipedia.org/wiki/Machine_check_architecture Wikipedia's article on the machine check architecture]
 
* [http://www.mcelog.org/ mcelog daemon page by Andi Kleen]
 
* [http://www.mcelog.org/references.html References page from mcelog site]
 

Latest revision as of 11:01, 20 March 2016

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.

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.

Installation

Install the mcelog package. mcelog written by Andi Kleen is one of the tools to gather MCE information.

Configuration

mcelog's configuration file is located at /etc/mcelog/mcelog.conf. See man mcelog, man mcelog.conf and man mcelog.triggers for more information.

Start and enable mcelog.service. By default, the service runs mcelog as a daemon.

See also

Hardware documentation