pci-driver.c 35.4 KB
Newer Older
Linus Torvalds's avatar
Linus Torvalds committed
1 2 3
/*
 * drivers/pci/pci-driver.c
 *
4 5 6 7 8
 * (C) Copyright 2002-2004, 2007 Greg Kroah-Hartman <greg@kroah.com>
 * (C) Copyright 2007 Novell Inc.
 *
 * Released under the GPL v2 only.
 *
Linus Torvalds's avatar
Linus Torvalds committed
9 10 11 12 13 14
 */

#include <linux/pci.h>
#include <linux/module.h>
#include <linux/init.h>
#include <linux/device.h>
15
#include <linux/mempolicy.h>
16 17
#include <linux/string.h>
#include <linux/slab.h>
18
#include <linux/sched.h>
19
#include <linux/cpu.h>
20
#include <linux/pm_runtime.h>
21
#include <linux/suspend.h>
22
#include <linux/kexec.h>
Linus Torvalds's avatar
Linus Torvalds committed
23 24
#include "pci.h"

25 26 27 28
struct pci_dynid {
	struct list_head node;
	struct pci_device_id id;
};
Linus Torvalds's avatar
Linus Torvalds committed
29

30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69
/**
 * pci_add_dynid - add a new PCI device ID to this driver and re-probe devices
 * @drv: target pci driver
 * @vendor: PCI vendor ID
 * @device: PCI device ID
 * @subvendor: PCI subvendor ID
 * @subdevice: PCI subdevice ID
 * @class: PCI class
 * @class_mask: PCI class mask
 * @driver_data: private driver data
 *
 * Adds a new dynamic pci device ID to this driver and causes the
 * driver to probe for all devices again.  @drv must have been
 * registered prior to calling this function.
 *
 * CONTEXT:
 * Does GFP_KERNEL allocation.
 *
 * RETURNS:
 * 0 on success, -errno on failure.
 */
int pci_add_dynid(struct pci_driver *drv,
		  unsigned int vendor, unsigned int device,
		  unsigned int subvendor, unsigned int subdevice,
		  unsigned int class, unsigned int class_mask,
		  unsigned long driver_data)
{
	struct pci_dynid *dynid;

	dynid = kzalloc(sizeof(*dynid), GFP_KERNEL);
	if (!dynid)
		return -ENOMEM;

	dynid->id.vendor = vendor;
	dynid->id.device = device;
	dynid->id.subvendor = subvendor;
	dynid->id.subdevice = subdevice;
	dynid->id.class = class;
	dynid->id.class_mask = class_mask;
	dynid->id.driver_data = driver_data;
70

71 72 73 74
	spin_lock(&drv->dynids.lock);
	list_add_tail(&dynid->node, &drv->dynids.list);
	spin_unlock(&drv->dynids.lock);

75
	return driver_attach(&drv->driver);
76
}
77
EXPORT_SYMBOL_GPL(pci_add_dynid);
78 79 80 81

static void pci_free_dynids(struct pci_driver *drv)
{
	struct pci_dynid *dynid, *n;
82

83 84 85 86 87 88 89 90
	spin_lock(&drv->dynids.lock);
	list_for_each_entry_safe(dynid, n, &drv->dynids.list, node) {
		list_del(&dynid->node);
		kfree(dynid);
	}
	spin_unlock(&drv->dynids.lock);
}

Linus Torvalds's avatar
Linus Torvalds committed
91
/**
92
 * store_new_id - sysfs frontend to pci_add_dynid()
93 94 95
 * @driver: target device driver
 * @buf: buffer for scanning device ID data
 * @count: input size
Linus Torvalds's avatar
Linus Torvalds committed
96
 *
97
 * Allow PCI IDs to be added to an existing driver via sysfs.
Linus Torvalds's avatar
Linus Torvalds committed
98
 */
Ryan Desfosses's avatar
Ryan Desfosses committed
99 100
static ssize_t store_new_id(struct device_driver *driver, const char *buf,
			    size_t count)
Linus Torvalds's avatar
Linus Torvalds committed
101 102
{
	struct pci_driver *pdrv = to_pci_driver(driver);
103
	const struct pci_device_id *ids = pdrv->id_table;
Ryan Desfosses's avatar
Ryan Desfosses committed
104 105 106 107
	__u32 vendor, device, subvendor = PCI_ANY_ID,
		subdevice = PCI_ANY_ID, class = 0, class_mask = 0;
	unsigned long driver_data = 0;
	int fields = 0;
108
	int retval = 0;
Linus Torvalds's avatar
Linus Torvalds committed
109

110
	fields = sscanf(buf, "%x %x %x %x %x %x %lx",
Linus Torvalds's avatar
Linus Torvalds committed
111 112
			&vendor, &device, &subvendor, &subdevice,
			&class, &class_mask, &driver_data);
113
	if (fields < 2)
Linus Torvalds's avatar
Linus Torvalds committed
114 115
		return -EINVAL;

116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135
	if (fields != 7) {
		struct pci_dev *pdev = kzalloc(sizeof(*pdev), GFP_KERNEL);
		if (!pdev)
			return -ENOMEM;

		pdev->vendor = vendor;
		pdev->device = device;
		pdev->subsystem_vendor = subvendor;
		pdev->subsystem_device = subdevice;
		pdev->class = class;

		if (pci_match_id(pdrv->id_table, pdev))
			retval = -EEXIST;

		kfree(pdev);

		if (retval)
			return retval;
	}

136 137
	/* Only accept driver_data values that match an existing id_table
	   entry */
138 139 140 141 142 143 144 145
	if (ids) {
		retval = -EINVAL;
		while (ids->vendor || ids->subvendor || ids->class_mask) {
			if (driver_data == ids->driver_data) {
				retval = 0;
				break;
			}
			ids++;
146
		}
147 148
		if (retval)	/* No match */
			return retval;
149 150
	}

151 152
	retval = pci_add_dynid(pdrv, vendor, device, subvendor, subdevice,
			       class, class_mask, driver_data);
153 154
	if (retval)
		return retval;
Linus Torvalds's avatar
Linus Torvalds committed
155 156
	return count;
}
157
static DRIVER_ATTR(new_id, S_IWUSR, NULL, store_new_id);
Linus Torvalds's avatar
Linus Torvalds committed
158

