[PATCH] Add bus_type probe, remove, shutdown methods.
[GitHub/mt8127/android_kernel_alcatel_ttab.git] / drivers / pci / pci-driver.c
CommitLineData
1da177e4
LT
1/*
2 * drivers/pci/pci-driver.c
3 *
4 */
5
6#include <linux/pci.h>
7#include <linux/module.h>
8#include <linux/init.h>
9#include <linux/device.h>
d42c6997 10#include <linux/mempolicy.h>
4e57b681
TS
11#include <linux/string.h>
12#include <linux/slab.h>
8c65b4a6 13#include <linux/sched.h>
1da177e4
LT
14#include "pci.h"
15
16/*
17 * Registration of PCI drivers and handling of hot-pluggable devices.
18 */
19
20/*
21 * Dynamic device IDs are disabled for !CONFIG_HOTPLUG
22 */
23
75865858
GKH
24struct pci_dynid {
25 struct list_head node;
26 struct pci_device_id id;
27};
1da177e4 28
3d3c2ae1
GKH
29#ifdef CONFIG_HOTPLUG
30
1da177e4 31/**
8f7020d3
RD
32 * store_new_id - add a new PCI device ID to this driver and re-probe devices
33 * @driver: target device driver
34 * @buf: buffer for scanning device ID data
35 * @count: input size
1da177e4
LT
36 *
37 * Adds a new dynamic pci device ID to this driver,
38 * and causes the driver to probe for all devices again.
39 */
f8eb1005 40static ssize_t
1da177e4
LT
41store_new_id(struct device_driver *driver, const char *buf, size_t count)
42{
75865858 43 struct pci_dynid *dynid;
1da177e4
LT
44 struct pci_driver *pdrv = to_pci_driver(driver);
45 __u32 vendor=PCI_ANY_ID, device=PCI_ANY_ID, subvendor=PCI_ANY_ID,
46 subdevice=PCI_ANY_ID, class=0, class_mask=0;
47 unsigned long driver_data=0;
48 int fields=0;
49
50 fields = sscanf(buf, "%x %x %x %x %x %x %lux",
51 &vendor, &device, &subvendor, &subdevice,
52 &class, &class_mask, &driver_data);
53 if (fields < 0)
54 return -EINVAL;
55
56 dynid = kmalloc(sizeof(*dynid), GFP_KERNEL);
57 if (!dynid)
58 return -ENOMEM;
59
60 memset(dynid, 0, sizeof(*dynid));
61 INIT_LIST_HEAD(&dynid->node);
62 dynid->id.vendor = vendor;
63 dynid->id.device = device;
64 dynid->id.subvendor = subvendor;
65 dynid->id.subdevice = subdevice;
66 dynid->id.class = class;
67 dynid->id.class_mask = class_mask;
68 dynid->id.driver_data = pdrv->dynids.use_driver_data ?
69 driver_data : 0UL;
70
71 spin_lock(&pdrv->dynids.lock);
72 list_add_tail(&pdrv->dynids.list, &dynid->node);
73 spin_unlock(&pdrv->dynids.lock);
74
75865858
GKH
75 if (get_driver(&pdrv->driver)) {
76 driver_attach(&pdrv->driver);
77 put_driver(&pdrv->driver);
1da177e4
LT
78 }
79
80 return count;
81}
1da177e4 82static DRIVER_ATTR(new_id, S_IWUSR, NULL, store_new_id);
1da177e4
LT
83
84static void
85pci_free_dynids(struct pci_driver *drv)
86{
75865858 87 struct pci_dynid *dynid, *n;
1da177e4
LT
88
89 spin_lock(&drv->dynids.lock);
75865858 90 list_for_each_entry_safe(dynid, n, &drv->dynids.list, node) {
1da177e4
LT
91 list_del(&dynid->node);
92 kfree(dynid);
93 }
94 spin_unlock(&drv->dynids.lock);
95}
96
97static int
98pci_create_newid_file(struct pci_driver *drv)
99{
100 int error = 0;
101 if (drv->probe != NULL)
102 error = sysfs_create_file(&drv->driver.kobj,
103 &driver_attr_new_id.attr);
104 return error;
105}
106
1da177e4 107#else /* !CONFIG_HOTPLUG */
1da177e4
LT
108static inline void pci_free_dynids(struct pci_driver *drv) {}
109static inline int pci_create_newid_file(struct pci_driver *drv)
110{
111 return 0;
112}
1da177e4
LT
113#endif
114
115/**
75865858 116 * pci_match_id - See if a pci device matches a given pci_id table
1da177e4 117 * @ids: array of PCI device id structures to search in
75865858
GKH
118 * @dev: the PCI device structure to match against.
119 *
1da177e4 120 * Used by a driver to check whether a PCI device present in the
75865858 121 * system is in its list of supported devices. Returns the matching
1da177e4 122 * pci_device_id structure or %NULL if there is no match.
75865858
GKH
123 *
124 * Depreciated, don't use this as it will not catch any dynamic ids
125 * that a driver might want to check for.
1da177e4 126 */
75865858
GKH
127const struct pci_device_id *pci_match_id(const struct pci_device_id *ids,
128 struct pci_dev *dev)
1da177e4 129{
75865858
GKH
130 if (ids) {
131 while (ids->vendor || ids->subvendor || ids->class_mask) {
132 if (pci_match_one_device(ids, dev))
133 return ids;
134 ids++;
135 }
1da177e4
LT
136 }
137 return NULL;
138}
139
140/**
75865858
GKH
141 * pci_match_device - Tell if a PCI device structure has a matching
142 * PCI device id structure
143 * @ids: array of PCI device id structures to search in
144 * @dev: the PCI device structure to match against
145 * @drv: the PCI driver to match against
146 *
147 * Used by a driver to check whether a PCI device present in the
148 * system is in its list of supported devices. Returns the matching
149 * pci_device_id structure or %NULL if there is no match.
1da177e4 150 */
75865858
GKH
151const struct pci_device_id *pci_match_device(struct pci_driver *drv,
152 struct pci_dev *dev)
153{
1da177e4 154 const struct pci_device_id *id;
75865858 155 struct pci_dynid *dynid;
1da177e4 156
75865858 157 id = pci_match_id(drv->id_table, dev);
1da177e4 158 if (id)
75865858
GKH
159 return id;
160
161 /* static ids didn't match, lets look at the dynamic ones */
162 spin_lock(&drv->dynids.lock);
163 list_for_each_entry(dynid, &drv->dynids.list, node) {
164 if (pci_match_one_device(&dynid->id, dev)) {
165 spin_unlock(&drv->dynids.lock);
166 return &dynid->id;
167 }
1da177e4 168 }
75865858
GKH
169 spin_unlock(&drv->dynids.lock);
170 return NULL;
1da177e4
LT
171}
172
d42c6997
AK
173static int pci_call_probe(struct pci_driver *drv, struct pci_dev *dev,
174 const struct pci_device_id *id)
175{
176 int error;
177#ifdef CONFIG_NUMA
178 /* Execute driver initialization on node where the
179 device's bus is attached to. This way the driver likely
180 allocates its local memory on the right node without
181 any need to change it. */
182 struct mempolicy *oldpol;
183 cpumask_t oldmask = current->cpus_allowed;
184 int node = pcibus_to_node(dev->bus);
185 if (node >= 0 && node_online(node))
186 set_cpus_allowed(current, node_to_cpumask(node));
187 /* And set default memory allocation policy */
188 oldpol = current->mempolicy;
189 current->mempolicy = &default_policy;
190 mpol_get(current->mempolicy);
191#endif
192 error = drv->probe(dev, id);
193#ifdef CONFIG_NUMA
194 set_cpus_allowed(current, oldmask);
195 mpol_free(current->mempolicy);
196 current->mempolicy = oldpol;
197#endif
198 return error;
199}
200
1da177e4
LT
201/**
202 * __pci_device_probe()
8f7020d3
RD
203 * @drv: driver to call to check if it wants the PCI device
204 * @pci_dev: PCI device being probed
1da177e4 205 *
8f7020d3 206 * returns 0 on success, else error.
1da177e4
LT
207 * side-effect: pci_dev->driver is set to drv when drv claims pci_dev.
208 */
209static int
210__pci_device_probe(struct pci_driver *drv, struct pci_dev *pci_dev)
75865858
GKH
211{
212 const struct pci_device_id *id;
1da177e4
LT
213 int error = 0;
214
215 if (!pci_dev->driver && drv->probe) {
75865858
GKH
216 error = -ENODEV;
217
218 id = pci_match_device(drv, pci_dev);
219 if (id)
d42c6997 220 error = pci_call_probe(drv, pci_dev, id);
75865858
GKH
221 if (error >= 0) {
222 pci_dev->driver = drv;
223 error = 0;
224 }
1da177e4
LT
225 }
226 return error;
227}
228
229static int pci_device_probe(struct device * dev)
230{
231 int error = 0;
232 struct pci_driver *drv;
233 struct pci_dev *pci_dev;
234
235 drv = to_pci_driver(dev->driver);
236 pci_dev = to_pci_dev(dev);
237 pci_dev_get(pci_dev);
238 error = __pci_device_probe(drv, pci_dev);
239 if (error)
240 pci_dev_put(pci_dev);
241
242 return error;
243}
244
245static int pci_device_remove(struct device * dev)
246{
247 struct pci_dev * pci_dev = to_pci_dev(dev);
248 struct pci_driver * drv = pci_dev->driver;
249
250 if (drv) {
251 if (drv->remove)
252 drv->remove(pci_dev);
253 pci_dev->driver = NULL;
254 }
255
256 /*
257 * We would love to complain here if pci_dev->is_enabled is set, that
258 * the driver should have called pci_disable_device(), but the
259 * unfortunate fact is there are too many odd BIOS and bridge setups
260 * that don't like drivers doing that all of the time.
261 * Oh well, we can dream of sane hardware when we sleep, no matter how
262 * horrible the crap we have to deal with is when we are awake...
263 */
264
265 pci_dev_put(pci_dev);
266 return 0;
267}
268
269static int pci_device_suspend(struct device * dev, pm_message_t state)
270{
271 struct pci_dev * pci_dev = to_pci_dev(dev);
272 struct pci_driver * drv = pci_dev->driver;
273 int i = 0;
274
275 if (drv && drv->suspend)
276 i = drv->suspend(pci_dev, state);
277 else
278 pci_save_state(pci_dev);
279 return i;
280}
281
282
95a62965 283/*
1da177e4
LT
284 * Default resume method for devices that have no driver provided resume,
285 * or not even a driver at all.
286 */
287static void pci_default_resume(struct pci_dev *pci_dev)
288{
95a62965
GKH
289 int retval;
290
1da177e4
LT
291 /* restore the PCI config space */
292 pci_restore_state(pci_dev);
293 /* if the device was enabled before suspend, reenable */
294 if (pci_dev->is_enabled)
95a62965 295 retval = pci_enable_device(pci_dev);
1da177e4
LT
296 /* if the device was busmaster before the suspend, make it busmaster again */
297 if (pci_dev->is_busmaster)
298 pci_set_master(pci_dev);
299}
300
301static int pci_device_resume(struct device * dev)
302{
303 struct pci_dev * pci_dev = to_pci_dev(dev);
304 struct pci_driver * drv = pci_dev->driver;
305
306 if (drv && drv->resume)
307 drv->resume(pci_dev);
308 else
309 pci_default_resume(pci_dev);
310 return 0;
311}
312
c8958177
GKH
313static void pci_device_shutdown(struct device *dev)
314{
315 struct pci_dev *pci_dev = to_pci_dev(dev);
316 struct pci_driver *drv = pci_dev->driver;
317
318 if (drv && drv->shutdown)
319 drv->shutdown(pci_dev);
320}
1da177e4
LT
321
322#define kobj_to_pci_driver(obj) container_of(obj, struct device_driver, kobj)
323#define attr_to_driver_attribute(obj) container_of(obj, struct driver_attribute, attr)
324
325static ssize_t
326pci_driver_attr_show(struct kobject * kobj, struct attribute *attr, char *buf)
327{
328 struct device_driver *driver = kobj_to_pci_driver(kobj);
329 struct driver_attribute *dattr = attr_to_driver_attribute(attr);
fc7e4828 330 ssize_t ret;
1da177e4 331
fc7e4828
DT
332 if (!get_driver(driver))
333 return -ENODEV;
334
335 ret = dattr->show ? dattr->show(driver, buf) : -EIO;
336
337 put_driver(driver);
1da177e4
LT
338 return ret;
339}
340
341static ssize_t
342pci_driver_attr_store(struct kobject * kobj, struct attribute *attr,
343 const char *buf, size_t count)
344{
345 struct device_driver *driver = kobj_to_pci_driver(kobj);
346 struct driver_attribute *dattr = attr_to_driver_attribute(attr);
fc7e4828 347 ssize_t ret;
1da177e4 348
fc7e4828
DT
349 if (!get_driver(driver))
350 return -ENODEV;
351
352 ret = dattr->store ? dattr->store(driver, buf, count) : -EIO;
353
354 put_driver(driver);
1da177e4
LT
355 return ret;
356}
357
358static struct sysfs_ops pci_driver_sysfs_ops = {
359 .show = pci_driver_attr_show,
360 .store = pci_driver_attr_store,
361};
362static struct kobj_type pci_driver_kobj_type = {
363 .sysfs_ops = &pci_driver_sysfs_ops,
364};
365
1da177e4 366/**
863b18f4 367 * __pci_register_driver - register a new pci driver
1da177e4 368 * @drv: the driver structure to register
863b18f4 369 * @owner: owner module of drv
1da177e4
LT
370 *
371 * Adds the driver structure to the list of registered drivers.
372 * Returns a negative value on error, otherwise 0.
eaae4b3a 373 * If no error occurred, the driver remains registered even if
1da177e4
LT
374 * no device was claimed during registration.
375 */
863b18f4 376int __pci_register_driver(struct pci_driver *drv, struct module *owner)
1da177e4
LT
377{
378 int error;
379
380 /* initialize common driver fields */
381 drv->driver.name = drv->name;
382 drv->driver.bus = &pci_bus_type;
383 drv->driver.probe = pci_device_probe;
384 drv->driver.remove = pci_device_remove;
794f5bfa
CH
385 /* FIXME, once all of the existing PCI drivers have been fixed to set
386 * the pci shutdown function, this test can go away. */
387 if (!drv->driver.shutdown)
c83d9945 388 drv->driver.shutdown = pci_device_shutdown;
a1720fdb
RK
389 else
390 printk(KERN_WARNING "Warning: PCI driver %s has a struct "
391 "device_driver shutdown method, please update!\n",
392 drv->name);
863b18f4 393 drv->driver.owner = owner;
1da177e4 394 drv->driver.kobj.ktype = &pci_driver_kobj_type;
75865858
GKH
395
396 spin_lock_init(&drv->dynids.lock);
397 INIT_LIST_HEAD(&drv->dynids.list);
1da177e4
LT
398
399 /* register with core */
400 error = driver_register(&drv->driver);
401
402 if (!error)
75865858 403 error = pci_create_newid_file(drv);
1da177e4
LT
404
405 return error;
406}
407
408/**
409 * pci_unregister_driver - unregister a pci driver
410 * @drv: the driver structure to unregister
411 *
412 * Deletes the driver structure from the list of registered PCI drivers,
413 * gives it a chance to clean up by calling its remove() function for
414 * each device it was responsible for, and marks those devices as
415 * driverless.
416 */
417
418void
419pci_unregister_driver(struct pci_driver *drv)
420{
421 driver_unregister(&drv->driver);
422 pci_free_dynids(drv);
423}
424
425static struct pci_driver pci_compat_driver = {
426 .name = "compat"
427};
428
429/**
430 * pci_dev_driver - get the pci_driver of a device
431 * @dev: the device to query
432 *
433 * Returns the appropriate pci_driver structure or %NULL if there is no
434 * registered driver for the device.
435 */
436struct pci_driver *
437pci_dev_driver(const struct pci_dev *dev)
438{
439 if (dev->driver)
440 return dev->driver;
441 else {
442 int i;
443 for(i=0; i<=PCI_ROM_RESOURCE; i++)
444 if (dev->resource[i].flags & IORESOURCE_BUSY)
445 return &pci_compat_driver;
446 }
447 return NULL;
448}
449
450/**
451 * pci_bus_match - Tell if a PCI device structure has a matching PCI device id structure
1da177e4 452 * @dev: the PCI device structure to match against
8f7020d3 453 * @drv: the device driver to search for matching PCI device id structures
1da177e4
LT
454 *
455 * Used by a driver to check whether a PCI device present in the
8f7020d3 456 * system is in its list of supported devices. Returns the matching
1da177e4
LT
457 * pci_device_id structure or %NULL if there is no match.
458 */
75865858 459static int pci_bus_match(struct device *dev, struct device_driver *drv)
1da177e4 460{
75865858
GKH
461 struct pci_dev *pci_dev = to_pci_dev(dev);
462 struct pci_driver *pci_drv = to_pci_driver(drv);
1da177e4
LT
463 const struct pci_device_id *found_id;
464
75865858 465 found_id = pci_match_device(pci_drv, pci_dev);
1da177e4
LT
466 if (found_id)
467 return 1;
468
75865858 469 return 0;
1da177e4
LT
470}
471
472/**
473 * pci_dev_get - increments the reference count of the pci device structure
474 * @dev: the device being referenced
475 *
476 * Each live reference to a device should be refcounted.
477 *
478 * Drivers for PCI devices should normally record such references in
479 * their probe() methods, when they bind to a device, and release
480 * them by calling pci_dev_put(), in their disconnect() methods.
481 *
482 * A pointer to the device with the incremented reference counter is returned.
483 */
484struct pci_dev *pci_dev_get(struct pci_dev *dev)
485{
486 if (dev)
487 get_device(&dev->dev);
488 return dev;
489}
490
491/**
492 * pci_dev_put - release a use of the pci device structure
493 * @dev: device that's been disconnected
494 *
495 * Must be called when a user of a device is finished with it. When the last
496 * user of the device calls this function, the memory of the device is freed.
497 */
498void pci_dev_put(struct pci_dev *dev)
499{
500 if (dev)
501 put_device(&dev->dev);
502}
503
504#ifndef CONFIG_HOTPLUG
312c004d
KS
505int pci_uevent(struct device *dev, char **envp, int num_envp,
506 char *buffer, int buffer_size)
1da177e4
LT
507{
508 return -ENODEV;
509}
510#endif
511
512struct bus_type pci_bus_type = {
513 .name = "pci",
514 .match = pci_bus_match,
312c004d 515 .uevent = pci_uevent,
1da177e4
LT
516 .suspend = pci_device_suspend,
517 .resume = pci_device_resume,
518 .dev_attrs = pci_dev_attrs,
519};
520
521static int __init pci_driver_init(void)
522{
523 return bus_register(&pci_bus_type);
524}
525
526postcore_initcall(pci_driver_init);
527
75865858 528EXPORT_SYMBOL(pci_match_id);
1da177e4 529EXPORT_SYMBOL(pci_match_device);
863b18f4 530EXPORT_SYMBOL(__pci_register_driver);
1da177e4
LT
531EXPORT_SYMBOL(pci_unregister_driver);
532EXPORT_SYMBOL(pci_dev_driver);
533EXPORT_SYMBOL(pci_bus_type);
534EXPORT_SYMBOL(pci_dev_get);
535EXPORT_SYMBOL(pci_dev_put);