Home

JNetRuntime BPF Compiler

Welcome to the JNetRuntime BPF Compiler module documentation. This module provides a flexible and extensible compilation framework for transforming network filter expressions into Berkeley Packet Filter (BPF) bytecode.

🚀 Key Features

• Multi-Dialect Support

  • TCPDump/PCAP filter syntax
  • Wireshark display filter expressions
  • Napatech NTPL filter language

• Standard BPF Compatibility

  • Generates bytecode compatible with kernel BPF
  • Works with JNetRuntime BPF VM
  • Compatible with traditional BPF interpreters

• High Performance

  • Optimized compilation process
  • Efficient bytecode generation
  • Multiple optimization levels

🎯 Purpose

The BPF Compiler module serves as a bridge between human-readable filter expressions and efficient machine-executable BPF bytecode. It enables:

1. Network Traffic Filtering

   • Packet capture and analysis
   • Network monitoring
   • Protocol-specific filtering

2. Cross-Platform Compatibility

   • Works on any Java-supported platform
   • Kernel BPF integration when available
   • Pure Java fallback with BPF VM

3. Tool Integration

   • Compatible with existing network tools
   • Support for industry-standard syntaxes
   • Extensible for custom requirements

🔧 Quick Start

// Choose your preferred dialect
BpfCompiler compiler = BpfCompiler.forDialect(FilterDialect.PCAP);

// Compile a filter expression
byte[] bytecode = compiler.compile("tcp port 80");

// Use with JNetRuntime BPF VM
BPFProgram program = BPFProgram.load(bytecode);
boolean matches = program.execute(packet);

📚 Documentation

• PCAP Filter Grammar
• Wireshark Filter Grammar
• NTPL Filter Grammar
• Compiler Usage Guide
• API Reference

🔄 Integration

The compiler module works seamlessly with other JNetRuntime components:

[Filter Expression]
        ↓
[BPF Compiler Module]
        ↓
   [BPF Bytecode]
        ↓
  ┌─────┴─────┐
[BPF VM]  [Kernel BPF]

🛠️ Next Steps

• Getting Started Guide
• Tutorial
• Examples
• Contributing

📮 Support

• GitHub Issues
• Discussions
• Mailing List

---

Check out our API Documentation for detailed information about using the compiler.

Have questions? Join our Community Discussion!