osfmk/i386/machine_check.h

   1 /*
   2  * Copyright (c) 2007 Apple Inc. All rights reserved.
   3  *
   4  * @APPLE_OSREFERENCE_LICENSE_HEADER_START@
   5  *
   6  * This file contains Original Code and/or Modifications of Original Code
   7  * as defined in and that are subject to the Apple Public Source License
   8  * Version 2.0 (the 'License'). You may not use this file except in
   9  * compliance with the License. The rights granted to you under the License
  10  * may not be used to create, or enable the creation or redistribution of,
  11  * unlawful or unlicensed copies of an Apple operating system, or to
  12  * circumvent, violate, or enable the circumvention or violation of, any
  13  * terms of an Apple operating system software license agreement.
  14  *
  15  * Please obtain a copy of the License at
  16  * http://www.opensource.apple.com/apsl/ and read it before using this file.
  17  *
  18  * The Original Code and all software distributed under the License are
  19  * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
  20  * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
  21  * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
  22  * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
  23  * Please see the License for the specific language governing rights and
  24  * limitations under the License.
  25  *
  26  * @APPLE_OSREFERENCE_LICENSE_HEADER_END@
  27  */
  28 #ifdef KERNEL_PRIVATE
  29 #ifndef _I386_MACHINE_CHECK_H_
  30 #define _I386_MACHINE_CHECK_H_
  31
  32 #include <stdint.h>
  33
  34 #include <i386/cpu_data.h>
  35
  36 /*
  37  * This header defines the machine check architecture for Pentium4 and Xeon.
  38  */
  39
  40 /*
  41  * Macro BITS(n,m) returns the number of bits between bit(n) and bit(m),
  42  * where (n>m). Macro BIT1(n) is cosmetic and returns 1.
  43  */
  44 #define BITS(n,m)       ((n)-(m)+1)
  45 #define BIT1(n)         (1)
  46
  47 /*
  48  * IA32 SDM 14.3.1 Machine-Check Global Control MSRs:
  49  */
  50 #define IA32_MCG_CAP            (0x179)
  51 typedef union {
  52      struct {
  53         uint64_t        count                   :BITS(7,0);
  54         uint64_t        mcg_ctl_p               :BIT1(8);
  55         uint64_t        mcg_ext_p               :BIT1(9);
  56         uint64_t        mcg_ext_corr_err_p      :BIT1(10);
  57         uint64_t        mcg_tes_p               :BIT1(11);
  58         uint64_t        mcg_ecms                :BIT1(12);
  59         uint64_t        mcg_reserved2           :BITS(15,13);
  60         uint64_t        mcg_ext_cnt             :BITS(23,16);
  61         uint64_t        mcg_ser_p               :BIT1(24);
  62      }          bits;
  63      uint64_t   u64;
  64 } ia32_mcg_cap_t;
  65
  66 #define IA32_MCG_STATUS         (0x17A)
  67 typedef union {
  68      struct {
  69         uint64_t        ripv                    :BIT1(0);
  70         uint64_t        eipv                    :BIT1(1);
  71         uint64_t        mcip                    :BIT1(2);
  72      }          bits;
  73      uint64_t   u64;
  74 } ia32_mcg_status_t;
  75
  76 #define IA32_MCG_CTL            (0x17B)
  77 typedef uint64_t        ia32_mcg_ctl_t;
  78 #define IA32_MCG_CTL_ENABLE     (0xFFFFFFFFFFFFFFFFULL)
  79 #define IA32_MCG_CTL_DISABLE    (0x0ULL)
  80
  81
  82 /*
  83  * IA32 SDM 14.3.2 Error-Reporting Register Banks:
  84  */
  85 #define IA32_MCi_CTL(i)         (0x400 + 4*(i))
  86 #define IA32_MCi_STATUS(i)      (0x401 + 4*(i))
  87 #define IA32_MCi_ADDR(i)        (0x402 + 4*(i))
  88 #define IA32_MCi_MISC(i)        (0x403 + 4*(i))
  89
  90 #define IA32_MC0_CTL            IA32_MCi_CTL(0)
  91 #define IA32_MC0_STATUS         IA32_MCi_STATUS(0)
  92 #define IA32_MC0_ADDR           IA32_MCi_ADDR(0)
  93 #define IA32_MC0_MISC           IA32_MCi_MISC(0)
  94
  95 #define IA32_MC1_CTL            IA32_MCi_CTL(1)
  96 #define IA32_MC1_STATUS         IA32_MCi_STATUS(1)
  97 #define IA32_MC1_ADDR           IA32_MCi_ADDR(1)
  98 #define IA32_MC1_MISC           IA32_MCi_MISC(1)
  99
 100 #define IA32_MC2_CTL            IA32_MCi_CTL(2)
 101 #define IA32_MC2_STATUS         IA32_MCi_STATUS(2)
 102 #define IA32_MC2_ADDR           IA32_MCi_ADDR(2)
 103 #define IA32_MC2_MISC           IA32_MCi_MISC(2)
 104
 105 #define IA32_MC3_CTL            IA32_MCi_CTL(3)
 106 #define IA32_MC3_STATUS         IA32_MCi_STATUS(3)
 107 #define IA32_MC3_ADDR           IA32_MCi_ADDR(3)
 108 #define IA32_MC3_MISC           IA32_MCi_MISC(3)
 109
 110 #define IA32_MC4_CTL            IA32_MCi_CTL(4)
 111 #define IA32_MC4_STATUS         IA32_MCi_STATUS(4)
 112 #define IA32_MC4_ADDR           IA32_MCi_ADDR(4)
 113 #define IA32_MC4_MISC           IA32_MCi_MISC(4)
 114
 115 typedef uint64_t        ia32_mci_ctl_t;
 116 #define IA32_MCi_CTL_EE(j)      (0x1ULL << (j))
 117 #define IA32_MCi_CTL_ENABLE_ALL (0xFFFFFFFFFFFFFFFFULL)
 118
 119 typedef union {
 120     struct {
 121         uint64_t        mca_error               :BITS(15,0);
 122         uint64_t        model_specific_error    :BITS(31,16);
 123         uint64_t        other_information       :BITS(56,32);
 124         uint64_t        pcc                     :BIT1(57);
 125         uint64_t        addrv                   :BIT1(58);
 126         uint64_t        miscv                   :BIT1(59);
 127         uint64_t        en                      :BIT1(60);
 128         uint64_t        uc                      :BIT1(61);
 129         uint64_t        over                    :BIT1(62);
 130         uint64_t        val                     :BIT1(63);
 131     }           bits;
 132     struct {            /* Variant if threshold-based error status present: */
 133         uint64_t        mca_error               :BITS(15,0);
 134         uint64_t        model_specific_error    :BITS(31,16);
 135         uint64_t        other_information       :BITS(52,32);
 136         uint64_t        threshold               :BITS(54,53);
 137         uint64_t        ar                      :BIT1(55);
 138         uint64_t        s                       :BIT1(56);
 139         uint64_t        pcc                     :BIT1(57);
 140         uint64_t        addrv                   :BIT1(58);
 141         uint64_t        miscv                   :BIT1(59);
 142         uint64_t        en                      :BIT1(60);
 143         uint64_t        uc                      :BIT1(61);
 144         uint64_t        over                    :BIT1(62);
 145         uint64_t        val                     :BIT1(63);
 146     }           bits_tes_p;
 147     struct ia32_mc8_specific {
 148         uint64_t        channel_number          :BITS(3,0);
 149         uint64_t        memory_operation        :BITS(6,4);
 150         uint64_t        unused                  :BITS(15,7);
 151         uint64_t        read_ecc                :BIT1(16);
 152         uint64_t        ecc_on_a_scrub          :BIT1(17);
 153         uint64_t        write_parity            :BIT1(18);
 154         uint64_t        redundant_memory        :BIT1(19);
 155         uint64_t        sparing                 :BIT1(20);
 156         uint64_t        access_out_of_range     :BIT1(21);
 157         uint64_t        rtid_out_of_range       :BIT1(22);
 158         uint64_t        address_parity          :BIT1(23);
 159         uint64_t        byte_enable_parity      :BIT1(24);
 160         uint64_t        reserved                :BITS(37,25);
 161         uint64_t        cor_err_cnt             :BITS(52,38);
 162     }           bits_mc8;
 163     uint64_t    u64;
 164 } ia32_mci_status_t;
 165
 166 /* Values for threshold_status if mcg_tes_p == 1 and uc == 0 */
 167 #define THRESHOLD_STATUS_NO_TRACKING    0
 168 #define THRESHOLD_STATUS_GREEN          1
 169 #define THRESHOLD_STATUS_YELLOW         2
 170 #define THRESHOLD_STATUS_RESERVED       3
 171
 172 /* MC8 memory operations encoding: */
 173 #define MC8_MMM_GENERIC                 0
 174 #define MC8_MMM_READ                    1
 175 #define MC8_MMM_WRITE                   2
 176 #define MC8_MMM_ADDRESS_COMMAND         3
 177 #define MC8_MMM_RESERVED                4
 178 typedef union {
 179     struct {
 180         uint64_t        rtid                    :BITS(7,0);
 181         uint64_t        reserved1               :BITS(15,8);
 182         uint64_t        dimm                    :BITS(17,16);
 183         uint64_t        channel                 :BITS(19,18);
 184         uint64_t        reserved2               :BITS(31,20);
 185         uint64_t        syndrome                :BITS(63,32);
 186     }           bits;
 187     uint64_t    u64;
 188 } ia32_mc8_misc_t;
 189
 190 typedef uint64_t        ia32_mci_addr_t;
 191 typedef uint64_t        ia32_mci_misc_t;
 192
 193 #define IA32_MCG_EAX            (0x180)
 194 #define IA32_MCG_EBX            (0x181)
 195 #define IA32_MCG_ECX            (0x182)
 196 #define IA32_MCG_EDX            (0x183)
 197 #define IA32_MCG_ESI            (0x184)
 198 #define IA32_MCG_EDI            (0x185)
 199 #define IA32_MCG_EBP            (0x186)
 200 #define IA32_MCG_ESP            (0x187)
 201 #define IA32_MCG_EFLAGS         (0x188)
 202 #define IA32_MCG_EIP            (0x189)
 203 #define IA32_MCG_MISC           (0x18A)
 204
 205 #define IA32_MCG_RAX            (0x180)
 206 #define IA32_MCG_RBX            (0x181)
 207 #define IA32_MCG_RCX            (0x182)
 208 #define IA32_MCG_RDX            (0x183)
 209 #define IA32_MCG_RSI            (0x184)
 210 #define IA32_MCG_RDI            (0x185)
 211 #define IA32_MCG_RBP            (0x186)
 212 #define IA32_MCG_RSP            (0x187)
 213 #define IA32_MCG_RFLAGS         (0x188)
 214 #define IA32_MCG_RIP            (0x189)
 215 #define IA32_MCG_MISC           (0x18A)
 216 #define IA32_MCG_RESERVED1      (0x18B)
 217 #define IA32_MCG_RESERVED2      (0x18C)
 218 #define IA32_MCG_RESERVED3      (0x18D)
 219 #define IA32_MCG_RESERVED4      (0x18E)
 220 #define IA32_MCG_RESERVED5      (0x18F)
 221 #define IA32_MCG_R8             (0x190)
 222 #define IA32_MCG_R9             (0x191)
 223 #define IA32_MCG_R10            (0x192)
 224 #define IA32_MCG_R11            (0x193)
 225 #define IA32_MCG_R12            (0x194)
 226 #define IA32_MCG_R13            (0x195)
 227 #define IA32_MCG_R14            (0x196)
 228 #define IA32_MCG_R15            (0x197)
 229
 230 extern void             mca_cpu_alloc(cpu_data_t *cdp);
 231 extern void             mca_cpu_init(void);
 232 extern void             mca_dump(void);
 233 extern void             mca_check_save(void);
 234 extern boolean_t        mca_is_cmci_present(void);
 235
 236 #endif  /* _I386_MACHINE_CHECK_H_ */
 237 #endif  /* KERNEL_PRIVATE */