К основному содержанию
скилл CX Codex

af-xdp — скилл для Claude Code: что делает и как установить

Настраивает сокеты AF_XDP и память UMEM для скоростной обработки сетевых пакетов в userspace. Пригодится при написании фильтров трафика и балансировщиков.

MIT 359 установок ★ 298 обновлён 2026-06-27

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add mohitmishra786/low-level-dev-skills --skill af-xdp -a claude-code
Открыть на GitHub

Что делает af-xdp

Скилл обучает агента разворачивать сетевой стек на сокетах AF_XDP через библиотеку libbpf. В инструкции разобраны этапы выделения памяти под буфер UMEM, инициализация колец RX, TX, fill и completion, а также привязка через xsk_socket__create. Отдельное внимание уделено eBPF-программе перенаправления с вызовом bpf_redirect_map и таблицей BPF_MAP_TYPE_XSKMAP.

Также материал сопоставляет режимы XDP_COPY и XDP_ZEROCOPY. Без поддержки драйвера сетевой карты (например, в i40e или mlx5) сокет автоматически свалится в копирование, а без прав CAP_NET_RAW ядро отклонит создание сокета. В подсказках описана защита от переполнения: если вовремя не отдавать буферы обратно в fill ring, ядро начнёт сбрасывать входящие пакеты.

Какие задачи решает

  • Настроить память UMEM и кольцевые буферы для сокета AF_XDP
  • Написать eBPF-программу перенаправления сетевого трафика через XDP_REDIRECT
  • Организовать цикл обработки входящих пакетов в userspace с возвратом буферов в fill ring
  • Устранить ошибки создания сокетов вроде EBUSY и падения в режим copy

Примеры запросов агенту

  • Напиши код инициализации сокета AF_XDP и буфера UMEM на C с использованием libbpf
  • Создай XDP-фильтр с bpf_redirect_map для перенаправления очереди eth0 в xsk
  • Разбери, почему при вызове xsk_socket__create возникает ошибка EBUSY

Как установить af-xdp

1Через Skills CLI (Vercel)

npx skills add mohitmishra786/low-level-dev-skills --skill af-xdp -a claude-code

2Вручную: положить файлы

~/.claude/skills/af-xdp/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/af-xdp/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы об af-xdp

Как установить af-xdp в Claude Code?

Выполните команду npx skills add mohitmishra786/low-level-dev-skills --skill af-xdp -a claude-code. Файл инструкции сохранится по пути ~/.claude/skills/af-xdp/SKILL.md.

Чем AF_XDP отличается от классического DPDK?

AF_XDP не требует полного обхода ядра через vfio или hugepages и сохраняет управление сетевым интерфейсом в Linux. Фильтрацию выполняет драйвер через XDP, передавая в userspace только нужные пакеты.

Что делать, если сокет сбрасывает входящие пакеты в RX?

Проверьте наполнение кольца fill ring. Если пользовательский процесс не пополняет его пустыми адресами фреймов через xsk_ring_prod__submit, ядру некуда записывать новые пакеты.

Исходный текст

SKILL.md · MIT
---
name: af-xdp
description: AF_XDP skill for high-performance XDP sockets. Use when creating AF_XDP sockets, configuring UMEM and XSK rings, XDP_REDIRECT programs, copy vs zero-copy mode, or comparing with DPDK. Activates on queries about AF_XDP, xsk_umem, XDP_REDIRECT, libbpf xsk, or zero-copy XDP.
---

# AF_XDP

## Purpose

Guide agents through AF_XDP sockets for high-performance packet I/O: socket creation, UMEM setup, fill/completion/RX/TX rings, XDP programs with `XDP_REDIRECT` to XSK, copy vs zero-copy modes, libbpf helpers, performance comparison with DPDK, and production use cases.

## When to Use

