From 013927f81afb08e06314b66c8c8cd8549d5711c1 Mon Sep 17 00:00:00 2001 From: Andrew Cooper Date: Mon, 30 Jan 2017 13:54:33 +0000 Subject: [PATCH] Improve documentation and error handling around FEP Signed-off-by: Andrew Cooper --- arch/x86/setup.c | 5 ++++- docs/mainpage.dox | 6 ++++++ 2 files changed, 10 insertions(+), 1 deletion(-) diff --git a/arch/x86/setup.c b/arch/x86/setup.c index d1c42d3..3e79226 100644 --- a/arch/x86/setup.c +++ b/arch/x86/setup.c @@ -229,7 +229,10 @@ void test_setup(void) : "0" (false)); if ( test_needs_fep && !xtf_has_fep ) - return xtf_skip("FEP unavailable, but needed by test\n"); + { + printk("FEP unavailable, but needed by test. (Is Xen support\n"); + return xtf_skip("compiled in, and booted with 'hvm_fep'?)\n"); + } } /* diff --git a/docs/mainpage.dox b/docs/mainpage.dox index c3257f5..91909e8 100644 --- a/docs/mainpage.dox +++ b/docs/mainpage.dox @@ -85,6 +85,12 @@ To run tests on a Xen host: (see @ref errata first) elsewhere, use `make install DESTDIR=$X xtfdir=$Y` to configure absolute paths appropriately for the test system. +- Some tests require the Xen Force Emulation Prefix to function. FEP + deliberately opens the x86 instruction emulator to arbitrary testing, and + should not be enabled in production. These tests must be run on a + hypervisor configured with `CONFIG_HVM_FEP` and booted with `'hvm_fep'` to + enable the runtime use of FEP. These tests will detect if FEP is + unavailable and exit with an error. @section further Further Information -- 2.39.5