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

kernel-testing — скилл для Claude Code: KUnit, kselftest и syzkaller

Скилл kernel-testing для Claude Code и Codex: тестирование Linux ядра через KUnit для unit-тестов, kselftest для регрессионных проверок, syzkaller для фаззинга и LTP для проверки совместимости syscall.

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

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

Что делает kernel-testing

Охватывает четыре уровня тестирования: KUnit запускает unit-тесты прямо в контексте ядра с макросами вроде KUNIT_EXPECT_EQ; kselftest проверяет поведение syscall и ioctl через userspace код в tools/testing/selftests/; syzkaller фаззит интерфейсы ядра с поддержкой kcov для измерения покрытия; Linux Test Project (LTP) валидирует совместимость на множестве ОС.

В ядре нужно собрать с CONFIG_KUNIT=y и опционально CONFIG_KCOV=y, CONFIG_KASAN=y для больших возможностей отладки. Для syzkaller требуется QEMU VM с настройкой в JSON конфиге и полным путём к скомпилированному образу. KernelCI интегрирует эти тесты в CI/CD пайплайн, проверяя патчи на allmodconfig и загружая результаты.

Скилл содержит примеры: структура KUnit теста с kunit_test_suite, Makefile для kselftest, конфиг syzkaller и полный пайплайн KernelCI. Каждая часть независима — можно писать KUnit тесты без syzkaller, или запускать LTP отдельно для регрессионных проверок.

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

  • написать KUnit тест для функции ядра
  • добавить selftest в tools/testing/selftests/
  • настроить syzkaller с kcov для фаззинга syscall
  • интегрировать тестирование в KernelCI для патчей
  • измерить покрытие кода при выполнении тестов

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

  • Напиши KUnit тест для kmalloc с проверкой на ошибку
  • Помоги собрать и запустить kselftest для syscall open
  • Настрой syzkaller для фаззинга с CONFIG_KASAN и покажи, как воспроизвести крэш

Как установить kernel-testing

1Через Skills CLI (Vercel)

npx skills add mohitmishra786/low-level-dev-skills --skill kernel-testing -a claude-code

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

~/.claude/skills/kernel-testing/SKILL.md

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

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

Вопросы о kernel-testing

Как установить kernel-testing в Claude Code?

Выполни npx skills add mohitmishra786/low-level-dev-skills --skill kernel-testing -a claude-code, затем отредактируй ~/.claude/skills/kernel-testing/SKILL.md. Для других платформ замени флаг: -a codex для Codex, -a cursor для Cursor, -a gemini-cli для Gemini CLI.

Что делает kernel-testing?

Направляет агента при написании unit-тестов на KUnit, регрессионных тестов через kselftest, фаззинге syscall через syzkaller с kcov и интеграции в KernelCI. Покрывает весь спектр тестирования Linux ядра от функций до поведения интерфейсов.

Какой конфиг ядра нужен для KUnit и syzkaller?

Минимум: CONFIG_KUNIT=y для KUnit тестов. Для syzkaller добавь CONFIG_KCOV=y (покрытие), CONFIG_KASAN=y (обнаружение ошибок) и CONFIG_DEBUG_INFO_DWARF5=y для отладки. Используй scripts/config --enable KUNIT KCOV KASAN и пересобери ядро.

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

SKILL.md · MIT
---
name: kernel-testing
description: Linux kernel testing skill for KUnit, kselftest, syzkaller, and LTP. Use when writing KUnit tests, running kselftest harness, configuring syzkaller fuzzing, or integrating KernelCI. Activates on queries about kunit_test_suite, kunit.py, kselftest, syzkaller, kcov, or Linux Test Project.
---

# Kernel Testing

## Purpose

Guide agents through testing the Linux kernel: KUnit in-kernel unit tests, the kselftest harness, syzkaller fuzzing with kcov coverage, Linux Test Project (LTP) syscall regression, and KernelCI integration for continuous testing.

## When to Use

- Writing unit tests for kernel library code or driver helpers
- Adding regression tests to `tools/testing/selftests/`
- Fuzzing syscalls and ioctl interfaces with syzkaller
- Measuring kernel code coverage with kcov
- Running LTP for syscall compatibility validation
- Setting up CI for kernel patches

## Workflow

### 1. KUnit — in-kernel unit tests

