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

writing-char-drivers — скилл для Claude Code: драйверы /dev

Скилл writing-char-drivers для написания символьных драйверов Linux: регистрация cdev, реализация file_operations, безопасные копии в userspace, ioctl и mmap.

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

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

Что делает 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_ioctl SET_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-code

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

~/.claude/skills/writing-char-drivers/SKILL.md

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

По шагам, с командами для каждой платформы: Как установить скилл в 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

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

Все скиллы по теме «Бэкенд и API» →
performance-tuning devops-skills Скилл performance-tuning для Claude Code: подбор параметров ядра Linux, поиск узких мест, работа с планировщиком I/O и памятью. Диагностирует торможение сервера и готовит его к нагрузке. CX Codex +1 454установок container-breakout-detection Problem99-io Скилл container-breakout-detection для Claude Code определяет побег процессов из контейнера на хост. Проверяет конфигурации рантайма и аномалии в пространствах имён хоста. CX Codex +1 ★ 71звёзд репо kernel-exploitation yaklang Скилл kernel-exploitation для Claude Code помогает исследовать уязвимости ядра Linux: настраивать QEMU и разбирать KASLR и SMEP. CX Codex +1 4 000установок analyzing-linux-kernel-rootkits mahipal Скилл analyzing-linux-kernel-rootkits для Claude Code ищет признаки руткитов уровня ядра в дампах памяти Linux и на работающей системе. Выполняет анализ для расследований и форензики. CX Codex +1 458установок performant-code vstorm-co Скилл performant-code для Claude Code задаёт правила оптимизации кода для больших файлов и жёстких лимитов памяти, помогая избежать таймаутов при обработке гигабайтов. CX Codex +1 ★ 1 125звёзд репо neo4j-driver-python-skill neo4j-contrib Скилл neo4j-driver-python-skill подсказывает агенту, как правильно писать Python-код под драйвер Neo4j v6: жизненный цикл драйвера, транзакции, async, батчинг через UNWIND. CX Codex +1 1 000установок

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

Весь набор →
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установок platform-device-model Скилл platform-device-model для Claude Code объясняет привязку Linux-драйверов к platform bus, работу probe и remove, sysfs и deferred probe. Описывает задачи разработки драйверов устройств и работы с Device Tree. CX Codex +1 378установок adc-dac-baremetal Скилл adc-dac-baremetal для настройки АЦП и ЦАП на микроконтроллерах: выбор каналов, время выборки, калибровка, DMA-буферы и выходное напряжение. Пригодится при работе с аналоговыми датчиками, аудио или управляющими сигналами. CX Codex +1 378установок resource-optimization-lowend Скилл resource-optimization-lowend помогает уменьшать расход flash и RAM в прошивках для MCU, разбирать linker map и оценивать глубину стека. CX Codex +1 376установок llvm-passes Скилл llvm-passes учит агента писать, собирать и тестировать проходы оптимизации LLVM через New Pass Manager. CX Codex +1 373установок openmp Скилл учит агента писать и чинить код с OpenMP: параллельные циклы, редукции, задачи, SIMD и выгрузка на GPU. CX Codex +1 371установок

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

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