Skip to contentSkip to conversation

s390x: Add specification exception interception test

PATCH Superseded Janis Schoetterl-Glausch 3 participants 4 messages Jul 6, 2021 – Jul 27, 2021

Subsystems (2)

v1 of 7 Superseded Latest is v7 →

lore
Share & tools
lore
#0 lore raw

PATCH 1/1 s390x: Add specification exception interception test

Check that specification exceptions cause intercepts when specification exception interpretation is off.
Check that specification exceptions caused by program new PSWs cause interceptions.
We cannot assert that non program new PSW specification exceptions are interpreted because whether interpretation occurs or not is configuration dependent.

---
The patch is based on the following patch sets by Janosch:
[kvm-unit-tests PATCH 0/5] s390x: sie and uv cleanups [kvm-unit-tests PATCH v2 0/3] s390x: Add snippet support

 s390x/Makefile             |  2 +
 lib/s390x/sie.h            |  1 +
 s390x/snippets/c/spec_ex.c | 13 ++++++
 s390x/spec_ex-sie.c        | 91 ++++++++++++++++++++++++++++++++++++++
 s390x/unittests.cfg        |  3 ++
 5 files changed, 110 insertions(+)
 create mode 100644 s390x/snippets/c/spec_ex.c
 create mode 100644 s390x/spec_ex-sie.c
s390x/Makefile +2 -0
index 07af26d..b1b6536 100644
@@ -24,6 +24,7 @@ tests += $(TEST_DIR)/mvpg.elf
 tests += $(TEST_DIR)/uv-host.elf
 tests += $(TEST_DIR)/edat.elf
 tests += $(TEST_DIR)/mvpg-sie.elf
+tests += $(TEST_DIR)/spec_ex-sie.elf
 
 tests_binary = $(patsubst %.elf,%.bin,$(tests))
 ifneq ($(HOST_KEY_DOCUMENT),)
@@ -84,6 +85,7 @@ snippet_asmlib = $(SNIPPET_DIR)/c/cstart.o
 # perquisites (=guests) for the snippet hosts.
 # $(TEST_DIR)/<snippet-host>.elf: snippets = $(SNIPPET_DIR)/<c/asm>/<snippet>.gbin
 $(TEST_DIR)/mvpg-sie.elf: snippets = $(SNIPPET_DIR)/c/mvpg-snippet.gbin
+$(TEST_DIR)/spec_ex-sie.elf: snippets = $(SNIPPET_DIR)/c/spec_ex.gbin
 
 $(SNIPPET_DIR)/asm/%.gbin: $(SNIPPET_DIR)/asm/%.o $(FLATLIBS)
 	$(OBJCOPY) -O binary $(patsubst %.gbin,%.o,$@) $@
lib/s390x/sie.h +1 -0
index 6ba858a..a3b8623 100644
@@ -98,6 +98,7 @@ struct kvm_s390_sie_block {
 	uint8_t		fpf;			/* 0x0060 */
 #define ECB_GS		0x40
 #define ECB_TE		0x10
+#define ECB_SPECI	0x08
 #define ECB_SRSI	0x04
 #define ECB_HOSTPROTINT	0x02
 	uint8_t		ecb;			/* 0x0061 */
s390x/snippets/c/spec_ex.c new file +13 -0
new file mode 100644
index 0000000..f2daab5
@@ -0,0 +1,13 @@
+#include <stdint.h>
+#include <asm/arch_def.h>
+
+__attribute__((section(".text"))) int main(void)
+{
+	uint64_t bad_psw = 0;
+	struct psw *pgm_new = (struct psw *)464;
+
+	pgm_new->mask = 1UL << (63 - 12); //invalid program new PSW
+	pgm_new->addr = 0xdeadbeef;
+	asm volatile ("lpsw %0" :: "Q"(bad_psw));
+	return 0;
+}
s390x/spec_ex-sie.c new file +91 -0

91 lines not on this page · raw message

s390x/unittests.cfg +3 -0
index 9e1802f..3b454b7 100644
@@ -109,3 +109,6 @@ file = edat.elf
 
 [mvpg-sie]
 file = mvpg-sie.elf
+
+[spec_ex-sie]
+file = spec_ex-sie.elf

base-commit: bc6f264386b4cb2cadc8b2492315f3e6e8a801a2
prerequisite-patch-id: 17697772b67d510e0e60108671c0dc2815973dca
prerequisite-patch-id: 5501a7902745c87349c05ebd88b709c7ac82557e
prerequisite-patch-id: 8377cf56402b62f5684b8c4113237b31e3373523
prerequisite-patch-id: cb9fd55b0ee96866d685616af914cfa752ea0cd3
prerequisite-patch-id: aed25b2421e37aba8786f65ef0ef10ac192d3098
prerequisite-patch-id: c50347e3942c594532d639fa4071c39b8e5e5415
prerequisite-patch-id: 116a357c74b3973d972ec206f066add611ce55ce
prerequisite-patch-id: c4f9f65f5fd25ca35cc04f16a21ef3653d59fc8f

Signature · 1 line
2.31.1
#1 lore raw

s390x/snippets/c/spec_ex.c

Quoted 60 lines · Janis Schoetterl-Glausch

Check that specification exceptions cause intercepts when specification exception interpretation is off.
Check that specification exceptions caused by program new PSWs cause interceptions.
We cannot assert that non program new PSW specification exceptions are interpreted because whether interpretation occurs or not is configuration dependent.

---
The patch is based on the following patch sets by Janosch:
[kvm-unit-tests PATCH 0/5] s390x: sie and uv cleanups [kvm-unit-tests PATCH v2 0/3] s390x: Add snippet support

  s390x/Makefile             |  2 +
  lib/s390x/sie.h            |  1 +
  s390x/snippets/c/spec_ex.c | 13 ++++++
  s390x/spec_ex-sie.c        | 91 ++++++++++++++++++++++++++++++++++++++
  s390x/unittests.cfg        |  3 ++
  5 files changed, 110 insertions(+)

create mode 100644 s390x/snippets/c/spec_ex.c
create mode 100644 s390x/spec_ex-sie.c

s390x/Makefile +2 -0
index 07af26d..b1b6536 100644
@@ -24,6 +24,7 @@ tests += $(TEST_DIR)/mvpg.elf
  tests += $(TEST_DIR)/uv-host.elf
  tests += $(TEST_DIR)/edat.elf
  tests += $(TEST_DIR)/mvpg-sie.elf
+tests += $(TEST_DIR)/spec_ex-sie.elf
 
  tests_binary = $(patsubst %.elf,%.bin,$(tests))
  ifneq ($(HOST_KEY_DOCUMENT),)
@@ -84,6 +85,7 @@ snippet_asmlib = $(SNIPPET_DIR)/c/cstart.o
  # perquisites (=guests) for the snippet hosts.
  # $(TEST_DIR)/<snippet-host>.elf: snippets = $(SNIPPET_DIR)/<c/asm>/<snippet>.gbin
  $(TEST_DIR)/mvpg-sie.elf: snippets = $(SNIPPET_DIR)/c/mvpg-snippet.gbin
+$(TEST_DIR)/spec_ex-sie.elf: snippets = $(SNIPPET_DIR)/c/spec_ex.gbin
 
  $(SNIPPET_DIR)/asm/%.gbin: $(SNIPPET_DIR)/asm/%.o $(FLATLIBS)
  	$(OBJCOPY) -O binary $(patsubst %.gbin,%.o,$@) $@
lib/s390x/sie.h +1 -0
index 6ba858a..a3b8623 100644
@@ -98,6 +98,7 @@ struct kvm_s390_sie_block {
  	uint8_t		fpf;			/* 0x0060 */
  #define ECB_GS		0x40
  #define ECB_TE		0x10
+#define ECB_SPECI	0x08
  #define ECB_SRSI	0x04
  #define ECB_HOSTPROTINT	0x02
  	uint8_t		ecb;			/* 0x0061 */
s390x/snippets/c/spec_ex.c new file +0 -0
new file mode 100644
index 0000000..f2daab5

Please add a short header comment with the basic idea here + license information (e.g. SPDX identifier). Also in the other new file that you introduce in this patch.

s390x/snippets/c/spec_ex.c line 7

Quoted 8 lines
s390x/snippets/c/spec_ex.c new file +7 -0
@@ -0,0 +1,13 @@
+#include <stdint.h>
+#include <asm/arch_def.h>
+
+__attribute__((section(".text"))) int main(void)
+{
+	uint64_t bad_psw = 0;
+	struct psw *pgm_new = (struct psw *)464;

Is it possible to use the lib/s390x/asm/arch_def.h in snippets? If so, I'd vote for using &lowcore->pgm_new_psw instead of the magic number 464.

s390x/snippets/c/spec_ex.c line 9

Quoted 1 line
s390x/snippets/c/spec_ex.c new file +1 -0
+	pgm_new->mask = 1UL << (63 - 12); //invalid program new PSW

Please add a space after the //
(also in the other spots in this patch)

s390x/snippets/c/spec_ex.c line 10

Quoted 1 line
s390x/snippets/c/spec_ex.c new file +1 -0
+	pgm_new->addr = 0xdeadbeef;

Are we testing the mask or the addr here? If we're testing the mask, I'd rather use an even addr here to make sure that we do not trap because of the uneven address. Or do we just don't care?

s390x/snippets/c/spec_ex.c line 13

Quoted 3 lines
s390x/snippets/c/spec_ex.c new file +3 -0
+	asm volatile ("lpsw %0" :: "Q"(bad_psw));
+	return 0;
+}

Thomas

#2 lore raw
Quoted 66 lines · Thomas Huth

s390x/snippets/c/spec_ex.c

Quoted 60 lines · Janis Schoetterl-Glausch

Check that specification exceptions cause intercepts when specification exception interpretation is off.
Check that specification exceptions caused by program new PSWs cause interceptions.
We cannot assert that non program new PSW specification exceptions are interpreted because whether interpretation occurs or not is configuration dependent.

---
The patch is based on the following patch sets by Janosch:
[kvm-unit-tests PATCH 0/5] s390x: sie and uv cleanups [kvm-unit-tests PATCH v2 0/3] s390x: Add snippet support

  s390x/Makefile             |  2 +
  lib/s390x/sie.h            |  1 +
  s390x/snippets/c/spec_ex.c | 13 ++++++
  s390x/spec_ex-sie.c        | 91 ++++++++++++++++++++++++++++++++++++++
  s390x/unittests.cfg        |  3 ++
  5 files changed, 110 insertions(+)

create mode 100644 s390x/snippets/c/spec_ex.c
create mode 100644 s390x/spec_ex-sie.c

s390x/Makefile +2 -0
index 07af26d..b1b6536 100644
@@ -24,6 +24,7 @@ tests += $(TEST_DIR)/mvpg.elf
  tests += $(TEST_DIR)/uv-host.elf
  tests += $(TEST_DIR)/edat.elf
  tests += $(TEST_DIR)/mvpg-sie.elf
+tests += $(TEST_DIR)/spec_ex-sie.elf
 
  tests_binary = $(patsubst %.elf,%.bin,$(tests))
  ifneq ($(HOST_KEY_DOCUMENT),)
@@ -84,6 +85,7 @@ snippet_asmlib = $(SNIPPET_DIR)/c/cstart.o
  # perquisites (=guests) for the snippet hosts.
  # $(TEST_DIR)/<snippet-host>.elf: snippets = $(SNIPPET_DIR)/<c/asm>/<snippet>.gbin
  $(TEST_DIR)/mvpg-sie.elf: snippets = $(SNIPPET_DIR)/c/mvpg-snippet.gbin
+$(TEST_DIR)/spec_ex-sie.elf: snippets = $(SNIPPET_DIR)/c/spec_ex.gbin
 
  $(SNIPPET_DIR)/asm/%.gbin: $(SNIPPET_DIR)/asm/%.o $(FLATLIBS)
  	$(OBJCOPY) -O binary $(patsubst %.gbin,%.o,$@) $@
lib/s390x/sie.h +1 -0
index 6ba858a..a3b8623 100644
@@ -98,6 +98,7 @@ struct kvm_s390_sie_block {
  	uint8_t		fpf;			/* 0x0060 */
  #define ECB_GS		0x40
  #define ECB_TE		0x10
+#define ECB_SPECI	0x08
  #define ECB_SRSI	0x04
  #define ECB_HOSTPROTINT	0x02
  	uint8_t		ecb;			/* 0x0061 */
s390x/snippets/c/spec_ex.c new file +0 -0
new file mode 100644
index 0000000..f2daab5

Please add a short header comment with the basic idea here + license information (e.g. SPDX identifier). Also in the other new file that you introduce in this patch.

Quoted 11 lines

s390x/snippets/c/spec_ex.c line 7

Quoted 8 lines
s390x/snippets/c/spec_ex.c new file +7 -0
@@ -0,0 +1,13 @@
+#include <stdint.h>
+#include <asm/arch_def.h>
+
+__attribute__((section(".text"))) int main(void)
+{
+	uint64_t bad_psw = 0;
+	struct psw *pgm_new = (struct psw *)464;

Is it possible to use the lib/s390x/asm/arch_def.h in snippets? If so, I'd vote for using &lowcore->pgm_new_psw instead of the magic number 464.

I think it should be, we don't print in arch_def.h and that's usually the biggest problem for snippets.

But even if it doesn't work we can still use GEN_LC_PGM_NEW_PSW from asm-offsets.h

Quoted 11 lines

s390x/snippets/c/spec_ex.c line 9

Quoted 2 lines
s390x/snippets/c/spec_ex.c new file +1 -0
+	pgm_new->mask = 1UL << (63 - 12); //invalid program new PSW

Please add a space after the //
(also in the other spots in this patch)

s390x/snippets/c/spec_ex.c line 10

Quoted 1 line
s390x/snippets/c/spec_ex.c new file +1 -0
+	pgm_new->addr = 0xdeadbeef;

Are we testing the mask or the addr here? If we're testing the mask, I'd rather use an even addr here to make sure that we do not trap because of the uneven address. Or do we just don't care?

If I remember correctly then the odd address would be a late exception and an invalid mask is an early exception. The whole topic of PSW exceptions is rather complex especially if you add the instructions that change the PSW into the consideration.

Quoted 7 lines

s390x/snippets/c/spec_ex.c line 13

Quoted 4 lines
s390x/snippets/c/spec_ex.c new file +3 -0
+	asm volatile ("lpsw %0" :: "Q"(bad_psw));
+	return 0;
+}

Thomas

#3 lore raw
In reply to Janis Schoetterl-Glausch
Quoted 118 lines · Janis Schoetterl-Glausch

Check that specification exceptions cause intercepts when specification exception interpretation is off.
Check that specification exceptions caused by program new PSWs cause interceptions.
We cannot assert that non program new PSW specification exceptions are interpreted because whether interpretation occurs or not is configuration dependent.

---
The patch is based on the following patch sets by Janosch:
[kvm-unit-tests PATCH 0/5] s390x: sie and uv cleanups [kvm-unit-tests PATCH v2 0/3] s390x: Add snippet support

 s390x/Makefile             |  2 +
 lib/s390x/sie.h            |  1 +
 s390x/snippets/c/spec_ex.c | 13 ++++++
 s390x/spec_ex-sie.c        | 91 ++++++++++++++++++++++++++++++++++++++
 s390x/unittests.cfg        |  3 ++
 5 files changed, 110 insertions(+)
 create mode 100644 s390x/snippets/c/spec_ex.c
 create mode 100644 s390x/spec_ex-sie.c
s390x/Makefile +2 -0
index 07af26d..b1b6536 100644
@@ -24,6 +24,7 @@ tests += $(TEST_DIR)/mvpg.elf
 tests += $(TEST_DIR)/uv-host.elf
 tests += $(TEST_DIR)/edat.elf
 tests += $(TEST_DIR)/mvpg-sie.elf
+tests += $(TEST_DIR)/spec_ex-sie.elf
 
 tests_binary = $(patsubst %.elf,%.bin,$(tests))
 ifneq ($(HOST_KEY_DOCUMENT),)
@@ -84,6 +85,7 @@ snippet_asmlib = $(SNIPPET_DIR)/c/cstart.o
 # perquisites (=guests) for the snippet hosts.
 # $(TEST_DIR)/<snippet-host>.elf: snippets = $(SNIPPET_DIR)/<c/asm>/<snippet>.gbin
 $(TEST_DIR)/mvpg-sie.elf: snippets = $(SNIPPET_DIR)/c/mvpg-snippet.gbin
+$(TEST_DIR)/spec_ex-sie.elf: snippets = $(SNIPPET_DIR)/c/spec_ex.gbin
 
 $(SNIPPET_DIR)/asm/%.gbin: $(SNIPPET_DIR)/asm/%.o $(FLATLIBS)
 	$(OBJCOPY) -O binary $(patsubst %.gbin,%.o,$@) $@
lib/s390x/sie.h +1 -0
index 6ba858a..a3b8623 100644
@@ -98,6 +98,7 @@ struct kvm_s390_sie_block {
 	uint8_t		fpf;			/* 0x0060 */
 #define ECB_GS		0x40
 #define ECB_TE		0x10
+#define ECB_SPECI	0x08
 #define ECB_SRSI	0x04
 #define ECB_HOSTPROTINT	0x02
 	uint8_t		ecb;			/* 0x0061 */
s390x/snippets/c/spec_ex.c new file +13 -0
new file mode 100644
index 0000000..f2daab5
@@ -0,0 +1,13 @@
+#include <stdint.h>
+#include <asm/arch_def.h>
+
+__attribute__((section(".text"))) int main(void)
+{
+	uint64_t bad_psw = 0;
+	struct psw *pgm_new = (struct psw *)464;
+
+	pgm_new->mask = 1UL << (63 - 12); //invalid program new PSW
+	pgm_new->addr = 0xdeadbeef;
+	asm volatile ("lpsw %0" :: "Q"(bad_psw));
+	return 0;
+}
s390x/spec_ex-sie.c new file +38 -0
new file mode 100644
index 0000000..7aa2f49
@@ -0,0 +1,91 @@
+#include <libcflat.h>
+#include <sclp.h>
+#include <asm/page.h>
+#include <asm/arch_def.h>
+#include <alloc_page.h>
+#include <vm.h>
+#include <sie.h>
+
+static struct vm vm;
+extern const char _binary_s390x_snippets_c_spec_ex_gbin_start[];
+extern const char _binary_s390x_snippets_c_spec_ex_gbin_end[];
+
+static void setup_guest(void)
+{
+	char *guest;
+	int binary_size = ((uintptr_t)_binary_s390x_snippets_c_spec_ex_gbin_end -
+			   (uintptr_t)_binary_s390x_snippets_c_spec_ex_gbin_start);
+
+	setup_vm();
+
+	/* Allocate 1MB as guest memory */
+	guest = alloc_pages(8);
+	/* The first two pages are the lowcore */
+
+	vm.sblk = alloc_page();
+
+	vm.sblk->cpuflags = CPUSTAT_ZARCH | CPUSTAT_RUNNING;
+	vm.sblk->prefix = 0;
+	/*
+	 * Pageable guest with the same ASCE as the test program, but
+	 * the guest memory 0x0 is offset to start at the allocated
+	 * guest pages and end after 1MB.
+	 *
+	 * It's not pretty but faster and easier than managing guest ASCEs.
+	 */
+	vm.sblk->mso = (u64)guest;
+	vm.sblk->msl = (u64)guest;
+	vm.sblk->ihcpu = 0xffff;

s390x/spec_ex-sie.c line 48

Quoted 10 lines
s390x/spec_ex-sie.c new file +10 -0
+
+	vm.sblk->crycbd = (uint64_t)alloc_page();
+
+	memcpy(guest, _binary_s390x_snippets_c_spec_ex_gbin_start, binary_size);
+}
+
+static void reset_guest(void)
+{
+	vm.sblk->gpsw.addr = PAGE_SIZE * 4;
+	vm.sblk->gpsw.mask = 0x0000000180000000ULL;

Remind me to add that to arch_def.h...

Quoted 12 lines
s390x/spec_ex-sie.c new file +12 -0
+}
+
+static void test_spec_ex_sie(void)
+{
+	setup_guest();
+
+	report_prefix_push("spec ex interpretation off");
+	reset_guest();
+	sie64a(vm.sblk, &vm.save_area);
+	//interpretation off -> initial exception must cause interception
+	report(vm.sblk->icptcode == ICPT_PROGI
+	       && vm.sblk->iprcc == PGM_INT_CODE_SPECIFICATION

s390x/spec_ex-sie.c line 70

Quoted 10 lines
s390x/spec_ex-sie.c new file +10 -0
+	       && vm.sblk->gpsw.addr != 0xdeadbeef,
+	       "Received specification exception intercept for non program new PSW");
+	report_prefix_pop();
+
+	report_prefix_push("spec ex interpretation on");
+	vm.sblk->ecb |= ECB_SPECI;
+	reset_guest();
+	sie64a(vm.sblk, &vm.save_area);
+	// interpretation on -> configuration dependent if initial exception causes
+	// interception, but invalid new program PSW must

Multi line comments are usually done via /* */
Generally // is not really used as a comment in the s390 part of this project.

s390x/spec_ex-sie.c line 82

Quoted 12 lines
s390x/spec_ex-sie.c new file +12 -0
+	report(vm.sblk->icptcode == ICPT_PROGI
+	       && vm.sblk->iprcc == PGM_INT_CODE_SPECIFICATION,
+	       "Received specification exception intercept");
+	if (vm.sblk->gpsw.addr == 0xdeadbeef)
+		report_info("Interpreted non program new PSW specification exception");
+	else
+		report_info("Did not interpret non program new PSW specification exception");
+	report_prefix_pop();
+}
+
+int main(int argc, char **argv)
+{

Is there a reason you didn't push a prefix here?
"spec ex sie"

and then:
"interpretation off"
and
"interpretation on"

Only minor nits, we hopefully should only need one more version :)

Quoted 31 lines
s390x/spec_ex-sie.c new file +9 -0
+	if (!sclp_facilities.has_sief2) {
+		report_skip("SIEF2 facility unavailable");
+		goto out;
+	}
+
+	test_spec_ex_sie();
+out:
+	return report_summary();
+}
s390x/unittests.cfg +3 -0
index 9e1802f..3b454b7 100644
@@ -109,3 +109,6 @@ file = edat.elf
 
 [mvpg-sie]
 file = mvpg-sie.elf
+
+[spec_ex-sie]
+file = spec_ex-sie.elf

base-commit: bc6f264386b4cb2cadc8b2492315f3e6e8a801a2
prerequisite-patch-id: 17697772b67d510e0e60108671c0dc2815973dca
prerequisite-patch-id: 5501a7902745c87349c05ebd88b709c7ac82557e
prerequisite-patch-id: 8377cf56402b62f5684b8c4113237b31e3373523
prerequisite-patch-id: cb9fd55b0ee96866d685616af914cfa752ea0cd3
prerequisite-patch-id: aed25b2421e37aba8786f65ef0ef10ac192d3098
prerequisite-patch-id: c50347e3942c594532d639fa4071c39b8e5e5415
prerequisite-patch-id: 116a357c74b3973d972ec206f066add611ce55ce
prerequisite-patch-id: c4f9f65f5fd25ca35cc04f16a21ef3653d59fc8f