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 = {.name = "mc", .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 mc_kset.kobj.parent = &edac_class->kset.kobj;
1015 /* register the mc_kset */
1016 err = kset_register(&mc_kset);
1018 debugf1("%s() Failed to register '.../edac/mc'\n", __func__);
1022 debugf1("%s() Registered '.../edac/mc' kobject\n", __func__);
1027 /* error unwind stack */
1033 * edac_sysfs_teardown_mc_kset
1035 * deconstruct the mc_ket for memory controllers
1037 void edac_sysfs_teardown_mc_kset(void)
1039 kset_unregister(&mc_kset);