Build

Speculator build system is based on cmake. For convenience, we suggest to create a build and an install folders and update the speculator.env accordingly.

This will prevent mixing of object files and, Makefile or ninja files with the source code.

Speculator cmake options

Hereafter the list of options that can be enabled during configure time.

DEBUG= [ON|OFF] (default OFF)

This option enables debug symbols for the monitor. The tests should already have debug symbols if compiled from c code.

VICTIM= [INTEGER] (default 0)

This option allow to specify which CPU should be used for the VICTIM. This will be propagate into the monitor and the tests set as VICTIM.

ATTACKER= [INTEGER] (default 4)

This option allow to specify which CPU should be used for the ATTACKER. This will be propagate into the monitor and the tests set as ATTACKER.

DUMMY= [path/to/dummy] (default not enabled)

This option allow to set between the execution of a program between each run to prep the CPU into a wanted state.

CANARY= [ON|OFF] (default OFF)

This option allows to enable canary support for the tests. To enable stack canaries the tests are compiled against dynamically linked glibc.