```c
// test_example.c
#include <kunit/test.h>

static void example_test(struct kunit *test)
{
    KUNIT_EXPECT_EQ(test, 1 + 1, 2);
    KUNIT_ASSERT_NOT_ERR_OR_NULL(test, kmalloc(16, GFP_KERNEL));
}

static struct kunit_case example_test_cases[] = {
    KUNIT_CASE(example_test),
    {}
};

static struct kunit_suite example_suite = {
    .name = "example",
    .test_cases = example_test_cases,
};
kunit_test_suite(example_suite);

MODULE_LICENSE("GPL");
```

```makefile
# Makefile
obj-$(CONFIG_KUNIT) += test_example.o
```

```bash
# Run KUnit (in-tree)
./tools/testing/kunit/kunit.py run

# Run specific test
./tools/testing/kunit/kunit.py run --filter example

# With cross-compilation
./tools/testing/kunit/kunit.py run --cross_compile aarch64-linux-gnu- \
    --arch arm64
```

KUnit runs in kernel context (UMH or dedicated kunit kernel). Use `kunit_kmalloc` for test allocations.

### 2. kselftest harness

```bash
# Build all selftests
cd tools/testing/selftests
make -j$(nproc)

# Run all
make run_tests

# Run specific test
./memfd/memfd_test
./mount/run_unprivileged_remount.sh
```

Adding a new selftest:

```
tools/testing/selftests/mytest/
├── Makefile
├── mytest.c
└── config        # optional kconfig requirements
```

```makefile
# tools/testing/selftests/mytest/Makefile
CFLAGS += -Wall
TEST_GEN_FILES := mytest
TEST_PROGS := mytest

include ../lib.mk
```

```bash
# Run from top-level
make -C tools/testing/selftests/mytest run_tests
```

### 3. syzkaller fuzzing

```bash
# Install syzkaller
git clone https://github.com/google/syzkaller
cd syzkaller && make

# Manager config (manager.cfg)
{
    "target": "linux/amd64",
    "http": "127.0.0.1:56741",
    "workdir": "/tmp/syzkaller",
    "kernel_obj": "/path/to/kernel/build",
    "syzkaller": "/path/to/syzkaller",
    "procs": 8,
    "type": "qemu",
    "vm": {
        "count": 4,
        "kernel": "/path/to/bzImage",
        "cpu": 2,
        "mem": 2048
    }
}
```

```bash
# Start manager
./bin/syz-manager -config manager.cfg

# Reproduce a crash
./bin/syz-repro -config manager.cfg crash-report.txt
```

Kernel requirements: `CONFIG_KCOV`, `CONFIG_DEBUG_FS`, `CONFIG_KASAN` (recommended).

### 4. kcov — kernel coverage

```bash
# Enable kcov on instrumented kernel
# CONFIG_KCOV=y in kernel config

# syzkaller uses kcov automatically
# Manual coverage via debugfs
ls /sys/kernel/debug/kcov/
```

Coverage guides syzkaller toward unexplored kernel paths.

### 5. Linux Test Project (LTP)

```bash
# Build LTP
git clone https://github.com/linux-test-project/ltp
cd ltp
make autotools
./configure
make -j$(nproc)
make install

# Run syscall tests
cd /opt/ltp
./runltp -f syscalls

# Run specific test
./runltp -f syscalls -s pipe01
```

LTP categories: syscalls, FS, network, IPC, controllers, security.

### 6. KernelCI

```bash
# Local kernel build test (simplified workflow)
# KernelCI tests patches against multiple defconfigs

# Submit build to KernelCI (project-specific tokens)
# See https://kernelci.org/docs/

# Check boot and kselftest results in KernelCI dashboard
```

Typical CI pipeline:

```
Patch → build (allmodconfig) → boot test (QEMU) → kselftest → LTP subset
```

### 7. Testing decision tree

```
What to test?
├── Pure kernel function logic → KUnit
├── Userspace-visible behavior (syscall, ioctl) → kselftest
├── Security/crash finding → syzkaller + KASAN
├── Regression across distros → LTP
└── Upstream patch CI → KernelCI
```

### 8. Debug-friendly test kernel config

```
CONFIG_KUNIT=y
CONFIG_KCOV=y
CONFIG_KASAN=y
CONFIG_DEBUG_INFO_DWARF5=y
CONFIG_FRAME_POINTER=y
CONFIG_FTRACE=y
```

```bash
make kvm_guest.config   # reasonable test config base
scripts/config --enable KUNIT KCOV KASAN
make olddefconfig
```

## Common Problems

