drivers/pci/pci-driver.c

   1 /*
   2  * drivers/pci/pci-driver.c
   3  *
   4  * (C) Copyright 2002-2004, 2007 Greg Kroah-Hartman <greg@kroah.com>
   5  * (C) Copyright 2007 Novell Inc.
   6  *
   7  * Released under the GPL v2 only.
   8  *
   9  */
  10
  11 #include <linux/pci.h>
  12 #include <linux/module.h>
  13 #include <linux/init.h>
  14 #include <linux/device.h>
  15 #include <linux/mempolicy.h>
  16 #include <linux/string.h>
  17 #include <linux/slab.h>
  18 #include <linux/sched.h>
  19 #include "pci.h"
  20
  21 /*
  22  * Dynamic device IDs are disabled for !CONFIG_HOTPLUG
  23  */
  24
  25 struct pci_dynid {
  26         struct list_head node;
  27         struct pci_device_id id;
  28 };
  29
  30 #ifdef CONFIG_HOTPLUG
  31
  32 /**
  33  * store_new_id - add a new PCI device ID to this driver and re-probe devices
  34  * @driver: target device driver
  35  * @buf: buffer for scanning device ID data
  36  * @count: input size
  37  *
  38  * Adds a new dynamic pci device ID to this driver,
  39  * and causes the driver to probe for all devices again.
  40  */
  41 static ssize_t
  42 store_new_id(struct device_driver *driver, const char *buf, size_t count)
  43 {
  44         struct pci_dynid *dynid;
  45         struct pci_driver *pdrv = to_pci_driver(driver);
  46         __u32 vendor, device, subvendor=PCI_ANY_ID,
  47                 subdevice=PCI_ANY_ID, class=0, class_mask=0;
  48         unsigned long driver_data=0;
  49         int fields=0;
  50         int retval = 0;
  51
  52         fields = sscanf(buf, "%x %x %x %x %x %x %lux",
  53                         &vendor, &device, &subvendor, &subdevice,
  54                         &class, &class_mask, &driver_data);
  55         if (fields < 2)
  56                 return -EINVAL;
  57
  58         dynid = kzalloc(sizeof(*dynid), GFP_KERNEL);
  59         if (!dynid)
  60                 return -ENOMEM;
  61
  62         dynid->id.vendor = vendor;
  63         dynid->id.device = device;
  64         dynid->id.subvendor = subvendor;
  65         dynid->id.subdevice = subdevice;
  66         dynid->id.class = class;
  67         dynid->id.class_mask = class_mask;
  68         dynid->id.driver_data = pdrv->dynids.use_driver_data ?
  69                 driver_data : 0UL;
  70
  71         spin_lock(&pdrv->dynids.lock);
  72         list_add_tail(&dynid->node, &pdrv->dynids.list);
  73         spin_unlock(&pdrv->dynids.lock);
  74
  75         if (get_driver(&pdrv->driver)) {
  76                 retval = driver_attach(&pdrv->driver);
  77                 put_driver(&pdrv->driver);
  78         }
  79
  80         if (retval)
  81                 return retval;
  82         return count;
  83 }
  84 static DRIVER_ATTR(new_id, S_IWUSR, NULL, store_new_id);
  85
  86 static void
  87 pci_free_dynids(struct pci_driver *drv)
  88 {
  89         struct pci_dynid *dynid, *n;
  90
  91         spin_lock(&drv->dynids.lock);
  92         list_for_each_entry_safe(dynid, n, &drv->dynids.list, node) {
  93                 list_del(&dynid->node);
  94                 kfree(dynid);
  95         }
  96         spin_unlock(&drv->dynids.lock);
  97 }
  98
  99 static int
 100 pci_create_newid_file(struct pci_driver *drv)
 101 {
 102         int error = 0;
 103         if (drv->probe != NULL)
 104                 error = driver_create_file(&drv->driver, &driver_attr_new_id);
 105         return error;
 106 }
 107
 108 static void pci_remove_newid_file(struct pci_driver *drv)
 109 {
 110         driver_remove_file(&drv->driver, &driver_attr_new_id);
 111 }
 112 #else /* !CONFIG_HOTPLUG */
 113 static inline void pci_free_dynids(struct pci_driver *drv) {}
 114 static inline int pci_create_newid_file(struct pci_driver *drv)
 115 {
 116         return 0;
 117 }
 118 static inline void pci_remove_newid_file(struct pci_driver *drv) {}
 119 #endif
 120
 121 /**
 122  * pci_match_id - See if a pci device matches a given pci_id table
 123  * @ids: array of PCI device id structures to search in
 124  * @dev: the PCI device structure to match against.
 125  *
 126  * Used by a driver to check whether a PCI device present in the
 127  * system is in its list of supported devices.  Returns the matching
 128  * pci_device_id structure or %NULL if there is no match.
 129  *
 130  * Deprecated, don't use this as it will not catch any dynamic ids
 131  * that a driver might want to check for.
 132  */
 133 const struct pci_device_id *pci_match_id(const struct pci_device_id *ids,
 134                                          struct pci_dev *dev)
 135 {
 136         if (ids) {
 137                 while (ids->vendor || ids->subvendor || ids->class_mask) {
 138                         if (pci_match_one_device(ids, dev))
 139                                 return ids;
 140                         ids++;
 141                 }
 142         }
 143         return NULL;
 144 }
 145
 146 /**
 147  * pci_match_device - Tell if a PCI device structure has a matching PCI device id structure
 148  * @drv: the PCI driver to match against
 149  * @dev: the PCI device structure to match against
 150  *
 151  * Used by a driver to check whether a PCI device present in the
 152  * system is in its list of supported devices.  Returns the matching
 153  * pci_device_id structure or %NULL if there is no match.
 154  */
 155 static const struct pci_device_id *pci_match_device(struct pci_driver *drv,
 156                                                     struct pci_dev *dev)
 157 {
 158         struct pci_dynid *dynid;
 159
 160         /* Look at the dynamic ids first, before the static ones */
 161         spin_lock(&drv->dynids.lock);
 162         list_for_each_entry(dynid, &drv->dynids.list, node) {
 163                 if (pci_match_one_device(&dynid->id, dev)) {
 164                         spin_unlock(&drv->dynids.lock);
 165                         return &dynid->id;
 166                 }
 167         }
 168         spin_unlock(&drv->dynids.lock);
 169
 170         return pci_match_id(drv->id_table, dev);
 171 }
 172
 173 static int pci_call_probe(struct pci_driver *drv, struct pci_dev *dev,
 174                           const struct pci_device_id *id)
 175 {
 176         int error;
 177 #ifdef CONFIG_NUMA
 178         /* Execute driver initialization on node where the
 179            device's bus is attached to.  This way the driver likely
 180            allocates its local memory on the right node without
 181            any need to change it. */
 182         struct mempolicy *oldpol;
 183         cpumask_t oldmask = current->cpus_allowed;
 184         int node = dev_to_node(&dev->dev);
 185
 186         if (node >= 0) {
 187                 node_to_cpumask_ptr(nodecpumask, node);
 188                 set_cpus_allowed_ptr(current, nodecpumask);
 189         }
 190         /* And set default memory allocation policy */
 191         oldpol = current->mempolicy;
 192         current->mempolicy = NULL;      /* fall back to system default policy */
 193 #endif
 194         error = drv->probe(dev, id);
 195 #ifdef CONFIG_NUMA
 196         set_cpus_allowed_ptr(current, &oldmask);
 197         current->mempolicy = oldpol;
 198 #endif
 199         return error;
 200 }
 201
 202 /**
 203  * __pci_device_probe()
 204  * @drv: driver to call to check if it wants the PCI device
 205  * @pci_dev: PCI device being probed
 206  *
 207  * returns 0 on success, else error.
 208  * side-effect: pci_dev->driver is set to drv when drv claims pci_dev.
 209  */
 210 static int
 211 __pci_device_probe(struct pci_driver *drv, struct pci_dev *pci_dev)
 212 {
 213         const struct pci_device_id *id;
 214         int error = 0;
 215
 216         if (!pci_dev->driver && drv->probe) {
 217                 error = -ENODEV;
 218
 219                 id = pci_match_device(drv, pci_dev);
 220                 if (id)
 221                         error = pci_call_probe(drv, pci_dev, id);
 222                 if (error >= 0) {
 223                         pci_dev->driver = drv;
 224                         error = 0;
 225                 }
 226         }
 227         return error;
 228 }
 229
 230 static int pci_device_probe(struct device * dev)
 231 {
 232         int error = 0;
 233         struct pci_driver *drv;
 234         struct pci_dev *pci_dev;
 235
 236         drv = to_pci_driver(dev->driver);
 237         pci_dev = to_pci_dev(dev);
 238         pci_dev_get(pci_dev);
 239         error = __pci_device_probe(drv, pci_dev);
 240         if (error)
 241                 pci_dev_put(pci_dev);
 242
 243         return error;
 244 }
 245
 246 static int pci_device_remove(struct device * dev)
 247 {
 248         struct pci_dev * pci_dev = to_pci_dev(dev);
 249         struct pci_driver * drv = pci_dev->driver;
 250
 251         if (drv) {
 252                 if (drv->remove)
 253                         drv->remove(pci_dev);
 254                 pci_dev->driver = NULL;
 255         }
 256
 257         /*
 258          * If the device is still on, set the power state as "unknown",
 259          * since it might change by the next time we load the driver.
 260          */
 261         if (pci_dev->current_state == PCI_D0)
 262                 pci_dev->current_state = PCI_UNKNOWN;
 263
 264         /*
 265          * We would love to complain here if pci_dev->is_enabled is set, that
 266          * the driver should have called pci_disable_device(), but the
 267          * unfortunate fact is there are too many odd BIOS and bridge setups
 268          * that don't like drivers doing that all of the time.
 269          * Oh well, we can dream of sane hardware when we sleep, no matter how
 270          * horrible the crap we have to deal with is when we are awake...
 271          */
 272
 273         pci_dev_put(pci_dev);
 274         return 0;
 275 }
 276
 277 static void pci_device_shutdown(struct device *dev)
 278 {
 279         struct pci_dev *pci_dev = to_pci_dev(dev);
 280         struct pci_driver *drv = pci_dev->driver;
 281
 282         if (drv && drv->shutdown)
 283                 drv->shutdown(pci_dev);
 284         pci_msi_shutdown(pci_dev);
 285         pci_msix_shutdown(pci_dev);
 286 }
 287
 288 #ifdef CONFIG_PM_SLEEP
 289
 290 /*
 291  * Default "suspend" method for devices that have no driver provided suspend,
 292  * or not even a driver at all.
 293  */
 294 static void pci_default_pm_suspend(struct pci_dev *pci_dev)
 295 {
 296         pci_save_state(pci_dev);
 297         /*
 298          * mark its power state as "unknown", since we don't know if
 299          * e.g. the BIOS will change its device state when we suspend.
 300          */
 301         if (pci_dev->current_state == PCI_D0)
 302                 pci_dev->current_state = PCI_UNKNOWN;
 303 }
 304
 305 /*
 306  * Default "resume" method for devices that have no driver provided resume,
 307  * or not even a driver at all.
 308  */
 309 static int pci_default_pm_resume(struct pci_dev *pci_dev)
 310 {
 311         int retval = 0;
 312
 313         /* restore the PCI config space */
 314         pci_restore_state(pci_dev);
 315         /* if the device was enabled before suspend, reenable */
 316         retval = pci_reenable_device(pci_dev);
 317         /*
 318          * if the device was busmaster before the suspend, make it busmaster
 319          * again
 320          */
 321         if (pci_dev->is_busmaster)
 322                 pci_set_master(pci_dev);
 323
 324         return retval;
 325 }
 326
 327 static int pci_legacy_suspend(struct device *dev, pm_message_t state)
 328 {
 329         struct pci_dev * pci_dev = to_pci_dev(dev);
 330         struct pci_driver * drv = pci_dev->driver;
 331         int i = 0;
 332
 333         if (drv && drv->suspend) {
 334                 i = drv->suspend(pci_dev, state);
 335                 suspend_report_result(drv->suspend, i);
 336         } else {
 337                 pci_default_pm_suspend(pci_dev);
 338         }
 339         return i;
 340 }
 341
 342 static int pci_legacy_suspend_late(struct device *dev, pm_message_t state)
 343 {
 344         struct pci_dev * pci_dev = to_pci_dev(dev);
 345         struct pci_driver * drv = pci_dev->driver;
 346         int i = 0;
 347
 348         if (drv && drv->suspend_late) {
 349                 i = drv->suspend_late(pci_dev, state);
 350                 suspend_report_result(drv->suspend_late, i);
 351         }
 352         return i;
 353 }
 354
 355 static int pci_legacy_resume(struct device *dev)
 356 {
 357         int error;
 358         struct pci_dev * pci_dev = to_pci_dev(dev);
 359         struct pci_driver * drv = pci_dev->driver;
 360
 361         if (drv && drv->resume)
 362                 error = drv->resume(pci_dev);
 363         else
 364                 error = pci_default_pm_resume(pci_dev);
 365         return error;
 366 }
 367
 368 static int pci_legacy_resume_early(struct device *dev)
 369 {
 370         int error = 0;
 371         struct pci_dev * pci_dev = to_pci_dev(dev);
 372         struct pci_driver * drv = pci_dev->driver;
 373
 374         if (drv && drv->resume_early)
 375                 error = drv->resume_early(pci_dev);
 376         return error;
 377 }
 378
 379 static int pci_pm_prepare(struct device *dev)
 380 {
 381         struct device_driver *drv = dev->driver;
 382         int error = 0;
 383
 384         if (drv && drv->pm && drv->pm->prepare)
 385                 error = drv->pm->prepare(dev);
 386
 387         return error;
 388 }
 389
 390 static void pci_pm_complete(struct device *dev)
 391 {
 392         struct device_driver *drv = dev->driver;
 393
 394         if (drv && drv->pm && drv->pm->complete)
 395                 drv->pm->complete(dev);
 396 }
 397
 398 #ifdef CONFIG_SUSPEND
 399
 400 static int pci_pm_suspend(struct device *dev)
 401 {
 402         struct pci_dev *pci_dev = to_pci_dev(dev);
 403         struct device_driver *drv = dev->driver;
 404         int error = 0;
 405
 406         if (drv && drv->pm) {
 407                 if (drv->pm->suspend) {
 408                         error = drv->pm->suspend(dev);
 409                         suspend_report_result(drv->pm->suspend, error);
 410                 } else {
 411                         pci_default_pm_suspend(pci_dev);
 412                 }
 413         } else {
 414                 error = pci_legacy_suspend(dev, PMSG_SUSPEND);
 415         }
 416         pci_fixup_device(pci_fixup_suspend, pci_dev);
 417
 418         return error;
 419 }
 420
 421 static int pci_pm_suspend_noirq(struct device *dev)
 422 {
 423         struct pci_dev *pci_dev = to_pci_dev(dev);
 424         struct pci_driver *drv = pci_dev->driver;
 425         int error = 0;
 426
 427         if (drv && drv->pm) {
 428                 if (drv->pm->suspend_noirq) {
 429                         error = drv->pm->suspend_noirq(dev);
 430                         suspend_report_result(drv->pm->suspend_noirq, error);
 431                 }
 432         } else {
 433                 error = pci_legacy_suspend_late(dev, PMSG_SUSPEND);
 434         }
 435
 436         return error;
 437 }
 438
 439 static int pci_pm_resume(struct device *dev)
 440 {
 441         struct pci_dev *pci_dev = to_pci_dev(dev);
 442         struct device_driver *drv = dev->driver;
 443         int error;
 444
 445         pci_fixup_device(pci_fixup_resume, pci_dev);
 446
 447         if (drv && drv->pm) {
 448                 error = drv->pm->resume ? drv->pm->resume(dev) :
 449                         pci_default_pm_resume(pci_dev);
 450         } else {
 451                 error = pci_legacy_resume(dev);
 452         }
 453
 454         return error;
 455 }
 456
 457 static int pci_pm_resume_noirq(struct device *dev)
 458 {
 459         struct pci_dev *pci_dev = to_pci_dev(dev);
 460         struct pci_driver *drv = pci_dev->driver;
 461         int error = 0;
 462
 463         pci_fixup_device(pci_fixup_resume_early, pci_dev);
 464
 465         if (drv && drv->pm) {
 466                 if (drv->pm->resume_noirq)
 467                         error = drv->pm->resume_noirq(dev);
 468         } else {
 469                 error = pci_legacy_resume_early(dev);
 470         }
 471
 472         return error;
 473 }
 474
 475 #else /* !CONFIG_SUSPEND */
 476
 477 #define pci_pm_suspend          NULL
 478 #define pci_pm_suspend_noirq    NULL
 479 #define pci_pm_resume           NULL
 480 #define pci_pm_resume_noirq     NULL
 481
 482 #endif /* !CONFIG_SUSPEND */
 483
 484 #ifdef CONFIG_HIBERNATION
 485
 486 static int pci_pm_freeze(struct device *dev)
 487 {
 488         struct pci_dev *pci_dev = to_pci_dev(dev);
 489         struct device_driver *drv = dev->driver;
 490         int error = 0;
 491
 492         if (drv && drv->pm) {
 493                 if (drv->pm->freeze) {
 494                         error = drv->pm->freeze(dev);
 495                         suspend_report_result(drv->pm->freeze, error);
 496                 } else {
 497                         pci_default_pm_suspend(pci_dev);
 498                 }
 499         } else {
 500                 error = pci_legacy_suspend(dev, PMSG_FREEZE);
 501                 pci_fixup_device(pci_fixup_suspend, pci_dev);
 502         }
 503
 504         return error;
 505 }
 506
 507 static int pci_pm_freeze_noirq(struct device *dev)
 508 {
 509         struct pci_dev *pci_dev = to_pci_dev(dev);
 510         struct pci_driver *drv = pci_dev->driver;
 511         int error = 0;
 512
 513         if (drv && drv->pm) {
 514                 if (drv->pm->freeze_noirq) {
 515                         error = drv->pm->freeze_noirq(dev);
 516                         suspend_report_result(drv->pm->freeze_noirq, error);
 517                 }
 518         } else {
 519                 error = pci_legacy_suspend_late(dev, PMSG_FREEZE);
 520         }
 521
 522         return error;
 523 }
 524
 525 static int pci_pm_thaw(struct device *dev)
 526 {
 527         struct device_driver *drv = dev->driver;
 528         int error = 0;
 529
 530         if (drv && drv->pm) {
 531                 if (drv->pm->thaw)
 532                         error =  drv->pm->thaw(dev);
 533         } else {
 534                 pci_fixup_device(pci_fixup_resume, to_pci_dev(dev));
 535                 error = pci_legacy_resume(dev);
 536         }
 537
 538         return error;
 539 }
 540
 541 static int pci_pm_thaw_noirq(struct device *dev)
 542 {
 543         struct pci_dev *pci_dev = to_pci_dev(dev);
 544         struct pci_driver *drv = pci_dev->driver;
 545         int error = 0;
 546
 547         if (drv && drv->pm) {
 548                 if (drv->pm->thaw_noirq)
 549                         error = drv->pm->thaw_noirq(dev);
 550         } else {
 551                 pci_fixup_device(pci_fixup_resume_early, pci_dev);
 552                 error = pci_legacy_resume_early(dev);
 553         }
 554
 555         return error;
 556 }
 557
 558 static int pci_pm_poweroff(struct device *dev)
 559 {
 560         struct device_driver *drv = dev->driver;
 561         int error = 0;
 562
 563         pci_fixup_device(pci_fixup_suspend, to_pci_dev(dev));
 564
 565         if (drv && drv->pm) {
 566                 if (drv->pm->poweroff) {
 567                         error = drv->pm->poweroff(dev);
 568                         suspend_report_result(drv->pm->poweroff, error);
 569                 }
 570         } else {
 571                 error = pci_legacy_suspend(dev, PMSG_HIBERNATE);
 572         }
 573
 574         return error;
 575 }
 576
 577 static int pci_pm_poweroff_noirq(struct device *dev)
 578 {
 579         struct pci_dev *pci_dev = to_pci_dev(dev);
 580         struct pci_driver *drv = pci_dev->driver;
 581         int error = 0;
 582
 583         if (drv && drv->pm) {
 584                 if (drv->pm->poweroff_noirq) {
 585                         error = drv->pm->poweroff_noirq(dev);
 586                         suspend_report_result(drv->pm->poweroff_noirq, error);
 587                 }
 588         } else {
 589                 error = pci_legacy_suspend_late(dev, PMSG_HIBERNATE);
 590         }
 591
 592         return error;
 593 }
 594
 595 static int pci_pm_restore(struct device *dev)
 596 {
 597         struct pci_dev *pci_dev = to_pci_dev(dev);
 598         struct device_driver *drv = dev->driver;
 599         int error;
 600
 601         if (drv && drv->pm) {
 602                 error = drv->pm->restore ? drv->pm->restore(dev) :
 603                         pci_default_pm_resume(pci_dev);
 604         } else {
 605                 error = pci_legacy_resume(dev);
 606         }
 607         pci_fixup_device(pci_fixup_resume, pci_dev);
 608
 609         return error;
 610 }
 611
 612 static int pci_pm_restore_noirq(struct device *dev)
 613 {
 614         struct pci_dev *pci_dev = to_pci_dev(dev);
 615         struct pci_driver *drv = pci_dev->driver;
 616         int error = 0;
 617
 618         pci_fixup_device(pci_fixup_resume, pci_dev);
 619
 620         if (drv && drv->pm) {
 621                 if (drv->pm->restore_noirq)
 622                         error = drv->pm->restore_noirq(dev);
 623         } else {
 624                 error = pci_legacy_resume_early(dev);
 625         }
 626         pci_fixup_device(pci_fixup_resume_early, pci_dev);
 627
 628         return error;
 629 }
 630
 631 #else /* !CONFIG_HIBERNATION */
 632
 633 #define pci_pm_freeze           NULL
 634 #define pci_pm_freeze_noirq     NULL
 635 #define pci_pm_thaw             NULL
 636 #define pci_pm_thaw_noirq       NULL
 637 #define pci_pm_poweroff         NULL
 638 #define pci_pm_poweroff_noirq   NULL
 639 #define pci_pm_restore          NULL
 640 #define pci_pm_restore_noirq    NULL
 641
 642 #endif /* !CONFIG_HIBERNATION */
 643
 644 struct pm_ext_ops pci_pm_ops = {
 645         .base = {
 646                 .prepare = pci_pm_prepare,
 647                 .complete = pci_pm_complete,
 648                 .suspend = pci_pm_suspend,
 649                 .resume = pci_pm_resume,
 650                 .freeze = pci_pm_freeze,
 651                 .thaw = pci_pm_thaw,
 652                 .poweroff = pci_pm_poweroff,
 653                 .restore = pci_pm_restore,
 654         },
 655         .suspend_noirq = pci_pm_suspend_noirq,
 656         .resume_noirq = pci_pm_resume_noirq,
 657         .freeze_noirq = pci_pm_freeze_noirq,
 658         .thaw_noirq = pci_pm_thaw_noirq,
 659         .poweroff_noirq = pci_pm_poweroff_noirq,
 660         .restore_noirq = pci_pm_restore_noirq,
 661 };
 662
 663 #define PCI_PM_OPS_PTR  &pci_pm_ops
 664
 665 #else /* !CONFIG_PM_SLEEP */
 666
 667 #define PCI_PM_OPS_PTR  NULL
 668
 669 #endif /* !CONFIG_PM_SLEEP */
 670
 671 /**
 672  * __pci_register_driver - register a new pci driver
 673  * @drv: the driver structure to register
 674  * @owner: owner module of drv
 675  * @mod_name: module name string
 676  *
 677  * Adds the driver structure to the list of registered drivers.
 678  * Returns a negative value on error, otherwise 0.
 679  * If no error occurred, the driver remains registered even if
 680  * no device was claimed during registration.
 681  */
 682 int __pci_register_driver(struct pci_driver *drv, struct module *owner,
 683                           const char *mod_name)
 684 {
 685         int error;
 686
 687         /* initialize common driver fields */
 688         drv->driver.name = drv->name;
 689         drv->driver.bus = &pci_bus_type;
 690         drv->driver.owner = owner;
 691         drv->driver.mod_name = mod_name;
 692
 693         if (drv->pm)
 694                 drv->driver.pm = &drv->pm->base;
 695
 696         spin_lock_init(&drv->dynids.lock);
 697         INIT_LIST_HEAD(&drv->dynids.list);
 698
 699         /* register with core */
 700         error = driver_register(&drv->driver);
 701         if (error)
 702                 return error;
 703
 704         error = pci_create_newid_file(drv);
 705         if (error)
 706                 driver_unregister(&drv->driver);
 707
 708         return error;
 709 }
 710
 711 /**
 712  * pci_unregister_driver - unregister a pci driver
 713  * @drv: the driver structure to unregister
 714  *
 715  * Deletes the driver structure from the list of registered PCI drivers,
 716  * gives it a chance to clean up by calling its remove() function for
 717  * each device it was responsible for, and marks those devices as
 718  * driverless.
 719  */
 720
 721 void
 722 pci_unregister_driver(struct pci_driver *drv)
 723 {
 724         pci_remove_newid_file(drv);
 725         driver_unregister(&drv->driver);
 726         pci_free_dynids(drv);
 727 }
 728
 729 static struct pci_driver pci_compat_driver = {
 730         .name = "compat"
 731 };
 732
 733 /**
 734  * pci_dev_driver - get the pci_driver of a device
 735  * @dev: the device to query
 736  *
 737  * Returns the appropriate pci_driver structure or %NULL if there is no
 738  * registered driver for the device.
 739  */
 740 struct pci_driver *
 741 pci_dev_driver(const struct pci_dev *dev)
 742 {
 743         if (dev->driver)
 744                 return dev->driver;
 745         else {
 746                 int i;
 747                 for(i=0; i<=PCI_ROM_RESOURCE; i++)
 748                         if (dev->resource[i].flags & IORESOURCE_BUSY)
 749                                 return &pci_compat_driver;
 750         }
 751         return NULL;
 752 }
 753
 754 /**
 755  * pci_bus_match - Tell if a PCI device structure has a matching PCI device id structure
 756  * @dev: the PCI device structure to match against
 757  * @drv: the device driver to search for matching PCI device id structures
 758  *
 759  * Used by a driver to check whether a PCI device present in the
 760  * system is in its list of supported devices. Returns the matching
 761  * pci_device_id structure or %NULL if there is no match.
 762  */
 763 static int pci_bus_match(struct device *dev, struct device_driver *drv)
 764 {
 765         struct pci_dev *pci_dev = to_pci_dev(dev);
 766         struct pci_driver *pci_drv = to_pci_driver(drv);
 767         const struct pci_device_id *found_id;
 768
 769         found_id = pci_match_device(pci_drv, pci_dev);
 770         if (found_id)
 771                 return 1;
 772
 773         return 0;
 774 }
 775
 776 /**
 777  * pci_dev_get - increments the reference count of the pci device structure
 778  * @dev: the device being referenced
 779  *
 780  * Each live reference to a device should be refcounted.
 781  *
 782  * Drivers for PCI devices should normally record such references in
 783  * their probe() methods, when they bind to a device, and release
 784  * them by calling pci_dev_put(), in their disconnect() methods.
 785  *
 786  * A pointer to the device with the incremented reference counter is returned.
 787  */
 788 struct pci_dev *pci_dev_get(struct pci_dev *dev)
 789 {
 790         if (dev)
 791                 get_device(&dev->dev);
 792         return dev;
 793 }
 794
 795 /**
 796  * pci_dev_put - release a use of the pci device structure
 797  * @dev: device that's been disconnected
 798  *
 799  * Must be called when a user of a device is finished with it.  When the last
 800  * user of the device calls this function, the memory of the device is freed.
 801  */
 802 void pci_dev_put(struct pci_dev *dev)
 803 {
 804         if (dev)
 805                 put_device(&dev->dev);
 806 }
 807
 808 #ifndef CONFIG_HOTPLUG
 809 int pci_uevent(struct device *dev, struct kobj_uevent_env *env)
 810 {
 811         return -ENODEV;
 812 }
 813 #endif
 814
 815 struct bus_type pci_bus_type = {
 816         .name           = "pci",
 817         .match          = pci_bus_match,
 818         .uevent         = pci_uevent,
 819         .probe          = pci_device_probe,
 820         .remove         = pci_device_remove,
 821         .shutdown       = pci_device_shutdown,
 822         .dev_attrs      = pci_dev_attrs,
 823         .pm             = PCI_PM_OPS_PTR,
 824 };
 825
 826 static int __init pci_driver_init(void)
 827 {
 828         return bus_register(&pci_bus_type);
 829 }
 830
 831 postcore_initcall(pci_driver_init);
 832
 833 EXPORT_SYMBOL(pci_match_id);
 834 EXPORT_SYMBOL(__pci_register_driver);
 835 EXPORT_SYMBOL(pci_unregister_driver);
 836 EXPORT_SYMBOL(pci_dev_driver);
 837 EXPORT_SYMBOL(pci_bus_type);
 838 EXPORT_SYMBOL(pci_dev_get);
 839 EXPORT_SYMBOL(pci_dev_put);