Boflink

Linker for Beacon Object Files.

• Installation
• Usage
• Examples

Installation

Requires: Rust >=1.91.0

rustc --version

From Source

git clone https://github.com/MEhrn00/boflink.git
cd boflink
cargo xtask install

# For an LTO build
cargo xtask install -p release-lto

Usage

Standalone

boflink [-o <output>] [options] <files>...
boflink -o mybof.bof -L/path/to/windows/libs -lkernel32 -ladvapi32 source.c object.o

Using MinGW GCC on Linux

MinGW GCC can be used to invoke boflink through a GCC spec file.

boflink --print-gcc-specs > boflink.specs
x86_64-w64-mingw32-gcc -specs=boflink.specs <args>...
x86_64-w64-mingw32-gcc -specs=boflink.specs -o mybof.bof source.c object.o

Using Clang on Linux

Clang can be used to invoke boflink by passing --ld-path with the full path to the executable.

clang --ld-path=/path/to/boflink --target=x86_64-windows-gnu -nostartfiles <args>...
clang --ld-path=/path/to/boflink --target=x86_64-windows-gnu -nostartfiles -o mybof.bof source.c object.o

Using MSVC on Windows

Windows requires running boflink inside a Visual Studio Developer Console.

boflink <args>...
boflink -o mybof.bof object1.o object2.o -lkernel32 -ladvapi32

Examples

Additional examples can be found in the examples/ directory.

Blog Post

https://blog.cybershenanigans.space/posts/boflink-a-linker-for-beacon-object-files/