| Symptom | Cause | Fix |
|---------|-------|-----|
| KUnit tests not found | CONFIG_KUNIT disabled | Enable in .config; rebuild |
| kselftest SKIP | Missing kernel feature | Check `config` file requirements |
| syzkaller no crashes | Wrong VM config | Verify QEMU boots; check kernel cmdline |
| kcov zero coverage | CONFIG_KCOV off | Rebuild kernel with kcov |
| LTP massive failures | Wrong environment | Run as root; check prerequisites in README |
| kunit.py hangs | UML vs hardware mismatch | Specify `--arch` and cross-compile |

## Related Skills

- `skills/low-level-programming/linux-kernel-modules` — modules under test
- `skills/kernel/device-drivers` — driver logic to unit test
- `skills/kernel/kernel-debugging` — debug failures found by tests
- `skills/runtimes/fuzzing` — userspace fuzzing concepts (libFuzzer)
- `skills/runtimes/sanitizers` — KASAN/KMSAN for kernel
- `skills/virtualization/qemu-kvm` — QEMU for kernel boot testing

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

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

Все скиллы по теме «Тесты и QA» →
testing-handbook-generator trailofbits Скилл testing-handbook-generator собирает скиллы для Claude из страниц Trail of Bits Testing Handbook: разбирает разделы и пишет файлы SKILL.md по шаблонам под каждый тип. CX Codex +1 5 800установок s800-vehicle-network-security-testing reason-machines Скилл s800-vehicle-network-security-testing для Claude Code и других агентов: анализирует и фаззит автомобильные сети CAN, LIN, FlexRay, сканирует ECU — на машинах с разрешением владельца. CX Codex +1 728установок golang-testing affaan-m Скилл golang-testing для Claude Code задаёт агенту шаблоны тестов на Go: табличные кейсы, подтесты, бенчмарки, фаззинг и покрытие. Держит идиоматичный стиль без дополнительных инструкций. CX Codex +1 7 100установок ossfuzz trailofbits Инструктирует агента по подключению репозитория к OSS-Fuzz и запуску фаззинг-тестов на локальной машине через вспомогательные скрипты. CX Codex +1 5 700установок security-fuzzing Eyadkelleh Скилл security-fuzzing подключает подборку пейлоадов из SecLists для поиска инъекций и проверки валидации ввода. Пригодится при аудите защищённости своего кода и на CTF. CX Codex +1 662установок spoof-suite-hardware-identity reason-machines Скилл spoof-suite-hardware-identity для Claude Code и других платформ, который помогает настроить маскировку аппаратных идентификаторов и сетевых отпечатков устройства. Применяется в тестировании безопасности и исследованиях приватности. CX Codex +1 219установок

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

Весь набор →
gpio-baremetal Скилл gpio-baremetal помогает настраивать регистры GPIO, альтернативные функции и прерывания EXTI на микроконтроллерах без библиотек HAL. CX Codex +1 383установок apple-silicon Скилл помогает разработчикам работать с Apple Silicon: настраивать код под единую память, использовать Metal Performance Shaders и Instruments, понимать поведение Rosetta 2 и особенности 16KB страниц. CX Codex +1 383установок code-generation-and-backends Скилл code-generation-and-backends объясняет этапы LLVM-бэкенда: от легализации IR до выдачи ассемблера. Пригодится, чтобы разобраться с llc, TableGen или переносом компилятора на новую архитектуру. CX Codex +1 382установок jit-compilation Скилл jit-compilation для Claude Code учит агента строить JIT-компиляцию с LLVM ORC/LLJIT, Cranelift, инлайн-кэшами, трамплинами и dynasm в Rust. Генерирует код на лету. CX Codex +1 382установок branch-prediction-and-speculation Скилл branch-prediction-and-speculation для Claude Code объясняет предсказание ветвлений и спекулятивное выполнение процессоров, помогая оптимизировать горячие циклы и защищать код от утечек. CX Codex +1 382установок os-dev-scratch Скилл os-dev-scratch для Claude Code помогает собрать минимальную ОС для x86-64: от загрузчика и таблиц страниц до драйверов и переключения контекста. Активируется на вопросах о загрузке ядра, прерываниях и QEMU. CX Codex +1 381установок kernel-security Скилл kernel-security для работы с SELinux, AppArmor, seccomp-bpf, KASLR и аппаратной защитой (CET, PAC). Помогает писать политики безопасности ядра, триировать CVE и настраивать хардение. CX Codex +1 381установок peripherals-from-datasheet Скилл peripherals-from-datasheet помогает писать драйверы микроконтроллеров прямо по документации вендора. Пригодится при bare-metal разработке без готового HAL или переносе периферии между чипами. CX Codex +1 380установок

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

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