Skip to contentSkip to conversation

selftests/sgx: Rename 'eenter' and 'sgx_call_vdso'

PATCH Superseded Jarkko Sakkinen 2 participants 7 messages May 12, 2021 – May 20, 2021

Subsystems (2)

v5 of 8 Superseded Latest is v8 →

lore
Share & tools
lore

Jarkko Sakkinen

author maintainer
#0 lore raw

PATCH v5 1/2 selftests/sgx: Rename 'eenter' and 'sgx_call_vdso'

Rename symbols for better clarity:

* 'eenter' might be confused for directly calling ENCLU[EENTER]. It does not. It calls into the VDSO, which actually has the EENTER instruction.
* 'sgx_call_vdso' is *only* used for entering the enclave. It's not some generic SGX call into the VDSO.

---

v3:
Refine the commit message according to Dave's suggestions.

v2:
Refined the renames just a bit.

 tools/testing/selftests/sgx/call.S |  6 +++---
 tools/testing/selftests/sgx/main.c | 25 +++++++++++++------------
 tools/testing/selftests/sgx/main.h |  4 ++--
 3 files changed, 18 insertions(+), 17 deletions(-)
tools/testing/selftests/sgx/call.S +3 -3
index 4ecadc7490f4..b09a25890f3b 100644
@@ -5,8 +5,8 @@
 
 	.text
 
-	.global sgx_call_vdso
-sgx_call_vdso:
+	.global sgx_enter_enclave
+sgx_enter_enclave:
 	.cfi_startproc
 	push	%r15
 	.cfi_adjust_cfa_offset	8
@@ -27,7 +27,7 @@ sgx_call_vdso:
 	.cfi_adjust_cfa_offset	8
 	push	0x38(%rsp)
 	.cfi_adjust_cfa_offset	8
-	call	*eenter(%rip)
+	call	*vdso_sgx_enter_enclave(%rip)
 	add	$0x10, %rsp
 	.cfi_adjust_cfa_offset	-0x10
 	pop	%rbx
tools/testing/selftests/sgx/main.c +13 -12
index d304a4044eb9..43da68388e25 100644
@@ -21,7 +21,7 @@
 #include "../kselftest.h"
 
 static const uint64_t MAGIC = 0x1122334455667788ULL;
