Squashed 'vendor/ruvector/' content from commit b64c2172

git-subtree-dir: vendor/ruvector
git-subtree-split: b64c21726f2bb37286d9ee36a7869fef60cc6900

crates/rvf/rvf-ebpf/README.md

@@ -0,0 +1,57 @@
+# rvf-ebpf
+
+Real eBPF program compiler and embedder for RVF cognitive containers.
+
+## What It Does
+
+`rvf-ebpf` compiles real BPF C programs with `clang` and embeds them into `.rvf` files as `EBPF_SEG` segments. These programs provide kernel-level acceleration for vector operations.
+
+## Included Programs
+
+| Program | Type | Description |
+|---------|------|-------------|
+| `xdp_distance.c` | XDP | L2 vector distance computation with LRU vector cache using BPF maps |
+| `socket_filter.c` | Socket Filter | Port-based allow-list access control with per-CPU counters |
+| `tc_query_route.c` | TC Classifier | Query priority routing (hot/warm/cold traffic classes) |
+
+## Usage
+
+```rust
+use rvf_ebpf::{EbpfCompiler, programs};
+
+// Access real BPF C source
+println!("{}", programs::XDP_DISTANCE);
+println!("{}", programs::SOCKET_FILTER);
+println!("{}", programs::TC_QUERY_ROUTE);
+
+// Compile with clang (requires clang installed)
+let compiler = EbpfCompiler::new()?;
+let program = compiler.compile_source(
+    programs::SOCKET_FILTER,
+    EbpfProgramType::SocketFilter,
+)?;
+
+// Embed compiled ELF into RVF
+store.embed_ebpf(
+    program.program_type as u8,
+    program.attach_type as u8,
+    1536,
+    &program.elf_bytes,
+    program.btf_bytes.as_deref(),
+)?;
+```
+
+## Requirements
+
+- `clang` with BPF target support (for compilation)
+- Programs can also be pre-compiled and embedded as raw ELF bytes
+
+## Tests
+
+```bash
+cargo test -p rvf-ebpf  # 17 tests
+```
+
+## License
+
+MIT OR Apache-2.0