Утилита chdbfl

chdbfl — это утилита командной строки для операционных систем семейства Unix, предназначенная для проверки целостности и восстановления файловых систем, отформатированных в файловую систему Btrfs. Она выполняет функции, аналогичные утилите fsck для других файловых систем, но адаптирована под специфику Btrfs, включая работу с подтомами, снимками, контрольными суммами и механизмами избыточности (например, RAID). Утилита входит в состав пакета btrfs-progs, который является основным набором инструментов для управления Btrfs.

История

Разработка утилиты chdbfl началась одновременно с созданием самой файловой системы Btrfs, которая была анонсирована компанией Oracle в 2007 году. Первоначально Btrfs проектировалась как современная замена ext3/ext4 с поддержкой расширенных функций: копирование при записи (CoW), снимки, проверка целостности данных и метаданных с помощью контрольных сумм, а также встроенные возможности RAID.

Первые версии btrfs-progs, включая chdbfl, появились в ядре Linux начиная с версии 2.6.29 (2009 год). На ранних этапах утилита была ограничена: она могла только проверять структуру метаданных на наличие явных ошибок, но не умела восстанавливать повреждённые данные. По мере развития Btrfs и её внедрения в корпоративных средах (например, в SUSE Linux Enterprise и Facebook) функциональность chdbfl расширялась. В версиях btrfs-progs 4.x и 5.x (2015–2020 годы) были добавлены режимы проверки контрольных сумм, поддержка профилей RAID5/RAID6, а также возможность ремонта некоторых типов повреждений.

На 2025 год chdbfl продолжает развиваться в рамках проекта Btrfs, поддерживаемого сообществом и такими компаниями, как Oracle, SUSE, Red Hat и Facebook (продукт Meta, признанной экстремистской и запрещённой в РФ). Утилита остаётся основным средством диагностики файловой системы, хотя разработчики рекомендуют использовать её с осторожностью из-за риска дальнейшего повреждения данных при неправильном применении.

Назначение и общие принципы работы

Основная задача chdbfl — проверка согласованности метаданных файловой системы Btrfs. В отличие от традиционных утилит fsck, которые работают с блочными устройствами на низком уровне, chdbfl оперирует с B-деревьями (B-trees), которые являются основой структуры Btrfs. Она анализирует следующие компоненты:

• Суперблоки: проверка целостности и согласованности всех копий суперблока (Btrfs хранит несколько копий в разных местах диска).
• Корневые деревья: проверка структуры корневого B-дерева, которое содержит ссылки на все остальные деревья (дерево экстентов, дерево контрольных сумм, дерево подтомов и т.д.).
• Деревья экстентов: проверка выделения и освобождения блоков данных, отсутствие пересечений и утечек.
• Деревья подтомов и снимков: проверка корректности ссылок на подтома и снимки, включая их иерархию.
• Контрольные суммы: верификация контрольных сумм для метаданных и данных (если включена опция --check-data-csum).
• Ссылки на файлы: проверка целостности каталогов и inode, отсутствие битых ссылок (например, на удалённые снимки).

Утилита работает в двух основных режимах: read-only (только проверка) и repair (попытка восстановления). По умолчанию используется режим read-only, который не вносит изменений в файловую систему.

Режимы работы

Проверка (read-only)

В режиме проверки chdbfl сканирует все метаданные файловой системы и выводит отчёт об ошибках. Типичные сообщения включают:

• errors found in fs roots — ошибки в корневых деревьях подтомов;
• missing backref — отсутствие обратной ссылки (back reference) на экстент;
• csum mismatch — несовпадение контрольной суммы;
• block group overlap — пересечение групп блоков.

Если ошибки не найдены, утилита завершает работу с кодом 0 и сообщением found 0 errors.

Восстановление (repair)

Режим восстановления активируется опцией --repair. В этом режиме chdbfl пытается исправить найденные ошибки, используя избыточные данные (например, копии суперблоков, дублирующиеся метаданные в RAID-конфигурациях). Однако возможности восстановления ограничены:

