kernel-concurrency — скилл для Linux: синхронизация и блокировки
Скилл kernel-concurrency помогает выбрать правильный примитив синхронизации в ядре Linux: spinlock, mutex, RCU, seqlock или completion.
MIT 391 установок ★ 298 обновлён 2026-06-27
npx skills add mohitmishra786/low-level-dev-skills --skill kernel-concurrency -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/kernel-concurrency/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/kernel-concurrency/
1Через Skills CLI (Vercel)
npx skills add mohitmishra786/low-level-dev-skills --skill kernel-concurrency -a codex2Вручную: положить файлы
.agents/skills/kernel-concurrency/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add mohitmishra786/low-level-dev-skills --skill kernel-concurrency -a cursor2Вручную: положить файлы
.cursor/skills/kernel-concurrency/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install mohitmishra786/low-level-dev-skills skills/kernel-dev/kernel-concurrency2Вручную: положить файлы
.github/skills/kernel-concurrency/SKILL.md1Через Skills CLI (Vercel)
npx skills add mohitmishra786/low-level-dev-skills --skill kernel-concurrency -a gemini-cli2Командой платформы
gemini skills install https://github.com/mohitmishra786/low-level-dev-skills --path skills/kernel-dev/kernel-concurrencyВручную: положить файлы
.devin/skills/kernel-concurrency/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add mohitmishra786/low-level-dev-skills --skill kernel-concurrency -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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