- Building a userspace packet processor with lower overhead than raw sockets
- Redirecting XDP-filtered traffic to userspace without DPDK complexity
- Implementing a custom load balancer or IDS dataplane
- Comparing zero-copy vs copy mode on your NIC/driver
- Integrating with existing libbpf/XDP infrastructure
- Need kernel cooperation (firewall rules) plus userspace processing

## Workflow

### 1. Architecture overview

```
NIC → XDP program (BPF) → XDP_REDIRECT → AF_XDP socket → userspace
                ↓
           XDP_DROP/PASS/TX
```

Components:
- **UMEM** — shared memory region for frames
- **Fill ring** — userspace provides empty frame addresses to kernel
- **Completion ring** — kernel returns completed TX frames
- **RX ring** — kernel delivers received packets
- **TX ring** — userspace submits packets for transmission

### 2. UMEM and XSK socket creation

```c
#include <bpf/xsk.h>
#include <bpf/libbpf.h>
#include <xdp/xsk.h>

#define NUM_FRAMES     4096
#define FRAME_SIZE     XSK_UMEM__DEFAULT_FRAME_SIZE
#define RX_BATCH_SIZE  64

struct xsk_umem_info {
    struct xsk_ring_prod fill;
    struct xsk_ring_cons comp;
    struct xsk_umem *umem;
    void *buffer;
};

struct xsk_socket_info {
    struct xsk_ring_cons rx;
    struct xsk_ring_prod tx;
    struct xsk_socket *xsk;
};

int xsk_setup(struct xsk_umem_info *umem_info,
              struct xsk_socket_info *xsk_info,
              int ifindex, int queue_id, int xsk_flags)
{
    umem_info->buffer = mmap(NULL, NUM_FRAMES * FRAME_SIZE,
        PROT_READ | PROT_WRITE, MAP_PRIVATE | MAP_ANONYMOUS, -1, 0);

    struct xsk_umem_config umem_cfg = {
        .fill_size = XSK_RING_PROD__DEFAULT_NUM_DESCS,
        .comp_size = XSK_RING_CONS__DEFAULT_NUM_DESCS,
        .frame_size = FRAME_SIZE,
        .frame_headroom = XSK_UMEM__DEFAULT_FRAME_HEADROOM,
        .flags = 0,
    };

    int ret = xsk_umem__create(&umem_info->umem, umem_info->buffer,
        NUM_FRAMES * FRAME_SIZE, &umem_info->fill, &umem_info->comp,
        &umem_cfg);
    if (ret)
        return ret;

    struct xsk_socket_config xsk_cfg = {
        .rx_size = XSK_RING_CONS__DEFAULT_NUM_DESCS,
        .tx_size = XSK_RING_PROD__DEFAULT_NUM_DESCS,
        .libbpf_flags = XSK_LIBBPF_FLAGS__INHIBIT_PROG_LOAD,
        .xdp_flags = XDP_FLAGS_UPDATE_IF_NOEXIST,
        .bind_flags = xsk_flags,  // XDP_ZEROCOPY or XDP_COPY
    };

    return xsk_socket__create(&xsk_info->xsk, "eth0", queue_id,
        umem_info->umem, &xsk_info->rx, &xsk_info->tx, &xsk_cfg);
}
```

### 3. Populate fill ring

```c
void populate_fill_ring(struct xsk_umem_info *umem) {
    uint32_t idx;
    uint32_t ret = xsk_ring_prod__reserve(&umem->fill, RX_BATCH_SIZE, &idx);
    for (uint32_t i = 0; i < ret; i++)
        *xsk_ring_prod__fill_addr(&umem->fill, idx + i) = i * FRAME_SIZE;
    xsk_ring_prod__submit(&umem->fill, ret);
}
```

Must keep fill ring stocked — kernel drops packets if no buffers available.

### 4. XDP redirect program

```c
// xdp_redirect.c
#include <linux/bpf.h>
#include <bpf/bpf_helpers.h>

struct {
    __uint(type, BPF_MAP_TYPE_XSKMAP);
    __uint(max_entries, 64);
    __type(key, int);
    __type(value, int);
} xsks_map SEC(".maps");

SEC("xdp")
int xdp_redirect_prog(struct xdp_md *ctx)
{
    int index = ctx->rx_queue_index;
    return bpf_redirect_map(&xsks_map, index, 0);
}
```