-vdso_sgx_enter_enclave_t eenter;
+vdso_sgx_enter_enclave_t vdso_sgx_enter_enclave;
 
 struct vdso_symtab {
 	Elf64_Sym *elf_symtab;
@@ -149,7 +149,7 @@ int main(int argc, char *argv[])
 {
 	struct sgx_enclave_run run;
 	struct vdso_symtab symtab;
-	Elf64_Sym *eenter_sym;
+	Elf64_Sym *sgx_enter_enclave_sym;
 	uint64_t result = 0;
 	struct encl encl;
 	unsigned int i;
@@ -194,29 +194,30 @@ int main(int argc, char *argv[])
 	if (!vdso_get_symtab(addr, &symtab))
 		goto err;
 
-	eenter_sym = vdso_symtab_get(&symtab, "__vdso_sgx_enter_enclave");
-	if (!eenter_sym)
+	sgx_enter_enclave_sym = vdso_symtab_get(&symtab, "__vdso_sgx_enter_enclave");
+	if (!sgx_enter_enclave_sym)
 		goto err;
 
-	eenter = addr + eenter_sym->st_value;
+	vdso_sgx_enter_enclave = addr + sgx_enter_enclave_sym->st_value;
 
-	ret = sgx_call_vdso((void *)&MAGIC, &result, 0, EENTER, NULL, NULL, &run);
-	if (!report_results(&run, ret, result, "sgx_call_vdso"))
+	ret = sgx_enter_enclave((void *)&MAGIC, &result, 0, EENTER,
+					    NULL, NULL, &run);
+	if (!report_results(&run, ret, result, "sgx_enter_enclave_unclobbered"))
 		goto err;
 
 
 	/* Invoke the vDSO directly. */
 	result = 0;
-	ret = eenter((unsigned long)&MAGIC, (unsigned long)&result, 0, EENTER,
-		     0, 0, &run);
-	if (!report_results(&run, ret, result, "eenter"))
+	ret = vdso_sgx_enter_enclave((unsigned long)&MAGIC, (unsigned long)&result,
+				     0, EENTER, 0, 0, &run);
+	if (!report_results(&run, ret, result, "sgx_enter_enclave"))
 		goto err;
 
 	/* And with an exit handler. */
 	run.user_handler = (__u64)user_handler;
 	run.user_data = 0xdeadbeef;
-	ret = eenter((unsigned long)&MAGIC, (unsigned long)&result, 0, EENTER,
-		     0, 0, &run);
+	ret = vdso_sgx_enter_enclave((unsigned long)&MAGIC, (unsigned long)&result,
+				     0, EENTER, 0, 0, &run);
 	if (!report_results(&run, ret, result, "user_handler"))
 		goto err;
 
tools/testing/selftests/sgx/main.h +2 -2
index 67211a708f04..68672fd86cf9 100644
@@ -35,7 +35,7 @@ bool encl_load(const char *path, struct encl *encl);
 bool encl_measure(struct encl *encl);
 bool encl_build(struct encl *encl);
 
-int sgx_call_vdso(void *rdi, void *rsi, long rdx, u32 function, void *r8, void *r9,
-		  struct sgx_enclave_run *run);
+int sgx_enter_enclave(void *rdi, void *rsi, long rdx, u32 function, void *r8, void *r9,
+		      struct sgx_enclave_run *run);
 
 #endif /* MAIN_H */
Signature · 1 line
2.31.1
author maintainer
#1 lore raw

PATCH v5 2/2 selftests/sgx: Migrate to kselftest harness

Migrate to kselftest harness. Use a fixture test with enclave initialized and de-initialized for each of the existing three tests, in other words:

1. One FIXTURE() for managing the enclave life-cycle.
2. Three TEST_F()'s, one for each test case.

This gives a leaps better reporting than before. Here's an example transcript:

TAP version 13
1..3

ok 1 enclave.unclobbered_vdso

ok 2 enclave.clobbered_vdso

ok 3 enclave.clobbered_vdso_and_user_function

---

v5:
* Use TH_LOG() for printing enclave address ranges instead of printf(), based on Reinette's remark.

v4:
* Refine to take better use of the kselftest harness macros.
* Fix: TCS base address was not initialized for a run struct.

v3:
* Use helper macros.

v2:
* Add the missing string argument to ksft_test_result_pass() and ksft_test_result_fail() calls.

 tools/testing/selftests/sgx/load.c |   3 -
 tools/testing/selftests/sgx/main.c | 170 ++++++++++++++---------------
 2 files changed, 85 insertions(+), 88 deletions(-)
tools/testing/selftests/sgx/load.c +0 -3
index f441ac34b4d4..00928be57fc4 100644
@@ -239,9 +239,6 @@ bool encl_load(const char *path, struct encl *encl)
 		seg->offset = (phdr->p_offset & PAGE_MASK) - src_offset;
 		seg->size = (phdr->p_filesz + PAGE_SIZE - 1) & PAGE_MASK;
 
-		printf("0x%016lx 0x%016lx 0x%02x\n", seg->offset, seg->size,
-		       seg->prot);
-
 		j++;
 	}
 
tools/testing/selftests/sgx/main.c +85 -85

210 lines not on this page · raw message

Signature · 1 line
2.31.1
#2 lore raw

Re: [PATCH v5 2/2] selftests/sgx: Migrate to kselftest harness

Hi Jarkko,

Quoted 16 lines · Jarkko Sakkinen

Migrate to kselftest harness. Use a fixture test with enclave initialized and de-initialized for each of the existing three tests, in other words:

1. One FIXTURE() for managing the enclave life-cycle.
2. Three TEST_F()'s, one for each test case.

This gives a leaps better reporting than before. Here's an example transcript:

TAP version 13
1..3

ok 1 enclave.unclobbered_vdso

ok 2 enclave.clobbered_vdso

Quoted 8 lines

ok 3 enclave.clobbered_vdso_and_user_function

---

v5:
* Use TH_LOG() for printing enclave address ranges instead of printf(), based on Reinette's remark.

Thank you for considering my feedback. The motivation for my comment was to consider how this test output will be parsed. If these tests will have their output parsed by automated systems then it needs to conform to the TAP13 format as supported by kselftest.

In your latest version the output printed during a successful test has been changed, using TH_LOG() as you noted. From what I can tell this is the only output addressed - failing tests continue to print error messages (perror, fprintf) without consideration of how they will be parsed. My apologies, I am not a kselftest expert to know what the best way for this integration is.

Reinette

author maintainer
#3 lore raw

Re: [PATCH v5 2/2] selftests/sgx: Migrate to kselftest harness

Quoted 33 lines · Reinette Chatre

Hi Jarkko,

Quoted 16 lines · Jarkko Sakkinen

Migrate to kselftest harness. Use a fixture test with enclave initialized and de-initialized for each of the existing three tests, in other words:

1. One FIXTURE() for managing the enclave life-cycle.
2. Three TEST_F()'s, one for each test case.

This gives a leaps better reporting than before. Here's an example transcript:

TAP version 13
1..3

ok 1 enclave.unclobbered_vdso

ok 2 enclave.clobbered_vdso

Quoted 8 lines

ok 3 enclave.clobbered_vdso_and_user_function

---

v5:
* Use TH_LOG() for printing enclave address ranges instead of printf(), based on Reinette's remark.

Thank you for considering my feedback. The motivation for my comment was to consider how this test output will be parsed. If these tests will have their output parsed by automated systems then it needs to conform to the TAP13 format as supported by kselftest.

Quoted 7 lines

In your latest version the output printed during a successful test has been changed, using TH_LOG() as you noted. From what I can tell this is the only output addressed - failing tests continue to print error messages (perror, fprintf) without consideration of how they will be parsed. My apologies, I am not a kselftest expert to know what the best way for this integration is.

Reinette

It's a valid question, yes.

The problem is that only main.c can use kselftest macros because kselftest_harness.h pulls

static int test_harness_run(int __attribute__((unused)) argc,

			    char __attribute__((unused)) **argv)

which will not end up having a call site (because there's no "TEST_HARNESS_MAIN").

The whole logging thing in kselftest harness is a bit ambiguous. Namely:

1. There's a macro TH_LOG() defined in kselftest_harness.h, which "internally" uses fprintf().
2. There's an inline function ksft_print_msg() in kselftest.h using vsprintf().

To add to that, kselftest_harness.h internally prints by using ksft_print_msg(), and provides TH_LOG(), which does not use ksft_print_msg().

I don't really get the logic in all this.

/Jarkko

author maintainer
#4 lore raw

Re: [PATCH v5 2/2] selftests/sgx: Migrate to kselftest harness

Quoted 61 lines · Jarkko Sakkinen
Quoted 33 lines · Reinette Chatre

Hi Jarkko,

Quoted 16 lines · Jarkko Sakkinen

Migrate to kselftest harness. Use a fixture test with enclave initialized and de-initialized for each of the existing three tests, in other words:

1. One FIXTURE() for managing the enclave life-cycle.
2. Three TEST_F()'s, one for each test case.

This gives a leaps better reporting than before. Here's an example transcript:

TAP version 13
1..3

ok 1 enclave.unclobbered_vdso

ok 2 enclave.clobbered_vdso

Quoted 8 lines

ok 3 enclave.clobbered_vdso_and_user_function

---

v5:
* Use TH_LOG() for printing enclave address ranges instead of printf(), based on Reinette's remark.

Thank you for considering my feedback. The motivation for my comment was to consider how this test output will be parsed. If these tests will have their output parsed by automated systems then it needs to conform to the TAP13 format as supported by kselftest.

Quoted 7 lines

In your latest version the output printed during a successful test has been changed, using TH_LOG() as you noted. From what I can tell this is the only output addressed - failing tests continue to print error messages (perror, fprintf) without consideration of how they will be parsed. My apologies, I am not a kselftest expert to know what the best way for this integration is.

Reinette

It's a valid question, yes.

The problem is that only main.c can use kselftest macros because kselftest_harness.h pulls

static int test_harness_run(int __attribute__((unused)) argc,

			    char __attribute__((unused)) **argv)

which will not end up having a call site (because there's no "TEST_HARNESS_MAIN").

The whole logging thing in kselftest harness is a bit ambiguous. Namely:

1. There's a macro TH_LOG() defined in kselftest_harness.h, which "internally" uses fprintf().
2. There's an inline function ksft_print_msg() in kselftest.h using vsprintf().

Quoted 5 lines

To add to that, kselftest_harness.h internally prints by using ksft_print_msg(), and provides TH_LOG(), which does not use ksft_print_msg().

I don't really get the logic in all this.

I tried to split TH_LOG() as separate entity but it's not possible, as the macros access a static variable called '_metadata'.

I'm not exactly sure how to proceed from this, if we want to make logging consistent.

I would personally suggest to leave the error messages intact in load.c, because there is no way to make them consistent, except by removing them.

/Jarkko

#5 lore raw

Re: [PATCH v5 2/2] selftests/sgx: Migrate to kselftest harness

Hi Jarkko,

Quoted 68 lines · Jarkko Sakkinen
Quoted 61 lines · Jarkko Sakkinen
Quoted 33 lines · Reinette Chatre

Hi Jarkko,

Quoted 16 lines · Jarkko Sakkinen

Migrate to kselftest harness. Use a fixture test with enclave initialized and de-initialized for each of the existing three tests, in other words:

1. One FIXTURE() for managing the enclave life-cycle.
2. Three TEST_F()'s, one for each test case.

This gives a leaps better reporting than before. Here's an example transcript:

TAP version 13
1..3

ok 1 enclave.unclobbered_vdso

ok 2 enclave.clobbered_vdso

Quoted 8 lines

ok 3 enclave.clobbered_vdso_and_user_function

---

v5:
* Use TH_LOG() for printing enclave address ranges instead of printf(), based on Reinette's remark.

Thank you for considering my feedback. The motivation for my comment was to consider how this test output will be parsed. If these tests will have their output parsed by automated systems then it needs to conform to the TAP13 format as supported by kselftest.

Quoted 7 lines

In your latest version the output printed during a successful test has been changed, using TH_LOG() as you noted. From what I can tell this is the only output addressed - failing tests continue to print error messages (perror, fprintf) without consideration of how they will be parsed. My apologies, I am not a kselftest expert to know what the best way for this integration is.

Reinette

It's a valid question, yes.

The problem is that only main.c can use kselftest macros because kselftest_harness.h pulls

static int test_harness_run(int __attribute__((unused)) argc,

			    char __attribute__((unused)) **argv)

which will not end up having a call site (because there's no "TEST_HARNESS_MAIN").

The whole logging thing in kselftest harness is a bit ambiguous. Namely:

1. There's a macro TH_LOG() defined in kselftest_harness.h, which "internally" uses fprintf().
2. There's an inline function ksft_print_msg() in kselftest.h using vsprintf().

Quoted 5 lines

To add to that, kselftest_harness.h internally prints by using ksft_print_msg(), and provides TH_LOG(), which does not use ksft_print_msg().

I don't really get the logic in all this.

Quoted 8 lines

I tried to split TH_LOG() as separate entity but it's not possible, as the macros access a static variable called '_metadata'.

I'm not exactly sure how to proceed from this, if we want to make logging consistent.

I would personally suggest to leave the error messages intact in load.c, because there is no way to make them consistent, except by removing them.

It is not clear to me why ksft_print_msg() cannot be used but an alternative to it may be to just prefix all existing diagnostic messages with "# ".

Reinette

author maintainer
#6 lore raw

Re: [PATCH v5 2/2] selftests/sgx: Migrate to kselftest harness

Quoted 77 lines · Reinette Chatre

Hi Jarkko,

Quoted 74 lines · Jarkko Sakkinen
Quoted 61 lines · Jarkko Sakkinen
Quoted 33 lines · Reinette Chatre

Hi Jarkko,

Quoted 16 lines · Jarkko Sakkinen

Migrate to kselftest harness. Use a fixture test with enclave initialized and de-initialized for each of the existing three tests, in other words:

1. One FIXTURE() for managing the enclave life-cycle.
2. Three TEST_F()'s, one for each test case.

This gives a leaps better reporting than before. Here's an example transcript:

TAP version 13
1..3

ok 1 enclave.unclobbered_vdso

ok 2 enclave.clobbered_vdso

Quoted 8 lines

ok 3 enclave.clobbered_vdso_and_user_function

---

v5:
* Use TH_LOG() for printing enclave address ranges instead of printf(), based on Reinette's remark.

Thank you for considering my feedback. The motivation for my comment was to consider how this test output will be parsed. If these tests will have their output parsed by automated systems then it needs to conform to the TAP13 format as supported by kselftest.

Quoted 7 lines

In your latest version the output printed during a successful test has been changed, using TH_LOG() as you noted. From what I can tell this is the only output addressed - failing tests continue to print error messages (perror, fprintf) without consideration of how they will be parsed. My apologies, I am not a kselftest expert to know what the best way for this integration is.

Reinette

It's a valid question, yes.

The problem is that only main.c can use kselftest macros because kselftest_harness.h pulls

static int test_harness_run(int __attribute__((unused)) argc,

			    char __attribute__((unused)) **argv)

which will not end up having a call site (because there's no "TEST_HARNESS_MAIN").

The whole logging thing in kselftest harness is a bit ambiguous. Namely:

1. There's a macro TH_LOG() defined in kselftest_harness.h, which "internally" uses fprintf().
2. There's an inline function ksft_print_msg() in kselftest.h using vsprintf().

Quoted 5 lines

To add to that, kselftest_harness.h internally prints by using ksft_print_msg(), and provides TH_LOG(), which does not use ksft_print_msg().

I don't really get the logic in all this.

I tried to split TH_LOG() as separate entity but it's not possible, as the macros access a static variable called '_metadata'.

I'm not exactly sure how to proceed from this, if we want to make logging consistent.

Quoted 8 lines
Quoted 2 lines

I would personally suggest to leave the error messages intact in load.c, because there is no way to make them consistent, except by removing them.

It is not clear to me why ksft_print_msg() cannot be used but an alternative to it may be to just prefix all existing diagnostic messages with "# ".

Reinette

How is using ksft_print_msg() better than using fprintf()? It's as incompatible with the logging used by fixtures, as is a raw fprintf().

What is the gain of doing that?

/Jarkko