C and C++ bindings for SCION's primary application API snet. The bindings build against the dispatcher removal PR.
CMake build options:
GO_BINARYPath to the go executable.BUILD_STATIC_LIBSBuild a static library.BUILD_SHARED_LIBSBuild a shared/dynamic library and link examples against it instead of statically linking SNET.BUILD_EXAMPLESBuild examples programs.
Release:
mkdir -p build/release
cmake -D CMAKE_BUILD_TYPE=Release -D BUILD_STATIC_LIBS=ON -B build/release
cmake --build build/releaseDebug:
mkdir -p build/debug
cmake -D CMAKE_BUILD_TYPE=Debug -D BUILD_STATIC_LIBS=ON -B build/debug
cmake --build build/debugInstall MSYS2 and Go. The following MSYS2 packets are required:
pacman -Sy
pacman -S \
mingw-w64-ucrt-x86_64-gcc \
mingw-w64-ucrt-x86_64-cmake \
mingw-w64-ucrt-x86_64-ninja \
mingw-w64-ucrt-x86_64-asio \
mingw-w64-ucrt-x86_64-doctestOpen an MSYS2 UCRT64 environment and navigate to the project root (Windows drive
letters are available as /c and so on).
mkdir build
cmake -D BUILD_STATIC_LIBS=ON -D GO_BINARY="$PROGRAMFILES/Go/bin/go.exe" -G 'Ninja Multi-Config' -B build
# Release:
cmake --build build --config Release
# Debug:
cmake --build build --config DebugSome tests can be run by invoking the "test" target in make or ninja.
The examples directory contains simple echo servers/clients demonstrating both
synchronous and asynchronous IO.
Usage example (assuming the tiny4.topo topology from the SCION repository):
# Synchronous API
# Server
snet-echo -sciond 127.0.0.19:30255 -local 127.0.0.1:5000
# Client
snet-echo -sciond 127.0.0.27:30255 -local 127.0.0.1:5001 -remote [1-ff00:0:111,127.0.0.1]:5000
# Asynchronous API
# Server
snet-echo-async -sciond 127.0.0.19:30255 -local 127.0.0.1:5000
# Client
snet-echo-async -sciond 127.0.0.27:30255 -local 127.0.0.1:5001 -remote [1-ff00:0:111,127.0.0.1]:5000