159 160 161 162 163 164 165 166
/**
 * store_remove_id - remove a PCI device ID from this driver
 * @driver: target device driver
 * @buf: buffer for scanning device ID data
 * @count: input size
 *
 * Removes a dynamic pci device ID to this driver.
 */
Ryan Desfosses's avatar
Ryan Desfosses committed
167 168
static ssize_t store_remove_id(struct device_driver *driver, const char *buf,
			       size_t count)
169 170 171 172 173 174
{
	struct pci_dynid *dynid, *n;
	struct pci_driver *pdrv = to_pci_driver(driver);
	__u32 vendor, device, subvendor = PCI_ANY_ID,
		subdevice = PCI_ANY_ID, class = 0, class_mask = 0;
	int fields = 0;
175
	size_t retval = -ENODEV;
176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192

	fields = sscanf(buf, "%x %x %x %x %x %x",
			&vendor, &device, &subvendor, &subdevice,
			&class, &class_mask);
	if (fields < 2)
		return -EINVAL;

	spin_lock(&pdrv->dynids.lock);
	list_for_each_entry_safe(dynid, n, &pdrv->dynids.list, node) {
		struct pci_device_id *id = &dynid->id;
		if ((id->vendor == vendor) &&
		    (id->device == device) &&
		    (subvendor == PCI_ANY_ID || id->subvendor == subvendor) &&
		    (subdevice == PCI_ANY_ID || id->subdevice == subdevice) &&
		    !((id->class ^ class) & class_mask)) {
			list_del(&dynid->node);
			kfree(dynid);
193
			retval = count;
194 195 196 197 198
			break;
		}
	}
	spin_unlock(&pdrv->dynids.lock);

199
	return retval;
200
}
201
static DRIVER_ATTR(remove_id, S_IWUSR, NULL, store_remove_id);
202

203 204 205 206
static struct attribute *pci_drv_attrs[] = {
	&driver_attr_new_id.attr,
	&driver_attr_remove_id.attr,
	NULL,
207
};
208
ATTRIBUTE_GROUPS(pci_drv);
209

Linus Torvalds's avatar
Linus Torvalds committed
210
/**
211
 * pci_match_id - See if a pci device matches a given pci_id table
Linus Torvalds's avatar
Linus Torvalds committed
212
 * @ids: array of PCI device id structures to search in
213 214
 * @dev: the PCI device structure to match against.
 *
Linus Torvalds's avatar
Linus Torvalds committed
215
 * Used by a driver to check whether a PCI device present in the
216
 * system is in its list of supported devices.  Returns the matching
Linus Torvalds's avatar
Linus Torvalds committed
217
 * pci_device_id structure or %NULL if there is no match.
218
 *
219
 * Deprecated, don't use this as it will not catch any dynamic ids
220
 * that a driver might want to check for.
Linus Torvalds's avatar
Linus Torvalds committed
221
 */
222 223
const struct pci_device_id *pci_match_id(const struct pci_device_id *ids,
					 struct pci_dev *dev)
Linus Torvalds's avatar
Linus Torvalds committed
224
{
225 226 227 228 229 230
	if (ids) {
		while (ids->vendor || ids->subvendor || ids->class_mask) {
			if (pci_match_one_device(ids, dev))
				return ids;
			ids++;
		}
Linus Torvalds's avatar
Linus Torvalds committed
231 232 233
	}
	return NULL;
}
234
EXPORT_SYMBOL(pci_match_id);
Linus Torvalds's avatar
Linus Torvalds committed
235

236 237 238 239 240 241 242
static const struct pci_device_id pci_device_id_any = {
	.vendor = PCI_ANY_ID,
	.device = PCI_ANY_ID,
	.subvendor = PCI_ANY_ID,
	.subdevice = PCI_ANY_ID,
};

Linus Torvalds's avatar
Linus Torvalds committed
243
/**
244
 * pci_match_device - Tell if a PCI device structure has a matching PCI device id structure
245
 * @drv: the PCI driver to match against
246
 * @dev: the PCI device structure to match against
247 248 249 250
 *
 * Used by a driver to check whether a PCI device present in the
 * system is in its list of supported devices.  Returns the matching
 * pci_device_id structure or %NULL if there is no match.
Linus Torvalds's avatar
Linus Torvalds committed
251
 */
252 253
static const struct pci_device_id *pci_match_device(struct pci_driver *drv,
						    struct pci_dev *dev)
254 255
{
	struct pci_dynid *dynid;
256 257 258 259 260
	const struct pci_device_id *found_id = NULL;

	/* When driver_override is set, only bind to the matching driver */
	if (dev->driver_override && strcmp(dev->driver_override, drv->name))
		return NULL;
Linus Torvalds's avatar
Linus Torvalds committed
261

262
	/* Look at the dynamic ids first, before the static ones */
263 264 265
	spin_lock(&drv->dynids.lock);
	list_for_each_entry(dynid, &drv->dynids.list, node) {
		if (pci_match_one_device(&dynid->id, dev)) {
266 267
			found_id = &dynid->id;
			break;
268
		}
Linus Torvalds's avatar
Linus Torvalds committed
269
	}
270
	spin_unlock(&drv->dynids.lock);
271

272 273 274 275 276 277 278 279
	if (!found_id)
		found_id = pci_match_id(drv->id_table, dev);

	/* driver_override will always match, send a dummy id */
	if (!found_id && dev->driver_override)
		found_id = &pci_device_id_any;

	return found_id;
Linus Torvalds's avatar
Linus Torvalds committed
280 281
}

282 283 284 285 286 287 288 289 290
struct drv_dev_and_id {
	struct pci_driver *drv;
	struct pci_dev *dev;
	const struct pci_device_id *id;
};

static long local_pci_probe(void *_ddi)
{
	struct drv_dev_and_id *ddi = _ddi;
291 292 293
	struct pci_dev *pci_dev = ddi->dev;
	struct pci_driver *pci_drv = ddi->drv;
	struct device *dev = &pci_dev->dev;
294 295
	int rc;

296 297 298 299
	/*
	 * Unbound PCI devices are always put in D0, regardless of
	 * runtime PM status.  During probe, the device is set to
	 * active and the usage count is incremented.  If the driver
300 301 302 303
	 * supports runtime PM, it should call pm_runtime_put_noidle(),
	 * or any other runtime PM helper function decrementing the usage
	 * count, in its probe routine and pm_runtime_get_noresume() in
	 * its remove routine.
304
	 */
305 306 307
	pm_runtime_get_sync(dev);
	pci_dev->driver = pci_drv;
	rc = pci_drv->probe(pci_dev, ddi->id);
308 309 310
	if (!rc)
		return rc;
	if (rc < 0) {
311 312
		pci_dev->driver = NULL;
		pm_runtime_put_sync(dev);
313
		return rc;
314
	}
315 316 317 318 319 320
	/*
	 * Probe function should return < 0 for failure, 0 for success
	 * Treat values > 0 as success, but warn.
	 */
	dev_warn(dev, "Driver probe function unexpectedly returned %d\n", rc);
	return 0;
321 322
}

