17c478bd9Sstevel@tonic-gate /* 27c478bd9Sstevel@tonic-gate * CDDL HEADER START 37c478bd9Sstevel@tonic-gate * 47c478bd9Sstevel@tonic-gate * The contents of this file are subject to the terms of the 53ad553a7Sgavinm * Common Development and Distribution License (the "License"). 63ad553a7Sgavinm * You may not use this file except in compliance with the License. 77c478bd9Sstevel@tonic-gate * 87c478bd9Sstevel@tonic-gate * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE 97c478bd9Sstevel@tonic-gate * or http://www.opensolaris.org/os/licensing. 107c478bd9Sstevel@tonic-gate * See the License for the specific language governing permissions 117c478bd9Sstevel@tonic-gate * and limitations under the License. 127c478bd9Sstevel@tonic-gate * 137c478bd9Sstevel@tonic-gate * When distributing Covered Code, include this CDDL HEADER in each 147c478bd9Sstevel@tonic-gate * file and include the License file at usr/src/OPENSOLARIS.LICENSE. 157c478bd9Sstevel@tonic-gate * If applicable, add the following below this CDDL HEADER, with the 167c478bd9Sstevel@tonic-gate * fields enclosed by brackets "[]" replaced with your own identifying 177c478bd9Sstevel@tonic-gate * information: Portions Copyright [yyyy] [name of copyright owner] 187c478bd9Sstevel@tonic-gate * 197c478bd9Sstevel@tonic-gate * CDDL HEADER END 207c478bd9Sstevel@tonic-gate */ 217aec1d6eScindi 227c478bd9Sstevel@tonic-gate /* 2389e921d5SKuriakose Kuruvilla * Copyright 2009 Sun Microsystems, Inc. All rights reserved. 247c478bd9Sstevel@tonic-gate * Use is subject to license terms. 257c478bd9Sstevel@tonic-gate */ 267c478bd9Sstevel@tonic-gate 277aec1d6eScindi #ifndef _SYS_CPU_MODULE_H 287aec1d6eScindi #define _SYS_CPU_MODULE_H 297c478bd9Sstevel@tonic-gate 307aec1d6eScindi #include <sys/types.h> 317aec1d6eScindi #include <sys/cpuvar.h> 327aec1d6eScindi #include <sys/nvpair.h> 337aec1d6eScindi #include <sys/mc.h> 3420c794b3Sgavinm #include <sys/sunddi.h> 357aec1d6eScindi 367aec1d6eScindi #ifdef __cplusplus 377c478bd9Sstevel@tonic-gate extern "C" { 387c478bd9Sstevel@tonic-gate #endif 397c478bd9Sstevel@tonic-gate 4020c794b3Sgavinm #ifdef _KERNEL 4120c794b3Sgavinm 4220c794b3Sgavinm #define CMIERR_BASE 0xc000 4320c794b3Sgavinm 4420c794b3Sgavinm typedef enum cmi_errno { 4520c794b3Sgavinm CMI_SUCCESS = 0, 4620c794b3Sgavinm /* 4720c794b3Sgavinm * CPU Module Interface API error return values/ 4820c794b3Sgavinm */ 4920c794b3Sgavinm CMIERR_UNKNOWN = CMIERR_BASE, /* no specific error reason reported */ 5020c794b3Sgavinm CMIERR_API, /* API usage error caught */ 5120c794b3Sgavinm CMIERR_NOTSUP, /* Unsupported operation */ 5220c794b3Sgavinm CMIERR_HDL_CLASS, /* Inappropriate handle class */ 5320c794b3Sgavinm CMIERR_HDL_NOTFOUND, /* Can't find handle for resource */ 5420c794b3Sgavinm CMIERR_MSRGPF, /* #GP during cmi_hdl_{wr,rd}msr */ 5520c794b3Sgavinm CMIERR_INTERPOSE, /* MSR/PCICFG interposition error */ 5620c794b3Sgavinm CMIERR_DEADLOCK, /* Deadlock avoidance */ 5720c794b3Sgavinm /* 5820c794b3Sgavinm * Memory-controller related errors 5920c794b3Sgavinm */ 6020c794b3Sgavinm CMIERR_MC_ABSENT, /* No, or not yet registered, MC ops */ 6120c794b3Sgavinm CMIERR_MC_NOTSUP, /* Requested functionality unimpld */ 6220c794b3Sgavinm CMIERR_MC_NOMEMSCRUB, /* No dram scrubber, or disabled */ 6320c794b3Sgavinm CMIERR_MC_SYNDROME, /* Invalid syndrome or syndrome type */ 6420c794b3Sgavinm CMIERR_MC_BADSTATE, /* MC driver state is invalid */ 6520c794b3Sgavinm CMIERR_MC_NOADDR, /* Address not found */ 6620c794b3Sgavinm CMIERR_MC_RSRCNOTPRESENT, /* Resource not present in system */ 6720c794b3Sgavinm CMIERR_MC_ADDRBITS, /* Too few valid addr bits */ 6820c794b3Sgavinm CMIERR_MC_INVALUNUM, /* Invalid input unum */ 6920c794b3Sgavinm CMIERR_MC_PARTIALUNUMTOPA /* unum to pa reflected physaddr */ 7020c794b3Sgavinm } cmi_errno_t; 7120c794b3Sgavinm 7220c794b3Sgavinm /* 7320c794b3Sgavinm * All access to cpu information is made via a handle, in order to get 7420c794b3Sgavinm * the desired info even when running non-natively. 7520c794b3Sgavinm * 7620c794b3Sgavinm * A CMI_HDL_NATIVE handle is used when we believe we are running on 7720c794b3Sgavinm * bare-metal. If we *are* on bare metal then this handle type will 7820c794b3Sgavinm * get us through to the real hardware, and there will be a 1:1 correspondence 7920c794b3Sgavinm * between handles and cpu_t structures; if not, say we are a domU to 8020c794b3Sgavinm * some unknown/undetected/unannounced hypervisor then chances are the 8120c794b3Sgavinm * hypervisor is not exposing much hardware detail to us so we should 8220c794b3Sgavinm * be prepared for some operations that "cannot fail" to fail or return 8320c794b3Sgavinm * odd data. 8420c794b3Sgavinm * 85e4b86885SCheng Sean Ye * A CMI_HDL_SOLARIS_xVM_MCA handle is used when we are running 8620c794b3Sgavinm * in i86xpv architecture - dom0 to a Solaris xVM hypervisor - and want to 8720c794b3Sgavinm * use a handle on each real execution core (as opposed to vcpu) 8820c794b3Sgavinm * to perform MCA related activities. The model for this handle type 8920c794b3Sgavinm * is that the hypervisor continues to own the real hardware and 9020c794b3Sgavinm * includes a polling service and #MC handler which forward error 9120c794b3Sgavinm * telemetry to dom0 for logging and diagnosis. As such, the operations 9220c794b3Sgavinm * such as RDMSR and WRMSR for this handle type do *not* read and write 9320c794b3Sgavinm * real MSRs via hypercalls- instead they should provide the values from 9420c794b3Sgavinm * already-read MCA bank telemetry, and writes are discarded. 9520c794b3Sgavinm * 9620c794b3Sgavinm * If some application requires real MSR read and write access another 9720c794b3Sgavinm * handle class should be introduced. 9820c794b3Sgavinm */ 9920c794b3Sgavinm 10020c794b3Sgavinm typedef struct cmi_hdl *cmi_hdl_t; /* opaque chip/core/strand handle */ 10120c794b3Sgavinm 10220c794b3Sgavinm enum cmi_hdl_class { 10320c794b3Sgavinm CMI_HDL_NATIVE, 104e4b86885SCheng Sean Ye CMI_HDL_SOLARIS_xVM_MCA, 105e4b86885SCheng Sean Ye CMI_HDL_NEUTRAL 10620c794b3Sgavinm }; 10720c794b3Sgavinm 1087aec1d6eScindi struct regs; 10920c794b3Sgavinm 110e4b86885SCheng Sean Ye typedef struct cmi_mc_ops { 111e4b86885SCheng Sean Ye cmi_errno_t (*cmi_mc_patounum)(void *, uint64_t, uint8_t, uint8_t, 112e4b86885SCheng Sean Ye uint32_t, int, mc_unum_t *); 113e4b86885SCheng Sean Ye cmi_errno_t (*cmi_mc_unumtopa)(void *, mc_unum_t *, nvlist_t *, 114e4b86885SCheng Sean Ye uint64_t *); 115e4b86885SCheng Sean Ye void (*cmi_mc_logout)(cmi_hdl_t, boolean_t, boolean_t); 116e4b86885SCheng Sean Ye } cmi_mc_ops_t; 117e4b86885SCheng Sean Ye 118e4b86885SCheng Sean Ye extern cmi_hdl_t cmi_init(enum cmi_hdl_class, uint_t, uint_t, uint_t); 11920c794b3Sgavinm extern void cmi_post_startup(void); 12020c794b3Sgavinm extern void cmi_post_mpstartup(void); 12120c794b3Sgavinm extern void cmi_fini(cmi_hdl_t); 12220c794b3Sgavinm 12320c794b3Sgavinm extern void cmi_hdl_hold(cmi_hdl_t); 12420c794b3Sgavinm extern void cmi_hdl_rele(cmi_hdl_t); 12520c794b3Sgavinm extern void *cmi_hdl_getcmidata(cmi_hdl_t); 12620c794b3Sgavinm extern void cmi_hdl_setspecific(cmi_hdl_t, void *); 12720c794b3Sgavinm extern void *cmi_hdl_getspecific(cmi_hdl_t); 12820c794b3Sgavinm extern const struct cmi_mc_ops *cmi_hdl_getmcops(cmi_hdl_t); 12920c794b3Sgavinm extern void *cmi_hdl_getmcdata(cmi_hdl_t); 13020c794b3Sgavinm extern enum cmi_hdl_class cmi_hdl_class(cmi_hdl_t); 131e4b86885SCheng Sean Ye 13220c794b3Sgavinm extern cmi_hdl_t cmi_hdl_lookup(enum cmi_hdl_class, uint_t, uint_t, uint_t); 13320c794b3Sgavinm extern cmi_hdl_t cmi_hdl_any(void); 13420c794b3Sgavinm 13520c794b3Sgavinm #define CMI_HDL_WALK_NEXT 0 13620c794b3Sgavinm #define CMI_HDL_WALK_DONE 1 13720c794b3Sgavinm extern void cmi_hdl_walk(int (*)(cmi_hdl_t, void *, void *, void *), 13820c794b3Sgavinm void *, void *, void *); 13920c794b3Sgavinm 14020c794b3Sgavinm extern void cmi_hdlconf_rdmsr_nohw(cmi_hdl_t); 14120c794b3Sgavinm extern void cmi_hdlconf_wrmsr_nohw(cmi_hdl_t); 14220c794b3Sgavinm extern cmi_errno_t cmi_hdl_rdmsr(cmi_hdl_t, uint_t, uint64_t *); 14320c794b3Sgavinm extern cmi_errno_t cmi_hdl_wrmsr(cmi_hdl_t, uint_t, uint64_t); 14420c794b3Sgavinm 14520c794b3Sgavinm extern void cmi_hdl_enable_mce(cmi_hdl_t); 14620c794b3Sgavinm 14720c794b3Sgavinm extern uint_t cmi_hdl_vendor(cmi_hdl_t); 14820c794b3Sgavinm extern const char *cmi_hdl_vendorstr(cmi_hdl_t); 14920c794b3Sgavinm extern uint_t cmi_hdl_family(cmi_hdl_t); 15020c794b3Sgavinm extern uint_t cmi_hdl_model(cmi_hdl_t); 15120c794b3Sgavinm extern uint_t cmi_hdl_stepping(cmi_hdl_t); 15220c794b3Sgavinm extern uint_t cmi_hdl_chipid(cmi_hdl_t); 153*8031591dSSrihari Venkatesan extern uint_t cmi_hdl_procnodeid(cmi_hdl_t); 15420c794b3Sgavinm extern uint_t cmi_hdl_coreid(cmi_hdl_t); 15520c794b3Sgavinm extern uint_t cmi_hdl_strandid(cmi_hdl_t); 156074bb90dSTom Pothier extern uint_t cmi_hdl_strand_apicid(cmi_hdl_t); 157*8031591dSSrihari Venkatesan extern uint_t cmi_hdl_procnodes_per_pkg(cmi_hdl_t); 158e4b86885SCheng Sean Ye extern boolean_t cmi_hdl_is_cmt(cmi_hdl_t); 15920c794b3Sgavinm extern uint32_t cmi_hdl_chiprev(cmi_hdl_t); 16020c794b3Sgavinm extern const char *cmi_hdl_chiprevstr(cmi_hdl_t); 16120c794b3Sgavinm extern uint32_t cmi_hdl_getsockettype(cmi_hdl_t); 16289e921d5SKuriakose Kuruvilla extern const char *cmi_hdl_getsocketstr(cmi_hdl_t); 163e4b86885SCheng Sean Ye extern id_t cmi_hdl_logical_id(cmi_hdl_t); 164074bb90dSTom Pothier extern uint16_t cmi_hdl_smbiosid(cmi_hdl_t); 165074bb90dSTom Pothier extern uint_t cmi_hdl_smb_chipid(cmi_hdl_t); 166074bb90dSTom Pothier extern nvlist_t *cmi_hdl_smb_bboard(cmi_hdl_t); 167e4b86885SCheng Sean Ye 168e4b86885SCheng Sean Ye extern int cmi_hdl_online(cmi_hdl_t, int, int *); 16920c794b3Sgavinm 17020c794b3Sgavinm #ifndef __xpv 17120c794b3Sgavinm extern uint_t cmi_ntv_hwchipid(cpu_t *); 172*8031591dSSrihari Venkatesan extern uint_t cmi_ntv_hwprocnodeid(cpu_t *); 17320c794b3Sgavinm extern uint_t cmi_ntv_hwcoreid(cpu_t *); 17420c794b3Sgavinm extern uint_t cmi_ntv_hwstrandid(cpu_t *); 17520c794b3Sgavinm #endif /* __xpv */ 176822fb41dStsien 1777aec1d6eScindi typedef struct cmi_mca_regs { 1787aec1d6eScindi uint_t cmr_msrnum; 1797aec1d6eScindi uint64_t cmr_msrval; 1807aec1d6eScindi } cmi_mca_regs_t; 181822fb41dStsien 18220c794b3Sgavinm extern cmi_errno_t cmi_hdl_msrinject(cmi_hdl_t, cmi_mca_regs_t *, uint_t, 18320c794b3Sgavinm int); 18420c794b3Sgavinm extern void cmi_hdl_msrinterpose(cmi_hdl_t, cmi_mca_regs_t *, uint_t); 185e4b86885SCheng Sean Ye extern void cmi_hdl_msrforward(cmi_hdl_t, cmi_mca_regs_t *, uint_t); 186e4b86885SCheng Sean Ye extern boolean_t cmi_inj_tainted(void); 18720c794b3Sgavinm 18820c794b3Sgavinm extern void cmi_faulted_enter(cmi_hdl_t); 18920c794b3Sgavinm extern void cmi_faulted_exit(cmi_hdl_t); 19020c794b3Sgavinm 19120c794b3Sgavinm extern void cmi_pcird_nohw(void); 19220c794b3Sgavinm extern void cmi_pciwr_nohw(void); 19320c794b3Sgavinm extern uint8_t cmi_pci_getb(int, int, int, int, int *, ddi_acc_handle_t); 19420c794b3Sgavinm extern uint16_t cmi_pci_getw(int, int, int, int, int *, ddi_acc_handle_t); 19520c794b3Sgavinm extern uint32_t cmi_pci_getl(int, int, int, int, int *, ddi_acc_handle_t); 19620c794b3Sgavinm extern void cmi_pci_interposeb(int, int, int, int, uint8_t); 19720c794b3Sgavinm extern void cmi_pci_interposew(int, int, int, int, uint16_t); 19820c794b3Sgavinm extern void cmi_pci_interposel(int, int, int, int, uint32_t); 19920c794b3Sgavinm extern void cmi_pci_putb(int, int, int, int, ddi_acc_handle_t, uint8_t); 20020c794b3Sgavinm extern void cmi_pci_putw(int, int, int, int, ddi_acc_handle_t, uint16_t); 20120c794b3Sgavinm extern void cmi_pci_putl(int, int, int, int, ddi_acc_handle_t, uint32_t); 202822fb41dStsien 20320c794b3Sgavinm extern void cmi_mca_init(cmi_hdl_t); 204822fb41dStsien 20520c794b3Sgavinm extern void cmi_hdl_poke(cmi_hdl_t); 206e3d60c9bSAdrian Frost extern void cmi_hdl_int(cmi_hdl_t, int); 2077c478bd9Sstevel@tonic-gate 20820c794b3Sgavinm extern void cmi_mca_trap(struct regs *); 20920c794b3Sgavinm 21020c794b3Sgavinm extern boolean_t cmi_panic_on_ue(void); 21120c794b3Sgavinm 21220c794b3Sgavinm extern void cmi_mc_register(cmi_hdl_t, const struct cmi_mc_ops *, void *); 213e4b86885SCheng Sean Ye extern void cmi_mc_sw_memscrub_disable(void); 21420c794b3Sgavinm extern cmi_errno_t cmi_mc_patounum(uint64_t, uint8_t, uint8_t, uint32_t, int, 2154156fc34Sgavinm mc_unum_t *); 21620c794b3Sgavinm extern cmi_errno_t cmi_mc_unumtopa(mc_unum_t *, nvlist_t *, uint64_t *); 21720c794b3Sgavinm extern void cmi_mc_logout(cmi_hdl_t, boolean_t, boolean_t); 21820c794b3Sgavinm 219e4b86885SCheng Sean Ye extern void cmi_panic_callback(void); 220e4b86885SCheng Sean Ye 22120c794b3Sgavinm #endif /* _KERNEL */ 2227c478bd9Sstevel@tonic-gate 2237c478bd9Sstevel@tonic-gate #ifdef __cplusplus 2247c478bd9Sstevel@tonic-gate } 2257c478bd9Sstevel@tonic-gate #endif 2267c478bd9Sstevel@tonic-gate 2277aec1d6eScindi #endif /* _SYS_CPU_MODULE_H */ 228