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

kernel-concurrency — скилл для Linux: синхронизация и блокировки

Скилл kernel-concurrency помогает выбрать правильный примитив синхронизации в ядре Linux: spinlock, mutex, RCU, seqlock или completion.

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

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

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

Ядро Linux требует точного выбора синхронизации: spinlock не может спать, mutex работает только в контексте, где спать можно, RCU экономит на блокировке для read-mostly данных. Скилл даёт дерево решений для выбора — сначала проверяешь, может ли текущий контекст спать, потом решаешь, нужна ли писателям эксклюзивность или читатели могут идти параллельно.

Внутри — готовые паттерны кода: spin_lock_irqsave() с флагами для IRQ, rcu_read_lock() / rcu_assign_pointer() для массивов и списков, seqlock для счётчиков типа jiffies, completion для одноразовых сигналов. Таблица диагностики связывает ошибки вроде «scheduling while atomic» с причиной (спал под spinlock) и решением (переключиться на GFP_ATOMIC или отложить работу).

Без правильной синхронизации код либо зависает в deadlock, либо портит данные race condition. Скилл помогает избежать обеих ошибок, дав чёткий путь от задачи к коду.

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

  • выбрать между spinlock и mutex для защиты общих данных
  • защитить ring buffer между IRQ-обработчиком и syscall
  • использовать RCU для read-mostly структур данных
  • применить memory barrier для порядка операций
  • отладить ошибку «scheduling while atomic»

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

  • Защити общий ring buffer между IRQ и read() syscall
  • Выбери примитив синхронизации для data структуры, 90% операций — чтение
  • Почему код падает на scheduling while atomic в probe?

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

1Через Skills CLI (Vercel)

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

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

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

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

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

Вопросы о kernel-concurrency

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

Запусти npx skills add mohitmishra786/low-level-dev-skills --skill kernel-concurrency -a claude-code, потом скилл найдёшь в ~/.claude/skills/kernel-concurrency/SKILL.md.

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

Помогает выбрать правильный примитив синхронизации (spinlock, mutex, RCU, seqlock, completion) в зависимости от контекста — IRQ, процесс, read-mostly данные. Даёт паттерны кода и таблицу диагностики ошибок.

Когда spinlock, а когда mutex?

Spinlock — когда контекст не может спать (IRQ, spinlock уже держишь, preemption отключён). Mutex — в контексте процесса, где спать можно. Spinlock держишь коротко, mutex — пока нужна эксклюзивность.

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

SKILL.md · MIT
---
name: kernel-concurrency
description: Kernel concurrency skill for Linux locking and synchronization. Use when choosing spinlocks vs mutexes, using RCU, seqlocks, completions, or applying memory barriers in kernel code. Activates on queries about kernel spinlock, mutex, RCU, seqlock, memory barrier, or PREEMPT_RT locking.
---

# Kernel Concurrency

## Purpose

Guide agents through synchronization in the Linux kernel: spinlocks, mutexes, semaphores, RCU, seqlocks, completions, and memory ordering rules — critical for correct drivers and subsystem patches.

## When to Use

- IRQ handler shares data with process context
- Read-mostly data structures needing RCU
- Choosing lock type for `probe` vs `ioctl` paths
- Debugging deadlocks or `scheduling while atomic`

## Workflow

### 1. Lock selection tree

```
Context can sleep?
├── No (IRQ, spinlock held, preempt disabled)
│   └── spin_lock_irqsave() / atomic_t
└── Yes
    ├── Exclusive long-held → mutex
    ├── Reader/writer → rw_semaphore or RCU (read-mostly)
    └── One-shot signal → completion
```

**Never sleep while holding a spinlock** (`kmalloc(GFP_KERNEL)`, `mutex_lock`).

### 2. Spinlock + IRQ

```c
spinlock_t lock;
unsigned long flags;

spin_lock_irqsave(&lock, flags);
/* critical section — no blocking */
spin_unlock_irqrestore(&lock, flags);
```

Use `spin_lock_bh` when softirq/tasklet sharing is the concern.

### 3. Mutex in process context

```c
struct mutex m;
mutex_lock(&m);
/* may allocate, may sleep */
mutex_unlock(&m);
```

### 4. RCU (read-copy update)

```c
/* Readers — no lock */
rcu_read_lock();
p = rcu_dereference(ptr);
/* use p */
rcu_read_unlock();

/* Writer */
new = kmalloc(...);
rcu_assign_pointer(ptr, new);
synchronize_rcu();
kfree(old);
```

RCU readers must not block indefinitely. Grace period completes after all CPUs quiescent.

### 5. Seqlock (jiffies, timestamps)

```c
unsigned seq;
do {
    seq = read_seqbegin(&seqlock);
    /* read shared data */
} while (read_seqretry(&seqlock, seq));
```

Writer uses `write_seqlock` / `write_sequnlock`.

### 6. Completions