323 324 325
static int pci_call_probe(struct pci_driver *drv, struct pci_dev *dev,
			  const struct pci_device_id *id)
{
326 327 328
	int error, node;
	struct drv_dev_and_id ddi = { drv, dev, id };

329 330 331 332 333
	/*
	 * Execute driver initialization on node where the device is
	 * attached.  This way the driver likely allocates its local memory
	 * on the right node.
	 */
334
	node = dev_to_node(&dev->dev);
335 336 337 338 339 340 341 342 343 344 345 346 347 348 349

	/*
	 * On NUMA systems, we are likely to call a PF probe function using
	 * work_on_cpu().  If that probe calls pci_enable_sriov() (which
	 * adds the VF devices via pci_bus_add_device()), we may re-enter
	 * this function to call the VF probe function.  Calling
	 * work_on_cpu() again will cause a lockdep warning.  Since VFs are
	 * always on the same node as the PF, we can work around this by
	 * avoiding work_on_cpu() when we're already on the correct node.
	 *
	 * Preemption is enabled, so it's theoretically unsafe to use
	 * numa_node_id(), but even if we run the probe function on the
	 * wrong node, it should be functionally correct.
	 */
	if (node >= 0 && node != numa_node_id()) {
350 351 352
		int cpu;

		get_online_cpus();
353
		cpu = cpumask_any_and(cpumask_of_node(node), cpu_online_mask);
354 355 356 357 358 359 360
		if (cpu < nr_cpu_ids)
			error = work_on_cpu(cpu, local_pci_probe, &ddi);
		else
			error = local_pci_probe(&ddi);
		put_online_cpus();
	} else
		error = local_pci_probe(&ddi);
361

362 363 364
	return error;
}

Linus Torvalds's avatar
Linus Torvalds committed
365
/**
366
 * __pci_device_probe - check if a driver wants to claim a specific PCI device
367 368
 * @drv: driver to call to check if it wants the PCI device
 * @pci_dev: PCI device being probed
369
 *
370
 * returns 0 on success, else error.
Linus Torvalds's avatar
Linus Torvalds committed
371 372
 * side-effect: pci_dev->driver is set to drv when drv claims pci_dev.
 */
Ryan Desfosses's avatar
Ryan Desfosses committed
373
static int __pci_device_probe(struct pci_driver *drv, struct pci_dev *pci_dev)
374 375
{
	const struct pci_device_id *id;
Linus Torvalds's avatar
Linus Torvalds committed
376 377 378
	int error = 0;

	if (!pci_dev->driver && drv->probe) {
379 380 381 382
		error = -ENODEV;

		id = pci_match_device(drv, pci_dev);
		if (id)
383
			error = pci_call_probe(drv, pci_dev, id);
384
		if (error >= 0)
385
			error = 0;
Linus Torvalds's avatar
Linus Torvalds committed
386 387 388 389
	}
	return error;
}

390 391 392 393 394 395 396 397 398
int __weak pcibios_alloc_irq(struct pci_dev *dev)
{
	return 0;
}

void __weak pcibios_free_irq(struct pci_dev *dev)
{
}

Ryan Desfosses's avatar
Ryan Desfosses committed
399
static int pci_device_probe(struct device *dev)
Linus Torvalds's avatar
Linus Torvalds committed
400
{
401 402 403 404 405 406 407
	int error;
	struct pci_dev *pci_dev = to_pci_dev(dev);
	struct pci_driver *drv = to_pci_driver(dev->driver);

	error = pcibios_alloc_irq(pci_dev);
	if (error < 0)
		return error;
Linus Torvalds's avatar
Linus Torvalds committed
408 409 410

	pci_dev_get(pci_dev);
	error = __pci_device_probe(drv, pci_dev);
411 412
	if (error) {
		pcibios_free_irq(pci_dev);
Linus Torvalds's avatar
Linus Torvalds committed
413
		pci_dev_put(pci_dev);
414
	}
Linus Torvalds's avatar
Linus Torvalds committed
415 416 417 418

	return error;
}

Ryan Desfosses's avatar
Ryan Desfosses committed
419
static int pci_device_remove(struct device *dev)
Linus Torvalds's avatar
Linus Torvalds committed
420
{
Ryan Desfosses's avatar
Ryan Desfosses committed
421 422
	struct pci_dev *pci_dev = to_pci_dev(dev);
	struct pci_driver *drv = pci_dev->driver;
Linus Torvalds's avatar
Linus Torvalds committed
423 424

	if (drv) {
425 426
		if (drv->remove) {
			pm_runtime_get_sync(dev);
Linus Torvalds's avatar
Linus Torvalds committed
427
			drv->remove(pci_dev);
428 429
			pm_runtime_put_noidle(dev);
		}
430
		pcibios_free_irq(pci_dev);
Linus Torvalds's avatar
Linus Torvalds committed
431 432 433
		pci_dev->driver = NULL;
	}

434
	/* Undo the runtime PM settings in local_pci_probe() */
435
	pm_runtime_put_sync(dev);
436

437 438 439 440 441 442 443
	/*
	 * If the device is still on, set the power state as "unknown",
	 * since it might change by the next time we load the driver.
	 */
	if (pci_dev->current_state == PCI_D0)
		pci_dev->current_state = PCI_UNKNOWN;

Linus Torvalds's avatar
Linus Torvalds committed
444 445 446 447
	/*
	 * We would love to complain here if pci_dev->is_enabled is set, that
	 * the driver should have called pci_disable_device(), but the
	 * unfortunate fact is there are too many odd BIOS and bridge setups
448
	 * that don't like drivers doing that all of the time.
Linus Torvalds's avatar
Linus Torvalds committed
449 450 451 452 453 454 455 456
	 * Oh well, we can dream of sane hardware when we sleep, no matter how
	 * horrible the crap we have to deal with is when we are awake...
	 */

	pci_dev_put(pci_dev);
	return 0;
}

