]> www.pilppa.org Git - linux-2.6-omap-h63xx.git/blob - drivers/firewire/fw-device.c
firewire: don't use extern on public symbols
[linux-2.6-omap-h63xx.git] / drivers / firewire / fw-device.c
1 /*                                              -*- c-basic-offset: 8 -*-
2  *
3  * fw-device.c - Device probing and sysfs code.
4  *
5  * Copyright (C) 2005-2006  Kristian Hoegsberg <krh@bitplanet.net>
6  *
7  * This program is free software; you can redistribute it and/or modify
8  * it under the terms of the GNU General Public License as published by
9  * the Free Software Foundation; either version 2 of the License, or
10  * (at your option) any later version.
11  *
12  * This program is distributed in the hope that it will be useful,
13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
15  * GNU General Public License for more details.
16  *
17  * You should have received a copy of the GNU General Public License
18  * along with this program; if not, write to the Free Software Foundation,
19  * Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
20  */
21
22 #include <linux/module.h>
23 #include <linux/wait.h>
24 #include <linux/errno.h>
25 #include <linux/kthread.h>
26 #include <linux/device.h>
27 #include <linux/delay.h>
28 #include <linux/idr.h>
29 #include <linux/rwsem.h>
30 #include <asm/semaphore.h>
31 #include <linux/ctype.h>
32 #include "fw-transaction.h"
33 #include "fw-topology.h"
34 #include "fw-device.h"
35
36 void fw_csr_iterator_init(struct fw_csr_iterator *ci, u32 * p)
37 {
38         ci->p = p + 1;
39         ci->end = ci->p + (p[0] >> 16);
40 }
41 EXPORT_SYMBOL(fw_csr_iterator_init);
42
43 int fw_csr_iterator_next(struct fw_csr_iterator *ci, int *key, int *value)
44 {
45         *key = *ci->p >> 24;
46         *value = *ci->p & 0xffffff;
47
48         return ci->p++ < ci->end;
49 }
50 EXPORT_SYMBOL(fw_csr_iterator_next);
51
52 static int is_fw_unit(struct device *dev);
53
54 static int match_unit_directory(u32 * directory, const struct fw_device_id *id)
55 {
56         struct fw_csr_iterator ci;
57         int key, value, match;
58
59         match = 0;
60         fw_csr_iterator_init(&ci, directory);
61         while (fw_csr_iterator_next(&ci, &key, &value)) {
62                 if (key == CSR_VENDOR && value == id->vendor)
63                         match |= FW_MATCH_VENDOR;
64                 if (key == CSR_MODEL && value == id->model)
65                         match |= FW_MATCH_MODEL;
66                 if (key == CSR_SPECIFIER_ID && value == id->specifier_id)
67                         match |= FW_MATCH_SPECIFIER_ID;
68                 if (key == CSR_VERSION && value == id->version)
69                         match |= FW_MATCH_VERSION;
70         }
71
72         return (match & id->match_flags) == id->match_flags;
73 }
74
75 static int fw_unit_match(struct device *dev, struct device_driver *drv)
76 {
77         struct fw_unit *unit = fw_unit(dev);
78         struct fw_driver *driver = fw_driver(drv);
79         int i;
80
81         /* We only allow binding to fw_units. */
82         if (!is_fw_unit(dev))
83                 return 0;
84
85         for (i = 0; driver->id_table[i].match_flags != 0; i++) {
86                 if (match_unit_directory(unit->directory, &driver->id_table[i]))
87                         return 1;
88         }
89
90         return 0;
91 }
92
93 static int get_modalias(struct fw_unit *unit, char *buffer, size_t buffer_size)
94 {
95         struct fw_device *device = fw_device(unit->device.parent);
96         struct fw_csr_iterator ci;
97
98         int key, value;
99         int vendor = 0;
100         int model = 0;
101         int specifier_id = 0;
102         int version = 0;
103
104         fw_csr_iterator_init(&ci, &device->config_rom[5]);
105         while (fw_csr_iterator_next(&ci, &key, &value)) {
106                 switch (key) {
107                 case CSR_VENDOR:
108                         vendor = value;
109                         break;
110                 case CSR_MODEL:
111                         model = value;
112                         break;
113                 }
114         }
115
116         fw_csr_iterator_init(&ci, unit->directory);
117         while (fw_csr_iterator_next(&ci, &key, &value)) {
118                 switch (key) {
119                 case CSR_SPECIFIER_ID:
120                         specifier_id = value;
121                         break;
122                 case CSR_VERSION:
123                         version = value;
124                         break;
125                 }
126         }
127
128         return snprintf(buffer, buffer_size,
129                         "ieee1394:ven%08Xmo%08Xsp%08Xver%08X",
130                         vendor, model, specifier_id, version);
131 }
132
133 static int
134 fw_unit_uevent(struct device *dev, char **envp, int num_envp,
135                char *buffer, int buffer_size)
136 {
137         struct fw_unit *unit = fw_unit(dev);
138         char modalias[64];
139         int length = 0;
140         int i = 0;
141
142         get_modalias(unit, modalias, sizeof modalias);
143
144         if (add_uevent_var(envp, num_envp, &i,
145                            buffer, buffer_size, &length,
146                            "MODALIAS=%s", modalias))
147                 return -ENOMEM;
148
149         envp[i] = NULL;
150
151         return 0;
152 }
153
154 struct bus_type fw_bus_type = {
155         .name = "firewire",
156         .match = fw_unit_match,
157 };
158 EXPORT_SYMBOL(fw_bus_type);
159
160 struct fw_device *fw_device_get(struct fw_device *device)
161 {
162         get_device(&device->device);
163
164         return device;
165 }
166
167 void fw_device_put(struct fw_device *device)
168 {
169         put_device(&device->device);
170 }
171
172 static void fw_device_release(struct device *dev)
173 {
174         struct fw_device *device = fw_device(dev);
175         unsigned long flags;
176
177         /* Take the card lock so we don't set this to NULL while a
178          * FW_NODE_UPDATED callback is being handled. */
179         spin_lock_irqsave(&device->card->lock, flags);
180         device->node->data = NULL;
181         spin_unlock_irqrestore(&device->card->lock, flags);
182
183         fw_node_put(device->node);
184         fw_card_put(device->card);
185         kfree(device->config_rom);
186         kfree(device);
187 }
188
189 int fw_device_enable_phys_dma(struct fw_device *device)
190 {
191         return device->card->driver->enable_phys_dma(device->card,
192                                                      device->node_id,
193                                                      device->generation);
194 }
195 EXPORT_SYMBOL(fw_device_enable_phys_dma);
196
197 struct config_rom_attribute {
198         struct device_attribute attr;
199         u32 key;
200 };
201
202 static ssize_t
203 show_immediate(struct device *dev, struct device_attribute *dattr, char *buf)
204 {
205         struct config_rom_attribute *attr =
206                 container_of(dattr, struct config_rom_attribute, attr);
207         struct fw_csr_iterator ci;
208         u32 *dir;
209         int key, value;
210
211         if (is_fw_unit(dev))
212                 dir = fw_unit(dev)->directory;
213         else
214                 dir = fw_device(dev)->config_rom + 5;
215
216         fw_csr_iterator_init(&ci, dir);
217         while (fw_csr_iterator_next(&ci, &key, &value))
218                 if (attr->key == key)
219                         return snprintf(buf, buf ? PAGE_SIZE : 0,
220                                         "0x%06x\n", value);
221
222         return -ENOENT;
223 }
224
225 #define IMMEDIATE_ATTR(name, key)                               \
226         { __ATTR(name, S_IRUGO, show_immediate, NULL), key }
227
228 static ssize_t
229 show_text_leaf(struct device *dev, struct device_attribute *dattr, char *buf)
230 {
231         struct config_rom_attribute *attr =
232                 container_of(dattr, struct config_rom_attribute, attr);
233         struct fw_csr_iterator ci;
234         u32 *dir, *block = NULL, *p, *end;
235         int length, key, value, last_key = 0;
236         char *b;
237
238         if (is_fw_unit(dev))
239                 dir = fw_unit(dev)->directory;
240         else
241                 dir = fw_device(dev)->config_rom + 5;
242
243         fw_csr_iterator_init(&ci, dir);
244         while (fw_csr_iterator_next(&ci, &key, &value)) {
245                 if (attr->key == last_key &&
246                     key == (CSR_DESCRIPTOR | CSR_LEAF))
247                         block = ci.p - 1 + value;
248                 last_key = key;
249         }
250
251         if (block == NULL)
252                 return -ENOENT;
253
254         length = min(block[0] >> 16, 256U);
255         if (length < 3)
256                 return -ENOENT;
257
258         if (block[1] != 0 || block[2] != 0)
259                 /* Unknown encoding. */
260                 return -ENOENT;
261
262         if (buf == NULL)
263                 return length * 4;
264
265         b = buf;
266         end = &block[length + 1];
267         for (p = &block[3]; p < end; p++, b += 4)
268                 * (u32 *) b = (__force u32) __cpu_to_be32(*p);
269
270         /* Strip trailing whitespace and add newline. */
271         while (b--, (isspace(*b) || *b == '\0') && b > buf);
272         strcpy(b + 1, "\n");
273
274         return b + 2 - buf;
275 }
276
277 #define TEXT_LEAF_ATTR(name, key)                               \
278         { __ATTR(name, S_IRUGO, show_text_leaf, NULL), key }
279
280 static struct config_rom_attribute config_rom_attributes[] = {
281         IMMEDIATE_ATTR(vendor, CSR_VENDOR),
282         IMMEDIATE_ATTR(hardware_version, CSR_HARDWARE_VERSION),
283         IMMEDIATE_ATTR(specifier_id, CSR_SPECIFIER_ID),
284         IMMEDIATE_ATTR(version, CSR_VERSION),
285         IMMEDIATE_ATTR(model, CSR_MODEL),
286         TEXT_LEAF_ATTR(vendor_name, CSR_VENDOR),
287         TEXT_LEAF_ATTR(model_name, CSR_MODEL),
288         TEXT_LEAF_ATTR(hardware_version_name, CSR_HARDWARE_VERSION),
289 };
290
291 static void
292 init_fw_attribute_group(struct device *dev,
293                         struct device_attribute *attrs,
294                         struct fw_attribute_group *group)
295 {
296         struct device_attribute *attr;
297         int i, j;
298
299         for (j = 0; attrs[j].attr.name != NULL; j++)
300                 group->attrs[j] = &attrs[j].attr;
301
302         for (i = 0; i < ARRAY_SIZE(config_rom_attributes); i++) {
303                 attr = &config_rom_attributes[i].attr;
304                 if (attr->show(dev, attr, NULL) < 0)
305                         continue;
306                 group->attrs[j++] = &attr->attr;
307         }
308
309         BUG_ON(j >= ARRAY_SIZE(group->attrs));
310         group->attrs[j++] = NULL;
311         group->groups[0] = &group->group;
312         group->groups[1] = NULL;
313         group->group.attrs = group->attrs;
314         dev->groups = group->groups;
315 }
316
317 static ssize_t
318 modalias_show(struct device *dev,
319               struct device_attribute *attr, char *buf)
320 {
321         struct fw_unit *unit = fw_unit(dev);
322         int length;
323
324         length = get_modalias(unit, buf, PAGE_SIZE);
325         strcpy(buf + length, "\n");
326
327         return length + 1;
328 }
329
330 static ssize_t
331 rom_index_show(struct device *dev,
332                struct device_attribute *attr, char *buf)
333 {
334         struct fw_device *device = fw_device(dev->parent);
335         struct fw_unit *unit = fw_unit(dev);
336
337         return snprintf(buf, PAGE_SIZE, "%d\n",
338                         (int)(unit->directory - device->config_rom));
339 }
340
341 static struct device_attribute fw_unit_attributes[] = {
342         __ATTR_RO(modalias),
343         __ATTR_RO(rom_index),
344         __ATTR_NULL,
345 };
346
347 static ssize_t
348 config_rom_show(struct device *dev, struct device_attribute *attr, char *buf)
349 {
350         struct fw_device *device = fw_device(dev);
351
352         memcpy(buf, device->config_rom, device->config_rom_length * 4);
353
354         return device->config_rom_length * 4;
355 }
356
357 static ssize_t
358 guid_show(struct device *dev, struct device_attribute *attr, char *buf)
359 {
360         struct fw_device *device = fw_device(dev);
361         u64 guid;
362
363         guid = ((u64)device->config_rom[3] << 32) | device->config_rom[4];
364
365         return snprintf(buf, PAGE_SIZE, "0x%016llx\n",
366                         (unsigned long long)guid);
367 }
368
369 static struct device_attribute fw_device_attributes[] = {
370         __ATTR_RO(config_rom),
371         __ATTR_RO(guid),
372         __ATTR_NULL,
373 };
374
375 struct read_quadlet_callback_data {
376         struct completion done;
377         int rcode;
378         u32 data;
379 };
380
381 static void
382 complete_transaction(struct fw_card *card, int rcode,
383                      void *payload, size_t length, void *data)
384 {
385         struct read_quadlet_callback_data *callback_data = data;
386
387         if (rcode == RCODE_COMPLETE)
388                 callback_data->data = be32_to_cpu(*(__be32 *)payload);
389         callback_data->rcode = rcode;
390         complete(&callback_data->done);
391 }
392
393 static int read_rom(struct fw_device *device, int index, u32 * data)
394 {
395         struct read_quadlet_callback_data callback_data;
396         struct fw_transaction t;
397         u64 offset;
398
399         init_completion(&callback_data.done);
400
401         offset = 0xfffff0000400ULL + index * 4;
402         fw_send_request(device->card, &t, TCODE_READ_QUADLET_REQUEST,
403                         device->node_id,
404                         device->generation, SCODE_100,
405                         offset, NULL, 4, complete_transaction, &callback_data);
406
407         wait_for_completion(&callback_data.done);
408
409         *data = callback_data.data;
410
411         return callback_data.rcode;
412 }
413
414 static int read_bus_info_block(struct fw_device *device)
415 {
416         static u32 rom[256];
417         u32 stack[16], sp, key;
418         int i, end, length;
419
420         /* First read the bus info block. */
421         for (i = 0; i < 5; i++) {
422                 if (read_rom(device, i, &rom[i]) != RCODE_COMPLETE)
423                         return -1;
424                 /* As per IEEE1212 7.2, during power-up, devices can
425                  * reply with a 0 for the first quadlet of the config
426                  * rom to indicate that they are booting (for example,
427                  * if the firmware is on the disk of a external
428                  * harddisk).  In that case we just fail, and the
429                  * retry mechanism will try again later. */
430                 if (i == 0 && rom[i] == 0)
431                         return -1;
432         }
433
434         /* Now parse the config rom.  The config rom is a recursive
435          * directory structure so we parse it using a stack of
436          * references to the blocks that make up the structure.  We
437          * push a reference to the root directory on the stack to
438          * start things off. */
439         length = i;
440         sp = 0;
441         stack[sp++] = 0xc0000005;
442         while (sp > 0) {
443                 /* Pop the next block reference of the stack.  The
444                  * lower 24 bits is the offset into the config rom,
445                  * the upper 8 bits are the type of the reference the
446                  * block. */
447                 key = stack[--sp];
448                 i = key & 0xffffff;
449                 if (i >= ARRAY_SIZE(rom))
450                         /* The reference points outside the standard
451                          * config rom area, something's fishy. */
452                         return -1;
453
454                 /* Read header quadlet for the block to get the length. */
455                 if (read_rom(device, i, &rom[i]) != RCODE_COMPLETE)
456                         return -1;
457                 end = i + (rom[i] >> 16) + 1;
458                 i++;
459                 if (end > ARRAY_SIZE(rom))
460                         /* This block extends outside standard config
461                          * area (and the array we're reading it
462                          * into).  That's broken, so ignore this
463                          * device. */
464                         return -1;
465
466                 /* Now read in the block.  If this is a directory
467                  * block, check the entries as we read them to see if
468                  * it references another block, and push it in that case. */
469                 while (i < end) {
470                         if (read_rom(device, i, &rom[i]) != RCODE_COMPLETE)
471                                 return -1;
472                         if ((key >> 30) == 3 && (rom[i] >> 30) > 1 &&
473                             sp < ARRAY_SIZE(stack))
474                                 stack[sp++] = i + rom[i];
475                         i++;
476                 }
477                 if (length < i)
478                         length = i;
479         }
480
481         device->config_rom = kmalloc(length * 4, GFP_KERNEL);
482         if (device->config_rom == NULL)
483                 return -1;
484         memcpy(device->config_rom, rom, length * 4);
485         device->config_rom_length = length;
486
487         return 0;
488 }
489
490 static void fw_unit_release(struct device *dev)
491 {
492         struct fw_unit *unit = fw_unit(dev);
493
494         kfree(unit);
495 }
496
497 static struct device_type fw_unit_type = {
498         .uevent         = fw_unit_uevent,
499         .release        = fw_unit_release,
500 };
501
502 static int is_fw_unit(struct device *dev)
503 {
504         return dev->type == &fw_unit_type;
505 }
506
507 static void create_units(struct fw_device *device)
508 {
509         struct fw_csr_iterator ci;
510         struct fw_unit *unit;
511         int key, value, i;
512
513         i = 0;
514         fw_csr_iterator_init(&ci, &device->config_rom[5]);
515         while (fw_csr_iterator_next(&ci, &key, &value)) {
516                 if (key != (CSR_UNIT | CSR_DIRECTORY))
517                         continue;
518
519                 /* Get the address of the unit directory and try to
520                  * match the drivers id_tables against it. */
521                 unit = kzalloc(sizeof *unit, GFP_KERNEL);
522                 if (unit == NULL) {
523                         fw_error("failed to allocate memory for unit\n");
524                         continue;
525                 }
526
527                 unit->directory = ci.p + value - 1;
528                 unit->device.bus = &fw_bus_type;
529                 unit->device.type = &fw_unit_type;
530                 unit->device.parent = &device->device;
531                 snprintf(unit->device.bus_id, sizeof unit->device.bus_id,
532                          "%s.%d", device->device.bus_id, i++);
533
534                 init_fw_attribute_group(&unit->device,
535                                         fw_unit_attributes,
536                                         &unit->attribute_group);
537                 if (device_register(&unit->device) < 0)
538                         goto skip_unit;
539
540                 continue;
541
542         skip_unit:
543                 kfree(unit);
544         }
545 }
546
547 static int shutdown_unit(struct device *device, void *data)
548 {
549         device_unregister(device);
550
551         return 0;
552 }
553
554 static DECLARE_RWSEM(idr_rwsem);
555 static DEFINE_IDR(fw_device_idr);
556 int fw_cdev_major;
557
558 struct fw_device *fw_device_from_devt(dev_t devt)
559 {
560         struct fw_device *device;
561
562         down_read(&idr_rwsem);
563         device = idr_find(&fw_device_idr, MINOR(devt));
564         up_read(&idr_rwsem);
565
566         return device;
567 }
568
569 static void fw_device_shutdown(struct work_struct *work)
570 {
571         struct fw_device *device =
572                 container_of(work, struct fw_device, work.work);
573         int minor = MINOR(device->device.devt);
574
575         down_write(&idr_rwsem);
576         idr_remove(&fw_device_idr, minor);
577         up_write(&idr_rwsem);
578
579         fw_device_cdev_remove(device);
580         device_for_each_child(&device->device, NULL, shutdown_unit);
581         device_unregister(&device->device);
582 }
583
584 static struct device_type fw_device_type = {
585         .release        = fw_device_release,
586 };
587
588 /* These defines control the retry behavior for reading the config
589  * rom.  It shouldn't be necessary to tweak these; if the device
590  * doesn't respond to a config rom read within 10 seconds, it's not
591  * going to respond at all.  As for the initial delay, a lot of
592  * devices will be able to respond within half a second after bus
593  * reset.  On the other hand, it's not really worth being more
594  * aggressive than that, since it scales pretty well; if 10 devices
595  * are plugged in, they're all getting read within one second. */
596
597 #define MAX_RETRIES     10
598 #define RETRY_DELAY     (3 * HZ)
599 #define INITIAL_DELAY   (HZ / 2)
600
601 static void fw_device_init(struct work_struct *work)
602 {
603         struct fw_device *device =
604                 container_of(work, struct fw_device, work.work);
605         int minor, err;
606
607         /* All failure paths here set node->data to NULL, so that we
608          * don't try to do device_for_each_child() on a kfree()'d
609          * device. */
610
611         if (read_bus_info_block(device) < 0) {
612                 if (device->config_rom_retries < MAX_RETRIES) {
613                         device->config_rom_retries++;
614                         schedule_delayed_work(&device->work, RETRY_DELAY);
615                 } else {
616                         fw_notify("giving up on config rom for node id %x\n",
617                                   device->node_id);
618                         if (device->node == device->card->root_node)
619                                 schedule_delayed_work(&device->card->work, 0);
620                         fw_device_release(&device->device);
621                 }
622                 return;
623         }
624
625         err = -ENOMEM;
626         down_write(&idr_rwsem);
627         if (idr_pre_get(&fw_device_idr, GFP_KERNEL))
628                 err = idr_get_new(&fw_device_idr, device, &minor);
629         up_write(&idr_rwsem);
630         if (err < 0)
631                 goto error;
632
633         device->device.bus = &fw_bus_type;
634         device->device.type = &fw_device_type;
635         device->device.parent = device->card->device;
636         device->device.devt = MKDEV(fw_cdev_major, minor);
637         snprintf(device->device.bus_id, sizeof device->device.bus_id,
638                  "fw%d", minor);
639
640         init_fw_attribute_group(&device->device,
641                                 fw_device_attributes,
642                                 &device->attribute_group);
643         if (device_add(&device->device)) {
644                 fw_error("Failed to add device.\n");
645                 goto error_with_cdev;
646         }
647
648         create_units(device);
649
650         /* Transition the device to running state.  If it got pulled
651          * out from under us while we did the intialization work, we
652          * have to shut down the device again here.  Normally, though,
653          * fw_node_event will be responsible for shutting it down when
654          * necessary.  We have to use the atomic cmpxchg here to avoid
655          * racing with the FW_NODE_DESTROYED case in
656          * fw_node_event(). */
657         if (atomic_cmpxchg(&device->state,
658                     FW_DEVICE_INITIALIZING,
659                     FW_DEVICE_RUNNING) == FW_DEVICE_SHUTDOWN)
660                 fw_device_shutdown(&device->work.work);
661         else
662                 fw_notify("created new fw device %s (%d config rom retries)\n",
663                           device->device.bus_id, device->config_rom_retries);
664
665         /* Reschedule the IRM work if we just finished reading the
666          * root node config rom.  If this races with a bus reset we
667          * just end up running the IRM work a couple of extra times -
668          * pretty harmless. */
669         if (device->node == device->card->root_node)
670                 schedule_delayed_work(&device->card->work, 0);
671
672         return;
673
674  error_with_cdev:
675         down_write(&idr_rwsem);
676         idr_remove(&fw_device_idr, minor);
677         up_write(&idr_rwsem);
678  error:
679         put_device(&device->device);
680 }
681
682 static int update_unit(struct device *dev, void *data)
683 {
684         struct fw_unit *unit = fw_unit(dev);
685         struct fw_driver *driver = (struct fw_driver *)dev->driver;
686
687         if (is_fw_unit(dev) && driver != NULL && driver->update != NULL) {
688                 down(&dev->sem);
689                 driver->update(unit);
690                 up(&dev->sem);
691         }
692
693         return 0;
694 }
695
696 static void fw_device_update(struct work_struct *work)
697 {
698         struct fw_device *device =
699                 container_of(work, struct fw_device, work.work);
700
701         fw_device_cdev_update(device);
702         device_for_each_child(&device->device, NULL, update_unit);
703 }
704
705 void fw_node_event(struct fw_card *card, struct fw_node *node, int event)
706 {
707         struct fw_device *device;
708
709         switch (event) {
710         case FW_NODE_CREATED:
711         case FW_NODE_LINK_ON:
712                 if (!node->link_on)
713                         break;
714
715                 device = kzalloc(sizeof(*device), GFP_ATOMIC);
716                 if (device == NULL)
717                         break;
718
719                 /* Do minimal intialization of the device here, the
720                  * rest will happen in fw_device_init().  We need the
721                  * card and node so we can read the config rom and we
722                  * need to do device_initialize() now so
723                  * device_for_each_child() in FW_NODE_UPDATED is
724                  * doesn't freak out. */
725                 device_initialize(&device->device);
726                 atomic_set(&device->state, FW_DEVICE_INITIALIZING);
727                 device->card = fw_card_get(card);
728                 device->node = fw_node_get(node);
729                 device->node_id = node->node_id;
730                 device->generation = card->generation;
731                 INIT_LIST_HEAD(&device->client_list);
732
733                 /* Set the node data to point back to this device so
734                  * FW_NODE_UPDATED callbacks can update the node_id
735                  * and generation for the device. */
736                 node->data = device;
737
738                 /* Many devices are slow to respond after bus resets,
739                  * especially if they are bus powered and go through
740                  * power-up after getting plugged in.  We schedule the
741                  * first config rom scan half a second after bus reset. */
742                 INIT_DELAYED_WORK(&device->work, fw_device_init);
743                 schedule_delayed_work(&device->work, INITIAL_DELAY);
744                 break;
745
746         case FW_NODE_UPDATED:
747                 if (!node->link_on || node->data == NULL)
748                         break;
749
750                 device = node->data;
751                 device->node_id = node->node_id;
752                 device->generation = card->generation;
753                 if (atomic_read(&device->state) == FW_DEVICE_RUNNING) {
754                         PREPARE_DELAYED_WORK(&device->work, fw_device_update);
755                         schedule_delayed_work(&device->work, 0);
756                 }
757                 break;
758
759         case FW_NODE_DESTROYED:
760         case FW_NODE_LINK_OFF:
761                 if (!node->data)
762                         break;
763
764                 /* Destroy the device associated with the node.  There
765                  * are two cases here: either the device is fully
766                  * initialized (FW_DEVICE_RUNNING) or we're in the
767                  * process of reading its config rom
768                  * (FW_DEVICE_INITIALIZING).  If it is fully
769                  * initialized we can reuse device->work to schedule a
770                  * full fw_device_shutdown().  If not, there's work
771                  * scheduled to read it's config rom, and we just put
772                  * the device in shutdown state to have that code fail
773                  * to create the device. */
774                 device = node->data;
775                 if (atomic_xchg(&device->state,
776                                 FW_DEVICE_SHUTDOWN) == FW_DEVICE_RUNNING) {
777                         PREPARE_DELAYED_WORK(&device->work, fw_device_shutdown);
778                         schedule_delayed_work(&device->work, 0);
779                 }
780                 break;
781         }
782 }