linux/drivers/edac/edac_mc_sysfs.c
<<
>>
Prefs
   1/*
   2 * edac_mc kernel module
   3 * (C) 2005-2007 Linux Networx (http://lnxi.com)
   4 *
   5 * This file may be distributed under the terms of the
   6 * GNU General Public License.
   7 *
   8 * Written Doug Thompson <norsk5@xmission.com> www.softwarebitmaker.com
   9 *
  10 */
  11
  12#include <linux/ctype.h>
  13#include <linux/bug.h>
  14
  15#include "edac_core.h"
  16#include "edac_module.h"
  17
  18
  19/* MC EDAC Controls, setable by module parameter, and sysfs */
  20static int edac_mc_log_ue = 1;
  21static int edac_mc_log_ce = 1;
  22static int edac_mc_panic_on_ue;
  23static int edac_mc_poll_msec = 1000;
  24
  25/* Getter functions for above */
  26int edac_mc_get_log_ue(void)
  27{
  28        return edac_mc_log_ue;
  29}
  30
  31int edac_mc_get_log_ce(void)
  32{
  33        return edac_mc_log_ce;
  34}
  35
  36int edac_mc_get_panic_on_ue(void)
  37{
  38        return edac_mc_panic_on_ue;
  39}
  40
  41/* this is temporary */
  42int edac_mc_get_poll_msec(void)
  43{
  44        return edac_mc_poll_msec;
  45}
  46
  47/* Parameter declarations for above */
  48module_param(edac_mc_panic_on_ue, int, 0644);
  49MODULE_PARM_DESC(edac_mc_panic_on_ue, "Panic on uncorrected error: 0=off 1=on");
  50module_param(edac_mc_log_ue, int, 0644);
  51MODULE_PARM_DESC(edac_mc_log_ue,
  52                 "Log uncorrectable error to console: 0=off 1=on");
  53module_param(edac_mc_log_ce, int, 0644);
  54MODULE_PARM_DESC(edac_mc_log_ce,
  55                 "Log correctable error to console: 0=off 1=on");
  56module_param(edac_mc_poll_msec, int, 0644);
  57MODULE_PARM_DESC(edac_mc_poll_msec, "Polling period in milliseconds");
  58
  59/*
  60 * various constants for Memory Controllers
  61 */
  62static const char *mem_types[] = {
  63        [MEM_EMPTY] = "Empty",
  64        [MEM_RESERVED] = "Reserved",
  65        [MEM_UNKNOWN] = "Unknown",
  66        [MEM_FPM] = "FPM",
  67        [MEM_EDO] = "EDO",
  68        [MEM_BEDO] = "BEDO",
  69        [MEM_SDR] = "Unbuffered-SDR",
  70        [MEM_RDR] = "Registered-SDR",
  71        [MEM_DDR] = "Unbuffered-DDR",
  72        [MEM_RDDR] = "Registered-DDR",
  73        [MEM_RMBS] = "RMBS",
  74        [MEM_DDR2] = "Unbuffered-DDR2",
  75        [MEM_FB_DDR2] = "FullyBuffered-DDR2",
  76        [MEM_RDDR2] = "Registered-DDR2"
  77};
  78
  79static const char *dev_types[] = {
  80        [DEV_UNKNOWN] = "Unknown",
  81        [DEV_X1] = "x1",
  82        [DEV_X2] = "x2",
  83        [DEV_X4] = "x4",
  84        [DEV_X8] = "x8",
  85        [DEV_X16] = "x16",
  86        [DEV_X32] = "x32",
  87        [DEV_X64] = "x64"
  88};
  89
  90static const char *edac_caps[] = {
  91        [EDAC_UNKNOWN] = "Unknown",
  92        [EDAC_NONE] = "None",
  93        [EDAC_RESERVED] = "Reserved",
  94        [EDAC_PARITY] = "PARITY",
  95        [EDAC_EC] = "EC",
  96        [EDAC_SECDED] = "SECDED",
  97        [EDAC_S2ECD2ED] = "S2ECD2ED",
  98        [EDAC_S4ECD4ED] = "S4ECD4ED",
  99        [EDAC_S8ECD8ED] = "S8ECD8ED",
 100        [EDAC_S16ECD16ED] = "S16ECD16ED"
 101};
 102
 103
 104
 105/*
 106 * /sys/devices/system/edac/mc;
 107 *      data structures and methods
 108 */
 109static ssize_t memctrl_int_show(void *ptr, char *buffer)
 110{
 111        int *value = (int *)ptr;
 112        return sprintf(buffer, "%u\n", *value);
 113}
 114
 115static ssize_t memctrl_int_store(void *ptr, const char *buffer, size_t count)
 116{
 117        int *value = (int *)ptr;
 118
 119        if (isdigit(*buffer))
 120                *value = simple_strtoul(buffer, NULL, 0);
 121
 122        return count;
 123}
 124
 125/*
 126 * mc poll_msec time value
 127 */
 128static ssize_t poll_msec_int_store(void *ptr, const char *buffer, size_t count)
 129{
 130        int *value = (int *)ptr;
 131
 132        if (isdigit(*buffer)) {
 133                *value = simple_strtoul(buffer, NULL, 0);
 134
 135                /* notify edac_mc engine to reset the poll period */
 136                edac_mc_reset_delay_period(*value);
 137        }
 138
 139        return count;
 140}
 141
 142
 143/* EDAC sysfs CSROW data structures and methods
 144 */
 145
 146/* Set of more default csrow<id> attribute show/store functions */
 147static ssize_t csrow_ue_count_show(struct csrow_info *csrow, char *data,
 148                                int private)
 149{
 150        return sprintf(data, "%u\n", csrow->ue_count);
 151}
 152
 153static ssize_t csrow_ce_count_show(struct csrow_info *csrow, char *data,
 154                                int private)
 155{
 156        return sprintf(data, "%u\n", csrow->ce_count);
 157}
 158
 159static ssize_t csrow_size_show(struct csrow_info *csrow, char *data,
 160                                int private)
 161{
 162        return sprintf(data, "%u\n", PAGES_TO_MiB(csrow->nr_pages));
 163}
 164
 165static ssize_t csrow_mem_type_show(struct csrow_info *csrow, char *data,
 166                                int private)
 167{
 168        return sprintf(data, "%s\n", mem_types[csrow->mtype]);
 169}
 170
 171static ssize_t csrow_dev_type_show(struct csrow_info *csrow, char *data,
 172                                int private)
 173{
 174        return sprintf(data, "%s\n", dev_types[csrow->dtype]);
 175}
 176
 177static ssize_t csrow_edac_mode_show(struct csrow_info *csrow, char *data,
 178                                int private)
 179{
 180        return sprintf(data, "%s\n", edac_caps[csrow->edac_mode]);
 181}
 182
 183/* show/store functions for DIMM Label attributes */
 184static ssize_t channel_dimm_label_show(struct csrow_info *csrow,
 185                                char *data, int channel)
 186{
 187        return snprintf(data, EDAC_MC_LABEL_LEN, "%s",
 188                        csrow->channels[channel].label);
 189}
 190
 191static ssize_t channel_dimm_label_store(struct csrow_info *csrow,
 192                                        const char *data,
 193                                        size_t count, int channel)
 194{
 195        ssize_t max_size = 0;
 196
 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';
 200
 201        return max_size;
 202}
 203
 204/* show function for dynamic chX_ce_count attribute */
 205static ssize_t channel_ce_count_show(struct csrow_info *csrow,
 206                                char *data, int channel)
 207{
 208        return sprintf(data, "%u\n", csrow->channels[channel].ce_count);
 209}
 210
 211/* csrow specific attribute structure */
 212struct 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);
 216        int private;
 217};
 218
 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)
 221
 222/* Set of show/store higher level functions for default csrow attributes */
 223static ssize_t csrowdev_show(struct kobject *kobj,
 224                        struct attribute *attr, char *buffer)
 225{
 226        struct csrow_info *csrow = to_csrow(kobj);
 227        struct csrowdev_attribute *csrowdev_attr = to_csrowdev_attr(attr);
 228
 229        if (csrowdev_attr->show)
 230                return csrowdev_attr->show(csrow,
 231                                        buffer, csrowdev_attr->private);
 232        return -EIO;
 233}
 234
 235static ssize_t csrowdev_store(struct kobject *kobj, struct attribute *attr,
 236                        const char *buffer, size_t count)
 237{
 238        struct csrow_info *csrow = to_csrow(kobj);
 239        struct csrowdev_attribute *csrowdev_attr = to_csrowdev_attr(attr);
 240
 241        if (csrowdev_attr->store)
 242                return csrowdev_attr->store(csrow,
 243                                        buffer,
 244                                        count, csrowdev_attr->private);
 245        return -EIO;
 246}
 247
 248static struct sysfs_ops csrowfs_ops = {
 249        .show = csrowdev_show,
 250        .store = csrowdev_store
 251};
 252
 253#define CSROWDEV_ATTR(_name,_mode,_show,_store,_private)        \
 254static struct csrowdev_attribute attr_##_name = {                       \
 255        .attr = {.name = __stringify(_name), .mode = _mode },   \
 256        .show   = _show,                                        \
 257        .store  = _store,                                       \
 258        .private = _private,                                    \
 259};
 260
 261/* default cwrow<id>/attribute files */
 262CSROWDEV_ATTR(size_mb, S_IRUGO, csrow_size_show, NULL, 0);
 263CSROWDEV_ATTR(dev_type, S_IRUGO, csrow_dev_type_show, NULL, 0);
 264CSROWDEV_ATTR(mem_type, S_IRUGO, csrow_mem_type_show, NULL, 0);
 265CSROWDEV_ATTR(edac_mode, S_IRUGO, csrow_edac_mode_show, NULL, 0);
 266CSROWDEV_ATTR(ue_count, S_IRUGO, csrow_ue_count_show, NULL, 0);
 267CSROWDEV_ATTR(ce_count, S_IRUGO, csrow_ce_count_show, NULL, 0);
 268
 269/* default attributes of the CSROW<id> object */
 270static struct csrowdev_attribute *default_csrow_attr[] = {
 271        &attr_dev_type,
 272        &attr_mem_type,
 273        &attr_edac_mode,
 274        &attr_size_mb,
 275        &attr_ue_count,
 276        &attr_ce_count,
 277        NULL,
 278};
 279
 280/* possible dynamic channel DIMM Label attribute files */
 281CSROWDEV_ATTR(ch0_dimm_label, S_IRUGO | S_IWUSR,
 282        channel_dimm_label_show, channel_dimm_label_store, 0);
 283CSROWDEV_ATTR(ch1_dimm_label, S_IRUGO | S_IWUSR,
 284        channel_dimm_label_show, channel_dimm_label_store, 1);
 285CSROWDEV_ATTR(ch2_dimm_label, S_IRUGO | S_IWUSR,
 286        channel_dimm_label_show, channel_dimm_label_store, 2);
 287CSROWDEV_ATTR(ch3_dimm_label, S_IRUGO | S_IWUSR,
 288        channel_dimm_label_show, channel_dimm_label_store, 3);
 289CSROWDEV_ATTR(ch4_dimm_label, S_IRUGO | S_IWUSR,
 290        channel_dimm_label_show, channel_dimm_label_store, 4);
 291CSROWDEV_ATTR(ch5_dimm_label, S_IRUGO | S_IWUSR,
 292        channel_dimm_label_show, channel_dimm_label_store, 5);
 293
 294/* Total possible dynamic DIMM Label attribute file table */
 295static 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,
 301        &attr_ch5_dimm_label
 302};
 303
 304/* possible dynamic channel ce_count attribute files */
 305CSROWDEV_ATTR(ch0_ce_count, S_IRUGO | S_IWUSR, channel_ce_count_show, NULL, 0);
 306CSROWDEV_ATTR(ch1_ce_count, S_IRUGO | S_IWUSR, channel_ce_count_show, NULL, 1);
 307CSROWDEV_ATTR(ch2_ce_count, S_IRUGO | S_IWUSR, channel_ce_count_show, NULL, 2);
 308CSROWDEV_ATTR(ch3_ce_count, S_IRUGO | S_IWUSR, channel_ce_count_show, NULL, 3);
 309CSROWDEV_ATTR(ch4_ce_count, S_IRUGO | S_IWUSR, channel_ce_count_show, NULL, 4);
 310CSROWDEV_ATTR(ch5_ce_count, S_IRUGO | S_IWUSR, channel_ce_count_show, NULL, 5);
 311
 312/* Total possible dynamic ce_count attribute file table */
 313static struct csrowdev_attribute *dynamic_csrow_ce_count_attr[] = {
 314        &attr_ch0_ce_count,
 315        &attr_ch1_ce_count,
 316        &attr_ch2_ce_count,
 317        &attr_ch3_ce_count,
 318        &attr_ch4_ce_count,
 319        &attr_ch5_ce_count
 320};
 321
 322#define EDAC_NR_CHANNELS        6
 323
 324/* Create dynamic CHANNEL files, indexed by 'chan',  under specifed CSROW */
 325static int edac_create_channel_files(struct kobject *kobj, int chan)
 326{
 327        int err = -ENODEV;
 328
 329        if (chan >= EDAC_NR_CHANNELS)
 330                return err;
 331
 332        /* create the DIMM label attribute file */
 333        err = sysfs_create_file(kobj,
 334                                (struct attribute *)
 335                                dynamic_csrow_dimm_attr[chan]);
 336
 337        if (!err) {
 338                /* create the CE Count attribute file */
 339                err = sysfs_create_file(kobj,
 340                                        (struct attribute *)
 341                                        dynamic_csrow_ce_count_attr[chan]);
 342        } else {
 343                debugf1("%s()  dimm labels and ce_count files created",
 344                        __func__);
 345        }
 346
 347        return err;
 348}
 349
 350/* No memory to release for this kobj */
 351static void edac_csrow_instance_release(struct kobject *kobj)
 352{
 353        struct mem_ctl_info *mci;
 354        struct csrow_info *cs;
 355
 356        debugf1("%s()\n", __func__);
 357
 358        cs = container_of(kobj, struct csrow_info, kobj);
 359        mci = cs->mci;
 360
 361        kobject_put(&mci->edac_mci_kobj);
 362}
 363
 364/* the kobj_type instance for a CSROW */
 365static struct kobj_type ktype_csrow = {
 366        .release = edac_csrow_instance_release,
 367        .sysfs_ops = &csrowfs_ops,
 368        .default_attrs = (struct attribute **)default_csrow_attr,
 369};
 370
 371/* Create a CSROW object under specifed edac_mc_device */
 372static int edac_create_csrow_object(struct mem_ctl_info *mci,
 373                                        struct csrow_info *csrow, int index)
 374{
 375        struct kobject *kobj_mci = &mci->edac_mci_kobj;
 376        struct kobject *kobj;
 377        int chan;
 378        int err;
 379
 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;
 385
 386        /* name this instance of csrow<id> */
 387        err = kobject_set_name(&csrow->kobj, "csrow%d", index);
 388        if (err)
 389                goto err_out;
 390
 391        /* bump the mci instance's kobject's ref count */
 392        kobj = kobject_get(&mci->edac_mci_kobj);
 393        if (!kobj) {
 394                err = -ENODEV;
 395                goto err_out;
 396        }
 397
 398        /* Instanstiate the csrow object */
 399        err = kobject_register(&csrow->kobj);
 400        if (err)
 401                goto err_release_top_kobj;
 402
 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
 406         */
 407
 408        /* Create the dyanmic attribute files on this csrow,
 409         * namely, the DIMM labels and the channel ce_count
 410         */
 411        for (chan = 0; chan < csrow->nr_channels; chan++) {
 412                err = edac_create_channel_files(&csrow->kobj, chan);
 413                if (err) {
 414                        /* special case the unregister here */
 415                        kobject_unregister(&csrow->kobj);
 416                        goto err_out;
 417                }
 418        }
 419
 420        return 0;
 421
 422        /* error unwind stack */
 423err_release_top_kobj:
 424        kobject_put(&mci->edac_mci_kobj);
 425
 426err_out:
 427        return err;
 428}
 429
 430/* default sysfs methods and data structures for the main MCI kobject */
 431
 432static ssize_t mci_reset_counters_store(struct mem_ctl_info *mci,
 433                                        const char *data, size_t count)
 434{
 435        int row, chan;
 436
 437        mci->ue_noinfo_count = 0;
 438        mci->ce_noinfo_count = 0;
 439        mci->ue_count = 0;
 440        mci->ce_count = 0;
 441
 442        for (row = 0; row < mci->nr_csrows; row++) {
 443                struct csrow_info *ri = &mci->csrows[row];
 444
 445                ri->ue_count = 0;
 446                ri->ce_count = 0;
 447
 448                for (chan = 0; chan < ri->nr_channels; chan++)
 449                        ri->channels[chan].ce_count = 0;
 450        }
 451
 452        mci->start_time = jiffies;
 453        return count;
 454}
 455
 456/* memory scrubbing */
 457static ssize_t mci_sdram_scrub_rate_store(struct mem_ctl_info *mci,
 458                                        const char *data, size_t count)
 459{
 460        u32 bandwidth = -1;
 461
 462        if (mci->set_sdram_scrub_rate) {
 463
 464                memctrl_int_store(&bandwidth, data, count);
 465
 466                if (!(*mci->set_sdram_scrub_rate) (mci, &bandwidth)) {
 467                        edac_printk(KERN_DEBUG, EDAC_MC,
 468                                "Scrub rate set successfully, applied: %d\n",
 469                                bandwidth);
 470                } else {
 471                        /* FIXME: error codes maybe? */
 472                        edac_printk(KERN_DEBUG, EDAC_MC,
 473                                "Scrub rate set FAILED, could not apply: %d\n",
 474                                bandwidth);
 475                }
 476        } else {
 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");
 480        }
 481        return count;
 482}
 483
 484static ssize_t mci_sdram_scrub_rate_show(struct mem_ctl_info *mci, char *data)
 485{
 486        u32 bandwidth = -1;
 487
 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",
 492                                bandwidth);
 493                } else {
 494                        /* FIXME: error codes maybe? */
 495                        edac_printk(KERN_DEBUG, EDAC_MC,
 496                                "Scrub rate fetch FAILED, got: %d\n",
 497                                bandwidth);
 498                }
 499        } else {
 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");
 503        }
 504        return sprintf(data, "%d\n", bandwidth);
 505}
 506
 507/* default attribute files for the MCI object */
 508static ssize_t mci_ue_count_show(struct mem_ctl_info *mci, char *data)
 509{
 510        return sprintf(data, "%d\n", mci->ue_count);
 511}
 512
 513static ssize_t mci_ce_count_show(struct mem_ctl_info *mci, char *data)
 514{
 515        return sprintf(data, "%d\n", mci->ce_count);
 516}
 517
 518static ssize_t mci_ce_noinfo_show(struct mem_ctl_info *mci, char *data)
 519{
 520        return sprintf(data, "%d\n", mci->ce_noinfo_count);
 521}
 522
 523static ssize_t mci_ue_noinfo_show(struct mem_ctl_info *mci, char *data)
 524{
 525        return sprintf(data, "%d\n", mci->ue_noinfo_count);
 526}
 527
 528static ssize_t mci_seconds_show(struct mem_ctl_info *mci, char *data)
 529{
 530        return sprintf(data, "%ld\n", (jiffies - mci->start_time) / HZ);
 531}
 532
 533static ssize_t mci_ctl_name_show(struct mem_ctl_info *mci, char *data)
 534{
 535        return sprintf(data, "%s\n", mci->ctl_name);
 536}
 537
 538static ssize_t mci_size_mb_show(struct mem_ctl_info *mci, char *data)
 539{
 540        int total_pages, csrow_idx;
 541
 542        for (total_pages = csrow_idx = 0; csrow_idx < mci->nr_csrows;
 543                csrow_idx++) {
 544                struct csrow_info *csrow = &mci->csrows[csrow_idx];
 545
 546                if (!csrow->nr_pages)
 547                        continue;
 548
 549                total_pages += csrow->nr_pages;
 550        }
 551
 552        return sprintf(data, "%u\n", PAGES_TO_MiB(total_pages));
 553}
 554
 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)
 557
 558/* MCI show/store functions for top most object */
 559static ssize_t mcidev_show(struct kobject *kobj, struct attribute *attr,
 560                        char *buffer)
 561{
 562        struct mem_ctl_info *mem_ctl_info = to_mci(kobj);
 563        struct mcidev_sysfs_attribute *mcidev_attr = to_mcidev_attr(attr);
 564
 565        if (mcidev_attr->show)
 566                return mcidev_attr->show(mem_ctl_info, buffer);
 567
 568        return -EIO;
 569}
 570
 571static ssize_t mcidev_store(struct kobject *kobj, struct attribute *attr,
 572                        const char *buffer, size_t count)
 573{
 574        struct mem_ctl_info *mem_ctl_info = to_mci(kobj);
 575        struct mcidev_sysfs_attribute *mcidev_attr = to_mcidev_attr(attr);
 576
 577        if (mcidev_attr->store)
 578                return mcidev_attr->store(mem_ctl_info, buffer, count);
 579
 580        return -EIO;
 581}
 582
 583/* Intermediate show/store table */
 584static struct sysfs_ops mci_ops = {
 585        .show = mcidev_show,
 586        .store = mcidev_store
 587};
 588
 589#define MCIDEV_ATTR(_name,_mode,_show,_store)                   \
 590static struct mcidev_sysfs_attribute mci_attr_##_name = {                       \
 591        .attr = {.name = __stringify(_name), .mode = _mode },   \
 592        .show   = _show,                                        \
 593        .store  = _store,                                       \
 594};
 595
 596/* default Control file */
 597MCIDEV_ATTR(reset_counters, S_IWUSR, NULL, mci_reset_counters_store);
 598
 599/* default Attribute files */
 600MCIDEV_ATTR(mc_name, S_IRUGO, mci_ctl_name_show, NULL);
 601MCIDEV_ATTR(size_mb, S_IRUGO, mci_size_mb_show, NULL);
 602MCIDEV_ATTR(seconds_since_reset, S_IRUGO, mci_seconds_show, NULL);
 603MCIDEV_ATTR(ue_noinfo_count, S_IRUGO, mci_ue_noinfo_show, NULL);
 604MCIDEV_ATTR(ce_noinfo_count, S_IRUGO, mci_ce_noinfo_show, NULL);
 605MCIDEV_ATTR(ue_count, S_IRUGO, mci_ue_count_show, NULL);
 606MCIDEV_ATTR(ce_count, S_IRUGO, mci_ce_count_show, NULL);
 607
 608/* memory scrubber attribute file */
 609MCIDEV_ATTR(sdram_scrub_rate, S_IRUGO | S_IWUSR, mci_sdram_scrub_rate_show,
 610        mci_sdram_scrub_rate_store);
 611
 612static struct mcidev_sysfs_attribute *mci_attr[] = {
 613        &mci_attr_reset_counters,
 614        &mci_attr_mc_name,
 615        &mci_attr_size_mb,
 616        &mci_attr_seconds_since_reset,
 617        &mci_attr_ue_noinfo_count,
 618        &mci_attr_ce_noinfo_count,
 619        &mci_attr_ue_count,
 620        &mci_attr_ce_count,
 621        &mci_attr_sdram_scrub_rate,
 622        NULL
 623};
 624
 625
 626/*
 627 * Release of a MC controlling instance
 628 *
 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
 632 *
 633 *      this function must decrement those ref counts and then
 634 *      issue a free on the instance's memory
 635 */
 636static void edac_mci_control_release(struct kobject *kobj)
 637{
 638        struct mem_ctl_info *mci;
 639
 640        mci = to_mci(kobj);
 641
 642        debugf0("%s() mci instance idx=%d releasing\n", __func__, mci->mc_idx);
 643
 644        /* decrement the module ref count */
 645        module_put(mci->owner);
 646
 647        /* free the mci instance memory here */
 648        kfree(mci);
 649}
 650
 651static struct kobj_type ktype_mci = {
 652        .release = edac_mci_control_release,
 653        .sysfs_ops = &mci_ops,
 654        .default_attrs = (struct attribute **)mci_attr,
 655};
 656
 657/* show/store, tables, etc for the MC kset */
 658
 659
 660struct memctrl_dev_attribute {
 661        struct attribute attr;
 662        void *value;
 663         ssize_t(*show) (void *, char *);
 664         ssize_t(*store) (void *, const char *, size_t);
 665};
 666
 667/* Set of show/store abstract level functions for memory control object */
 668static ssize_t memctrl_dev_show(struct kobject *kobj,
 669                                struct attribute *attr, char *buffer)
 670{
 671        struct memctrl_dev_attribute *memctrl_dev;
 672        memctrl_dev = (struct memctrl_dev_attribute *)attr;
 673
 674        if (memctrl_dev->show)
 675                return memctrl_dev->show(memctrl_dev->value, buffer);
 676
 677        return -EIO;
 678}
 679
 680static ssize_t memctrl_dev_store(struct kobject *kobj, struct attribute *attr,
 681                                 const char *buffer, size_t count)
 682{
 683        struct memctrl_dev_attribute *memctrl_dev;
 684        memctrl_dev = (struct memctrl_dev_attribute *)attr;
 685
 686        if (memctrl_dev->store)
 687                return memctrl_dev->store(memctrl_dev->value, buffer, count);
 688
 689        return -EIO;
 690}
 691
 692static struct sysfs_ops memctrlfs_ops = {
 693        .show = memctrl_dev_show,
 694        .store = memctrl_dev_store
 695};
 696
 697#define MEMCTRL_ATTR(_name, _mode, _show, _store)                       \
 698static struct memctrl_dev_attribute attr_##_name = {                    \
 699        .attr = {.name = __stringify(_name), .mode = _mode },   \
 700        .value  = &_name,                                       \
 701        .show   = _show,                                        \
 702        .store  = _store,                                       \
 703};
 704
 705#define MEMCTRL_STRING_ATTR(_name, _data, _mode, _show, _store) \
 706static struct memctrl_dev_attribute attr_##_name = {                    \
 707        .attr = {.name = __stringify(_name), .mode = _mode },   \
 708        .value  = _data,                                        \
 709        .show   = _show,                                        \
 710        .store  = _store,                                       \
 711};
 712
 713/* csrow<id> control files */
 714MEMCTRL_ATTR(edac_mc_panic_on_ue,
 715        S_IRUGO | S_IWUSR, memctrl_int_show, memctrl_int_store);
 716
 717MEMCTRL_ATTR(edac_mc_log_ue,
 718        S_IRUGO | S_IWUSR, memctrl_int_show, memctrl_int_store);
 719
 720MEMCTRL_ATTR(edac_mc_log_ce,
 721        S_IRUGO | S_IWUSR, memctrl_int_show, memctrl_int_store);
 722
 723MEMCTRL_ATTR(edac_mc_poll_msec,
 724        S_IRUGO | S_IWUSR, memctrl_int_show, poll_msec_int_store);
 725
 726/* Base Attributes of the memory ECC object */
 727static 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,
 732        NULL,
 733};
 734
 735
 736/* the ktype for the mc_kset internal kobj */
 737static struct kobj_type ktype_mc_set_attribs = {
 738        .sysfs_ops = &memctrlfs_ops,
 739        .default_attrs = (struct attribute **)memctrl_attr,
 740};
 741
 742/* EDAC memory controller sysfs kset:
 743 *      /sys/devices/system/edac/mc
 744 */
 745static struct kset mc_kset = {
 746        .kobj = {.ktype = &ktype_mc_set_attribs },
 747        .ktype = &ktype_mci,
 748};
 749
 750
 751/*
 752 * edac_mc_register_sysfs_main_kobj
 753 *
 754 *      setups and registers the main kobject for each mci
 755 */
 756int edac_mc_register_sysfs_main_kobj(struct mem_ctl_info *mci)
 757{
 758        struct kobject *kobj_mci;
 759        int err;
 760
 761        debugf1("%s()\n", __func__);
 762
 763        kobj_mci = &mci->edac_mci_kobj;
 764
 765        /* Init the mci's kobject */
 766        memset(kobj_mci, 0, sizeof(*kobj_mci));
 767
 768        /* this instance become part of the mc_kset */
 769        kobj_mci->kset = &mc_kset;
 770
 771        /* set the name of the mc<id> object */
 772        err = kobject_set_name(kobj_mci, "mc%d", mci->mc_idx);
 773        if (err)
 774                goto fail_out;
 775
 776        /* Record which module 'owns' this control structure
 777         * and bump the ref count of the module
 778         */
 779        mci->owner = THIS_MODULE;
 780
 781        /* bump ref count on this module */
 782        if (!try_module_get(mci->owner)) {
 783                err = -ENODEV;
 784                goto fail_out;
 785        }
 786
 787        /* register the mc<id> kobject to the mc_kset */
 788        err = kobject_register(kobj_mci);
 789        if (err) {
 790                debugf1("%s()Failed to register '.../edac/mc%d'\n",
 791                        __func__, mci->mc_idx);
 792                goto kobj_reg_fail;
 793        }
 794
 795        /* At this point, to 'free' the control struct,
 796         * edac_mc_unregister_sysfs_main_kobj() must be used
 797         */
 798
 799        debugf1("%s() Registered '.../edac/mc%d' kobject\n",
 800                __func__, mci->mc_idx);
 801
 802        return 0;
 803
 804        /* Error exit stack */
 805
 806kobj_reg_fail:
 807        module_put(mci->owner);
 808
 809fail_out:
 810        return err;
 811}
 812
 813/*
 814 * edac_mc_register_sysfs_main_kobj
 815 *
 816 *      tears down and the main mci kobject from the mc_kset
 817 */
 818void edac_mc_unregister_sysfs_main_kobj(struct mem_ctl_info *mci)
 819{
 820        /* delete the kobj from the mc_kset */
 821        kobject_unregister(&mci->edac_mci_kobj);
 822}
 823
 824#define EDAC_DEVICE_SYMLINK     "device"
 825
 826/*
 827 * edac_create_mci_instance_attributes
 828 *      create MC driver specific attributes at the topmost level
 829 *      directory of this mci instance.
 830 */
 831static int edac_create_mci_instance_attributes(struct mem_ctl_info *mci)
 832{
 833        int err;
 834        struct mcidev_sysfs_attribute *sysfs_attrib;
 835
 836        /* point to the start of the array and iterate over it
 837         * adding each attribute listed to this mci instance's kobject
 838         */
 839        sysfs_attrib = mci->mc_driver_sysfs_attributes;
 840
 841        while (sysfs_attrib && sysfs_attrib->attr.name) {
 842                err = sysfs_create_file(&mci->edac_mci_kobj,
 843                                        (struct attribute*) sysfs_attrib);
 844                if (err) {
 845                        return err;
 846                }
 847
 848                sysfs_attrib++;
 849        }
 850
 851        return 0;
 852}
 853
 854/*
 855 * edac_remove_mci_instance_attributes
 856 *      remove MC driver specific attributes at the topmost level
 857 *      directory of this mci instance.
 858 */
 859static void edac_remove_mci_instance_attributes(struct mem_ctl_info *mci)
 860{
 861        struct mcidev_sysfs_attribute *sysfs_attrib;
 862
 863        /* point to the start of the array and iterate over it
 864         * adding each attribute listed to this mci instance's kobject
 865         */
 866        sysfs_attrib = mci->mc_driver_sysfs_attributes;
 867
 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);
 872                sysfs_attrib++;
 873        }
 874}
 875
 876
 877/*
 878 * Create a new Memory Controller kobject instance,
 879 *      mc<id> under the 'mc' directory
 880 *
 881 * Return:
 882 *      0       Success
 883 *      !0      Failure
 884 */
 885int edac_create_sysfs_mci_device(struct mem_ctl_info *mci)
 886{
 887        int i;
 888        int err;
 889        struct csrow_info *csrow;
 890        struct kobject *kobj_mci = &mci->edac_mci_kobj;
 891
 892        debugf0("%s() idx=%d\n", __func__, mci->mc_idx);
 893
 894        /* create a symlink for the device */
 895        err = sysfs_create_link(kobj_mci, &mci->dev->kobj,
 896                                EDAC_DEVICE_SYMLINK);
 897        if (err) {
 898                debugf1("%s() failure to create symlink\n", __func__);
 899                goto fail0;
 900        }
 901
 902        /* If the low level driver desires some attributes,
 903         * then create them now for the driver.
 904         */
 905        if (mci->mc_driver_sysfs_attributes) {
 906                err = edac_create_mci_instance_attributes(mci);
 907                if (err) {
 908                        debugf1("%s() failure to create mci attributes\n",
 909                                __func__);
 910                        goto fail0;
 911                }
 912        }
 913
 914        /* Make directories for each CSROW object under the mc<id> kobject
 915         */
 916        for (i = 0; i < mci->nr_csrows; i++) {
 917                csrow = &mci->csrows[i];
 918
 919                /* Only expose populated CSROWs */
 920                if (csrow->nr_pages > 0) {
 921                        err = edac_create_csrow_object(mci, csrow, i);
 922                        if (err) {
 923                                debugf1("%s() failure: create csrow %d obj\n",
 924                                        __func__, i);
 925                                goto fail1;
 926                        }
 927                }
 928        }
 929
 930        return 0;
 931
 932        /* CSROW error: backout what has already been registered,  */
 933fail1:
 934        for (i--; i >= 0; i--) {
 935                if (csrow->nr_pages > 0) {
 936                        kobject_unregister(&mci->csrows[i].kobj);
 937                }
 938        }
 939
 940        /* remove the mci instance's attributes, if any */
 941        edac_remove_mci_instance_attributes(mci);
 942
 943        /* remove the symlink */
 944        sysfs_remove_link(kobj_mci, EDAC_DEVICE_SYMLINK);
 945
 946fail0:
 947        return err;
 948}
 949
 950/*
 951 * remove a Memory Controller instance
 952 */
 953void edac_remove_sysfs_mci_device(struct mem_ctl_info *mci)
 954{
 955        int i;
 956
 957        debugf0("%s()\n", __func__);
 958
 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);
 964                }
 965        }
 966
 967        debugf0("%s()  remove_link\n", __func__);
 968
 969        /* remove the symlink */
 970        sysfs_remove_link(&mci->edac_mci_kobj, EDAC_DEVICE_SYMLINK);
 971
 972        debugf0("%s()  remove_mci_instance\n", __func__);
 973
 974        /* remove this mci instance's attribtes */
 975        edac_remove_mci_instance_attributes(mci);
 976
 977        debugf0("%s()  unregister this mci kobj\n", __func__);
 978
 979        /* unregister this instance's kobject */
 980        kobject_unregister(&mci->edac_mci_kobj);
 981}
 982
 983
 984
 985
 986/*
 987 * edac_setup_sysfs_mc_kset(void)
 988 *
 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.
 992 *
 993 *      To this 'mc' kset, instance 'mci' will be grouped as children.
 994 *
 995 * Return:  0 SUCCESS
 996 *         !0 FAILURE error code
 997 */
 998int edac_sysfs_setup_mc_kset(void)
 999{
1000        int err = 0;
1001        struct sysdev_class *edac_class;
1002
1003        debugf1("%s()\n", __func__);
1004
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);
1009                goto fail_out;
1010        }
1011
1012        /* Init the MC's kobject */
1013        kobject_set_name(&mc_kset.kobj, "mc");
1014        mc_kset.kobj.parent = &edac_class->kset.kobj;
1015
1016        /* register the mc_kset */
1017        err = kset_register(&mc_kset);
1018        if (err) {
1019                debugf1("%s() Failed to register '.../edac/mc'\n", __func__);
1020                goto fail_out;
1021        }
1022
1023        debugf1("%s() Registered '.../edac/mc' kobject\n", __func__);
1024
1025        return 0;
1026
1027
1028        /* error unwind stack */
1029fail_out:
1030        return err;
1031}
1032
1033/*
1034 * edac_sysfs_teardown_mc_kset
1035 *
1036 *      deconstruct the mc_ket for memory controllers
1037 */
1038void edac_sysfs_teardown_mc_kset(void)
1039{
1040        kset_unregister(&mc_kset);
1041}
1042
1043
lxr.linux.no kindly hosted by Redpill Linpro AS, provider of Linux consulting and operations services since 1995.