457 458 459 460 461
static void pci_device_shutdown(struct device *dev)
{
	struct pci_dev *pci_dev = to_pci_dev(dev);
	struct pci_driver *drv = pci_dev->driver;

462 463
	pm_runtime_resume(dev);

464 465 466 467
	if (drv && drv->shutdown)
		drv->shutdown(pci_dev);
	pci_msi_shutdown(pci_dev);
	pci_msix_shutdown(pci_dev);
468

469
#ifdef CONFIG_KEXEC_CORE
470
	/*
471 472 473 474 475
	 * If this is a kexec reboot, turn off Bus Master bit on the
	 * device to tell it to not continue to do DMA. Don't touch
	 * devices in D3cold or unknown states.
	 * If it is not a kexec reboot, firmware will hit the PCI
	 * devices with big hammer and stop their DMA any way.
476
	 */
477
	if (kexec_in_progress && (pci_dev->current_state <= PCI_D3hot))
478
		pci_clear_master(pci_dev);
479
#endif
480 481
}

482
#ifdef CONFIG_PM
483 484 485 486 487 488 489 490 491 492 493 494 495 496 497 498 499

/* Auxiliary functions used for system resume and run-time resume. */

/**
 * pci_restore_standard_config - restore standard config registers of PCI device
 * @pci_dev: PCI device to handle
 */
static int pci_restore_standard_config(struct pci_dev *pci_dev)
{
	pci_update_current_state(pci_dev, PCI_UNKNOWN);

	if (pci_dev->current_state != PCI_D0) {
		int error = pci_set_power_state(pci_dev, PCI_D0);
		if (error)
			return error;
	}

500 501
	pci_restore_state(pci_dev);
	return 0;
502 503
}

504 505 506 507
#endif

#ifdef CONFIG_PM_SLEEP

508 509
static void pci_pm_default_resume_early(struct pci_dev *pci_dev)
{
510 511
	pci_power_up(pci_dev);
	pci_restore_state(pci_dev);
512 513 514
	pci_fixup_device(pci_fixup_resume_early, pci_dev);
}

515 516 517
/*
 * Default "suspend" method for devices that have no driver provided suspend,
 * or not even a driver at all (second part).
518
 */
519
static void pci_pm_set_unknown_state(struct pci_dev *pci_dev)
520 521 522 523 524 525 526 527 528
{
	/*
	 * mark its power state as "unknown", since we don't know if
	 * e.g. the BIOS will change its device state when we suspend.
	 */
	if (pci_dev->current_state == PCI_D0)
		pci_dev->current_state = PCI_UNKNOWN;
}

529 530 531 532
/*
 * Default "resume" method for devices that have no driver provided resume,
 * or not even a driver at all (second part).
 */
533
static int pci_pm_reenable_device(struct pci_dev *pci_dev)
534 535 536
{
	int retval;

537 538 539 540 541 542 543 544 545 546 547 548 549
	/* if the device was enabled before suspend, reenable */
	retval = pci_reenable_device(pci_dev);
	/*
	 * if the device was busmaster before the suspend, make it busmaster
	 * again
	 */
	if (pci_dev->is_busmaster)
		pci_set_master(pci_dev);

	return retval;
}

static int pci_legacy_suspend(struct device *dev, pm_message_t state)
Linus Torvalds's avatar
Linus Torvalds committed
550
{
Ryan Desfosses's avatar
Ryan Desfosses committed
551 552
	struct pci_dev *pci_dev = to_pci_dev(dev);
	struct pci_driver *drv = pci_dev->driver;
553

554
	if (drv && drv->suspend) {
555
		pci_power_t prev = pci_dev->current_state;
556
		int error;
557

558 559 560 561
		error = drv->suspend(pci_dev, state);
		suspend_report_result(drv->suspend, error);
		if (error)
			return error;
562

563
		if (!pci_dev->state_saved && pci_dev->current_state != PCI_D0
564 565 566 567 568
		    && pci_dev->current_state != PCI_UNKNOWN) {
			WARN_ONCE(pci_dev->current_state != prev,
				"PCI PM: Device state not saved by %pF\n",
				drv->suspend);
		}
569
	}
570 571 572

	pci_fixup_device(pci_fixup_suspend, pci_dev);

573
	return 0;
Linus Torvalds's avatar
Linus Torvalds committed
574 575
}

576
static int pci_legacy_suspend_late(struct device *dev, pm_message_t state)
577
{
Ryan Desfosses's avatar
Ryan Desfosses committed
578 579
	struct pci_dev *pci_dev = to_pci_dev(dev);
	struct pci_driver *drv = pci_dev->driver;
580 581

	if (drv && drv->suspend_late) {
582 583 584
		pci_power_t prev = pci_dev->current_state;
		int error;

585 586
		error = drv->suspend_late(pci_dev, state);
		suspend_report_result(drv->suspend_late, error);
587 588 589 590 591 592 593 594
		if (error)
			return error;

		if (!pci_dev->state_saved && pci_dev->current_state != PCI_D0
		    && pci_dev->current_state != PCI_UNKNOWN) {
			WARN_ONCE(pci_dev->current_state != prev,
				"PCI PM: Device state not saved by %pF\n",
				drv->suspend_late);
595
			goto Fixup;
596
		}
597
	}
598 599 600 601 602 603

	if (!pci_dev->state_saved)
		pci_save_state(pci_dev);

	pci_pm_set_unknown_state(pci_dev);

604 605 606
Fixup:
	pci_fixup_device(pci_fixup_suspend_late, pci_dev);

607
	return 0;
608
}
Linus Torvalds's avatar
Linus Torvalds committed
609

610 611
static int pci_legacy_resume_early(struct device *dev)
{
Ryan Desfosses's avatar
Ryan Desfosses committed
612 613
	struct pci_dev *pci_dev = to_pci_dev(dev);
	struct pci_driver *drv = pci_dev->driver;
614

615 616
	return drv && drv->resume_early ?
			drv->resume_early(pci_dev) : 0;
617 618
}

