Skip to content

Building HAL

Jump to bottom
SJulianS edited this page Oct 19, 2022 · 30 revisions

HAL officially supports (and is tested for) Ubuntu 20.04 and 22.04 only, but you are free to add support for other platforms. We also offer experimental support for macOS.

Ubuntu 20.04 and 22.04

If you want to build HAL on Ubuntu 20.04 or 22.04, run the following commands:

  1. git clone https://github.com/emsec/hal.git && cd hal to clone the Git repository
  2. ./install_dependencies.sh to install all required dependencies
  3. mkdir build && cd build to create and move to the build folder
  4. cmake .. [OPTIONS] to run cmake
  5. make to compile HAL
  6. from within the build folder, run ./bin/hal -g to launch HAL in GUI mode. More details on this can be found in ('Starting HAL').

Specifying options for cmake is optional and only required to build tests, documentation, or specific plugins that are disabled by default (see below). We do currently not support building on any other Linux distribution.

macOS

Warning: Building on macOS is experimental and may not always work.

All essential tools and dependencies for the HAL build must be installed via (Homebrew), so please make sure it is available on your system. Also make sure that you have git installed (brew install git).

  1. git clone https://github.com/emsec/hal.git && cd hal to clone the Git repository
  2. ./install_dependencies.sh to install all required dependencies

The latter command will not only install all dependencies listed in the Brewfile file but also build the igraph-0.9 library from source, so it make take some time. Once this is done the HAL build be done using a compiler that supports OpenMP (currently llvm@14). It might be a good idea to hide the llvm version number by creating a symbolic link.

  1. mkdir build && cd build to create and move to the build folder
  2. cmake -G Ninja .. -DQt5_DIR=/usr/local/opt/qt@5/lib/cmake -DPL_GUI=ON ‐DCMAKE_C_COMPILER=/usr/local/opt/llvm@14/bin/clang ‐DCMAKE_CXX_COMPILER=/usr/local/opt/llvm@14/bin/clang++ run cmake explicitly pointing to compiler location
  3. ninja to compile HAL

Windows

You can try using HAL directly on Windows using an Ubuntu 20.04 subsystem on WSL 2. After setting up WSL 2, follow the installation instructions for Ubuntu 20.04 and 22.04 provided above.

To work with the HAL GUI, you will need to set up an XServer. Install VcXsrv and run Xlaunch on your Windows machine. Now go to Ubuntu 20.04 and start HAL with GUI support using the command below. Note that the command assumes the DISPLAY to be at located at localhost:0. This will need adjustment on your machine.

export LIBGL_ALWAYS_INDIRECT=1; export DISPLAY=:0; hal -g

In case you encounter an error, try restarting the XServer and select One Large Window.

CMake Options

Using the CMake build system, your HAL build can be configured quite easily (by adding -D<OPTION>=1 to the cmake command). Here is a selection of the most important options:

  • BUILD_TESTS: builds all available tests which can be executed by running ctest in the build directory. This also builds all tests of plugins that are built.
  • BUILD_DOCUMENTATION: build the C++ and Python documentation
  • PL_<plugin name>: enable (or disable) building a specific plugin
  • BUILD_ALL_PLUGINS: all-in-one option to build all available plugins, overrides the options for individual plugins
  • SANITIZE_ADDRESS, SANITIZE_MEMORY, SANITIZE_THREAD, SANITIZE_UNDEFINED : builds with the respective sanitizers (recommended only for debug builds)

If you do not specify CMAKE_BUILD_TYPE, it defaults to Release.

Clone this wiki locally