• Утилита может восстановить только повреждения метаданных, но не данных (если контрольная сумма данных не совпадает, данные считаются потерянными).
• При серьёзных повреждениях (например, разрушении корневого B-дерева) восстановление может быть невозможным.
• В некоторых случаях chdbfl может удалить повреждённые подтома или файлы, что приведёт к потере данных.

Разработчики Btrfs настоятельно рекомендуют перед использованием --repair создавать резервную копию метаданных с помощью утилиты btrfs-image.

Офлайн-режим

chdbfl требует, чтобы файловая система была размонтирована (offline) перед запуском. Попытка проверки смонтированной файловой системы приведёт к ошибке ERROR: cannot check mounted filesystem и завершению работы. Это связано с тем, что Btrfs активно изменяет метаданные в процессе работы, и проверка на смонтированной системе может дать ложные результаты или повредить данные.

Синтаксис и основные опции

Общий синтаксис вызова утилиты:

`` chdbfl [опции] <устройство> ``

Где <устройство> — это блочное устройство (например, /dev/sda1), содержащее файловую систему Btrfs.

Основные опции:

Пример использования:

`` chdbfl --progress --check-data-csum /dev/sdb1 ``

Ограничения и критика

Несмотря на свою важность, chdbfl имеет ряд ограничений, которые критикуются сообществом и администраторами:

• Неспособность восстановить данные: утилита может исправить только метаданные. Если данные повреждены (например, из-за битых секторов диска), chdbfl не может их восстановить, а только пометит как потерянные.
• Риск при ремонте: в некоторых версиях btrfs-progs (особенно до версии 5.0) режим --repair мог усугубить повреждения, удалив целые подтома или сделав файловую систему немонтируемой. Разработчики до сих пор предупреждают, что chdbfl --repair — это «последнее средство».
• Отсутствие поддержки некоторых профилей RAID: для профилей RAID5 и RAID6 проверка контрольных сумм данных может быть неполной, а восстановление — невозможным из-за отсутствия механизма восстановления по чётности (parity) в утилите.
• Длительное время работы: на больших файловых системах (несколько терабайт) проверка может занимать часы, особенно если включена опция --check-data-csum.
• Необходимость размонтирования: для проверки корневой файловой системы требуется загрузка с LiveCD или использование initramfs, что усложняет процедуру.

Сравнение с аналогами

В экосистеме Linux chdbfl является аналогом fsck для других файловых систем:

• Для ext4 существует e2fsck, который также работает offline и может восстанавливать метаданные, но не данные.
• Для XFS — xfs_repair, который, в отличие от chdbfl, может работать с журналом и восстанавливать некоторые типы повреждений данных.
• Для ZFS — zpool scrub, который работает online и проверяет как метаданные, так и данные, используя избыточность (зеркала, RAID-Z).

Основное отличие chdbfl от аналогов — ориентация на сложную структуру Btrfs (B-деревья, подтома, снимки) и ограниченные возможности восстановления данных.

Практические рекомендации

Администраторам, использующим Btrfs, рекомендуется:

1. Регулярно выполнять проверку в режиме read-only (например, раз в месяц) для выявления потенциальных проблем.
2. Перед использованием --repair создавать образ метаданных с помощью btrfs-image.
3. Для критически важных данных использовать RAID-конфигурации (RAID1 или RAID10) и регулярно выполнять btrfs scrub — утилиту, которая проверяет и восстанавливает данные online.
4. Избегать использования chdbfl --repair на файловых системах с версией ядра Linux ниже 4.0 из-за известных ошибок.

Источники

• Документация пакета btrfs-progs (man-страницы chdbfl, btrfs, btrfs-image).
• Официальный сайт проекта Btrfs (btrfs.wiki.kernel.org).
• Статьи и руководства по администрированию Btrfs в документации SUSE Linux Enterprise и Red Hat Enterprise Linux.
• Код утилиты chdbfl в репозитории git.kernel.org/pub/scm/linux/kernel/git/kdave/btrfs-progs.git.