ausimian

ausimian

I just pushed a library called BPF that converts binary pattern matching expressions into (classic) BPF (Berkeley Packet Filter) programs that you can use with SO_ATTACHFILTER or libpcap. There’s also an interpreter that allows you to test your programs against binaries.

BPF programs are essentially predicates on packets that run in the kernel and are usually used to filter traffic efficiently for programs like tcpdump etc, They are described using a Turing-incomplete instruction set.

I intend to add some integration tests using Tundra shortly.

Features

  • Elixir syntax - Write filters using binary pattern matching and guards
  • Multi-clause support - Multiple patterns with fallthrough semantics
  • Guard expressions - Comparisons, logical operators, bitwise operations, arithmetic
  • Packet length filtering - Use byte_size(packet) to filter by packet size
  • SSA-based compiler - Optimized code generation with register allocation

Package
Docs

https://github.com/ausimian/bpf

Showing Posts 1 to 6

Asd

Asd

Very cool! Do you have any example setup for how to call libpcap with it?

ausimian

ausimian OP

Not currently.

If you specifically want libpcap integration (i.e. take a dependency on libpcap.so/dylib at runtime). You could write a NIF that takes the interface and the assembled bytes and does something like:

// validation / error handling elided
ErlNifBinary prog;
enif_inspect_binary(env, argv[1], &prog)

struct bpf_program fp;
fp.bf_len = prog.size >> 3; // instructions, not bytes, so divide by 8
fp.bf_insns = (struct bpf_insn *)prog.data
pcap_setfilter(handle, &fp);

If i was doing this, i’d use pcap_get_selectable_fd and then integrate it with enif_select_read to avoid any blocking issues and play nicely with the scheduler (or stick the pcap loop on a thread, and mark it as a dirty nif, but i prefer to not manage threads in my NIFs)

If you’re (only) on Linux you can skip most of this and set it all up through the erlang :socket module directly using raw sockets at the link or ip layer depending on your use case. Unfortunately, you still need a (tiny) NIF to handle setting the SO_ATTACH_FILTER options as the C struct it takes is not describable in Erlang (it contains pointers)

On the elixir side:

{:ok, filter} = BPF.assemble(prog)
{:ok, fd} = :socket.get_opt(sock, {:otp, :fd})
:ok = Nif.attach_filter(fd, filter)

On the C side:

int fd;
enif_get_int(env, argv[0], &fd);
ErlNifBinary prog;
enif_inspect_binary(env, argv[1], &prog)

struct sock_sock_fprog bpf = {
    .len = prog.size >>> 3;
    .filter = (struct sock_filter*)prog.data;
};
setsockopt(fd, SOL_SOCKET, SO_ATTACH_FILTER, &bpf, sizeof(bpf));

You can then read the sock on the elixir side.

(None of the above code is tested, I’m winging it)

Asd

Asd

Gotcha, so it generates a struct sock_filter, I see, thanks. I will try to play with it then. Again, looks very interesting

ausimian

ausimian OP

I just did it anyway. I haven’t published a package for it yet, but I probably will.

https://github.com/ausimian/peacap

ausimian

ausimian OP

I published it. I’ve tested it on macos and linux, but i haven’t stressed it.

Asd

Asd

D:

That’s very nice. I can finally play with covert channels in Elixir. I think this library deserves a separate topic!

— All posts loaded —

Where Next? Top

Trending in Announcing Top

type1fool
WebAuthnLiveComponent WebAuthnComponents See this post about renaming the package. Passwordless authentication for Phoenix LiveView app...
New
GenericJam
Edit: 2026 May 15 - This post is archived. Mob is alive!! Main docs: mob v0.7.11 — Documentation A bit of explanation for the slightly c...
New
woylie
I released Doggo, a collection of unstyled Phoenix components. https://github.com/woylie/doggo Features Unstyled Phoenix components....
New
JesseHerrick
Hey, I’m Jesse and I’m the main contributor behind Dexter, a full-featured, lightning-fast Elixir LSP optimized for large codebases. It s...
New
ahamez
Hi everyone, I’ve been working on this protobuf library for 3 years. We use it in the company I work for, EasyMile, to communicate with ...
New
garrison
Hobbes is a low-level distributed database for the Elixir programming language. Hobbes provides a simple, safe, and scalable storage lay...
New
kip
I’ll shortly be launching Text, a nascent text analysis library. Current functionality In this early version (not ready for prime time) ...
New

Other Trending Topics Top

mudasobwa
I am happy to introduce the very α version of the new programming language compiled to BEAM. Welcome Cure. It has literally three kille...
New
mhanberg
Hi everyone! The first release candidate for the Expert language server project is now available! We’ve published a press release detai...
New
budgie
A little off-topic, but I feel like people here have a good head on their shoulders. I used to be quite good at making software. Was luc...
New
webofbits
With AI doing more of the implementation work, I’ve been wondering how much coding I should deliberately keep doing myself. My main conc...
#ai
New
bartblast
Hey folks, I just published a post about Hologram’s funding and where the project goes next - the short version: Curiosum as Main Spons...
New
budgie
I love Elixir. It’s one of 2 programming languages I’ve ever fallen in love with. But I don’t use it anymore. Serverless was the promis...
New

We're in Beta

About us Mission Statement

Options

Thread Display Mode




Thread Preview

Skip Thread Previews