drivers/edac/edac_mc.h

   1 /*
   2  * Defines, structures, APIs for edac_mc module
   3  *
   4  * (C) 2007 Linux Networx (http://lnxi.com)
   5  * This file may be distributed under the terms of the
   6  * GNU General Public License.
   7  *
   8  * Written by Thayne Harbaugh
   9  * Based on work by Dan Hollis <goemon at anime dot net> and others.
  10  *      http://www.anime.net/~goemon/linux-ecc/
  11  *
  12  * NMI handling support added by
  13  *     Dave Peterson <dsp@llnl.gov> <dave_peterson@pobox.com>
  14  *
  15  * Refactored for multi-source files:
  16  *      Doug Thompson <norsk5@xmission.com>
  17  *
  18  * Please look at Documentation/driver-api/edac.rst for more info about
  19  * EDAC core structs and functions.
  20  */
  21
  22 #ifndef _EDAC_MC_H_
  23 #define _EDAC_MC_H_
  24
  25 #include <linux/kernel.h>
  26 #include <linux/types.h>
  27 #include <linux/module.h>
  28 #include <linux/spinlock.h>
  29 #include <linux/smp.h>
  30 #include <linux/pci.h>
  31 #include <linux/time.h>
  32 #include <linux/nmi.h>
  33 #include <linux/rcupdate.h>
  34 #include <linux/completion.h>
  35 #include <linux/kobject.h>
  36 #include <linux/platform_device.h>
  37 #include <linux/workqueue.h>
  38 #include <linux/edac.h>
  39
  40 #if PAGE_SHIFT < 20
  41 #define PAGES_TO_MiB(pages)     ((pages) >> (20 - PAGE_SHIFT))
  42 #define MiB_TO_PAGES(mb)        ((mb) << (20 - PAGE_SHIFT))
  43 #else                           /* PAGE_SHIFT > 20 */
  44 #define PAGES_TO_MiB(pages)     ((pages) << (PAGE_SHIFT - 20))
  45 #define MiB_TO_PAGES(mb)        ((mb) >> (PAGE_SHIFT - 20))
  46 #endif
  47
  48 #define edac_printk(level, prefix, fmt, arg...) \
  49         printk(level "EDAC " prefix ": " fmt, ##arg)
  50
  51 #define edac_mc_printk(mci, level, fmt, arg...) \
  52         printk(level "EDAC MC%d: " fmt, mci->mc_idx, ##arg)
  53
  54 #define edac_mc_chipset_printk(mci, level, prefix, fmt, arg...) \
  55         printk(level "EDAC " prefix " MC%d: " fmt, mci->mc_idx, ##arg)
  56
  57 #define edac_device_printk(ctl, level, fmt, arg...) \
  58         printk(level "EDAC DEVICE%d: " fmt, ctl->dev_idx, ##arg)
  59
  60 #define edac_pci_printk(ctl, level, fmt, arg...) \
  61         printk(level "EDAC PCI%d: " fmt, ctl->pci_idx, ##arg)
  62
  63 /* prefixes for edac_printk() and edac_mc_printk() */
  64 #define EDAC_MC "MC"
  65 #define EDAC_PCI "PCI"
  66 #define EDAC_DEBUG "DEBUG"
  67
  68 extern const char * const edac_mem_types[];
  69
  70 #ifdef CONFIG_EDAC_DEBUG
  71 extern int edac_debug_level;
  72
  73 #define edac_dbg(level, fmt, ...)                                       \
  74 do {                                                                    \
  75         if (level <= edac_debug_level)                                  \
  76                 edac_printk(KERN_DEBUG, EDAC_DEBUG,                     \
  77                             "%s: " fmt, __func__, ##__VA_ARGS__);       \
  78 } while (0)
  79
  80 #else                           /* !CONFIG_EDAC_DEBUG */
  81
  82 #define edac_dbg(level, fmt, ...)                                       \
  83 do {                                                                    \
  84         if (0)                                                          \
  85                 edac_printk(KERN_DEBUG, EDAC_DEBUG,                     \
  86                             "%s: " fmt, __func__, ##__VA_ARGS__);       \
  87 } while (0)
  88
  89 #endif                          /* !CONFIG_EDAC_DEBUG */
  90
  91 #define PCI_VEND_DEV(vend, dev) PCI_VENDOR_ID_ ## vend, \
  92         PCI_DEVICE_ID_ ## vend ## _ ## dev
  93
  94 #define edac_dev_name(dev) (dev)->dev_name
  95
  96 #define to_mci(k) container_of(k, struct mem_ctl_info, dev)
  97
  98 /**
  99  * edac_mc_alloc() - Allocate and partially fill a struct &mem_ctl_info.
 100  *
 101  * @mc_num:             Memory controller number
 102  * @n_layers:           Number of MC hierarchy layers
 103  * @layers:             Describes each layer as seen by the Memory Controller
 104  * @sz_pvt:             size of private storage needed
 105  *
 106  *
 107  * Everything is kmalloc'ed as one big chunk - more efficient.
 108  * Only can be used if all structures have the same lifetime - otherwise
 109  * you have to allocate and initialize your own structures.
 110  *
 111  * Use edac_mc_free() to free mc structures allocated by this function.
 112  *
 113  * .. note::
 114  *
 115  *   drivers handle multi-rank memories in different ways: in some
 116  *   drivers, one multi-rank memory stick is mapped as one entry, while, in
 117  *   others, a single multi-rank memory stick would be mapped into several
 118  *   entries. Currently, this function will allocate multiple struct dimm_info
 119  *   on such scenarios, as grouping the multiple ranks require drivers change.
 120  *
 121  * Returns:
 122  *      On success, return a pointer to struct mem_ctl_info pointer;
 123  *      %NULL otherwise
 124  */
 125 struct mem_ctl_info *edac_mc_alloc(unsigned mc_num,
 126                                    unsigned n_layers,
 127                                    struct edac_mc_layer *layers,
 128                                    unsigned sz_pvt);
 129
 130 /**
 131  * edac_mc_add_mc_with_groups() - Insert the @mci structure into the mci
 132  *      global list and create sysfs entries associated with @mci structure.
 133  *
 134  * @mci: pointer to the mci structure to be added to the list
 135  * @groups: optional attribute groups for the driver-specific sysfs entries
 136  *
 137  * Returns:
 138  *      0 on Success, or an error code on failure
 139  */
 140 extern int edac_mc_add_mc_with_groups(struct mem_ctl_info *mci,
 141                                       const struct attribute_group **groups);
 142 #define edac_mc_add_mc(mci)     edac_mc_add_mc_with_groups(mci, NULL)
 143
 144 /**
 145  * edac_mc_free() -  Frees a previously allocated @mci structure
 146  *
 147  * @mci: pointer to a struct mem_ctl_info structure
 148  */
 149 extern void edac_mc_free(struct mem_ctl_info *mci);
 150
 151 /**
 152  * edac_mc_find() - Search for a mem_ctl_info structure whose index is @idx.
 153  *
 154  * @idx: index to be seek
 155  *
 156  * If found, return a pointer to the structure.
 157  * Else return NULL.
 158  */
 159 extern struct mem_ctl_info *edac_mc_find(int idx);
 160
 161 /**
 162  * find_mci_by_dev() - Scan list of controllers looking for the one that
 163  *      manages the @dev device.
 164  *
 165  * @dev: pointer to a struct device related with the MCI
 166  *
 167  * Returns: on success, returns a pointer to struct &mem_ctl_info;
 168  * %NULL otherwise.
 169  */
 170 extern struct mem_ctl_info *find_mci_by_dev(struct device *dev);
 171
 172 /**
 173  * edac_mc_del_mc() - Remove sysfs entries for mci structure associated with
 174  *      @dev and remove mci structure from global list.
 175  *
 176  * @dev: Pointer to struct &device representing mci structure to remove.
 177  *
 178  * Returns: pointer to removed mci structure, or %NULL if device not found.
 179  */
 180 extern struct mem_ctl_info *edac_mc_del_mc(struct device *dev);
 181
 182 /**
 183  * edac_mc_find_csrow_by_page() - Ancillary routine to identify what csrow
 184  *      contains a memory page.
 185  *
 186  * @mci: pointer to a struct mem_ctl_info structure
 187  * @page: memory page to find
 188  *
 189  * Returns: on success, returns the csrow. -1 if not found.
 190  */
 191 extern int edac_mc_find_csrow_by_page(struct mem_ctl_info *mci,
 192                                       unsigned long page);
 193
 194 /**
 195  * edac_raw_mc_handle_error() - Reports a memory event to userspace without
 196  *      doing anything to discover the error location.
 197  *
 198  * @type:               severity of the error (CE/UE/Fatal)
 199  * @mci:                a struct mem_ctl_info pointer
 200  * @e:                  error description
 201  *
 202  * This raw function is used internally by edac_mc_handle_error(). It should
 203  * only be called directly when the hardware error come directly from BIOS,
 204  * like in the case of APEI GHES driver.
 205  */
 206 void edac_raw_mc_handle_error(const enum hw_event_mc_err_type type,
 207                               struct mem_ctl_info *mci,
 208                               struct edac_raw_error_desc *e);
 209
 210 /**
 211  * edac_mc_handle_error() - Reports a memory event to userspace.
 212  *
 213  * @type:               severity of the error (CE/UE/Fatal)
 214  * @mci:                a struct mem_ctl_info pointer
 215  * @error_count:        Number of errors of the same type
 216  * @page_frame_number:  mem page where the error occurred
 217  * @offset_in_page:     offset of the error inside the page
 218  * @syndrome:           ECC syndrome
 219  * @top_layer:          Memory layer[0] position
 220  * @mid_layer:          Memory layer[1] position
 221  * @low_layer:          Memory layer[2] position
 222  * @msg:                Message meaningful to the end users that
 223  *                      explains the event
 224  * @other_detail:       Technical details about the event that
 225  *                      may help hardware manufacturers and
 226  *                      EDAC developers to analyse the event
 227  */
 228 void edac_mc_handle_error(const enum hw_event_mc_err_type type,
 229                           struct mem_ctl_info *mci,
 230                           const u16 error_count,
 231                           const unsigned long page_frame_number,
 232                           const unsigned long offset_in_page,
 233                           const unsigned long syndrome,
 234                           const int top_layer,
 235                           const int mid_layer,
 236                           const int low_layer,
 237                           const char *msg,
 238                           const char *other_detail);
 239
 240 /*
 241  * edac misc APIs
 242  */
 243 extern char *edac_op_state_to_string(int op_state);
 244
 245 #endif                          /* _EDAC_MC_H_ */