Merge branch 'r6040-next'
[linux/fpc-iii.git] / drivers / s390 / cio / device.c
blob7ada078ffdd04b09c81cc45ddfab4057f397158d
1 /*
2 * bus driver for ccw devices
4 * Copyright IBM Corp. 2002, 2008
5 * Author(s): Arnd Bergmann (arndb@de.ibm.com)
6 * Cornelia Huck (cornelia.huck@de.ibm.com)
7 * Martin Schwidefsky (schwidefsky@de.ibm.com)
8 */
10 #define KMSG_COMPONENT "cio"
11 #define pr_fmt(fmt) KMSG_COMPONENT ": " fmt
13 #include <linux/module.h>
14 #include <linux/init.h>
15 #include <linux/spinlock.h>
16 #include <linux/errno.h>
17 #include <linux/err.h>
18 #include <linux/slab.h>
19 #include <linux/list.h>
20 #include <linux/device.h>
21 #include <linux/workqueue.h>
22 #include <linux/delay.h>
23 #include <linux/timer.h>
24 #include <linux/kernel_stat.h>
26 #include <asm/ccwdev.h>
27 #include <asm/cio.h>
28 #include <asm/param.h> /* HZ */
29 #include <asm/cmb.h>
30 #include <asm/isc.h>
32 #include "chp.h"
33 #include "cio.h"
34 #include "cio_debug.h"
35 #include "css.h"
36 #include "device.h"
37 #include "ioasm.h"
38 #include "io_sch.h"
39 #include "blacklist.h"
40 #include "chsc.h"
42 static struct timer_list recovery_timer;
43 static DEFINE_SPINLOCK(recovery_lock);
44 static int recovery_phase;
45 static const unsigned long recovery_delay[] = { 3, 30, 300 };
47 static atomic_t ccw_device_init_count = ATOMIC_INIT(0);
48 static DECLARE_WAIT_QUEUE_HEAD(ccw_device_init_wq);
49 static struct bus_type ccw_bus_type;
51 /******************* bus type handling ***********************/
53 /* The Linux driver model distinguishes between a bus type and
54 * the bus itself. Of course we only have one channel
55 * subsystem driver and one channel system per machine, but
56 * we still use the abstraction. T.R. says it's a good idea. */
57 static int
58 ccw_bus_match (struct device * dev, struct device_driver * drv)
60 struct ccw_device *cdev = to_ccwdev(dev);
61 struct ccw_driver *cdrv = to_ccwdrv(drv);
62 const struct ccw_device_id *ids = cdrv->ids, *found;
64 if (!ids)
65 return 0;
67 found = ccw_device_id_match(ids, &cdev->id);
68 if (!found)
69 return 0;
71 cdev->id.driver_info = found->driver_info;
73 return 1;
76 /* Store modalias string delimited by prefix/suffix string into buffer with
77 * specified size. Return length of resulting string (excluding trailing '\0')
78 * even if string doesn't fit buffer (snprintf semantics). */
79 static int snprint_alias(char *buf, size_t size,
80 struct ccw_device_id *id, const char *suffix)
82 int len;
84 len = snprintf(buf, size, "ccw:t%04Xm%02X", id->cu_type, id->cu_model);
85 if (len > size)
86 return len;
87 buf += len;
88 size -= len;
90 if (id->dev_type != 0)
91 len += snprintf(buf, size, "dt%04Xdm%02X%s", id->dev_type,
92 id->dev_model, suffix);
93 else
94 len += snprintf(buf, size, "dtdm%s", suffix);
96 return len;
99 /* Set up environment variables for ccw device uevent. Return 0 on success,
100 * non-zero otherwise. */
101 static int ccw_uevent(struct device *dev, struct kobj_uevent_env *env)
103 struct ccw_device *cdev = to_ccwdev(dev);
104 struct ccw_device_id *id = &(cdev->id);
105 int ret;
106 char modalias_buf[30];
108 /* CU_TYPE= */
109 ret = add_uevent_var(env, "CU_TYPE=%04X", id->cu_type);
110 if (ret)
111 return ret;
113 /* CU_MODEL= */
114 ret = add_uevent_var(env, "CU_MODEL=%02X", id->cu_model);
115 if (ret)
116 return ret;
118 /* The next two can be zero, that's ok for us */
119 /* DEV_TYPE= */
120 ret = add_uevent_var(env, "DEV_TYPE=%04X", id->dev_type);
121 if (ret)
122 return ret;
124 /* DEV_MODEL= */
125 ret = add_uevent_var(env, "DEV_MODEL=%02X", id->dev_model);
126 if (ret)
127 return ret;
129 /* MODALIAS= */
130 snprint_alias(modalias_buf, sizeof(modalias_buf), id, "");
131 ret = add_uevent_var(env, "MODALIAS=%s", modalias_buf);
132 return ret;
135 static void io_subchannel_irq(struct subchannel *);
136 static int io_subchannel_probe(struct subchannel *);
137 static int io_subchannel_remove(struct subchannel *);
138 static void io_subchannel_shutdown(struct subchannel *);
139 static int io_subchannel_sch_event(struct subchannel *, int);
140 static int io_subchannel_chp_event(struct subchannel *, struct chp_link *,
141 int);
142 static void recovery_func(unsigned long data);
144 static struct css_device_id io_subchannel_ids[] = {
145 { .match_flags = 0x1, .type = SUBCHANNEL_TYPE_IO, },
146 { /* end of list */ },
148 MODULE_DEVICE_TABLE(css, io_subchannel_ids);
150 static int io_subchannel_prepare(struct subchannel *sch)
152 struct ccw_device *cdev;
154 * Don't allow suspend while a ccw device registration
155 * is still outstanding.
157 cdev = sch_get_cdev(sch);
158 if (cdev && !device_is_registered(&cdev->dev))
159 return -EAGAIN;
160 return 0;
163 static int io_subchannel_settle(void)
165 int ret;
167 ret = wait_event_interruptible(ccw_device_init_wq,
168 atomic_read(&ccw_device_init_count) == 0);
169 if (ret)
170 return -EINTR;
171 flush_workqueue(cio_work_q);
172 return 0;
175 static struct css_driver io_subchannel_driver = {
176 .drv = {
177 .owner = THIS_MODULE,
178 .name = "io_subchannel",
180 .subchannel_type = io_subchannel_ids,
181 .irq = io_subchannel_irq,
182 .sch_event = io_subchannel_sch_event,
183 .chp_event = io_subchannel_chp_event,
184 .probe = io_subchannel_probe,
185 .remove = io_subchannel_remove,
186 .shutdown = io_subchannel_shutdown,
187 .prepare = io_subchannel_prepare,
188 .settle = io_subchannel_settle,
191 int __init io_subchannel_init(void)
193 int ret;
195 setup_timer(&recovery_timer, recovery_func, 0);
196 ret = bus_register(&ccw_bus_type);
197 if (ret)
198 return ret;
199 ret = css_driver_register(&io_subchannel_driver);
200 if (ret)
201 bus_unregister(&ccw_bus_type);
203 return ret;
207 /************************ device handling **************************/
210 * A ccw_device has some interfaces in sysfs in addition to the
211 * standard ones.
212 * The following entries are designed to export the information which
213 * resided in 2.4 in /proc/subchannels. Subchannel and device number
214 * are obvious, so they don't have an entry :)
215 * TODO: Split chpids and pimpampom up? Where is "in use" in the tree?
217 static ssize_t
218 chpids_show (struct device * dev, struct device_attribute *attr, char * buf)
220 struct subchannel *sch = to_subchannel(dev);
221 struct chsc_ssd_info *ssd = &sch->ssd_info;
222 ssize_t ret = 0;
223 int chp;
224 int mask;
226 for (chp = 0; chp < 8; chp++) {
227 mask = 0x80 >> chp;
228 if (ssd->path_mask & mask)
229 ret += sprintf(buf + ret, "%02x ", ssd->chpid[chp].id);
230 else
231 ret += sprintf(buf + ret, "00 ");
233 ret += sprintf (buf+ret, "\n");
234 return min((ssize_t)PAGE_SIZE, ret);
237 static ssize_t
238 pimpampom_show (struct device * dev, struct device_attribute *attr, char * buf)
240 struct subchannel *sch = to_subchannel(dev);
241 struct pmcw *pmcw = &sch->schib.pmcw;
243 return sprintf (buf, "%02x %02x %02x\n",
244 pmcw->pim, pmcw->pam, pmcw->pom);
247 static ssize_t
248 devtype_show (struct device *dev, struct device_attribute *attr, char *buf)
250 struct ccw_device *cdev = to_ccwdev(dev);
251 struct ccw_device_id *id = &(cdev->id);
253 if (id->dev_type != 0)
254 return sprintf(buf, "%04x/%02x\n",
255 id->dev_type, id->dev_model);
256 else
257 return sprintf(buf, "n/a\n");
260 static ssize_t
261 cutype_show (struct device *dev, struct device_attribute *attr, char *buf)
263 struct ccw_device *cdev = to_ccwdev(dev);
264 struct ccw_device_id *id = &(cdev->id);
266 return sprintf(buf, "%04x/%02x\n",
267 id->cu_type, id->cu_model);
270 static ssize_t
271 modalias_show (struct device *dev, struct device_attribute *attr, char *buf)
273 struct ccw_device *cdev = to_ccwdev(dev);
274 struct ccw_device_id *id = &(cdev->id);
275 int len;
277 len = snprint_alias(buf, PAGE_SIZE, id, "\n");
279 return len > PAGE_SIZE ? PAGE_SIZE : len;
282 static ssize_t
283 online_show (struct device *dev, struct device_attribute *attr, char *buf)
285 struct ccw_device *cdev = to_ccwdev(dev);
287 return sprintf(buf, cdev->online ? "1\n" : "0\n");
290 int ccw_device_is_orphan(struct ccw_device *cdev)
292 return sch_is_pseudo_sch(to_subchannel(cdev->dev.parent));
295 static void ccw_device_unregister(struct ccw_device *cdev)
297 if (device_is_registered(&cdev->dev)) {
298 /* Undo device_add(). */
299 device_del(&cdev->dev);
301 if (cdev->private->flags.initialized) {
302 cdev->private->flags.initialized = 0;
303 /* Release reference from device_initialize(). */
304 put_device(&cdev->dev);
308 static void io_subchannel_quiesce(struct subchannel *);
311 * ccw_device_set_offline() - disable a ccw device for I/O
312 * @cdev: target ccw device
314 * This function calls the driver's set_offline() function for @cdev, if
315 * given, and then disables @cdev.
316 * Returns:
317 * %0 on success and a negative error value on failure.
318 * Context:
319 * enabled, ccw device lock not held
321 int ccw_device_set_offline(struct ccw_device *cdev)
323 struct subchannel *sch;
324 int ret, state;
326 if (!cdev)
327 return -ENODEV;
328 if (!cdev->online || !cdev->drv)
329 return -EINVAL;
331 if (cdev->drv->set_offline) {
332 ret = cdev->drv->set_offline(cdev);
333 if (ret != 0)
334 return ret;
336 spin_lock_irq(cdev->ccwlock);
337 sch = to_subchannel(cdev->dev.parent);
338 cdev->online = 0;
339 /* Wait until a final state or DISCONNECTED is reached */
340 while (!dev_fsm_final_state(cdev) &&
341 cdev->private->state != DEV_STATE_DISCONNECTED) {
342 spin_unlock_irq(cdev->ccwlock);
343 wait_event(cdev->private->wait_q, (dev_fsm_final_state(cdev) ||
344 cdev->private->state == DEV_STATE_DISCONNECTED));
345 spin_lock_irq(cdev->ccwlock);
347 do {
348 ret = ccw_device_offline(cdev);
349 if (!ret)
350 break;
351 CIO_MSG_EVENT(0, "ccw_device_offline returned %d, device "
352 "0.%x.%04x\n", ret, cdev->private->dev_id.ssid,
353 cdev->private->dev_id.devno);
354 if (ret != -EBUSY)
355 goto error;
356 state = cdev->private->state;
357 spin_unlock_irq(cdev->ccwlock);
358 io_subchannel_quiesce(sch);
359 spin_lock_irq(cdev->ccwlock);
360 cdev->private->state = state;
361 } while (ret == -EBUSY);
362 spin_unlock_irq(cdev->ccwlock);
363 wait_event(cdev->private->wait_q, (dev_fsm_final_state(cdev) ||
364 cdev->private->state == DEV_STATE_DISCONNECTED));
365 /* Inform the user if set offline failed. */
366 if (cdev->private->state == DEV_STATE_BOXED) {
367 pr_warn("%s: The device entered boxed state while being set offline\n",
368 dev_name(&cdev->dev));
369 } else if (cdev->private->state == DEV_STATE_NOT_OPER) {
370 pr_warn("%s: The device stopped operating while being set offline\n",
371 dev_name(&cdev->dev));
373 /* Give up reference from ccw_device_set_online(). */
374 put_device(&cdev->dev);
375 return 0;
377 error:
378 cdev->private->state = DEV_STATE_OFFLINE;
379 dev_fsm_event(cdev, DEV_EVENT_NOTOPER);
380 spin_unlock_irq(cdev->ccwlock);
381 /* Give up reference from ccw_device_set_online(). */
382 put_device(&cdev->dev);
383 return -ENODEV;
387 * ccw_device_set_online() - enable a ccw device for I/O
388 * @cdev: target ccw device
390 * This function first enables @cdev and then calls the driver's set_online()
391 * function for @cdev, if given. If set_online() returns an error, @cdev is
392 * disabled again.
393 * Returns:
394 * %0 on success and a negative error value on failure.
395 * Context:
396 * enabled, ccw device lock not held
398 int ccw_device_set_online(struct ccw_device *cdev)
400 int ret;
401 int ret2;
403 if (!cdev)
404 return -ENODEV;
405 if (cdev->online || !cdev->drv)
406 return -EINVAL;
407 /* Hold on to an extra reference while device is online. */
408 if (!get_device(&cdev->dev))
409 return -ENODEV;
411 spin_lock_irq(cdev->ccwlock);
412 ret = ccw_device_online(cdev);
413 spin_unlock_irq(cdev->ccwlock);
414 if (ret == 0)
415 wait_event(cdev->private->wait_q, dev_fsm_final_state(cdev));
416 else {
417 CIO_MSG_EVENT(0, "ccw_device_online returned %d, "
418 "device 0.%x.%04x\n",
419 ret, cdev->private->dev_id.ssid,
420 cdev->private->dev_id.devno);
421 /* Give up online reference since onlining failed. */
422 put_device(&cdev->dev);
423 return ret;
425 spin_lock_irq(cdev->ccwlock);
426 /* Check if online processing was successful */
427 if ((cdev->private->state != DEV_STATE_ONLINE) &&
428 (cdev->private->state != DEV_STATE_W4SENSE)) {
429 spin_unlock_irq(cdev->ccwlock);
430 /* Inform the user that set online failed. */
431 if (cdev->private->state == DEV_STATE_BOXED) {
432 pr_warn("%s: Setting the device online failed because it is boxed\n",
433 dev_name(&cdev->dev));
434 } else if (cdev->private->state == DEV_STATE_NOT_OPER) {
435 pr_warn("%s: Setting the device online failed because it is not operational\n",
436 dev_name(&cdev->dev));
438 /* Give up online reference since onlining failed. */
439 put_device(&cdev->dev);
440 return -ENODEV;
442 spin_unlock_irq(cdev->ccwlock);
443 if (cdev->drv->set_online)
444 ret = cdev->drv->set_online(cdev);
445 if (ret)
446 goto rollback;
448 spin_lock_irq(cdev->ccwlock);
449 cdev->online = 1;
450 spin_unlock_irq(cdev->ccwlock);
451 return 0;
453 rollback:
454 spin_lock_irq(cdev->ccwlock);
455 /* Wait until a final state or DISCONNECTED is reached */
456 while (!dev_fsm_final_state(cdev) &&
457 cdev->private->state != DEV_STATE_DISCONNECTED) {
458 spin_unlock_irq(cdev->ccwlock);
459 wait_event(cdev->private->wait_q, (dev_fsm_final_state(cdev) ||
460 cdev->private->state == DEV_STATE_DISCONNECTED));
461 spin_lock_irq(cdev->ccwlock);
463 ret2 = ccw_device_offline(cdev);
464 if (ret2)
465 goto error;
466 spin_unlock_irq(cdev->ccwlock);
467 wait_event(cdev->private->wait_q, (dev_fsm_final_state(cdev) ||
468 cdev->private->state == DEV_STATE_DISCONNECTED));
469 /* Give up online reference since onlining failed. */
470 put_device(&cdev->dev);
471 return ret;
473 error:
474 CIO_MSG_EVENT(0, "rollback ccw_device_offline returned %d, "
475 "device 0.%x.%04x\n",
476 ret2, cdev->private->dev_id.ssid,
477 cdev->private->dev_id.devno);
478 cdev->private->state = DEV_STATE_OFFLINE;
479 spin_unlock_irq(cdev->ccwlock);
480 /* Give up online reference since onlining failed. */
481 put_device(&cdev->dev);
482 return ret;
485 static int online_store_handle_offline(struct ccw_device *cdev)
487 if (cdev->private->state == DEV_STATE_DISCONNECTED) {
488 spin_lock_irq(cdev->ccwlock);
489 ccw_device_sched_todo(cdev, CDEV_TODO_UNREG_EVAL);
490 spin_unlock_irq(cdev->ccwlock);
491 return 0;
493 if (cdev->drv && cdev->drv->set_offline)
494 return ccw_device_set_offline(cdev);
495 return -EINVAL;
498 static int online_store_recog_and_online(struct ccw_device *cdev)
500 /* Do device recognition, if needed. */
501 if (cdev->private->state == DEV_STATE_BOXED) {
502 spin_lock_irq(cdev->ccwlock);
503 ccw_device_recognition(cdev);
504 spin_unlock_irq(cdev->ccwlock);
505 wait_event(cdev->private->wait_q,
506 cdev->private->flags.recog_done);
507 if (cdev->private->state != DEV_STATE_OFFLINE)
508 /* recognition failed */
509 return -EAGAIN;
511 if (cdev->drv && cdev->drv->set_online)
512 return ccw_device_set_online(cdev);
513 return -EINVAL;
516 static int online_store_handle_online(struct ccw_device *cdev, int force)
518 int ret;
520 ret = online_store_recog_and_online(cdev);
521 if (ret && !force)
522 return ret;
523 if (force && cdev->private->state == DEV_STATE_BOXED) {
524 ret = ccw_device_stlck(cdev);
525 if (ret)
526 return ret;
527 if (cdev->id.cu_type == 0)
528 cdev->private->state = DEV_STATE_NOT_OPER;
529 ret = online_store_recog_and_online(cdev);
530 if (ret)
531 return ret;
533 return 0;
536 static ssize_t online_store (struct device *dev, struct device_attribute *attr,
537 const char *buf, size_t count)
539 struct ccw_device *cdev = to_ccwdev(dev);
540 int force, ret;
541 unsigned long i;
543 /* Prevent conflict between multiple on-/offline processing requests. */
544 if (atomic_cmpxchg(&cdev->private->onoff, 0, 1) != 0)
545 return -EAGAIN;
546 /* Prevent conflict between internal I/Os and on-/offline processing. */
547 if (!dev_fsm_final_state(cdev) &&
548 cdev->private->state != DEV_STATE_DISCONNECTED) {
549 ret = -EAGAIN;
550 goto out;
552 /* Prevent conflict between pending work and on-/offline processing.*/
553 if (work_pending(&cdev->private->todo_work)) {
554 ret = -EAGAIN;
555 goto out;
557 if (!strncmp(buf, "force\n", count)) {
558 force = 1;
559 i = 1;
560 ret = 0;
561 } else {
562 force = 0;
563 ret = kstrtoul(buf, 16, &i);
565 if (ret)
566 goto out;
568 device_lock(dev);
569 switch (i) {
570 case 0:
571 ret = online_store_handle_offline(cdev);
572 break;
573 case 1:
574 ret = online_store_handle_online(cdev, force);
575 break;
576 default:
577 ret = -EINVAL;
579 device_unlock(dev);
581 out:
582 atomic_set(&cdev->private->onoff, 0);
583 return (ret < 0) ? ret : count;
586 static ssize_t
587 available_show (struct device *dev, struct device_attribute *attr, char *buf)
589 struct ccw_device *cdev = to_ccwdev(dev);
590 struct subchannel *sch;
592 if (ccw_device_is_orphan(cdev))
593 return sprintf(buf, "no device\n");
594 switch (cdev->private->state) {
595 case DEV_STATE_BOXED:
596 return sprintf(buf, "boxed\n");
597 case DEV_STATE_DISCONNECTED:
598 case DEV_STATE_DISCONNECTED_SENSE_ID:
599 case DEV_STATE_NOT_OPER:
600 sch = to_subchannel(dev->parent);
601 if (!sch->lpm)
602 return sprintf(buf, "no path\n");
603 else
604 return sprintf(buf, "no device\n");
605 default:
606 /* All other states considered fine. */
607 return sprintf(buf, "good\n");
611 static ssize_t
612 initiate_logging(struct device *dev, struct device_attribute *attr,
613 const char *buf, size_t count)
615 struct subchannel *sch = to_subchannel(dev);
616 int rc;
618 rc = chsc_siosl(sch->schid);
619 if (rc < 0) {
620 pr_warn("Logging for subchannel 0.%x.%04x failed with errno=%d\n",
621 sch->schid.ssid, sch->schid.sch_no, rc);
622 return rc;
624 pr_notice("Logging for subchannel 0.%x.%04x was triggered\n",
625 sch->schid.ssid, sch->schid.sch_no);
626 return count;
629 static ssize_t vpm_show(struct device *dev, struct device_attribute *attr,
630 char *buf)
632 struct subchannel *sch = to_subchannel(dev);
634 return sprintf(buf, "%02x\n", sch->vpm);
637 static DEVICE_ATTR(chpids, 0444, chpids_show, NULL);
638 static DEVICE_ATTR(pimpampom, 0444, pimpampom_show, NULL);
639 static DEVICE_ATTR(devtype, 0444, devtype_show, NULL);
640 static DEVICE_ATTR(cutype, 0444, cutype_show, NULL);
641 static DEVICE_ATTR(modalias, 0444, modalias_show, NULL);
642 static DEVICE_ATTR(online, 0644, online_show, online_store);
643 static DEVICE_ATTR(availability, 0444, available_show, NULL);
644 static DEVICE_ATTR(logging, 0200, NULL, initiate_logging);
645 static DEVICE_ATTR(vpm, 0444, vpm_show, NULL);
647 static struct attribute *io_subchannel_attrs[] = {
648 &dev_attr_chpids.attr,
649 &dev_attr_pimpampom.attr,
650 &dev_attr_logging.attr,
651 &dev_attr_vpm.attr,
652 NULL,
655 static struct attribute_group io_subchannel_attr_group = {
656 .attrs = io_subchannel_attrs,
659 static struct attribute * ccwdev_attrs[] = {
660 &dev_attr_devtype.attr,
661 &dev_attr_cutype.attr,
662 &dev_attr_modalias.attr,
663 &dev_attr_online.attr,
664 &dev_attr_cmb_enable.attr,
665 &dev_attr_availability.attr,
666 NULL,
669 static struct attribute_group ccwdev_attr_group = {
670 .attrs = ccwdev_attrs,
673 static const struct attribute_group *ccwdev_attr_groups[] = {
674 &ccwdev_attr_group,
675 NULL,
678 static int ccw_device_add(struct ccw_device *cdev)
680 struct device *dev = &cdev->dev;
682 dev->bus = &ccw_bus_type;
683 return device_add(dev);
686 static int match_dev_id(struct device *dev, void *data)
688 struct ccw_device *cdev = to_ccwdev(dev);
689 struct ccw_dev_id *dev_id = data;
691 return ccw_dev_id_is_equal(&cdev->private->dev_id, dev_id);
695 * get_ccwdev_by_dev_id() - obtain device from a ccw device id
696 * @dev_id: id of the device to be searched
698 * This function searches all devices attached to the ccw bus for a device
699 * matching @dev_id.
700 * Returns:
701 * If a device is found its reference count is increased and returned;
702 * else %NULL is returned.
704 struct ccw_device *get_ccwdev_by_dev_id(struct ccw_dev_id *dev_id)
706 struct device *dev;
708 dev = bus_find_device(&ccw_bus_type, NULL, dev_id, match_dev_id);
710 return dev ? to_ccwdev(dev) : NULL;
712 EXPORT_SYMBOL_GPL(get_ccwdev_by_dev_id);
714 static void ccw_device_do_unbind_bind(struct ccw_device *cdev)
716 int ret;
718 if (device_is_registered(&cdev->dev)) {
719 device_release_driver(&cdev->dev);
720 ret = device_attach(&cdev->dev);
721 WARN_ON(ret == -ENODEV);
725 static void
726 ccw_device_release(struct device *dev)
728 struct ccw_device *cdev;
730 cdev = to_ccwdev(dev);
731 /* Release reference of parent subchannel. */
732 put_device(cdev->dev.parent);
733 kfree(cdev->private);
734 kfree(cdev);
737 static struct ccw_device * io_subchannel_allocate_dev(struct subchannel *sch)
739 struct ccw_device *cdev;
741 cdev = kzalloc(sizeof(*cdev), GFP_KERNEL);
742 if (cdev) {
743 cdev->private = kzalloc(sizeof(struct ccw_device_private),
744 GFP_KERNEL | GFP_DMA);
745 if (cdev->private)
746 return cdev;
748 kfree(cdev);
749 return ERR_PTR(-ENOMEM);
752 static void ccw_device_todo(struct work_struct *work);
754 static int io_subchannel_initialize_dev(struct subchannel *sch,
755 struct ccw_device *cdev)
757 struct ccw_device_private *priv = cdev->private;
758 int ret;
760 priv->cdev = cdev;
761 priv->int_class = IRQIO_CIO;
762 priv->state = DEV_STATE_NOT_OPER;
763 priv->dev_id.devno = sch->schib.pmcw.dev;
764 priv->dev_id.ssid = sch->schid.ssid;
765 priv->schid = sch->schid;
767 INIT_WORK(&priv->todo_work, ccw_device_todo);
768 INIT_LIST_HEAD(&priv->cmb_list);
769 init_waitqueue_head(&priv->wait_q);
770 init_timer(&priv->timer);
772 atomic_set(&priv->onoff, 0);
773 cdev->ccwlock = sch->lock;
774 cdev->dev.parent = &sch->dev;
775 cdev->dev.release = ccw_device_release;
776 cdev->dev.groups = ccwdev_attr_groups;
777 /* Do first half of device_register. */
778 device_initialize(&cdev->dev);
779 ret = dev_set_name(&cdev->dev, "0.%x.%04x", cdev->private->dev_id.ssid,
780 cdev->private->dev_id.devno);
781 if (ret)
782 goto out_put;
783 if (!get_device(&sch->dev)) {
784 ret = -ENODEV;
785 goto out_put;
787 priv->flags.initialized = 1;
788 spin_lock_irq(sch->lock);
789 sch_set_cdev(sch, cdev);
790 spin_unlock_irq(sch->lock);
791 return 0;
793 out_put:
794 /* Release reference from device_initialize(). */
795 put_device(&cdev->dev);
796 return ret;
799 static struct ccw_device * io_subchannel_create_ccwdev(struct subchannel *sch)
801 struct ccw_device *cdev;
802 int ret;
804 cdev = io_subchannel_allocate_dev(sch);
805 if (!IS_ERR(cdev)) {
806 ret = io_subchannel_initialize_dev(sch, cdev);
807 if (ret)
808 cdev = ERR_PTR(ret);
810 return cdev;
813 static void io_subchannel_recog(struct ccw_device *, struct subchannel *);
815 static void sch_create_and_recog_new_device(struct subchannel *sch)
817 struct ccw_device *cdev;
819 /* Need to allocate a new ccw device. */
820 cdev = io_subchannel_create_ccwdev(sch);
821 if (IS_ERR(cdev)) {
822 /* OK, we did everything we could... */
823 css_sch_device_unregister(sch);
824 return;
826 /* Start recognition for the new ccw device. */
827 io_subchannel_recog(cdev, sch);
831 * Register recognized device.
833 static void io_subchannel_register(struct ccw_device *cdev)
835 struct subchannel *sch;
836 int ret, adjust_init_count = 1;
837 unsigned long flags;
839 sch = to_subchannel(cdev->dev.parent);
841 * Check if subchannel is still registered. It may have become
842 * unregistered if a machine check hit us after finishing
843 * device recognition but before the register work could be
844 * queued.
846 if (!device_is_registered(&sch->dev))
847 goto out_err;
848 css_update_ssd_info(sch);
850 * io_subchannel_register() will also be called after device
851 * recognition has been done for a boxed device (which will already
852 * be registered). We need to reprobe since we may now have sense id
853 * information.
855 if (device_is_registered(&cdev->dev)) {
856 if (!cdev->drv) {
857 ret = device_reprobe(&cdev->dev);
858 if (ret)
859 /* We can't do much here. */
860 CIO_MSG_EVENT(0, "device_reprobe() returned"
861 " %d for 0.%x.%04x\n", ret,
862 cdev->private->dev_id.ssid,
863 cdev->private->dev_id.devno);
865 adjust_init_count = 0;
866 goto out;
869 * Now we know this subchannel will stay, we can throw
870 * our delayed uevent.
872 dev_set_uevent_suppress(&sch->dev, 0);
873 kobject_uevent(&sch->dev.kobj, KOBJ_ADD);
874 /* make it known to the system */
875 ret = ccw_device_add(cdev);
876 if (ret) {
877 CIO_MSG_EVENT(0, "Could not register ccw dev 0.%x.%04x: %d\n",
878 cdev->private->dev_id.ssid,
879 cdev->private->dev_id.devno, ret);
880 spin_lock_irqsave(sch->lock, flags);
881 sch_set_cdev(sch, NULL);
882 spin_unlock_irqrestore(sch->lock, flags);
883 /* Release initial device reference. */
884 put_device(&cdev->dev);
885 goto out_err;
887 out:
888 cdev->private->flags.recog_done = 1;
889 wake_up(&cdev->private->wait_q);
890 out_err:
891 if (adjust_init_count && atomic_dec_and_test(&ccw_device_init_count))
892 wake_up(&ccw_device_init_wq);
895 static void ccw_device_call_sch_unregister(struct ccw_device *cdev)
897 struct subchannel *sch;
899 /* Get subchannel reference for local processing. */
900 if (!get_device(cdev->dev.parent))
901 return;
902 sch = to_subchannel(cdev->dev.parent);
903 css_sch_device_unregister(sch);
904 /* Release subchannel reference for local processing. */
905 put_device(&sch->dev);
909 * subchannel recognition done. Called from the state machine.
911 void
912 io_subchannel_recog_done(struct ccw_device *cdev)
914 if (css_init_done == 0) {
915 cdev->private->flags.recog_done = 1;
916 return;
918 switch (cdev->private->state) {
919 case DEV_STATE_BOXED:
920 /* Device did not respond in time. */
921 case DEV_STATE_NOT_OPER:
922 cdev->private->flags.recog_done = 1;
923 /* Remove device found not operational. */
924 ccw_device_sched_todo(cdev, CDEV_TODO_UNREG);
925 if (atomic_dec_and_test(&ccw_device_init_count))
926 wake_up(&ccw_device_init_wq);
927 break;
928 case DEV_STATE_OFFLINE:
930 * We can't register the device in interrupt context so
931 * we schedule a work item.
933 ccw_device_sched_todo(cdev, CDEV_TODO_REGISTER);
934 break;
938 static void io_subchannel_recog(struct ccw_device *cdev, struct subchannel *sch)
940 /* Increase counter of devices currently in recognition. */
941 atomic_inc(&ccw_device_init_count);
943 /* Start async. device sensing. */
944 spin_lock_irq(sch->lock);
945 ccw_device_recognition(cdev);
946 spin_unlock_irq(sch->lock);
949 static int ccw_device_move_to_sch(struct ccw_device *cdev,
950 struct subchannel *sch)
952 struct subchannel *old_sch;
953 int rc, old_enabled = 0;
955 old_sch = to_subchannel(cdev->dev.parent);
956 /* Obtain child reference for new parent. */
957 if (!get_device(&sch->dev))
958 return -ENODEV;
960 if (!sch_is_pseudo_sch(old_sch)) {
961 spin_lock_irq(old_sch->lock);
962 old_enabled = old_sch->schib.pmcw.ena;
963 rc = 0;
964 if (old_enabled)
965 rc = cio_disable_subchannel(old_sch);
966 spin_unlock_irq(old_sch->lock);
967 if (rc == -EBUSY) {
968 /* Release child reference for new parent. */
969 put_device(&sch->dev);
970 return rc;
974 mutex_lock(&sch->reg_mutex);
975 rc = device_move(&cdev->dev, &sch->dev, DPM_ORDER_PARENT_BEFORE_DEV);
976 mutex_unlock(&sch->reg_mutex);
977 if (rc) {
978 CIO_MSG_EVENT(0, "device_move(0.%x.%04x,0.%x.%04x)=%d\n",
979 cdev->private->dev_id.ssid,
980 cdev->private->dev_id.devno, sch->schid.ssid,
981 sch->schib.pmcw.dev, rc);
982 if (old_enabled) {
983 /* Try to reenable the old subchannel. */
984 spin_lock_irq(old_sch->lock);
985 cio_enable_subchannel(old_sch, (u32)(addr_t)old_sch);
986 spin_unlock_irq(old_sch->lock);
988 /* Release child reference for new parent. */
989 put_device(&sch->dev);
990 return rc;
992 /* Clean up old subchannel. */
993 if (!sch_is_pseudo_sch(old_sch)) {
994 spin_lock_irq(old_sch->lock);
995 sch_set_cdev(old_sch, NULL);
996 spin_unlock_irq(old_sch->lock);
997 css_schedule_eval(old_sch->schid);
999 /* Release child reference for old parent. */
1000 put_device(&old_sch->dev);
1001 /* Initialize new subchannel. */
1002 spin_lock_irq(sch->lock);
1003 cdev->private->schid = sch->schid;
1004 cdev->ccwlock = sch->lock;
1005 if (!sch_is_pseudo_sch(sch))
1006 sch_set_cdev(sch, cdev);
1007 spin_unlock_irq(sch->lock);
1008 if (!sch_is_pseudo_sch(sch))
1009 css_update_ssd_info(sch);
1010 return 0;
1013 static int ccw_device_move_to_orph(struct ccw_device *cdev)
1015 struct subchannel *sch = to_subchannel(cdev->dev.parent);
1016 struct channel_subsystem *css = to_css(sch->dev.parent);
1018 return ccw_device_move_to_sch(cdev, css->pseudo_subchannel);
1021 static void io_subchannel_irq(struct subchannel *sch)
1023 struct ccw_device *cdev;
1025 cdev = sch_get_cdev(sch);
1027 CIO_TRACE_EVENT(6, "IRQ");
1028 CIO_TRACE_EVENT(6, dev_name(&sch->dev));
1029 if (cdev)
1030 dev_fsm_event(cdev, DEV_EVENT_INTERRUPT);
1031 else
1032 inc_irq_stat(IRQIO_CIO);
1035 void io_subchannel_init_config(struct subchannel *sch)
1037 memset(&sch->config, 0, sizeof(sch->config));
1038 sch->config.csense = 1;
1041 static void io_subchannel_init_fields(struct subchannel *sch)
1043 if (cio_is_console(sch->schid))
1044 sch->opm = 0xff;
1045 else
1046 sch->opm = chp_get_sch_opm(sch);
1047 sch->lpm = sch->schib.pmcw.pam & sch->opm;
1048 sch->isc = cio_is_console(sch->schid) ? CONSOLE_ISC : IO_SCH_ISC;
1050 CIO_MSG_EVENT(6, "Detected device %04x on subchannel 0.%x.%04X"
1051 " - PIM = %02X, PAM = %02X, POM = %02X\n",
1052 sch->schib.pmcw.dev, sch->schid.ssid,
1053 sch->schid.sch_no, sch->schib.pmcw.pim,
1054 sch->schib.pmcw.pam, sch->schib.pmcw.pom);
1056 io_subchannel_init_config(sch);
1060 * Note: We always return 0 so that we bind to the device even on error.
1061 * This is needed so that our remove function is called on unregister.
1063 static int io_subchannel_probe(struct subchannel *sch)
1065 struct io_subchannel_private *io_priv;
1066 struct ccw_device *cdev;
1067 int rc;
1069 if (cio_is_console(sch->schid)) {
1070 rc = sysfs_create_group(&sch->dev.kobj,
1071 &io_subchannel_attr_group);
1072 if (rc)
1073 CIO_MSG_EVENT(0, "Failed to create io subchannel "
1074 "attributes for subchannel "
1075 "0.%x.%04x (rc=%d)\n",
1076 sch->schid.ssid, sch->schid.sch_no, rc);
1078 * The console subchannel already has an associated ccw_device.
1079 * Throw the delayed uevent for the subchannel, register
1080 * the ccw_device and exit.
1082 dev_set_uevent_suppress(&sch->dev, 0);
1083 kobject_uevent(&sch->dev.kobj, KOBJ_ADD);
1084 cdev = sch_get_cdev(sch);
1085 rc = ccw_device_add(cdev);
1086 if (rc) {
1087 /* Release online reference. */
1088 put_device(&cdev->dev);
1089 goto out_schedule;
1091 if (atomic_dec_and_test(&ccw_device_init_count))
1092 wake_up(&ccw_device_init_wq);
1093 return 0;
1095 io_subchannel_init_fields(sch);
1096 rc = cio_commit_config(sch);
1097 if (rc)
1098 goto out_schedule;
1099 rc = sysfs_create_group(&sch->dev.kobj,
1100 &io_subchannel_attr_group);
1101 if (rc)
1102 goto out_schedule;
1103 /* Allocate I/O subchannel private data. */
1104 io_priv = kzalloc(sizeof(*io_priv), GFP_KERNEL | GFP_DMA);
1105 if (!io_priv)
1106 goto out_schedule;
1108 set_io_private(sch, io_priv);
1109 css_schedule_eval(sch->schid);
1110 return 0;
1112 out_schedule:
1113 spin_lock_irq(sch->lock);
1114 css_sched_sch_todo(sch, SCH_TODO_UNREG);
1115 spin_unlock_irq(sch->lock);
1116 return 0;
1119 static int
1120 io_subchannel_remove (struct subchannel *sch)
1122 struct io_subchannel_private *io_priv = to_io_private(sch);
1123 struct ccw_device *cdev;
1125 cdev = sch_get_cdev(sch);
1126 if (!cdev)
1127 goto out_free;
1128 io_subchannel_quiesce(sch);
1129 /* Set ccw device to not operational and drop reference. */
1130 spin_lock_irq(cdev->ccwlock);
1131 sch_set_cdev(sch, NULL);
1132 set_io_private(sch, NULL);
1133 cdev->private->state = DEV_STATE_NOT_OPER;
1134 spin_unlock_irq(cdev->ccwlock);
1135 ccw_device_unregister(cdev);
1136 out_free:
1137 kfree(io_priv);
1138 sysfs_remove_group(&sch->dev.kobj, &io_subchannel_attr_group);
1139 return 0;
1142 static void io_subchannel_verify(struct subchannel *sch)
1144 struct ccw_device *cdev;
1146 cdev = sch_get_cdev(sch);
1147 if (cdev)
1148 dev_fsm_event(cdev, DEV_EVENT_VERIFY);
1151 static void io_subchannel_terminate_path(struct subchannel *sch, u8 mask)
1153 struct ccw_device *cdev;
1155 cdev = sch_get_cdev(sch);
1156 if (!cdev)
1157 return;
1158 if (cio_update_schib(sch))
1159 goto err;
1160 /* Check for I/O on path. */
1161 if (scsw_actl(&sch->schib.scsw) == 0 || sch->schib.pmcw.lpum != mask)
1162 goto out;
1163 if (cdev->private->state == DEV_STATE_ONLINE) {
1164 ccw_device_kill_io(cdev);
1165 goto out;
1167 if (cio_clear(sch))
1168 goto err;
1169 out:
1170 /* Trigger path verification. */
1171 dev_fsm_event(cdev, DEV_EVENT_VERIFY);
1172 return;
1174 err:
1175 dev_fsm_event(cdev, DEV_EVENT_NOTOPER);
1178 static int io_subchannel_chp_event(struct subchannel *sch,
1179 struct chp_link *link, int event)
1181 struct ccw_device *cdev = sch_get_cdev(sch);
1182 int mask;
1184 mask = chp_ssd_get_mask(&sch->ssd_info, link);
1185 if (!mask)
1186 return 0;
1187 switch (event) {
1188 case CHP_VARY_OFF:
1189 sch->opm &= ~mask;
1190 sch->lpm &= ~mask;
1191 if (cdev)
1192 cdev->private->path_gone_mask |= mask;
1193 io_subchannel_terminate_path(sch, mask);
1194 break;
1195 case CHP_VARY_ON:
1196 sch->opm |= mask;
1197 sch->lpm |= mask;
1198 if (cdev)
1199 cdev->private->path_new_mask |= mask;
1200 io_subchannel_verify(sch);
1201 break;
1202 case CHP_OFFLINE:
1203 if (cio_update_schib(sch))
1204 return -ENODEV;
1205 if (cdev)
1206 cdev->private->path_gone_mask |= mask;
1207 io_subchannel_terminate_path(sch, mask);
1208 break;
1209 case CHP_ONLINE:
1210 if (cio_update_schib(sch))
1211 return -ENODEV;
1212 sch->lpm |= mask & sch->opm;
1213 if (cdev)
1214 cdev->private->path_new_mask |= mask;
1215 io_subchannel_verify(sch);
1216 break;
1218 return 0;
1221 static void io_subchannel_quiesce(struct subchannel *sch)
1223 struct ccw_device *cdev;
1224 int ret;
1226 spin_lock_irq(sch->lock);
1227 cdev = sch_get_cdev(sch);
1228 if (cio_is_console(sch->schid))
1229 goto out_unlock;
1230 if (!sch->schib.pmcw.ena)
1231 goto out_unlock;
1232 ret = cio_disable_subchannel(sch);
1233 if (ret != -EBUSY)
1234 goto out_unlock;
1235 if (cdev->handler)
1236 cdev->handler(cdev, cdev->private->intparm, ERR_PTR(-EIO));
1237 while (ret == -EBUSY) {
1238 cdev->private->state = DEV_STATE_QUIESCE;
1239 cdev->private->iretry = 255;
1240 ret = ccw_device_cancel_halt_clear(cdev);
1241 if (ret == -EBUSY) {
1242 ccw_device_set_timeout(cdev, HZ/10);
1243 spin_unlock_irq(sch->lock);
1244 wait_event(cdev->private->wait_q,
1245 cdev->private->state != DEV_STATE_QUIESCE);
1246 spin_lock_irq(sch->lock);
1248 ret = cio_disable_subchannel(sch);
1250 out_unlock:
1251 spin_unlock_irq(sch->lock);
1254 static void io_subchannel_shutdown(struct subchannel *sch)
1256 io_subchannel_quiesce(sch);
1259 static int device_is_disconnected(struct ccw_device *cdev)
1261 if (!cdev)
1262 return 0;
1263 return (cdev->private->state == DEV_STATE_DISCONNECTED ||
1264 cdev->private->state == DEV_STATE_DISCONNECTED_SENSE_ID);
1267 static int recovery_check(struct device *dev, void *data)
1269 struct ccw_device *cdev = to_ccwdev(dev);
1270 int *redo = data;
1272 spin_lock_irq(cdev->ccwlock);
1273 switch (cdev->private->state) {
1274 case DEV_STATE_DISCONNECTED:
1275 CIO_MSG_EVENT(3, "recovery: trigger 0.%x.%04x\n",
1276 cdev->private->dev_id.ssid,
1277 cdev->private->dev_id.devno);
1278 dev_fsm_event(cdev, DEV_EVENT_VERIFY);
1279 *redo = 1;
1280 break;
1281 case DEV_STATE_DISCONNECTED_SENSE_ID:
1282 *redo = 1;
1283 break;
1285 spin_unlock_irq(cdev->ccwlock);
1287 return 0;
1290 static void recovery_work_func(struct work_struct *unused)
1292 int redo = 0;
1294 bus_for_each_dev(&ccw_bus_type, NULL, &redo, recovery_check);
1295 if (redo) {
1296 spin_lock_irq(&recovery_lock);
1297 if (!timer_pending(&recovery_timer)) {
1298 if (recovery_phase < ARRAY_SIZE(recovery_delay) - 1)
1299 recovery_phase++;
1300 mod_timer(&recovery_timer, jiffies +
1301 recovery_delay[recovery_phase] * HZ);
1303 spin_unlock_irq(&recovery_lock);
1304 } else
1305 CIO_MSG_EVENT(4, "recovery: end\n");
1308 static DECLARE_WORK(recovery_work, recovery_work_func);
1310 static void recovery_func(unsigned long data)
1313 * We can't do our recovery in softirq context and it's not
1314 * performance critical, so we schedule it.
1316 schedule_work(&recovery_work);
1319 static void ccw_device_schedule_recovery(void)
1321 unsigned long flags;
1323 CIO_MSG_EVENT(4, "recovery: schedule\n");
1324 spin_lock_irqsave(&recovery_lock, flags);
1325 if (!timer_pending(&recovery_timer) || (recovery_phase != 0)) {
1326 recovery_phase = 0;
1327 mod_timer(&recovery_timer, jiffies + recovery_delay[0] * HZ);
1329 spin_unlock_irqrestore(&recovery_lock, flags);
1332 static int purge_fn(struct device *dev, void *data)
1334 struct ccw_device *cdev = to_ccwdev(dev);
1335 struct ccw_dev_id *id = &cdev->private->dev_id;
1337 spin_lock_irq(cdev->ccwlock);
1338 if (is_blacklisted(id->ssid, id->devno) &&
1339 (cdev->private->state == DEV_STATE_OFFLINE) &&
1340 (atomic_cmpxchg(&cdev->private->onoff, 0, 1) == 0)) {
1341 CIO_MSG_EVENT(3, "ccw: purging 0.%x.%04x\n", id->ssid,
1342 id->devno);
1343 ccw_device_sched_todo(cdev, CDEV_TODO_UNREG);
1344 atomic_set(&cdev->private->onoff, 0);
1346 spin_unlock_irq(cdev->ccwlock);
1347 /* Abort loop in case of pending signal. */
1348 if (signal_pending(current))
1349 return -EINTR;
1351 return 0;
1355 * ccw_purge_blacklisted - purge unused, blacklisted devices
1357 * Unregister all ccw devices that are offline and on the blacklist.
1359 int ccw_purge_blacklisted(void)
1361 CIO_MSG_EVENT(2, "ccw: purging blacklisted devices\n");
1362 bus_for_each_dev(&ccw_bus_type, NULL, NULL, purge_fn);
1363 return 0;
1366 void ccw_device_set_disconnected(struct ccw_device *cdev)
1368 if (!cdev)
1369 return;
1370 ccw_device_set_timeout(cdev, 0);
1371 cdev->private->flags.fake_irb = 0;
1372 cdev->private->state = DEV_STATE_DISCONNECTED;
1373 if (cdev->online)
1374 ccw_device_schedule_recovery();
1377 void ccw_device_set_notoper(struct ccw_device *cdev)
1379 struct subchannel *sch = to_subchannel(cdev->dev.parent);
1381 CIO_TRACE_EVENT(2, "notoper");
1382 CIO_TRACE_EVENT(2, dev_name(&sch->dev));
1383 ccw_device_set_timeout(cdev, 0);
1384 cio_disable_subchannel(sch);
1385 cdev->private->state = DEV_STATE_NOT_OPER;
1388 enum io_sch_action {
1389 IO_SCH_UNREG,
1390 IO_SCH_ORPH_UNREG,
1391 IO_SCH_ATTACH,
1392 IO_SCH_UNREG_ATTACH,
1393 IO_SCH_ORPH_ATTACH,
1394 IO_SCH_REPROBE,
1395 IO_SCH_VERIFY,
1396 IO_SCH_DISC,
1397 IO_SCH_NOP,
1400 static enum io_sch_action sch_get_action(struct subchannel *sch)
1402 struct ccw_device *cdev;
1404 cdev = sch_get_cdev(sch);
1405 if (cio_update_schib(sch)) {
1406 /* Not operational. */
1407 if (!cdev)
1408 return IO_SCH_UNREG;
1409 if (ccw_device_notify(cdev, CIO_GONE) != NOTIFY_OK)
1410 return IO_SCH_UNREG;
1411 return IO_SCH_ORPH_UNREG;
1413 /* Operational. */
1414 if (!cdev)
1415 return IO_SCH_ATTACH;
1416 if (sch->schib.pmcw.dev != cdev->private->dev_id.devno) {
1417 if (ccw_device_notify(cdev, CIO_GONE) != NOTIFY_OK)
1418 return IO_SCH_UNREG_ATTACH;
1419 return IO_SCH_ORPH_ATTACH;
1421 if ((sch->schib.pmcw.pam & sch->opm) == 0) {
1422 if (ccw_device_notify(cdev, CIO_NO_PATH) != NOTIFY_OK)
1423 return IO_SCH_UNREG;
1424 return IO_SCH_DISC;
1426 if (device_is_disconnected(cdev))
1427 return IO_SCH_REPROBE;
1428 if (cdev->online && !cdev->private->flags.resuming)
1429 return IO_SCH_VERIFY;
1430 if (cdev->private->state == DEV_STATE_NOT_OPER)
1431 return IO_SCH_UNREG_ATTACH;
1432 return IO_SCH_NOP;
1436 * io_subchannel_sch_event - process subchannel event
1437 * @sch: subchannel
1438 * @process: non-zero if function is called in process context
1440 * An unspecified event occurred for this subchannel. Adjust data according
1441 * to the current operational state of the subchannel and device. Return
1442 * zero when the event has been handled sufficiently or -EAGAIN when this
1443 * function should be called again in process context.
1445 static int io_subchannel_sch_event(struct subchannel *sch, int process)
1447 unsigned long flags;
1448 struct ccw_device *cdev;
1449 struct ccw_dev_id dev_id;
1450 enum io_sch_action action;
1451 int rc = -EAGAIN;
1453 spin_lock_irqsave(sch->lock, flags);
1454 if (!device_is_registered(&sch->dev))
1455 goto out_unlock;
1456 if (work_pending(&sch->todo_work))
1457 goto out_unlock;
1458 cdev = sch_get_cdev(sch);
1459 if (cdev && work_pending(&cdev->private->todo_work))
1460 goto out_unlock;
1461 action = sch_get_action(sch);
1462 CIO_MSG_EVENT(2, "event: sch 0.%x.%04x, process=%d, action=%d\n",
1463 sch->schid.ssid, sch->schid.sch_no, process,
1464 action);
1465 /* Perform immediate actions while holding the lock. */
1466 switch (action) {
1467 case IO_SCH_REPROBE:
1468 /* Trigger device recognition. */
1469 ccw_device_trigger_reprobe(cdev);
1470 rc = 0;
1471 goto out_unlock;
1472 case IO_SCH_VERIFY:
1473 /* Trigger path verification. */
1474 io_subchannel_verify(sch);
1475 rc = 0;
1476 goto out_unlock;
1477 case IO_SCH_DISC:
1478 ccw_device_set_disconnected(cdev);
1479 rc = 0;
1480 goto out_unlock;
1481 case IO_SCH_ORPH_UNREG:
1482 case IO_SCH_ORPH_ATTACH:
1483 ccw_device_set_disconnected(cdev);
1484 break;
1485 case IO_SCH_UNREG_ATTACH:
1486 case IO_SCH_UNREG:
1487 if (!cdev)
1488 break;
1489 if (cdev->private->state == DEV_STATE_SENSE_ID) {
1491 * Note: delayed work triggered by this event
1492 * and repeated calls to sch_event are synchronized
1493 * by the above check for work_pending(cdev).
1495 dev_fsm_event(cdev, DEV_EVENT_NOTOPER);
1496 } else
1497 ccw_device_set_notoper(cdev);
1498 break;
1499 case IO_SCH_NOP:
1500 rc = 0;
1501 goto out_unlock;
1502 default:
1503 break;
1505 spin_unlock_irqrestore(sch->lock, flags);
1506 /* All other actions require process context. */
1507 if (!process)
1508 goto out;
1509 /* Handle attached ccw device. */
1510 switch (action) {
1511 case IO_SCH_ORPH_UNREG:
1512 case IO_SCH_ORPH_ATTACH:
1513 /* Move ccw device to orphanage. */
1514 rc = ccw_device_move_to_orph(cdev);
1515 if (rc)
1516 goto out;
1517 break;
1518 case IO_SCH_UNREG_ATTACH:
1519 spin_lock_irqsave(sch->lock, flags);
1520 if (cdev->private->flags.resuming) {
1521 /* Device will be handled later. */
1522 rc = 0;
1523 goto out_unlock;
1525 sch_set_cdev(sch, NULL);
1526 spin_unlock_irqrestore(sch->lock, flags);
1527 /* Unregister ccw device. */
1528 ccw_device_unregister(cdev);
1529 break;
1530 default:
1531 break;
1533 /* Handle subchannel. */
1534 switch (action) {
1535 case IO_SCH_ORPH_UNREG:
1536 case IO_SCH_UNREG:
1537 if (!cdev || !cdev->private->flags.resuming)
1538 css_sch_device_unregister(sch);
1539 break;
1540 case IO_SCH_ORPH_ATTACH:
1541 case IO_SCH_UNREG_ATTACH:
1542 case IO_SCH_ATTACH:
1543 dev_id.ssid = sch->schid.ssid;
1544 dev_id.devno = sch->schib.pmcw.dev;
1545 cdev = get_ccwdev_by_dev_id(&dev_id);
1546 if (!cdev) {
1547 sch_create_and_recog_new_device(sch);
1548 break;
1550 rc = ccw_device_move_to_sch(cdev, sch);
1551 if (rc) {
1552 /* Release reference from get_ccwdev_by_dev_id() */
1553 put_device(&cdev->dev);
1554 goto out;
1556 spin_lock_irqsave(sch->lock, flags);
1557 ccw_device_trigger_reprobe(cdev);
1558 spin_unlock_irqrestore(sch->lock, flags);
1559 /* Release reference from get_ccwdev_by_dev_id() */
1560 put_device(&cdev->dev);
1561 break;
1562 default:
1563 break;
1565 return 0;
1567 out_unlock:
1568 spin_unlock_irqrestore(sch->lock, flags);
1569 out:
1570 return rc;
1573 static void ccw_device_set_int_class(struct ccw_device *cdev)
1575 struct ccw_driver *cdrv = cdev->drv;
1577 /* Note: we interpret class 0 in this context as an uninitialized
1578 * field since it translates to a non-I/O interrupt class. */
1579 if (cdrv->int_class != 0)
1580 cdev->private->int_class = cdrv->int_class;
1581 else
1582 cdev->private->int_class = IRQIO_CIO;
1585 #ifdef CONFIG_CCW_CONSOLE
1586 int __init ccw_device_enable_console(struct ccw_device *cdev)
1588 struct subchannel *sch = to_subchannel(cdev->dev.parent);
1589 int rc;
1591 if (!cdev->drv || !cdev->handler)
1592 return -EINVAL;
1594 io_subchannel_init_fields(sch);
1595 rc = cio_commit_config(sch);
1596 if (rc)
1597 return rc;
1598 sch->driver = &io_subchannel_driver;
1599 io_subchannel_recog(cdev, sch);
1600 /* Now wait for the async. recognition to come to an end. */
1601 spin_lock_irq(cdev->ccwlock);
1602 while (!dev_fsm_final_state(cdev))
1603 ccw_device_wait_idle(cdev);
1605 /* Hold on to an extra reference while device is online. */
1606 get_device(&cdev->dev);
1607 rc = ccw_device_online(cdev);
1608 if (rc)
1609 goto out_unlock;
1611 while (!dev_fsm_final_state(cdev))
1612 ccw_device_wait_idle(cdev);
1614 if (cdev->private->state == DEV_STATE_ONLINE)
1615 cdev->online = 1;
1616 else
1617 rc = -EIO;
1618 out_unlock:
1619 spin_unlock_irq(cdev->ccwlock);
1620 if (rc) /* Give up online reference since onlining failed. */
1621 put_device(&cdev->dev);
1622 return rc;
1625 struct ccw_device * __init ccw_device_create_console(struct ccw_driver *drv)
1627 struct io_subchannel_private *io_priv;
1628 struct ccw_device *cdev;
1629 struct subchannel *sch;
1631 sch = cio_probe_console();
1632 if (IS_ERR(sch))
1633 return ERR_CAST(sch);
1635 io_priv = kzalloc(sizeof(*io_priv), GFP_KERNEL | GFP_DMA);
1636 if (!io_priv) {
1637 put_device(&sch->dev);
1638 return ERR_PTR(-ENOMEM);
1640 set_io_private(sch, io_priv);
1641 cdev = io_subchannel_create_ccwdev(sch);
1642 if (IS_ERR(cdev)) {
1643 put_device(&sch->dev);
1644 kfree(io_priv);
1645 return cdev;
1647 cdev->drv = drv;
1648 ccw_device_set_int_class(cdev);
1649 return cdev;
1652 void __init ccw_device_destroy_console(struct ccw_device *cdev)
1654 struct subchannel *sch = to_subchannel(cdev->dev.parent);
1655 struct io_subchannel_private *io_priv = to_io_private(sch);
1657 set_io_private(sch, NULL);
1658 put_device(&sch->dev);
1659 put_device(&cdev->dev);
1660 kfree(io_priv);
1664 * ccw_device_wait_idle() - busy wait for device to become idle
1665 * @cdev: ccw device
1667 * Poll until activity control is zero, that is, no function or data
1668 * transfer is pending/active.
1669 * Called with device lock being held.
1671 void ccw_device_wait_idle(struct ccw_device *cdev)
1673 struct subchannel *sch = to_subchannel(cdev->dev.parent);
1675 while (1) {
1676 cio_tsch(sch);
1677 if (sch->schib.scsw.cmd.actl == 0)
1678 break;
1679 udelay_simple(100);
1683 static int ccw_device_pm_restore(struct device *dev);
1685 int ccw_device_force_console(struct ccw_device *cdev)
1687 return ccw_device_pm_restore(&cdev->dev);
1689 EXPORT_SYMBOL_GPL(ccw_device_force_console);
1690 #endif
1693 * get ccw_device matching the busid, but only if owned by cdrv
1695 static int
1696 __ccwdev_check_busid(struct device *dev, void *id)
1698 char *bus_id;
1700 bus_id = id;
1702 return (strcmp(bus_id, dev_name(dev)) == 0);
1707 * get_ccwdev_by_busid() - obtain device from a bus id
1708 * @cdrv: driver the device is owned by
1709 * @bus_id: bus id of the device to be searched
1711 * This function searches all devices owned by @cdrv for a device with a bus
1712 * id matching @bus_id.
1713 * Returns:
1714 * If a match is found, its reference count of the found device is increased
1715 * and it is returned; else %NULL is returned.
1717 struct ccw_device *get_ccwdev_by_busid(struct ccw_driver *cdrv,
1718 const char *bus_id)
1720 struct device *dev;
1722 dev = driver_find_device(&cdrv->driver, NULL, (void *)bus_id,
1723 __ccwdev_check_busid);
1725 return dev ? to_ccwdev(dev) : NULL;
1728 /************************** device driver handling ************************/
1730 /* This is the implementation of the ccw_driver class. The probe, remove
1731 * and release methods are initially very similar to the device_driver
1732 * implementations, with the difference that they have ccw_device
1733 * arguments.
1735 * A ccw driver also contains the information that is needed for
1736 * device matching.
1738 static int
1739 ccw_device_probe (struct device *dev)
1741 struct ccw_device *cdev = to_ccwdev(dev);
1742 struct ccw_driver *cdrv = to_ccwdrv(dev->driver);
1743 int ret;
1745 cdev->drv = cdrv; /* to let the driver call _set_online */
1746 ccw_device_set_int_class(cdev);
1747 ret = cdrv->probe ? cdrv->probe(cdev) : -ENODEV;
1748 if (ret) {
1749 cdev->drv = NULL;
1750 cdev->private->int_class = IRQIO_CIO;
1751 return ret;
1754 return 0;
1757 static int ccw_device_remove(struct device *dev)
1759 struct ccw_device *cdev = to_ccwdev(dev);
1760 struct ccw_driver *cdrv = cdev->drv;
1761 int ret;
1763 if (cdrv->remove)
1764 cdrv->remove(cdev);
1766 spin_lock_irq(cdev->ccwlock);
1767 if (cdev->online) {
1768 cdev->online = 0;
1769 ret = ccw_device_offline(cdev);
1770 spin_unlock_irq(cdev->ccwlock);
1771 if (ret == 0)
1772 wait_event(cdev->private->wait_q,
1773 dev_fsm_final_state(cdev));
1774 else
1775 CIO_MSG_EVENT(0, "ccw_device_offline returned %d, "
1776 "device 0.%x.%04x\n",
1777 ret, cdev->private->dev_id.ssid,
1778 cdev->private->dev_id.devno);
1779 /* Give up reference obtained in ccw_device_set_online(). */
1780 put_device(&cdev->dev);
1781 spin_lock_irq(cdev->ccwlock);
1783 ccw_device_set_timeout(cdev, 0);
1784 cdev->drv = NULL;
1785 cdev->private->int_class = IRQIO_CIO;
1786 spin_unlock_irq(cdev->ccwlock);
1787 __disable_cmf(cdev);
1789 return 0;
1792 static void ccw_device_shutdown(struct device *dev)
1794 struct ccw_device *cdev;
1796 cdev = to_ccwdev(dev);
1797 if (cdev->drv && cdev->drv->shutdown)
1798 cdev->drv->shutdown(cdev);
1799 __disable_cmf(cdev);
1802 static int ccw_device_pm_prepare(struct device *dev)
1804 struct ccw_device *cdev = to_ccwdev(dev);
1806 if (work_pending(&cdev->private->todo_work))
1807 return -EAGAIN;
1808 /* Fail while device is being set online/offline. */
1809 if (atomic_read(&cdev->private->onoff))
1810 return -EAGAIN;
1812 if (cdev->online && cdev->drv && cdev->drv->prepare)
1813 return cdev->drv->prepare(cdev);
1815 return 0;
1818 static void ccw_device_pm_complete(struct device *dev)
1820 struct ccw_device *cdev = to_ccwdev(dev);
1822 if (cdev->online && cdev->drv && cdev->drv->complete)
1823 cdev->drv->complete(cdev);
1826 static int ccw_device_pm_freeze(struct device *dev)
1828 struct ccw_device *cdev = to_ccwdev(dev);
1829 struct subchannel *sch = to_subchannel(cdev->dev.parent);
1830 int ret, cm_enabled;
1832 /* Fail suspend while device is in transistional state. */
1833 if (!dev_fsm_final_state(cdev))
1834 return -EAGAIN;
1835 if (!cdev->online)
1836 return 0;
1837 if (cdev->drv && cdev->drv->freeze) {
1838 ret = cdev->drv->freeze(cdev);
1839 if (ret)
1840 return ret;
1843 spin_lock_irq(sch->lock);
1844 cm_enabled = cdev->private->cmb != NULL;
1845 spin_unlock_irq(sch->lock);
1846 if (cm_enabled) {
1847 /* Don't have the css write on memory. */
1848 ret = ccw_set_cmf(cdev, 0);
1849 if (ret)
1850 return ret;
1852 /* From here on, disallow device driver I/O. */
1853 spin_lock_irq(sch->lock);
1854 ret = cio_disable_subchannel(sch);
1855 spin_unlock_irq(sch->lock);
1857 return ret;
1860 static int ccw_device_pm_thaw(struct device *dev)
1862 struct ccw_device *cdev = to_ccwdev(dev);
1863 struct subchannel *sch = to_subchannel(cdev->dev.parent);
1864 int ret, cm_enabled;
1866 if (!cdev->online)
1867 return 0;
1869 spin_lock_irq(sch->lock);
1870 /* Allow device driver I/O again. */
1871 ret = cio_enable_subchannel(sch, (u32)(addr_t)sch);
1872 cm_enabled = cdev->private->cmb != NULL;
1873 spin_unlock_irq(sch->lock);
1874 if (ret)
1875 return ret;
1877 if (cm_enabled) {
1878 ret = ccw_set_cmf(cdev, 1);
1879 if (ret)
1880 return ret;
1883 if (cdev->drv && cdev->drv->thaw)
1884 ret = cdev->drv->thaw(cdev);
1886 return ret;
1889 static void __ccw_device_pm_restore(struct ccw_device *cdev)
1891 struct subchannel *sch = to_subchannel(cdev->dev.parent);
1893 spin_lock_irq(sch->lock);
1894 if (cio_is_console(sch->schid)) {
1895 cio_enable_subchannel(sch, (u32)(addr_t)sch);
1896 goto out_unlock;
1899 * While we were sleeping, devices may have gone or become
1900 * available again. Kick re-detection.
1902 cdev->private->flags.resuming = 1;
1903 cdev->private->path_new_mask = LPM_ANYPATH;
1904 css_sched_sch_todo(sch, SCH_TODO_EVAL);
1905 spin_unlock_irq(sch->lock);
1906 css_wait_for_slow_path();
1908 /* cdev may have been moved to a different subchannel. */
1909 sch = to_subchannel(cdev->dev.parent);
1910 spin_lock_irq(sch->lock);
1911 if (cdev->private->state != DEV_STATE_ONLINE &&
1912 cdev->private->state != DEV_STATE_OFFLINE)
1913 goto out_unlock;
1915 ccw_device_recognition(cdev);
1916 spin_unlock_irq(sch->lock);
1917 wait_event(cdev->private->wait_q, dev_fsm_final_state(cdev) ||
1918 cdev->private->state == DEV_STATE_DISCONNECTED);
1919 spin_lock_irq(sch->lock);
1921 out_unlock:
1922 cdev->private->flags.resuming = 0;
1923 spin_unlock_irq(sch->lock);
1926 static int resume_handle_boxed(struct ccw_device *cdev)
1928 cdev->private->state = DEV_STATE_BOXED;
1929 if (ccw_device_notify(cdev, CIO_BOXED) == NOTIFY_OK)
1930 return 0;
1931 ccw_device_sched_todo(cdev, CDEV_TODO_UNREG);
1932 return -ENODEV;
1935 static int resume_handle_disc(struct ccw_device *cdev)
1937 cdev->private->state = DEV_STATE_DISCONNECTED;
1938 if (ccw_device_notify(cdev, CIO_GONE) == NOTIFY_OK)
1939 return 0;
1940 ccw_device_sched_todo(cdev, CDEV_TODO_UNREG);
1941 return -ENODEV;
1944 static int ccw_device_pm_restore(struct device *dev)
1946 struct ccw_device *cdev = to_ccwdev(dev);
1947 struct subchannel *sch;
1948 int ret = 0;
1950 __ccw_device_pm_restore(cdev);
1951 sch = to_subchannel(cdev->dev.parent);
1952 spin_lock_irq(sch->lock);
1953 if (cio_is_console(sch->schid))
1954 goto out_restore;
1956 /* check recognition results */
1957 switch (cdev->private->state) {
1958 case DEV_STATE_OFFLINE:
1959 case DEV_STATE_ONLINE:
1960 cdev->private->flags.donotify = 0;
1961 break;
1962 case DEV_STATE_BOXED:
1963 ret = resume_handle_boxed(cdev);
1964 if (ret)
1965 goto out_unlock;
1966 goto out_restore;
1967 default:
1968 ret = resume_handle_disc(cdev);
1969 if (ret)
1970 goto out_unlock;
1971 goto out_restore;
1973 /* check if the device type has changed */
1974 if (!ccw_device_test_sense_data(cdev)) {
1975 ccw_device_update_sense_data(cdev);
1976 ccw_device_sched_todo(cdev, CDEV_TODO_REBIND);
1977 ret = -ENODEV;
1978 goto out_unlock;
1980 if (!cdev->online)
1981 goto out_unlock;
1983 if (ccw_device_online(cdev)) {
1984 ret = resume_handle_disc(cdev);
1985 if (ret)
1986 goto out_unlock;
1987 goto out_restore;
1989 spin_unlock_irq(sch->lock);
1990 wait_event(cdev->private->wait_q, dev_fsm_final_state(cdev));
1991 spin_lock_irq(sch->lock);
1993 if (ccw_device_notify(cdev, CIO_OPER) == NOTIFY_BAD) {
1994 ccw_device_sched_todo(cdev, CDEV_TODO_UNREG);
1995 ret = -ENODEV;
1996 goto out_unlock;
1999 /* reenable cmf, if needed */
2000 if (cdev->private->cmb) {
2001 spin_unlock_irq(sch->lock);
2002 ret = ccw_set_cmf(cdev, 1);
2003 spin_lock_irq(sch->lock);
2004 if (ret) {
2005 CIO_MSG_EVENT(2, "resume: cdev 0.%x.%04x: cmf failed "
2006 "(rc=%d)\n", cdev->private->dev_id.ssid,
2007 cdev->private->dev_id.devno, ret);
2008 ret = 0;
2012 out_restore:
2013 spin_unlock_irq(sch->lock);
2014 if (cdev->online && cdev->drv && cdev->drv->restore)
2015 ret = cdev->drv->restore(cdev);
2016 return ret;
2018 out_unlock:
2019 spin_unlock_irq(sch->lock);
2020 return ret;
2023 static const struct dev_pm_ops ccw_pm_ops = {
2024 .prepare = ccw_device_pm_prepare,
2025 .complete = ccw_device_pm_complete,
2026 .freeze = ccw_device_pm_freeze,
2027 .thaw = ccw_device_pm_thaw,
2028 .restore = ccw_device_pm_restore,
2031 static struct bus_type ccw_bus_type = {
2032 .name = "ccw",
2033 .match = ccw_bus_match,
2034 .uevent = ccw_uevent,
2035 .probe = ccw_device_probe,
2036 .remove = ccw_device_remove,
2037 .shutdown = ccw_device_shutdown,
2038 .pm = &ccw_pm_ops,
2042 * ccw_driver_register() - register a ccw driver
2043 * @cdriver: driver to be registered
2045 * This function is mainly a wrapper around driver_register().
2046 * Returns:
2047 * %0 on success and a negative error value on failure.
2049 int ccw_driver_register(struct ccw_driver *cdriver)
2051 struct device_driver *drv = &cdriver->driver;
2053 drv->bus = &ccw_bus_type;
2055 return driver_register(drv);
2059 * ccw_driver_unregister() - deregister a ccw driver
2060 * @cdriver: driver to be deregistered
2062 * This function is mainly a wrapper around driver_unregister().
2064 void ccw_driver_unregister(struct ccw_driver *cdriver)
2066 driver_unregister(&cdriver->driver);
2069 static void ccw_device_todo(struct work_struct *work)
2071 struct ccw_device_private *priv;
2072 struct ccw_device *cdev;
2073 struct subchannel *sch;
2074 enum cdev_todo todo;
2076 priv = container_of(work, struct ccw_device_private, todo_work);
2077 cdev = priv->cdev;
2078 sch = to_subchannel(cdev->dev.parent);
2079 /* Find out todo. */
2080 spin_lock_irq(cdev->ccwlock);
2081 todo = priv->todo;
2082 priv->todo = CDEV_TODO_NOTHING;
2083 CIO_MSG_EVENT(4, "cdev_todo: cdev=0.%x.%04x todo=%d\n",
2084 priv->dev_id.ssid, priv->dev_id.devno, todo);
2085 spin_unlock_irq(cdev->ccwlock);
2086 /* Perform todo. */
2087 switch (todo) {
2088 case CDEV_TODO_ENABLE_CMF:
2089 cmf_reenable(cdev);
2090 break;
2091 case CDEV_TODO_REBIND:
2092 ccw_device_do_unbind_bind(cdev);
2093 break;
2094 case CDEV_TODO_REGISTER:
2095 io_subchannel_register(cdev);
2096 break;
2097 case CDEV_TODO_UNREG_EVAL:
2098 if (!sch_is_pseudo_sch(sch))
2099 css_schedule_eval(sch->schid);
2100 /* fall-through */
2101 case CDEV_TODO_UNREG:
2102 if (sch_is_pseudo_sch(sch))
2103 ccw_device_unregister(cdev);
2104 else
2105 ccw_device_call_sch_unregister(cdev);
2106 break;
2107 default:
2108 break;
2110 /* Release workqueue ref. */
2111 put_device(&cdev->dev);
2115 * ccw_device_sched_todo - schedule ccw device operation
2116 * @cdev: ccw device
2117 * @todo: todo
2119 * Schedule the operation identified by @todo to be performed on the slow path
2120 * workqueue. Do nothing if another operation with higher priority is already
2121 * scheduled. Needs to be called with ccwdev lock held.
2123 void ccw_device_sched_todo(struct ccw_device *cdev, enum cdev_todo todo)
2125 CIO_MSG_EVENT(4, "cdev_todo: sched cdev=0.%x.%04x todo=%d\n",
2126 cdev->private->dev_id.ssid, cdev->private->dev_id.devno,
2127 todo);
2128 if (cdev->private->todo >= todo)
2129 return;
2130 cdev->private->todo = todo;
2131 /* Get workqueue ref. */
2132 if (!get_device(&cdev->dev))
2133 return;
2134 if (!queue_work(cio_work_q, &cdev->private->todo_work)) {
2135 /* Already queued, release workqueue ref. */
2136 put_device(&cdev->dev);
2141 * ccw_device_siosl() - initiate logging
2142 * @cdev: ccw device
2144 * This function is used to invoke model-dependent logging within the channel
2145 * subsystem.
2147 int ccw_device_siosl(struct ccw_device *cdev)
2149 struct subchannel *sch = to_subchannel(cdev->dev.parent);
2151 return chsc_siosl(sch->schid);
2153 EXPORT_SYMBOL_GPL(ccw_device_siosl);
2155 MODULE_LICENSE("GPL");
2156 EXPORT_SYMBOL(ccw_device_set_online);
2157 EXPORT_SYMBOL(ccw_device_set_offline);
2158 EXPORT_SYMBOL(ccw_driver_register);
2159 EXPORT_SYMBOL(ccw_driver_unregister);
2160 EXPORT_SYMBOL(get_ccwdev_by_busid);