2 * I/O instructions for S/390
4 * Copyright 2012, 2015 IBM Corp.
7 * This work is licensed under the terms of the GNU GPL, version 2 or (at
8 * your option) any later version. See the COPYING file in the top-level
12 #include "qemu/osdep.h"
16 #include "hw/s390x/ioinst.h"
18 #include "hw/s390x/s390-pci-bus.h"
19 #include "hw/s390x/pv.h"
21 /* All I/O instructions but chsc use the s format */
22 static uint64_t get_address_from_regs(CPUS390XState *env, uint32_t ipb,
26 * Addresses for protected guests are all offsets into the
27 * satellite block which holds the IO control structures. Those
28 * control structures are always starting at offset 0 and are
29 * always aligned and accessible. So we can return 0 here which
30 * will pass the following address checks.
36 return decode_basedisp_s(env, ipb, ar);
39 int ioinst_disassemble_sch_ident(uint32_t value, int *m, int *cssid, int *ssid,
42 if (!IOINST_SCHID_ONE(value)) {
45 if (!IOINST_SCHID_M(value)) {
46 if (IOINST_SCHID_CSSID(value)) {
52 *cssid = IOINST_SCHID_CSSID(value);
55 *ssid = IOINST_SCHID_SSID(value);
56 *schid = IOINST_SCHID_NR(value);
60 void ioinst_handle_xsch(S390CPU *cpu, uint64_t reg1, uintptr_t ra)
62 int cssid, ssid, schid, m;
65 if (ioinst_disassemble_sch_ident(reg1, &m, &cssid, &ssid, &schid)) {
66 s390_program_interrupt(&cpu->env, PGM_OPERAND, ra);
69 trace_ioinst_sch_id("xsch", cssid, ssid, schid);
70 sch = css_find_subch(m, cssid, ssid, schid);
71 if (!sch || !css_subch_visible(sch)) {
75 setcc(cpu, css_do_xsch(sch));
78 void ioinst_handle_csch(S390CPU *cpu, uint64_t reg1, uintptr_t ra)
80 int cssid, ssid, schid, m;
83 if (ioinst_disassemble_sch_ident(reg1, &m, &cssid, &ssid, &schid)) {
84 s390_program_interrupt(&cpu->env, PGM_OPERAND, ra);
87 trace_ioinst_sch_id("csch", cssid, ssid, schid);
88 sch = css_find_subch(m, cssid, ssid, schid);
89 if (!sch || !css_subch_visible(sch)) {
93 setcc(cpu, css_do_csch(sch));
96 void ioinst_handle_hsch(S390CPU *cpu, uint64_t reg1, uintptr_t ra)
98 int cssid, ssid, schid, m;
101 if (ioinst_disassemble_sch_ident(reg1, &m, &cssid, &ssid, &schid)) {
102 s390_program_interrupt(&cpu->env, PGM_OPERAND, ra);
105 trace_ioinst_sch_id("hsch", cssid, ssid, schid);
106 sch = css_find_subch(m, cssid, ssid, schid);
107 if (!sch || !css_subch_visible(sch)) {
111 setcc(cpu, css_do_hsch(sch));
114 static int ioinst_schib_valid(SCHIB *schib)
116 if ((be16_to_cpu(schib->pmcw.flags) & PMCW_FLAGS_MASK_INVALID) ||
117 (be32_to_cpu(schib->pmcw.chars) & PMCW_CHARS_MASK_INVALID)) {
120 /* Disallow extended measurements for now. */
121 if (be32_to_cpu(schib->pmcw.chars) & PMCW_CHARS_MASK_XMWME) {
127 void ioinst_handle_msch(S390CPU *cpu, uint64_t reg1, uint32_t ipb, uintptr_t ra)
129 int cssid, ssid, schid, m;
133 CPUS390XState *env = &cpu->env;
136 addr = get_address_from_regs(env, ipb, &ar);
138 s390_program_interrupt(env, PGM_SPECIFICATION, ra);
142 s390_cpu_pv_mem_read(cpu, addr, &schib, sizeof(schib));
143 } else if (s390_cpu_virt_mem_read(cpu, addr, ar, &schib, sizeof(schib))) {
144 s390_cpu_virt_mem_handle_exc(cpu, ra);
147 if (ioinst_disassemble_sch_ident(reg1, &m, &cssid, &ssid, &schid) ||
148 !ioinst_schib_valid(&schib)) {
149 s390_program_interrupt(env, PGM_OPERAND, ra);
152 trace_ioinst_sch_id("msch", cssid, ssid, schid);
153 sch = css_find_subch(m, cssid, ssid, schid);
154 if (!sch || !css_subch_visible(sch)) {
158 setcc(cpu, css_do_msch(sch, &schib));
161 static void copy_orb_from_guest(ORB *dest, const ORB *src)
163 dest->intparm = be32_to_cpu(src->intparm);
164 dest->ctrl0 = be16_to_cpu(src->ctrl0);
165 dest->lpm = src->lpm;
166 dest->ctrl1 = src->ctrl1;
167 dest->cpa = be32_to_cpu(src->cpa);
170 static int ioinst_orb_valid(ORB *orb)
172 if ((orb->ctrl0 & ORB_CTRL0_MASK_INVALID) ||
173 (orb->ctrl1 & ORB_CTRL1_MASK_INVALID)) {
176 /* We don't support MIDA. */
177 if (orb->ctrl1 & ORB_CTRL1_MASK_MIDAW) {
180 if ((orb->cpa & HIGH_ORDER_BIT) != 0) {
186 void ioinst_handle_ssch(S390CPU *cpu, uint64_t reg1, uint32_t ipb, uintptr_t ra)
188 int cssid, ssid, schid, m;
192 CPUS390XState *env = &cpu->env;
195 addr = get_address_from_regs(env, ipb, &ar);
197 s390_program_interrupt(env, PGM_SPECIFICATION, ra);
201 s390_cpu_pv_mem_read(cpu, addr, &orig_orb, sizeof(orb));
202 } else if (s390_cpu_virt_mem_read(cpu, addr, ar, &orig_orb, sizeof(orb))) {
203 s390_cpu_virt_mem_handle_exc(cpu, ra);
206 copy_orb_from_guest(&orb, &orig_orb);
207 if (ioinst_disassemble_sch_ident(reg1, &m, &cssid, &ssid, &schid) ||
208 !ioinst_orb_valid(&orb)) {
209 s390_program_interrupt(env, PGM_OPERAND, ra);
212 trace_ioinst_sch_id("ssch", cssid, ssid, schid);
213 sch = css_find_subch(m, cssid, ssid, schid);
214 if (!sch || !css_subch_visible(sch)) {
218 setcc(cpu, css_do_ssch(sch, &orb));
221 void ioinst_handle_stcrw(S390CPU *cpu, uint32_t ipb, uintptr_t ra)
226 CPUS390XState *env = &cpu->env;
229 addr = get_address_from_regs(env, ipb, &ar);
231 s390_program_interrupt(env, PGM_SPECIFICATION, ra);
235 cc = css_do_stcrw(&crw);
236 /* 0 - crw stored, 1 - zeroes stored */
239 s390_cpu_pv_mem_write(cpu, addr, &crw, sizeof(crw));
242 if (s390_cpu_virt_mem_write(cpu, addr, ar, &crw, sizeof(crw)) == 0) {
246 /* Write failed: requeue CRW since STCRW is suppressing */
247 css_undo_stcrw(&crw);
249 s390_cpu_virt_mem_handle_exc(cpu, ra);
254 void ioinst_handle_stsch(S390CPU *cpu, uint64_t reg1, uint32_t ipb,
257 int cssid, ssid, schid, m;
262 CPUS390XState *env = &cpu->env;
265 addr = get_address_from_regs(env, ipb, &ar);
267 s390_program_interrupt(env, PGM_SPECIFICATION, ra);
271 if (ioinst_disassemble_sch_ident(reg1, &m, &cssid, &ssid, &schid)) {
273 * The Ultravisor checks schid bit 16 to be one and bits 0-12
274 * to be 0 and injects a operand exception itself.
276 * Hence we should never end up here.
278 g_assert(!s390_is_pv());
280 * As operand exceptions have a lower priority than access exceptions,
281 * we check whether the memory area is writeable (injecting the
282 * access execption if it is not) first.
284 if (!s390_cpu_virt_mem_check_write(cpu, addr, ar, sizeof(schib))) {
285 s390_program_interrupt(env, PGM_OPERAND, ra);
287 s390_cpu_virt_mem_handle_exc(cpu, ra);
291 trace_ioinst_sch_id("stsch", cssid, ssid, schid);
292 sch = css_find_subch(m, cssid, ssid, schid);
294 if (css_subch_visible(sch)) {
295 cc = css_do_stsch(sch, &schib);
297 /* Indicate no more subchannels in this css/ss */
301 if (css_schid_final(m, cssid, ssid, schid)) {
302 cc = 3; /* No more subchannels in this css/ss */
304 /* Store an empty schib. */
305 memset(&schib, 0, sizeof(schib));
311 s390_cpu_pv_mem_write(cpu, addr, &schib, sizeof(schib));
312 } else if (s390_cpu_virt_mem_write(cpu, addr, ar, &schib,
313 sizeof(schib)) != 0) {
314 s390_cpu_virt_mem_handle_exc(cpu, ra);
318 /* Access exceptions have a higher priority than cc3 */
320 s390_cpu_virt_mem_check_write(cpu, addr, ar, sizeof(schib)) != 0) {
321 s390_cpu_virt_mem_handle_exc(cpu, ra);
328 int ioinst_handle_tsch(S390CPU *cpu, uint64_t reg1, uint32_t ipb, uintptr_t ra)
330 CPUS390XState *env = &cpu->env;
331 int cssid, ssid, schid, m;
338 if (ioinst_disassemble_sch_ident(reg1, &m, &cssid, &ssid, &schid)) {
339 s390_program_interrupt(env, PGM_OPERAND, ra);
342 trace_ioinst_sch_id("tsch", cssid, ssid, schid);
343 addr = get_address_from_regs(env, ipb, &ar);
345 s390_program_interrupt(env, PGM_SPECIFICATION, ra);
349 sch = css_find_subch(m, cssid, ssid, schid);
350 if (sch && css_subch_visible(sch)) {
351 cc = css_do_tsch_get_irb(sch, &irb, &irb_len);
355 /* 0 - status pending, 1 - not status pending, 3 - not operational */
358 s390_cpu_pv_mem_write(cpu, addr, &irb, irb_len);
359 } else if (s390_cpu_virt_mem_write(cpu, addr, ar, &irb, irb_len) != 0) {
360 s390_cpu_virt_mem_handle_exc(cpu, ra);
363 css_do_tsch_update_subch(sch);
365 irb_len = sizeof(irb) - sizeof(irb.emw);
366 /* Access exceptions have a higher priority than cc3 */
368 s390_cpu_virt_mem_check_write(cpu, addr, ar, irb_len) != 0) {
369 s390_cpu_virt_mem_handle_exc(cpu, ra);
378 typedef struct ChscReq {
384 } QEMU_PACKED ChscReq;
386 typedef struct ChscResp {
391 } QEMU_PACKED ChscResp;
393 #define CHSC_MIN_RESP_LEN 0x0008
395 #define CHSC_SCPD 0x0002
396 #define CHSC_SCSC 0x0010
397 #define CHSC_SDA 0x0031
398 #define CHSC_SEI 0x000e
400 #define CHSC_SCPD_0_M 0x20000000
401 #define CHSC_SCPD_0_C 0x10000000
402 #define CHSC_SCPD_0_FMT 0x0f000000
403 #define CHSC_SCPD_0_CSSID 0x00ff0000
404 #define CHSC_SCPD_0_RFMT 0x00000f00
405 #define CHSC_SCPD_0_RES 0xc000f000
406 #define CHSC_SCPD_1_RES 0xffffff00
407 #define CHSC_SCPD_01_CHPID 0x000000ff
408 static void ioinst_handle_chsc_scpd(ChscReq *req, ChscResp *res)
410 uint16_t len = be16_to_cpu(req->len);
411 uint32_t param0 = be32_to_cpu(req->param0);
412 uint32_t param1 = be32_to_cpu(req->param1);
416 uint8_t f_chpid, l_chpid;
420 rfmt = (param0 & CHSC_SCPD_0_RFMT) >> 8;
421 if ((rfmt == 0) || (rfmt == 1)) {
422 rfmt = !!(param0 & CHSC_SCPD_0_C);
424 if ((len != 0x0010) || (param0 & CHSC_SCPD_0_RES) ||
425 (param1 & CHSC_SCPD_1_RES) || req->param2) {
429 if (param0 & CHSC_SCPD_0_FMT) {
433 cssid = (param0 & CHSC_SCPD_0_CSSID) >> 16;
434 m = param0 & CHSC_SCPD_0_M;
436 if (!m || !css_present(cssid)) {
441 f_chpid = param0 & CHSC_SCPD_01_CHPID;
442 l_chpid = param1 & CHSC_SCPD_01_CHPID;
443 if (l_chpid < f_chpid) {
447 /* css_collect_chp_desc() is endian-aware */
448 desc_size = css_collect_chp_desc(m, cssid, f_chpid, l_chpid, rfmt,
450 res->code = cpu_to_be16(0x0001);
451 res->len = cpu_to_be16(8 + desc_size);
452 res->param = cpu_to_be32(rfmt);
456 res->code = cpu_to_be16(resp_code);
457 res->len = cpu_to_be16(CHSC_MIN_RESP_LEN);
458 res->param = cpu_to_be32(rfmt);
461 #define CHSC_SCSC_0_M 0x20000000
462 #define CHSC_SCSC_0_FMT 0x000f0000
463 #define CHSC_SCSC_0_CSSID 0x0000ff00
464 #define CHSC_SCSC_0_RES 0xdff000ff
465 static void ioinst_handle_chsc_scsc(ChscReq *req, ChscResp *res)
467 uint16_t len = be16_to_cpu(req->len);
468 uint32_t param0 = be32_to_cpu(req->param0);
471 uint32_t general_chars[510];
472 uint32_t chsc_chars[508];
479 if (param0 & CHSC_SCSC_0_FMT) {
483 cssid = (param0 & CHSC_SCSC_0_CSSID) >> 8;
485 if (!(param0 & CHSC_SCSC_0_M) || !css_present(cssid)) {
490 if ((param0 & CHSC_SCSC_0_RES) || req->param1 || req->param2) {
494 res->code = cpu_to_be16(0x0001);
495 res->len = cpu_to_be16(4080);
498 memset(general_chars, 0, sizeof(general_chars));
499 memset(chsc_chars, 0, sizeof(chsc_chars));
501 general_chars[0] = cpu_to_be32(0x03000000);
502 general_chars[1] = cpu_to_be32(0x00079000);
503 general_chars[3] = cpu_to_be32(0x00080000);
505 chsc_chars[0] = cpu_to_be32(0x40000000);
506 chsc_chars[3] = cpu_to_be32(0x00040000);
508 memcpy(res->data, general_chars, sizeof(general_chars));
509 memcpy(res->data + sizeof(general_chars), chsc_chars, sizeof(chsc_chars));
513 res->code = cpu_to_be16(resp_code);
514 res->len = cpu_to_be16(CHSC_MIN_RESP_LEN);
518 #define CHSC_SDA_0_FMT 0x0f000000
519 #define CHSC_SDA_0_OC 0x0000ffff
520 #define CHSC_SDA_0_RES 0xf0ff0000
521 #define CHSC_SDA_OC_MCSSE 0x0
522 #define CHSC_SDA_OC_MSS 0x2
523 static void ioinst_handle_chsc_sda(ChscReq *req, ChscResp *res)
525 uint16_t resp_code = 0x0001;
526 uint16_t len = be16_to_cpu(req->len);
527 uint32_t param0 = be32_to_cpu(req->param0);
531 if ((len != 0x0400) || (param0 & CHSC_SDA_0_RES)) {
536 if (param0 & CHSC_SDA_0_FMT) {
541 oc = param0 & CHSC_SDA_0_OC;
543 case CHSC_SDA_OC_MCSSE:
544 ret = css_enable_mcsse();
545 if (ret == -EINVAL) {
550 case CHSC_SDA_OC_MSS:
551 ret = css_enable_mss();
552 if (ret == -EINVAL) {
563 res->code = cpu_to_be16(resp_code);
564 res->len = cpu_to_be16(CHSC_MIN_RESP_LEN);
568 static int chsc_sei_nt0_get_event(void *res)
574 static int chsc_sei_nt0_have_event(void)
580 static int chsc_sei_nt2_get_event(void *res)
582 if (s390_has_feat(S390_FEAT_ZPCI)) {
583 return pci_chsc_sei_nt2_get_event(res);
588 static int chsc_sei_nt2_have_event(void)
590 if (s390_has_feat(S390_FEAT_ZPCI)) {
591 return pci_chsc_sei_nt2_have_event();
596 #define CHSC_SEI_NT0 (1ULL << 63)
597 #define CHSC_SEI_NT2 (1ULL << 61)
598 static void ioinst_handle_chsc_sei(ChscReq *req, ChscResp *res)
600 uint64_t selection_mask = ldq_p(&req->param1);
601 uint8_t *res_flags = (uint8_t *)res->data;
605 /* regarding architecture nt0 can not be masked */
606 have_event = !chsc_sei_nt0_get_event(res);
607 have_more = chsc_sei_nt0_have_event();
609 if (selection_mask & CHSC_SEI_NT2) {
611 have_event = !chsc_sei_nt2_get_event(res);
615 have_more = chsc_sei_nt2_have_event();
620 res->code = cpu_to_be16(0x0001);
622 (*res_flags) |= 0x80;
624 (*res_flags) &= ~0x80;
625 css_clear_sei_pending();
628 res->code = cpu_to_be16(0x0005);
629 res->len = cpu_to_be16(CHSC_MIN_RESP_LEN);
633 static void ioinst_handle_chsc_unimplemented(ChscResp *res)
635 res->len = cpu_to_be16(CHSC_MIN_RESP_LEN);
636 res->code = cpu_to_be16(0x0004);
640 void ioinst_handle_chsc(S390CPU *cpu, uint32_t ipb, uintptr_t ra)
648 CPUS390XState *env = &cpu->env;
649 uint8_t buf[TARGET_PAGE_SIZE];
651 trace_ioinst("chsc");
652 reg = (ipb >> 20) & 0x00f;
654 addr = env->regs[reg];
658 s390_program_interrupt(env, PGM_SPECIFICATION, ra);
662 * Reading sizeof(ChscReq) bytes is currently enough for all of our
663 * present CHSC sub-handlers ... if we ever need more, we should take
664 * care of req->len here first.
667 s390_cpu_pv_mem_read(cpu, addr, buf, sizeof(ChscReq));
668 } else if (s390_cpu_virt_mem_read(cpu, addr, reg, buf, sizeof(ChscReq))) {
669 s390_cpu_virt_mem_handle_exc(cpu, ra);
672 req = (ChscReq *)buf;
673 len = be16_to_cpu(req->len);
674 /* Length field valid? */
675 if ((len < 16) || (len > 4088) || (len & 7)) {
676 s390_program_interrupt(env, PGM_OPERAND, ra);
679 memset((char *)req + len, 0, TARGET_PAGE_SIZE - len);
680 res = (void *)((char *)req + len);
681 command = be16_to_cpu(req->command);
682 trace_ioinst_chsc_cmd(command, len);
685 ioinst_handle_chsc_scsc(req, res);
688 ioinst_handle_chsc_scpd(req, res);
691 ioinst_handle_chsc_sda(req, res);
694 ioinst_handle_chsc_sei(req, res);
697 ioinst_handle_chsc_unimplemented(res);
702 s390_cpu_pv_mem_write(cpu, addr + len, res, be16_to_cpu(res->len));
703 setcc(cpu, 0); /* Command execution complete */
705 if (!s390_cpu_virt_mem_write(cpu, addr + len, reg, res,
706 be16_to_cpu(res->len))) {
707 setcc(cpu, 0); /* Command execution complete */
709 s390_cpu_virt_mem_handle_exc(cpu, ra);
714 #define SCHM_REG1_RES(_reg) (_reg & 0x000000000ffffffc)
715 #define SCHM_REG1_MBK(_reg) ((_reg & 0x00000000f0000000) >> 28)
716 #define SCHM_REG1_UPD(_reg) ((_reg & 0x0000000000000002) >> 1)
717 #define SCHM_REG1_DCT(_reg) (_reg & 0x0000000000000001)
719 void ioinst_handle_schm(S390CPU *cpu, uint64_t reg1, uint64_t reg2,
720 uint32_t ipb, uintptr_t ra)
725 CPUS390XState *env = &cpu->env;
727 trace_ioinst("schm");
729 if (SCHM_REG1_RES(reg1)) {
730 s390_program_interrupt(env, PGM_OPERAND, ra);
734 mbk = SCHM_REG1_MBK(reg1);
735 update = SCHM_REG1_UPD(reg1);
736 dct = SCHM_REG1_DCT(reg1);
738 if (update && (reg2 & 0x000000000000001f)) {
739 s390_program_interrupt(env, PGM_OPERAND, ra);
743 css_do_schm(mbk, update, dct, update ? reg2 : 0);
746 void ioinst_handle_rsch(S390CPU *cpu, uint64_t reg1, uintptr_t ra)
748 int cssid, ssid, schid, m;
751 if (ioinst_disassemble_sch_ident(reg1, &m, &cssid, &ssid, &schid)) {
752 s390_program_interrupt(&cpu->env, PGM_OPERAND, ra);
755 trace_ioinst_sch_id("rsch", cssid, ssid, schid);
756 sch = css_find_subch(m, cssid, ssid, schid);
757 if (!sch || !css_subch_visible(sch)) {
761 setcc(cpu, css_do_rsch(sch));
764 #define RCHP_REG1_RES(_reg) (_reg & 0x00000000ff00ff00)
765 #define RCHP_REG1_CSSID(_reg) ((_reg & 0x0000000000ff0000) >> 16)
766 #define RCHP_REG1_CHPID(_reg) (_reg & 0x00000000000000ff)
767 void ioinst_handle_rchp(S390CPU *cpu, uint64_t reg1, uintptr_t ra)
773 CPUS390XState *env = &cpu->env;
775 if (RCHP_REG1_RES(reg1)) {
776 s390_program_interrupt(env, PGM_OPERAND, ra);
780 cssid = RCHP_REG1_CSSID(reg1);
781 chpid = RCHP_REG1_CHPID(reg1);
783 trace_ioinst_chp_id("rchp", cssid, chpid);
785 ret = css_do_rchp(cssid, chpid);
798 /* Invalid channel subsystem. */
799 s390_program_interrupt(env, PGM_OPERAND, ra);
805 #define SAL_REG1_INVALID(_reg) (_reg & 0x0000000080000000)
806 void ioinst_handle_sal(S390CPU *cpu, uint64_t reg1, uintptr_t ra)
808 /* We do not provide address limit checking, so let's suppress it. */
809 if (SAL_REG1_INVALID(reg1) || reg1 & 0x000000000000ffff) {
810 s390_program_interrupt(&cpu->env, PGM_OPERAND, ra);