2  * edac_mc kernel module
 
   3  * (C) 2005-2007 Linux Networx (http://lnxi.com)
 
   5  * This file may be distributed under the terms of the
 
   6  * GNU General Public License.
 
   8  * Written Doug Thompson <norsk5@xmission.com> www.softwarebitmaker.com
 
  12 #include <linux/ctype.h>
 
  13 #include <linux/bug.h>
 
  15 #include "edac_core.h"
 
  16 #include "edac_module.h"
 
  19 /* MC EDAC Controls, setable by module parameter, and sysfs */
 
  20 static int edac_mc_log_ue = 1;
 
  21 static int edac_mc_log_ce = 1;
 
  22 static int edac_mc_panic_on_ue;
 
  23 static int edac_mc_poll_msec = 1000;
 
  25 /* Getter functions for above */
 
  26 int edac_mc_get_log_ue(void)
 
  28         return edac_mc_log_ue;
 
  31 int edac_mc_get_log_ce(void)
 
  33         return edac_mc_log_ce;
 
  36 int edac_mc_get_panic_on_ue(void)
 
  38         return edac_mc_panic_on_ue;
 
  41 /* this is temporary */
 
  42 int edac_mc_get_poll_msec(void)
 
  44         return edac_mc_poll_msec;
 
  47 /* Parameter declarations for above */
 
  48 module_param(edac_mc_panic_on_ue, int, 0644);
 
  49 MODULE_PARM_DESC(edac_mc_panic_on_ue, "Panic on uncorrected error: 0=off 1=on");
 
  50 module_param(edac_mc_log_ue, int, 0644);
 
  51 MODULE_PARM_DESC(edac_mc_log_ue,
 
  52                  "Log uncorrectable error to console: 0=off 1=on");
 
  53 module_param(edac_mc_log_ce, int, 0644);
 
  54 MODULE_PARM_DESC(edac_mc_log_ce,
 
  55                  "Log correctable error to console: 0=off 1=on");
 
  56 module_param(edac_mc_poll_msec, int, 0644);
 
  57 MODULE_PARM_DESC(edac_mc_poll_msec, "Polling period in milliseconds");
 
  60  * various constants for Memory Controllers
 
  62 static const char *mem_types[] = {
 
  63         [MEM_EMPTY] = "Empty",
 
  64         [MEM_RESERVED] = "Reserved",
 
  65         [MEM_UNKNOWN] = "Unknown",
 
  69         [MEM_SDR] = "Unbuffered-SDR",
 
  70         [MEM_RDR] = "Registered-SDR",
 
  71         [MEM_DDR] = "Unbuffered-DDR",
 
  72         [MEM_RDDR] = "Registered-DDR",
 
  74         [MEM_DDR2] = "Unbuffered-DDR2",
 
  75         [MEM_FB_DDR2] = "FullyBuffered-DDR2",
 
  76         [MEM_RDDR2] = "Registered-DDR2"
 
  79 static const char *dev_types[] = {
 
  80         [DEV_UNKNOWN] = "Unknown",
 
  90 static const char *edac_caps[] = {
 
  91         [EDAC_UNKNOWN] = "Unknown",
 
  93         [EDAC_RESERVED] = "Reserved",
 
  94         [EDAC_PARITY] = "PARITY",
 
  96         [EDAC_SECDED] = "SECDED",
 
  97         [EDAC_S2ECD2ED] = "S2ECD2ED",
 
  98         [EDAC_S4ECD4ED] = "S4ECD4ED",
 
  99         [EDAC_S8ECD8ED] = "S8ECD8ED",
 
 100         [EDAC_S16ECD16ED] = "S16ECD16ED"
 
 106  * /sys/devices/system/edac/mc;
 
 107  *      data structures and methods
 
 109 static ssize_t memctrl_int_show(void *ptr, char *buffer)
 
 111         int *value = (int *)ptr;
 
 112         return sprintf(buffer, "%u\n", *value);
 
 115 static ssize_t memctrl_int_store(void *ptr, const char *buffer, size_t count)
 
 117         int *value = (int *)ptr;
 
 119         if (isdigit(*buffer))
 
 120                 *value = simple_strtoul(buffer, NULL, 0);
 
 126  * mc poll_msec time value
 
 128 static ssize_t poll_msec_int_store(void *ptr, const char *buffer, size_t count)
 
 130         int *value = (int *)ptr;
 
 132         if (isdigit(*buffer)) {
 
 133                 *value = simple_strtoul(buffer, NULL, 0);
 
 135                 /* notify edac_mc engine to reset the poll period */
 
 136                 edac_mc_reset_delay_period(*value);
 
 143 /* EDAC sysfs CSROW data structures and methods
 
 146 /* Set of more default csrow<id> attribute show/store functions */
 
 147 static ssize_t csrow_ue_count_show(struct csrow_info *csrow, char *data,
 
 150         return sprintf(data, "%u\n", csrow->ue_count);
 
 153 static ssize_t csrow_ce_count_show(struct csrow_info *csrow, char *data,
 
 156         return sprintf(data, "%u\n", csrow->ce_count);
 
 159 static ssize_t csrow_size_show(struct csrow_info *csrow, char *data,
 
 162         return sprintf(data, "%u\n", PAGES_TO_MiB(csrow->nr_pages));
 
 165 static ssize_t csrow_mem_type_show(struct csrow_info *csrow, char *data,
 
 168         return sprintf(data, "%s\n", mem_types[csrow->mtype]);
 
 171 static ssize_t csrow_dev_type_show(struct csrow_info *csrow, char *data,
 
 174         return sprintf(data, "%s\n", dev_types[csrow->dtype]);
 
 177 static ssize_t csrow_edac_mode_show(struct csrow_info *csrow, char *data,
 
 180         return sprintf(data, "%s\n", edac_caps[csrow->edac_mode]);
 
 183 /* show/store functions for DIMM Label attributes */
 
 184 static ssize_t channel_dimm_label_show(struct csrow_info *csrow,
 
 185                                 char *data, int channel)
 
 187         return snprintf(data, EDAC_MC_LABEL_LEN, "%s",
 
 188                         csrow->channels[channel].label);
 
 191 static ssize_t channel_dimm_label_store(struct csrow_info *csrow,
 
 193                                         size_t count, int channel)
 
 195         ssize_t max_size = 0;
 
 197         max_size = min((ssize_t) count, (ssize_t) EDAC_MC_LABEL_LEN - 1);
 
 198         strncpy(csrow->channels[channel].label, data, max_size);
 
 199         csrow->channels[channel].label[max_size] = '\0';
 
 204 /* show function for dynamic chX_ce_count attribute */
 
 205 static ssize_t channel_ce_count_show(struct csrow_info *csrow,
 
 206                                 char *data, int channel)
 
 208         return sprintf(data, "%u\n", csrow->channels[channel].ce_count);
 
 211 /* csrow specific attribute structure */
 
 212 struct csrowdev_attribute {
 
 213         struct attribute attr;
 
 214          ssize_t(*show) (struct csrow_info *, char *, int);
 
 215          ssize_t(*store) (struct csrow_info *, const char *, size_t, int);
 
 219 #define to_csrow(k) container_of(k, struct csrow_info, kobj)
 
 220 #define to_csrowdev_attr(a) container_of(a, struct csrowdev_attribute, attr)
 
 222 /* Set of show/store higher level functions for default csrow attributes */
 
 223 static ssize_t csrowdev_show(struct kobject *kobj,
 
 224                         struct attribute *attr, char *buffer)
 
 226         struct csrow_info *csrow = to_csrow(kobj);
 
 227         struct csrowdev_attribute *csrowdev_attr = to_csrowdev_attr(attr);
 
 229         if (csrowdev_attr->show)
 
 230                 return csrowdev_attr->show(csrow,
 
 231                                         buffer, csrowdev_attr->private);
 
 235 static ssize_t csrowdev_store(struct kobject *kobj, struct attribute *attr,
 
 236                         const char *buffer, size_t count)
 
 238         struct csrow_info *csrow = to_csrow(kobj);
 
 239         struct csrowdev_attribute *csrowdev_attr = to_csrowdev_attr(attr);
 
 241         if (csrowdev_attr->store)
 
 242                 return csrowdev_attr->store(csrow,
 
 244                                         count, csrowdev_attr->private);
 
 248 static struct sysfs_ops csrowfs_ops = {
 
 249         .show = csrowdev_show,
 
 250         .store = csrowdev_store
 
 253 #define CSROWDEV_ATTR(_name,_mode,_show,_store,_private)        \
 
 254 static struct csrowdev_attribute attr_##_name = {                       \
 
 255         .attr = {.name = __stringify(_name), .mode = _mode },   \
 
 258         .private = _private,                                    \
 
 261 /* default cwrow<id>/attribute files */
 
 262 CSROWDEV_ATTR(size_mb, S_IRUGO, csrow_size_show, NULL, 0);
 
 263 CSROWDEV_ATTR(dev_type, S_IRUGO, csrow_dev_type_show, NULL, 0);
 
 264 CSROWDEV_ATTR(mem_type, S_IRUGO, csrow_mem_type_show, NULL, 0);
 
 265 CSROWDEV_ATTR(edac_mode, S_IRUGO, csrow_edac_mode_show, NULL, 0);
 
 266 CSROWDEV_ATTR(ue_count, S_IRUGO, csrow_ue_count_show, NULL, 0);
 
 267 CSROWDEV_ATTR(ce_count, S_IRUGO, csrow_ce_count_show, NULL, 0);
 
 269 /* default attributes of the CSROW<id> object */
 
 270 static struct csrowdev_attribute *default_csrow_attr[] = {
 
 280 /* possible dynamic channel DIMM Label attribute files */
 
 281 CSROWDEV_ATTR(ch0_dimm_label, S_IRUGO | S_IWUSR,
 
 282         channel_dimm_label_show, channel_dimm_label_store, 0);
 
 283 CSROWDEV_ATTR(ch1_dimm_label, S_IRUGO | S_IWUSR,
 
 284         channel_dimm_label_show, channel_dimm_label_store, 1);
 
 285 CSROWDEV_ATTR(ch2_dimm_label, S_IRUGO | S_IWUSR,
 
 286         channel_dimm_label_show, channel_dimm_label_store, 2);
 
 287 CSROWDEV_ATTR(ch3_dimm_label, S_IRUGO | S_IWUSR,
 
 288         channel_dimm_label_show, channel_dimm_label_store, 3);
 
 289 CSROWDEV_ATTR(ch4_dimm_label, S_IRUGO | S_IWUSR,
 
 290         channel_dimm_label_show, channel_dimm_label_store, 4);
 
 291 CSROWDEV_ATTR(ch5_dimm_label, S_IRUGO | S_IWUSR,
 
 292         channel_dimm_label_show, channel_dimm_label_store, 5);
 
 294 /* Total possible dynamic DIMM Label attribute file table */
 
 295 static struct csrowdev_attribute *dynamic_csrow_dimm_attr[] = {
 
 296         &attr_ch0_dimm_label,
 
 297         &attr_ch1_dimm_label,
 
 298         &attr_ch2_dimm_label,
 
 299         &attr_ch3_dimm_label,
 
 300         &attr_ch4_dimm_label,
 
 304 /* possible dynamic channel ce_count attribute files */
 
 305 CSROWDEV_ATTR(ch0_ce_count, S_IRUGO | S_IWUSR, channel_ce_count_show, NULL, 0);
 
 306 CSROWDEV_ATTR(ch1_ce_count, S_IRUGO | S_IWUSR, channel_ce_count_show, NULL, 1);
 
 307 CSROWDEV_ATTR(ch2_ce_count, S_IRUGO | S_IWUSR, channel_ce_count_show, NULL, 2);
 
 308 CSROWDEV_ATTR(ch3_ce_count, S_IRUGO | S_IWUSR, channel_ce_count_show, NULL, 3);
 
 309 CSROWDEV_ATTR(ch4_ce_count, S_IRUGO | S_IWUSR, channel_ce_count_show, NULL, 4);
 
 310 CSROWDEV_ATTR(ch5_ce_count, S_IRUGO | S_IWUSR, channel_ce_count_show, NULL, 5);
 
 312 /* Total possible dynamic ce_count attribute file table */
 
 313 static struct csrowdev_attribute *dynamic_csrow_ce_count_attr[] = {
 
 322 #define EDAC_NR_CHANNELS        6
 
 324 /* Create dynamic CHANNEL files, indexed by 'chan',  under specifed CSROW */
 
 325 static int edac_create_channel_files(struct kobject *kobj, int chan)
 
 329         if (chan >= EDAC_NR_CHANNELS)
 
 332         /* create the DIMM label attribute file */
 
 333         err = sysfs_create_file(kobj,
 
 335                                 dynamic_csrow_dimm_attr[chan]);
 
 338                 /* create the CE Count attribute file */
 
 339                 err = sysfs_create_file(kobj,
 
 341                                         dynamic_csrow_ce_count_attr[chan]);
 
 343                 debugf1("%s()  dimm labels and ce_count files created",
 
 350 /* No memory to release for this kobj */
 
 351 static void edac_csrow_instance_release(struct kobject *kobj)
 
 353         struct mem_ctl_info *mci;
 
 354         struct csrow_info *cs;
 
 356         debugf1("%s()\n", __func__);
 
 358         cs = container_of(kobj, struct csrow_info, kobj);
 
 361         kobject_put(&mci->edac_mci_kobj);
 
 364 /* the kobj_type instance for a CSROW */
 
 365 static struct kobj_type ktype_csrow = {
 
 366         .release = edac_csrow_instance_release,
 
 367         .sysfs_ops = &csrowfs_ops,
 
 368         .default_attrs = (struct attribute **)default_csrow_attr,
 
 371 /* Create a CSROW object under specifed edac_mc_device */
 
 372 static int edac_create_csrow_object(struct mem_ctl_info *mci,
 
 373                                         struct csrow_info *csrow, int index)
 
 375         struct kobject *kobj_mci = &mci->edac_mci_kobj;
 
 376         struct kobject *kobj;
 
 380         /* generate ..../edac/mc/mc<id>/csrow<index>   */
 
 381         memset(&csrow->kobj, 0, sizeof(csrow->kobj));
 
 382         csrow->mci = mci;       /* include container up link */
 
 383         csrow->kobj.parent = kobj_mci;
 
 384         csrow->kobj.ktype = &ktype_csrow;
 
 386         /* name this instance of csrow<id> */
 
 387         err = kobject_set_name(&csrow->kobj, "csrow%d", index);
 
 391         /* bump the mci instance's kobject's ref count */
 
 392         kobj = kobject_get(&mci->edac_mci_kobj);
 
 398         /* Instanstiate the csrow object */
 
 399         err = kobject_register(&csrow->kobj);
 
 401                 goto err_release_top_kobj;
 
 403         /* At this point, to release a csrow kobj, one must
 
 404          * call the kobject_unregister and allow that tear down
 
 405          * to work the releasing
 
 408         /* Create the dyanmic attribute files on this csrow,
 
 409          * namely, the DIMM labels and the channel ce_count
 
 411         for (chan = 0; chan < csrow->nr_channels; chan++) {
 
 412                 err = edac_create_channel_files(&csrow->kobj, chan);
 
 414                         /* special case the unregister here */
 
 415                         kobject_unregister(&csrow->kobj);
 
 422         /* error unwind stack */
 
 423 err_release_top_kobj:
 
 424         kobject_put(&mci->edac_mci_kobj);
 
 430 /* default sysfs methods and data structures for the main MCI kobject */
 
 432 static ssize_t mci_reset_counters_store(struct mem_ctl_info *mci,
 
 433                                         const char *data, size_t count)
 
 437         mci->ue_noinfo_count = 0;
 
 438         mci->ce_noinfo_count = 0;
 
 442         for (row = 0; row < mci->nr_csrows; row++) {
 
 443                 struct csrow_info *ri = &mci->csrows[row];
 
 448                 for (chan = 0; chan < ri->nr_channels; chan++)
 
 449                         ri->channels[chan].ce_count = 0;
 
 452         mci->start_time = jiffies;
 
 456 /* memory scrubbing */
 
 457 static ssize_t mci_sdram_scrub_rate_store(struct mem_ctl_info *mci,
 
 458                                         const char *data, size_t count)
 
 462         if (mci->set_sdram_scrub_rate) {
 
 464                 memctrl_int_store(&bandwidth, data, count);
 
 466                 if (!(*mci->set_sdram_scrub_rate) (mci, &bandwidth)) {
 
 467                         edac_printk(KERN_DEBUG, EDAC_MC,
 
 468                                 "Scrub rate set successfully, applied: %d\n",
 
 471                         /* FIXME: error codes maybe? */
 
 472                         edac_printk(KERN_DEBUG, EDAC_MC,
 
 473                                 "Scrub rate set FAILED, could not apply: %d\n",
 
 477                 /* FIXME: produce "not implemented" ERROR for user-side. */
 
 478                 edac_printk(KERN_WARNING, EDAC_MC,
 
 479                         "Memory scrubbing 'set'control is not implemented!\n");
 
 484 static ssize_t mci_sdram_scrub_rate_show(struct mem_ctl_info *mci, char *data)
 
 488         if (mci->get_sdram_scrub_rate) {
 
 489                 if (!(*mci->get_sdram_scrub_rate) (mci, &bandwidth)) {
 
 490                         edac_printk(KERN_DEBUG, EDAC_MC,
 
 491                                 "Scrub rate successfully, fetched: %d\n",
 
 494                         /* FIXME: error codes maybe? */
 
 495                         edac_printk(KERN_DEBUG, EDAC_MC,
 
 496                                 "Scrub rate fetch FAILED, got: %d\n",
 
 500                 /* FIXME: produce "not implemented" ERROR for user-side.  */
 
 501                 edac_printk(KERN_WARNING, EDAC_MC,
 
 502                         "Memory scrubbing 'get' control is not implemented\n");
 
 504         return sprintf(data, "%d\n", bandwidth);
 
 507 /* default attribute files for the MCI object */
 
 508 static ssize_t mci_ue_count_show(struct mem_ctl_info *mci, char *data)
 
 510         return sprintf(data, "%d\n", mci->ue_count);
 
 513 static ssize_t mci_ce_count_show(struct mem_ctl_info *mci, char *data)
 
 515         return sprintf(data, "%d\n", mci->ce_count);
 
 518 static ssize_t mci_ce_noinfo_show(struct mem_ctl_info *mci, char *data)
 
 520         return sprintf(data, "%d\n", mci->ce_noinfo_count);
 
 523 static ssize_t mci_ue_noinfo_show(struct mem_ctl_info *mci, char *data)
 
 525         return sprintf(data, "%d\n", mci->ue_noinfo_count);
 
 528 static ssize_t mci_seconds_show(struct mem_ctl_info *mci, char *data)
 
 530         return sprintf(data, "%ld\n", (jiffies - mci->start_time) / HZ);
 
 533 static ssize_t mci_ctl_name_show(struct mem_ctl_info *mci, char *data)
 
 535         return sprintf(data, "%s\n", mci->ctl_name);
 
 538 static ssize_t mci_size_mb_show(struct mem_ctl_info *mci, char *data)
 
 540         int total_pages, csrow_idx;
 
 542         for (total_pages = csrow_idx = 0; csrow_idx < mci->nr_csrows;
 
 544                 struct csrow_info *csrow = &mci->csrows[csrow_idx];
 
 546                 if (!csrow->nr_pages)
 
 549                 total_pages += csrow->nr_pages;
 
 552         return sprintf(data, "%u\n", PAGES_TO_MiB(total_pages));
 
 555 #define to_mci(k) container_of(k, struct mem_ctl_info, edac_mci_kobj)
 
 556 #define to_mcidev_attr(a) container_of(a,struct mcidev_sysfs_attribute,attr)
 
 558 /* MCI show/store functions for top most object */
 
 559 static ssize_t mcidev_show(struct kobject *kobj, struct attribute *attr,
 
 562         struct mem_ctl_info *mem_ctl_info = to_mci(kobj);
 
 563         struct mcidev_sysfs_attribute *mcidev_attr = to_mcidev_attr(attr);
 
 565         if (mcidev_attr->show)
 
 566                 return mcidev_attr->show(mem_ctl_info, buffer);
 
 571 static ssize_t mcidev_store(struct kobject *kobj, struct attribute *attr,
 
 572                         const char *buffer, size_t count)
 
 574         struct mem_ctl_info *mem_ctl_info = to_mci(kobj);
 
 575         struct mcidev_sysfs_attribute *mcidev_attr = to_mcidev_attr(attr);
 
 577         if (mcidev_attr->store)
 
 578                 return mcidev_attr->store(mem_ctl_info, buffer, count);
 
 583 /* Intermediate show/store table */
 
 584 static struct sysfs_ops mci_ops = {
 
 586         .store = mcidev_store
 
 589 #define MCIDEV_ATTR(_name,_mode,_show,_store)                   \
 
 590 static struct mcidev_sysfs_attribute mci_attr_##_name = {                       \
 
 591         .attr = {.name = __stringify(_name), .mode = _mode },   \
 
 596 /* default Control file */
 
 597 MCIDEV_ATTR(reset_counters, S_IWUSR, NULL, mci_reset_counters_store);
 
 599 /* default Attribute files */
 
 600 MCIDEV_ATTR(mc_name, S_IRUGO, mci_ctl_name_show, NULL);
 
 601 MCIDEV_ATTR(size_mb, S_IRUGO, mci_size_mb_show, NULL);
 
 602 MCIDEV_ATTR(seconds_since_reset, S_IRUGO, mci_seconds_show, NULL);
 
 603 MCIDEV_ATTR(ue_noinfo_count, S_IRUGO, mci_ue_noinfo_show, NULL);
 
 604 MCIDEV_ATTR(ce_noinfo_count, S_IRUGO, mci_ce_noinfo_show, NULL);
 
 605 MCIDEV_ATTR(ue_count, S_IRUGO, mci_ue_count_show, NULL);
 
 606 MCIDEV_ATTR(ce_count, S_IRUGO, mci_ce_count_show, NULL);
 
 608 /* memory scrubber attribute file */
 
 609 MCIDEV_ATTR(sdram_scrub_rate, S_IRUGO | S_IWUSR, mci_sdram_scrub_rate_show,
 
 610         mci_sdram_scrub_rate_store);
 
 612 static struct mcidev_sysfs_attribute *mci_attr[] = {
 
 613         &mci_attr_reset_counters,
 
 616         &mci_attr_seconds_since_reset,
 
 617         &mci_attr_ue_noinfo_count,
 
 618         &mci_attr_ce_noinfo_count,
 
 621         &mci_attr_sdram_scrub_rate,
 
 627  * Release of a MC controlling instance
 
 629  *      each MC control instance has the following resources upon entry:
 
 630  *              a) a ref count on the top memctl kobj
 
 631  *              b) a ref count on this module
 
 633  *      this function must decrement those ref counts and then
 
 634  *      issue a free on the instance's memory
 
 636 static void edac_mci_control_release(struct kobject *kobj)
 
 638         struct mem_ctl_info *mci;
 
 642         debugf0("%s() mci instance idx=%d releasing\n", __func__, mci->mc_idx);
 
 644         /* decrement the module ref count */
 
 645         module_put(mci->owner);
 
 647         /* free the mci instance memory here */
 
 651 static struct kobj_type ktype_mci = {
 
 652         .release = edac_mci_control_release,
 
 653         .sysfs_ops = &mci_ops,
 
 654         .default_attrs = (struct attribute **)mci_attr,
 
 657 /* show/store, tables, etc for the MC kset */
 
 660 struct memctrl_dev_attribute {
 
 661         struct attribute attr;
 
 663          ssize_t(*show) (void *, char *);
 
 664          ssize_t(*store) (void *, const char *, size_t);
 
 667 /* Set of show/store abstract level functions for memory control object */
 
 668 static ssize_t memctrl_dev_show(struct kobject *kobj,
 
 669                                 struct attribute *attr, char *buffer)
 
 671         struct memctrl_dev_attribute *memctrl_dev;
 
 672         memctrl_dev = (struct memctrl_dev_attribute *)attr;
 
 674         if (memctrl_dev->show)
 
 675                 return memctrl_dev->show(memctrl_dev->value, buffer);
 
 680 static ssize_t memctrl_dev_store(struct kobject *kobj, struct attribute *attr,
 
 681                                  const char *buffer, size_t count)
 
 683         struct memctrl_dev_attribute *memctrl_dev;
 
 684         memctrl_dev = (struct memctrl_dev_attribute *)attr;
 
 686         if (memctrl_dev->store)
 
 687                 return memctrl_dev->store(memctrl_dev->value, buffer, count);
 
 692 static struct sysfs_ops memctrlfs_ops = {
 
 693         .show = memctrl_dev_show,
 
 694         .store = memctrl_dev_store
 
 697 #define MEMCTRL_ATTR(_name, _mode, _show, _store)                       \
 
 698 static struct memctrl_dev_attribute attr_##_name = {                    \
 
 699         .attr = {.name = __stringify(_name), .mode = _mode },   \
 
 705 #define MEMCTRL_STRING_ATTR(_name, _data, _mode, _show, _store) \
 
 706 static struct memctrl_dev_attribute attr_##_name = {                    \
 
 707         .attr = {.name = __stringify(_name), .mode = _mode },   \
 
 713 /* csrow<id> control files */
 
 714 MEMCTRL_ATTR(edac_mc_panic_on_ue,
 
 715         S_IRUGO | S_IWUSR, memctrl_int_show, memctrl_int_store);
 
 717 MEMCTRL_ATTR(edac_mc_log_ue,
 
 718         S_IRUGO | S_IWUSR, memctrl_int_show, memctrl_int_store);
 
 720 MEMCTRL_ATTR(edac_mc_log_ce,
 
 721         S_IRUGO | S_IWUSR, memctrl_int_show, memctrl_int_store);
 
 723 MEMCTRL_ATTR(edac_mc_poll_msec,
 
 724         S_IRUGO | S_IWUSR, memctrl_int_show, poll_msec_int_store);
 
 726 /* Base Attributes of the memory ECC object */
 
 727 static struct memctrl_dev_attribute *memctrl_attr[] = {
 
 728         &attr_edac_mc_panic_on_ue,
 
 729         &attr_edac_mc_log_ue,
 
 730         &attr_edac_mc_log_ce,
 
 731         &attr_edac_mc_poll_msec,
 
 736 /* the ktype for the mc_kset internal kobj */
 
 737 static struct kobj_type ktype_mc_set_attribs = {
 
 738         .sysfs_ops = &memctrlfs_ops,
 
 739         .default_attrs = (struct attribute **)memctrl_attr,
 
 742 /* EDAC memory controller sysfs kset:
 
 743  *      /sys/devices/system/edac/mc
 
 745 static struct kset mc_kset = {
 
 746         .kobj = {.ktype = &ktype_mc_set_attribs },
 
 752  * edac_mc_register_sysfs_main_kobj
 
 754  *      setups and registers the main kobject for each mci
 
 756 int edac_mc_register_sysfs_main_kobj(struct mem_ctl_info *mci)
 
 758         struct kobject *kobj_mci;
 
 761         debugf1("%s()\n", __func__);
 
 763         kobj_mci = &mci->edac_mci_kobj;
 
 765         /* Init the mci's kobject */
 
 766         memset(kobj_mci, 0, sizeof(*kobj_mci));
 
 768         /* this instance become part of the mc_kset */
 
 769         kobj_mci->kset = &mc_kset;
 
 771         /* set the name of the mc<id> object */
 
 772         err = kobject_set_name(kobj_mci, "mc%d", mci->mc_idx);
 
 776         /* Record which module 'owns' this control structure
 
 777          * and bump the ref count of the module
 
 779         mci->owner = THIS_MODULE;
 
 781         /* bump ref count on this module */
 
 782         if (!try_module_get(mci->owner)) {
 
 787         /* register the mc<id> kobject to the mc_kset */
 
 788         err = kobject_register(kobj_mci);
 
 790                 debugf1("%s()Failed to register '.../edac/mc%d'\n",
 
 791                         __func__, mci->mc_idx);
 
 795         /* At this point, to 'free' the control struct,
 
 796          * edac_mc_unregister_sysfs_main_kobj() must be used
 
 799         debugf1("%s() Registered '.../edac/mc%d' kobject\n",
 
 800                 __func__, mci->mc_idx);
 
 804         /* Error exit stack */
 
 807         module_put(mci->owner);
 
 814  * edac_mc_register_sysfs_main_kobj
 
 816  *      tears down and the main mci kobject from the mc_kset
 
 818 void edac_mc_unregister_sysfs_main_kobj(struct mem_ctl_info *mci)
 
 820         /* delete the kobj from the mc_kset */
 
 821         kobject_unregister(&mci->edac_mci_kobj);
 
 824 #define EDAC_DEVICE_SYMLINK     "device"
 
 827  * edac_create_mci_instance_attributes
 
 828  *      create MC driver specific attributes at the topmost level
 
 829  *      directory of this mci instance.
 
 831 static int edac_create_mci_instance_attributes(struct mem_ctl_info *mci)
 
 834         struct mcidev_sysfs_attribute *sysfs_attrib;
 
 836         /* point to the start of the array and iterate over it
 
 837          * adding each attribute listed to this mci instance's kobject
 
 839         sysfs_attrib = mci->mc_driver_sysfs_attributes;
 
 841         while (sysfs_attrib && sysfs_attrib->attr.name) {
 
 842                 err = sysfs_create_file(&mci->edac_mci_kobj,
 
 843                                         (struct attribute*) sysfs_attrib);
 
 855  * edac_remove_mci_instance_attributes
 
 856  *      remove MC driver specific attributes at the topmost level
 
 857  *      directory of this mci instance.
 
 859 static void edac_remove_mci_instance_attributes(struct mem_ctl_info *mci)
 
 861         struct mcidev_sysfs_attribute *sysfs_attrib;
 
 863         /* point to the start of the array and iterate over it
 
 864          * adding each attribute listed to this mci instance's kobject
 
 866         sysfs_attrib = mci->mc_driver_sysfs_attributes;
 
 868         /* loop if there are attributes and until we hit a NULL entry */
 
 869         while (sysfs_attrib && sysfs_attrib->attr.name) {
 
 870                 sysfs_remove_file(&mci->edac_mci_kobj,
 
 871                                         (struct attribute *) sysfs_attrib);
 
 878  * Create a new Memory Controller kobject instance,
 
 879  *      mc<id> under the 'mc' directory
 
 885 int edac_create_sysfs_mci_device(struct mem_ctl_info *mci)
 
 889         struct csrow_info *csrow;
 
 890         struct kobject *kobj_mci = &mci->edac_mci_kobj;
 
 892         debugf0("%s() idx=%d\n", __func__, mci->mc_idx);
 
 894         /* create a symlink for the device */
 
 895         err = sysfs_create_link(kobj_mci, &mci->dev->kobj,
 
 896                                 EDAC_DEVICE_SYMLINK);
 
 898                 debugf1("%s() failure to create symlink\n", __func__);
 
 902         /* If the low level driver desires some attributes,
 
 903          * then create them now for the driver.
 
 905         if (mci->mc_driver_sysfs_attributes) {
 
 906                 err = edac_create_mci_instance_attributes(mci);
 
 908                         debugf1("%s() failure to create mci attributes\n",
 
 914         /* Make directories for each CSROW object under the mc<id> kobject
 
 916         for (i = 0; i < mci->nr_csrows; i++) {
 
 917                 csrow = &mci->csrows[i];
 
 919                 /* Only expose populated CSROWs */
 
 920                 if (csrow->nr_pages > 0) {
 
 921                         err = edac_create_csrow_object(mci, csrow, i);
 
 923                                 debugf1("%s() failure: create csrow %d obj\n",
 
 932         /* CSROW error: backout what has already been registered,  */
 
 934         for (i--; i >= 0; i--) {
 
 935                 if (csrow->nr_pages > 0) {
 
 936                         kobject_unregister(&mci->csrows[i].kobj);
 
 940         /* remove the mci instance's attributes, if any */
 
 941         edac_remove_mci_instance_attributes(mci);
 
 943         /* remove the symlink */
 
 944         sysfs_remove_link(kobj_mci, EDAC_DEVICE_SYMLINK);
 
 951  * remove a Memory Controller instance
 
 953 void edac_remove_sysfs_mci_device(struct mem_ctl_info *mci)
 
 957         debugf0("%s()\n", __func__);
 
 959         /* remove all csrow kobjects */
 
 960         for (i = 0; i < mci->nr_csrows; i++) {
 
 961                 if (mci->csrows[i].nr_pages > 0) {
 
 962                         debugf0("%s()  unreg csrow-%d\n", __func__, i);
 
 963                         kobject_unregister(&mci->csrows[i].kobj);
 
 967         debugf0("%s()  remove_link\n", __func__);
 
 969         /* remove the symlink */
 
 970         sysfs_remove_link(&mci->edac_mci_kobj, EDAC_DEVICE_SYMLINK);
 
 972         debugf0("%s()  remove_mci_instance\n", __func__);
 
 974         /* remove this mci instance's attribtes */
 
 975         edac_remove_mci_instance_attributes(mci);
 
 977         debugf0("%s()  unregister this mci kobj\n", __func__);
 
 979         /* unregister this instance's kobject */
 
 980         kobject_unregister(&mci->edac_mci_kobj);
 
 987  * edac_setup_sysfs_mc_kset(void)
 
 989  * Initialize the mc_kset for the 'mc' entry
 
 990  *      This requires creating the top 'mc' directory with a kset
 
 991  *      and its controls/attributes.
 
 993  *      To this 'mc' kset, instance 'mci' will be grouped as children.
 
 996  *         !0 FAILURE error code
 
 998 int edac_sysfs_setup_mc_kset(void)
 
1001         struct sysdev_class *edac_class;
 
1003         debugf1("%s()\n", __func__);
 
1005         /* get the /sys/devices/system/edac class reference */
 
1006         edac_class = edac_get_edac_class();
 
1007         if (edac_class == NULL) {
 
1008                 debugf1("%s() no edac_class error=%d\n", __func__, err);
 
1012         /* Init the MC's kobject */
 
1013         kobject_set_name(&mc_kset.kobj, "mc");
 
1014         mc_kset.kobj.parent = &edac_class->kset.kobj;
 
1016         /* register the mc_kset */
 
1017         err = kset_register(&mc_kset);
 
1019                 debugf1("%s() Failed to register '.../edac/mc'\n", __func__);
 
1023         debugf1("%s() Registered '.../edac/mc' kobject\n", __func__);
 
1028         /* error unwind stack */
 
1034  * edac_sysfs_teardown_mc_kset
 
1036  *      deconstruct the mc_ket for memory controllers
 
1038 void edac_sysfs_teardown_mc_kset(void)
 
1040         kset_unregister(&mc_kset);