Overview

XDP-Firewall/
├── src/                          # 源代码目录
│   ├── common/                   # 公共模块（类型定义、配置）
│   │   ├── all.h                 # 统一包含头文件
│   │   ├── config.h              # 编译期配置（ENABLE_FILTERS 等宏）
│   │   ├── constants.h           # 常量定义
│   │   ├── int_types.h           # 整数类型定义（u8, u16, u32, u64, u128）
│   │   └── types.h               # 核心数据结构（filter_t, stats_t 等）
│   │
│   ├── loader/                   # 主程序加载器（xdpfw）
│   │   ├── prog.c                # 主入口（main函数）
│   │   └── utils/                # 工具函数
│   │       ├── cli.c/h           # 命令行参数解析
│   │       ├── config.c/h        # 配置文件解析（libconfig）
│   │       ├── helpers.c/h       # 辅助函数（IP解析、工具函数）
│   │       ├── logging.c/h       # 日志系统
│   │       ├── stats.c/h         # 统计信息处理
│   │       └── xdp.c/h           # XDP/BPF 操作封装
│   │
│   ├── xdp/                      # XDP BPF程序（内核态）
│   │   ├── prog.c                # XDP程序入口（xdp_prog_main）
│   │   └── utils/                # XDP工具函数
│   │       ├── helpers.c/h       # XDP辅助函数
│   │       ├── logging.c         # XDP日志记录
│   │       ├── maps.h            # BPF Map定义
│   │       ├── rl.c/h            # 速率限制（Rate Limiting）
│   │       ├── rule.c/h          # 过滤规则处理
│   │       └── stats.c/h         # 统计数据更新
│   │
│   ├── rule_add/                 # CLI工具：添加规则（xdpfw-add）
│   │   ├── prog.c                # 入口文件
│   │   └── utils/
│   │       └── cli.c/h           # 命令行解析
│   │
│   └── rule_del/                 # CLI工具：删除规则（xdpfw-del）
│       ├── prog.c                # 入口文件
│       └── utils/
│           └── cli.c/h           # 命令行解析
│
├── modules/                      # 外部依赖（子模块）
│   └── xdp-tools/                # XDP Tools（libxdp + libbpf）
│
├── build/                        # 构建输出目录
│   ├── loader/                   # xdpfw 二进制
│   ├── xdp/                      # xdp_prog.o BPF对象
│   ├── rule_add/                 # xdpfw-add 二进制
│   └── rule_del/                 # xdpfw-del 二进制
│
├── scripts/                      # 构建脚本
│   ├── build.sh
│   ├── clean.sh
│   ├── install.sh
│   ├── libxdp_build.sh
│   ├── libxdp_clean.sh
│   ├── libxdp_install.sh
│   └── objdump.sh
│
├── other/                        # 其他文件
│   └── xdpfw.service             # systemd服务文件
│
├── .github/workflows/            # CI/CD
│   ├── build.yml                 # 构建验证
│   └── run.yml                   # 运行时测试
│
├── Makefile                      # 主构建文件
├── install.sh                    # 安装脚本
├── xdpfw.conf.example            # 配置文件示例
└── README.md                     # 项目文档

main() [loader/prog.c:97]
    ├── parse_cli()           # 解析命令行参数
    ├── load_cfg()            # 加载配置文件（libconfig）
    ├── print_tool_info()     # 打印工具信息
    ├── setrlimit()           # 提升内存限制（需要root）
    ├── load_bpf_obj()        # 加载BPF对象文件（libxdp）
    ├── attach_xdp()          # 附加XDP程序到网卡（DRV/SKB/Offload模式）
    ├── get_map_fd()          # 获取BPF Map文件描述符
    ├── pin_bpf_map()         # 固定Map到文件系统（供CLI工具访问）
    ├── update_filters()      # 更新过滤规则到BPF Map
    └── 主循环：
        ├── calc_stats()      # 计算并显示统计数据
        ├── poll_filters_rb() # 轮询过滤器日志环形缓冲区
        └── 信号处理（SIGINT/SIGTERM）清理资源

xdp_prog_main() [xdp/prog.c:27]
    ├── 解析以太网头部
    ├── 检查协议（IPv4/IPv6）
    ├── 检查IP头部有效性
    ├── 处理TCP/UDP/ICMP协议
    ├── 检查阻止列表（map_block/map_block6）
    ├── 检查IP范围丢弃（map_range_drop）[可选]
    ├── 遍历过滤规则（map_filters）[可选]
    │   ├── 匹配IP、端口、标志等
    │   ├── 速率限制检查（map_rl_ip/map_rl_flow）
    │   └── 执行动作（DROP/ALLOW）
    └── 更新统计数据（map_stats）

map_stats        # 统计数据（per-CPU array）
map_block        # IPv4阻止列表（hash map）
map_block6       # IPv6阻止列表（hash map）
map_filters      # 动态过滤规则（array）
map_range_drop   # IP范围丢弃（LPM trie）
map_rl_ip        # IP速率限制（LRU hash）
map_rl_flow      # 流速率限制（LRU hash）
map_filter_log   # 过滤器日志（ring buffer）