projects / deliverable / linux.git / blame_incremental
? search:
summary | shortlog | log | commit | commitdiff | tree
blob | blame (non-incremental) | history | HEAD
pcmcia: remove obsolete CS_EVENT_ definitions
[deliverable/linux.git] / drivers / pcmcia / ds.c
... / ...
CommitLineData
1/*
2 * ds.c -- 16-bit PCMCIA core support
3 *
4 * This program is free software; you can redistribute it and/or modify
5 * it under the terms of the GNU General Public License version 2 as
6 * published by the Free Software Foundation.
7 *
8 * The initial developer of the original code is David A. Hinds
9 * <dahinds@users.sourceforge.net>. Portions created by David A. Hinds
10 * are Copyright (C) 1999 David A. Hinds. All Rights Reserved.
11 *
12 * (C) 1999 David A. Hinds
13 * (C) 2003 - 2010 Dominik Brodowski
14 */
15
16#include <linux/kernel.h>
17#include <linux/module.h>
18#include <linux/init.h>
19#include <linux/errno.h>
20#include <linux/list.h>
21#include <linux/delay.h>
22#include <linux/workqueue.h>
23#include <linux/crc32.h>
24#include <linux/firmware.h>
25#include <linux/kref.h>
26#include <linux/dma-mapping.h>
27#include <linux/slab.h>
28
29#include <pcmcia/cs_types.h>
30#include <pcmcia/cs.h>
31#include <pcmcia/cistpl.h>
32#include <pcmcia/ds.h>
33#include <pcmcia/ss.h>
34
35#include "cs_internal.h"
36
37/*====================================================================*/
38
39/* Module parameters */
40
41MODULE_AUTHOR("David Hinds <dahinds@users.sourceforge.net>");
42MODULE_DESCRIPTION("PCMCIA Driver Services");
43MODULE_LICENSE("GPL");
44
45
46/*====================================================================*/
47
48static void pcmcia_check_driver(struct pcmcia_driver *p_drv)
49{
50 struct pcmcia_device_id *did = p_drv->id_table;
51 unsigned int i;
52 u32 hash;
53
54 if (!p_drv->probe || !p_drv->remove)
55 printk(KERN_DEBUG "pcmcia: %s lacks a requisite callback "
56 "function\n", p_drv->drv.name);
57
58 while (did && did->match_flags) {
59 for (i = 0; i < 4; i++) {
60 if (!did->prod_id[i])
61 continue;
62
63 hash = crc32(0, did->prod_id[i], strlen(did->prod_id[i]));
64 if (hash == did->prod_id_hash[i])
65 continue;
66
67 printk(KERN_DEBUG "pcmcia: %s: invalid hash for "
68 "product string \"%s\": is 0x%x, should "
69 "be 0x%x\n", p_drv->drv.name, did->prod_id[i],
70 did->prod_id_hash[i], hash);
71 printk(KERN_DEBUG "pcmcia: see "
72 "Documentation/pcmcia/devicetable.txt for "
73 "details\n");
74 }
75 did++;
76 }
77
78 return;
79}
80
81
82/*======================================================================*/
83
84
85struct pcmcia_dynid {
86 struct list_head node;
87 struct pcmcia_device_id id;
88};
89
90/**
91 * pcmcia_store_new_id - add a new PCMCIA device ID to this driver and re-probe devices
92 * @driver: target device driver
93 * @buf: buffer for scanning device ID data
94 * @count: input size
95 *
96 * Adds a new dynamic PCMCIA device ID to this driver,
97 * and causes the driver to probe for all devices again.
98 */
99static ssize_t
100pcmcia_store_new_id(struct device_driver *driver, const char *buf, size_t count)
101{
102 struct pcmcia_dynid *dynid;
103 struct pcmcia_driver *pdrv = to_pcmcia_drv(driver);
104 __u16 match_flags, manf_id, card_id;
105 __u8 func_id, function, device_no;
106 __u32 prod_id_hash[4] = {0, 0, 0, 0};
107 int fields = 0;
108 int retval = 0;
109
110 fields = sscanf(buf, "%hx %hx %hx %hhx %hhx %hhx %x %x %x %x",
111 &match_flags, &manf_id, &card_id, &func_id, &function, &device_no,
112 &prod_id_hash[0], &prod_id_hash[1], &prod_id_hash[2], &prod_id_hash[3]);
113 if (fields < 6)
114 return -EINVAL;
115
116 dynid = kzalloc(sizeof(struct pcmcia_dynid), GFP_KERNEL);
117 if (!dynid)
118 return -ENOMEM;
119
120 dynid->id.match_flags = match_flags;
121 dynid->id.manf_id = manf_id;
122 dynid->id.card_id = card_id;
123 dynid->id.func_id = func_id;
124 dynid->id.function = function;
125 dynid->id.device_no = device_no;
126 memcpy(dynid->id.prod_id_hash, prod_id_hash, sizeof(__u32) * 4);
127
128 mutex_lock(&pdrv->dynids.lock);
129 list_add_tail(&dynid->node, &pdrv->dynids.list);
130 mutex_unlock(&pdrv->dynids.lock);
131
132 if (get_driver(&pdrv->drv)) {
133 retval = driver_attach(&pdrv->drv);
134 put_driver(&pdrv->drv);
135 }
136
137 if (retval)
138 return retval;
139 return count;
140}
141static DRIVER_ATTR(new_id, S_IWUSR, NULL, pcmcia_store_new_id);
142
143static void
144pcmcia_free_dynids(struct pcmcia_driver *drv)
145{
146 struct pcmcia_dynid *dynid, *n;
147
148 mutex_lock(&drv->dynids.lock);
149 list_for_each_entry_safe(dynid, n, &drv->dynids.list, node) {
150 list_del(&dynid->node);
151 kfree(dynid);
152 }
153 mutex_unlock(&drv->dynids.lock);
154}
155
156static int
157pcmcia_create_newid_file(struct pcmcia_driver *drv)
158{
159 int error = 0;
160 if (drv->probe != NULL)
161 error = driver_create_file(&drv->drv, &driver_attr_new_id);
162 return error;
163}
164
165
166/**
167 * pcmcia_register_driver - register a PCMCIA driver with the bus core
168 * @driver: the &driver being registered
169 *
170 * Registers a PCMCIA driver with the PCMCIA bus core.
171 */
172int pcmcia_register_driver(struct pcmcia_driver *driver)
173{
174 int error;
175
176 if (!driver)
177 return -EINVAL;
178
179 pcmcia_check_driver(driver);
180
181 /* initialize common fields */
182 driver->drv.bus = &pcmcia_bus_type;
183 driver->drv.owner = driver->owner;
184 mutex_init(&driver->dynids.lock);
185 INIT_LIST_HEAD(&driver->dynids.list);
186
187 pr_debug("registering driver %s\n", driver->drv.name);
188
189 error = driver_register(&driver->drv);
190 if (error < 0)
191 return error;
192
193 error = pcmcia_create_newid_file(driver);
194 if (error)
195 driver_unregister(&driver->drv);
196
197 return error;
198}
199EXPORT_SYMBOL(pcmcia_register_driver);
200
201/**
202 * pcmcia_unregister_driver - unregister a PCMCIA driver with the bus core
203 * @driver: the &driver being unregistered
204 */
205void pcmcia_unregister_driver(struct pcmcia_driver *driver)
206{
207 pr_debug("unregistering driver %s\n", driver->drv.name);
208 driver_unregister(&driver->drv);
209 pcmcia_free_dynids(driver);
210}
211EXPORT_SYMBOL(pcmcia_unregister_driver);
212
213
214/* pcmcia_device handling */
215
216static struct pcmcia_device *pcmcia_get_dev(struct pcmcia_device *p_dev)
217{
218 struct device *tmp_dev;
219 tmp_dev = get_device(&p_dev->dev);
220 if (!tmp_dev)
221 return NULL;
222 return to_pcmcia_dev(tmp_dev);
223}
224
225static void pcmcia_put_dev(struct pcmcia_device *p_dev)
226{
227 if (p_dev)
228 put_device(&p_dev->dev);
229}
230
231static void pcmcia_release_function(struct kref *ref)
232{
233 struct config_t *c = container_of(ref, struct config_t, ref);
234 pr_debug("releasing config_t\n");
235 kfree(c);
236}
237
238static void pcmcia_release_dev(struct device *dev)
239{
240 struct pcmcia_device *p_dev = to_pcmcia_dev(dev);
241 int i;
242 dev_dbg(dev, "releasing device\n");
243 pcmcia_put_socket(p_dev->socket);
244 for (i = 0; i < 4; i++)
245 kfree(p_dev->prod_id[i]);
246 kfree(p_dev->devname);
247 kref_put(&p_dev->function_config->ref, pcmcia_release_function);
248 kfree(p_dev);
249}
250
251
252static int pcmcia_device_probe(struct device *dev)
253{
254 struct pcmcia_device *p_dev;
255 struct pcmcia_driver *p_drv;
256 struct pcmcia_socket *s;
257 cistpl_config_t cis_config;
258 int ret = 0;
259
260 dev = get_device(dev);
261 if (!dev)
262 return -ENODEV;
263
264 p_dev = to_pcmcia_dev(dev);
265 p_drv = to_pcmcia_drv(dev->driver);
266 s = p_dev->socket;
267
268 dev_dbg(dev, "trying to bind to %s\n", p_drv->drv.name);
269
270 if ((!p_drv->probe) || (!p_dev->function_config) ||
271 (!try_module_get(p_drv->owner))) {
272 ret = -EINVAL;
273 goto put_dev;
274 }
275
276 /* set up some more device information */
277 ret = pccard_read_tuple(p_dev->socket, p_dev->func, CISTPL_CONFIG,
278 &cis_config);
279 if (!ret) {
280 p_dev->conf.ConfigBase = cis_config.base;
281 p_dev->conf.Present = cis_config.rmask[0];
282 } else {
283 dev_printk(KERN_INFO, dev,
284 "pcmcia: could not parse base and rmask0 of CIS\n");
285 p_dev->conf.ConfigBase = 0;
286 p_dev->conf.Present = 0;
287 }
288
289 ret = p_drv->probe(p_dev);
290 if (ret) {
291 dev_dbg(dev, "binding to %s failed with %d\n",
292 p_drv->drv.name, ret);
293 goto put_module;
294 }
295
296 mutex_lock(&s->ops_mutex);
297 if ((s->pcmcia_state.has_pfc) &&
298 (p_dev->socket->device_count == 1) && (p_dev->device_no == 0))
299 pcmcia_parse_uevents(s, PCMCIA_UEVENT_REQUERY);
300 mutex_unlock(&s->ops_mutex);
301
302put_module:
303 if (ret)
304 module_put(p_drv->owner);
305put_dev:
306 if (ret)
307 put_device(dev);
308 return ret;
309}
310
311
312/*
313 * Removes a PCMCIA card from the device tree and socket list.
314 */
315static void pcmcia_card_remove(struct pcmcia_socket *s, struct pcmcia_device *leftover)
316{
317 struct pcmcia_device *p_dev;
318 struct pcmcia_device *tmp;
319
320 dev_dbg(leftover ? &leftover->dev : &s->dev,
321 "pcmcia_card_remove(%d) %s\n", s->sock,
322 leftover ? leftover->devname : "");
323
324 mutex_lock(&s->ops_mutex);
325 if (!leftover)
326 s->device_count = 0;
327 else
328 s->device_count = 1;
329 mutex_unlock(&s->ops_mutex);
330
331 /* unregister all pcmcia_devices registered with this socket, except leftover */
332 list_for_each_entry_safe(p_dev, tmp, &s->devices_list, socket_device_list) {
333 if (p_dev == leftover)
334 continue;
335
336 mutex_lock(&s->ops_mutex);
337 list_del(&p_dev->socket_device_list);
338 mutex_unlock(&s->ops_mutex);
339
340 dev_dbg(&p_dev->dev, "unregistering device\n");
341 device_unregister(&p_dev->dev);
342 }
343
344 return;
345}
346
347static int pcmcia_device_remove(struct device *dev)
348{
349 struct pcmcia_device *p_dev;
350 struct pcmcia_driver *p_drv;
351 int i;
352
353 p_dev = to_pcmcia_dev(dev);
354 p_drv = to_pcmcia_drv(dev->driver);
355
356 dev_dbg(dev, "removing device\n");
357
358 /* If we're removing the primary module driving a
359 * pseudo multi-function card, we need to unbind
360 * all devices
361 */
362 if ((p_dev->socket->pcmcia_state.has_pfc) &&
363 (p_dev->socket->device_count > 0) &&
364 (p_dev->device_no == 0))
365 pcmcia_card_remove(p_dev->socket, p_dev);
366
367 /* detach the "instance" */
368 if (!p_drv)
369 return 0;
370
371 if (p_drv->remove)
372 p_drv->remove(p_dev);
373
374 /* check for proper unloading */
375 if (p_dev->_irq || p_dev->_io || p_dev->_locked)
376 dev_printk(KERN_INFO, dev,
377 "pcmcia: driver %s did not release config properly\n",
378 p_drv->drv.name);
379
380 for (i = 0; i < MAX_WIN; i++)
381 if (p_dev->_win & CLIENT_WIN_REQ(i))
382 dev_printk(KERN_INFO, dev,
383 "pcmcia: driver %s did not release window properly\n",
384 p_drv->drv.name);
385
386 /* references from pcmcia_probe_device */
387 pcmcia_put_dev(p_dev);
388 module_put(p_drv->owner);
389
390 return 0;
391}
392
393
394/*
395 * pcmcia_device_query -- determine information about a pcmcia device
396 */
397static int pcmcia_device_query(struct pcmcia_device *p_dev)
398{
399 cistpl_manfid_t manf_id;
400 cistpl_funcid_t func_id;
401 cistpl_vers_1_t *vers1;
402 unsigned int i;
403
404 vers1 = kmalloc(sizeof(*vers1), GFP_KERNEL);
405 if (!vers1)
406 return -ENOMEM;
407
408 if (!pccard_read_tuple(p_dev->socket, BIND_FN_ALL,
409 CISTPL_MANFID, &manf_id)) {
410 mutex_lock(&p_dev->socket->ops_mutex);
411 p_dev->manf_id = manf_id.manf;
412 p_dev->card_id = manf_id.card;
413 p_dev->has_manf_id = 1;
414 p_dev->has_card_id = 1;
415 mutex_unlock(&p_dev->socket->ops_mutex);
416 }
417
418 if (!pccard_read_tuple(p_dev->socket, p_dev->func,
419 CISTPL_FUNCID, &func_id)) {
420 mutex_lock(&p_dev->socket->ops_mutex);
421 p_dev->func_id = func_id.func;
422 p_dev->has_func_id = 1;
423 mutex_unlock(&p_dev->socket->ops_mutex);
424 } else {
425 /* rule of thumb: cards with no FUNCID, but with
426 * common memory device geometry information, are
427 * probably memory cards (from pcmcia-cs) */
428 cistpl_device_geo_t *devgeo;
429
430 devgeo = kmalloc(sizeof(*devgeo), GFP_KERNEL);
431 if (!devgeo) {
432 kfree(vers1);
433 return -ENOMEM;
434 }
435 if (!pccard_read_tuple(p_dev->socket, p_dev->func,
436 CISTPL_DEVICE_GEO, devgeo)) {
437 dev_dbg(&p_dev->dev,
438 "mem device geometry probably means "
439 "FUNCID_MEMORY\n");
440 mutex_lock(&p_dev->socket->ops_mutex);
441 p_dev->func_id = CISTPL_FUNCID_MEMORY;
442 p_dev->has_func_id = 1;
443 mutex_unlock(&p_dev->socket->ops_mutex);
444 }
445 kfree(devgeo);
446 }
447
448 if (!pccard_read_tuple(p_dev->socket, BIND_FN_ALL, CISTPL_VERS_1,
449 vers1)) {
450 mutex_lock(&p_dev->socket->ops_mutex);
451 for (i = 0; i < min_t(unsigned int, 4, vers1->ns); i++) {
452 char *tmp;
453 unsigned int length;
454 char *new;
455
456 tmp = vers1->str + vers1->ofs[i];
457
458 length = strlen(tmp) + 1;
459 if ((length < 2) || (length > 255))
460 continue;
461
462 new = kmalloc(sizeof(char) * length, GFP_KERNEL);
463 if (!new)
464 continue;
465
466 new = strncpy(new, tmp, length);
467
468 tmp = p_dev->prod_id[i];
469 p_dev->prod_id[i] = new;
470 kfree(tmp);
471 }
472 mutex_unlock(&p_dev->socket->ops_mutex);
473 }
474
475 kfree(vers1);
476 return 0;
477}
478
479
480static struct pcmcia_device *pcmcia_device_add(struct pcmcia_socket *s,
481 unsigned int function)
482{
483 struct pcmcia_device *p_dev, *tmp_dev;
484 int i;
485
486 s = pcmcia_get_socket(s);
487 if (!s)
488 return NULL;
489
490 pr_debug("adding device to %d, function %d\n", s->sock, function);
491
492 p_dev = kzalloc(sizeof(struct pcmcia_device), GFP_KERNEL);
493 if (!p_dev)
494 goto err_put;
495
496 mutex_lock(&s->ops_mutex);
497 p_dev->device_no = (s->device_count++);
498 mutex_unlock(&s->ops_mutex);
499
500 /* max of 2 PFC devices */
501 if ((p_dev->device_no >= 2) && (function == 0))
502 goto err_free;
503
504 /* max of 4 devices overall */
505 if (p_dev->device_no >= 4)
506 goto err_free;
507
508 p_dev->socket = s;
509 p_dev->func = function;
510
511 p_dev->dev.bus = &pcmcia_bus_type;
512 p_dev->dev.parent = s->dev.parent;
513 p_dev->dev.release = pcmcia_release_dev;
514 /* by default don't allow DMA */
515 p_dev->dma_mask = DMA_MASK_NONE;
516 p_dev->dev.dma_mask = &p_dev->dma_mask;
517 dev_set_name(&p_dev->dev, "%d.%d", p_dev->socket->sock, p_dev->device_no);
518 if (!dev_name(&p_dev->dev))
519 goto err_free;
520 p_dev->devname = kasprintf(GFP_KERNEL, "pcmcia%s", dev_name(&p_dev->dev));
521 if (!p_dev->devname)
522 goto err_free;
523 dev_dbg(&p_dev->dev, "devname is %s\n", p_dev->devname);
524
525 mutex_lock(&s->ops_mutex);
526
527 /*
528 * p_dev->function_config must be the same for all card functions.
529 * Note that this is serialized by ops_mutex, so that only one
530 * such struct will be created.
531 */
532 list_for_each_entry(tmp_dev, &s->devices_list, socket_device_list)
533 if (p_dev->func == tmp_dev->func) {
534 p_dev->function_config = tmp_dev->function_config;
535 p_dev->io = tmp_dev->io;
536 p_dev->irq = tmp_dev->irq;
537 kref_get(&p_dev->function_config->ref);
538 }
539
540 /* Add to the list in pcmcia_bus_socket */
541 list_add(&p_dev->socket_device_list, &s->devices_list);
542
543 if (pcmcia_setup_irq(p_dev))
544 dev_warn(&p_dev->dev,
545 "IRQ setup failed -- device might not work\n");
546
547 if (!p_dev->function_config) {
548 dev_dbg(&p_dev->dev, "creating config_t\n");
549 p_dev->function_config = kzalloc(sizeof(struct config_t),
550 GFP_KERNEL);
551 if (!p_dev->function_config) {
552 mutex_unlock(&s->ops_mutex);
553 goto err_unreg;
554 }
555 kref_init(&p_dev->function_config->ref);
556 }
557 mutex_unlock(&s->ops_mutex);
558
559 dev_printk(KERN_NOTICE, &p_dev->dev,
560 "pcmcia: registering new device %s (IRQ: %d)\n",
561 p_dev->devname, p_dev->irq);
562
563 pcmcia_device_query(p_dev);
564
565 if (device_register(&p_dev->dev))
566 goto err_unreg;
567
568 return p_dev;
569
570 err_unreg:
571 mutex_lock(&s->ops_mutex);
572 list_del(&p_dev->socket_device_list);
573 mutex_unlock(&s->ops_mutex);
574
575 err_free:
576 mutex_lock(&s->ops_mutex);
577 s->device_count--;
578 mutex_unlock(&s->ops_mutex);
579
580 for (i = 0; i < 4; i++)
581 kfree(p_dev->prod_id[i]);
582 kfree(p_dev->devname);
583 kfree(p_dev);
584 err_put:
585 pcmcia_put_socket(s);
586
587 return NULL;
588}
589
590
591static int pcmcia_card_add(struct pcmcia_socket *s)
592{
593 cistpl_longlink_mfc_t mfc;
594 unsigned int no_funcs, i, no_chains;
595 int ret = -EAGAIN;
596
597 mutex_lock(&s->ops_mutex);
598 if (!(s->resource_setup_done)) {
599 dev_dbg(&s->dev,
600 "no resources available, delaying card_add\n");
601 mutex_unlock(&s->ops_mutex);
602 return -EAGAIN; /* try again, but later... */
603 }
604
605 if (pcmcia_validate_mem(s)) {
606 dev_dbg(&s->dev, "validating mem resources failed, "
607 "delaying card_add\n");
608 mutex_unlock(&s->ops_mutex);
609 return -EAGAIN; /* try again, but later... */
610 }
611 mutex_unlock(&s->ops_mutex);
612
613 ret = pccard_validate_cis(s, &no_chains);
614 if (ret || !no_chains) {
615 dev_dbg(&s->dev, "invalid CIS or invalid resources\n");
616 return -ENODEV;
617 }
618
619 if (!pccard_read_tuple(s, BIND_FN_ALL, CISTPL_LONGLINK_MFC, &mfc))
620 no_funcs = mfc.nfn;
621 else
622 no_funcs = 1;
623 s->functions = no_funcs;
624
625 for (i = 0; i < no_funcs; i++)
626 pcmcia_device_add(s, i);
627
628 return ret;
629}
630
631
632static int pcmcia_requery_callback(struct device *dev, void * _data)
633{
634 struct pcmcia_device *p_dev = to_pcmcia_dev(dev);
635 if (!p_dev->dev.driver) {
636 dev_dbg(dev, "update device information\n");
637 pcmcia_device_query(p_dev);
638 }
639
640 return 0;
641}
642
643
644static void pcmcia_requery(struct pcmcia_socket *s)
645{
646 int has_pfc;
647
648 if (s->functions == 0) {
649 pcmcia_card_add(s);
650 return;
651 }
652
653 /* some device information might have changed because of a CIS
654 * update or because we can finally read it correctly... so
655 * determine it again, overwriting old values if necessary. */
656 bus_for_each_dev(&pcmcia_bus_type, NULL, NULL, pcmcia_requery_callback);
657
658 /* if the CIS changed, we need to check whether the number of
659 * functions changed. */
660 if (s->fake_cis) {
661 int old_funcs, new_funcs;
662 cistpl_longlink_mfc_t mfc;
663
664 /* does this cis override add or remove functions? */
665 old_funcs = s->functions;
666
667 if (!pccard_read_tuple(s, BIND_FN_ALL, CISTPL_LONGLINK_MFC,
668 &mfc))
669 new_funcs = mfc.nfn;
670 else
671 new_funcs = 1;
672 if (old_funcs != new_funcs) {
673 /* we need to re-start */
674 pcmcia_card_remove(s, NULL);
675 s->functions = 0;
676 pcmcia_card_add(s);
677 }
678 }
679
680 /* If the PCMCIA device consists of two pseudo devices,
681 * call pcmcia_device_add() -- which will fail if both
682 * devices are already registered. */
683 mutex_lock(&s->ops_mutex);
684 has_pfc = s->pcmcia_state.has_pfc;
685 mutex_unlock(&s->ops_mutex);
686 if (has_pfc)
687 pcmcia_device_add(s, 0);
688
689 /* we re-scan all devices, not just the ones connected to this
690 * socket. This does not matter, though. */
691 if (bus_rescan_devices(&pcmcia_bus_type))
692 dev_warn(&s->dev, "rescanning the bus failed\n");
693}
694
695
696#ifdef CONFIG_PCMCIA_LOAD_CIS
697
698/**
699 * pcmcia_load_firmware - load CIS from userspace if device-provided is broken
700 * @dev: the pcmcia device which needs a CIS override
701 * @filename: requested filename in /lib/firmware/
702 *
703 * This uses the in-kernel firmware loading mechanism to use a "fake CIS" if
704 * the one provided by the card is broken. The firmware files reside in
705 * /lib/firmware/ in userspace.
706 */
707static int pcmcia_load_firmware(struct pcmcia_device *dev, char * filename)
708{
709 struct pcmcia_socket *s = dev->socket;
710 const struct firmware *fw;
711 int ret = -ENOMEM;
712 cistpl_longlink_mfc_t mfc;
713 int old_funcs, new_funcs = 1;
714
715 if (!filename)
716 return -EINVAL;
717
718 dev_dbg(&dev->dev, "trying to load CIS file %s\n", filename);
719
720 if (request_firmware(&fw, filename, &dev->dev) == 0) {
721 if (fw->size >= CISTPL_MAX_CIS_SIZE) {
722 ret = -EINVAL;
723 dev_printk(KERN_ERR, &dev->dev,
724 "pcmcia: CIS override is too big\n");
725 goto release;
726 }
727
728 if (!pcmcia_replace_cis(s, fw->data, fw->size))
729 ret = 0;
730 else {
731 dev_printk(KERN_ERR, &dev->dev,
732 "pcmcia: CIS override failed\n");
733 goto release;
734 }
735
736 /* we need to re-start if the number of functions changed */
737 old_funcs = s->functions;
738 if (!pccard_read_tuple(s, BIND_FN_ALL, CISTPL_LONGLINK_MFC,
739 &mfc))
740 new_funcs = mfc.nfn;
741
742 if (old_funcs != new_funcs)
743 ret = -EBUSY;
744
745 /* update information */
746 pcmcia_device_query(dev);
747
748 /* requery (as number of functions might have changed) */
749 pcmcia_parse_uevents(s, PCMCIA_UEVENT_REQUERY);
750 }
751 release:
752 release_firmware(fw);
753
754 return ret;
755}
756
757#else /* !CONFIG_PCMCIA_LOAD_CIS */
758
759static inline int pcmcia_load_firmware(struct pcmcia_device *dev, char * filename)
760{
761 return -ENODEV;
762}
763
764#endif
765
766
767static inline int pcmcia_devmatch(struct pcmcia_device *dev,
768 struct pcmcia_device_id *did)
769{
770 if (did->match_flags & PCMCIA_DEV_ID_MATCH_MANF_ID) {
771 if ((!dev->has_manf_id) || (dev->manf_id != did->manf_id))
772 return 0;
773 }
774
775 if (did->match_flags & PCMCIA_DEV_ID_MATCH_CARD_ID) {
776 if ((!dev->has_card_id) || (dev->card_id != did->card_id))
777 return 0;
778 }
779
780 if (did->match_flags & PCMCIA_DEV_ID_MATCH_FUNCTION) {
781 if (dev->func != did->function)
782 return 0;
783 }
784
785 if (did->match_flags & PCMCIA_DEV_ID_MATCH_PROD_ID1) {
786 if (!dev->prod_id[0])
787 return 0;
788 if (strcmp(did->prod_id[0], dev->prod_id[0]))
789 return 0;
790 }
791
792 if (did->match_flags & PCMCIA_DEV_ID_MATCH_PROD_ID2) {
793 if (!dev->prod_id[1])
794 return 0;
795 if (strcmp(did->prod_id[1], dev->prod_id[1]))
796 return 0;
797 }
798
799 if (did->match_flags & PCMCIA_DEV_ID_MATCH_PROD_ID3) {
800 if (!dev->prod_id[2])
801 return 0;
802 if (strcmp(did->prod_id[2], dev->prod_id[2]))
803 return 0;
804 }
805
806 if (did->match_flags & PCMCIA_DEV_ID_MATCH_PROD_ID4) {
807 if (!dev->prod_id[3])
808 return 0;
809 if (strcmp(did->prod_id[3], dev->prod_id[3]))
810 return 0;
811 }
812
813 if (did->match_flags & PCMCIA_DEV_ID_MATCH_DEVICE_NO) {
814 dev_dbg(&dev->dev, "this is a pseudo-multi-function device\n");
815 mutex_lock(&dev->socket->ops_mutex);
816 dev->socket->pcmcia_state.has_pfc = 1;
817 mutex_unlock(&dev->socket->ops_mutex);
818 if (dev->device_no != did->device_no)
819 return 0;
820 }
821
822 if (did->match_flags & PCMCIA_DEV_ID_MATCH_FUNC_ID) {
823 int ret;
824
825 if ((!dev->has_func_id) || (dev->func_id != did->func_id))
826 return 0;
827
828 /* if this is a pseudo-multi-function device,
829 * we need explicit matches */
830 if (dev->socket->pcmcia_state.has_pfc)
831 return 0;
832 if (dev->device_no)
833 return 0;
834
835 /* also, FUNC_ID matching needs to be activated by userspace
836 * after it has re-checked that there is no possible module
837 * with a prod_id/manf_id/card_id match.
838 */
839 mutex_lock(&dev->socket->ops_mutex);
840 ret = dev->allow_func_id_match;
841 mutex_unlock(&dev->socket->ops_mutex);
842
843 if (!ret) {
844 dev_dbg(&dev->dev,
845 "skipping FUNC_ID match until userspace ACK\n");
846 return 0;
847 }
848 }
849
850 if (did->match_flags & PCMCIA_DEV_ID_MATCH_FAKE_CIS) {
851 dev_dbg(&dev->dev, "device needs a fake CIS\n");
852 if (!dev->socket->fake_cis)
853 if (pcmcia_load_firmware(dev, did->cisfile))
854 return 0;
855 }
856
857 if (did->match_flags & PCMCIA_DEV_ID_MATCH_ANONYMOUS) {
858 int i;
859 for (i = 0; i < 4; i++)
860 if (dev->prod_id[i])
861 return 0;
862 if (dev->has_manf_id || dev->has_card_id || dev->has_func_id)
863 return 0;
864 }
865
866 return 1;
867}
868
869
870static int pcmcia_bus_match(struct device *dev, struct device_driver *drv)
871{
872 struct pcmcia_device *p_dev = to_pcmcia_dev(dev);
873 struct pcmcia_driver *p_drv = to_pcmcia_drv(drv);
874 struct pcmcia_device_id *did = p_drv->id_table;
875 struct pcmcia_dynid *dynid;
876
877 /* match dynamic devices first */
878 mutex_lock(&p_drv->dynids.lock);
879 list_for_each_entry(dynid, &p_drv->dynids.list, node) {
880 dev_dbg(dev, "trying to match to %s\n", drv->name);
881 if (pcmcia_devmatch(p_dev, &dynid->id)) {
882 dev_dbg(dev, "matched to %s\n", drv->name);
883 mutex_unlock(&p_drv->dynids.lock);
884 return 1;
885 }
886 }
887 mutex_unlock(&p_drv->dynids.lock);
888
889 while (did && did->match_flags) {
890 dev_dbg(dev, "trying to match to %s\n", drv->name);
891 if (pcmcia_devmatch(p_dev, did)) {
892 dev_dbg(dev, "matched to %s\n", drv->name);
893 return 1;
894 }
895 did++;
896 }
897
898 return 0;
899}
900
901#ifdef CONFIG_HOTPLUG
902
903static int pcmcia_bus_uevent(struct device *dev, struct kobj_uevent_env *env)
904{
905 struct pcmcia_device *p_dev;
906 int i;
907 u32 hash[4] = { 0, 0, 0, 0};
908
909 if (!dev)
910 return -ENODEV;
911
912 p_dev = to_pcmcia_dev(dev);
913
914 /* calculate hashes */
915 for (i = 0; i < 4; i++) {
916 if (!p_dev->prod_id[i])
917 continue;
918 hash[i] = crc32(0, p_dev->prod_id[i], strlen(p_dev->prod_id[i]));
919 }
920
921 if (add_uevent_var(env, "SOCKET_NO=%u", p_dev->socket->sock))
922 return -ENOMEM;
923
924 if (add_uevent_var(env, "DEVICE_NO=%02X", p_dev->device_no))
925 return -ENOMEM;
926
927 if (add_uevent_var(env, "MODALIAS=pcmcia:m%04Xc%04Xf%02Xfn%02Xpfn%02X"
928 "pa%08Xpb%08Xpc%08Xpd%08X",
929 p_dev->has_manf_id ? p_dev->manf_id : 0,
930 p_dev->has_card_id ? p_dev->card_id : 0,
931 p_dev->has_func_id ? p_dev->func_id : 0,
932 p_dev->func,
933 p_dev->device_no,
934 hash[0],
935 hash[1],
936 hash[2],
937 hash[3]))
938 return -ENOMEM;
939
940 return 0;
941}
942
943#else
944
945static int pcmcia_bus_uevent(struct device *dev, struct kobj_uevent_env *env)
946{
947 return -ENODEV;
948}
949
950#endif
951
952/************************ runtime PM support ***************************/
953
954static int pcmcia_dev_suspend(struct device *dev, pm_message_t state);
955static int pcmcia_dev_resume(struct device *dev);
956
957static int runtime_suspend(struct device *dev)
958{
959 int rc;
960
961 device_lock(dev);
962 rc = pcmcia_dev_suspend(dev, PMSG_SUSPEND);
963 device_unlock(dev);
964 return rc;
965}
966
967static int runtime_resume(struct device *dev)
968{
969 int rc;
970
971 device_lock(dev);
972 rc = pcmcia_dev_resume(dev);
973 device_unlock(dev);
974 return rc;
975}
976
977/************************ per-device sysfs output ***************************/
978
979#define pcmcia_device_attr(field, test, format) \
980static ssize_t field##_show (struct device *dev, struct device_attribute *attr, char *buf) \
981{ \
982 struct pcmcia_device *p_dev = to_pcmcia_dev(dev); \
983 return p_dev->test ? sprintf(buf, format, p_dev->field) : -ENODEV; \
984}
985
986#define pcmcia_device_stringattr(name, field) \
987static ssize_t name##_show (struct device *dev, struct device_attribute *attr, char *buf) \
988{ \
989 struct pcmcia_device *p_dev = to_pcmcia_dev(dev); \
990 return p_dev->field ? sprintf(buf, "%s\n", p_dev->field) : -ENODEV; \
991}
992
993pcmcia_device_attr(func, socket, "0x%02x\n");
994pcmcia_device_attr(func_id, has_func_id, "0x%02x\n");
995pcmcia_device_attr(manf_id, has_manf_id, "0x%04x\n");
996pcmcia_device_attr(card_id, has_card_id, "0x%04x\n");
997pcmcia_device_stringattr(prod_id1, prod_id[0]);
998pcmcia_device_stringattr(prod_id2, prod_id[1]);
999pcmcia_device_stringattr(prod_id3, prod_id[2]);
1000pcmcia_device_stringattr(prod_id4, prod_id[3]);
1001
1002
1003static ssize_t pcmcia_show_pm_state(struct device *dev, struct device_attribute *attr, char *buf)
1004{
1005 struct pcmcia_device *p_dev = to_pcmcia_dev(dev);
1006
1007 if (p_dev->suspended)
1008 return sprintf(buf, "off\n");
1009 else
1010 return sprintf(buf, "on\n");
1011}
1012
1013static ssize_t pcmcia_store_pm_state(struct device *dev, struct device_attribute *attr,
1014 const char *buf, size_t count)
1015{
1016 struct pcmcia_device *p_dev = to_pcmcia_dev(dev);
1017 int ret = 0;
1018
1019 if (!count)
1020 return -EINVAL;
1021
1022 if ((!p_dev->suspended) && !strncmp(buf, "off", 3))
1023 ret = runtime_suspend(dev);
1024 else if (p_dev->suspended && !strncmp(buf, "on", 2))
1025 ret = runtime_resume(dev);
1026
1027 return ret ? ret : count;
1028}
1029
1030
1031static ssize_t modalias_show(struct device *dev, struct device_attribute *attr, char *buf)
1032{
1033 struct pcmcia_device *p_dev = to_pcmcia_dev(dev);
1034 int i;
1035 u32 hash[4] = { 0, 0, 0, 0};
1036
1037 /* calculate hashes */
1038 for (i = 0; i < 4; i++) {
1039 if (!p_dev->prod_id[i])
1040 continue;
1041 hash[i] = crc32(0, p_dev->prod_id[i],
1042 strlen(p_dev->prod_id[i]));
1043 }
1044 return sprintf(buf, "pcmcia:m%04Xc%04Xf%02Xfn%02Xpfn%02X"
1045 "pa%08Xpb%08Xpc%08Xpd%08X\n",
1046 p_dev->has_manf_id ? p_dev->manf_id : 0,
1047 p_dev->has_card_id ? p_dev->card_id : 0,
1048 p_dev->has_func_id ? p_dev->func_id : 0,
1049 p_dev->func, p_dev->device_no,
1050 hash[0], hash[1], hash[2], hash[3]);
1051}
1052
1053static ssize_t pcmcia_store_allow_func_id_match(struct device *dev,
1054 struct device_attribute *attr, const char *buf, size_t count)
1055{
1056 struct pcmcia_device *p_dev = to_pcmcia_dev(dev);
1057
1058 if (!count)
1059 return -EINVAL;
1060
1061 mutex_lock(&p_dev->socket->ops_mutex);
1062 p_dev->allow_func_id_match = 1;
1063 mutex_unlock(&p_dev->socket->ops_mutex);
1064 pcmcia_parse_uevents(p_dev->socket, PCMCIA_UEVENT_REQUERY);
1065
1066 return count;
1067}
1068
1069static struct device_attribute pcmcia_dev_attrs[] = {
1070 __ATTR(function, 0444, func_show, NULL),
1071 __ATTR(pm_state, 0644, pcmcia_show_pm_state, pcmcia_store_pm_state),
1072 __ATTR_RO(func_id),
1073 __ATTR_RO(manf_id),
1074 __ATTR_RO(card_id),
1075 __ATTR_RO(prod_id1),
1076 __ATTR_RO(prod_id2),
1077 __ATTR_RO(prod_id3),
1078 __ATTR_RO(prod_id4),
1079 __ATTR_RO(modalias),
1080 __ATTR(allow_func_id_match, 0200, NULL, pcmcia_store_allow_func_id_match),
1081 __ATTR_NULL,
1082};
1083
1084/* PM support, also needed for reset */
1085
1086static int pcmcia_dev_suspend(struct device *dev, pm_message_t state)
1087{
1088 struct pcmcia_device *p_dev = to_pcmcia_dev(dev);
1089 struct pcmcia_driver *p_drv = NULL;
1090 int ret = 0;
1091
1092 mutex_lock(&p_dev->socket->ops_mutex);
1093 if (p_dev->suspended) {
1094 mutex_unlock(&p_dev->socket->ops_mutex);
1095 return 0;
1096 }
1097 p_dev->suspended = 1;
1098 mutex_unlock(&p_dev->socket->ops_mutex);
1099
1100 dev_dbg(dev, "suspending\n");
1101
1102 if (dev->driver)
1103 p_drv = to_pcmcia_drv(dev->driver);
1104
1105 if (!p_drv)
1106 goto out;
1107
1108 if (p_drv->suspend) {
1109 ret = p_drv->suspend(p_dev);
1110 if (ret) {
1111 dev_printk(KERN_ERR, dev,
1112 "pcmcia: device %s (driver %s) did "
1113 "not want to go to sleep (%d)\n",
1114 p_dev->devname, p_drv->drv.name, ret);
1115 mutex_lock(&p_dev->socket->ops_mutex);
1116 p_dev->suspended = 0;
1117 mutex_unlock(&p_dev->socket->ops_mutex);
1118 goto out;
1119 }
1120 }
1121
1122 if (p_dev->device_no == p_dev->func) {
1123 dev_dbg(dev, "releasing configuration\n");
1124 pcmcia_release_configuration(p_dev);
1125 }
1126
1127 out:
1128 return ret;
1129}
1130
1131
1132static int pcmcia_dev_resume(struct device *dev)
1133{
1134 struct pcmcia_device *p_dev = to_pcmcia_dev(dev);
1135 struct pcmcia_driver *p_drv = NULL;
1136 int ret = 0;
1137
1138 mutex_lock(&p_dev->socket->ops_mutex);
1139 if (!p_dev->suspended) {
1140 mutex_unlock(&p_dev->socket->ops_mutex);
1141 return 0;
1142 }
1143 p_dev->suspended = 0;
1144 mutex_unlock(&p_dev->socket->ops_mutex);
1145
1146 dev_dbg(dev, "resuming\n");
1147
1148 if (dev->driver)
1149 p_drv = to_pcmcia_drv(dev->driver);
1150
1151 if (!p_drv)
1152 goto out;
1153
1154 if (p_dev->device_no == p_dev->func) {
1155 dev_dbg(dev, "requesting configuration\n");
1156 ret = pcmcia_request_configuration(p_dev, &p_dev->conf);
1157 if (ret)
1158 goto out;
1159 }
1160
1161 if (p_drv->resume)
1162 ret = p_drv->resume(p_dev);
1163
1164 out:
1165 return ret;
1166}
1167
1168
1169static int pcmcia_bus_suspend_callback(struct device *dev, void * _data)
1170{
1171 struct pcmcia_socket *skt = _data;
1172 struct pcmcia_device *p_dev = to_pcmcia_dev(dev);
1173
1174 if (p_dev->socket != skt || p_dev->suspended)
1175 return 0;
1176
1177 return runtime_suspend(dev);
1178}
1179
1180static int pcmcia_bus_resume_callback(struct device *dev, void * _data)
1181{
1182 struct pcmcia_socket *skt = _data;
1183 struct pcmcia_device *p_dev = to_pcmcia_dev(dev);
1184
1185 if (p_dev->socket != skt || !p_dev->suspended)
1186 return 0;
1187
1188 runtime_resume(dev);
1189
1190 return 0;
1191}
1192
1193static int pcmcia_bus_resume(struct pcmcia_socket *skt)
1194{
1195 dev_dbg(&skt->dev, "resuming socket %d\n", skt->sock);
1196 bus_for_each_dev(&pcmcia_bus_type, NULL, skt, pcmcia_bus_resume_callback);
1197 return 0;
1198}
1199
1200static int pcmcia_bus_suspend(struct pcmcia_socket *skt)
1201{
1202 dev_dbg(&skt->dev, "suspending socket %d\n", skt->sock);
1203 if (bus_for_each_dev(&pcmcia_bus_type, NULL, skt,
1204 pcmcia_bus_suspend_callback)) {
1205 pcmcia_bus_resume(skt);
1206 return -EIO;
1207 }
1208 return 0;
1209}
1210
1211static int pcmcia_bus_remove(struct pcmcia_socket *skt)
1212{
1213 atomic_set(&skt->present, 0);
1214 pcmcia_card_remove(skt, NULL);
1215
1216 mutex_lock(&skt->ops_mutex);
1217 destroy_cis_cache(skt);
1218 pcmcia_cleanup_irq(skt);
1219 mutex_unlock(&skt->ops_mutex);
1220
1221 return 0;
1222}
1223
1224static int pcmcia_bus_add(struct pcmcia_socket *skt)
1225{
1226 atomic_set(&skt->present, 1);
1227
1228 mutex_lock(&skt->ops_mutex);
1229 skt->pcmcia_state.has_pfc = 0;
1230 destroy_cis_cache(skt); /* to be on the safe side... */
1231 mutex_unlock(&skt->ops_mutex);
1232
1233 pcmcia_card_add(skt);
1234
1235 return 0;
1236}
1237
1238static int pcmcia_bus_early_resume(struct pcmcia_socket *skt)
1239{
1240 if (!verify_cis_cache(skt)) {
1241 pcmcia_put_socket(skt);
1242 return 0;
1243 }
1244
1245 dev_dbg(&skt->dev, "cis mismatch - different card\n");
1246
1247 /* first, remove the card */
1248 pcmcia_bus_remove(skt);
1249
1250 mutex_lock(&skt->ops_mutex);
1251 destroy_cis_cache(skt);
1252 kfree(skt->fake_cis);
1253 skt->fake_cis = NULL;
1254 skt->functions = 0;
1255 mutex_unlock(&skt->ops_mutex);
1256
1257 /* now, add the new card */
1258 pcmcia_bus_add(skt);
1259 return 0;
1260}
1261
1262
1263/*
1264 * NOTE: This is racy. There's no guarantee the card will still be
1265 * physically present, even if the call to this function returns
1266 * non-NULL. Furthermore, the device driver most likely is unbound
1267 * almost immediately, so the timeframe where pcmcia_dev_present
1268 * returns NULL is probably really really small.
1269 */
1270struct pcmcia_device *pcmcia_dev_present(struct pcmcia_device *_p_dev)
1271{
1272 struct pcmcia_device *p_dev;
1273 struct pcmcia_device *ret = NULL;
1274
1275 p_dev = pcmcia_get_dev(_p_dev);
1276 if (!p_dev)
1277 return NULL;
1278
1279 if (atomic_read(&p_dev->socket->present) != 0)
1280 ret = p_dev;
1281
1282 pcmcia_put_dev(p_dev);
1283 return ret;
1284}
1285EXPORT_SYMBOL(pcmcia_dev_present);
1286
1287
1288static struct pcmcia_callback pcmcia_bus_callback = {
1289 .owner = THIS_MODULE,
1290 .add = pcmcia_bus_add,
1291 .remove = pcmcia_bus_remove,
1292 .requery = pcmcia_requery,
1293 .validate = pccard_validate_cis,
1294 .suspend = pcmcia_bus_suspend,
1295 .early_resume = pcmcia_bus_early_resume,
1296 .resume = pcmcia_bus_resume,
1297};
1298
1299static int __devinit pcmcia_bus_add_socket(struct device *dev,
1300 struct class_interface *class_intf)
1301{
1302 struct pcmcia_socket *socket = dev_get_drvdata(dev);
1303 int ret;
1304
1305 socket = pcmcia_get_socket(socket);
1306 if (!socket) {
1307 dev_printk(KERN_ERR, dev,
1308 "PCMCIA obtaining reference to socket failed\n");
1309 return -ENODEV;
1310 }
1311
1312 ret = sysfs_create_bin_file(&dev->kobj, &pccard_cis_attr);
1313 if (ret) {
1314 dev_printk(KERN_ERR, dev, "PCMCIA registration failed\n");
1315 pcmcia_put_socket(socket);
1316 return ret;
1317 }
1318
1319 INIT_LIST_HEAD(&socket->devices_list);
1320 memset(&socket->pcmcia_state, 0, sizeof(u8));
1321 socket->device_count = 0;
1322 atomic_set(&socket->present, 0);
1323
1324 ret = pccard_register_pcmcia(socket, &pcmcia_bus_callback);
1325 if (ret) {
1326 dev_printk(KERN_ERR, dev, "PCMCIA registration failed\n");
1327 pcmcia_put_socket(socket);
1328 return ret;
1329 }
1330
1331 return 0;
1332}
1333
1334static void pcmcia_bus_remove_socket(struct device *dev,
1335 struct class_interface *class_intf)
1336{
1337 struct pcmcia_socket *socket = dev_get_drvdata(dev);
1338
1339 if (!socket)
1340 return;
1341
1342 pccard_register_pcmcia(socket, NULL);
1343
1344 /* unregister any unbound devices */
1345 mutex_lock(&socket->skt_mutex);
1346 pcmcia_card_remove(socket, NULL);
1347 release_cis_mem(socket);
1348 mutex_unlock(&socket->skt_mutex);
1349
1350 sysfs_remove_bin_file(&dev->kobj, &pccard_cis_attr);
1351
1352 pcmcia_put_socket(socket);
1353
1354 return;
1355}
1356
1357
1358/* the pcmcia_bus_interface is used to handle pcmcia socket devices */
1359static struct class_interface pcmcia_bus_interface __refdata = {
1360 .class = &pcmcia_socket_class,
1361 .add_dev = &pcmcia_bus_add_socket,
1362 .remove_dev = &pcmcia_bus_remove_socket,
1363};
1364
1365
1366struct bus_type pcmcia_bus_type = {
1367 .name = "pcmcia",
1368 .uevent = pcmcia_bus_uevent,
1369 .match = pcmcia_bus_match,
1370 .dev_attrs = pcmcia_dev_attrs,
1371 .probe = pcmcia_device_probe,
1372 .remove = pcmcia_device_remove,
1373 .suspend = pcmcia_dev_suspend,
1374 .resume = pcmcia_dev_resume,
1375};
1376
1377
1378static int __init init_pcmcia_bus(void)
1379{
1380 int ret;
1381
1382 ret = bus_register(&pcmcia_bus_type);
1383 if (ret < 0) {
1384 printk(KERN_WARNING "pcmcia: bus_register error: %d\n", ret);
1385 return ret;
1386 }
1387 ret = class_interface_register(&pcmcia_bus_interface);
1388 if (ret < 0) {
1389 printk(KERN_WARNING
1390 "pcmcia: class_interface_register error: %d\n", ret);
1391 bus_unregister(&pcmcia_bus_type);
1392 return ret;
1393 }
1394
1395 return 0;
1396}
1397fs_initcall(init_pcmcia_bus); /* one level after subsys_initcall so that
1398 * pcmcia_socket_class is already registered */
1399
1400
1401static void __exit exit_pcmcia_bus(void)
1402{
1403 class_interface_unregister(&pcmcia_bus_interface);
1404
1405 bus_unregister(&pcmcia_bus_type);
1406}
1407module_exit(exit_pcmcia_bus);
1408
1409
1410MODULE_ALIAS("ds");
Linux kernel - Deliverables
This page took 0.028488 seconds and 5 git commands to generate.