2 * S/390 common I/O routines -- low level i/o calls
4 * Copyright IBM Corp. 1999, 2008
11 #define KMSG_COMPONENT "cio"
12 #define pr_fmt(fmt) KMSG_COMPONENT ": " fmt
14 #include <linux/ftrace.h>
15 #include <linux/module.h>
16 #include <linux/init.h>
17 #include <linux/slab.h>
18 #include <linux/device.h>
19 #include <linux/kernel_stat.h>
20 #include <linux/interrupt.h>
21 #include <linux/irq.h>
23 #include <asm/delay.h>
25 #include <asm/irq_regs.h>
26 #include <asm/setup.h>
27 #include <asm/reset.h>
29 #include <asm/chpid.h>
32 #include <linux/cputime.h>
41 #include "blacklist.h"
42 #include "cio_debug.h"
45 debug_info_t *cio_debug_msg_id;
46 debug_info_t *cio_debug_trace_id;
47 debug_info_t *cio_debug_crw_id;
49 DEFINE_PER_CPU_ALIGNED(struct irb, cio_irb);
50 EXPORT_PER_CPU_SYMBOL(cio_irb);
53 * Function: cio_debug_init
54 * Initializes three debug logs for common I/O:
55 * - cio_msg logs generic cio messages
56 * - cio_trace logs the calling of different functions
57 * - cio_crw logs machine check related cio messages
59 static int __init cio_debug_init(void)
61 cio_debug_msg_id = debug_register("cio_msg", 16, 1, 11 * sizeof(long));
62 if (!cio_debug_msg_id)
64 debug_register_view(cio_debug_msg_id, &debug_sprintf_view);
65 debug_set_level(cio_debug_msg_id, 2);
66 cio_debug_trace_id = debug_register("cio_trace", 16, 1, 16);
67 if (!cio_debug_trace_id)
69 debug_register_view(cio_debug_trace_id, &debug_hex_ascii_view);
70 debug_set_level(cio_debug_trace_id, 2);
71 cio_debug_crw_id = debug_register("cio_crw", 8, 1, 8 * sizeof(long));
72 if (!cio_debug_crw_id)
74 debug_register_view(cio_debug_crw_id, &debug_sprintf_view);
75 debug_set_level(cio_debug_crw_id, 4);
80 debug_unregister(cio_debug_msg_id);
81 if (cio_debug_trace_id)
82 debug_unregister(cio_debug_trace_id);
84 debug_unregister(cio_debug_crw_id);
88 arch_initcall (cio_debug_init);
90 int cio_set_options(struct subchannel *sch, int flags)
92 struct io_subchannel_private *priv = to_io_private(sch);
94 priv->options.suspend = (flags & DOIO_ALLOW_SUSPEND) != 0;
95 priv->options.prefetch = (flags & DOIO_DENY_PREFETCH) != 0;
96 priv->options.inter = (flags & DOIO_SUPPRESS_INTER) != 0;
101 cio_start_handle_notoper(struct subchannel *sch, __u8 lpm)
110 CIO_MSG_EVENT(2, "cio_start: 'not oper' status for "
111 "subchannel 0.%x.%04x!\n", sch->schid.ssid,
114 if (cio_update_schib(sch))
117 sprintf(dbf_text, "no%s", dev_name(&sch->dev));
118 CIO_TRACE_EVENT(0, dbf_text);
119 CIO_HEX_EVENT(0, &sch->schib, sizeof (struct schib));
121 return (sch->lpm ? -EACCES : -ENODEV);
125 cio_start_key (struct subchannel *sch, /* subchannel structure */
126 struct ccw1 * cpa, /* logical channel prog addr */
127 __u8 lpm, /* logical path mask */
128 __u8 key) /* storage key */
130 struct io_subchannel_private *priv = to_io_private(sch);
131 union orb *orb = &priv->orb;
134 CIO_TRACE_EVENT(5, "stIO");
135 CIO_TRACE_EVENT(5, dev_name(&sch->dev));
137 memset(orb, 0, sizeof(union orb));
138 /* sch is always under 2G. */
139 orb->cmd.intparm = (u32)(addr_t)sch;
142 orb->cmd.pfch = priv->options.prefetch == 0;
143 orb->cmd.spnd = priv->options.suspend;
144 orb->cmd.ssic = priv->options.suspend && priv->options.inter;
145 orb->cmd.lpm = (lpm != 0) ? lpm : sch->lpm;
148 * for 64 bit we always support 64 bit IDAWs with 4k page size only
153 orb->cmd.key = key >> 4;
154 /* issue "Start Subchannel" */
155 orb->cmd.cpa = (__u32) __pa(cpa);
156 ccode = ssch(sch->schid, orb);
158 /* process condition code */
159 CIO_HEX_EVENT(5, &ccode, sizeof(ccode));
164 * initialize device status information
166 sch->schib.scsw.cmd.actl |= SCSW_ACTL_START_PEND;
168 case 1: /* status pending */
171 case 3: /* device/path not operational */
172 return cio_start_handle_notoper(sch, lpm);
179 cio_start (struct subchannel *sch, struct ccw1 *cpa, __u8 lpm)
181 return cio_start_key(sch, cpa, lpm, PAGE_DEFAULT_KEY);
185 * resume suspended I/O operation
188 cio_resume (struct subchannel *sch)
192 CIO_TRACE_EVENT(4, "resIO");
193 CIO_TRACE_EVENT(4, dev_name(&sch->dev));
195 ccode = rsch (sch->schid);
197 CIO_HEX_EVENT(4, &ccode, sizeof(ccode));
201 sch->schib.scsw.cmd.actl |= SCSW_ACTL_RESUME_PEND;
209 * useless to wait for request completion
210 * as device is no longer operational !
220 cio_halt(struct subchannel *sch)
227 CIO_TRACE_EVENT(2, "haltIO");
228 CIO_TRACE_EVENT(2, dev_name(&sch->dev));
231 * Issue "Halt subchannel" and process condition code
233 ccode = hsch (sch->schid);
235 CIO_HEX_EVENT(2, &ccode, sizeof(ccode));
239 sch->schib.scsw.cmd.actl |= SCSW_ACTL_HALT_PEND;
241 case 1: /* status pending */
244 default: /* device not operational */
250 * Clear I/O operation
253 cio_clear(struct subchannel *sch)
260 CIO_TRACE_EVENT(2, "clearIO");
261 CIO_TRACE_EVENT(2, dev_name(&sch->dev));
264 * Issue "Clear subchannel" and process condition code
266 ccode = csch (sch->schid);
268 CIO_HEX_EVENT(2, &ccode, sizeof(ccode));
272 sch->schib.scsw.cmd.actl |= SCSW_ACTL_CLEAR_PEND;
274 default: /* device not operational */
280 * Function: cio_cancel
281 * Issues a "Cancel Subchannel" on the specified subchannel
282 * Note: We don't need any fancy intparms and flags here
283 * since xsch is executed synchronously.
284 * Only for common I/O internal use as for now.
287 cio_cancel (struct subchannel *sch)
294 CIO_TRACE_EVENT(2, "cancelIO");
295 CIO_TRACE_EVENT(2, dev_name(&sch->dev));
297 ccode = xsch (sch->schid);
299 CIO_HEX_EVENT(2, &ccode, sizeof(ccode));
302 case 0: /* success */
303 /* Update information in scsw. */
304 if (cio_update_schib(sch))
307 case 1: /* status pending */
309 case 2: /* not applicable */
311 default: /* not oper */
317 static void cio_apply_config(struct subchannel *sch, struct schib *schib)
319 schib->pmcw.intparm = sch->config.intparm;
320 schib->pmcw.mbi = sch->config.mbi;
321 schib->pmcw.isc = sch->config.isc;
322 schib->pmcw.ena = sch->config.ena;
323 schib->pmcw.mme = sch->config.mme;
324 schib->pmcw.mp = sch->config.mp;
325 schib->pmcw.csense = sch->config.csense;
326 schib->pmcw.mbfc = sch->config.mbfc;
327 if (sch->config.mbfc)
328 schib->mba = sch->config.mba;
331 static int cio_check_config(struct subchannel *sch, struct schib *schib)
333 return (schib->pmcw.intparm == sch->config.intparm) &&
334 (schib->pmcw.mbi == sch->config.mbi) &&
335 (schib->pmcw.isc == sch->config.isc) &&
336 (schib->pmcw.ena == sch->config.ena) &&
337 (schib->pmcw.mme == sch->config.mme) &&
338 (schib->pmcw.mp == sch->config.mp) &&
339 (schib->pmcw.csense == sch->config.csense) &&
340 (schib->pmcw.mbfc == sch->config.mbfc) &&
341 (!sch->config.mbfc || (schib->mba == sch->config.mba));
345 * cio_commit_config - apply configuration to the subchannel
347 int cio_commit_config(struct subchannel *sch)
349 int ccode, retry, ret = 0;
353 if (stsch_err(sch->schid, &schib) || !css_sch_is_valid(&schib))
356 for (retry = 0; retry < 5; retry++) {
357 /* copy desired changes to local schib */
358 cio_apply_config(sch, &schib);
359 ccode = msch_err(sch->schid, &schib);
360 if (ccode < 0) /* -EIO if msch gets a program check. */
363 case 0: /* successful */
364 if (stsch_err(sch->schid, &schib) ||
365 !css_sch_is_valid(&schib))
367 if (cio_check_config(sch, &schib)) {
368 /* commit changes from local schib */
369 memcpy(&sch->schib, &schib, sizeof(schib));
374 case 1: /* status pending */
376 if (tsch(sch->schid, &irb))
380 udelay(100); /* allow for recovery */
383 case 3: /* not operational */
391 * cio_update_schib - Perform stsch and update schib if subchannel is valid.
392 * @sch: subchannel on which to perform stsch
393 * Return zero on success, -ENODEV otherwise.
395 int cio_update_schib(struct subchannel *sch)
399 if (stsch_err(sch->schid, &schib) || !css_sch_is_valid(&schib))
402 memcpy(&sch->schib, &schib, sizeof(schib));
405 EXPORT_SYMBOL_GPL(cio_update_schib);
408 * cio_enable_subchannel - enable a subchannel.
409 * @sch: subchannel to be enabled
410 * @intparm: interruption parameter to set
412 int cio_enable_subchannel(struct subchannel *sch, u32 intparm)
416 CIO_TRACE_EVENT(2, "ensch");
417 CIO_TRACE_EVENT(2, dev_name(&sch->dev));
419 if (sch_is_pseudo_sch(sch))
421 if (cio_update_schib(sch))
425 sch->config.isc = sch->isc;
426 sch->config.intparm = intparm;
428 ret = cio_commit_config(sch);
431 * Got a program check in msch. Try without
432 * the concurrent sense bit the next time.
434 sch->config.csense = 0;
435 ret = cio_commit_config(sch);
437 CIO_HEX_EVENT(2, &ret, sizeof(ret));
440 EXPORT_SYMBOL_GPL(cio_enable_subchannel);
443 * cio_disable_subchannel - disable a subchannel.
444 * @sch: subchannel to disable
446 int cio_disable_subchannel(struct subchannel *sch)
450 CIO_TRACE_EVENT(2, "dissch");
451 CIO_TRACE_EVENT(2, dev_name(&sch->dev));
453 if (sch_is_pseudo_sch(sch))
455 if (cio_update_schib(sch))
459 ret = cio_commit_config(sch);
461 CIO_HEX_EVENT(2, &ret, sizeof(ret));
464 EXPORT_SYMBOL_GPL(cio_disable_subchannel);
466 static int cio_check_devno_blacklisted(struct subchannel *sch)
468 if (is_blacklisted(sch->schid.ssid, sch->schib.pmcw.dev)) {
470 * This device must not be known to Linux. So we simply
471 * say that there is no device and return ENODEV.
473 CIO_MSG_EVENT(6, "Blacklisted device detected "
474 "at devno %04X, subchannel set %x\n",
475 sch->schib.pmcw.dev, sch->schid.ssid);
481 static int cio_validate_io_subchannel(struct subchannel *sch)
483 /* Initialization for io subchannels. */
484 if (!css_sch_is_valid(&sch->schib))
487 /* Devno is valid. */
488 return cio_check_devno_blacklisted(sch);
491 static int cio_validate_msg_subchannel(struct subchannel *sch)
493 /* Initialization for message subchannels. */
494 if (!css_sch_is_valid(&sch->schib))
497 /* Devno is valid. */
498 return cio_check_devno_blacklisted(sch);
502 * cio_validate_subchannel - basic validation of subchannel
503 * @sch: subchannel structure to be filled out
504 * @schid: subchannel id
506 * Find out subchannel type and initialize struct subchannel.
509 * -ENXIO for non-defined subchannels
510 * -ENODEV for invalid subchannels or blacklisted devices
511 * -EIO for subchannels in an invalid subchannel set
513 int cio_validate_subchannel(struct subchannel *sch, struct subchannel_id schid)
519 sprintf(dbf_txt, "valsch%x", schid.sch_no);
520 CIO_TRACE_EVENT(4, dbf_txt);
523 * The first subchannel that is not-operational (ccode==3)
524 * indicates that there aren't any more devices available.
525 * If stsch gets an exception, it means the current subchannel set
528 ccode = stsch_err(schid, &sch->schib);
530 err = (ccode == 3) ? -ENXIO : ccode;
533 sch->st = sch->schib.pmcw.st;
537 case SUBCHANNEL_TYPE_IO:
538 err = cio_validate_io_subchannel(sch);
540 case SUBCHANNEL_TYPE_MSG:
541 err = cio_validate_msg_subchannel(sch);
549 CIO_MSG_EVENT(4, "Subchannel 0.%x.%04x reports subchannel type %04X\n",
550 sch->schid.ssid, sch->schid.sch_no, sch->st);
556 * do_cio_interrupt() handles all normal I/O device IRQ's
558 static irqreturn_t do_cio_interrupt(int irq, void *dummy)
560 struct tpi_info *tpi_info;
561 struct subchannel *sch;
564 set_cpu_flag(CIF_NOHZ_DELAY);
565 tpi_info = (struct tpi_info *) &get_irq_regs()->int_code;
566 irb = this_cpu_ptr(&cio_irb);
567 sch = (struct subchannel *)(unsigned long) tpi_info->intparm;
569 /* Clear pending interrupt condition. */
570 inc_irq_stat(IRQIO_CIO);
571 tsch(tpi_info->schid, irb);
574 spin_lock(sch->lock);
575 /* Store interrupt response block to lowcore. */
576 if (tsch(tpi_info->schid, irb) == 0) {
577 /* Keep subchannel information word up to date. */
578 memcpy (&sch->schib.scsw, &irb->scsw, sizeof (irb->scsw));
579 /* Call interrupt handler if there is one. */
580 if (sch->driver && sch->driver->irq)
581 sch->driver->irq(sch);
583 inc_irq_stat(IRQIO_CIO);
585 inc_irq_stat(IRQIO_CIO);
586 spin_unlock(sch->lock);
591 static struct irqaction io_interrupt = {
593 .handler = do_cio_interrupt,
596 void __init init_cio_interrupts(void)
598 irq_set_chip_and_handler(IO_INTERRUPT,
599 &dummy_irq_chip, handle_percpu_irq);
600 setup_irq(IO_INTERRUPT, &io_interrupt);
603 #ifdef CONFIG_CCW_CONSOLE
604 static struct subchannel *console_sch;
605 static struct lock_class_key console_sch_key;
608 * Use cio_tsch to update the subchannel status and call the interrupt handler
609 * if status had been pending. Called with the subchannel's lock held.
611 void cio_tsch(struct subchannel *sch)
616 irb = this_cpu_ptr(&cio_irb);
617 /* Store interrupt response block to lowcore. */
618 if (tsch(sch->schid, irb) != 0)
619 /* Not status pending or not operational. */
621 memcpy(&sch->schib.scsw, &irb->scsw, sizeof(union scsw));
622 /* Call interrupt handler with updated status. */
623 irq_context = in_interrupt();
628 kstat_incr_irq_this_cpu(IO_INTERRUPT);
629 if (sch->driver && sch->driver->irq)
630 sch->driver->irq(sch);
632 inc_irq_stat(IRQIO_CIO);
639 static int cio_test_for_console(struct subchannel_id schid, void *data)
643 if (stsch_err(schid, &schib) != 0)
645 if ((schib.pmcw.st == SUBCHANNEL_TYPE_IO) && schib.pmcw.dnv &&
646 (schib.pmcw.dev == console_devno)) {
647 console_irq = schid.sch_no;
648 return 1; /* found */
653 static int cio_get_console_sch_no(void)
655 struct subchannel_id schid;
658 init_subchannel_id(&schid);
659 if (console_irq != -1) {
660 /* VM provided us with the irq number of the console. */
661 schid.sch_no = console_irq;
662 if (stsch_err(schid, &schib) != 0 ||
663 (schib.pmcw.st != SUBCHANNEL_TYPE_IO) || !schib.pmcw.dnv)
665 console_devno = schib.pmcw.dev;
666 } else if (console_devno != -1) {
667 /* At least the console device number is known. */
668 for_each_subchannel(cio_test_for_console, NULL);
673 struct subchannel *cio_probe_console(void)
675 struct subchannel_id schid;
676 struct subchannel *sch;
679 sch_no = cio_get_console_sch_no();
681 pr_warning("No CCW console was found\n");
682 return ERR_PTR(-ENODEV);
684 init_subchannel_id(&schid);
685 schid.sch_no = sch_no;
686 sch = css_alloc_subchannel(schid);
690 lockdep_set_class(sch->lock, &console_sch_key);
691 isc_register(CONSOLE_ISC);
692 sch->config.isc = CONSOLE_ISC;
693 sch->config.intparm = (u32)(addr_t)sch;
694 ret = cio_commit_config(sch);
696 isc_unregister(CONSOLE_ISC);
697 put_device(&sch->dev);
704 int cio_is_console(struct subchannel_id schid)
708 return schid_equal(&schid, &console_sch->schid);
711 void cio_register_early_subchannels(void)
718 ret = css_register_subchannel(console_sch);
720 put_device(&console_sch->dev);
722 #endif /* CONFIG_CCW_CONSOLE */
725 __disable_subchannel_easy(struct subchannel_id schid, struct schib *schib)
730 for (retry=0;retry<3;retry++) {
732 cc = msch_err(schid, schib);
734 return (cc==3?-ENODEV:-EBUSY);
735 if (stsch_err(schid, schib) || !css_sch_is_valid(schib))
737 if (!schib->pmcw.ena)
740 return -EBUSY; /* uhm... */
744 __clear_io_subchannel_easy(struct subchannel_id schid)
750 for (retry=0;retry<20;retry++) {
754 tsch(ti.schid, this_cpu_ptr(&cio_irb));
755 if (schid_equal(&ti.schid, &schid))
763 static void __clear_chsc_subchannel_easy(void)
765 /* It seems we can only wait for a bit here :/ */
769 static int pgm_check_occured;
771 static void cio_reset_pgm_check_handler(void)
773 pgm_check_occured = 1;
776 static int stsch_reset(struct subchannel_id schid, struct schib *addr)
780 pgm_check_occured = 0;
781 s390_base_pgm_handler_fn = cio_reset_pgm_check_handler;
782 rc = stsch_err(schid, addr);
783 s390_base_pgm_handler_fn = NULL;
785 /* The program check handler could have changed pgm_check_occured. */
788 if (pgm_check_occured)
794 static int __shutdown_subchannel_easy(struct subchannel_id schid, void *data)
798 if (stsch_reset(schid, &schib))
802 switch(__disable_subchannel_easy(schid, &schib)) {
806 default: /* -EBUSY */
807 switch (schib.pmcw.st) {
808 case SUBCHANNEL_TYPE_IO:
809 if (__clear_io_subchannel_easy(schid))
810 goto out; /* give up... */
812 case SUBCHANNEL_TYPE_CHSC:
813 __clear_chsc_subchannel_easy();
816 /* No default clear strategy */
819 stsch_err(schid, &schib);
820 __disable_subchannel_easy(schid, &schib);
826 static atomic_t chpid_reset_count;
828 static void s390_reset_chpids_mcck_handler(void)
833 /* Check for pending channel report word. */
834 mci = (struct mci *)&S390_lowcore.mcck_interruption_code;
837 /* Process channel report words. */
838 while (stcrw(&crw) == 0) {
839 /* Check for responses to RCHP. */
840 if (crw.slct && crw.rsc == CRW_RSC_CPATH)
841 atomic_dec(&chpid_reset_count);
845 #define RCHP_TIMEOUT (30 * USEC_PER_SEC)
846 static void css_reset(void)
849 unsigned long long timeout;
852 /* Reset subchannels. */
853 for_each_subchannel(__shutdown_subchannel_easy, NULL);
854 /* Reset channel paths. */
855 s390_base_mcck_handler_fn = s390_reset_chpids_mcck_handler;
856 /* Enable channel report machine checks. */
857 __ctl_set_bit(14, 28);
858 /* Temporarily reenable machine checks. */
861 for (i = 0; i <= __MAX_CHPID; i++) {
864 if ((ret == 0) || (ret == 2))
866 * rchp either succeeded, or another rchp is already
867 * in progress. In either case, we'll get a crw.
869 atomic_inc(&chpid_reset_count);
871 /* Wait for machine check for all channel paths. */
872 timeout = get_tod_clock_fast() + (RCHP_TIMEOUT << 12);
873 while (atomic_read(&chpid_reset_count) != 0) {
874 if (get_tod_clock_fast() > timeout)
878 /* Disable machine checks again. */
879 local_mcck_disable();
880 /* Disable channel report machine checks. */
881 __ctl_clear_bit(14, 28);
882 s390_base_mcck_handler_fn = NULL;
885 static struct reset_call css_reset_call = {
889 static int __init init_css_reset_call(void)
891 atomic_set(&chpid_reset_count, 0);
892 register_reset_call(&css_reset_call);
896 arch_initcall(init_css_reset_call);
898 struct sch_match_id {
899 struct subchannel_id schid;
900 struct ccw_dev_id devid;
904 static int __reipl_subchannel_match(struct subchannel_id schid, void *data)
907 struct sch_match_id *match_id = data;
909 if (stsch_reset(schid, &schib))
911 if ((schib.pmcw.st == SUBCHANNEL_TYPE_IO) && schib.pmcw.dnv &&
912 (schib.pmcw.dev == match_id->devid.devno) &&
913 (schid.ssid == match_id->devid.ssid)) {
914 match_id->schid = schid;
921 static int reipl_find_schid(struct ccw_dev_id *devid,
922 struct subchannel_id *schid)
924 struct sch_match_id match_id;
926 match_id.devid = *devid;
927 match_id.rc = -ENODEV;
928 for_each_subchannel(__reipl_subchannel_match, &match_id);
929 if (match_id.rc == 0)
930 *schid = match_id.schid;
934 extern void do_reipl_asm(__u32 schid);
936 /* Make sure all subchannels are quiet before we re-ipl an lpar. */
937 void reipl_ccw_dev(struct ccw_dev_id *devid)
939 struct subchannel_id uninitialized_var(schid);
941 s390_reset_system(NULL, NULL, NULL);
942 if (reipl_find_schid(devid, &schid) != 0)
943 panic("IPL Device not found\n");
944 do_reipl_asm(*((__u32*)&schid));
947 int __init cio_get_iplinfo(struct cio_iplinfo *iplinfo)
949 struct subchannel_id schid;
952 schid = *(struct subchannel_id *)&S390_lowcore.subchannel_id;
955 if (stsch_err(schid, &schib))
957 if (schib.pmcw.st != SUBCHANNEL_TYPE_IO)
961 iplinfo->devno = schib.pmcw.dev;
962 iplinfo->is_qdio = schib.pmcw.qf;
967 * cio_tm_start_key - perform start function
968 * @sch: subchannel on which to perform the start function
969 * @tcw: transport-command word to be started
970 * @lpm: mask of paths to use
971 * @key: storage key to use for storage access
973 * Start the tcw on the given subchannel. Return zero on success, non-zero
976 int cio_tm_start_key(struct subchannel *sch, struct tcw *tcw, u8 lpm, u8 key)
979 union orb *orb = &to_io_private(sch)->orb;
981 memset(orb, 0, sizeof(union orb));
982 orb->tm.intparm = (u32) (addr_t) sch;
983 orb->tm.key = key >> 4;
985 orb->tm.lpm = lpm ? lpm : sch->lpm;
986 orb->tm.tcw = (u32) (addr_t) tcw;
987 cc = ssch(sch->schid, orb);
995 return cio_start_handle_notoper(sch, lpm);
1000 * cio_tm_intrg - perform interrogate function
1001 * @sch - subchannel on which to perform the interrogate function
1003 * If the specified subchannel is running in transport-mode, perform the
1004 * interrogate function. Return zero on success, non-zero otherwie.
1006 int cio_tm_intrg(struct subchannel *sch)
1010 if (!to_io_private(sch)->orb.tm.b)
1012 cc = xsch(sch->schid);