| commit | 88cb0ba67d15a5689f6df0f86a67ca6a49efccf5 | [log] [tgz] |
|---|---|---|
| author | Github Action <ubpf@users.noreply.github.com> | Sun Dec 15 19:45:50 2024 +0000 |
| committer | Github Action <ubpf@users.noreply.github.com> | Sun Dec 15 19:45:50 2024 +0000 |
| tree | f349e748e43efb8d61b9dc266756a827f4188ed3 | |
| parent | e7d66d59777056afde2109b08f9b792432a6d841 [diff] |
Updated documentation Signed-off-by: Github Action <ubpf@users.noreply.github.com>
Userspace eBPF VM
This project aims to create an Apache-licensed library for executing eBPF programs. The primary implementation of eBPF lives in the Linux kernel, but due to its GPL license it can't be used in many projects.
Linux documentation for the eBPF instruction set
This project includes an eBPF assembler, disassembler, interpreter (for all platforms), and JIT compiler (for x86-64 and Arm64 targets).
Note: This works on Windows, Linux, and MacOS, provided the prerequisites are installed.
cmake -S . -B build -DUBPF_ENABLE_TESTS=true cmake --build build --config Debug
cmake --build build --target test --
ctest --test-dir build
Run make -C vm to build the VM. This produces a static library libubpf.a and a simple executable used by the testsuite. After building the library you can install using make -C vm install via either root or sudo.
To run the tests, you first need to build the vm code then use nosetests to execute the tests. Note: The tests have some dependencies that need to be present. See the .travis.yml for details.
sudo apt-get update sudo apt-get -y install python python-pip python-setuptools python-wheel python-nose python2 -m pip install --upgrade "pip<21.0" python2 -m pip install -r requirements.txt python2 -m pip install cpp-coveralls
make -C vm COVERAGE=1 nosetests -v # run tests
coveralls --gcov-options '\-lp' -i $PWD/vm/ubpf_vm.c -i $PWD/vm/ubpf_jit_x86_64.c -i $PWD/vm/ubpf_loader.c
You'll need Clang 3.7.
clang-3.7 -O2 -target bpf -c prog.c -o prog.o
You can then pass the contents of prog.o to ubpf_load_elf, or to the stdin of the vm/test binary.
Please fork the project on GitHub and open a pull request. You can run all the tests with nosetests.
Copyright 2015, Big Switch Networks, Inc. Licensed under the Apache License, Version 2.0 <LICENSE.txt or http://www.apache.org/licenses/LICENSE-2.0>.