```c
DECLARE_COMPLETION(done);
/* waiter */
wait_for_completion(&done);
/* signaller */
complete(&done);
```

### 7. Memory barriers

Kernel provides `smp_mb()`, `smp_wmb()`, `smp_rmb()`. Device MMIO uses `readl`/`writel` (ordered on most arches). See `skills/low-level-programming/memory-model` for userspace analogies.

### 8. Agent usage

```
/kernel-concurrency Protect shared ring buffer between IRQ and read() syscall
```

## Common Problems

| Symptom | Cause | Fix |
|---------|-------|-----|
| `scheduling while atomic` | Sleep under spinlock | Use `GFP_ATOMIC` or defer work |
| Deadlock | AB-BA mutex order | Global lock ordering |
| RCU stall | Reader blocked too long | `rcu_read_lock` section minimal |
| Lost wake | `complete` before `wait` | Use `INIT_COMPLETION` each cycle |
| Corrupt counter | Non-atomic RMW in IRQ | `atomic_t` or lock |

## Related Skills

- `skills/kernel/device-drivers` — threaded IRQ pattern
- `skills/low-level-programming/memory-model` — C11 atomics vs kernel
- `skills/debuggers/concurrency-debugging` — userspace TSan
- `skills/kernel/kernel-internals` — scheduler preemption
- `skills/profilers/linux-perf` — lock contention profiling

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

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

Все скиллы по теме «Языки программирования» →
go-concurrency cxuu Скилл go-concurrency для Claude Code задаёт правила работы с горутинами, каналами и мьютексами, чтобы предотвращать утечки и гонки данных в Go-коде. CX Codex +1 1 400установок golang-concurrency samber Скилл golang-concurrency задаёт правила для конкурентного кода на Go: жизненный цикл горутин, каналы и select, мьютексы, errgroup, singleflight, воркер-пулы и fan-out/fan-in пайплайны. CX Codex +1 44 500установок swift-concurrency AvdLee Скилл swift-concurrency для Claude Code разбирает ошибки Swift Concurrency и предлагает безопасные исправления. Он включается при миграции на Swift 6 и работе с задачами, акторами и Sendable. CX Codex +1 17 700установок swift-concurrency-pro Paul Hudson Скилл swift-concurrency-pro проверяет Swift-код на корректность конкурентности, современные API и типичные ловушки async/await. Пригодится при чтении и ревью асинхронного кода. CX Codex +1 13 100установок m07-concurrency actionbook Скилл m07-concurrency помогает разбирать конкурентный и асинхронный Rust-код: выбрать потоки, async/await, каналы или синхронизацию. Нужен при ошибках Send/Sync, дедлоках и гонках. CX Codex +1 3 900установок swift-concurrency-expert Dimillian Скилл swift-concurrency-expert проверяет и исправляет проблемы параллелизма в Swift 6.2+: добавляет Sendable, применяет @MainActor, решает предупреждения об изоляции акторов и переводит completion handlers на async/await. CX Codex +1 2 100установок

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

Весь набор →
mmio-and-bit-manipulation Скилл mmio-and-bit-manipulation для безопасной работы с памятью периферии: volatile-семантика, read-modify-write паттерны, маски битов и выравнивание. Пригодится при написании драйверов голого железа без HAL. CX Codex +1 392установок dma-baremetal Скилл dma-baremetal помогает настраивать прямую передачу данных в память на микроконтроллерах без операционной системы. Пригодится при разгрузке CPU от приёма пакетов UART, SPI или ADC. CX Codex +1 392установок bus-drivers-i2c-spi Скилл bus-drivers-i2c-spi помогает писать клиентские драйверы Linux для датчиков и PMIC на шинах I2C и SPI: регистрация, regmap, привязка к device tree. CX Codex +1 392установок uart-serial-baremetal Скилл uart-serial-baremetal помогает настроить bare-metal UART и USART на микроконтроллерах для вывода логов, расчёта битрейта и отладки. CX Codex +1 391установок gpu-memory-model Скилл gpu-memory-model объясняет модели памяти GPU, расхождения варпов и конфликты банков памяти. Помогает находить узкие места в ядрах CUDA и HIP. CX Codex +1 391установок compiler-frontend Скилл compiler-frontend для Claude Code помогает проектировать лексер, парсер и проверку типов, а затем генерировать LLVM IR. Описывает фронтенд компилятора, интерпретатора или собственного языка. CX Codex +1 390установок qemu-embedded-simulation Скилл qemu-embedded-simulation для Claude Code помогает запускать bare-metal прошивки ARM и RISC-V в QEMU и подключать GDB. Проверяет прошивку без платы. CX Codex +1 389установок kernel-memory-management Скилл kernel-memory-management по памяти ядра Linux: помогает выбрать между kmalloc, vmalloc и страничным аллокатором и понять, почему драйвер упирается в OOM. CX Codex +1 388установок

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

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