1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport/*
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport * CDDL HEADER START
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport *
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport * The contents of this file are subject to the terms of the
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport * Common Development and Distribution License (the "License").
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport * You may not use this file except in compliance with the License.
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport *
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport * or http://www.opensolaris.org/os/licensing.
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport * See the License for the specific language governing permissions
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport * and limitations under the License.
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport *
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport * When distributing Covered Code, include this CDDL HEADER in each
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport * If applicable, add the following below this CDDL HEADER, with the
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport * fields enclosed by brackets "[]" replaced with your own identifying
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport * information: Portions Copyright [yyyy] [name of copyright owner]
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport *
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport * CDDL HEADER END
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport */
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport/*
cfb7311ca709ca6f4d930977c7498455556b5312Louis Tsien * Copyright (c) 2008, 2010, Oracle and/or its affiliates. All rights reserved.
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport */
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport#ifndef _GMEM_DIMM_H
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport#define _GMEM_DIMM_H
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport/*
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport * Memory modules are described by the gmem_dimm general-purpose state
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport * structure.
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport *
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport * Data structure P? Case? Notes
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport * ---------------- --- ----- ----------------------------------------------
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport * gmem_dimm_t Yes No Name is derived from the serial ("dimm_%s")
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport * gmem_case_ptr_t Yes Yes Name is case's UUID
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport * dimm_asru Yes No Name is derived from the serial
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport * ("dimm_asru_%s")
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport * dimm_serial No No Pointer into ASRU - relinked during restore
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport */
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport#include <gmem_mem.h>
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport#include <values.h>
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport#ifdef __cplusplus
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenportextern "C" {
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport#endif
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport/*
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport * GMEM_MAX_CKWDS denotes the highest number, across all covered
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport * SPARC architectures, of checkwords per cache line.
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport */
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport#define GMEM_MAX_CKWDS 8
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport#define FINDRSC 0
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport#define FINDFRU 1
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport#define FINDASRU 2
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport#define DIMM_MKVERSION(version) (version)
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport#define GMEM_DIMM_VERSION_0 DIMM_MKVERSION(0)
d4ac42a1cd3016618a9ba0330862d410f0058f89Trang Do#define GMEM_DIMM_VERSION_1 DIMM_MKVERSION(1)
d4ac42a1cd3016618a9ba0330862d410f0058f89Trang Do#define GMEM_DIMM_VERSION GMEM_DIMM_VERSION_1
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport#define GMEM_DIMM_VERSIONED(dimm) ((dimm)->dimm_version)
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport#define GMEM_DIMM_STAT_PREFIX "DIMM_"
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport
d4ac42a1cd3016618a9ba0330862d410f0058f89Trang Dotypedef struct gmem_dimm_0 {
d4ac42a1cd3016618a9ba0330862d410f0058f89Trang Do gmem_header_t dimm0_header; /* Nodetype must be GMEM_NT_DIMM */
d4ac42a1cd3016618a9ba0330862d410f0058f89Trang Do uint_t dimm0_version; /* DIMM version */
d4ac42a1cd3016618a9ba0330862d410f0058f89Trang Do gmem_fmri_t dimm0_asru; /* ASRU for this DIMM */
d4ac42a1cd3016618a9ba0330862d410f0058f89Trang Do uint_t dimm0_flags; /* GMEM_MEM_F_* */
d4ac42a1cd3016618a9ba0330862d410f0058f89Trang Do uint_t dimm0_nretired; /* # ret'd pages for CEs in DIMM */
d4ac42a1cd3016618a9ba0330862d410f0058f89Trang Do} gmem_dimm_0_t;
d4ac42a1cd3016618a9ba0330862d410f0058f89Trang Do
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenporttypedef struct gmem_dimm_pers {
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport gmem_header_t dimmp_header; /* Nodetype must be GMEM_NT_DIMM */
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport uint_t dimmp_version;
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport gmem_fmri_t dimmp_asru; /* ASRU for this DIMM */
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport uint_t dimmp_flags; /* GMEM_MEM_F_* */
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport uint_t dimmp_nretired; /* # ret'd pages for CEs in DIMM */
d4ac42a1cd3016618a9ba0330862d410f0058f89Trang Do uint64_t dimmp_phys_addr_hi; /* retired page addr high */
d4ac42a1cd3016618a9ba0330862d410f0058f89Trang Do uint64_t dimmp_phys_addr_low; /* retired page addr low */
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport} gmem_dimm_pers_t;
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport/*
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport * Index block for MQSC rules 4A and 4B correlation of memory CEs
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport * on a single DIMM. "Unit Position" refers to bit or nibble depending
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport * on the memory ECC. This structure is not persisted.
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport */
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenporttypedef struct gmem_mq {
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport gmem_list_t mq_l; /* pointers to prev and next */
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport uint64_t mq_tstamp; /* timestamp of ereport in secs */
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport uint16_t mq_ckwd; /* phys addr mod 64 */
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport uint64_t mq_phys_addr; /* from ereport */
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport uint16_t mq_unit_position; /* bit for sun4u, nibble for sun4v */
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport fmd_event_t *mq_ep; /* ereport - for potential fault */
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport char *mq_serdnm; /* serd eng to retain CE events */
d4ac42a1cd3016618a9ba0330862d410f0058f89Trang Do uint16_t mq_dupce_count; /* count dup CEs */
d4ac42a1cd3016618a9ba0330862d410f0058f89Trang Do gmem_list_t mq_dupce_tstamp; /* list dup CE time stamp */
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport} gmem_mq_t;
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport
d4ac42a1cd3016618a9ba0330862d410f0058f89Trang Dotypedef struct tstamp {
d4ac42a1cd3016618a9ba0330862d410f0058f89Trang Do gmem_list_t ts_l;
d4ac42a1cd3016618a9ba0330862d410f0058f89Trang Do uint64_t tstamp;
d4ac42a1cd3016618a9ba0330862d410f0058f89Trang Do} tstamp_t;
d4ac42a1cd3016618a9ba0330862d410f0058f89Trang Do
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenportstruct gmem_dimm {
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport gmem_dimm_pers_t dimm_pers;
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport char *dimm_serial; /* Dimm serial number */
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport gmem_case_t dimm_case; /* Open CE case against this DIMM */
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport fmd_stat_t dimm_retstat; /* retirement statistics, this DIMM */
d4ac42a1cd3016618a9ba0330862d410f0058f89Trang Do uint16_t dimm_syl_error; /* bad rw symbol-in-error */
8f6658897e88431fedd1dbcecab56535cb8a6ebfTrang Do uint32_t dimm_chipid; /* detector */
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport gmem_list_t
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport mq_root[GMEM_MAX_CKWDS]; /* per-checkword CEs to correlate */
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport};
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport#define GMEM_MQ_TIMELIM (72*60*60) /* 72 hours */
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport#define GMEM_MQ_SERDT MAXINT /* Never expected to fire */
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport#define GMEM_MQ_SERDN 2 /* Dup CEs not allowed */
d4ac42a1cd3016618a9ba0330862d410f0058f89Trang Do#define GMEM_MQ_512KB 0x80000 /* space between hi-low addr */
d4ac42a1cd3016618a9ba0330862d410f0058f89Trang Do#define GMEM_MQ_RATIO 0.0625 /* bad r/w page ratio (1/16) */
d4ac42a1cd3016618a9ba0330862d410f0058f89Trang Do
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport
d4ac42a1cd3016618a9ba0330862d410f0058f89Trang Do#define GMEM_DIMM_MAXSIZE MAX(sizeof (gmem_dimm_0_t), sizeof (gmem_dimm_pers_t))
d4ac42a1cd3016618a9ba0330862d410f0058f89Trang Do#define GMEM_DIMM_MINSIZE MIN(sizeof (gmem_dimm_0_t), sizeof (gmem_dimm_pers_t))
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport#define dimm_header dimm_pers.dimmp_header
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport#define dimm_nodetype dimm_pers.dimmp_header.hdr_nodetype
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport#define dimm_bufname dimm_pers.dimmp_header.hdr_bufname
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport#define dimm_version dimm_pers.dimmp_version
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport#define dimm_asru dimm_pers.dimmp_asru
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport#define dimm_asru_nvl dimm_pers.dimmp_asru.fmri_nvl
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport#define dimm_flags dimm_pers.dimmp_flags
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport#define dimm_nretired dimm_pers.dimmp_nretired
d4ac42a1cd3016618a9ba0330862d410f0058f89Trang Do#define dimm_phys_addr_hi dimm_pers.dimmp_phys_addr_hi
d4ac42a1cd3016618a9ba0330862d410f0058f89Trang Do#define dimm_phys_addr_low dimm_pers.dimmp_phys_addr_low
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenportextern gmem_dimm_t *gmem_dimm_lookup(fmd_hdl_t *, nvlist_t *);
8f6658897e88431fedd1dbcecab56535cb8a6ebfTrang Doextern gmem_dimm_t *gmem_dimm_create(fmd_hdl_t *, nvlist_t *, nvlist_t *);
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenportextern nvlist_t *gmem_dimm_fru(gmem_dimm_t *);
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenportextern int gmem_dimm_thresh_reached(fmd_hdl_t *, gmem_dimm_t *, uint64_t,
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport uint16_t);
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenportextern nvlist_t *gmem_find_dimm_fru(fmd_hdl_t *, char *);
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenportextern nvlist_t *gmem_find_dimm_rsc(fmd_hdl_t *, char *);
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenportextern nvlist_t *gmem_find_dimm_asru(fmd_hdl_t *, char *);
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenportextern int gmem_dimm_present(fmd_hdl_t *, nvlist_t *asru);
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenportextern void gmem_dimm_dirty(fmd_hdl_t *, gmem_dimm_t *);
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenportextern void *gmem_dimm_restore(fmd_hdl_t *, fmd_case_t *, gmem_case_ptr_t *);
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenportextern void gmem_dimm_destroy(fmd_hdl_t *, gmem_dimm_t *);
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenportextern void gmem_dimm_validate(fmd_hdl_t *);
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenportextern void gmem_dimm_gc(fmd_hdl_t *);
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenportextern void gmem_dimm_fini(fmd_hdl_t *);
d4ac42a1cd3016618a9ba0330862d410f0058f89Trang Doextern int gmem_same_datapath_dimms(fmd_hdl_t *, gmem_dimm_t *, gmem_dimm_t *);
d4ac42a1cd3016618a9ba0330862d410f0058f89Trang Doextern int gmem_check_symbol_error(fmd_hdl_t *, gmem_dimm_t *, uint16_t);
d4ac42a1cd3016618a9ba0330862d410f0058f89Trang Doextern void gmem_save_symbol_error(fmd_hdl_t *, gmem_dimm_t *, uint16_t);
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport#ifdef __cplusplus
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport}
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport#endif
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport
1529f529004c61fcfd0d95ab79b0f257d6ad4451Scott Davenport#endif /* _GMEM_DIMM_H */