619
static int pci_legacy_resume(struct device *dev)
Linus Torvalds's avatar
Linus Torvalds committed
620
{
Ryan Desfosses's avatar
Ryan Desfosses committed
621 622
	struct pci_dev *pci_dev = to_pci_dev(dev);
	struct pci_driver *drv = pci_dev->driver;
Linus Torvalds's avatar
Linus Torvalds committed
623

624 625
	pci_fixup_device(pci_fixup_resume, pci_dev);

626 627
	return drv && drv->resume ?
			drv->resume(pci_dev) : pci_pm_reenable_device(pci_dev);
Linus Torvalds's avatar
Linus Torvalds committed
628 629
}

630 631
/* Auxiliary functions used by the new power management framework */

632
static void pci_pm_default_resume(struct pci_dev *pci_dev)
633
{
634 635
	pci_fixup_device(pci_fixup_resume, pci_dev);

636
	if (!pci_has_subordinate(pci_dev))
637
		pci_enable_wake(pci_dev, PCI_D0, false);
638 639
}

640
static void pci_pm_default_suspend(struct pci_dev *pci_dev)
641
{
642
	/* Disable non-bridge devices without PM support */
643
	if (!pci_has_subordinate(pci_dev))
644
		pci_disable_enabled_device(pci_dev);
645 646
}

647 648 649
static bool pci_has_legacy_pm_support(struct pci_dev *pci_dev)
{
	struct pci_driver *drv = pci_dev->driver;
650
	bool ret = drv && (drv->suspend || drv->suspend_late || drv->resume
651
		|| drv->resume_early);
652 653 654 655 656 657

	/*
	 * Legacy PM support is used by default, so warn if the new framework is
	 * supported as well.  Drivers are supposed to support either the
	 * former, or the latter, but not both at the same time.
	 */
658 659
	WARN(ret && drv->driver.pm, "driver %s device %04x:%04x\n",
		drv->name, pci_dev->vendor, pci_dev->device);
660 661

	return ret;
662 663
}

664 665
/* New power management framework */

666 667 668 669
static int pci_pm_prepare(struct device *dev)
{
	struct device_driver *drv = dev->driver;

670
	/*
671 672
	 * Devices having power.ignore_children set may still be necessary for
	 * suspending their children in the next phase of device suspend.
673
	 */
674 675
	if (dev->power.ignore_children)
		pm_runtime_resume(dev);
676

677 678 679 680 681 682
	if (drv && drv->pm && drv->pm->prepare) {
		int error = drv->pm->prepare(dev);
		if (error)
			return error;
	}
	return pci_dev_keep_suspended(to_pci_dev(dev));
683 684
}

685 686
static void pci_pm_complete(struct device *dev)
{
687
	pci_dev_complete_resume(to_pci_dev(dev));
688
	pm_complete_with_resume_check(dev);
689
}
690

691 692 693
#else /* !CONFIG_PM_SLEEP */

#define pci_pm_prepare	NULL
694
#define pci_pm_complete	NULL
695 696 697

#endif /* !CONFIG_PM_SLEEP */

698 699 700 701 702
#ifdef CONFIG_SUSPEND

static int pci_pm_suspend(struct device *dev)
{
	struct pci_dev *pci_dev = to_pci_dev(dev);
703
	const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
704

705 706
	if (pci_has_legacy_pm_support(pci_dev))
		return pci_legacy_suspend(dev, PMSG_SUSPEND);
707

708 709 710 711 712
	if (!pm) {
		pci_pm_default_suspend(pci_dev);
		goto Fixup;
	}

713 714 715 716 717 718 719 720 721 722
	/*
	 * PCI devices suspended at run time need to be resumed at this point,
	 * because in general it is necessary to reconfigure them for system
	 * suspend.  Namely, if the device is supposed to wake up the system
	 * from the sleep state, we may need to reconfigure it for this purpose.
	 * In turn, if the device is not supposed to wake up the system from the
	 * sleep state, we'll have to prevent it from signaling wake-up.
	 */
	pm_runtime_resume(dev);

723
	pci_dev->state_saved = false;
724 725 726 727
	if (pm->suspend) {
		pci_power_t prev = pci_dev->current_state;
		int error;

728 729
		error = pm->suspend(dev);
		suspend_report_result(pm->suspend, error);
730 731 732
		if (error)
			return error;

733
		if (!pci_dev->state_saved && pci_dev->current_state != PCI_D0
734 735 736 737 738
		    && pci_dev->current_state != PCI_UNKNOWN) {
			WARN_ONCE(pci_dev->current_state != prev,
				"PCI PM: State of device not saved by %pF\n",
				pm->suspend);
		}
739
	}
740

741 742 743 744
 Fixup:
	pci_fixup_device(pci_fixup_suspend, pci_dev);

	return 0;
745 746 747
}

static int pci_pm_suspend_noirq(struct device *dev)
748
{
749
	struct pci_dev *pci_dev = to_pci_dev(dev);
750
	const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
751

752 753 754
	if (pci_has_legacy_pm_support(pci_dev))
		return pci_legacy_suspend_late(dev, PMSG_SUSPEND);

755 756
	if (!pm) {
		pci_save_state(pci_dev);
757
		goto Fixup;
758
	}
759 760 761 762 763 764 765 766 767 768 769 770 771 772 773

	if (pm->suspend_noirq) {
		pci_power_t prev = pci_dev->current_state;
		int error;

		error = pm->suspend_noirq(dev);
		suspend_report_result(pm->suspend_noirq, error);
		if (error)
			return error;

		if (!pci_dev->state_saved && pci_dev->current_state != PCI_D0
		    && pci_dev->current_state != PCI_UNKNOWN) {
			WARN_ONCE(pci_dev->current_state != prev,
				"PCI PM: State of device not saved by %pF\n",
				pm->suspend_noirq);
774
			goto Fixup;
775
		}
776 777
	}

778 779
	if (!pci_dev->state_saved) {
		pci_save_state(pci_dev);
780
		if (pci_power_manageable(pci_dev))
781 782
			pci_prepare_to_sleep(pci_dev);
	}
783

784 785
	pci_pm_set_unknown_state(pci_dev);

786 787 788 789 790 791 792 793 794 795 796 797
	/*
	 * Some BIOSes from ASUS have a bug: If a USB EHCI host controller's
	 * PCI COMMAND register isn't 0, the BIOS assumes that the controller
	 * hasn't been quiesced and tries to turn it off.  If the controller
	 * is already in D3, this can hang or cause memory corruption.
	 *
	 * Since the value of the COMMAND register doesn't matter once the
	 * device has been suspended, we can safely set it to 0 here.
	 */
	if (pci_dev->class == PCI_CLASS_SERIAL_USB_EHCI)
		pci_write_config_word(pci_dev, PCI_COMMAND, 0);

798 799 800
Fixup:
	pci_fixup_device(pci_fixup_suspend_late, pci_dev);

801
	return 0;
802
}
Linus Torvalds's avatar
Linus Torvalds committed
803

804
static int pci_pm_resume_noirq(struct device *dev)
805 806 807
{
	struct pci_dev *pci_dev = to_pci_dev(dev);
	struct device_driver *drv = dev->driver;
808
	int error = 0;
809

810
	pci_pm_default_resume_early(pci_dev);
811

812
	if (pci_has_legacy_pm_support(pci_dev))
813
		return pci_legacy_resume_early(dev);
814

815 816
	if (drv && drv->pm && drv->pm->resume_noirq)
		error = drv->pm->resume_noirq(dev);
817 818 819 820

	return error;
}

821
static int pci_pm_resume(struct device *dev)
822
{
823
	struct pci_dev *pci_dev = to_pci_dev(dev);
824
	const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
825 826
	int error = 0;

827 828 829 830 831 832 833
	/*
	 * This is necessary for the suspend error path in which resume is
	 * called without restoring the standard config registers of the device.
	 */
	if (pci_dev->state_saved)
		pci_restore_standard_config(pci_dev);

834
	if (pci_has_legacy_pm_support(pci_dev))
835
		return pci_legacy_resume(dev);
836

837
	pci_pm_default_resume(pci_dev);
838

839 840 841 842 843 844
	if (pm) {
		if (pm->resume)
			error = pm->resume(dev);
	} else {
		pci_pm_reenable_device(pci_dev);
	}
845

846
	return error;
847 848 849 850 851 852 853 854 855 856 857
}

#else /* !CONFIG_SUSPEND */

#define pci_pm_suspend		NULL
#define pci_pm_suspend_noirq	NULL
#define pci_pm_resume		NULL
#define pci_pm_resume_noirq	NULL

#endif /* !CONFIG_SUSPEND */

858
#ifdef CONFIG_HIBERNATE_CALLBACKS
859

860 861 862 863 864 865 866

/*
 * pcibios_pm_ops - provide arch-specific hooks when a PCI device is doing
 * a hibernate transition
 */
struct dev_pm_ops __weak pcibios_pm_ops;

867 868 869
static int pci_pm_freeze(struct device *dev)
{
	struct pci_dev *pci_dev = to_pci_dev(dev);
870
	const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
871

872 873
	if (pci_has_legacy_pm_support(pci_dev))
		return pci_legacy_suspend(dev, PMSG_FREEZE);
874

875 876 877
	if (!pm) {
		pci_pm_default_suspend(pci_dev);
		return 0;
878 879
	}

880 881 882 883 884 885 886 887
	/*
	 * This used to be done in pci_pm_prepare() for all devices and some
	 * drivers may depend on it, so do it here.  Ideally, runtime-suspended
	 * devices should not be touched during freeze/thaw transitions,
	 * however.
	 */
	pm_runtime_resume(dev);

888
	pci_dev->state_saved = false;
889 890 891 892 893 894 895 896 897
	if (pm->freeze) {
		int error;

		error = pm->freeze(dev);
		suspend_report_result(pm->freeze, error);
		if (error)
			return error;
	}

898 899 900
	if (pcibios_pm_ops.freeze)
		return pcibios_pm_ops.freeze(dev);

901
	return 0;
902 903 904 905
}

static int pci_pm_freeze_noirq(struct device *dev)
{
906
	struct pci_dev *pci_dev = to_pci_dev(dev);
907
	struct device_driver *drv = dev->driver;
908

909 910 911
	if (pci_has_legacy_pm_support(pci_dev))
		return pci_legacy_suspend_late(dev, PMSG_FREEZE);

912
	if (drv && drv->pm && drv->pm->freeze_noirq) {
913 914
		int error;

915 916
		error = drv->pm->freeze_noirq(dev);
		suspend_report_result(drv->pm->freeze_noirq, error);
917 918
		if (error)
			return error;
919 920
	}

921 922
	if (!pci_dev->state_saved)
		pci_save_state(pci_dev);
923

924 925
	pci_pm_set_unknown_state(pci_dev);

926 927 928
	if (pcibios_pm_ops.freeze_noirq)
		return pcibios_pm_ops.freeze_noirq(dev);

929
	return 0;
930 931
}

932
static int pci_pm_thaw_noirq(struct device *dev)
933
{
934
	struct pci_dev *pci_dev = to_pci_dev(dev);
935 936 937
	struct device_driver *drv = dev->driver;
	int error = 0;

938 939 940 941 942 943
	if (pcibios_pm_ops.thaw_noirq) {
		error = pcibios_pm_ops.thaw_noirq(dev);
		if (error)
			return error;
	}

944
	if (pci_has_legacy_pm_support(pci_dev))
945
		return pci_legacy_resume_early(dev);
946

947
	pci_update_current_state(pci_dev, PCI_D0);
948

949 950
	if (drv && drv->pm && drv->pm->thaw_noirq)
		error = drv->pm->thaw_noirq(dev);
951 952 953 954

	return error;
}

955
static int pci_pm_thaw(struct device *dev)
956
{
957
	struct pci_dev *pci_dev = to_pci_dev(dev);
958
	const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
959 960
	int error = 0;

961 962 963 964 965 966
	if (pcibios_pm_ops.thaw) {
		error = pcibios_pm_ops.thaw(dev);
		if (error)
			return error;
	}

967
	if (pci_has_legacy_pm_support(pci_dev))
968
		return pci_legacy_resume(dev);
969

970 971 972 973 974 975
	if (pm) {
		if (pm->thaw)
			error = pm->thaw(dev);
	} else {
		pci_pm_reenable_device(pci_dev);
	}
976

977 978
	pci_dev->state_saved = false;

979 980 981 982 983
	return error;
}

