You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: AGENTS.md
+18-7Lines changed: 18 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -7,6 +7,24 @@ This repository is a Rust workspace for a network flow extractor. The main crate
7
7
-`xtask`: helper commands for building and running the project
8
8
-`ebpf-ipv4` / `ebpf-ipv6`: Linux eBPF programs used for realtime capture
9
9
10
+
## Platform Notes
11
+
12
+
- Realtime eBPF support is Linux-specific.
13
+
- Linux is the source of truth for build, runtime, and performance validation.
14
+
- Do not assume that successful non-Linux builds imply realtime correctness.
15
+
- When touching `aya`/eBPF/realtime code, prefer validating on Linux.
16
+
17
+
## Local Test Network
18
+
19
+
- The primary dedicated software-path test setup is local to `rgbcore`.
20
+
- A persistent veth pair is available for RustiFlow testing:
21
+
- host namespace capture side: `rustiflow-t0`
22
+
- peer namespace side: `rustiflow-p0`
23
+
- peer namespace: `rustiflow-peer`
24
+
- addressing: `10.203.0.1/30` on `rustiflow-t0`, `10.203.0.2/30` on `rustiflow-p0`
25
+
- This setup is intended to stress the RustiFlow software path without depending on the physical LAN.
26
+
- Treat it as a high-throughput local test harness, not as a substitute for true physical wire-rate validation.
27
+
10
28
## Remote Machine Guardrails
11
29
12
30
- Remote Linux machines reachable over SSH may be used only for this RustiFlow project.
@@ -61,13 +79,6 @@ This repository is a Rust workspace for a network flow extractor. The main crate
61
79
- one exporter only
62
80
- If you change contamination-free exports, keep in mind that these outputs intentionally avoid raw identifiers such as exact ports/IPs.
63
81
64
-
## Platform Notes
65
-
66
-
- Realtime eBPF support is Linux-specific.
67
-
- macOS may be usable for some read-only work, formatting, and limited code inspection, but Linux is the source of truth for full build and runtime validation.
68
-
- Do not assume that successful macOS builds imply realtime correctness.
69
-
- When touching `aya`/eBPF/realtime code, prefer validating on Linux or in a Linux container/VM.
0 commit comments