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.
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>
23 * Dynamic device IDs are disabled for !CONFIG_HOTPLUG
27 struct list_head node
;
28 struct pci_device_id id
;
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
39 * Adds a new dynamic pci device ID to this driver,
40 * and causes the driver to probe for all devices again.
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;
54 fields
= sscanf(buf
, "%x %x %x %x %x %x %lx",
55 &vendor
, &device
, &subvendor
, &subdevice
,
56 &class, &class_mask
, &driver_data
);
60 /* Only accept driver_data values that match an existing id_table
64 while (ids
->vendor
|| ids
->subvendor
|| ids
->class_mask
) {
65 if (driver_data
== ids
->driver_data
) {
71 if (retval
) /* No match */
75 dynid
= kzalloc(sizeof(*dynid
), GFP_KERNEL
);
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
);
100 static DRIVER_ATTR(new_id
, S_IWUSR
, NULL
, store_new_id
);
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
);
112 spin_unlock(&drv
->dynids
.lock
);
116 pci_create_newid_file(struct pci_driver
*drv
)
119 if (drv
->probe
!= NULL
)
120 error
= driver_create_file(&drv
->driver
, &driver_attr_new_id
);
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
)
134 static inline void pci_remove_newid_file(struct pci_driver
*drv
) {}
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
,
153 while (ids
->vendor
|| ids
->subvendor
|| ids
->class_mask
) {
154 if (pci_match_one_device(ids
, dev
))
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
,
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
);
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
;
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
)
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
212 node
= dev_to_node(&dev
->dev
);
215 node_to_cpumask_ptr(nodecpumask
, node
);
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
);
222 error
= local_pci_probe(&ddi
);
225 error
= local_pci_probe(&ddi
);
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.
238 __pci_device_probe(struct pci_driver
*drv
, struct pci_dev
*pci_dev
)
240 const struct pci_device_id
*id
;
243 if (!pci_dev
->driver
&& drv
->probe
) {
246 id
= pci_match_device(drv
, pci_dev
);
248 error
= pci_call_probe(drv
, pci_dev
, id
);
250 pci_dev
->driver
= drv
;
257 static int pci_device_probe(struct device
* dev
)
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
);
268 pci_dev_put(pci_dev
);
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
;
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
);
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
)
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
345 if (pci_dev
->is_busmaster
)
346 pci_set_master(pci_dev
);
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
;
357 if (drv
&& drv
->suspend
) {
358 pci_dev
->state_saved
= false;
360 i
= drv
->suspend(pci_dev
, state
);
361 suspend_report_result(drv
->suspend
, i
);
365 if (pci_dev
->state_saved
)
368 if (WARN_ON_ONCE(pci_dev
->current_state
!= PCI_D0
))
372 pci_save_state(pci_dev
);
373 pci_dev
->state_saved
= true;
375 * This is for compatibility with existing code with legacy PM support.
377 pci_pm_set_unknown_state(pci_dev
);
380 pci_fixup_device(pci_fixup_suspend
, pci_dev
);
385 static int pci_legacy_suspend_late(struct device
*dev
, pm_message_t state
)
387 struct pci_dev
* pci_dev
= to_pci_dev(dev
);
388 struct pci_driver
* drv
= pci_dev
->driver
;
391 if (drv
&& drv
->suspend_late
) {
392 i
= drv
->suspend_late(pci_dev
, state
);
393 suspend_report_result(drv
->suspend_late
, i
);
398 static int pci_legacy_resume_early(struct device
*dev
)
400 struct pci_dev
* pci_dev
= to_pci_dev(dev
);
401 struct pci_driver
* drv
= pci_dev
->driver
;
403 return drv
&& drv
->resume_early
?
404 drv
->resume_early(pci_dev
) : 0;
407 static int pci_legacy_resume(struct device
*dev
)
409 struct pci_dev
* pci_dev
= to_pci_dev(dev
);
410 struct pci_driver
* drv
= pci_dev
->driver
;
412 pci_fixup_device(pci_fixup_resume
, pci_dev
);
414 return drv
&& drv
->resume
?
415 drv
->resume(pci_dev
) : pci_pm_reenable_device(pci_dev
);
418 /* Auxiliary functions used by the new power management framework */
420 static void pci_pm_default_resume_noirq(struct pci_dev
*pci_dev
)
422 pci_restore_standard_config(pci_dev
);
423 pci_dev
->state_saved
= false;
424 pci_fixup_device(pci_fixup_resume_early
, pci_dev
);
427 static int pci_pm_default_resume(struct pci_dev
*pci_dev
)
429 pci_fixup_device(pci_fixup_resume
, pci_dev
);
431 if (!pci_is_bridge(pci_dev
))
432 pci_enable_wake(pci_dev
, PCI_D0
, false);
434 return pci_pm_reenable_device(pci_dev
);
437 static void pci_pm_default_suspend_generic(struct pci_dev
*pci_dev
)
439 /* If device is enabled at this point, disable it */
440 pci_disable_enabled_device(pci_dev
);
442 * Save state with interrupts enabled, because in principle the bus the
443 * device is on may be put into a low power state after this code runs.
445 pci_save_state(pci_dev
);
448 static void pci_pm_default_suspend(struct pci_dev
*pci_dev
)
450 pci_pm_default_suspend_generic(pci_dev
);
452 if (!pci_is_bridge(pci_dev
))
453 pci_prepare_to_sleep(pci_dev
);
455 pci_fixup_device(pci_fixup_suspend
, pci_dev
);
458 static bool pci_has_legacy_pm_support(struct pci_dev
*pci_dev
)
460 struct pci_driver
*drv
= pci_dev
->driver
;
461 bool ret
= drv
&& (drv
->suspend
|| drv
->suspend_late
|| drv
->resume
462 || drv
->resume_early
);
465 * Legacy PM support is used by default, so warn if the new framework is
466 * supported as well. Drivers are supposed to support either the
467 * former, or the latter, but not both at the same time.
469 WARN_ON(ret
&& drv
->driver
.pm
);
474 /* New power management framework */
476 static int pci_pm_prepare(struct device
*dev
)
478 struct device_driver
*drv
= dev
->driver
;
481 if (drv
&& drv
->pm
&& drv
->pm
->prepare
)
482 error
= drv
->pm
->prepare(dev
);
487 static void pci_pm_complete(struct device
*dev
)
489 struct device_driver
*drv
= dev
->driver
;
491 if (drv
&& drv
->pm
&& drv
->pm
->complete
)
492 drv
->pm
->complete(dev
);
495 #ifdef CONFIG_SUSPEND
497 static int pci_pm_suspend(struct device
*dev
)
499 struct pci_dev
*pci_dev
= to_pci_dev(dev
);
500 struct device_driver
*drv
= dev
->driver
;
503 if (pci_has_legacy_pm_support(pci_dev
))
504 return pci_legacy_suspend(dev
, PMSG_SUSPEND
);
506 if (drv
&& drv
->pm
&& drv
->pm
->suspend
) {
507 error
= drv
->pm
->suspend(dev
);
508 suspend_report_result(drv
->pm
->suspend
, error
);
512 pci_pm_default_suspend(pci_dev
);
517 static int pci_pm_suspend_noirq(struct device
*dev
)
519 struct pci_dev
*pci_dev
= to_pci_dev(dev
);
520 struct device_driver
*drv
= dev
->driver
;
523 if (pci_has_legacy_pm_support(pci_dev
))
524 return pci_legacy_suspend_late(dev
, PMSG_SUSPEND
);
526 if (drv
&& drv
->pm
&& drv
->pm
->suspend_noirq
) {
527 error
= drv
->pm
->suspend_noirq(dev
);
528 suspend_report_result(drv
->pm
->suspend_noirq
, error
);
532 pci_pm_set_unknown_state(pci_dev
);
537 static int pci_pm_resume_noirq(struct device
*dev
)
539 struct pci_dev
*pci_dev
= to_pci_dev(dev
);
540 struct device_driver
*drv
= dev
->driver
;
543 pci_pm_default_resume_noirq(pci_dev
);
545 if (pci_has_legacy_pm_support(pci_dev
))
546 return pci_legacy_resume_early(dev
);
548 if (drv
&& drv
->pm
&& drv
->pm
->resume_noirq
)
549 error
= drv
->pm
->resume_noirq(dev
);
554 static int pci_pm_resume(struct device
*dev
)
556 struct pci_dev
*pci_dev
= to_pci_dev(dev
);
557 struct device_driver
*drv
= dev
->driver
;
561 * This is necessary for the suspend error path in which resume is
562 * called without restoring the standard config registers of the device.
564 if (pci_dev
->state_saved
)
565 pci_restore_standard_config(pci_dev
);
567 if (pci_has_legacy_pm_support(pci_dev
))
568 return pci_legacy_resume(dev
);
570 error
= pci_pm_default_resume(pci_dev
);
572 if (!error
&& drv
&& drv
->pm
&& drv
->pm
->resume
)
573 error
= drv
->pm
->resume(dev
);
578 #else /* !CONFIG_SUSPEND */
580 #define pci_pm_suspend NULL
581 #define pci_pm_suspend_noirq NULL
582 #define pci_pm_resume NULL
583 #define pci_pm_resume_noirq NULL
585 #endif /* !CONFIG_SUSPEND */
587 #ifdef CONFIG_HIBERNATION
589 static int pci_pm_freeze(struct device
*dev
)
591 struct pci_dev
*pci_dev
= to_pci_dev(dev
);
592 struct device_driver
*drv
= dev
->driver
;
595 if (pci_has_legacy_pm_support(pci_dev
))
596 return pci_legacy_suspend(dev
, PMSG_FREEZE
);
598 if (drv
&& drv
->pm
&& drv
->pm
->freeze
) {
599 error
= drv
->pm
->freeze(dev
);
600 suspend_report_result(drv
->pm
->freeze
, error
);
604 pci_pm_default_suspend_generic(pci_dev
);
609 static int pci_pm_freeze_noirq(struct device
*dev
)
611 struct pci_dev
*pci_dev
= to_pci_dev(dev
);
612 struct device_driver
*drv
= dev
->driver
;
615 if (pci_has_legacy_pm_support(pci_dev
))
616 return pci_legacy_suspend_late(dev
, PMSG_FREEZE
);
618 if (drv
&& drv
->pm
&& drv
->pm
->freeze_noirq
) {
619 error
= drv
->pm
->freeze_noirq(dev
);
620 suspend_report_result(drv
->pm
->freeze_noirq
, error
);
624 pci_pm_set_unknown_state(pci_dev
);
629 static int pci_pm_thaw_noirq(struct device
*dev
)
631 struct pci_dev
*pci_dev
= to_pci_dev(dev
);
632 struct device_driver
*drv
= dev
->driver
;
635 if (pci_has_legacy_pm_support(pci_dev
))
636 return pci_legacy_resume_early(dev
);
638 pci_update_current_state(pci_dev
, PCI_D0
);
640 if (drv
&& drv
->pm
&& drv
->pm
->thaw_noirq
)
641 error
= drv
->pm
->thaw_noirq(dev
);
646 static int pci_pm_thaw(struct device
*dev
)
648 struct pci_dev
*pci_dev
= to_pci_dev(dev
);
649 struct device_driver
*drv
= dev
->driver
;
652 if (pci_has_legacy_pm_support(pci_dev
))
653 return pci_legacy_resume(dev
);
655 pci_pm_reenable_device(pci_dev
);
657 if (drv
&& drv
->pm
&& drv
->pm
->thaw
)
658 error
= drv
->pm
->thaw(dev
);
663 static int pci_pm_poweroff(struct device
*dev
)
665 struct pci_dev
*pci_dev
= to_pci_dev(dev
);
666 struct device_driver
*drv
= dev
->driver
;
669 if (pci_has_legacy_pm_support(pci_dev
))
670 return pci_legacy_suspend(dev
, PMSG_HIBERNATE
);
672 if (drv
&& drv
->pm
&& drv
->pm
->poweroff
) {
673 error
= drv
->pm
->poweroff(dev
);
674 suspend_report_result(drv
->pm
->poweroff
, error
);
678 pci_pm_default_suspend(pci_dev
);
683 static int pci_pm_poweroff_noirq(struct device
*dev
)
685 struct device_driver
*drv
= dev
->driver
;
688 if (pci_has_legacy_pm_support(to_pci_dev(dev
)))
689 return pci_legacy_suspend_late(dev
, PMSG_HIBERNATE
);
691 if (drv
&& drv
->pm
&& drv
->pm
->poweroff_noirq
) {
692 error
= drv
->pm
->poweroff_noirq(dev
);
693 suspend_report_result(drv
->pm
->poweroff_noirq
, error
);
699 static int pci_pm_restore_noirq(struct device
*dev
)
701 struct pci_dev
*pci_dev
= to_pci_dev(dev
);
702 struct device_driver
*drv
= dev
->driver
;
705 pci_pm_default_resume_noirq(pci_dev
);
707 if (pci_has_legacy_pm_support(pci_dev
))
708 return pci_legacy_resume_early(dev
);
710 if (drv
&& drv
->pm
&& drv
->pm
->restore_noirq
)
711 error
= drv
->pm
->restore_noirq(dev
);
716 static int pci_pm_restore(struct device
*dev
)
718 struct pci_dev
*pci_dev
= to_pci_dev(dev
);
719 struct device_driver
*drv
= dev
->driver
;
723 * This is necessary for the hibernation error path in which restore is
724 * called without restoring the standard config registers of the device.
726 if (pci_dev
->state_saved
)
727 pci_restore_standard_config(pci_dev
);
729 if (pci_has_legacy_pm_support(pci_dev
))
730 return pci_legacy_resume(dev
);
732 error
= pci_pm_default_resume(pci_dev
);
734 if (!error
&& drv
&& drv
->pm
&& drv
->pm
->restore
)
735 error
= drv
->pm
->restore(dev
);
740 #else /* !CONFIG_HIBERNATION */
742 #define pci_pm_freeze NULL
743 #define pci_pm_freeze_noirq NULL
744 #define pci_pm_thaw NULL
745 #define pci_pm_thaw_noirq NULL
746 #define pci_pm_poweroff NULL
747 #define pci_pm_poweroff_noirq NULL
748 #define pci_pm_restore NULL
749 #define pci_pm_restore_noirq NULL
751 #endif /* !CONFIG_HIBERNATION */
753 struct dev_pm_ops pci_dev_pm_ops
= {
754 .prepare
= pci_pm_prepare
,
755 .complete
= pci_pm_complete
,
756 .suspend
= pci_pm_suspend
,
757 .resume
= pci_pm_resume
,
758 .freeze
= pci_pm_freeze
,
760 .poweroff
= pci_pm_poweroff
,
761 .restore
= pci_pm_restore
,
762 .suspend_noirq
= pci_pm_suspend_noirq
,
763 .resume_noirq
= pci_pm_resume_noirq
,
764 .freeze_noirq
= pci_pm_freeze_noirq
,
765 .thaw_noirq
= pci_pm_thaw_noirq
,
766 .poweroff_noirq
= pci_pm_poweroff_noirq
,
767 .restore_noirq
= pci_pm_restore_noirq
,
770 #define PCI_PM_OPS_PTR (&pci_dev_pm_ops)
772 #else /* !CONFIG_PM_SLEEP */
774 #define PCI_PM_OPS_PTR NULL
776 #endif /* !CONFIG_PM_SLEEP */
779 * __pci_register_driver - register a new pci driver
780 * @drv: the driver structure to register
781 * @owner: owner module of drv
782 * @mod_name: module name string
784 * Adds the driver structure to the list of registered drivers.
785 * Returns a negative value on error, otherwise 0.
786 * If no error occurred, the driver remains registered even if
787 * no device was claimed during registration.
789 int __pci_register_driver(struct pci_driver
*drv
, struct module
*owner
,
790 const char *mod_name
)
794 /* initialize common driver fields */
795 drv
->driver
.name
= drv
->name
;
796 drv
->driver
.bus
= &pci_bus_type
;
797 drv
->driver
.owner
= owner
;
798 drv
->driver
.mod_name
= mod_name
;
800 spin_lock_init(&drv
->dynids
.lock
);
801 INIT_LIST_HEAD(&drv
->dynids
.list
);
803 /* register with core */
804 error
= driver_register(&drv
->driver
);
808 error
= pci_create_newid_file(drv
);
810 driver_unregister(&drv
->driver
);
816 * pci_unregister_driver - unregister a pci driver
817 * @drv: the driver structure to unregister
819 * Deletes the driver structure from the list of registered PCI drivers,
820 * gives it a chance to clean up by calling its remove() function for
821 * each device it was responsible for, and marks those devices as
826 pci_unregister_driver(struct pci_driver
*drv
)
828 pci_remove_newid_file(drv
);
829 driver_unregister(&drv
->driver
);
830 pci_free_dynids(drv
);
833 static struct pci_driver pci_compat_driver
= {
838 * pci_dev_driver - get the pci_driver of a device
839 * @dev: the device to query
841 * Returns the appropriate pci_driver structure or %NULL if there is no
842 * registered driver for the device.
845 pci_dev_driver(const struct pci_dev
*dev
)
851 for(i
=0; i
<=PCI_ROM_RESOURCE
; i
++)
852 if (dev
->resource
[i
].flags
& IORESOURCE_BUSY
)
853 return &pci_compat_driver
;
859 * pci_bus_match - Tell if a PCI device structure has a matching PCI device id structure
860 * @dev: the PCI device structure to match against
861 * @drv: the device driver to search for matching PCI device id structures
863 * Used by a driver to check whether a PCI device present in the
864 * system is in its list of supported devices. Returns the matching
865 * pci_device_id structure or %NULL if there is no match.
867 static int pci_bus_match(struct device
*dev
, struct device_driver
*drv
)
869 struct pci_dev
*pci_dev
= to_pci_dev(dev
);
870 struct pci_driver
*pci_drv
= to_pci_driver(drv
);
871 const struct pci_device_id
*found_id
;
873 found_id
= pci_match_device(pci_drv
, pci_dev
);
881 * pci_dev_get - increments the reference count of the pci device structure
882 * @dev: the device being referenced
884 * Each live reference to a device should be refcounted.
886 * Drivers for PCI devices should normally record such references in
887 * their probe() methods, when they bind to a device, and release
888 * them by calling pci_dev_put(), in their disconnect() methods.
890 * A pointer to the device with the incremented reference counter is returned.
892 struct pci_dev
*pci_dev_get(struct pci_dev
*dev
)
895 get_device(&dev
->dev
);
900 * pci_dev_put - release a use of the pci device structure
901 * @dev: device that's been disconnected
903 * Must be called when a user of a device is finished with it. When the last
904 * user of the device calls this function, the memory of the device is freed.
906 void pci_dev_put(struct pci_dev
*dev
)
909 put_device(&dev
->dev
);
912 #ifndef CONFIG_HOTPLUG
913 int pci_uevent(struct device
*dev
, struct kobj_uevent_env
*env
)
919 struct bus_type pci_bus_type
= {
921 .match
= pci_bus_match
,
922 .uevent
= pci_uevent
,
923 .probe
= pci_device_probe
,
924 .remove
= pci_device_remove
,
925 .shutdown
= pci_device_shutdown
,
926 .dev_attrs
= pci_dev_attrs
,
927 .pm
= PCI_PM_OPS_PTR
,
930 static int __init
pci_driver_init(void)
932 return bus_register(&pci_bus_type
);
935 postcore_initcall(pci_driver_init
);
937 EXPORT_SYMBOL(pci_match_id
);
938 EXPORT_SYMBOL(__pci_register_driver
);
939 EXPORT_SYMBOL(pci_unregister_driver
);
940 EXPORT_SYMBOL(pci_dev_driver
);
941 EXPORT_SYMBOL(pci_bus_type
);
942 EXPORT_SYMBOL(pci_dev_get
);
943 EXPORT_SYMBOL(pci_dev_put
);