drivers/edac/edac_pci_sysfs.c

   1 /*
   2  * (C) 2005, 2006 Linux Networx (http://lnxi.com)
   3  * This file may be distributed under the terms of the
   4  * GNU General Public License.
   5  *
   6  * Written Doug Thompson <norsk5@xmission.com>
   7  *
   8  */
   9 #include <linux/module.h>
  10 #include <linux/sysdev.h>
  11 #include <linux/slab.h>
  12 #include <linux/ctype.h>
  13
  14 #include "edac_core.h"
  15 #include "edac_module.h"
  16
  17 /* Turn off this whole feature if PCI is not configured */
  18 #ifdef CONFIG_PCI
  19
  20 #define EDAC_PCI_SYMLINK        "device"
  21
  22 /* data variables exported via sysfs */
  23 static int check_pci_errors;            /* default NO check PCI parity */
  24 static int edac_pci_panic_on_pe;        /* default NO panic on PCI Parity */
  25 static int edac_pci_log_pe = 1;         /* log PCI parity errors */
  26 static int edac_pci_log_npe = 1;        /* log PCI non-parity error errors */
  27 static int edac_pci_poll_msec = 1000;   /* one second workq period */
  28
  29 static atomic_t pci_parity_count = ATOMIC_INIT(0);
  30 static atomic_t pci_nonparity_count = ATOMIC_INIT(0);
  31
  32 static struct kobject *edac_pci_top_main_kobj;
  33 static atomic_t edac_pci_sysfs_refcount = ATOMIC_INIT(0);
  34
  35 /* getter functions for the data variables */
  36 int edac_pci_get_check_errors(void)
  37 {
  38         return check_pci_errors;
  39 }
  40
  41 static int edac_pci_get_log_pe(void)
  42 {
  43         return edac_pci_log_pe;
  44 }
  45
  46 static int edac_pci_get_log_npe(void)
  47 {
  48         return edac_pci_log_npe;
  49 }
  50
  51 static int edac_pci_get_panic_on_pe(void)
  52 {
  53         return edac_pci_panic_on_pe;
  54 }
  55
  56 int edac_pci_get_poll_msec(void)
  57 {
  58         return edac_pci_poll_msec;
  59 }
  60
  61 /**************************** EDAC PCI sysfs instance *******************/
  62 static ssize_t instance_pe_count_show(struct edac_pci_ctl_info *pci, char *data)
  63 {
  64         return sprintf(data, "%u\n", atomic_read(&pci->counters.pe_count));
  65 }
  66
  67 static ssize_t instance_npe_count_show(struct edac_pci_ctl_info *pci,
  68                                 char *data)
  69 {
  70         return sprintf(data, "%u\n", atomic_read(&pci->counters.npe_count));
  71 }
  72
  73 #define to_instance(k) container_of(k, struct edac_pci_ctl_info, kobj)
  74 #define to_instance_attr(a) container_of(a, struct instance_attribute, attr)
  75
  76 /* DEVICE instance kobject release() function */
  77 static void edac_pci_instance_release(struct kobject *kobj)
  78 {
  79         struct edac_pci_ctl_info *pci;
  80
  81         debugf0("%s()\n", __func__);
  82
  83         /* Form pointer to containing struct, the pci control struct */
  84         pci = to_instance(kobj);
  85
  86         /* decrement reference count on top main kobj */
  87         kobject_put(edac_pci_top_main_kobj);
  88
  89         kfree(pci);     /* Free the control struct */
  90 }
  91
  92 /* instance specific attribute structure */
  93 struct instance_attribute {
  94         struct attribute attr;
  95         ssize_t(*show) (struct edac_pci_ctl_info *, char *);
  96         ssize_t(*store) (struct edac_pci_ctl_info *, const char *, size_t);
  97 };
  98
  99 /* Function to 'show' fields from the edac_pci 'instance' structure */
 100 static ssize_t edac_pci_instance_show(struct kobject *kobj,
 101                                 struct attribute *attr, char *buffer)
 102 {
 103         struct edac_pci_ctl_info *pci = to_instance(kobj);
 104         struct instance_attribute *instance_attr = to_instance_attr(attr);
 105
 106         if (instance_attr->show)
 107                 return instance_attr->show(pci, buffer);
 108         return -EIO;
 109 }
 110
 111 /* Function to 'store' fields into the edac_pci 'instance' structure */
 112 static ssize_t edac_pci_instance_store(struct kobject *kobj,
 113                                 struct attribute *attr,
 114                                 const char *buffer, size_t count)
 115 {
 116         struct edac_pci_ctl_info *pci = to_instance(kobj);
 117         struct instance_attribute *instance_attr = to_instance_attr(attr);
 118
 119         if (instance_attr->store)
 120                 return instance_attr->store(pci, buffer, count);
 121         return -EIO;
 122 }
 123
 124 /* fs_ops table */
 125 static const struct sysfs_ops pci_instance_ops = {
 126         .show = edac_pci_instance_show,
 127         .store = edac_pci_instance_store
 128 };
 129
 130 #define INSTANCE_ATTR(_name, _mode, _show, _store)      \
 131 static struct instance_attribute attr_instance_##_name = {      \
 132         .attr   = {.name = __stringify(_name), .mode = _mode }, \
 133         .show   = _show,                                        \
 134         .store  = _store,                                       \
 135 };
 136
 137 INSTANCE_ATTR(pe_count, S_IRUGO, instance_pe_count_show, NULL);
 138 INSTANCE_ATTR(npe_count, S_IRUGO, instance_npe_count_show, NULL);
 139
 140 /* pci instance attributes */
 141 static struct instance_attribute *pci_instance_attr[] = {
 142         &attr_instance_pe_count,
 143         &attr_instance_npe_count,
 144         NULL
 145 };
 146
 147 /* the ktype for a pci instance */
 148 static struct kobj_type ktype_pci_instance = {
 149         .release = edac_pci_instance_release,
 150         .sysfs_ops = &pci_instance_ops,
 151         .default_attrs = (struct attribute **)pci_instance_attr,
 152 };
 153
 154 /*
 155  * edac_pci_create_instance_kobj
 156  *
 157  *      construct one EDAC PCI instance's kobject for use
 158  */
 159 static int edac_pci_create_instance_kobj(struct edac_pci_ctl_info *pci, int idx)
 160 {
 161         struct kobject *main_kobj;
 162         int err;
 163
 164         debugf0("%s()\n", __func__);
 165
 166         /* First bump the ref count on the top main kobj, which will
 167          * track the number of PCI instances we have, and thus nest
 168          * properly on keeping the module loaded
 169          */
 170         main_kobj = kobject_get(edac_pci_top_main_kobj);
 171         if (!main_kobj) {
 172                 err = -ENODEV;
 173                 goto error_out;
 174         }
 175
 176         /* And now register this new kobject under the main kobj */
 177         err = kobject_init_and_add(&pci->kobj, &ktype_pci_instance,
 178                                    edac_pci_top_main_kobj, "pci%d", idx);
 179         if (err != 0) {
 180                 debugf2("%s() failed to register instance pci%d\n",
 181                         __func__, idx);
 182                 kobject_put(edac_pci_top_main_kobj);
 183                 goto error_out;
 184         }
 185
 186         kobject_uevent(&pci->kobj, KOBJ_ADD);
 187         debugf1("%s() Register instance 'pci%d' kobject\n", __func__, idx);
 188
 189         return 0;
 190
 191         /* Error unwind statck */
 192 error_out:
 193         return err;
 194 }
 195
 196 /*
 197  * edac_pci_unregister_sysfs_instance_kobj
 198  *
 199  *      unregister the kobj for the EDAC PCI instance
 200  */
 201 static void edac_pci_unregister_sysfs_instance_kobj(
 202                         struct edac_pci_ctl_info *pci)
 203 {
 204         debugf0("%s()\n", __func__);
 205
 206         /* Unregister the instance kobject and allow its release
 207          * function release the main reference count and then
 208          * kfree the memory
 209          */
 210         kobject_put(&pci->kobj);
 211 }
 212
 213 /***************************** EDAC PCI sysfs root **********************/
 214 #define to_edacpci(k) container_of(k, struct edac_pci_ctl_info, kobj)
 215 #define to_edacpci_attr(a) container_of(a, struct edac_pci_attr, attr)
 216
 217 /* simple show/store functions for attributes */
 218 static ssize_t edac_pci_int_show(void *ptr, char *buffer)
 219 {
 220         int *value = ptr;
 221         return sprintf(buffer, "%d\n", *value);
 222 }
 223
 224 static ssize_t edac_pci_int_store(void *ptr, const char *buffer, size_t count)
 225 {
 226         int *value = ptr;
 227
 228         if (isdigit(*buffer))
 229                 *value = simple_strtoul(buffer, NULL, 0);
 230
 231         return count;
 232 }
 233
 234 struct edac_pci_dev_attribute {
 235         struct attribute attr;
 236         void *value;
 237          ssize_t(*show) (void *, char *);
 238          ssize_t(*store) (void *, const char *, size_t);
 239 };
 240
 241 /* Set of show/store abstract level functions for PCI Parity object */
 242 static ssize_t edac_pci_dev_show(struct kobject *kobj, struct attribute *attr,
 243                                  char *buffer)
 244 {
 245         struct edac_pci_dev_attribute *edac_pci_dev;
 246         edac_pci_dev = (struct edac_pci_dev_attribute *)attr;
 247
 248         if (edac_pci_dev->show)
 249                 return edac_pci_dev->show(edac_pci_dev->value, buffer);
 250         return -EIO;
 251 }
 252
 253 static ssize_t edac_pci_dev_store(struct kobject *kobj,
 254                                 struct attribute *attr, const char *buffer,
 255                                 size_t count)
 256 {
 257         struct edac_pci_dev_attribute *edac_pci_dev;
 258         edac_pci_dev = (struct edac_pci_dev_attribute *)attr;
 259
 260         if (edac_pci_dev->show)
 261                 return edac_pci_dev->store(edac_pci_dev->value, buffer, count);
 262         return -EIO;
 263 }
 264
 265 static const struct sysfs_ops edac_pci_sysfs_ops = {
 266         .show = edac_pci_dev_show,
 267         .store = edac_pci_dev_store
 268 };
 269
 270 #define EDAC_PCI_ATTR(_name,_mode,_show,_store)                 \
 271 static struct edac_pci_dev_attribute edac_pci_attr_##_name = {          \
 272         .attr = {.name = __stringify(_name), .mode = _mode },   \
 273         .value  = &_name,                                       \
 274         .show   = _show,                                        \
 275         .store  = _store,                                       \
 276 };
 277
 278 #define EDAC_PCI_STRING_ATTR(_name,_data,_mode,_show,_store)    \
 279 static struct edac_pci_dev_attribute edac_pci_attr_##_name = {          \
 280         .attr = {.name = __stringify(_name), .mode = _mode },   \
 281         .value  = _data,                                        \
 282         .show   = _show,                                        \
 283         .store  = _store,                                       \
 284 };
 285
 286 /* PCI Parity control files */
 287 EDAC_PCI_ATTR(check_pci_errors, S_IRUGO | S_IWUSR, edac_pci_int_show,
 288         edac_pci_int_store);
 289 EDAC_PCI_ATTR(edac_pci_log_pe, S_IRUGO | S_IWUSR, edac_pci_int_show,
 290         edac_pci_int_store);
 291 EDAC_PCI_ATTR(edac_pci_log_npe, S_IRUGO | S_IWUSR, edac_pci_int_show,
 292         edac_pci_int_store);
 293 EDAC_PCI_ATTR(edac_pci_panic_on_pe, S_IRUGO | S_IWUSR, edac_pci_int_show,
 294         edac_pci_int_store);
 295 EDAC_PCI_ATTR(pci_parity_count, S_IRUGO, edac_pci_int_show, NULL);
 296 EDAC_PCI_ATTR(pci_nonparity_count, S_IRUGO, edac_pci_int_show, NULL);
 297
 298 /* Base Attributes of the memory ECC object */
 299 static struct edac_pci_dev_attribute *edac_pci_attr[] = {
 300         &edac_pci_attr_check_pci_errors,
 301         &edac_pci_attr_edac_pci_log_pe,
 302         &edac_pci_attr_edac_pci_log_npe,
 303         &edac_pci_attr_edac_pci_panic_on_pe,
 304         &edac_pci_attr_pci_parity_count,
 305         &edac_pci_attr_pci_nonparity_count,
 306         NULL,
 307 };
 308
 309 /*
 310  * edac_pci_release_main_kobj
 311  *
 312  *      This release function is called when the reference count to the
 313  *      passed kobj goes to zero.
 314  *
 315  *      This kobj is the 'main' kobject that EDAC PCI instances
 316  *      link to, and thus provide for proper nesting counts
 317  */
 318 static void edac_pci_release_main_kobj(struct kobject *kobj)
 319 {
 320         debugf0("%s() here to module_put(THIS_MODULE)\n", __func__);
 321
 322         kfree(kobj);
 323
 324         /* last reference to top EDAC PCI kobject has been removed,
 325          * NOW release our ref count on the core module
 326          */
 327         module_put(THIS_MODULE);
 328 }
 329
 330 /* ktype struct for the EDAC PCI main kobj */
 331 static struct kobj_type ktype_edac_pci_main_kobj = {
 332         .release = edac_pci_release_main_kobj,
 333         .sysfs_ops = &edac_pci_sysfs_ops,
 334         .default_attrs = (struct attribute **)edac_pci_attr,
 335 };
 336
 337 /**
 338  * edac_pci_main_kobj_setup()
 339  *
 340  *      setup the sysfs for EDAC PCI attributes
 341  *      assumes edac_class has already been initialized
 342  */
 343 static int edac_pci_main_kobj_setup(void)
 344 {
 345         int err;
 346         struct sysdev_class *edac_class;
 347
 348         debugf0("%s()\n", __func__);
 349
 350         /* check and count if we have already created the main kobject */
 351         if (atomic_inc_return(&edac_pci_sysfs_refcount) != 1)
 352                 return 0;
 353
 354         /* First time, so create the main kobject and its
 355          * controls and atributes
 356          */
 357         edac_class = edac_get_edac_class();
 358         if (edac_class == NULL) {
 359                 debugf1("%s() no edac_class\n", __func__);
 360                 err = -ENODEV;
 361                 goto decrement_count_fail;
 362         }
 363
 364         /* Bump the reference count on this module to ensure the
 365          * modules isn't unloaded until we deconstruct the top
 366          * level main kobj for EDAC PCI
 367          */
 368         if (!try_module_get(THIS_MODULE)) {
 369                 debugf1("%s() try_module_get() failed\n", __func__);
 370                 err = -ENODEV;
 371                 goto decrement_count_fail;
 372         }
 373
 374         edac_pci_top_main_kobj = kzalloc(sizeof(struct kobject), GFP_KERNEL);
 375         if (!edac_pci_top_main_kobj) {
 376                 debugf1("Failed to allocate\n");
 377                 err = -ENOMEM;
 378                 goto kzalloc_fail;
 379         }
 380
 381         /* Instanstiate the pci object */
 382         err = kobject_init_and_add(edac_pci_top_main_kobj,
 383                                    &ktype_edac_pci_main_kobj,
 384                                    &edac_class->kset.kobj, "pci");
 385         if (err) {
 386                 debugf1("Failed to register '.../edac/pci'\n");
 387                 goto kobject_init_and_add_fail;
 388         }
 389
 390         /* At this point, to 'release' the top level kobject
 391          * for EDAC PCI, then edac_pci_main_kobj_teardown()
 392          * must be used, for resources to be cleaned up properly
 393          */
 394         kobject_uevent(edac_pci_top_main_kobj, KOBJ_ADD);
 395         debugf1("Registered '.../edac/pci' kobject\n");
 396
 397         return 0;
 398
 399         /* Error unwind statck */
 400 kobject_init_and_add_fail:
 401         kfree(edac_pci_top_main_kobj);
 402
 403 kzalloc_fail:
 404         module_put(THIS_MODULE);
 405
 406 decrement_count_fail:
 407         /* if are on this error exit, nothing to tear down */
 408         atomic_dec(&edac_pci_sysfs_refcount);
 409
 410         return err;
 411 }
 412
 413 /*
 414  * edac_pci_main_kobj_teardown()
 415  *
 416  *      if no longer linked (needed) remove the top level EDAC PCI
 417  *      kobject with its controls and attributes
 418  */
 419 static void edac_pci_main_kobj_teardown(void)
 420 {
 421         debugf0("%s()\n", __func__);
 422
 423         /* Decrement the count and only if no more controller instances
 424          * are connected perform the unregisteration of the top level
 425          * main kobj
 426          */
 427         if (atomic_dec_return(&edac_pci_sysfs_refcount) == 0) {
 428                 debugf0("%s() called kobject_put on main kobj\n",
 429                         __func__);
 430                 kobject_put(edac_pci_top_main_kobj);
 431         }
 432 }
 433
 434 /*
 435  *
 436  * edac_pci_create_sysfs
 437  *
 438  *      Create the controls/attributes for the specified EDAC PCI device
 439  */
 440 int edac_pci_create_sysfs(struct edac_pci_ctl_info *pci)
 441 {
 442         int err;
 443         struct kobject *edac_kobj = &pci->kobj;
 444
 445         debugf0("%s() idx=%d\n", __func__, pci->pci_idx);
 446
 447         /* create the top main EDAC PCI kobject, IF needed */
 448         err = edac_pci_main_kobj_setup();
 449         if (err)
 450                 return err;
 451
 452         /* Create this instance's kobject under the MAIN kobject */
 453         err = edac_pci_create_instance_kobj(pci, pci->pci_idx);
 454         if (err)
 455                 goto unregister_cleanup;
 456
 457         err = sysfs_create_link(edac_kobj, &pci->dev->kobj, EDAC_PCI_SYMLINK);
 458         if (err) {
 459                 debugf0("%s() sysfs_create_link() returned err= %d\n",
 460                         __func__, err);
 461                 goto symlink_fail;
 462         }
 463
 464         return 0;
 465
 466         /* Error unwind stack */
 467 symlink_fail:
 468         edac_pci_unregister_sysfs_instance_kobj(pci);
 469
 470 unregister_cleanup:
 471         edac_pci_main_kobj_teardown();
 472
 473         return err;
 474 }
 475
 476 /*
 477  * edac_pci_remove_sysfs
 478  *
 479  *      remove the controls and attributes for this EDAC PCI device
 480  */
 481 void edac_pci_remove_sysfs(struct edac_pci_ctl_info *pci)
 482 {
 483         debugf0("%s() index=%d\n", __func__, pci->pci_idx);
 484
 485         /* Remove the symlink */
 486         sysfs_remove_link(&pci->kobj, EDAC_PCI_SYMLINK);
 487
 488         /* remove this PCI instance's sysfs entries */
 489         edac_pci_unregister_sysfs_instance_kobj(pci);
 490
 491         /* Call the main unregister function, which will determine
 492          * if this 'pci' is the last instance.
 493          * If it is, the main kobject will be unregistered as a result
 494          */
 495         debugf0("%s() calling edac_pci_main_kobj_teardown()\n", __func__);
 496         edac_pci_main_kobj_teardown();
 497 }
 498
 499 /************************ PCI error handling *************************/
 500 static u16 get_pci_parity_status(struct pci_dev *dev, int secondary)
 501 {
 502         int where;
 503         u16 status;
 504
 505         where = secondary ? PCI_SEC_STATUS : PCI_STATUS;
 506         pci_read_config_word(dev, where, &status);
 507
 508         /* If we get back 0xFFFF then we must suspect that the card has been
 509          * pulled but the Linux PCI layer has not yet finished cleaning up.
 510          * We don't want to report on such devices
 511          */
 512
 513         if (status == 0xFFFF) {
 514                 u32 sanity;
 515
 516                 pci_read_config_dword(dev, 0, &sanity);
 517
 518                 if (sanity == 0xFFFFFFFF)
 519                         return 0;
 520         }
 521
 522         status &= PCI_STATUS_DETECTED_PARITY | PCI_STATUS_SIG_SYSTEM_ERROR |
 523                 PCI_STATUS_PARITY;
 524
 525         if (status)
 526                 /* reset only the bits we are interested in */
 527                 pci_write_config_word(dev, where, status);
 528
 529         return status;
 530 }
 531
 532
 533 /* Clear any PCI parity errors logged by this device. */
 534 static void edac_pci_dev_parity_clear(struct pci_dev *dev)
 535 {
 536         u8 header_type;
 537
 538         get_pci_parity_status(dev, 0);
 539
 540         /* read the device TYPE, looking for bridges */
 541         pci_read_config_byte(dev, PCI_HEADER_TYPE, &header_type);
 542
 543         if ((header_type & 0x7F) == PCI_HEADER_TYPE_BRIDGE)
 544                 get_pci_parity_status(dev, 1);
 545 }
 546
 547 /*
 548  *  PCI Parity polling
 549  *
 550  *      Fucntion to retrieve the current parity status
 551  *      and decode it
 552  *
 553  */
 554 static void edac_pci_dev_parity_test(struct pci_dev *dev)
 555 {
 556         unsigned long flags;
 557         u16 status;
 558         u8 header_type;
 559
 560         /* stop any interrupts until we can acquire the status */
 561         local_irq_save(flags);
 562
 563         /* read the STATUS register on this device */
 564         status = get_pci_parity_status(dev, 0);
 565
 566         /* read the device TYPE, looking for bridges */
 567         pci_read_config_byte(dev, PCI_HEADER_TYPE, &header_type);
 568
 569         local_irq_restore(flags);
 570
 571         debugf4("PCI STATUS= 0x%04x %s\n", status, dev_name(&dev->dev));
 572
 573         /* check the status reg for errors on boards NOT marked as broken
 574          * if broken, we cannot trust any of the status bits
 575          */
 576         if (status && !dev->broken_parity_status) {
 577                 if (status & (PCI_STATUS_SIG_SYSTEM_ERROR)) {
 578                         edac_printk(KERN_CRIT, EDAC_PCI,
 579                                 "Signaled System Error on %s\n",
 580                                 pci_name(dev));
 581                         atomic_inc(&pci_nonparity_count);
 582                 }
 583
 584                 if (status & (PCI_STATUS_PARITY)) {
 585                         edac_printk(KERN_CRIT, EDAC_PCI,
 586                                 "Master Data Parity Error on %s\n",
 587                                 pci_name(dev));
 588
 589                         atomic_inc(&pci_parity_count);
 590                 }
 591
 592                 if (status & (PCI_STATUS_DETECTED_PARITY)) {
 593                         edac_printk(KERN_CRIT, EDAC_PCI,
 594                                 "Detected Parity Error on %s\n",
 595                                 pci_name(dev));
 596
 597                         atomic_inc(&pci_parity_count);
 598                 }
 599         }
 600
 601
 602         debugf4("PCI HEADER TYPE= 0x%02x %s\n", header_type, dev_name(&dev->dev));
 603
 604         if ((header_type & 0x7F) == PCI_HEADER_TYPE_BRIDGE) {
 605                 /* On bridges, need to examine secondary status register  */
 606                 status = get_pci_parity_status(dev, 1);
 607
 608                 debugf4("PCI SEC_STATUS= 0x%04x %s\n", status, dev_name(&dev->dev));
 609
 610                 /* check the secondary status reg for errors,
 611                  * on NOT broken boards
 612                  */
 613                 if (status && !dev->broken_parity_status) {
 614                         if (status & (PCI_STATUS_SIG_SYSTEM_ERROR)) {
 615                                 edac_printk(KERN_CRIT, EDAC_PCI, "Bridge "
 616                                         "Signaled System Error on %s\n",
 617                                         pci_name(dev));
 618                                 atomic_inc(&pci_nonparity_count);
 619                         }
 620
 621                         if (status & (PCI_STATUS_PARITY)) {
 622                                 edac_printk(KERN_CRIT, EDAC_PCI, "Bridge "
 623                                         "Master Data Parity Error on "
 624                                         "%s\n", pci_name(dev));
 625
 626                                 atomic_inc(&pci_parity_count);
 627                         }
 628
 629                         if (status & (PCI_STATUS_DETECTED_PARITY)) {
 630                                 edac_printk(KERN_CRIT, EDAC_PCI, "Bridge "
 631                                         "Detected Parity Error on %s\n",
 632                                         pci_name(dev));
 633
 634                                 atomic_inc(&pci_parity_count);
 635                         }
 636                 }
 637         }
 638 }
 639
 640 /* reduce some complexity in definition of the iterator */
 641 typedef void (*pci_parity_check_fn_t) (struct pci_dev *dev);
 642
 643 /*
 644  * pci_dev parity list iterator
 645  *      Scan the PCI device list for one pass, looking for SERRORs
 646  *      Master Parity ERRORS or Parity ERRORs on primary or secondary devices
 647  */
 648 static inline void edac_pci_dev_parity_iterator(pci_parity_check_fn_t fn)
 649 {
 650         struct pci_dev *dev = NULL;
 651
 652         /* request for kernel access to the next PCI device, if any,
 653          * and while we are looking at it have its reference count
 654          * bumped until we are done with it
 655          */
 656         while ((dev = pci_get_device(PCI_ANY_ID, PCI_ANY_ID, dev)) != NULL) {
 657                 fn(dev);
 658         }
 659 }
 660
 661 /*
 662  * edac_pci_do_parity_check
 663  *
 664  *      performs the actual PCI parity check operation
 665  */
 666 void edac_pci_do_parity_check(void)
 667 {
 668         int before_count;
 669
 670         debugf3("%s()\n", __func__);
 671
 672         /* if policy has PCI check off, leave now */
 673         if (!check_pci_errors)
 674                 return;
 675
 676         before_count = atomic_read(&pci_parity_count);
 677
 678         /* scan all PCI devices looking for a Parity Error on devices and
 679          * bridges.
 680          * The iterator calls pci_get_device() which might sleep, thus
 681          * we cannot disable interrupts in this scan.
 682          */
 683         edac_pci_dev_parity_iterator(edac_pci_dev_parity_test);
 684
 685         /* Only if operator has selected panic on PCI Error */
 686         if (edac_pci_get_panic_on_pe()) {
 687                 /* If the count is different 'after' from 'before' */
 688                 if (before_count != atomic_read(&pci_parity_count))
 689                         panic("EDAC: PCI Parity Error");
 690         }
 691 }
 692
 693 /*
 694  * edac_pci_clear_parity_errors
 695  *
 696  *      function to perform an iteration over the PCI devices
 697  *      and clearn their current status
 698  */
 699 void edac_pci_clear_parity_errors(void)
 700 {
 701         /* Clear any PCI bus parity errors that devices initially have logged
 702          * in their registers.
 703          */
 704         edac_pci_dev_parity_iterator(edac_pci_dev_parity_clear);
 705 }
 706
 707 /*
 708  * edac_pci_handle_pe
 709  *
 710  *      Called to handle a PARITY ERROR event
 711  */
 712 void edac_pci_handle_pe(struct edac_pci_ctl_info *pci, const char *msg)
 713 {
 714
 715         /* global PE counter incremented by edac_pci_do_parity_check() */
 716         atomic_inc(&pci->counters.pe_count);
 717
 718         if (edac_pci_get_log_pe())
 719                 edac_pci_printk(pci, KERN_WARNING,
 720                                 "Parity Error ctl: %s %d: %s\n",
 721                                 pci->ctl_name, pci->pci_idx, msg);
 722
 723         /*
 724          * poke all PCI devices and see which one is the troublemaker
 725          * panic() is called if set
 726          */
 727         edac_pci_do_parity_check();
 728 }
 729 EXPORT_SYMBOL_GPL(edac_pci_handle_pe);
 730
 731
 732 /*
 733  * edac_pci_handle_npe
 734  *
 735  *      Called to handle a NON-PARITY ERROR event
 736  */
 737 void edac_pci_handle_npe(struct edac_pci_ctl_info *pci, const char *msg)
 738 {
 739
 740         /* global NPE counter incremented by edac_pci_do_parity_check() */
 741         atomic_inc(&pci->counters.npe_count);
 742
 743         if (edac_pci_get_log_npe())
 744                 edac_pci_printk(pci, KERN_WARNING,
 745                                 "Non-Parity Error ctl: %s %d: %s\n",
 746                                 pci->ctl_name, pci->pci_idx, msg);
 747
 748         /*
 749          * poke all PCI devices and see which one is the troublemaker
 750          * panic() is called if set
 751          */
 752         edac_pci_do_parity_check();
 753 }
 754 EXPORT_SYMBOL_GPL(edac_pci_handle_npe);
 755
 756 /*
 757  * Define the PCI parameter to the module
 758  */
 759 module_param(check_pci_errors, int, 0644);
 760 MODULE_PARM_DESC(check_pci_errors,
 761                  "Check for PCI bus parity errors: 0=off 1=on");
 762 module_param(edac_pci_panic_on_pe, int, 0644);
 763 MODULE_PARM_DESC(edac_pci_panic_on_pe,
 764                  "Panic on PCI Bus Parity error: 0=off 1=on");
 765
 766 #endif                          /* CONFIG_PCI */