```bash
# Load and attach
bpftool prog load xdp_redirect.o /sys/fs/bpf/xdp_redirect
ip link set dev eth0 xdp obj xdp_redirect.o sec xdp

# Pin xsks_map and update with socket fd
```

### 5. RX processing loop

```c
while (running) {
    uint32_t idx_rx = 0, rcvd;
    rcvd = xsk_ring_cons__peek(&xsk_info->rx, RX_BATCH_SIZE, &idx_rx);
    if (!rcvd)
        continue;

    for (uint32_t i = 0; i < rcvd; i++) {
        const struct xdp_desc *desc = xsk_ring_cons__rx_desc(&xsk_info->rx, idx_rx + i);
        uint64_t addr = desc->addr;
        uint32_t len = desc->len;
        uint8_t *pkt = (uint8_t *)xsk_umem__get_data(umem_info->buffer, addr);
        process_packet(pkt, len);
    }
    xsk_ring_cons__release(&xsk_info->rx, rcvd);

    // Return frames to fill ring
    refill_fill_ring(umem_info, rcvd);
}
```

### 6. Copy vs zero-copy

| Mode | Flag | Requirements |
|------|------|--------------|
| Copy | `XDP_COPY` (default) | Any driver; kernel copies to UMEM |
| Zero-copy | `XDP_ZEROCOPY` | Driver support (i40e, ixgbe, mlx5, etc.) |

```bash
# Check driver ZC support
ethtool -i eth0
# Kernel log on bind:
dmesg | grep xsk
# "Zero-copy enabled" or "Copy mode"
```

Zero-copy: NIC DMAs directly into UMEM frames — lowest latency. Copy mode: safer, universal.

### 7. libbpf xsk.h helpers

```bash
# Modern libbpf includes xsk API
pkg-config --libs libbpf
# -lbpf -lxdp (if separate libxdp installed)
```

Key functions:
- `xsk_umem__create` / `xsk_umem__delete`
- `xsk_socket__create` / `xsk_socket__delete`
- `xsk_umem__get_data` — pointer from frame address
- `xsk_socket__fd` — for epoll/poll integration

### 8. Performance vs DPDK

| Factor | AF_XDP | DPDK |
|--------|--------|------|
| Setup complexity | Moderate | High (hugepages, EAL) |
| Kernel integration | XDP filter in kernel | Full bypass |
| Typical throughput | Near-DPDK with ZC | Highest |
| NIC binding | Stays on kernel driver | vfio/uio binding |
| Use case fit | Filter + selective userspace | Full dataplane takeover |

### 9. Production patterns

```
Common deployments
├── CDN edge cache — XDP_DROP junk, redirect cacheable to XSK
├── DDoS mitigation — XDP_DROP attack patterns
├── Load balancer — XDP_TX hairpin or redirect to backend XSK
└── Observability — mirror subset to XSK for analysis
```

```bash
# Multi-queue: one XSK per RX queue, pinned to CPU
taskset -c 2 ./xsk_app --queue 2
```

## Common Problems

| Symptom | Cause | Fix |
|---------|-------|-----|
| No packets in RX ring | XDP program not redirecting | Verify xsks_map entry for queue index |
| `EBUSY` on socket create | XDP already attached | `ip link set dev eth0 xdp off` first |
| Zero-copy fallback to copy | Driver lacks ZC | Check dmesg; use supported NIC |
| Packet drops | Fill ring empty | Aggressive refill; increase NUM_FRAMES |
| TX not working | Completion ring not polled | Process comp ring to recycle frames |
| Permission denied | CAP_NET_RAW needed | Run with appropriate capabilities |

## Related Skills

