pci-driver.c 36 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454
  1. /*
  2. * drivers/pci/pci-driver.c
  3. *
  4. * (C) Copyright 2002-2004, 2007 Greg Kroah-Hartman <greg@kroah.com>
  5. * (C) Copyright 2007 Novell Inc.
  6. *
  7. * Released under the GPL v2 only.
  8. *
  9. */
  10. #include <linux/pci.h>
  11. #include <linux/module.h>
  12. #include <linux/init.h>
  13. #include <linux/device.h>
  14. #include <linux/mempolicy.h>
  15. #include <linux/string.h>
  16. #include <linux/slab.h>
  17. #include <linux/sched.h>
  18. #include <linux/cpu.h>
  19. #include <linux/pm_runtime.h>
  20. #include <linux/suspend.h>
  21. #include <linux/kexec.h>
  22. #include "pci.h"
  23. struct pci_dynid {
  24. struct list_head node;
  25. struct pci_device_id id;
  26. };
  27. /**
  28. * pci_add_dynid - add a new PCI device ID to this driver and re-probe devices
  29. * @drv: target pci driver
  30. * @vendor: PCI vendor ID
  31. * @device: PCI device ID
  32. * @subvendor: PCI subvendor ID
  33. * @subdevice: PCI subdevice ID
  34. * @class: PCI class
  35. * @class_mask: PCI class mask
  36. * @driver_data: private driver data
  37. *
  38. * Adds a new dynamic pci device ID to this driver and causes the
  39. * driver to probe for all devices again. @drv must have been
  40. * registered prior to calling this function.
  41. *
  42. * CONTEXT:
  43. * Does GFP_KERNEL allocation.
  44. *
  45. * RETURNS:
  46. * 0 on success, -errno on failure.
  47. */
  48. int pci_add_dynid(struct pci_driver *drv,
  49. unsigned int vendor, unsigned int device,
  50. unsigned int subvendor, unsigned int subdevice,
  51. unsigned int class, unsigned int class_mask,
  52. unsigned long driver_data)
  53. {
  54. struct pci_dynid *dynid;
  55. dynid = kzalloc(sizeof(*dynid), GFP_KERNEL);
  56. if (!dynid)
  57. return -ENOMEM;
  58. dynid->id.vendor = vendor;
  59. dynid->id.device = device;
  60. dynid->id.subvendor = subvendor;
  61. dynid->id.subdevice = subdevice;
  62. dynid->id.class = class;
  63. dynid->id.class_mask = class_mask;
  64. dynid->id.driver_data = driver_data;
  65. spin_lock(&drv->dynids.lock);
  66. list_add_tail(&dynid->node, &drv->dynids.list);
  67. spin_unlock(&drv->dynids.lock);
  68. return driver_attach(&drv->driver);
  69. }
  70. EXPORT_SYMBOL_GPL(pci_add_dynid);
  71. static void pci_free_dynids(struct pci_driver *drv)
  72. {
  73. struct pci_dynid *dynid, *n;
  74. spin_lock(&drv->dynids.lock);
  75. list_for_each_entry_safe(dynid, n, &drv->dynids.list, node) {
  76. list_del(&dynid->node);
  77. kfree(dynid);
  78. }
  79. spin_unlock(&drv->dynids.lock);
  80. }
  81. /**
  82. * store_new_id - sysfs frontend to pci_add_dynid()
  83. * @driver: target device driver
  84. * @buf: buffer for scanning device ID data
  85. * @count: input size
  86. *
  87. * Allow PCI IDs to be added to an existing driver via sysfs.
  88. */
  89. static ssize_t store_new_id(struct device_driver *driver, const char *buf,
  90. size_t count)
  91. {
  92. struct pci_driver *pdrv = to_pci_driver(driver);
  93. const struct pci_device_id *ids = pdrv->id_table;
  94. __u32 vendor, device, subvendor = PCI_ANY_ID,
  95. subdevice = PCI_ANY_ID, class = 0, class_mask = 0;
  96. unsigned long driver_data = 0;
  97. int fields = 0;
  98. int retval = 0;
  99. fields = sscanf(buf, "%x %x %x %x %x %x %lx",
  100. &vendor, &device, &subvendor, &subdevice,
  101. &class, &class_mask, &driver_data);
  102. if (fields < 2)
  103. return -EINVAL;
  104. if (fields != 7) {
  105. struct pci_dev *pdev = kzalloc(sizeof(*pdev), GFP_KERNEL);
  106. if (!pdev)
  107. return -ENOMEM;
  108. pdev->vendor = vendor;
  109. pdev->device = device;
  110. pdev->subsystem_vendor = subvendor;
  111. pdev->subsystem_device = subdevice;
  112. pdev->class = class;
  113. if (pci_match_id(pdrv->id_table, pdev))
  114. retval = -EEXIST;
  115. kfree(pdev);
  116. if (retval)
  117. return retval;
  118. }
  119. /* Only accept driver_data values that match an existing id_table
  120. entry */
  121. if (ids) {
  122. retval = -EINVAL;
  123. while (ids->vendor || ids->subvendor || ids->class_mask) {
  124. if (driver_data == ids->driver_data) {
  125. retval = 0;
  126. break;
  127. }
  128. ids++;
  129. }
  130. if (retval) /* No match */
  131. return retval;
  132. }
  133. retval = pci_add_dynid(pdrv, vendor, device, subvendor, subdevice,
  134. class, class_mask, driver_data);
  135. if (retval)
  136. return retval;
  137. return count;
  138. }
  139. static DRIVER_ATTR(new_id, S_IWUSR, NULL, store_new_id);
  140. /**
  141. * store_remove_id - remove a PCI device ID from this driver
  142. * @driver: target device driver
  143. * @buf: buffer for scanning device ID data
  144. * @count: input size
  145. *
  146. * Removes a dynamic pci device ID to this driver.
  147. */
  148. static ssize_t store_remove_id(struct device_driver *driver, const char *buf,
  149. size_t count)
  150. {
  151. struct pci_dynid *dynid, *n;
  152. struct pci_driver *pdrv = to_pci_driver(driver);
  153. __u32 vendor, device, subvendor = PCI_ANY_ID,
  154. subdevice = PCI_ANY_ID, class = 0, class_mask = 0;
  155. int fields = 0;
  156. size_t retval = -ENODEV;
  157. fields = sscanf(buf, "%x %x %x %x %x %x",
  158. &vendor, &device, &subvendor, &subdevice,
  159. &class, &class_mask);
  160. if (fields < 2)
  161. return -EINVAL;
  162. spin_lock(&pdrv->dynids.lock);
  163. list_for_each_entry_safe(dynid, n, &pdrv->dynids.list, node) {
  164. struct pci_device_id *id = &dynid->id;
  165. if ((id->vendor == vendor) &&
  166. (id->device == device) &&
  167. (subvendor == PCI_ANY_ID || id->subvendor == subvendor) &&
  168. (subdevice == PCI_ANY_ID || id->subdevice == subdevice) &&
  169. !((id->class ^ class) & class_mask)) {
  170. list_del(&dynid->node);
  171. kfree(dynid);
  172. retval = count;
  173. break;
  174. }
  175. }
  176. spin_unlock(&pdrv->dynids.lock);
  177. return retval;
  178. }
  179. static DRIVER_ATTR(remove_id, S_IWUSR, NULL, store_remove_id);
  180. static struct attribute *pci_drv_attrs[] = {
  181. &driver_attr_new_id.attr,
  182. &driver_attr_remove_id.attr,
  183. NULL,
  184. };
  185. ATTRIBUTE_GROUPS(pci_drv);
  186. /**
  187. * pci_match_id - See if a pci device matches a given pci_id table
  188. * @ids: array of PCI device id structures to search in
  189. * @dev: the PCI device structure to match against.
  190. *
  191. * Used by a driver to check whether a PCI device present in the
  192. * system is in its list of supported devices. Returns the matching
  193. * pci_device_id structure or %NULL if there is no match.
  194. *
  195. * Deprecated, don't use this as it will not catch any dynamic ids
  196. * that a driver might want to check for.
  197. */
  198. const struct pci_device_id *pci_match_id(const struct pci_device_id *ids,
  199. struct pci_dev *dev)
  200. {
  201. if (ids) {
  202. while (ids->vendor || ids->subvendor || ids->class_mask) {
  203. if (pci_match_one_device(ids, dev))
  204. return ids;
  205. ids++;
  206. }
  207. }
  208. return NULL;
  209. }
  210. EXPORT_SYMBOL(pci_match_id);
  211. static const struct pci_device_id pci_device_id_any = {
  212. .vendor = PCI_ANY_ID,
  213. .device = PCI_ANY_ID,
  214. .subvendor = PCI_ANY_ID,
  215. .subdevice = PCI_ANY_ID,
  216. };
  217. /**
  218. * pci_match_device - Tell if a PCI device structure has a matching PCI device id structure
  219. * @drv: the PCI driver to match against
  220. * @dev: the PCI device structure to match against
  221. *
  222. * Used by a driver to check whether a PCI device present in the
  223. * system is in its list of supported devices. Returns the matching
  224. * pci_device_id structure or %NULL if there is no match.
  225. */
  226. static const struct pci_device_id *pci_match_device(struct pci_driver *drv,
  227. struct pci_dev *dev)
  228. {
  229. struct pci_dynid *dynid;
  230. const struct pci_device_id *found_id = NULL;
  231. /* When driver_override is set, only bind to the matching driver */
  232. if (dev->driver_override && strcmp(dev->driver_override, drv->name))
  233. return NULL;
  234. /* Look at the dynamic ids first, before the static ones */
  235. spin_lock(&drv->dynids.lock);
  236. list_for_each_entry(dynid, &drv->dynids.list, node) {
  237. if (pci_match_one_device(&dynid->id, dev)) {
  238. found_id = &dynid->id;
  239. break;
  240. }
  241. }
  242. spin_unlock(&drv->dynids.lock);
  243. if (!found_id)
  244. found_id = pci_match_id(drv->id_table, dev);
  245. /* driver_override will always match, send a dummy id */
  246. if (!found_id && dev->driver_override)
  247. found_id = &pci_device_id_any;
  248. return found_id;
  249. }
  250. struct drv_dev_and_id {
  251. struct pci_driver *drv;
  252. struct pci_dev *dev;
  253. const struct pci_device_id *id;
  254. };
  255. static long local_pci_probe(void *_ddi)
  256. {
  257. struct drv_dev_and_id *ddi = _ddi;
  258. struct pci_dev *pci_dev = ddi->dev;
  259. struct pci_driver *pci_drv = ddi->drv;
  260. struct device *dev = &pci_dev->dev;
  261. int rc;
  262. /*
  263. * Unbound PCI devices are always put in D0, regardless of
  264. * runtime PM status. During probe, the device is set to
  265. * active and the usage count is incremented. If the driver
  266. * supports runtime PM, it should call pm_runtime_put_noidle(),
  267. * or any other runtime PM helper function decrementing the usage
  268. * count, in its probe routine and pm_runtime_get_noresume() in
  269. * its remove routine.
  270. */
  271. pm_runtime_get_sync(dev);
  272. pci_dev->driver = pci_drv;
  273. rc = pci_drv->probe(pci_dev, ddi->id);
  274. if (!rc)
  275. return rc;
  276. if (rc < 0) {
  277. pci_dev->driver = NULL;
  278. pm_runtime_put_sync(dev);
  279. return rc;
  280. }
  281. /*
  282. * Probe function should return < 0 for failure, 0 for success
  283. * Treat values > 0 as success, but warn.
  284. */
  285. dev_warn(dev, "Driver probe function unexpectedly returned %d\n", rc);
  286. return 0;
  287. }
  288. static int pci_call_probe(struct pci_driver *drv, struct pci_dev *dev,
  289. const struct pci_device_id *id)
  290. {
  291. int error, node;
  292. struct drv_dev_and_id ddi = { drv, dev, id };
  293. /*
  294. * Execute driver initialization on node where the device is
  295. * attached. This way the driver likely allocates its local memory
  296. * on the right node.
  297. */
  298. node = dev_to_node(&dev->dev);
  299. /*
  300. * On NUMA systems, we are likely to call a PF probe function using
  301. * work_on_cpu(). If that probe calls pci_enable_sriov() (which
  302. * adds the VF devices via pci_bus_add_device()), we may re-enter
  303. * this function to call the VF probe function. Calling
  304. * work_on_cpu() again will cause a lockdep warning. Since VFs are
  305. * always on the same node as the PF, we can work around this by
  306. * avoiding work_on_cpu() when we're already on the correct node.
  307. *
  308. * Preemption is enabled, so it's theoretically unsafe to use
  309. * numa_node_id(), but even if we run the probe function on the
  310. * wrong node, it should be functionally correct.
  311. */
  312. if (node >= 0 && node != numa_node_id()) {
  313. int cpu;
  314. get_online_cpus();
  315. cpu = cpumask_any_and(cpumask_of_node(node), cpu_online_mask);
  316. if (cpu < nr_cpu_ids)
  317. error = work_on_cpu(cpu, local_pci_probe, &ddi);
  318. else
  319. error = local_pci_probe(&ddi);
  320. put_online_cpus();
  321. } else
  322. error = local_pci_probe(&ddi);
  323. return error;
  324. }
  325. /**
  326. * __pci_device_probe - check if a driver wants to claim a specific PCI device
  327. * @drv: driver to call to check if it wants the PCI device
  328. * @pci_dev: PCI device being probed
  329. *
  330. * returns 0 on success, else error.
  331. * side-effect: pci_dev->driver is set to drv when drv claims pci_dev.
  332. */
  333. static int __pci_device_probe(struct pci_driver *drv, struct pci_dev *pci_dev)
  334. {
  335. const struct pci_device_id *id;
  336. int error = 0;
  337. if (!pci_dev->driver && drv->probe) {
  338. error = -ENODEV;
  339. id = pci_match_device(drv, pci_dev);
  340. if (id)
  341. error = pci_call_probe(drv, pci_dev, id);
  342. if (error >= 0)
  343. error = 0;
  344. }
  345. return error;
  346. }
  347. int __weak pcibios_alloc_irq(struct pci_dev *dev)
  348. {
  349. return 0;
  350. }
  351. void __weak pcibios_free_irq(struct pci_dev *dev)
  352. {
  353. }
  354. static int pci_device_probe(struct device *dev)
  355. {
  356. int error;
  357. struct pci_dev *pci_dev = to_pci_dev(dev);
  358. struct pci_driver *drv = to_pci_driver(dev->driver);
  359. error = pcibios_alloc_irq(pci_dev);
  360. if (error < 0)
  361. return error;
  362. pci_dev_get(pci_dev);
  363. error = __pci_device_probe(drv, pci_dev);
  364. if (error) {
  365. pcibios_free_irq(pci_dev);
  366. pci_dev_put(pci_dev);
  367. }
  368. return error;
  369. }
  370. static int pci_device_remove(struct device *dev)
  371. {
  372. struct pci_dev *pci_dev = to_pci_dev(dev);
  373. struct pci_driver *drv = pci_dev->driver;
  374. if (drv) {
  375. if (drv->remove) {
  376. pm_runtime_get_sync(dev);
  377. drv->remove(pci_dev);
  378. pm_runtime_put_noidle(dev);
  379. }
  380. pcibios_free_irq(pci_dev);
  381. pci_dev->driver = NULL;
  382. }
  383. /* Undo the runtime PM settings in local_pci_probe() */
  384. pm_runtime_put_sync(dev);
  385. /*
  386. * If the device is still on, set the power state as "unknown",
  387. * since it might change by the next time we load the driver.
  388. */
  389. if (pci_dev->current_state == PCI_D0)
  390. pci_dev->current_state = PCI_UNKNOWN;
  391. /*
  392. * We would love to complain here if pci_dev->is_enabled is set, that
  393. * the driver should have called pci_disable_device(), but the
  394. * unfortunate fact is there are too many odd BIOS and bridge setups
  395. * that don't like drivers doing that all of the time.
  396. * Oh well, we can dream of sane hardware when we sleep, no matter how
  397. * horrible the crap we have to deal with is when we are awake...
  398. */
  399. pci_dev_put(pci_dev);
  400. return 0;
  401. }
  402. static void pci_device_shutdown(struct device *dev)
  403. {
  404. struct pci_dev *pci_dev = to_pci_dev(dev);
  405. struct pci_driver *drv = pci_dev->driver;
  406. pm_runtime_resume(dev);
  407. if (drv && drv->shutdown)
  408. drv->shutdown(pci_dev);
  409. pci_msi_shutdown(pci_dev);
  410. pci_msix_shutdown(pci_dev);
  411. /*
  412. * If this is a kexec reboot, turn off Bus Master bit on the
  413. * device to tell it to not continue to do DMA. Don't touch
  414. * devices in D3cold or unknown states.
  415. * If it is not a kexec reboot, firmware will hit the PCI
  416. * devices with big hammer and stop their DMA any way.
  417. */
  418. if (kexec_in_progress && (pci_dev->current_state <= PCI_D3hot))
  419. pci_clear_master(pci_dev);
  420. }
  421. #ifdef CONFIG_PM
  422. /* Auxiliary functions used for system resume and run-time resume. */
  423. /**
  424. * pci_restore_standard_config - restore standard config registers of PCI device
  425. * @pci_dev: PCI device to handle
  426. */
  427. static int pci_restore_standard_config(struct pci_dev *pci_dev)
  428. {
  429. pci_update_current_state(pci_dev, PCI_UNKNOWN);
  430. if (pci_dev->current_state != PCI_D0) {
  431. int error = pci_set_power_state(pci_dev, PCI_D0);
  432. if (error)
  433. return error;
  434. }
  435. pci_restore_state(pci_dev);
  436. return 0;
  437. }
  438. #endif
  439. #ifdef CONFIG_PM_SLEEP
  440. static void pci_pm_default_resume_early(struct pci_dev *pci_dev)
  441. {
  442. pci_power_up(pci_dev);
  443. pci_restore_state(pci_dev);
  444. pci_fixup_device(pci_fixup_resume_early, pci_dev);
  445. }
  446. /*
  447. * Default "suspend" method for devices that have no driver provided suspend,
  448. * or not even a driver at all (second part).
  449. */
  450. static void pci_pm_set_unknown_state(struct pci_dev *pci_dev)
  451. {
  452. /*
  453. * mark its power state as "unknown", since we don't know if
  454. * e.g. the BIOS will change its device state when we suspend.
  455. */
  456. if (pci_dev->current_state == PCI_D0)
  457. pci_dev->current_state = PCI_UNKNOWN;
  458. }
  459. /*
  460. * Default "resume" method for devices that have no driver provided resume,
  461. * or not even a driver at all (second part).
  462. */
  463. static int pci_pm_reenable_device(struct pci_dev *pci_dev)
  464. {
  465. int retval;
  466. /* if the device was enabled before suspend, reenable */
  467. retval = pci_reenable_device(pci_dev);
  468. /*
  469. * if the device was busmaster before the suspend, make it busmaster
  470. * again
  471. */
  472. if (pci_dev->is_busmaster)
  473. pci_set_master(pci_dev);
  474. return retval;
  475. }
  476. static int pci_legacy_suspend(struct device *dev, pm_message_t state)
  477. {
  478. struct pci_dev *pci_dev = to_pci_dev(dev);
  479. struct pci_driver *drv = pci_dev->driver;
  480. if (drv && drv->suspend) {
  481. pci_power_t prev = pci_dev->current_state;
  482. int error;
  483. error = drv->suspend(pci_dev, state);
  484. suspend_report_result(drv->suspend, error);
  485. if (error)
  486. return error;
  487. if (!pci_dev->state_saved && pci_dev->current_state != PCI_D0
  488. && pci_dev->current_state != PCI_UNKNOWN) {
  489. WARN_ONCE(pci_dev->current_state != prev,
  490. "PCI PM: Device state not saved by %pF\n",
  491. drv->suspend);
  492. }
  493. }
  494. pci_fixup_device(pci_fixup_suspend, pci_dev);
  495. return 0;
  496. }
  497. static int pci_legacy_suspend_late(struct device *dev, pm_message_t state)
  498. {
  499. struct pci_dev *pci_dev = to_pci_dev(dev);
  500. struct pci_driver *drv = pci_dev->driver;
  501. if (drv && drv->suspend_late) {
  502. pci_power_t prev = pci_dev->current_state;
  503. int error;
  504. error = drv->suspend_late(pci_dev, state);
  505. suspend_report_result(drv->suspend_late, error);
  506. if (error)
  507. return error;
  508. if (!pci_dev->state_saved && pci_dev->current_state != PCI_D0
  509. && pci_dev->current_state != PCI_UNKNOWN) {
  510. WARN_ONCE(pci_dev->current_state != prev,
  511. "PCI PM: Device state not saved by %pF\n",
  512. drv->suspend_late);
  513. goto Fixup;
  514. }
  515. }
  516. if (!pci_dev->state_saved)
  517. pci_save_state(pci_dev);
  518. pci_pm_set_unknown_state(pci_dev);
  519. Fixup:
  520. pci_fixup_device(pci_fixup_suspend_late, pci_dev);
  521. return 0;
  522. }
  523. static int pci_legacy_resume_early(struct device *dev)
  524. {
  525. struct pci_dev *pci_dev = to_pci_dev(dev);
  526. struct pci_driver *drv = pci_dev->driver;
  527. return drv && drv->resume_early ?
  528. drv->resume_early(pci_dev) : 0;
  529. }
  530. static int pci_legacy_resume(struct device *dev)
  531. {
  532. struct pci_dev *pci_dev = to_pci_dev(dev);
  533. struct pci_driver *drv = pci_dev->driver;
  534. pci_fixup_device(pci_fixup_resume, pci_dev);
  535. return drv && drv->resume ?
  536. drv->resume(pci_dev) : pci_pm_reenable_device(pci_dev);
  537. }
  538. /* Auxiliary functions used by the new power management framework */
  539. static void pci_pm_default_resume(struct pci_dev *pci_dev)
  540. {
  541. pci_fixup_device(pci_fixup_resume, pci_dev);
  542. if (!pci_has_subordinate(pci_dev))
  543. pci_enable_wake(pci_dev, PCI_D0, false);
  544. }
  545. static void pci_pm_default_suspend(struct pci_dev *pci_dev)
  546. {
  547. /* Disable non-bridge devices without PM support */
  548. if (!pci_has_subordinate(pci_dev))
  549. pci_disable_enabled_device(pci_dev);
  550. }
  551. static bool pci_has_legacy_pm_support(struct pci_dev *pci_dev)
  552. {
  553. struct pci_driver *drv = pci_dev->driver;
  554. bool ret = drv && (drv->suspend || drv->suspend_late || drv->resume
  555. || drv->resume_early);
  556. /*
  557. * Legacy PM support is used by default, so warn if the new framework is
  558. * supported as well. Drivers are supposed to support either the
  559. * former, or the latter, but not both at the same time.
  560. */
  561. WARN(ret && drv->driver.pm, "driver %s device %04x:%04x\n",
  562. drv->name, pci_dev->vendor, pci_dev->device);
  563. return ret;
  564. }
  565. /* New power management framework */
  566. static int pci_pm_prepare(struct device *dev)
  567. {
  568. struct device_driver *drv = dev->driver;
  569. /*
  570. * Devices having power.ignore_children set may still be necessary for
  571. * suspending their children in the next phase of device suspend.
  572. */
  573. if (dev->power.ignore_children)
  574. pm_runtime_resume(dev);
  575. if (drv && drv->pm && drv->pm->prepare) {
  576. int error = drv->pm->prepare(dev);
  577. if (error)
  578. return error;
  579. }
  580. return pci_dev_keep_suspended(to_pci_dev(dev));
  581. }
  582. static void pci_pm_complete(struct device *dev)
  583. {
  584. struct pci_dev *pci_dev = to_pci_dev(dev);
  585. pci_dev_complete_resume(pci_dev);
  586. pm_generic_complete(dev);
  587. /* Resume device if platform firmware has put it in reset-power-on */
  588. if (dev->power.direct_complete && pm_resume_via_firmware()) {
  589. pci_power_t pre_sleep_state = pci_dev->current_state;
  590. pci_update_current_state(pci_dev, pci_dev->current_state);
  591. if (pci_dev->current_state < pre_sleep_state)
  592. pm_request_resume(dev);
  593. }
  594. }
  595. #else /* !CONFIG_PM_SLEEP */
  596. #define pci_pm_prepare NULL
  597. #define pci_pm_complete NULL
  598. #endif /* !CONFIG_PM_SLEEP */
  599. #ifdef CONFIG_SUSPEND
  600. static int pci_pm_suspend(struct device *dev)
  601. {
  602. struct pci_dev *pci_dev = to_pci_dev(dev);
  603. const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
  604. if (pci_has_legacy_pm_support(pci_dev))
  605. return pci_legacy_suspend(dev, PMSG_SUSPEND);
  606. if (!pm) {
  607. pci_pm_default_suspend(pci_dev);
  608. goto Fixup;
  609. }
  610. /*
  611. * PCI devices suspended at run time need to be resumed at this point,
  612. * because in general it is necessary to reconfigure them for system
  613. * suspend. Namely, if the device is supposed to wake up the system
  614. * from the sleep state, we may need to reconfigure it for this purpose.
  615. * In turn, if the device is not supposed to wake up the system from the
  616. * sleep state, we'll have to prevent it from signaling wake-up.
  617. */
  618. pm_runtime_resume(dev);
  619. pci_dev->state_saved = false;
  620. if (pm->suspend) {
  621. pci_power_t prev = pci_dev->current_state;
  622. int error;
  623. error = pm->suspend(dev);
  624. suspend_report_result(pm->suspend, error);
  625. if (error)
  626. return error;
  627. if (!pci_dev->state_saved && pci_dev->current_state != PCI_D0
  628. && pci_dev->current_state != PCI_UNKNOWN) {
  629. WARN_ONCE(pci_dev->current_state != prev,
  630. "PCI PM: State of device not saved by %pF\n",
  631. pm->suspend);
  632. }
  633. }
  634. Fixup:
  635. pci_fixup_device(pci_fixup_suspend, pci_dev);
  636. return 0;
  637. }
  638. static int pci_pm_suspend_noirq(struct device *dev)
  639. {
  640. struct pci_dev *pci_dev = to_pci_dev(dev);
  641. const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
  642. if (pci_has_legacy_pm_support(pci_dev))
  643. return pci_legacy_suspend_late(dev, PMSG_SUSPEND);
  644. if (!pm) {
  645. pci_save_state(pci_dev);
  646. goto Fixup;
  647. }
  648. if (pm->suspend_noirq) {
  649. pci_power_t prev = pci_dev->current_state;
  650. int error;
  651. error = pm->suspend_noirq(dev);
  652. suspend_report_result(pm->suspend_noirq, error);
  653. if (error)
  654. return error;
  655. if (!pci_dev->state_saved && pci_dev->current_state != PCI_D0
  656. && pci_dev->current_state != PCI_UNKNOWN) {
  657. WARN_ONCE(pci_dev->current_state != prev,
  658. "PCI PM: State of device not saved by %pF\n",
  659. pm->suspend_noirq);
  660. goto Fixup;
  661. }
  662. }
  663. if (!pci_dev->state_saved) {
  664. pci_save_state(pci_dev);
  665. if (pci_power_manageable(pci_dev))
  666. pci_prepare_to_sleep(pci_dev);
  667. }
  668. pci_pm_set_unknown_state(pci_dev);
  669. /*
  670. * Some BIOSes from ASUS have a bug: If a USB EHCI host controller's
  671. * PCI COMMAND register isn't 0, the BIOS assumes that the controller
  672. * hasn't been quiesced and tries to turn it off. If the controller
  673. * is already in D3, this can hang or cause memory corruption.
  674. *
  675. * Since the value of the COMMAND register doesn't matter once the
  676. * device has been suspended, we can safely set it to 0 here.
  677. */
  678. if (pci_dev->class == PCI_CLASS_SERIAL_USB_EHCI)
  679. pci_write_config_word(pci_dev, PCI_COMMAND, 0);
  680. Fixup:
  681. pci_fixup_device(pci_fixup_suspend_late, pci_dev);
  682. return 0;
  683. }
  684. static int pci_pm_resume_noirq(struct device *dev)
  685. {
  686. struct pci_dev *pci_dev = to_pci_dev(dev);
  687. struct device_driver *drv = dev->driver;
  688. int error = 0;
  689. pci_pm_default_resume_early(pci_dev);
  690. if (pci_has_legacy_pm_support(pci_dev))
  691. return pci_legacy_resume_early(dev);
  692. if (drv && drv->pm && drv->pm->resume_noirq)
  693. error = drv->pm->resume_noirq(dev);
  694. return error;
  695. }
  696. static int pci_pm_resume(struct device *dev)
  697. {
  698. struct pci_dev *pci_dev = to_pci_dev(dev);
  699. const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
  700. int error = 0;
  701. /*
  702. * This is necessary for the suspend error path in which resume is
  703. * called without restoring the standard config registers of the device.
  704. */
  705. if (pci_dev->state_saved)
  706. pci_restore_standard_config(pci_dev);
  707. if (pci_has_legacy_pm_support(pci_dev))
  708. return pci_legacy_resume(dev);
  709. pci_pm_default_resume(pci_dev);
  710. if (pm) {
  711. if (pm->resume)
  712. error = pm->resume(dev);
  713. } else {
  714. pci_pm_reenable_device(pci_dev);
  715. }
  716. return error;
  717. }
  718. #else /* !CONFIG_SUSPEND */
  719. #define pci_pm_suspend NULL
  720. #define pci_pm_suspend_noirq NULL
  721. #define pci_pm_resume NULL
  722. #define pci_pm_resume_noirq NULL
  723. #endif /* !CONFIG_SUSPEND */
  724. #ifdef CONFIG_HIBERNATE_CALLBACKS
  725. /*
  726. * pcibios_pm_ops - provide arch-specific hooks when a PCI device is doing
  727. * a hibernate transition
  728. */
  729. struct dev_pm_ops __weak pcibios_pm_ops;
  730. static int pci_pm_freeze(struct device *dev)
  731. {
  732. struct pci_dev *pci_dev = to_pci_dev(dev);
  733. const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
  734. if (pci_has_legacy_pm_support(pci_dev))
  735. return pci_legacy_suspend(dev, PMSG_FREEZE);
  736. if (!pm) {
  737. pci_pm_default_suspend(pci_dev);
  738. return 0;
  739. }
  740. /*
  741. * This used to be done in pci_pm_prepare() for all devices and some
  742. * drivers may depend on it, so do it here. Ideally, runtime-suspended
  743. * devices should not be touched during freeze/thaw transitions,
  744. * however.
  745. */
  746. pm_runtime_resume(dev);
  747. pci_dev->state_saved = false;
  748. if (pm->freeze) {
  749. int error;
  750. error = pm->freeze(dev);
  751. suspend_report_result(pm->freeze, error);
  752. if (error)
  753. return error;
  754. }
  755. if (pcibios_pm_ops.freeze)
  756. return pcibios_pm_ops.freeze(dev);
  757. return 0;
  758. }
  759. static int pci_pm_freeze_noirq(struct device *dev)
  760. {
  761. struct pci_dev *pci_dev = to_pci_dev(dev);
  762. struct device_driver *drv = dev->driver;
  763. if (pci_has_legacy_pm_support(pci_dev))
  764. return pci_legacy_suspend_late(dev, PMSG_FREEZE);
  765. if (drv && drv->pm && drv->pm->freeze_noirq) {
  766. int error;
  767. error = drv->pm->freeze_noirq(dev);
  768. suspend_report_result(drv->pm->freeze_noirq, error);
  769. if (error)
  770. return error;
  771. }
  772. if (!pci_dev->state_saved)
  773. pci_save_state(pci_dev);
  774. pci_pm_set_unknown_state(pci_dev);
  775. if (pcibios_pm_ops.freeze_noirq)
  776. return pcibios_pm_ops.freeze_noirq(dev);
  777. return 0;
  778. }
  779. static int pci_pm_thaw_noirq(struct device *dev)
  780. {
  781. struct pci_dev *pci_dev = to_pci_dev(dev);
  782. struct device_driver *drv = dev->driver;
  783. int error = 0;
  784. if (pcibios_pm_ops.thaw_noirq) {
  785. error = pcibios_pm_ops.thaw_noirq(dev);
  786. if (error)
  787. return error;
  788. }
  789. if (pci_has_legacy_pm_support(pci_dev))
  790. return pci_legacy_resume_early(dev);
  791. pci_update_current_state(pci_dev, PCI_D0);
  792. pci_restore_state(pci_dev);
  793. if (drv && drv->pm && drv->pm->thaw_noirq)
  794. error = drv->pm->thaw_noirq(dev);
  795. return error;
  796. }
  797. static int pci_pm_thaw(struct device *dev)
  798. {
  799. struct pci_dev *pci_dev = to_pci_dev(dev);
  800. const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
  801. int error = 0;
  802. if (pcibios_pm_ops.thaw) {
  803. error = pcibios_pm_ops.thaw(dev);
  804. if (error)
  805. return error;
  806. }
  807. if (pci_has_legacy_pm_support(pci_dev))
  808. return pci_legacy_resume(dev);
  809. if (pm) {
  810. if (pm->thaw)
  811. error = pm->thaw(dev);
  812. } else {
  813. pci_pm_reenable_device(pci_dev);
  814. }
  815. pci_dev->state_saved = false;
  816. return error;
  817. }
  818. static int pci_pm_poweroff(struct device *dev)
  819. {
  820. struct pci_dev *pci_dev = to_pci_dev(dev);
  821. const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
  822. if (pci_has_legacy_pm_support(pci_dev))
  823. return pci_legacy_suspend(dev, PMSG_HIBERNATE);
  824. if (!pm) {
  825. pci_pm_default_suspend(pci_dev);
  826. goto Fixup;
  827. }
  828. /* The reason to do that is the same as in pci_pm_suspend(). */
  829. pm_runtime_resume(dev);
  830. pci_dev->state_saved = false;
  831. if (pm->poweroff) {
  832. int error;
  833. error = pm->poweroff(dev);
  834. suspend_report_result(pm->poweroff, error);
  835. if (error)
  836. return error;
  837. }
  838. Fixup:
  839. pci_fixup_device(pci_fixup_suspend, pci_dev);
  840. if (pcibios_pm_ops.poweroff)
  841. return pcibios_pm_ops.poweroff(dev);
  842. return 0;
  843. }
  844. static int pci_pm_poweroff_noirq(struct device *dev)
  845. {
  846. struct pci_dev *pci_dev = to_pci_dev(dev);
  847. struct device_driver *drv = dev->driver;
  848. if (pci_has_legacy_pm_support(to_pci_dev(dev)))
  849. return pci_legacy_suspend_late(dev, PMSG_HIBERNATE);
  850. if (!drv || !drv->pm) {
  851. pci_fixup_device(pci_fixup_suspend_late, pci_dev);
  852. return 0;
  853. }
  854. if (drv->pm->poweroff_noirq) {
  855. int error;
  856. error = drv->pm->poweroff_noirq(dev);
  857. suspend_report_result(drv->pm->poweroff_noirq, error);
  858. if (error)
  859. return error;
  860. }
  861. if (!pci_dev->state_saved && !pci_has_subordinate(pci_dev))
  862. pci_prepare_to_sleep(pci_dev);
  863. /*
  864. * The reason for doing this here is the same as for the analogous code
  865. * in pci_pm_suspend_noirq().
  866. */
  867. if (pci_dev->class == PCI_CLASS_SERIAL_USB_EHCI)
  868. pci_write_config_word(pci_dev, PCI_COMMAND, 0);
  869. pci_fixup_device(pci_fixup_suspend_late, pci_dev);
  870. if (pcibios_pm_ops.poweroff_noirq)
  871. return pcibios_pm_ops.poweroff_noirq(dev);
  872. return 0;
  873. }
  874. static int pci_pm_restore_noirq(struct device *dev)
  875. {
  876. struct pci_dev *pci_dev = to_pci_dev(dev);
  877. struct device_driver *drv = dev->driver;
  878. int error = 0;
  879. if (pcibios_pm_ops.restore_noirq) {
  880. error = pcibios_pm_ops.restore_noirq(dev);
  881. if (error)
  882. return error;
  883. }
  884. pci_pm_default_resume_early(pci_dev);
  885. if (pci_has_legacy_pm_support(pci_dev))
  886. return pci_legacy_resume_early(dev);
  887. if (drv && drv->pm && drv->pm->restore_noirq)
  888. error = drv->pm->restore_noirq(dev);
  889. return error;
  890. }
  891. static int pci_pm_restore(struct device *dev)
  892. {
  893. struct pci_dev *pci_dev = to_pci_dev(dev);
  894. const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
  895. int error = 0;
  896. if (pcibios_pm_ops.restore) {
  897. error = pcibios_pm_ops.restore(dev);
  898. if (error)
  899. return error;
  900. }
  901. /*
  902. * This is necessary for the hibernation error path in which restore is
  903. * called without restoring the standard config registers of the device.
  904. */
  905. if (pci_dev->state_saved)
  906. pci_restore_standard_config(pci_dev);
  907. if (pci_has_legacy_pm_support(pci_dev))
  908. return pci_legacy_resume(dev);
  909. pci_pm_default_resume(pci_dev);
  910. if (pm) {
  911. if (pm->restore)
  912. error = pm->restore(dev);
  913. } else {
  914. pci_pm_reenable_device(pci_dev);
  915. }
  916. return error;
  917. }
  918. #else /* !CONFIG_HIBERNATE_CALLBACKS */
  919. #define pci_pm_freeze NULL
  920. #define pci_pm_freeze_noirq NULL
  921. #define pci_pm_thaw NULL
  922. #define pci_pm_thaw_noirq NULL
  923. #define pci_pm_poweroff NULL
  924. #define pci_pm_poweroff_noirq NULL
  925. #define pci_pm_restore NULL
  926. #define pci_pm_restore_noirq NULL
  927. #endif /* !CONFIG_HIBERNATE_CALLBACKS */
  928. #ifdef CONFIG_PM
  929. static int pci_pm_runtime_suspend(struct device *dev)
  930. {
  931. struct pci_dev *pci_dev = to_pci_dev(dev);
  932. const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
  933. pci_power_t prev = pci_dev->current_state;
  934. int error;
  935. /*
  936. * If pci_dev->driver is not set (unbound), the device should
  937. * always remain in D0 regardless of the runtime PM status
  938. */
  939. if (!pci_dev->driver)
  940. return 0;
  941. if (!pm || !pm->runtime_suspend)
  942. return -ENOSYS;
  943. pci_dev->state_saved = false;
  944. error = pm->runtime_suspend(dev);
  945. if (error) {
  946. /*
  947. * -EBUSY and -EAGAIN is used to request the runtime PM core
  948. * to schedule a new suspend, so log the event only with debug
  949. * log level.
  950. */
  951. if (error == -EBUSY || error == -EAGAIN)
  952. dev_dbg(dev, "can't suspend now (%pf returned %d)\n",
  953. pm->runtime_suspend, error);
  954. else
  955. dev_err(dev, "can't suspend (%pf returned %d)\n",
  956. pm->runtime_suspend, error);
  957. return error;
  958. }
  959. pci_fixup_device(pci_fixup_suspend, pci_dev);
  960. if (!pci_dev->state_saved && pci_dev->current_state != PCI_D0
  961. && pci_dev->current_state != PCI_UNKNOWN) {
  962. WARN_ONCE(pci_dev->current_state != prev,
  963. "PCI PM: State of device not saved by %pF\n",
  964. pm->runtime_suspend);
  965. return 0;
  966. }
  967. if (!pci_dev->state_saved) {
  968. pci_save_state(pci_dev);
  969. pci_finish_runtime_suspend(pci_dev);
  970. }
  971. return 0;
  972. }
  973. static int pci_pm_runtime_resume(struct device *dev)
  974. {
  975. int rc;
  976. struct pci_dev *pci_dev = to_pci_dev(dev);
  977. const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
  978. /*
  979. * If pci_dev->driver is not set (unbound), the device should
  980. * always remain in D0 regardless of the runtime PM status
  981. */
  982. if (!pci_dev->driver)
  983. return 0;
  984. if (!pm || !pm->runtime_resume)
  985. return -ENOSYS;
  986. pci_restore_standard_config(pci_dev);
  987. pci_fixup_device(pci_fixup_resume_early, pci_dev);
  988. __pci_enable_wake(pci_dev, PCI_D0, true, false);
  989. pci_fixup_device(pci_fixup_resume, pci_dev);
  990. rc = pm->runtime_resume(dev);
  991. pci_dev->runtime_d3cold = false;
  992. return rc;
  993. }
  994. static int pci_pm_runtime_idle(struct device *dev)
  995. {
  996. struct pci_dev *pci_dev = to_pci_dev(dev);
  997. const struct dev_pm_ops *pm = dev->driver ? dev->driver->pm : NULL;
  998. int ret = 0;
  999. /*
  1000. * If pci_dev->driver is not set (unbound), the device should
  1001. * always remain in D0 regardless of the runtime PM status
  1002. */
  1003. if (!pci_dev->driver)
  1004. return 0;
  1005. if (!pm)
  1006. return -ENOSYS;
  1007. if (pm->runtime_idle)
  1008. ret = pm->runtime_idle(dev);
  1009. return ret;
  1010. }
  1011. static const struct dev_pm_ops pci_dev_pm_ops = {
  1012. .prepare = pci_pm_prepare,
  1013. .complete = pci_pm_complete,
  1014. .suspend = pci_pm_suspend,
  1015. .resume = pci_pm_resume,
  1016. .freeze = pci_pm_freeze,
  1017. .thaw = pci_pm_thaw,
  1018. .poweroff = pci_pm_poweroff,
  1019. .restore = pci_pm_restore,
  1020. .suspend_noirq = pci_pm_suspend_noirq,
  1021. .resume_noirq = pci_pm_resume_noirq,
  1022. .freeze_noirq = pci_pm_freeze_noirq,
  1023. .thaw_noirq = pci_pm_thaw_noirq,
  1024. .poweroff_noirq = pci_pm_poweroff_noirq,
  1025. .restore_noirq = pci_pm_restore_noirq,
  1026. .runtime_suspend = pci_pm_runtime_suspend,
  1027. .runtime_resume = pci_pm_runtime_resume,
  1028. .runtime_idle = pci_pm_runtime_idle,
  1029. };
  1030. #define PCI_PM_OPS_PTR (&pci_dev_pm_ops)
  1031. #else /* !CONFIG_PM */
  1032. #define pci_pm_runtime_suspend NULL
  1033. #define pci_pm_runtime_resume NULL
  1034. #define pci_pm_runtime_idle NULL
  1035. #define PCI_PM_OPS_PTR NULL
  1036. #endif /* !CONFIG_PM */
  1037. /**
  1038. * __pci_register_driver - register a new pci driver
  1039. * @drv: the driver structure to register
  1040. * @owner: owner module of drv
  1041. * @mod_name: module name string
  1042. *
  1043. * Adds the driver structure to the list of registered drivers.
  1044. * Returns a negative value on error, otherwise 0.
  1045. * If no error occurred, the driver remains registered even if
  1046. * no device was claimed during registration.
  1047. */
  1048. int __pci_register_driver(struct pci_driver *drv, struct module *owner,
  1049. const char *mod_name)
  1050. {
  1051. /* initialize common driver fields */
  1052. drv->driver.name = drv->name;
  1053. drv->driver.bus = &pci_bus_type;
  1054. drv->driver.owner = owner;
  1055. drv->driver.mod_name = mod_name;
  1056. spin_lock_init(&drv->dynids.lock);
  1057. INIT_LIST_HEAD(&drv->dynids.list);
  1058. /* register with core */
  1059. return driver_register(&drv->driver);
  1060. }
  1061. EXPORT_SYMBOL(__pci_register_driver);
  1062. /**
  1063. * pci_unregister_driver - unregister a pci driver
  1064. * @drv: the driver structure to unregister
  1065. *
  1066. * Deletes the driver structure from the list of registered PCI drivers,
  1067. * gives it a chance to clean up by calling its remove() function for
  1068. * each device it was responsible for, and marks those devices as
  1069. * driverless.
  1070. */
  1071. void pci_unregister_driver(struct pci_driver *drv)
  1072. {
  1073. driver_unregister(&drv->driver);
  1074. pci_free_dynids(drv);
  1075. }
  1076. EXPORT_SYMBOL(pci_unregister_driver);
  1077. static struct pci_driver pci_compat_driver = {
  1078. .name = "compat"
  1079. };
  1080. /**
  1081. * pci_dev_driver - get the pci_driver of a device
  1082. * @dev: the device to query
  1083. *
  1084. * Returns the appropriate pci_driver structure or %NULL if there is no
  1085. * registered driver for the device.
  1086. */
  1087. struct pci_driver *pci_dev_driver(const struct pci_dev *dev)
  1088. {
  1089. if (dev->driver)
  1090. return dev->driver;
  1091. else {
  1092. int i;
  1093. for (i = 0; i <= PCI_ROM_RESOURCE; i++)
  1094. if (dev->resource[i].flags & IORESOURCE_BUSY)
  1095. return &pci_compat_driver;
  1096. }
  1097. return NULL;
  1098. }
  1099. EXPORT_SYMBOL(pci_dev_driver);
  1100. /**
  1101. * pci_bus_match - Tell if a PCI device structure has a matching PCI device id structure
  1102. * @dev: the PCI device structure to match against
  1103. * @drv: the device driver to search for matching PCI device id structures
  1104. *
  1105. * Used by a driver to check whether a PCI device present in the
  1106. * system is in its list of supported devices. Returns the matching
  1107. * pci_device_id structure or %NULL if there is no match.
  1108. */
  1109. static int pci_bus_match(struct device *dev, struct device_driver *drv)
  1110. {
  1111. struct pci_dev *pci_dev = to_pci_dev(dev);
  1112. struct pci_driver *pci_drv;
  1113. const struct pci_device_id *found_id;
  1114. if (!pci_dev->match_driver)
  1115. return 0;
  1116. pci_drv = to_pci_driver(drv);
  1117. found_id = pci_match_device(pci_drv, pci_dev);
  1118. if (found_id)
  1119. return 1;
  1120. return 0;
  1121. }
  1122. /**
  1123. * pci_dev_get - increments the reference count of the pci device structure
  1124. * @dev: the device being referenced
  1125. *
  1126. * Each live reference to a device should be refcounted.
  1127. *
  1128. * Drivers for PCI devices should normally record such references in
  1129. * their probe() methods, when they bind to a device, and release
  1130. * them by calling pci_dev_put(), in their disconnect() methods.
  1131. *
  1132. * A pointer to the device with the incremented reference counter is returned.
  1133. */
  1134. struct pci_dev *pci_dev_get(struct pci_dev *dev)
  1135. {
  1136. if (dev)
  1137. get_device(&dev->dev);
  1138. return dev;
  1139. }
  1140. EXPORT_SYMBOL(pci_dev_get);
  1141. /**
  1142. * pci_dev_put - release a use of the pci device structure
  1143. * @dev: device that's been disconnected
  1144. *
  1145. * Must be called when a user of a device is finished with it. When the last
  1146. * user of the device calls this function, the memory of the device is freed.
  1147. */
  1148. void pci_dev_put(struct pci_dev *dev)
  1149. {
  1150. if (dev)
  1151. put_device(&dev->dev);
  1152. }
  1153. EXPORT_SYMBOL(pci_dev_put);
  1154. static int pci_uevent(struct device *dev, struct kobj_uevent_env *env)
  1155. {
  1156. struct pci_dev *pdev;
  1157. if (!dev)
  1158. return -ENODEV;
  1159. pdev = to_pci_dev(dev);
  1160. if (add_uevent_var(env, "PCI_CLASS=%04X", pdev->class))
  1161. return -ENOMEM;
  1162. if (add_uevent_var(env, "PCI_ID=%04X:%04X", pdev->vendor, pdev->device))
  1163. return -ENOMEM;
  1164. if (add_uevent_var(env, "PCI_SUBSYS_ID=%04X:%04X", pdev->subsystem_vendor,
  1165. pdev->subsystem_device))
  1166. return -ENOMEM;
  1167. if (add_uevent_var(env, "PCI_SLOT_NAME=%s", pci_name(pdev)))
  1168. return -ENOMEM;
  1169. if (add_uevent_var(env, "MODALIAS=pci:v%08Xd%08Xsv%08Xsd%08Xbc%02Xsc%02Xi%02X",
  1170. pdev->vendor, pdev->device,
  1171. pdev->subsystem_vendor, pdev->subsystem_device,
  1172. (u8)(pdev->class >> 16), (u8)(pdev->class >> 8),
  1173. (u8)(pdev->class)))
  1174. return -ENOMEM;
  1175. return 0;
  1176. }
  1177. struct bus_type pci_bus_type = {
  1178. .name = "pci",
  1179. .match = pci_bus_match,
  1180. .uevent = pci_uevent,
  1181. .probe = pci_device_probe,
  1182. .remove = pci_device_remove,
  1183. .shutdown = pci_device_shutdown,
  1184. .dev_groups = pci_dev_groups,
  1185. .bus_groups = pci_bus_groups,
  1186. .drv_groups = pci_drv_groups,
  1187. .pm = PCI_PM_OPS_PTR,
  1188. };
  1189. EXPORT_SYMBOL(pci_bus_type);
  1190. static int __init pci_driver_init(void)
  1191. {
  1192. return bus_register(&pci_bus_type);
  1193. }
  1194. postcore_initcall(pci_driver_init);