Merge branch 'master' of git://git.kernel.org/pub/scm/linux/kernel/git/linville/wirel...
[linux-2.6/x86.git] / drivers / pci / pci-driver.c
blobc697f268085698bf886e7b3a358f5343b3ce5c71
1 /*
2 * drivers/pci/pci-driver.c
4 * (C) Copyright 2002-2004, 2007 Greg Kroah-Hartman <greg@kroah.com>
5 * (C) Copyright 2007 Novell Inc.
7 * Released under the GPL v2 only.
9 */
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 <linux/cpu.h>
20 #include "pci.h"
23 * Dynamic device IDs are disabled for !CONFIG_HOTPLUG
26 struct pci_dynid {
27 struct list_head node;
28 struct pci_device_id id;
31 #ifdef CONFIG_HOTPLUG
33 /**
34 * store_new_id - add a new PCI device ID to this driver and re-probe devices
35 * @driver: target device driver
36 * @buf: buffer for scanning device ID data
37 * @count: input size
39 * Adds a new dynamic pci device ID to this driver,
40 * and causes the driver to probe for all devices again.
42 static ssize_t
43 store_new_id(struct device_driver *driver, const char *buf, size_t count)
45 struct pci_dynid *dynid;
46 struct pci_driver *pdrv = to_pci_driver(driver);
47 const struct pci_device_id *ids = pdrv->id_table;
48 __u32 vendor, device, subvendor=PCI_ANY_ID,
49 subdevice=PCI_ANY_ID, class=0, class_mask=0;
50 unsigned long driver_data=0;
51 int fields=0;
52 int retval=0;
54 fields = sscanf(buf, "%x %x %x %x %x %x %lx",
55 &vendor, &device, &subvendor, &subdevice,
56 &class, &class_mask, &driver_data);
57 if (fields < 2)
58 return -EINVAL;
60 /* Only accept driver_data values that match an existing id_table
61 entry */
62 if (ids) {
63 retval = -EINVAL;
64 while (ids->vendor || ids->subvendor || ids->class_mask) {
65 if (driver_data == ids->driver_data) {
66 retval = 0;
67 break;
69 ids++;
71 if (retval) /* No match */
72 return retval;
75 dynid = kzalloc(sizeof(*dynid), GFP_KERNEL);
76 if (!dynid)
77 return -ENOMEM;
79 dynid->id.vendor = vendor;
80 dynid->id.device = device;
81 dynid->id.subvendor = subvendor;
82 dynid->id.subdevice = subdevice;
83 dynid->id.class = class;
84 dynid->id.class_mask = class_mask;
85 dynid->id.driver_data = driver_data;
87 spin_lock(&pdrv->dynids.lock);
88 list_add_tail(&dynid->node, &pdrv->dynids.list);
89 spin_unlock(&pdrv->dynids.lock);
91 if (get_driver(&pdrv->driver)) {
92 retval = driver_attach(&pdrv->driver);
93 put_driver(&pdrv->driver);
96 if (retval)
97 return retval;
98 return count;
100 static DRIVER_ATTR(new_id, S_IWUSR, NULL, store_new_id);
102 static void
103 pci_free_dynids(struct pci_driver *drv)
105 struct pci_dynid *dynid, *n;
107 spin_lock(&drv->dynids.lock);
108 list_for_each_entry_safe(dynid, n, &drv->dynids.list, node) {
109 list_del(&dynid->node);
110 kfree(dynid);
112 spin_unlock(&drv->dynids.lock);
115 static int
116 pci_create_newid_file(struct pci_driver *drv)
118 int error = 0;
119 if (drv->probe != NULL)
120 error = driver_create_file(&drv->driver, &driver_attr_new_id);
121 return error;
124 static void pci_remove_newid_file(struct pci_driver *drv)
126 driver_remove_file(&drv->driver, &driver_attr_new_id);
128 #else /* !CONFIG_HOTPLUG */
129 static inline void pci_free_dynids(struct pci_driver *drv) {}
130 static inline int pci_create_newid_file(struct pci_driver *drv)
132 return 0;
134 static inline void pci_remove_newid_file(struct pci_driver *drv) {}
135 #endif
138 * pci_match_id - See if a pci device matches a given pci_id table
139 * @ids: array of PCI device id structures to search in
140 * @dev: the PCI device structure to match against.
142 * Used by a driver to check whether a PCI device present in the
143 * system is in its list of supported devices. Returns the matching
144 * pci_device_id structure or %NULL if there is no match.
146 * Deprecated, don't use this as it will not catch any dynamic ids
147 * that a driver might want to check for.
149 const struct pci_device_id *pci_match_id(const struct pci_device_id *ids,
150 struct pci_dev *dev)
152 if (ids) {
153 while (ids->vendor || ids->subvendor || ids->class_mask) {
154 if (pci_match_one_device(ids, dev))
155 return ids;
156 ids++;
159 return NULL;
163 * pci_match_device - Tell if a PCI device structure has a matching PCI device id structure
164 * @drv: the PCI driver to match against
165 * @dev: the PCI device structure to match against
167 * Used by a driver to check whether a PCI device present in the
168 * system is in its list of supported devices. Returns the matching
169 * pci_device_id structure or %NULL if there is no match.
171 static const struct pci_device_id *pci_match_device(struct pci_driver *drv,
172 struct pci_dev *dev)
174 struct pci_dynid *dynid;
176 /* Look at the dynamic ids first, before the static ones */
177 spin_lock(&drv->dynids.lock);
178 list_for_each_entry(dynid, &drv->dynids.list, node) {
179 if (pci_match_one_device(&dynid->id, dev)) {
180 spin_unlock(&drv->dynids.lock);
181 return &dynid->id;
184 spin_unlock(&drv->dynids.lock);
186 return pci_match_id(drv->id_table, dev);
189 struct drv_dev_and_id {
190 struct pci_driver *drv;
191 struct pci_dev *dev;
192 const struct pci_device_id *id;
195 static long local_pci_probe(void *_ddi)
197 struct drv_dev_and_id *ddi = _ddi;
199 return ddi->drv->probe(ddi->dev, ddi->id);
202 static int pci_call_probe(struct pci_driver *drv, struct pci_dev *dev,
203 const struct pci_device_id *id)
205 int error, node;
206 struct drv_dev_and_id ddi = { drv, dev, id };
208 /* Execute driver initialization on node where the device's
209 bus is attached to. This way the driver likely allocates
210 its local memory on the right node without any need to
211 change it. */
212 node = dev_to_node(&dev->dev);
213 if (node >= 0) {
214 int cpu;
215 node_to_cpumask_ptr(nodecpumask, node);
217 get_online_cpus();
218 cpu = cpumask_any_and(nodecpumask, cpu_online_mask);
219 if (cpu < nr_cpu_ids)
220 error = work_on_cpu(cpu, local_pci_probe, &ddi);
221 else
222 error = local_pci_probe(&ddi);
223 put_online_cpus();
224 } else
225 error = local_pci_probe(&ddi);
226 return error;
230 * __pci_device_probe()
231 * @drv: driver to call to check if it wants the PCI device
232 * @pci_dev: PCI device being probed
234 * returns 0 on success, else error.
235 * side-effect: pci_dev->driver is set to drv when drv claims pci_dev.
237 static int
238 __pci_device_probe(struct pci_driver *drv, struct pci_dev *pci_dev)
240 const struct pci_device_id *id;
241 int error = 0;
243 if (!pci_dev->driver && drv->probe) {
244 error = -ENODEV;
246 id = pci_match_device(drv, pci_dev);
247 if (id)
248 error = pci_call_probe(drv, pci_dev, id);
249 if (error >= 0) {
250 pci_dev->driver = drv;
251 error = 0;
254 return error;
257 static int pci_device_probe(struct device * dev)
259 int error = 0;
260 struct pci_driver *drv;
261 struct pci_dev *pci_dev;
263 drv = to_pci_driver(dev->driver);
264 pci_dev = to_pci_dev(dev);
265 pci_dev_get(pci_dev);
266 error = __pci_device_probe(drv, pci_dev);
267 if (error)
268 pci_dev_put(pci_dev);
270 return error;
273 static int pci_device_remove(struct device * dev)
275 struct pci_dev * pci_dev = to_pci_dev(dev);
276 struct pci_driver * drv = pci_dev->driver;
278 if (drv) {
279 if (drv->remove)
280 drv->remove(pci_dev);
281 pci_dev->driver = NULL;
285 * If the device is still on, set the power state as "unknown",
286 * since it might change by the next time we load the driver.
288 if (pci_dev->current_state == PCI_D0)
289 pci_dev->current_state = PCI_UNKNOWN;
292 * We would love to complain here if pci_dev->is_enabled is set, that
293 * the driver should have called pci_disable_device(), but the
294 * unfortunate fact is there are too many odd BIOS and bridge setups
295 * that don't like drivers doing that all of the time.
296 * Oh well, we can dream of sane hardware when we sleep, no matter how
297 * horrible the crap we have to deal with is when we are awake...
300 pci_dev_put(pci_dev);
301 return 0;
304 static void pci_device_shutdown(struct device *dev)
306 struct pci_dev *pci_dev = to_pci_dev(dev);
307 struct pci_driver *drv = pci_dev->driver;
309 if (drv && drv->shutdown)
310 drv->shutdown(pci_dev);
311 pci_msi_shutdown(pci_dev);
312 pci_msix_shutdown(pci_dev);
315 #ifdef CONFIG_PM_SLEEP
318 * Default "suspend" method for devices that have no driver provided suspend,
319 * or not even a driver at all (second part).
321 static void pci_pm_set_unknown_state(struct pci_dev *pci_dev)
324 * mark its power state as "unknown", since we don't know if
325 * e.g. the BIOS will change its device state when we suspend.
327 if (pci_dev->current_state == PCI_D0)
328 pci_dev->current_state = PCI_UNKNOWN;
332 * Default "resume" method for devices that have no driver provided resume,
333 * or not even a driver at all (second part).
335 static int pci_pm_reenable_device(struct pci_dev *pci_dev)
337 int retval;
339 /* if the device was enabled before suspend, reenable */
340 retval = pci_reenable_device(pci_dev);
342 * if the device was busmaster before the suspend, make it busmaster
343 * again
345 if (pci_dev->is_busmaster)
346 pci_set_master(pci_dev);
348 return retval;
351 static int pci_legacy_suspend(struct device *dev, pm_message_t state)
353 struct pci_dev * pci_dev = to_pci_dev(dev);
354 struct pci_driver * drv = pci_dev->driver;
355 int i = 0;
357 if (drv && drv->suspend) {
358 i = drv->suspend(pci_dev, state);
359 suspend_report_result(drv->suspend, i);
360 } else {
361 pci_save_state(pci_dev);
363 * This is for compatibility with existing code with legacy PM
364 * support.
366 pci_pm_set_unknown_state(pci_dev);
369 pci_fixup_device(pci_fixup_suspend, pci_dev);
371 return i;
374 static int pci_legacy_suspend_late(struct device *dev, pm_message_t state)
376 struct pci_dev * pci_dev = to_pci_dev(dev);
377 struct pci_driver * drv = pci_dev->driver;
378 int i = 0;
380 if (drv && drv->suspend_late) {
381 i = drv->suspend_late(pci_dev, state);
382 suspend_report_result(drv->suspend_late, i);
384 return i;
387 static int pci_legacy_resume_early(struct device *dev)
389 int error = 0;
390 struct pci_dev * pci_dev = to_pci_dev(dev);
391 struct pci_driver * drv = pci_dev->driver;
393 pci_fixup_device(pci_fixup_resume_early, pci_dev);
395 if (drv && drv->resume_early)
396 error = drv->resume_early(pci_dev);
397 return error;
400 static int pci_legacy_resume(struct device *dev)
402 int error;
403 struct pci_dev * pci_dev = to_pci_dev(dev);
404 struct pci_driver * drv = pci_dev->driver;
406 pci_fixup_device(pci_fixup_resume, pci_dev);
408 if (drv && drv->resume) {
409 error = drv->resume(pci_dev);
410 } else {
411 /* restore the PCI config space */
412 pci_restore_state(pci_dev);
413 error = pci_pm_reenable_device(pci_dev);
415 return error;
418 /* Auxiliary functions used by the new power management framework */
420 static int pci_restore_standard_config(struct pci_dev *pci_dev)
422 struct pci_dev *parent = pci_dev->bus->self;
423 int error = 0;
425 /* Check if the device's bus is operational */
426 if (!parent || parent->current_state == PCI_D0) {
427 pci_restore_state(pci_dev);
428 pci_update_current_state(pci_dev, PCI_D0);
429 } else {
430 dev_warn(&pci_dev->dev, "unable to restore config, "
431 "bridge %s in low power state D%d\n", pci_name(parent),
432 parent->current_state);
433 pci_dev->current_state = PCI_UNKNOWN;
434 error = -EAGAIN;
437 return error;
440 static bool pci_is_bridge(struct pci_dev *pci_dev)
442 return !!(pci_dev->subordinate);
445 static void pci_pm_default_resume_noirq(struct pci_dev *pci_dev)
447 if (pci_restore_standard_config(pci_dev))
448 pci_fixup_device(pci_fixup_resume_early, pci_dev);
451 static int pci_pm_default_resume(struct pci_dev *pci_dev)
454 * pci_restore_standard_config() should have been called once already,
455 * but it would have failed if the device's parent bridge had not been
456 * in power state D0 at that time. Check it and try again if necessary.
458 if (pci_dev->current_state == PCI_UNKNOWN) {
459 int error = pci_restore_standard_config(pci_dev);
460 if (error)
461 return error;
464 pci_fixup_device(pci_fixup_resume, pci_dev);
466 if (!pci_is_bridge(pci_dev))
467 pci_enable_wake(pci_dev, PCI_D0, false);
469 return pci_pm_reenable_device(pci_dev);
472 static void pci_pm_default_suspend_generic(struct pci_dev *pci_dev)
474 /* If device is enabled at this point, disable it */
475 pci_disable_enabled_device(pci_dev);
477 * Save state with interrupts enabled, because in principle the bus the
478 * device is on may be put into a low power state after this code runs.
480 pci_save_state(pci_dev);
483 static void pci_pm_default_suspend(struct pci_dev *pci_dev)
485 pci_pm_default_suspend_generic(pci_dev);
487 if (!pci_is_bridge(pci_dev))
488 pci_prepare_to_sleep(pci_dev);
490 pci_fixup_device(pci_fixup_suspend, pci_dev);
493 static bool pci_has_legacy_pm_support(struct pci_dev *pci_dev)
495 struct pci_driver *drv = pci_dev->driver;
496 bool ret = drv && (drv->suspend || drv->suspend_late || drv->resume
497 || drv->resume_early);
500 * Legacy PM support is used by default, so warn if the new framework is
501 * supported as well. Drivers are supposed to support either the
502 * former, or the latter, but not both at the same time.
504 WARN_ON(ret && drv->driver.pm);
506 return ret;
509 /* New power management framework */
511 static int pci_pm_prepare(struct device *dev)
513 struct device_driver *drv = dev->driver;
514 int error = 0;
516 if (drv && drv->pm && drv->pm->prepare)
517 error = drv->pm->prepare(dev);
519 return error;
522 static void pci_pm_complete(struct device *dev)
524 struct device_driver *drv = dev->driver;
526 if (drv && drv->pm && drv->pm->complete)
527 drv->pm->complete(dev);
530 #ifdef CONFIG_SUSPEND
532 static int pci_pm_suspend(struct device *dev)
534 struct pci_dev *pci_dev = to_pci_dev(dev);
535 struct device_driver *drv = dev->driver;
536 int error = 0;
538 if (pci_has_legacy_pm_support(pci_dev))
539 return pci_legacy_suspend(dev, PMSG_SUSPEND);
541 if (drv && drv->pm && drv->pm->suspend) {
542 error = drv->pm->suspend(dev);
543 suspend_report_result(drv->pm->suspend, error);
546 if (!error)
547 pci_pm_default_suspend(pci_dev);
549 return error;
552 static int pci_pm_suspend_noirq(struct device *dev)
554 struct pci_dev *pci_dev = to_pci_dev(dev);
555 struct device_driver *drv = dev->driver;
556 int error = 0;
558 if (pci_has_legacy_pm_support(pci_dev))
559 return pci_legacy_suspend_late(dev, PMSG_SUSPEND);
561 if (drv && drv->pm && drv->pm->suspend_noirq) {
562 error = drv->pm->suspend_noirq(dev);
563 suspend_report_result(drv->pm->suspend_noirq, error);
566 if (!error)
567 pci_pm_set_unknown_state(pci_dev);
569 return error;
572 static int pci_pm_resume_noirq(struct device *dev)
574 struct pci_dev *pci_dev = to_pci_dev(dev);
575 struct device_driver *drv = dev->driver;
576 int error = 0;
578 if (pci_has_legacy_pm_support(pci_dev))
579 return pci_legacy_resume_early(dev);
581 pci_pm_default_resume_noirq(pci_dev);
583 if (drv && drv->pm && drv->pm->resume_noirq)
584 error = drv->pm->resume_noirq(dev);
586 return error;
589 static int pci_pm_resume(struct device *dev)
591 struct pci_dev *pci_dev = to_pci_dev(dev);
592 struct device_driver *drv = dev->driver;
593 int error = 0;
595 if (pci_has_legacy_pm_support(pci_dev))
596 return pci_legacy_resume(dev);
598 error = pci_pm_default_resume(pci_dev);
600 if (!error && drv && drv->pm && drv->pm->resume)
601 error = drv->pm->resume(dev);
603 return error;
606 #else /* !CONFIG_SUSPEND */
608 #define pci_pm_suspend NULL
609 #define pci_pm_suspend_noirq NULL
610 #define pci_pm_resume NULL
611 #define pci_pm_resume_noirq NULL
613 #endif /* !CONFIG_SUSPEND */
615 #ifdef CONFIG_HIBERNATION
617 static int pci_pm_freeze(struct device *dev)
619 struct pci_dev *pci_dev = to_pci_dev(dev);
620 struct device_driver *drv = dev->driver;
621 int error = 0;
623 if (pci_has_legacy_pm_support(pci_dev))
624 return pci_legacy_suspend(dev, PMSG_FREEZE);
626 if (drv && drv->pm && drv->pm->freeze) {
627 error = drv->pm->freeze(dev);
628 suspend_report_result(drv->pm->freeze, error);
631 if (!error)
632 pci_pm_default_suspend_generic(pci_dev);
634 return error;
637 static int pci_pm_freeze_noirq(struct device *dev)
639 struct pci_dev *pci_dev = to_pci_dev(dev);
640 struct device_driver *drv = dev->driver;
641 int error = 0;
643 if (pci_has_legacy_pm_support(pci_dev))
644 return pci_legacy_suspend_late(dev, PMSG_FREEZE);
646 if (drv && drv->pm && drv->pm->freeze_noirq) {
647 error = drv->pm->freeze_noirq(dev);
648 suspend_report_result(drv->pm->freeze_noirq, error);
651 if (!error)
652 pci_pm_set_unknown_state(pci_dev);
654 return error;
657 static int pci_pm_thaw_noirq(struct device *dev)
659 struct pci_dev *pci_dev = to_pci_dev(dev);
660 struct device_driver *drv = dev->driver;
661 int error = 0;
663 if (pci_has_legacy_pm_support(pci_dev))
664 return pci_legacy_resume_early(dev);
666 pci_update_current_state(pci_dev, PCI_D0);
668 if (drv && drv->pm && drv->pm->thaw_noirq)
669 error = drv->pm->thaw_noirq(dev);
671 return error;
674 static int pci_pm_thaw(struct device *dev)
676 struct pci_dev *pci_dev = to_pci_dev(dev);
677 struct device_driver *drv = dev->driver;
678 int error = 0;
680 if (pci_has_legacy_pm_support(pci_dev))
681 return pci_legacy_resume(dev);
683 pci_pm_reenable_device(pci_dev);
685 if (drv && drv->pm && drv->pm->thaw)
686 error = drv->pm->thaw(dev);
688 return error;
691 static int pci_pm_poweroff(struct device *dev)
693 struct pci_dev *pci_dev = to_pci_dev(dev);
694 struct device_driver *drv = dev->driver;
695 int error = 0;
697 if (pci_has_legacy_pm_support(pci_dev))
698 return pci_legacy_suspend(dev, PMSG_HIBERNATE);
700 if (drv && drv->pm && drv->pm->poweroff) {
701 error = drv->pm->poweroff(dev);
702 suspend_report_result(drv->pm->poweroff, error);
705 if (!error)
706 pci_pm_default_suspend(pci_dev);
708 return error;
711 static int pci_pm_poweroff_noirq(struct device *dev)
713 struct device_driver *drv = dev->driver;
714 int error = 0;
716 if (pci_has_legacy_pm_support(to_pci_dev(dev)))
717 return pci_legacy_suspend_late(dev, PMSG_HIBERNATE);
719 if (drv && drv->pm && drv->pm->poweroff_noirq) {
720 error = drv->pm->poweroff_noirq(dev);
721 suspend_report_result(drv->pm->poweroff_noirq, error);
724 return error;
727 static int pci_pm_restore_noirq(struct device *dev)
729 struct pci_dev *pci_dev = to_pci_dev(dev);
730 struct device_driver *drv = dev->driver;
731 int error = 0;
733 if (pci_has_legacy_pm_support(pci_dev))
734 return pci_legacy_resume_early(dev);
736 pci_pm_default_resume_noirq(pci_dev);
738 if (drv && drv->pm && drv->pm->restore_noirq)
739 error = drv->pm->restore_noirq(dev);
741 return error;
744 static int pci_pm_restore(struct device *dev)
746 struct pci_dev *pci_dev = to_pci_dev(dev);
747 struct device_driver *drv = dev->driver;
748 int error = 0;
750 if (pci_has_legacy_pm_support(pci_dev))
751 return pci_legacy_resume(dev);
753 error = pci_pm_default_resume(pci_dev);
755 if (!error && drv && drv->pm && drv->pm->restore)
756 error = drv->pm->restore(dev);
758 return error;
761 #else /* !CONFIG_HIBERNATION */
763 #define pci_pm_freeze NULL
764 #define pci_pm_freeze_noirq NULL
765 #define pci_pm_thaw NULL
766 #define pci_pm_thaw_noirq NULL
767 #define pci_pm_poweroff NULL
768 #define pci_pm_poweroff_noirq NULL
769 #define pci_pm_restore NULL
770 #define pci_pm_restore_noirq NULL
772 #endif /* !CONFIG_HIBERNATION */
774 struct dev_pm_ops pci_dev_pm_ops = {
775 .prepare = pci_pm_prepare,
776 .complete = pci_pm_complete,
777 .suspend = pci_pm_suspend,
778 .resume = pci_pm_resume,
779 .freeze = pci_pm_freeze,
780 .thaw = pci_pm_thaw,
781 .poweroff = pci_pm_poweroff,
782 .restore = pci_pm_restore,
783 .suspend_noirq = pci_pm_suspend_noirq,
784 .resume_noirq = pci_pm_resume_noirq,
785 .freeze_noirq = pci_pm_freeze_noirq,
786 .thaw_noirq = pci_pm_thaw_noirq,
787 .poweroff_noirq = pci_pm_poweroff_noirq,
788 .restore_noirq = pci_pm_restore_noirq,
791 #define PCI_PM_OPS_PTR (&pci_dev_pm_ops)
793 #else /* !CONFIG_PM_SLEEP */
795 #define PCI_PM_OPS_PTR NULL
797 #endif /* !CONFIG_PM_SLEEP */
800 * __pci_register_driver - register a new pci driver
801 * @drv: the driver structure to register
802 * @owner: owner module of drv
803 * @mod_name: module name string
805 * Adds the driver structure to the list of registered drivers.
806 * Returns a negative value on error, otherwise 0.
807 * If no error occurred, the driver remains registered even if
808 * no device was claimed during registration.
810 int __pci_register_driver(struct pci_driver *drv, struct module *owner,
811 const char *mod_name)
813 int error;
815 /* initialize common driver fields */
816 drv->driver.name = drv->name;
817 drv->driver.bus = &pci_bus_type;
818 drv->driver.owner = owner;
819 drv->driver.mod_name = mod_name;
821 spin_lock_init(&drv->dynids.lock);
822 INIT_LIST_HEAD(&drv->dynids.list);
824 /* register with core */
825 error = driver_register(&drv->driver);
826 if (error)
827 return error;
829 error = pci_create_newid_file(drv);
830 if (error)
831 driver_unregister(&drv->driver);
833 return error;
837 * pci_unregister_driver - unregister a pci driver
838 * @drv: the driver structure to unregister
840 * Deletes the driver structure from the list of registered PCI drivers,
841 * gives it a chance to clean up by calling its remove() function for
842 * each device it was responsible for, and marks those devices as
843 * driverless.
846 void
847 pci_unregister_driver(struct pci_driver *drv)
849 pci_remove_newid_file(drv);
850 driver_unregister(&drv->driver);
851 pci_free_dynids(drv);
854 static struct pci_driver pci_compat_driver = {
855 .name = "compat"
859 * pci_dev_driver - get the pci_driver of a device
860 * @dev: the device to query
862 * Returns the appropriate pci_driver structure or %NULL if there is no
863 * registered driver for the device.
865 struct pci_driver *
866 pci_dev_driver(const struct pci_dev *dev)
868 if (dev->driver)
869 return dev->driver;
870 else {
871 int i;
872 for(i=0; i<=PCI_ROM_RESOURCE; i++)
873 if (dev->resource[i].flags & IORESOURCE_BUSY)
874 return &pci_compat_driver;
876 return NULL;
880 * pci_bus_match - Tell if a PCI device structure has a matching PCI device id structure
881 * @dev: the PCI device structure to match against
882 * @drv: the device driver to search for matching PCI device id structures
884 * Used by a driver to check whether a PCI device present in the
885 * system is in its list of supported devices. Returns the matching
886 * pci_device_id structure or %NULL if there is no match.
888 static int pci_bus_match(struct device *dev, struct device_driver *drv)
890 struct pci_dev *pci_dev = to_pci_dev(dev);
891 struct pci_driver *pci_drv = to_pci_driver(drv);
892 const struct pci_device_id *found_id;
894 found_id = pci_match_device(pci_drv, pci_dev);
895 if (found_id)
896 return 1;
898 return 0;
902 * pci_dev_get - increments the reference count of the pci device structure
903 * @dev: the device being referenced
905 * Each live reference to a device should be refcounted.
907 * Drivers for PCI devices should normally record such references in
908 * their probe() methods, when they bind to a device, and release
909 * them by calling pci_dev_put(), in their disconnect() methods.
911 * A pointer to the device with the incremented reference counter is returned.
913 struct pci_dev *pci_dev_get(struct pci_dev *dev)
915 if (dev)
916 get_device(&dev->dev);
917 return dev;
921 * pci_dev_put - release a use of the pci device structure
922 * @dev: device that's been disconnected
924 * Must be called when a user of a device is finished with it. When the last
925 * user of the device calls this function, the memory of the device is freed.
927 void pci_dev_put(struct pci_dev *dev)
929 if (dev)
930 put_device(&dev->dev);
933 #ifndef CONFIG_HOTPLUG
934 int pci_uevent(struct device *dev, struct kobj_uevent_env *env)
936 return -ENODEV;
938 #endif
940 struct bus_type pci_bus_type = {
941 .name = "pci",
942 .match = pci_bus_match,
943 .uevent = pci_uevent,
944 .probe = pci_device_probe,
945 .remove = pci_device_remove,
946 .shutdown = pci_device_shutdown,
947 .dev_attrs = pci_dev_attrs,
948 .pm = PCI_PM_OPS_PTR,
951 static int __init pci_driver_init(void)
953 return bus_register(&pci_bus_type);
956 postcore_initcall(pci_driver_init);
958 EXPORT_SYMBOL(pci_match_id);
959 EXPORT_SYMBOL(__pci_register_driver);
960 EXPORT_SYMBOL(pci_unregister_driver);
961 EXPORT_SYMBOL(pci_dev_driver);
962 EXPORT_SYMBOL(pci_bus_type);
963 EXPORT_SYMBOL(pci_dev_get);
964 EXPORT_SYMBOL(pci_dev_put);