xref: /linux/Documentation/ABI/testing/sysfs-mce (revision cbac924200b838cfb8d8b1415113d788089dc50b)
1What:		/sys/devices/system/machinecheck/machinecheckX/
2Contact:	Andi Kleen <ak@linux.intel.com>
3Date:		Feb, 2007
4Description:
5		(X = CPU number)
6
7		Machine checks report internal hardware error conditions
8		detected by the CPU. Uncorrected errors typically cause a
9		machine check (often with panic), corrected ones cause a
10		machine check log entry.
11
12		For more details about the x86 machine check architecture
13		see the Intel and AMD architecture manuals from their
14		developer websites.
15
16		For more details about the architecture
17		see http://one.firstfloor.org/~andi/mce.pdf
18
19		Each CPU has its own directory.
20
21What:		/sys/devices/system/machinecheck/machinecheckX/bank<Y>
22Contact:	Andi Kleen <ak@linux.intel.com>
23Date:		Feb, 2007
24Description:
25		(Y bank number)
26
27		64bit Hex bitmask enabling/disabling specific subevents for
28		bank Y.
29
30		When a bit in the bitmask is zero then the respective
31		subevent will not be reported.
32
33		By default all events are enabled.
34
35		Note that BIOS maintain another mask to disable specific events
36		per bank.  This is not visible here
37
38What:		/sys/devices/system/machinecheck/machinecheckX/check_interval
39Contact:	Andi Kleen <ak@linux.intel.com>
40Date:		Feb, 2007
41Description:
42		The entries appear for each CPU, but they are truly shared
43		between all CPUs.
44
45		How often to poll for corrected machine check errors, in
46		seconds (Note output is hexadecimal). Default 5 minutes.
47		When the poller finds MCEs it triggers an exponential speedup
48		(poll more often) on the polling interval.  When the poller
49		stops finding MCEs, it triggers an exponential backoff
50		(poll less often) on the polling interval. The check_interval
51		variable is both the initial and maximum polling interval.
52		0 means no polling for corrected machine check errors
53		(but some corrected errors might be still reported
54		in other ways)
55
56What:		/sys/devices/system/machinecheck/machinecheckX/trigger
57Contact:	Andi Kleen <ak@linux.intel.com>
58Date:		Feb, 2007
59Description:
60		The entries appear for each CPU, but they are truly shared
61		between all CPUs.
62
63		Program to run when a machine check event is detected.
64		This is an alternative to running mcelog regularly from cron
65		and allows to detect events faster.
66
67What:		/sys/devices/system/machinecheck/machinecheckX/monarch_timeout
68Contact:	Andi Kleen <ak@linux.intel.com>
69Date:		Feb, 2007
70Description:
71		How long to wait for the other CPUs to machine check too on a
72		exception. 0 to disable waiting for other CPUs.
73
74		Unit: us
75
76What:		/sys/devices/system/machinecheck/machinecheckX/ignore_ce
77Contact:	Hidetoshi Seto <seto.hidetoshi@jp.fujitsu.com>
78Date:		Jun 2009
79Description:
80		Disables polling and CMCI for corrected errors.
81		All corrected events are not cleared and kept in bank MSRs.
82
83What:		/sys/devices/system/machinecheck/machinecheckX/dont_log_ce
84Contact:	Hidetoshi Seto <seto.hidetoshi@jp.fujitsu.com>
85Date:		Jun 2009
86Description:
87		Disables logging for corrected errors.
88		All reported corrected errors will be cleared silently.
89
90		This option will be useful if you never care about corrected
91		errors.
92
93What:		/sys/devices/system/machinecheck/machinecheckX/cmci_disabled
94Contact:	Hidetoshi Seto <seto.hidetoshi@jp.fujitsu.com>
95Date:		Jun 2009
96Description:
97		Disables the CMCI feature.
98