static int pci_pm_poweroff(struct device *dev)
{
984
	struct pci_dev *pci_dev = to_pci_dev(dev);
985
	const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
986

987 988
	if (pci_has_legacy_pm_support(pci_dev))
		return pci_legacy_suspend(dev, PMSG_HIBERNATE);
989

990 991 992 993 994
	if (!pm) {
		pci_pm_default_suspend(pci_dev);
		goto Fixup;
	}

995 996 997
	/* The reason to do that is the same as in pci_pm_suspend(). */
	pm_runtime_resume(dev);

998
	pci_dev->state_saved = false;
999
	if (pm->poweroff) {
1000 1001
		int error;

1002 1003
		error = pm->poweroff(dev);
		suspend_report_result(pm->poweroff, error);
1004 1005
		if (error)
			return error;
1006 1007
	}

1008 1009
 Fixup:
	pci_fixup_device(pci_fixup_suspend, pci_dev);
1010

1011 1012 1013
	if (pcibios_pm_ops.poweroff)
		return pcibios_pm_ops.poweroff(dev);

1014
	return 0;
1015 1016 1017 1018
}

static int pci_pm_poweroff_noirq(struct device *dev)
{
1019
	struct pci_dev *pci_dev = to_pci_dev(dev);
1020
	struct device_driver *drv = dev->driver;
1021

1022 1023 1024
	if (pci_has_legacy_pm_support(to_pci_dev(dev)))
		return pci_legacy_suspend_late(dev, PMSG_HIBERNATE);

1025 1026
	if (!drv || !drv->pm) {
		pci_fixup_device(pci_fixup_suspend_late, pci_dev);
1027
		return 0;
1028
	}
1029 1030 1031 1032

	if (drv->pm->poweroff_noirq) {
		int error;

1033 1034
		error = drv->pm->poweroff_noirq(dev);
		suspend_report_result(drv->pm->poweroff_noirq, error);
1035 1036
		if (error)
			return error;
1037 1038
	}

1039
	if (!pci_dev->state_saved && !pci_has_subordinate(pci_dev))
1040 1041
		pci_prepare_to_sleep(pci_dev);

1042 1043 1044 1045 1046 1047 1048
	/*
	 * The reason for doing this here is the same as for the analogous code
	 * in pci_pm_suspend_noirq().
	 */
	if (pci_dev->class == PCI_CLASS_SERIAL_USB_EHCI)
		pci_write_config_word(pci_dev, PCI_COMMAND, 0);

1049 1050
	pci_fixup_device(pci_fixup_suspend_late, pci_dev);

1051 1052 1053
	if (pcibios_pm_ops.poweroff_noirq)
		return pcibios_pm_ops.poweroff_noirq(dev);

1054
	return 0;
1055 1056
}

1057
static int pci_pm_restore_noirq(struct device *dev)
1058 1059 1060
{
	struct pci_dev *pci_dev = to_pci_dev(dev);
	struct device_driver *drv = dev->driver;
1061
	int error = 0;
1062

1063 1064 1065 1066 1067 1068
	if (pcibios_pm_ops.restore_noirq) {
		error = pcibios_pm_ops.restore_noirq(dev);
		if (error)
			return error;
	}

1069
	pci_pm_default_resume_early(pci_dev);
1070

1071
	if (pci_has_legacy_pm_support(pci_dev))
1072
		return pci_legacy_resume_early(dev);
1073

1074 1075
	if (drv && drv->pm && drv->pm->restore_noirq)
		error = drv->pm->restore_noirq(dev);
1076 1077 1078 1079

	return error;
}

1080
static int pci_pm_restore(struct device *dev)
1081 1082
{
	struct pci_dev *pci_dev = to_pci_dev(dev);
1083
	const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
1084 1085
	int error = 0;

1086 1087 1088 1089 1090 1091
	if (pcibios_pm_ops.restore) {
		error = pcibios_pm_ops.restore(dev);
		if (error)
			return error;
	}

1092 1093 1094 1095 1096 1097 1098
	/*
	 * This is necessary for the hibernation error path in which restore is
	 * called without restoring the standard config registers of the device.
	 */
	if (pci_dev->state_saved)
		pci_restore_standard_config(pci_dev);

1099
	if (pci_has_legacy_pm_support(pci_dev))
1100
		return pci_legacy_resume(dev);
1101

1102
	pci_pm_default_resume(pci_dev);
1103

1104 1105 1106 1107 1108 1109
	if (pm) {
		if (pm->restore)
			error = pm->restore(dev);
	} else {
		pci_pm_reenable_device(pci_dev);
	}
1110 1111

	return error;
1112
}
Linus Torvalds's avatar
Linus Torvalds committed
1113

1114
#else /* !CONFIG_HIBERNATE_CALLBACKS */
1115 1116 1117 1118 1119 1120 1121 1122 1123 1124

#define pci_pm_freeze		NULL
#define pci_pm_freeze_noirq	NULL
#define pci_pm_thaw		NULL
#define pci_pm_thaw_noirq	NULL
#define pci_pm_poweroff		NULL
#define pci_pm_poweroff_noirq	NULL
#define pci_pm_restore		NULL
#define pci_pm_restore_noirq	NULL

1125
#endif /* !CONFIG_HIBERNATE_CALLBACKS */
1126

1127
#ifdef CONFIG_PM
1128 1129 1130 1131 1132 1133 1134 1135

static int pci_pm_runtime_suspend(struct device *dev)
{
	struct pci_dev *pci_dev = to_pci_dev(dev);
	const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
	pci_power_t prev = pci_dev->current_state;
	int error;

1136 1137 1138 1139 1140 1141 1142
	/*
	 * If pci_dev->driver is not set (unbound), the device should
	 * always remain in D0 regardless of the runtime PM status
	 */
	if (!pci_dev->driver)
		return 0;

1143 1144 1145
	if (!pm || !pm->runtime_suspend)
		return -ENOSYS;

1146
	pci_dev->state_saved = false;
1147
	error = pm->runtime_suspend(dev);
1148 1149 1150 1151 1152 1153 1154 1155 1156 1157 1158 1159 1160
	if (error) {
		/*
		 * -EBUSY and -EAGAIN is used to request the runtime PM core
		 * to schedule a new suspend, so log the event only with debug
		 * log level.
		 */
		if (error == -EBUSY || error == -EAGAIN)
			dev_dbg(dev, "can't suspend now (%pf returned %d)\n",
				pm->runtime_suspend, error);
		else
			dev_err(dev, "can't suspend (%pf returned %d)\n",
				pm->runtime_suspend, error);

1161
		return error;
1162
	}
1163 1164 1165 1166 1167 1168 1169 1170 1171 1172 1173

	pci_fixup_device(pci_fixup_suspend, pci_dev);

	if (!pci_dev->state_saved && pci_dev->current_state != PCI_D0
	    && pci_dev->current_state != PCI_UNKNOWN) {
		WARN_ONCE(pci_dev->current_state != prev,
			"PCI PM: State of device not saved by %pF\n",
			pm->runtime_suspend);
		return 0;
	}

1174
	if (!pci_dev->state_saved) {
1175
		pci_save_state(pci_dev);
1176 1177
		pci_finish_runtime_suspend(pci_dev);
	}
1178 1179 1180 1181 1182 1183

	return 0;
}

