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>
22 * Dynamic device IDs are disabled for !CONFIG_HOTPLUG
26 struct list_head node
;
27 struct pci_device_id id
;
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
38 * Adds a new dynamic pci device ID to this driver,
39 * and causes the driver to probe for all devices again.
42 store_new_id(struct device_driver
*driver
, const char *buf
, size_t count
)
44 struct pci_dynid
*dynid
;
45 struct pci_driver
*pdrv
= to_pci_driver(driver
);
46 const struct pci_device_id
*ids
= pdrv
->id_table
;
47 __u32 vendor
, device
, subvendor
=PCI_ANY_ID
,
48 subdevice
=PCI_ANY_ID
, class=0, class_mask
=0;
49 unsigned long driver_data
=0;
53 fields
= sscanf(buf
, "%x %x %x %x %x %x %lx",
54 &vendor
, &device
, &subvendor
, &subdevice
,
55 &class, &class_mask
, &driver_data
);
59 /* Only accept driver_data values that match an existing id_table
62 while (ids
->vendor
|| ids
->subvendor
|| ids
->class_mask
) {
63 if (driver_data
== ids
->driver_data
) {
69 if (retval
) /* No match */
72 dynid
= kzalloc(sizeof(*dynid
), GFP_KERNEL
);
76 dynid
->id
.vendor
= vendor
;
77 dynid
->id
.device
= device
;
78 dynid
->id
.subvendor
= subvendor
;
79 dynid
->id
.subdevice
= subdevice
;
80 dynid
->id
.class = class;
81 dynid
->id
.class_mask
= class_mask
;
82 dynid
->id
.driver_data
= driver_data
;
84 spin_lock(&pdrv
->dynids
.lock
);
85 list_add_tail(&dynid
->node
, &pdrv
->dynids
.list
);
86 spin_unlock(&pdrv
->dynids
.lock
);
88 if (get_driver(&pdrv
->driver
)) {
89 retval
= driver_attach(&pdrv
->driver
);
90 put_driver(&pdrv
->driver
);
97 static DRIVER_ATTR(new_id
, S_IWUSR
, NULL
, store_new_id
);
100 pci_free_dynids(struct pci_driver
*drv
)
102 struct pci_dynid
*dynid
, *n
;
104 spin_lock(&drv
->dynids
.lock
);
105 list_for_each_entry_safe(dynid
, n
, &drv
->dynids
.list
, node
) {
106 list_del(&dynid
->node
);
109 spin_unlock(&drv
->dynids
.lock
);
113 pci_create_newid_file(struct pci_driver
*drv
)
116 if (drv
->probe
!= NULL
)
117 error
= driver_create_file(&drv
->driver
, &driver_attr_new_id
);
121 static void pci_remove_newid_file(struct pci_driver
*drv
)
123 driver_remove_file(&drv
->driver
, &driver_attr_new_id
);
125 #else /* !CONFIG_HOTPLUG */
126 static inline void pci_free_dynids(struct pci_driver
*drv
) {}
127 static inline int pci_create_newid_file(struct pci_driver
*drv
)
131 static inline void pci_remove_newid_file(struct pci_driver
*drv
) {}
135 * pci_match_id - See if a pci device matches a given pci_id table
136 * @ids: array of PCI device id structures to search in
137 * @dev: the PCI device structure to match against.
139 * Used by a driver to check whether a PCI device present in the
140 * system is in its list of supported devices. Returns the matching
141 * pci_device_id structure or %NULL if there is no match.
143 * Deprecated, don't use this as it will not catch any dynamic ids
144 * that a driver might want to check for.
146 const struct pci_device_id
*pci_match_id(const struct pci_device_id
*ids
,
150 while (ids
->vendor
|| ids
->subvendor
|| ids
->class_mask
) {
151 if (pci_match_one_device(ids
, dev
))
160 * pci_match_device - Tell if a PCI device structure has a matching PCI device id structure
161 * @drv: the PCI driver to match against
162 * @dev: the PCI device structure to match against
164 * Used by a driver to check whether a PCI device present in the
165 * system is in its list of supported devices. Returns the matching
166 * pci_device_id structure or %NULL if there is no match.
168 static const struct pci_device_id
*pci_match_device(struct pci_driver
*drv
,
171 struct pci_dynid
*dynid
;
173 /* Look at the dynamic ids first, before the static ones */
174 spin_lock(&drv
->dynids
.lock
);
175 list_for_each_entry(dynid
, &drv
->dynids
.list
, node
) {
176 if (pci_match_one_device(&dynid
->id
, dev
)) {
177 spin_unlock(&drv
->dynids
.lock
);
181 spin_unlock(&drv
->dynids
.lock
);
183 return pci_match_id(drv
->id_table
, dev
);
186 static int pci_call_probe(struct pci_driver
*drv
, struct pci_dev
*dev
,
187 const struct pci_device_id
*id
)
191 /* Execute driver initialization on node where the
192 device's bus is attached to. This way the driver likely
193 allocates its local memory on the right node without
194 any need to change it. */
195 struct mempolicy
*oldpol
;
196 cpumask_t oldmask
= current
->cpus_allowed
;
197 int node
= dev_to_node(&dev
->dev
);
200 node_to_cpumask_ptr(nodecpumask
, node
);
201 set_cpus_allowed_ptr(current
, nodecpumask
);
203 /* And set default memory allocation policy */
204 oldpol
= current
->mempolicy
;
205 current
->mempolicy
= NULL
; /* fall back to system default policy */
207 error
= drv
->probe(dev
, id
);
209 set_cpus_allowed_ptr(current
, &oldmask
);
210 current
->mempolicy
= oldpol
;
216 * __pci_device_probe()
217 * @drv: driver to call to check if it wants the PCI device
218 * @pci_dev: PCI device being probed
220 * returns 0 on success, else error.
221 * side-effect: pci_dev->driver is set to drv when drv claims pci_dev.
224 __pci_device_probe(struct pci_driver
*drv
, struct pci_dev
*pci_dev
)
226 const struct pci_device_id
*id
;
229 if (!pci_dev
->driver
&& drv
->probe
) {
232 id
= pci_match_device(drv
, pci_dev
);
234 error
= pci_call_probe(drv
, pci_dev
, id
);
236 pci_dev
->driver
= drv
;
243 static int pci_device_probe(struct device
* dev
)
246 struct pci_driver
*drv
;
247 struct pci_dev
*pci_dev
;
249 drv
= to_pci_driver(dev
->driver
);
250 pci_dev
= to_pci_dev(dev
);
251 pci_dev_get(pci_dev
);
252 error
= __pci_device_probe(drv
, pci_dev
);
254 pci_dev_put(pci_dev
);
259 static int pci_device_remove(struct device
* dev
)
261 struct pci_dev
* pci_dev
= to_pci_dev(dev
);
262 struct pci_driver
* drv
= pci_dev
->driver
;
266 drv
->remove(pci_dev
);
267 pci_dev
->driver
= NULL
;
271 * If the device is still on, set the power state as "unknown",
272 * since it might change by the next time we load the driver.
274 if (pci_dev
->current_state
== PCI_D0
)
275 pci_dev
->current_state
= PCI_UNKNOWN
;
278 * We would love to complain here if pci_dev->is_enabled is set, that
279 * the driver should have called pci_disable_device(), but the
280 * unfortunate fact is there are too many odd BIOS and bridge setups
281 * that don't like drivers doing that all of the time.
282 * Oh well, we can dream of sane hardware when we sleep, no matter how
283 * horrible the crap we have to deal with is when we are awake...
286 pci_dev_put(pci_dev
);
290 static void pci_device_shutdown(struct device
*dev
)
292 struct pci_dev
*pci_dev
= to_pci_dev(dev
);
293 struct pci_driver
*drv
= pci_dev
->driver
;
295 if (drv
&& drv
->shutdown
)
296 drv
->shutdown(pci_dev
);
297 pci_msi_shutdown(pci_dev
);
298 pci_msix_shutdown(pci_dev
);
301 #ifdef CONFIG_PM_SLEEP
304 * Default "suspend" method for devices that have no driver provided suspend,
305 * or not even a driver at all.
307 static void pci_default_pm_suspend(struct pci_dev
*pci_dev
)
309 pci_save_state(pci_dev
);
311 * mark its power state as "unknown", since we don't know if
312 * e.g. the BIOS will change its device state when we suspend.
314 if (pci_dev
->current_state
== PCI_D0
)
315 pci_dev
->current_state
= PCI_UNKNOWN
;
319 * Default "resume" method for devices that have no driver provided resume,
320 * or not even a driver at all.
322 static int pci_default_pm_resume(struct pci_dev
*pci_dev
)
326 /* restore the PCI config space */
327 pci_restore_state(pci_dev
);
328 /* if the device was enabled before suspend, reenable */
329 retval
= pci_reenable_device(pci_dev
);
331 * if the device was busmaster before the suspend, make it busmaster
334 if (pci_dev
->is_busmaster
)
335 pci_set_master(pci_dev
);
340 static int pci_legacy_suspend(struct device
*dev
, pm_message_t state
)
342 struct pci_dev
* pci_dev
= to_pci_dev(dev
);
343 struct pci_driver
* drv
= pci_dev
->driver
;
346 if (drv
&& drv
->suspend
) {
347 i
= drv
->suspend(pci_dev
, state
);
348 suspend_report_result(drv
->suspend
, i
);
350 pci_default_pm_suspend(pci_dev
);
355 static int pci_legacy_suspend_late(struct device
*dev
, pm_message_t state
)
357 struct pci_dev
* pci_dev
= to_pci_dev(dev
);
358 struct pci_driver
* drv
= pci_dev
->driver
;
361 if (drv
&& drv
->suspend_late
) {
362 i
= drv
->suspend_late(pci_dev
, state
);
363 suspend_report_result(drv
->suspend_late
, i
);
368 static int pci_legacy_resume(struct device
*dev
)
371 struct pci_dev
* pci_dev
= to_pci_dev(dev
);
372 struct pci_driver
* drv
= pci_dev
->driver
;
374 if (drv
&& drv
->resume
)
375 error
= drv
->resume(pci_dev
);
377 error
= pci_default_pm_resume(pci_dev
);
381 static int pci_legacy_resume_early(struct device
*dev
)
384 struct pci_dev
* pci_dev
= to_pci_dev(dev
);
385 struct pci_driver
* drv
= pci_dev
->driver
;
387 if (drv
&& drv
->resume_early
)
388 error
= drv
->resume_early(pci_dev
);
392 static int pci_pm_prepare(struct device
*dev
)
394 struct device_driver
*drv
= dev
->driver
;
397 if (drv
&& drv
->pm
&& drv
->pm
->prepare
)
398 error
= drv
->pm
->prepare(dev
);
403 static void pci_pm_complete(struct device
*dev
)
405 struct device_driver
*drv
= dev
->driver
;
407 if (drv
&& drv
->pm
&& drv
->pm
->complete
)
408 drv
->pm
->complete(dev
);
411 #ifdef CONFIG_SUSPEND
413 static int pci_pm_suspend(struct device
*dev
)
415 struct pci_dev
*pci_dev
= to_pci_dev(dev
);
416 struct device_driver
*drv
= dev
->driver
;
419 if (drv
&& drv
->pm
) {
420 if (drv
->pm
->suspend
) {
421 error
= drv
->pm
->suspend(dev
);
422 suspend_report_result(drv
->pm
->suspend
, error
);
424 pci_default_pm_suspend(pci_dev
);
427 error
= pci_legacy_suspend(dev
, PMSG_SUSPEND
);
429 pci_fixup_device(pci_fixup_suspend
, pci_dev
);
434 static int pci_pm_suspend_noirq(struct device
*dev
)
436 struct pci_dev
*pci_dev
= to_pci_dev(dev
);
437 struct pci_driver
*drv
= pci_dev
->driver
;
440 if (drv
&& drv
->pm
) {
441 if (drv
->pm
->suspend_noirq
) {
442 error
= drv
->pm
->suspend_noirq(dev
);
443 suspend_report_result(drv
->pm
->suspend_noirq
, error
);
446 error
= pci_legacy_suspend_late(dev
, PMSG_SUSPEND
);
452 static int pci_pm_resume(struct device
*dev
)
454 struct pci_dev
*pci_dev
= to_pci_dev(dev
);
455 struct device_driver
*drv
= dev
->driver
;
458 pci_fixup_device(pci_fixup_resume
, pci_dev
);
460 if (drv
&& drv
->pm
) {
461 error
= drv
->pm
->resume
? drv
->pm
->resume(dev
) :
462 pci_default_pm_resume(pci_dev
);
464 error
= pci_legacy_resume(dev
);
470 static int pci_pm_resume_noirq(struct device
*dev
)
472 struct pci_dev
*pci_dev
= to_pci_dev(dev
);
473 struct pci_driver
*drv
= pci_dev
->driver
;
476 pci_fixup_device(pci_fixup_resume_early
, pci_dev
);
478 if (drv
&& drv
->pm
) {
479 if (drv
->pm
->resume_noirq
)
480 error
= drv
->pm
->resume_noirq(dev
);
482 error
= pci_legacy_resume_early(dev
);
488 #else /* !CONFIG_SUSPEND */
490 #define pci_pm_suspend NULL
491 #define pci_pm_suspend_noirq NULL
492 #define pci_pm_resume NULL
493 #define pci_pm_resume_noirq NULL
495 #endif /* !CONFIG_SUSPEND */
497 #ifdef CONFIG_HIBERNATION
499 static int pci_pm_freeze(struct device
*dev
)
501 struct pci_dev
*pci_dev
= to_pci_dev(dev
);
502 struct device_driver
*drv
= dev
->driver
;
505 if (drv
&& drv
->pm
) {
506 if (drv
->pm
->freeze
) {
507 error
= drv
->pm
->freeze(dev
);
508 suspend_report_result(drv
->pm
->freeze
, error
);
510 pci_default_pm_suspend(pci_dev
);
513 error
= pci_legacy_suspend(dev
, PMSG_FREEZE
);
514 pci_fixup_device(pci_fixup_suspend
, pci_dev
);
520 static int pci_pm_freeze_noirq(struct device
*dev
)
522 struct pci_dev
*pci_dev
= to_pci_dev(dev
);
523 struct pci_driver
*drv
= pci_dev
->driver
;
526 if (drv
&& drv
->pm
) {
527 if (drv
->pm
->freeze_noirq
) {
528 error
= drv
->pm
->freeze_noirq(dev
);
529 suspend_report_result(drv
->pm
->freeze_noirq
, error
);
532 error
= pci_legacy_suspend_late(dev
, PMSG_FREEZE
);
538 static int pci_pm_thaw(struct device
*dev
)
540 struct device_driver
*drv
= dev
->driver
;
543 if (drv
&& drv
->pm
) {
545 error
= drv
->pm
->thaw(dev
);
547 pci_fixup_device(pci_fixup_resume
, to_pci_dev(dev
));
548 error
= pci_legacy_resume(dev
);
554 static int pci_pm_thaw_noirq(struct device
*dev
)
556 struct pci_dev
*pci_dev
= to_pci_dev(dev
);
557 struct pci_driver
*drv
= pci_dev
->driver
;
560 if (drv
&& drv
->pm
) {
561 if (drv
->pm
->thaw_noirq
)
562 error
= drv
->pm
->thaw_noirq(dev
);
564 pci_fixup_device(pci_fixup_resume_early
, pci_dev
);
565 error
= pci_legacy_resume_early(dev
);
571 static int pci_pm_poweroff(struct device
*dev
)
573 struct device_driver
*drv
= dev
->driver
;
576 pci_fixup_device(pci_fixup_suspend
, to_pci_dev(dev
));
578 if (drv
&& drv
->pm
) {
579 if (drv
->pm
->poweroff
) {
580 error
= drv
->pm
->poweroff(dev
);
581 suspend_report_result(drv
->pm
->poweroff
, error
);
584 error
= pci_legacy_suspend(dev
, PMSG_HIBERNATE
);
590 static int pci_pm_poweroff_noirq(struct device
*dev
)
592 struct pci_dev
*pci_dev
= to_pci_dev(dev
);
593 struct pci_driver
*drv
= pci_dev
->driver
;
596 if (drv
&& drv
->pm
) {
597 if (drv
->pm
->poweroff_noirq
) {
598 error
= drv
->pm
->poweroff_noirq(dev
);
599 suspend_report_result(drv
->pm
->poweroff_noirq
, error
);
602 error
= pci_legacy_suspend_late(dev
, PMSG_HIBERNATE
);
608 static int pci_pm_restore(struct device
*dev
)
610 struct pci_dev
*pci_dev
= to_pci_dev(dev
);
611 struct device_driver
*drv
= dev
->driver
;
614 if (drv
&& drv
->pm
) {
615 error
= drv
->pm
->restore
? drv
->pm
->restore(dev
) :
616 pci_default_pm_resume(pci_dev
);
618 error
= pci_legacy_resume(dev
);
620 pci_fixup_device(pci_fixup_resume
, pci_dev
);
625 static int pci_pm_restore_noirq(struct device
*dev
)
627 struct pci_dev
*pci_dev
= to_pci_dev(dev
);
628 struct pci_driver
*drv
= pci_dev
->driver
;
631 pci_fixup_device(pci_fixup_resume
, pci_dev
);
633 if (drv
&& drv
->pm
) {
634 if (drv
->pm
->restore_noirq
)
635 error
= drv
->pm
->restore_noirq(dev
);
637 error
= pci_legacy_resume_early(dev
);
639 pci_fixup_device(pci_fixup_resume_early
, pci_dev
);
644 #else /* !CONFIG_HIBERNATION */
646 #define pci_pm_freeze NULL
647 #define pci_pm_freeze_noirq NULL
648 #define pci_pm_thaw NULL
649 #define pci_pm_thaw_noirq NULL
650 #define pci_pm_poweroff NULL
651 #define pci_pm_poweroff_noirq NULL
652 #define pci_pm_restore NULL
653 #define pci_pm_restore_noirq NULL
655 #endif /* !CONFIG_HIBERNATION */
657 struct pm_ext_ops pci_pm_ops
= {
659 .prepare
= pci_pm_prepare
,
660 .complete
= pci_pm_complete
,
661 .suspend
= pci_pm_suspend
,
662 .resume
= pci_pm_resume
,
663 .freeze
= pci_pm_freeze
,
665 .poweroff
= pci_pm_poweroff
,
666 .restore
= pci_pm_restore
,
668 .suspend_noirq
= pci_pm_suspend_noirq
,
669 .resume_noirq
= pci_pm_resume_noirq
,
670 .freeze_noirq
= pci_pm_freeze_noirq
,
671 .thaw_noirq
= pci_pm_thaw_noirq
,
672 .poweroff_noirq
= pci_pm_poweroff_noirq
,
673 .restore_noirq
= pci_pm_restore_noirq
,
676 #define PCI_PM_OPS_PTR &pci_pm_ops
678 #else /* !CONFIG_PM_SLEEP */
680 #define PCI_PM_OPS_PTR NULL
682 #endif /* !CONFIG_PM_SLEEP */
685 * __pci_register_driver - register a new pci driver
686 * @drv: the driver structure to register
687 * @owner: owner module of drv
688 * @mod_name: module name string
690 * Adds the driver structure to the list of registered drivers.
691 * Returns a negative value on error, otherwise 0.
692 * If no error occurred, the driver remains registered even if
693 * no device was claimed during registration.
695 int __pci_register_driver(struct pci_driver
*drv
, struct module
*owner
,
696 const char *mod_name
)
700 /* initialize common driver fields */
701 drv
->driver
.name
= drv
->name
;
702 drv
->driver
.bus
= &pci_bus_type
;
703 drv
->driver
.owner
= owner
;
704 drv
->driver
.mod_name
= mod_name
;
707 drv
->driver
.pm
= &drv
->pm
->base
;
709 spin_lock_init(&drv
->dynids
.lock
);
710 INIT_LIST_HEAD(&drv
->dynids
.list
);
712 /* register with core */
713 error
= driver_register(&drv
->driver
);
717 error
= pci_create_newid_file(drv
);
719 driver_unregister(&drv
->driver
);
725 * pci_unregister_driver - unregister a pci driver
726 * @drv: the driver structure to unregister
728 * Deletes the driver structure from the list of registered PCI drivers,
729 * gives it a chance to clean up by calling its remove() function for
730 * each device it was responsible for, and marks those devices as
735 pci_unregister_driver(struct pci_driver
*drv
)
737 pci_remove_newid_file(drv
);
738 driver_unregister(&drv
->driver
);
739 pci_free_dynids(drv
);
742 static struct pci_driver pci_compat_driver
= {
747 * pci_dev_driver - get the pci_driver of a device
748 * @dev: the device to query
750 * Returns the appropriate pci_driver structure or %NULL if there is no
751 * registered driver for the device.
754 pci_dev_driver(const struct pci_dev
*dev
)
760 for(i
=0; i
<=PCI_ROM_RESOURCE
; i
++)
761 if (dev
->resource
[i
].flags
& IORESOURCE_BUSY
)
762 return &pci_compat_driver
;
768 * pci_bus_match - Tell if a PCI device structure has a matching PCI device id structure
769 * @dev: the PCI device structure to match against
770 * @drv: the device driver to search for matching PCI device id structures
772 * Used by a driver to check whether a PCI device present in the
773 * system is in its list of supported devices. Returns the matching
774 * pci_device_id structure or %NULL if there is no match.
776 static int pci_bus_match(struct device
*dev
, struct device_driver
*drv
)
778 struct pci_dev
*pci_dev
= to_pci_dev(dev
);
779 struct pci_driver
*pci_drv
= to_pci_driver(drv
);
780 const struct pci_device_id
*found_id
;
782 found_id
= pci_match_device(pci_drv
, pci_dev
);
790 * pci_dev_get - increments the reference count of the pci device structure
791 * @dev: the device being referenced
793 * Each live reference to a device should be refcounted.
795 * Drivers for PCI devices should normally record such references in
796 * their probe() methods, when they bind to a device, and release
797 * them by calling pci_dev_put(), in their disconnect() methods.
799 * A pointer to the device with the incremented reference counter is returned.
801 struct pci_dev
*pci_dev_get(struct pci_dev
*dev
)
804 get_device(&dev
->dev
);
809 * pci_dev_put - release a use of the pci device structure
810 * @dev: device that's been disconnected
812 * Must be called when a user of a device is finished with it. When the last
813 * user of the device calls this function, the memory of the device is freed.
815 void pci_dev_put(struct pci_dev
*dev
)
818 put_device(&dev
->dev
);
821 #ifndef CONFIG_HOTPLUG
822 int pci_uevent(struct device
*dev
, struct kobj_uevent_env
*env
)
828 struct bus_type pci_bus_type
= {
830 .match
= pci_bus_match
,
831 .uevent
= pci_uevent
,
832 .probe
= pci_device_probe
,
833 .remove
= pci_device_remove
,
834 .shutdown
= pci_device_shutdown
,
835 .dev_attrs
= pci_dev_attrs
,
836 .pm
= PCI_PM_OPS_PTR
,
839 static int __init
pci_driver_init(void)
841 return bus_register(&pci_bus_type
);
844 postcore_initcall(pci_driver_init
);
846 EXPORT_SYMBOL(pci_match_id
);
847 EXPORT_SYMBOL(__pci_register_driver
);
848 EXPORT_SYMBOL(pci_unregister_driver
);
849 EXPORT_SYMBOL(pci_dev_driver
);
850 EXPORT_SYMBOL(pci_bus_type
);
851 EXPORT_SYMBOL(pci_dev_get
);
852 EXPORT_SYMBOL(pci_dev_put
);