Xen Test Framework
Functions | Variables
test.h File Reference

API for tests. More...

#include <xtf/types.h>
+ Include dependency graph for test.h:
+ This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Functions

void test_main (void)
 To be implemented by each test, as its entry point. More...
 

Variables

const char test_title []
 The title of the test. More...
 
bool xtf_has_fep
 Boolean indicating whether generic Force Emulation Prefix support is available for the test to use. More...
 
bool test_wants_user_mappings
 Boolean indicating whether the test wants user mappings or not. More...
 
bool test_needs_fep
 Boolean indicating whether the test is entirely predicated on the available of the Force Emulation Prefix. More...
 

Detailed Description

API for tests.

Definition in file test.h.

Function Documentation

◆ test_main()

void test_main ( void  )

To be implemented by each test, as its entry point.

Todo:
Implement better command line infrastructure, but this will do for now.

At the time of writing, Xen doesn't correctly handle invlpg while running in shadow mode on AMD Gen1 hardware lacking decode assistance. For this test, we simply care that Xen doesn't crash.

Definition at line 137 of file main.c.

+ Here is the caller graph for this function:

Variable Documentation

◆ test_title

const char test_title[]

The title of the test.

Definition at line 14 of file main.c.

◆ xtf_has_fep

bool xtf_has_fep

Boolean indicating whether generic Force Emulation Prefix support is available for the test to use.

Definition at line 276 of file setup.c.

◆ test_wants_user_mappings

bool test_wants_user_mappings

Boolean indicating whether the test wants user mappings or not.

Some tests want an easy transition between supervisor and user modes. For such tests, this requires running on _PAGE_USER mappings, and they must opt-in.

See also
Errata

The framework variable is a weak reference, and may be overridden by a test wishing to change the default.

Definition at line 287 of file setup.c.

◆ test_needs_fep

bool test_needs_fep

Boolean indicating whether the test is entirely predicated on the available of the Force Emulation Prefix.

Definition at line 288 of file setup.c.