static int pci_pm_runtime_resume(struct device *dev)
{
1184
	int rc;
1185 1186 1187
	struct pci_dev *pci_dev = to_pci_dev(dev);
	const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;

1188 1189 1190 1191 1192 1193 1194
	/*
	 * If pci_dev->driver is not set (unbound), the device should
	 * always remain in D0 regardless of the runtime PM status
	 */
	if (!pci_dev->driver)
		return 0;

1195 1196 1197
	if (!pm || !pm->runtime_resume)
		return -ENOSYS;

1198 1199
	pci_restore_standard_config(pci_dev);
	pci_fixup_device(pci_fixup_resume_early, pci_dev);
1200 1201 1202
	__pci_enable_wake(pci_dev, PCI_D0, true, false);
	pci_fixup_device(pci_fixup_resume, pci_dev);

1203 1204 1205 1206 1207
	rc = pm->runtime_resume(dev);

	pci_dev->runtime_d3cold = false;

	return rc;
1208 1209 1210 1211
}

static int pci_pm_runtime_idle(struct device *dev)
{
1212
	struct pci_dev *pci_dev = to_pci_dev(dev);
1213
	const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
1214
	int ret = 0;
1215

1216 1217 1218 1219 1220
	/*
	 * If pci_dev->driver is not set (unbound), the device should
	 * always remain in D0 regardless of the runtime PM status
	 */
	if (!pci_dev->driver)
1221
		return 0;
1222

1223 1224 1225
	if (!pm)
		return -ENOSYS;

1226 1227
	if (pm->runtime_idle)
		ret = pm->runtime_idle(dev);
1228

1229
	return ret;
1230 1231
}

1232
static const struct dev_pm_ops pci_dev_pm_ops = {
1233
	.prepare = pci_pm_prepare,
1234
	.complete = pci_pm_complete,
1235 1236 1237 1238 1239 1240
	.suspend = pci_pm_suspend,
	.resume = pci_pm_resume,
	.freeze = pci_pm_freeze,
	.thaw = pci_pm_thaw,
	.poweroff = pci_pm_poweroff,
	.restore = pci_pm_restore,
1241 1242 1243 1244 1245 1246
	.suspend_noirq = pci_pm_suspend_noirq,
	.resume_noirq = pci_pm_resume_noirq,
	.freeze_noirq = pci_pm_freeze_noirq,
	.thaw_noirq = pci_pm_thaw_noirq,
	.poweroff_noirq = pci_pm_poweroff_noirq,
	.restore_noirq = pci_pm_restore_noirq,
1247 1248 1249
	.runtime_suspend = pci_pm_runtime_suspend,
	.runtime_resume = pci_pm_runtime_resume,
	.runtime_idle = pci_pm_runtime_idle,
1250 1251
};

1252
#define PCI_PM_OPS_PTR	(&pci_dev_pm_ops)
1253

1254 1255 1256 1257 1258
#else /* !CONFIG_PM */

#define pci_pm_runtime_suspend	NULL
#define pci_pm_runtime_resume	NULL
#define pci_pm_runtime_idle	NULL
1259 1260 1261

#define PCI_PM_OPS_PTR	NULL

1262
#endif /* !CONFIG_PM */
1263

Linus Torvalds's avatar
Linus Torvalds committed
1264
/**
1265
 * __pci_register_driver - register a new pci driver
Linus Torvalds's avatar
Linus Torvalds committed
1266
 * @drv: the driver structure to register
1267
 * @owner: owner module of drv
1268
 * @mod_name: module name string
1269
 *
Linus Torvalds's avatar
Linus Torvalds committed
1270
 * Adds the driver structure to the list of registered drivers.
1271 1272
 * Returns a negative value on error, otherwise 0.
 * If no error occurred, the driver remains registered even if
Linus Torvalds's avatar
Linus Torvalds committed
1273 1274
 * no device was claimed during registration.
 */
1275 1276
int __pci_register_driver(struct pci_driver *drv, struct module *owner,
			  const char *mod_name)
Linus Torvalds's avatar
Linus Torvalds committed
1277 1278 1279 1280
{
	/* initialize common driver fields */
	drv->driver.name = drv->name;
	drv->driver.bus = &pci_bus_type;
1281
	drv->driver.owner = owner;
1282
	drv->driver.mod_name = mod_name;
Alan Cox's avatar
Alan Cox committed
1283

1284 1285
	spin_lock_init(&drv->dynids.lock);
	INIT_LIST_HEAD(&drv->dynids.list);
Linus Torvalds's avatar
Linus Torvalds committed
1286 1287

	/* register with core */
1288
	return driver_register(&drv->driver);
Linus Torvalds's avatar
Linus Torvalds committed
1289
}
1290
EXPORT_SYMBOL(__pci_register_driver);
Linus Torvalds's avatar
Linus Torvalds committed
1291 1292 1293 1294

/**
 * pci_unregister_driver - unregister a pci driver
 * @drv: the driver structure to unregister
1295
 *
Linus Torvalds's avatar
Linus Torvalds committed
1296 1297 1298 1299 1300 1301
 * Deletes the driver structure from the list of registered PCI drivers,
 * gives it a chance to clean up by calling its remove() function for
 * each device it was responsible for, and marks those devices as
 * driverless.
 */

Ryan Desfosses's avatar
Ryan Desfosses committed
1302
void pci_unregister_driver(struct pci_driver *drv)
Linus Torvalds's avatar
Linus Torvalds committed
1303 1304 1305 1306
{
	driver_unregister(&drv->driver);
	pci_free_dynids(drv);
}
1307
EXPORT_SYMBOL(pci_unregister_driver);