- `skills/observability/ebpf` — XDP/BPF program development
- `skills/async-io/dpdk` — full kernel bypass alternative
- `skills/async-io/io-uring` — async I/O for non-packet workloads
- `skills/observability/ebpf-rust` — Aya for XDP in Rust
- `skills/profilers/linux-perf` — profile XDP program CPU usage
- `skills/allocators/numa-programming` — NUMA-local UMEM allocation

© mohitmishra786 · MIT · mohitmishra786/low-level-dev-skills

Похожие скиллы

Все скиллы по теме «Бэкенд и API» →
google-cloud-global-frontend-configuration официальный google Скилл google-cloud-global-frontend-configuration помогает спроектировать и развернуть глобальный внешний Application Load Balancer в Google Cloud. Подходит для CDN, WAF и Service Extensions. CX Codex +1 5 300установок telecommunications-expert personamanagmentlayer Скилл telecommunications-expert для Claude Code, который добавляет агенту экспертизу в телеком-инфраструктуре: OSS/BSS, 5G, SDN/NFV, протоколы и тарификация. Помогает проектировать системы и рассчитывать биллинг. CX Codex +1 1 900установок omada-controller jakeasmith Скилл omada-controller для Claude Code, Codex, Cursor, Copilot и других агентов, который подключается к TP-Link Omada SDN Controller через Open API. CX Codex +1 880установок debugging-network-issues daymade Скилл debugging-network-issues для Claude Code структурирует диагностику сетевых сбоев, обрывов потоков и протокольных ошибок по уровням. Исключает ложные догадки при зависаниях SSE или таймаутах. CX Codex +1 740установок temporal-cloud temporalio Скилл помогает находить и устранять сбои подключения к Temporal Cloud: ошибки TLS, неверные эндпоинты, проблемы с tcld и авторизацией. CX Codex +1 619установок render-networking Render Скилл render-networking для Claude Code, Codex, Cursor и других платформ: настраивает межсервисное взаимодействие через приватную сеть Render. CX Codex +1 427установок

Из того же набора140

Весь набор →
hypervisor-internals Скилл hypervisor-internals для Claude Code объясняет аппаратную виртуализацию Intel VT-x и AMD-V: VMCS, VMCB, EPT/NPT и обработку VMEXIT. Описывает основы создания минимального гипервизора. CX Codex +1 365установок hip-rocm Скилл hip-rocm для Claude Code помогает писать HIP-ядра и переносить CUDA-код на AMD GPU. Он включается при запросах о HIP, ROCm, HIPIFY и профилировании. CX Codex +1 364установок io-uring Скилл для работы с io_uring — новым API асинхронного ввода-вывода Linux. Пригодится при разработке высоконагруженных серверов, если нужно снизить количество системных вызовов и использовать передачу данных без копирования. CX Codex +1 361установок arm-sve Скилл arm-sve для работы со Scalable Vector Extension — расширением SIMD на процессорах ARM. Помогает писать код, который адаптируется к разной длине векторов на Graviton, Apple M4 и других AArch64 серверах. CX Codex +1 361установок triton-lang Скилл triton-lang учит агента писать GPU-ядра на Triton: @triton.jit, блочные tl.load/tl.store с масками, атомарные операции, автотюнинг и интеграцию в PyTorch. CX Codex +1 358установок containers-internals Скилл containers-internals для Claude Code по устройству Linux-контейнеров: намспейсы, cgroups v2, overlayfs, runc, seccomp и защита от escape. CX Codex +1 358установок rdma-verbs Скилл rdma-verbs для Claude Code — справочник по RDMA-программированию через libibverbs для InfiniBand и RoCE; в нём описаны настройка очередей, односторонняя запись и тесты perftest. CX Codex +1 356установок riscv-privileged Скилл riscv-privileged для разработки ядер и прошивок на RISC-V: работа с привилегированной архитектурой, режимами машины и супервизора, CSR регистрами, обработчиками ловушек, контроллерами PLIC и CLINT, OpenSBI. CX Codex +1 355установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой