writing-char-drivers — скилл для Claude Code: драйверы /dev
Скилл writing-char-drivers для написания символьных драйверов Linux: регистрация cdev, реализация file_operations, безопасные копии в userspace, ioctl и mmap.
MIT 378 установок ★ 298 обновлён 2026-06-27
npx skills add mohitmishra786/low-level-dev-skills --skill writing-char-drivers -a claude-codeЧто делает writing-char-drivers
Учит агента создавать символьные устройства Linux с полным циклом: выделение major/minor через alloc_chrdev_region, инициализация cdev, заполнение структуры file_operations с методами open, read, write, unlocked_ioctl. Показывает, как безопасно передавать данные между ядром и пользовательским пространством через copy_to_user и copy_from_user, определять команды ioctl макросами _IO, _IOW, _IOWR с фиксированным magic-числом, отображать физическую память устройства в адресное пространство процесса через remap_pfn_range с pgprot_noncached.
Включает таблицу типичных ошибок: -EFAULT при невалидном указателе userspace, ENOTTY при несовпадении magic в ioctl, конфликт статического major, SIGSEGV в mmap из-за кешированного отображения регионов MMIO. Срабатывает на упоминания cdev, file_operations, copy_from_user, ioctl, kernel mmap. Без заголовочных файлов ядра (<linux/fs.h>, <linux/cdev.h>, <linux/uaccess.h>) код не соберётся.
Какие задачи решает
- зарегистрировать символьное устройство с динамическим major
- реализовать
readиwriteс безопасными копиями в userspace - добавить
unlocked_ioctlс командами через_IOWи_IOWR - отобразить MMIO-регион устройства в userspace через
mmap - обработать
-EFAULTиENOTTYв драйвере
Примеры запросов агенту
- Добавь
unlocked_ioctlSET_SPEED к существующему platform-драйверу - Зарегистрируй
cdevс динамическим major и создай/dev/mydev - Реализуй
my_readсcopy_to_userи проверкой смещения
Как установить writing-char-drivers
1Через Skills CLI (Vercel)
npx skills add mohitmishra786/low-level-dev-skills --skill writing-char-drivers -a claude-code2Вручную: положить файлы
~/.claude/skills/writing-char-drivers/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/writing-char-drivers/
1Через Skills CLI (Vercel)
npx skills add mohitmishra786/low-level-dev-skills --skill writing-char-drivers -a codex2Вручную: положить файлы
.agents/skills/writing-char-drivers/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add mohitmishra786/low-level-dev-skills --skill writing-char-drivers -a cursor2Вручную: положить файлы
.cursor/skills/writing-char-drivers/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install mohitmishra786/low-level-dev-skills skills/kernel-dev/writing-char-drivers2Вручную: положить файлы
.github/skills/writing-char-drivers/SKILL.md1Через Skills CLI (Vercel)
npx skills add mohitmishra786/low-level-dev-skills --skill writing-char-drivers -a gemini-cli2Командой платформы
gemini skills install https://github.com/mohitmishra786/low-level-dev-skills --path skills/kernel-dev/writing-char-driversВручную: положить файлы
.devin/skills/writing-char-drivers/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add mohitmishra786/low-level-dev-skills --skill writing-char-drivers -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о writing-char-drivers
Как установить writing-char-drivers в Claude Code?
Выполни npx skills add mohitmishra786/low-level-dev-skills --skill writing-char-drivers -a claude-code. Скилл появится в ~/.claude/skills/writing-char-drivers/SKILL.md.
Что делает writing-char-drivers?
Скилл учит агента писать символьные драйверы Linux: регистрировать cdev, заполнять file_operations, передавать данные через copy_to_user и copy_from_user, создавать ioctl-команды и отображать память устройства в userspace.
Что нужно для работы writing-char-drivers?
Заголовки ядра Linux (<linux/fs.h>, <linux/cdev.h>, <linux/uaccess.h>), окружение для сборки модулей ядра. Без них код не соберётся.
Исходный текст
SKILL.md · MIT
---
name: writing-char-drivers
description: Character driver skill for Linux kernel char devices. Use when implementing file_operations, cdev, copy_to_user, ioctl, or mmap for userspace interfaces. Activates on queries about char device, cdev, file_operations, copy_from_user, ioctl, or kernel mmap.
---
# Writing Character Drivers
## Purpose
Guide agents through Linux character device implementation: `struct file_operations`, `cdev` registration, safe userspace copies, `ioctl` design, and basic `mmap` — focused depth beyond `skills/kernel/device-drivers`.
## When to Use
- Exposing hardware to `/dev/mydev`
- Implementing `read`/`write`/`poll` from kernel
- Defining `ioctl` commands with type-safe macros
- Mapping device MMIO to userspace (carefully)
## Workflow
### 1. Char device registration
```c
#include <linux/fs.h>
#include <linux/cdev.h>
#include <linux/uaccess.h>
#define MY_MAJOR 0 /* 0 = dynamic alloc */
#define MY_MINOR 0
static dev_t devno;
static struct cdev my_cdev;
static struct class *class;
static const struct file_operations my_fops = {
.owner = THIS_MODULE,
.open = my_open,
.release = my_release,
.read = my_read,
.write = my_write,
.unlocked_ioctl = my_ioctl,
.llseek = no_llseek,
};
static int __init my_init(void)
{
int ret = alloc_chrdev_region(&devno, MY_MINOR, 1, "mydev");
if (ret)
return ret;
cdev_init(&my_cdev, &my_fops);
ret = cdev_add(&my_cdev, devno, 1);
if (ret)
goto err_cdev;
class = class_create("mydev");
device_create(class, NULL, devno, NULL, "mydev");
return 0;
err_cdev:
unregister_chrdev_region(devno, 1);
return ret;
}
```
Modern drivers often use `devm_*` variants inside `probe`.
### 2. Safe userspace I/O
```c
static ssize_t my_read(struct file *filp, char __user *buf,
size_t count, loff_t *ppos)
{
char kbuf[128];
ssize_t len;
if (*ppos >= sizeof(kbuf))
return 0;
len = min(count, sizeof(kbuf) - *ppos);
memcpy(kbuf, "data", 4);
if (copy_to_user(buf, kbuf + *ppos, len))
return -EFAULT;
*ppos += len;
return len;
}
```
Never dereference `__user` pointers directly.
### 3. ioctl pattern
```c
#include <linux/ioctl.h>
#define MY_IOC_MAGIC 'k'
#define MY_IOC_RESET _IO(MY_IOC_MAGIC, 0)
#define MY_IOC_SET _IOW(MY_IOC_MAGIC, 1, int)
static long my_ioctl(struct file *filp, unsigned int cmd, unsigned long arg)
{
switch (cmd) {
case MY_IOC_RESET:
return 0;
case MY_IOC_SET: {
int val;
if (copy_from_user(&val, (void __user *)arg, sizeof(val)))
return -EFAULT;
return 0;
}
default:
return -ENOTTY;
}
}
```
Use `_IOWR` with fixed-size structs; prefer `compat_ioctl` on bi-arch.
### 4. mmap (device memory)
```c
static int my_mmap(struct file *filp, struct vm_area_struct *vma)
{
unsigned long size = vma->vm_end - vma->vm_start;
phys_addr_t phys = device_phys_base;
vma->vm_page_prot = pgprot_noncached(vma->vm_page_prot);
return remap_pfn_range(vma, vma->vm_start, phys >> PAGE_SHIFT,
size, vma->vm_page_prot);
}
```
Prefer `mmap` of DMA buffers only with explicit size limits and permission checks.
### 5. poll / async I/O
Implement `poll` + `wake_up_interruptible` for blocking reads; use `fasync_helper` for SIGIO.
### 6. Agent usage
```
/writing-char-drivers Add unlocked_ioctl SET_SPEED to existing platform driver
```
## Common Problems
| Symptom | Cause | Fix |
|---------|-------|-----|
| `-EFAULT` | Bad user pointer | Validate `access_ok` (older) / rely on `copy_*` |
| `ENOTTY` | Wrong ioctl magic | Match userspace `ioctl.h` |
| Major conflict | Static major taken | Use `alloc_chrdev_region` |
| mmap SIGSEGV | Cached mapping to device | `pgprot_noncached` |
| Sleep in ioctl | Holding spinlock | Drop lock before blocking |
## Related Skills
- `skills/kernel-dev/platform-device-model` — probe context
- `skills/kernel/device-drivers` — full driver lifecycle
- `skills/kernel/kernel-concurrency` — locking in file ops
- `skills/kernel-dev/kernel-debugging-advanced` — trace ioctl path
- `skills/low-level-programming/linux-kernel-modules` — module boilerplate
© mohitmishra786 · MIT · mohitmishra786/low-level-dev-skills