2 * drivers/s390/cio/device.c
3 * bus driver for ccw devices
5 * Copyright (C) 2002 IBM Deutschland Entwicklung GmbH,
7 * Author(s): Arnd Bergmann (arndb@de.ibm.com)
8 * Cornelia Huck (cornelia.huck@de.ibm.com)
9 * Martin Schwidefsky (schwidefsky@de.ibm.com)
11 #include <linux/module.h>
12 #include <linux/init.h>
13 #include <linux/spinlock.h>
14 #include <linux/errno.h>
15 #include <linux/err.h>
16 #include <linux/slab.h>
17 #include <linux/list.h>
18 #include <linux/device.h>
19 #include <linux/workqueue.h>
21 #include <asm/ccwdev.h>
23 #include <asm/param.h> /* HZ */
27 #include "cio_debug.h"
32 /******************* bus type handling ***********************/
34 /* The Linux driver model distinguishes between a bus type and
35 * the bus itself. Of course we only have one channel
36 * subsystem driver and one channel system per machine, but
37 * we still use the abstraction. T.R. says it's a good idea. */
39 ccw_bus_match (struct device * dev, struct device_driver * drv)
41 struct ccw_device *cdev = to_ccwdev(dev);
42 struct ccw_driver *cdrv = to_ccwdrv(drv);
43 const struct ccw_device_id *ids = cdrv->ids, *found;
48 found = ccw_device_id_match(ids, &cdev->id);
52 cdev->id.driver_info = found->driver_info;
57 /* Store modalias string delimited by prefix/suffix string into buffer with
58 * specified size. Return length of resulting string (excluding trailing '\0')
59 * even if string doesn't fit buffer (snprintf semantics). */
60 static int snprint_alias(char *buf, size_t size,
61 struct ccw_device_id *id, const char *suffix)
65 len = snprintf(buf, size, "ccw:t%04Xm%02X", id->cu_type, id->cu_model);
71 if (id->dev_type != 0)
72 len += snprintf(buf, size, "dt%04Xdm%02X%s", id->dev_type,
73 id->dev_model, suffix);
75 len += snprintf(buf, size, "dtdm%s", suffix);
80 /* Set up environment variables for ccw device uevent. Return 0 on success,
81 * non-zero otherwise. */
82 static int ccw_uevent(struct device *dev, struct kobj_uevent_env *env)
84 struct ccw_device *cdev = to_ccwdev(dev);
85 struct ccw_device_id *id = &(cdev->id);
87 char modalias_buf[30];
90 ret = add_uevent_var(env, "CU_TYPE=%04X", id->cu_type);
95 ret = add_uevent_var(env, "CU_MODEL=%02X", id->cu_model);
99 /* The next two can be zero, that's ok for us */
101 ret = add_uevent_var(env, "DEV_TYPE=%04X", id->dev_type);
106 ret = add_uevent_var(env, "DEV_MODEL=%02X", id->dev_model);
111 snprint_alias(modalias_buf, sizeof(modalias_buf), id, "");
112 ret = add_uevent_var(env, "MODALIAS=%s", modalias_buf);
116 struct bus_type ccw_bus_type;
118 static int io_subchannel_probe (struct subchannel *);
119 static int io_subchannel_remove (struct subchannel *);
120 static int io_subchannel_notify(struct device *, int);
121 static void io_subchannel_verify(struct device *);
122 static void io_subchannel_ioterm(struct device *);
123 static void io_subchannel_shutdown(struct subchannel *);
125 static struct css_driver io_subchannel_driver = {
126 .subchannel_type = SUBCHANNEL_TYPE_IO,
128 .name = "io_subchannel",
129 .bus = &css_bus_type,
131 .irq = io_subchannel_irq,
132 .notify = io_subchannel_notify,
133 .verify = io_subchannel_verify,
134 .termination = io_subchannel_ioterm,
135 .probe = io_subchannel_probe,
136 .remove = io_subchannel_remove,
137 .shutdown = io_subchannel_shutdown,
140 struct workqueue_struct *ccw_device_work;
141 struct workqueue_struct *ccw_device_notify_work;
142 wait_queue_head_t ccw_device_init_wq;
143 atomic_t ccw_device_init_count;
146 init_ccw_bus_type (void)
150 init_waitqueue_head(&ccw_device_init_wq);
151 atomic_set(&ccw_device_init_count, 0);
153 ccw_device_work = create_singlethread_workqueue("cio");
154 if (!ccw_device_work)
155 return -ENOMEM; /* FIXME: better errno ? */
156 ccw_device_notify_work = create_singlethread_workqueue("cio_notify");
157 if (!ccw_device_notify_work) {
158 ret = -ENOMEM; /* FIXME: better errno ? */
161 slow_path_wq = create_singlethread_workqueue("kslowcrw");
163 ret = -ENOMEM; /* FIXME: better errno ? */
166 if ((ret = bus_register (&ccw_bus_type)))
169 if ((ret = driver_register(&io_subchannel_driver.drv)))
172 wait_event(ccw_device_init_wq,
173 atomic_read(&ccw_device_init_count) == 0);
174 flush_workqueue(ccw_device_work);
178 destroy_workqueue(ccw_device_work);
179 if (ccw_device_notify_work)
180 destroy_workqueue(ccw_device_notify_work);
182 destroy_workqueue(slow_path_wq);
187 cleanup_ccw_bus_type (void)
189 driver_unregister(&io_subchannel_driver.drv);
190 bus_unregister(&ccw_bus_type);
191 destroy_workqueue(ccw_device_notify_work);
192 destroy_workqueue(ccw_device_work);
195 subsys_initcall(init_ccw_bus_type);
196 module_exit(cleanup_ccw_bus_type);
198 /************************ device handling **************************/
201 * A ccw_device has some interfaces in sysfs in addition to the
203 * The following entries are designed to export the information which
204 * resided in 2.4 in /proc/subchannels. Subchannel and device number
205 * are obvious, so they don't have an entry :)
206 * TODO: Split chpids and pimpampom up? Where is "in use" in the tree?
209 chpids_show (struct device * dev, struct device_attribute *attr, char * buf)
211 struct subchannel *sch = to_subchannel(dev);
212 struct chsc_ssd_info *ssd = &sch->ssd_info;
217 for (chp = 0; chp < 8; chp++) {
219 if (ssd->path_mask & mask)
220 ret += sprintf(buf + ret, "%02x ", ssd->chpid[chp].id);
222 ret += sprintf(buf + ret, "00 ");
224 ret += sprintf (buf+ret, "\n");
225 return min((ssize_t)PAGE_SIZE, ret);
229 pimpampom_show (struct device * dev, struct device_attribute *attr, char * buf)
231 struct subchannel *sch = to_subchannel(dev);
232 struct pmcw *pmcw = &sch->schib.pmcw;
234 return sprintf (buf, "%02x %02x %02x\n",
235 pmcw->pim, pmcw->pam, pmcw->pom);
239 devtype_show (struct device *dev, struct device_attribute *attr, char *buf)
241 struct ccw_device *cdev = to_ccwdev(dev);
242 struct ccw_device_id *id = &(cdev->id);
244 if (id->dev_type != 0)
245 return sprintf(buf, "%04x/%02x\n",
246 id->dev_type, id->dev_model);
248 return sprintf(buf, "n/a\n");
252 cutype_show (struct device *dev, struct device_attribute *attr, char *buf)
254 struct ccw_device *cdev = to_ccwdev(dev);
255 struct ccw_device_id *id = &(cdev->id);
257 return sprintf(buf, "%04x/%02x\n",
258 id->cu_type, id->cu_model);
262 modalias_show (struct device *dev, struct device_attribute *attr, char *buf)
264 struct ccw_device *cdev = to_ccwdev(dev);
265 struct ccw_device_id *id = &(cdev->id);
268 len = snprint_alias(buf, PAGE_SIZE, id, "\n");
270 return len > PAGE_SIZE ? PAGE_SIZE : len;
274 online_show (struct device *dev, struct device_attribute *attr, char *buf)
276 struct ccw_device *cdev = to_ccwdev(dev);
278 return sprintf(buf, cdev->online ? "1\n" : "0\n");
281 int ccw_device_is_orphan(struct ccw_device *cdev)
283 return sch_is_pseudo_sch(to_subchannel(cdev->dev.parent));
286 static void ccw_device_unregister(struct ccw_device *cdev)
288 if (test_and_clear_bit(1, &cdev->private->registered))
289 device_del(&cdev->dev);
292 static void ccw_device_remove_orphan_cb(struct device *dev)
294 struct ccw_device *cdev = to_ccwdev(dev);
296 ccw_device_unregister(cdev);
297 put_device(&cdev->dev);
300 static void ccw_device_remove_sch_cb(struct device *dev)
302 struct subchannel *sch;
304 sch = to_subchannel(dev);
305 css_sch_device_unregister(sch);
306 /* Reset intparm to zeroes. */
307 sch->schib.pmcw.intparm = 0;
309 put_device(&sch->dev);
313 ccw_device_remove_disconnected(struct ccw_device *cdev)
319 * Forced offline in disconnected state means
320 * 'throw away device'.
322 if (ccw_device_is_orphan(cdev)) {
324 * Deregister ccw device.
325 * Unfortunately, we cannot do this directly from the
328 spin_lock_irqsave(cdev->ccwlock, flags);
329 cdev->private->state = DEV_STATE_NOT_OPER;
330 spin_unlock_irqrestore(cdev->ccwlock, flags);
331 rc = device_schedule_callback(&cdev->dev,
332 ccw_device_remove_orphan_cb);
334 CIO_MSG_EVENT(2, "Couldn't unregister orphan "
336 cdev->private->dev_id.ssid,
337 cdev->private->dev_id.devno);
340 /* Deregister subchannel, which will kill the ccw device. */
341 rc = device_schedule_callback(cdev->dev.parent,
342 ccw_device_remove_sch_cb);
344 CIO_MSG_EVENT(2, "Couldn't unregister disconnected device "
346 cdev->private->dev_id.ssid,
347 cdev->private->dev_id.devno);
351 * ccw_device_set_offline() - disable a ccw device for I/O
352 * @cdev: target ccw device
354 * This function calls the driver's set_offline() function for @cdev, if
355 * given, and then disables @cdev.
357 * %0 on success and a negative error value on failure.
359 * enabled, ccw device lock not held
361 int ccw_device_set_offline(struct ccw_device *cdev)
367 if (!cdev->online || !cdev->drv)
370 if (cdev->drv->set_offline) {
371 ret = cdev->drv->set_offline(cdev);
376 spin_lock_irq(cdev->ccwlock);
377 ret = ccw_device_offline(cdev);
378 if (ret == -ENODEV) {
379 if (cdev->private->state != DEV_STATE_NOT_OPER) {
380 cdev->private->state = DEV_STATE_OFFLINE;
381 dev_fsm_event(cdev, DEV_EVENT_NOTOPER);
383 spin_unlock_irq(cdev->ccwlock);
386 spin_unlock_irq(cdev->ccwlock);
388 wait_event(cdev->private->wait_q, dev_fsm_final_state(cdev));
390 CIO_MSG_EVENT(2, "ccw_device_offline returned %d, "
391 "device 0.%x.%04x\n",
392 ret, cdev->private->dev_id.ssid,
393 cdev->private->dev_id.devno);
400 * ccw_device_set_online() - enable a ccw device for I/O
401 * @cdev: target ccw device
403 * This function first enables @cdev and then calls the driver's set_online()
404 * function for @cdev, if given. If set_online() returns an error, @cdev is
407 * %0 on success and a negative error value on failure.
409 * enabled, ccw device lock not held
411 int ccw_device_set_online(struct ccw_device *cdev)
417 if (cdev->online || !cdev->drv)
420 spin_lock_irq(cdev->ccwlock);
421 ret = ccw_device_online(cdev);
422 spin_unlock_irq(cdev->ccwlock);
424 wait_event(cdev->private->wait_q, dev_fsm_final_state(cdev));
426 CIO_MSG_EVENT(2, "ccw_device_online returned %d, "
427 "device 0.%x.%04x\n",
428 ret, cdev->private->dev_id.ssid,
429 cdev->private->dev_id.devno);
432 if (cdev->private->state != DEV_STATE_ONLINE)
434 if (!cdev->drv->set_online || cdev->drv->set_online(cdev) == 0) {
438 spin_lock_irq(cdev->ccwlock);
439 ret = ccw_device_offline(cdev);
440 spin_unlock_irq(cdev->ccwlock);
442 wait_event(cdev->private->wait_q, dev_fsm_final_state(cdev));
444 CIO_MSG_EVENT(2, "ccw_device_offline returned %d, "
445 "device 0.%x.%04x\n",
446 ret, cdev->private->dev_id.ssid,
447 cdev->private->dev_id.devno);
448 return (ret == 0) ? -ENODEV : ret;
451 static void online_store_handle_offline(struct ccw_device *cdev)
453 if (cdev->private->state == DEV_STATE_DISCONNECTED)
454 ccw_device_remove_disconnected(cdev);
455 else if (cdev->drv && cdev->drv->set_offline)
456 ccw_device_set_offline(cdev);
459 static int online_store_recog_and_online(struct ccw_device *cdev)
463 /* Do device recognition, if needed. */
464 if (cdev->id.cu_type == 0) {
465 ret = ccw_device_recognition(cdev);
467 CIO_MSG_EVENT(0, "Couldn't start recognition "
468 "for device 0.%x.%04x (ret=%d)\n",
469 cdev->private->dev_id.ssid,
470 cdev->private->dev_id.devno, ret);
473 wait_event(cdev->private->wait_q,
474 cdev->private->flags.recog_done);
476 if (cdev->drv && cdev->drv->set_online)
477 ccw_device_set_online(cdev);
480 static void online_store_handle_online(struct ccw_device *cdev, int force)
484 ret = online_store_recog_and_online(cdev);
487 if (force && cdev->private->state == DEV_STATE_BOXED) {
488 ret = ccw_device_stlck(cdev);
491 "ccw_device_stlck returned %d!\n", ret);
494 if (cdev->id.cu_type == 0)
495 cdev->private->state = DEV_STATE_NOT_OPER;
496 online_store_recog_and_online(cdev);
501 static ssize_t online_store (struct device *dev, struct device_attribute *attr,
502 const char *buf, size_t count)
504 struct ccw_device *cdev = to_ccwdev(dev);
508 if (atomic_cmpxchg(&cdev->private->onoff, 0, 1) != 0)
511 if (cdev->drv && !try_module_get(cdev->drv->owner)) {
512 atomic_set(&cdev->private->onoff, 0);
515 if (!strncmp(buf, "force\n", count)) {
520 i = simple_strtoul(buf, &tmp, 16);
525 online_store_handle_offline(cdev);
528 online_store_handle_online(cdev, force);
534 module_put(cdev->drv->owner);
535 atomic_set(&cdev->private->onoff, 0);
540 available_show (struct device *dev, struct device_attribute *attr, char *buf)
542 struct ccw_device *cdev = to_ccwdev(dev);
543 struct subchannel *sch;
545 if (ccw_device_is_orphan(cdev))
546 return sprintf(buf, "no device\n");
547 switch (cdev->private->state) {
548 case DEV_STATE_BOXED:
549 return sprintf(buf, "boxed\n");
550 case DEV_STATE_DISCONNECTED:
551 case DEV_STATE_DISCONNECTED_SENSE_ID:
552 case DEV_STATE_NOT_OPER:
553 sch = to_subchannel(dev->parent);
555 return sprintf(buf, "no path\n");
557 return sprintf(buf, "no device\n");
559 /* All other states considered fine. */
560 return sprintf(buf, "good\n");
564 static DEVICE_ATTR(chpids, 0444, chpids_show, NULL);
565 static DEVICE_ATTR(pimpampom, 0444, pimpampom_show, NULL);
566 static DEVICE_ATTR(devtype, 0444, devtype_show, NULL);
567 static DEVICE_ATTR(cutype, 0444, cutype_show, NULL);
568 static DEVICE_ATTR(modalias, 0444, modalias_show, NULL);
569 static DEVICE_ATTR(online, 0644, online_show, online_store);
570 extern struct device_attribute dev_attr_cmb_enable;
571 static DEVICE_ATTR(availability, 0444, available_show, NULL);
573 static struct attribute * subch_attrs[] = {
574 &dev_attr_chpids.attr,
575 &dev_attr_pimpampom.attr,
579 static struct attribute_group subch_attr_group = {
580 .attrs = subch_attrs,
583 struct attribute_group *subch_attr_groups[] = {
588 static struct attribute * ccwdev_attrs[] = {
589 &dev_attr_devtype.attr,
590 &dev_attr_cutype.attr,
591 &dev_attr_modalias.attr,
592 &dev_attr_online.attr,
593 &dev_attr_cmb_enable.attr,
594 &dev_attr_availability.attr,
598 static struct attribute_group ccwdev_attr_group = {
599 .attrs = ccwdev_attrs,
602 static struct attribute_group *ccwdev_attr_groups[] = {
607 /* this is a simple abstraction for device_register that sets the
608 * correct bus type and adds the bus specific files */
609 static int ccw_device_register(struct ccw_device *cdev)
611 struct device *dev = &cdev->dev;
614 dev->bus = &ccw_bus_type;
616 if ((ret = device_add(dev)))
619 set_bit(1, &cdev->private->registered);
624 struct ccw_dev_id dev_id;
625 struct ccw_device * sibling;
629 match_devno(struct device * dev, void * data)
631 struct match_data * d = data;
632 struct ccw_device * cdev;
634 cdev = to_ccwdev(dev);
635 if ((cdev->private->state == DEV_STATE_DISCONNECTED) &&
636 !ccw_device_is_orphan(cdev) &&
637 ccw_dev_id_is_equal(&cdev->private->dev_id, &d->dev_id) &&
638 (cdev != d->sibling))
643 static struct ccw_device * get_disc_ccwdev_by_dev_id(struct ccw_dev_id *dev_id,
644 struct ccw_device *sibling)
647 struct match_data data;
649 data.dev_id = *dev_id;
650 data.sibling = sibling;
651 dev = bus_find_device(&ccw_bus_type, NULL, &data, match_devno);
653 return dev ? to_ccwdev(dev) : NULL;
656 static int match_orphan(struct device *dev, void *data)
658 struct ccw_dev_id *dev_id;
659 struct ccw_device *cdev;
662 cdev = to_ccwdev(dev);
663 return ccw_dev_id_is_equal(&cdev->private->dev_id, dev_id);
666 static struct ccw_device *
667 get_orphaned_ccwdev_by_dev_id(struct channel_subsystem *css,
668 struct ccw_dev_id *dev_id)
672 dev = device_find_child(&css->pseudo_subchannel->dev, dev_id,
675 return dev ? to_ccwdev(dev) : NULL;
679 ccw_device_add_changed(struct work_struct *work)
681 struct ccw_device_private *priv;
682 struct ccw_device *cdev;
684 priv = container_of(work, struct ccw_device_private, kick_work);
686 if (device_add(&cdev->dev)) {
687 put_device(&cdev->dev);
690 set_bit(1, &cdev->private->registered);
693 void ccw_device_do_unreg_rereg(struct work_struct *work)
695 struct ccw_device_private *priv;
696 struct ccw_device *cdev;
697 struct subchannel *sch;
699 priv = container_of(work, struct ccw_device_private, kick_work);
701 sch = to_subchannel(cdev->dev.parent);
703 ccw_device_unregister(cdev);
704 PREPARE_WORK(&cdev->private->kick_work,
705 ccw_device_add_changed);
706 queue_work(ccw_device_work, &cdev->private->kick_work);
710 ccw_device_release(struct device *dev)
712 struct ccw_device *cdev;
714 cdev = to_ccwdev(dev);
715 kfree(cdev->private);
719 static struct ccw_device * io_subchannel_allocate_dev(struct subchannel *sch)
721 struct ccw_device *cdev;
723 cdev = kzalloc(sizeof(*cdev), GFP_KERNEL);
725 cdev->private = kzalloc(sizeof(struct ccw_device_private),
726 GFP_KERNEL | GFP_DMA);
731 return ERR_PTR(-ENOMEM);
734 static int io_subchannel_initialize_dev(struct subchannel *sch,
735 struct ccw_device *cdev)
737 cdev->private->cdev = cdev;
738 atomic_set(&cdev->private->onoff, 0);
739 cdev->dev.parent = &sch->dev;
740 cdev->dev.release = ccw_device_release;
741 INIT_WORK(&cdev->private->kick_work, NULL);
742 cdev->dev.groups = ccwdev_attr_groups;
743 /* Do first half of device_register. */
744 device_initialize(&cdev->dev);
745 if (!get_device(&sch->dev)) {
746 if (cdev->dev.release)
747 cdev->dev.release(&cdev->dev);
753 static struct ccw_device * io_subchannel_create_ccwdev(struct subchannel *sch)
755 struct ccw_device *cdev;
758 cdev = io_subchannel_allocate_dev(sch);
760 ret = io_subchannel_initialize_dev(sch, cdev);
769 static int io_subchannel_recog(struct ccw_device *, struct subchannel *);
771 static void sch_attach_device(struct subchannel *sch,
772 struct ccw_device *cdev)
774 css_update_ssd_info(sch);
775 spin_lock_irq(sch->lock);
776 sch->dev.driver_data = cdev;
777 cdev->private->schid = sch->schid;
778 cdev->ccwlock = sch->lock;
779 device_trigger_reprobe(sch);
780 spin_unlock_irq(sch->lock);
783 static void sch_attach_disconnected_device(struct subchannel *sch,
784 struct ccw_device *cdev)
786 struct subchannel *other_sch;
789 other_sch = to_subchannel(get_device(cdev->dev.parent));
790 ret = device_move(&cdev->dev, &sch->dev);
792 CIO_MSG_EVENT(2, "Moving disconnected device 0.%x.%04x failed "
793 "(ret=%d)!\n", cdev->private->dev_id.ssid,
794 cdev->private->dev_id.devno, ret);
795 put_device(&other_sch->dev);
798 other_sch->dev.driver_data = NULL;
799 /* No need to keep a subchannel without ccw device around. */
800 css_sch_device_unregister(other_sch);
801 put_device(&other_sch->dev);
802 sch_attach_device(sch, cdev);
805 static void sch_attach_orphaned_device(struct subchannel *sch,
806 struct ccw_device *cdev)
810 /* Try to move the ccw device to its new subchannel. */
811 ret = device_move(&cdev->dev, &sch->dev);
813 CIO_MSG_EVENT(0, "Moving device 0.%x.%04x from orphanage "
814 "failed (ret=%d)!\n",
815 cdev->private->dev_id.ssid,
816 cdev->private->dev_id.devno, ret);
819 sch_attach_device(sch, cdev);
822 static void sch_create_and_recog_new_device(struct subchannel *sch)
824 struct ccw_device *cdev;
826 /* Need to allocate a new ccw device. */
827 cdev = io_subchannel_create_ccwdev(sch);
829 /* OK, we did everything we could... */
830 css_sch_device_unregister(sch);
833 spin_lock_irq(sch->lock);
834 sch->dev.driver_data = cdev;
835 spin_unlock_irq(sch->lock);
836 /* Start recognition for the new ccw device. */
837 if (io_subchannel_recog(cdev, sch)) {
838 spin_lock_irq(sch->lock);
839 sch->dev.driver_data = NULL;
840 spin_unlock_irq(sch->lock);
841 if (cdev->dev.release)
842 cdev->dev.release(&cdev->dev);
843 css_sch_device_unregister(sch);
848 void ccw_device_move_to_orphanage(struct work_struct *work)
850 struct ccw_device_private *priv;
851 struct ccw_device *cdev;
852 struct ccw_device *replacing_cdev;
853 struct subchannel *sch;
855 struct channel_subsystem *css;
856 struct ccw_dev_id dev_id;
858 priv = container_of(work, struct ccw_device_private, kick_work);
860 sch = to_subchannel(cdev->dev.parent);
861 css = to_css(sch->dev.parent);
862 dev_id.devno = sch->schib.pmcw.dev;
863 dev_id.ssid = sch->schid.ssid;
866 * Move the orphaned ccw device to the orphanage so the replacing
867 * ccw device can take its place on the subchannel.
869 ret = device_move(&cdev->dev, &css->pseudo_subchannel->dev);
871 CIO_MSG_EVENT(0, "Moving device 0.%x.%04x to orphanage failed "
872 "(ret=%d)!\n", cdev->private->dev_id.ssid,
873 cdev->private->dev_id.devno, ret);
876 cdev->ccwlock = css->pseudo_subchannel->lock;
878 * Search for the replacing ccw device
879 * - among the disconnected devices
882 replacing_cdev = get_disc_ccwdev_by_dev_id(&dev_id, cdev);
883 if (replacing_cdev) {
884 sch_attach_disconnected_device(sch, replacing_cdev);
887 replacing_cdev = get_orphaned_ccwdev_by_dev_id(css, &dev_id);
888 if (replacing_cdev) {
889 sch_attach_orphaned_device(sch, replacing_cdev);
892 sch_create_and_recog_new_device(sch);
896 * Register recognized device.
899 io_subchannel_register(struct work_struct *work)
901 struct ccw_device_private *priv;
902 struct ccw_device *cdev;
903 struct subchannel *sch;
907 priv = container_of(work, struct ccw_device_private, kick_work);
909 sch = to_subchannel(cdev->dev.parent);
910 css_update_ssd_info(sch);
912 * io_subchannel_register() will also be called after device
913 * recognition has been done for a boxed device (which will already
914 * be registered). We need to reprobe since we may now have sense id
917 if (klist_node_attached(&cdev->dev.knode_parent)) {
919 ret = device_reprobe(&cdev->dev);
921 /* We can't do much here. */
922 CIO_MSG_EVENT(2, "device_reprobe() returned"
923 " %d for 0.%x.%04x\n", ret,
924 cdev->private->dev_id.ssid,
925 cdev->private->dev_id.devno);
930 * Now we know this subchannel will stay, we can throw
931 * our delayed uevent.
933 sch->dev.uevent_suppress = 0;
934 kobject_uevent(&sch->dev.kobj, KOBJ_ADD);
935 /* make it known to the system */
936 ret = ccw_device_register(cdev);
938 CIO_MSG_EVENT(0, "Could not register ccw dev 0.%x.%04x: %d\n",
939 cdev->private->dev_id.ssid,
940 cdev->private->dev_id.devno, ret);
941 put_device(&cdev->dev);
942 spin_lock_irqsave(sch->lock, flags);
943 sch->dev.driver_data = NULL;
944 spin_unlock_irqrestore(sch->lock, flags);
945 kfree (cdev->private);
947 put_device(&sch->dev);
948 if (atomic_dec_and_test(&ccw_device_init_count))
949 wake_up(&ccw_device_init_wq);
952 put_device(&cdev->dev);
954 cdev->private->flags.recog_done = 1;
955 put_device(&sch->dev);
956 wake_up(&cdev->private->wait_q);
957 if (atomic_dec_and_test(&ccw_device_init_count))
958 wake_up(&ccw_device_init_wq);
961 static void ccw_device_call_sch_unregister(struct work_struct *work)
963 struct ccw_device_private *priv;
964 struct ccw_device *cdev;
965 struct subchannel *sch;
967 priv = container_of(work, struct ccw_device_private, kick_work);
969 sch = to_subchannel(cdev->dev.parent);
970 css_sch_device_unregister(sch);
971 /* Reset intparm to zeroes. */
972 sch->schib.pmcw.intparm = 0;
974 put_device(&cdev->dev);
975 put_device(&sch->dev);
979 * subchannel recognition done. Called from the state machine.
982 io_subchannel_recog_done(struct ccw_device *cdev)
984 struct subchannel *sch;
986 if (css_init_done == 0) {
987 cdev->private->flags.recog_done = 1;
990 switch (cdev->private->state) {
991 case DEV_STATE_NOT_OPER:
992 cdev->private->flags.recog_done = 1;
993 /* Remove device found not operational. */
994 if (!get_device(&cdev->dev))
996 sch = to_subchannel(cdev->dev.parent);
997 PREPARE_WORK(&cdev->private->kick_work,
998 ccw_device_call_sch_unregister);
999 queue_work(slow_path_wq, &cdev->private->kick_work);
1000 if (atomic_dec_and_test(&ccw_device_init_count))
1001 wake_up(&ccw_device_init_wq);
1003 case DEV_STATE_BOXED:
1004 /* Device did not respond in time. */
1005 case DEV_STATE_OFFLINE:
1007 * We can't register the device in interrupt context so
1008 * we schedule a work item.
1010 if (!get_device(&cdev->dev))
1012 PREPARE_WORK(&cdev->private->kick_work,
1013 io_subchannel_register);
1014 queue_work(slow_path_wq, &cdev->private->kick_work);
1020 io_subchannel_recog(struct ccw_device *cdev, struct subchannel *sch)
1023 struct ccw_device_private *priv;
1025 sch->dev.driver_data = cdev;
1026 sch->driver = &io_subchannel_driver;
1027 cdev->ccwlock = sch->lock;
1029 /* Init private data. */
1030 priv = cdev->private;
1031 priv->dev_id.devno = sch->schib.pmcw.dev;
1032 priv->dev_id.ssid = sch->schid.ssid;
1033 priv->schid = sch->schid;
1034 priv->state = DEV_STATE_NOT_OPER;
1035 INIT_LIST_HEAD(&priv->cmb_list);
1036 init_waitqueue_head(&priv->wait_q);
1037 init_timer(&priv->timer);
1039 /* Set an initial name for the device. */
1040 snprintf (cdev->dev.bus_id, BUS_ID_SIZE, "0.%x.%04x",
1041 sch->schid.ssid, sch->schib.pmcw.dev);
1043 /* Increase counter of devices currently in recognition. */
1044 atomic_inc(&ccw_device_init_count);
1046 /* Start async. device sensing. */
1047 spin_lock_irq(sch->lock);
1048 rc = ccw_device_recognition(cdev);
1049 spin_unlock_irq(sch->lock);
1051 if (atomic_dec_and_test(&ccw_device_init_count))
1052 wake_up(&ccw_device_init_wq);
1057 static void ccw_device_move_to_sch(struct work_struct *work)
1059 struct ccw_device_private *priv;
1061 struct subchannel *sch;
1062 struct ccw_device *cdev;
1063 struct subchannel *former_parent;
1065 priv = container_of(work, struct ccw_device_private, kick_work);
1068 former_parent = ccw_device_is_orphan(cdev) ?
1069 NULL : to_subchannel(get_device(cdev->dev.parent));
1070 mutex_lock(&sch->reg_mutex);
1071 /* Try to move the ccw device to its new subchannel. */
1072 rc = device_move(&cdev->dev, &sch->dev);
1073 mutex_unlock(&sch->reg_mutex);
1075 CIO_MSG_EVENT(2, "Moving device 0.%x.%04x to subchannel "
1076 "0.%x.%04x failed (ret=%d)!\n",
1077 cdev->private->dev_id.ssid,
1078 cdev->private->dev_id.devno, sch->schid.ssid,
1079 sch->schid.sch_no, rc);
1080 css_sch_device_unregister(sch);
1083 if (former_parent) {
1084 spin_lock_irq(former_parent->lock);
1085 former_parent->dev.driver_data = NULL;
1086 spin_unlock_irq(former_parent->lock);
1087 css_sch_device_unregister(former_parent);
1088 /* Reset intparm to zeroes. */
1089 former_parent->schib.pmcw.intparm = 0;
1090 cio_modify(former_parent);
1092 sch_attach_device(sch, cdev);
1095 put_device(&former_parent->dev);
1096 put_device(&cdev->dev);
1100 io_subchannel_probe (struct subchannel *sch)
1102 struct ccw_device *cdev;
1104 unsigned long flags;
1105 struct ccw_dev_id dev_id;
1107 if (sch->dev.driver_data) {
1109 * This subchannel already has an associated ccw_device.
1110 * Register it and exit. This happens for all early
1111 * device, e.g. the console.
1113 cdev = sch->dev.driver_data;
1114 cdev->dev.groups = ccwdev_attr_groups;
1115 device_initialize(&cdev->dev);
1116 ccw_device_register(cdev);
1118 * Check if the device is already online. If it is
1119 * the reference count needs to be corrected
1120 * (see ccw_device_online and css_init_done for the
1123 if (cdev->private->state != DEV_STATE_NOT_OPER &&
1124 cdev->private->state != DEV_STATE_OFFLINE &&
1125 cdev->private->state != DEV_STATE_BOXED)
1126 get_device(&cdev->dev);
1130 * First check if a fitting device may be found amongst the
1131 * disconnected devices or in the orphanage.
1133 dev_id.devno = sch->schib.pmcw.dev;
1134 dev_id.ssid = sch->schid.ssid;
1135 cdev = get_disc_ccwdev_by_dev_id(&dev_id, NULL);
1137 cdev = get_orphaned_ccwdev_by_dev_id(to_css(sch->dev.parent),
1141 * Schedule moving the device until when we have a registered
1142 * subchannel to move to and succeed the probe. We can
1143 * unregister later again, when the probe is through.
1145 cdev->private->sch = sch;
1146 PREPARE_WORK(&cdev->private->kick_work,
1147 ccw_device_move_to_sch);
1148 queue_work(slow_path_wq, &cdev->private->kick_work);
1151 cdev = io_subchannel_create_ccwdev(sch);
1153 return PTR_ERR(cdev);
1155 rc = io_subchannel_recog(cdev, sch);
1157 spin_lock_irqsave(sch->lock, flags);
1158 sch->dev.driver_data = NULL;
1159 spin_unlock_irqrestore(sch->lock, flags);
1160 if (cdev->dev.release)
1161 cdev->dev.release(&cdev->dev);
1168 io_subchannel_remove (struct subchannel *sch)
1170 struct ccw_device *cdev;
1171 unsigned long flags;
1173 if (!sch->dev.driver_data)
1175 cdev = sch->dev.driver_data;
1176 /* Set ccw device to not operational and drop reference. */
1177 spin_lock_irqsave(cdev->ccwlock, flags);
1178 sch->dev.driver_data = NULL;
1179 cdev->private->state = DEV_STATE_NOT_OPER;
1180 spin_unlock_irqrestore(cdev->ccwlock, flags);
1181 ccw_device_unregister(cdev);
1182 put_device(&cdev->dev);
1187 io_subchannel_notify(struct device *dev, int event)
1189 struct ccw_device *cdev;
1191 cdev = dev->driver_data;
1198 return cdev->drv->notify ? cdev->drv->notify(cdev, event) : 0;
1202 io_subchannel_verify(struct device *dev)
1204 struct ccw_device *cdev;
1206 cdev = dev->driver_data;
1208 dev_fsm_event(cdev, DEV_EVENT_VERIFY);
1212 io_subchannel_ioterm(struct device *dev)
1214 struct ccw_device *cdev;
1216 cdev = dev->driver_data;
1219 /* Internal I/O will be retried by the interrupt handler. */
1220 if (cdev->private->flags.intretry)
1222 cdev->private->state = DEV_STATE_CLEAR_VERIFY;
1224 cdev->handler(cdev, cdev->private->intparm,
1229 io_subchannel_shutdown(struct subchannel *sch)
1231 struct ccw_device *cdev;
1234 cdev = sch->dev.driver_data;
1236 if (cio_is_console(sch->schid))
1238 if (!sch->schib.pmcw.ena)
1239 /* Nothing to do. */
1241 ret = cio_disable_subchannel(sch);
1243 /* Subchannel is disabled, we're done. */
1245 cdev->private->state = DEV_STATE_QUIESCE;
1247 cdev->handler(cdev, cdev->private->intparm,
1249 ret = ccw_device_cancel_halt_clear(cdev);
1250 if (ret == -EBUSY) {
1251 ccw_device_set_timeout(cdev, HZ/10);
1252 wait_event(cdev->private->wait_q, dev_fsm_final_state(cdev));
1254 cio_disable_subchannel(sch);
1257 #ifdef CONFIG_CCW_CONSOLE
1258 static struct ccw_device console_cdev;
1259 static struct ccw_device_private console_private;
1260 static int console_cdev_in_use;
1262 static DEFINE_SPINLOCK(ccw_console_lock);
1264 spinlock_t * cio_get_console_lock(void)
1266 return &ccw_console_lock;
1270 ccw_device_console_enable (struct ccw_device *cdev, struct subchannel *sch)
1274 /* Initialize the ccw_device structure. */
1275 cdev->dev.parent= &sch->dev;
1276 rc = io_subchannel_recog(cdev, sch);
1280 /* Now wait for the async. recognition to come to an end. */
1281 spin_lock_irq(cdev->ccwlock);
1282 while (!dev_fsm_final_state(cdev))
1285 if (cdev->private->state != DEV_STATE_OFFLINE)
1287 ccw_device_online(cdev);
1288 while (!dev_fsm_final_state(cdev))
1290 if (cdev->private->state != DEV_STATE_ONLINE)
1294 spin_unlock_irq(cdev->ccwlock);
1299 ccw_device_probe_console(void)
1301 struct subchannel *sch;
1304 if (xchg(&console_cdev_in_use, 1) != 0)
1305 return ERR_PTR(-EBUSY);
1306 sch = cio_probe_console();
1308 console_cdev_in_use = 0;
1309 return (void *) sch;
1311 memset(&console_cdev, 0, sizeof(struct ccw_device));
1312 memset(&console_private, 0, sizeof(struct ccw_device_private));
1313 console_cdev.private = &console_private;
1314 console_private.cdev = &console_cdev;
1315 ret = ccw_device_console_enable(&console_cdev, sch);
1317 cio_release_console();
1318 console_cdev_in_use = 0;
1319 return ERR_PTR(ret);
1321 console_cdev.online = 1;
1322 return &console_cdev;
1327 * get ccw_device matching the busid, but only if owned by cdrv
1330 __ccwdev_check_busid(struct device *dev, void *id)
1336 return (strncmp(bus_id, dev->bus_id, BUS_ID_SIZE) == 0);
1341 * get_ccwdev_by_busid() - obtain device from a bus id
1342 * @cdrv: driver the device is owned by
1343 * @bus_id: bus id of the device to be searched
1345 * This function searches all devices owned by @cdrv for a device with a bus
1346 * id matching @bus_id.
1348 * If a match is found, its reference count of the found device is increased
1349 * and it is returned; else %NULL is returned.
1351 struct ccw_device *get_ccwdev_by_busid(struct ccw_driver *cdrv,
1355 struct device_driver *drv;
1357 drv = get_driver(&cdrv->driver);
1361 dev = driver_find_device(drv, NULL, (void *)bus_id,
1362 __ccwdev_check_busid);
1365 return dev ? to_ccwdev(dev) : NULL;
1368 /************************** device driver handling ************************/
1370 /* This is the implementation of the ccw_driver class. The probe, remove
1371 * and release methods are initially very similar to the device_driver
1372 * implementations, with the difference that they have ccw_device
1375 * A ccw driver also contains the information that is needed for
1379 ccw_device_probe (struct device *dev)
1381 struct ccw_device *cdev = to_ccwdev(dev);
1382 struct ccw_driver *cdrv = to_ccwdrv(dev->driver);
1385 cdev->drv = cdrv; /* to let the driver call _set_online */
1387 ret = cdrv->probe ? cdrv->probe(cdev) : -ENODEV;
1398 ccw_device_remove (struct device *dev)
1400 struct ccw_device *cdev = to_ccwdev(dev);
1401 struct ccw_driver *cdrv = cdev->drv;
1408 spin_lock_irq(cdev->ccwlock);
1409 ret = ccw_device_offline(cdev);
1410 spin_unlock_irq(cdev->ccwlock);
1412 wait_event(cdev->private->wait_q,
1413 dev_fsm_final_state(cdev));
1415 //FIXME: we can't fail!
1416 CIO_MSG_EVENT(2, "ccw_device_offline returned %d, "
1417 "device 0.%x.%04x\n",
1418 ret, cdev->private->dev_id.ssid,
1419 cdev->private->dev_id.devno);
1421 ccw_device_set_timeout(cdev, 0);
1426 static void ccw_device_shutdown(struct device *dev)
1428 struct ccw_device *cdev;
1430 cdev = to_ccwdev(dev);
1431 if (cdev->drv && cdev->drv->shutdown)
1432 cdev->drv->shutdown(cdev);
1436 struct bus_type ccw_bus_type = {
1438 .match = ccw_bus_match,
1439 .uevent = ccw_uevent,
1440 .probe = ccw_device_probe,
1441 .remove = ccw_device_remove,
1442 .shutdown = ccw_device_shutdown,
1446 * ccw_driver_register() - register a ccw driver
1447 * @cdriver: driver to be registered
1449 * This function is mainly a wrapper around driver_register().
1451 * %0 on success and a negative error value on failure.
1453 int ccw_driver_register(struct ccw_driver *cdriver)
1455 struct device_driver *drv = &cdriver->driver;
1457 drv->bus = &ccw_bus_type;
1458 drv->name = cdriver->name;
1460 return driver_register(drv);
1464 * ccw_driver_unregister() - deregister a ccw driver
1465 * @cdriver: driver to be deregistered
1467 * This function is mainly a wrapper around driver_unregister().
1469 void ccw_driver_unregister(struct ccw_driver *cdriver)
1471 driver_unregister(&cdriver->driver);
1474 /* Helper func for qdio. */
1475 struct subchannel_id
1476 ccw_device_get_subchannel_id(struct ccw_device *cdev)
1478 struct subchannel *sch;
1480 sch = to_subchannel(cdev->dev.parent);
1484 MODULE_LICENSE("GPL");
1485 EXPORT_SYMBOL(ccw_device_set_online);
1486 EXPORT_SYMBOL(ccw_device_set_offline);
1487 EXPORT_SYMBOL(ccw_driver_register);
1488 EXPORT_SYMBOL(ccw_driver_unregister);
1489 EXPORT_SYMBOL(get_ccwdev_by_busid);
1490 EXPORT_SYMBOL(ccw_bus_type);
1491 EXPORT_SYMBOL(ccw_device_work);
1492 EXPORT_SYMBOL(ccw_device_notify_work);
1493 EXPORT_SYMBOL_GPL(ccw_device_get_subchannel_id);