Skip to content

Repository files navigation

Note

bpfvv is not being actively developed and is in maintenance mode. It's been a fun and useful experiment when it was created. However the relevance of this tool is now questionable as BPF enters the agentic era, and everyone is figuring out how to navigate it. That said, if you are using the app and notice usability-breaking bugs, don't hesitate to report them and tag the maintainers.

CI

bpfvv stands for BPF Verifier Visualizer

https://libbpf.github.io/bpfvv/

BPF Verifier Visualizer is a tool to analyze Linux Kernel BPF verifier logs.

The goal of bpfvv is to help BPF programmers debug verification failures.

The user can load a text file, and the app will attempt to parse it as a verifier log. Successfully parsed lines produce a state which is then visualized in the UI. You can think of this as a primitive debugger UI, except it interprets a log and not a runtime state of a program.

For more information on how to use bpfvv see the HOWTO.md

Development

  • Fork the website repo: https://github.com/libbpf/bpfvv.git

  • Clone your fork:

    • git clone https://github.com/<username>/bpfvv.git
  • Setup node modules:

    • npm install
  • Develop the app:

    • npm start
  • Build the app for static testing:

    • npm run build
  • Serve the statically built app:

    • npm run serve
  • Format your code:

    • npm run format
  • To run lint, typecheck, and tests:

    • npm run check
  • If everything is OK, push your branch, create a PR.


This is a self-contained web app that runs entirely on the client side. There is no backend server. Once loaded, it operates within the browser.

About

A tool to help programmers debug and analyze Linux Kernel BPF verification failures.

Topics

Resources

Stars

94 stars

Watchers

4 watching

Forks

Releases

Packages

Used by

Contributors

Languages