snapraid/doc/snapraid-ru.txt

              ====================================================
              Резервное копирование SnapRAID для дисковых массивов
              ====================================================


1 Синопсис (SYNOPSIS)
=====================

snapraid [-c, --conf CONFIG]
	[-f, --filter PATTERN] [-d, --filter-disk NAME]
	[-m, --filter-missing] [-e, --filter-error]
	[-a, --audit-only] [-h, --pre-hash] [-i, --import DIR]
	[-p, --plan PERC|bad|new|full]
	[-o, --older-than DAYS] [-l, --log FILE]
	[-s, --spin-down-on-error] [-w, --bw-limit RATE]
	[-t, --tail]
	[-Z, --force-zero] [-E, --force-empty]
	[-U, --force-uuid] [-D, --force-device]
	[-N, --force-nocopy] [-F, --force-full]
	[-R, --force-realloc] [-W, --force-realloc-tail]
	[-S, --start BLKSTART] [-B, --count BLKCOUNT]
	[-L, --error-limit NUMBER]
	[-A, --stats]
	[-v, --verbose] [-q, --quiet]
	status|smart|probe|up|down|diff|sync|scrub|fix|check
	|list|dup|pool|devices|touch|rehash|locate

snapraid [-V, --version] [-H, --help] [-C, --gen-conf CONTENT]


2 Описание (DESCRIPTION)
========================

SnapRAID — это программа резервного копирования, разработанная для дисковых массивов,
хранящая информацию четности для восстановления данных в случае сбоя
до шести дисков.

В первую очередь предназначенная для домашних медиацентров с большими,
редко меняющимися файлами, SnapRAID предлагает несколько функций:

* Вы можете использовать диски, уже заполненные файлами, без
  необходимости их переформатирования, получая к ним доступ как обычно.
* Все ваши данные хэшируются для обеспечения целостности данных и
  предотвращения скрытого повреждения.
* Когда число отказавших дисков превышает количество дисков четности,
  потеря данных ограничивается затронутыми дисками; данные на
  других дисках остаются доступными.
* Если вы случайно удалите файлы на диске, возможно их восстановление.
* Диски могут иметь разные размеры.
* Вы можете добавлять диски в любое время.
* SnapRAID не блокирует ваши данные; вы можете прекратить его использование
  в любое время без переформатирования или перемещения данных.
* Для доступа к файлу должен раскручиваться только один диск, что экономит
  энергию и снижает шум.

Для получения дополнительной информации, пожалуйста, посетите официальный сайт SnapRAID:

    https://www.snapraid.it/


3 Ограничения (LIMITATIONS)
===========================

SnapRAID — это гибрид между RAID и программой резервного копирования, стремящийся сочетать
в себе лучшие преимущества обоих подходов. Однако у него есть некоторые ограничения, которые вам
следует учесть перед использованием.

Основное ограничение заключается в том, что в случае сбоя диска вы можете восстановить данные только до
состояния последней операции синхронизации (`sync`). Любые данные, добавленные или измененные
с момента последней синхронизации и находящиеся на отказавшем диске, будут потеряны.

Следовательно, SnapRAID в первую очередь подходит для данных, которые редко меняются.

Для данных, которые уже существовали на момент последней синхронизации, надежность восстановления зависит
от того, используется ли опция снимка (`snapshot`):

* При наличии поддержки снимков (доступно на Btrfs, ZFS, Bcachefs и NTFS),
  SnapRAID может автоматически поддерживать независимую замороженную копию
  каждой поддерживаемой файловой системы данных.
  Это гарантирует, что даже если вы измените или удалите файлы в вашей живой файловой системе
  во время или после синхронизации, процесс восстановления останется согласованным и надежным.

* Без поддержки снимков удаление или изменение файлов после `sync`
  может предотвратить полное восстановление других отказавших дисков. Это происходит
  потому, что четность больше не соответствует измененным файлам, даже если
  эти файлы находятся не на отказавшем диске. С другой стороны, недавно добавленные
  файлы не препятствуют восстановлению уже существующих файлов.

Другие ограничения SnapRAID:

* Со SnapRAID у вас все еще отдельные файловые системы для каждого диска.
  С RAID вы получаете единую большую файловую систему.
* SnapRAID не выполняет чередование данных.
  С RAID вы получаете прирост скорости благодаря чередованию.
* SnapRAID не поддерживает восстановление в реальном времени.
  С RAID вам не нужно прекращать работу при сбое диска.
* SnapRAID может восстановить данные только при ограниченном числе сбоев дисков.
  С резервным копированием вы можете восстановиться после полного
  сбоя всего дискового массива.
* Сохраняются только имена файлов, метки времени, символические ссылки и жесткие ссылки.
  Разрешения, права владения и расширенные атрибуты не сохраняются.


4 Начало работы (GETTING STARTED)
=================================

Чтобы использовать SnapRAID, вам нужно сначала выбрать один диск в вашем дисковом массиве
для выделения под информацию `четности` (parity). С одним диском для четности, вы
сможете восстановиться после одного сбоя диска, подобно RAID5.

Если вы хотите восстановиться после большего числа сбоев дисков, подобно RAID6,
вы должны зарезервировать дополнительные диски для четности. Каждый дополнительный диск
четности позволяет восстановиться после еще одного сбоя диска.

В качестве дисков четности вы должны выбирать самые большие диски в массиве,
так как информация четности может вырасти до размера самого большого
диска данных в массиве.

Эти диски будут выделены для хранения файлов `четности`.
Вы не должны хранить на них свои данные.

Затем вы должны определить диски `данных`, которые вы хотите защитить
с помощью SnapRAID. Защита более эффективна, если эти диски
содержат данные, которые редко меняются. По этой причине лучше
НЕ включать диск Windows C:\ или каталоги Unix /home, /var и /tmp.

Список файлов сохраняется в файлах `content`, обычно
хранящихся на дисках данных, четности или загрузочных дисках.
Этот файл содержит детали вашего резервного копирования, включая все
контрольные суммы для проверки его целостности.
Файл `content` хранится в нескольких копиях, и каждая копия должна
находиться на отдельном диске, чтобы гарантировать, что даже в случае
множественных сбоев дисков, хотя бы одна копия будет доступна.

Например, предположим, что вы заинтересованы только в одном уровне защиты четности,
и ваши диски расположены по адресам:

    /mnt/diskp <- выбранный диск для четности
    /mnt/disk1 <- первый диск для защиты
    /mnt/disk2 <- второй диск для защиты
    /mnt/disk3 <- третий диск для защиты

Вы должны создать файл конфигурации /etc/snapraid.conf со
следующими опциями:

    parity /mnt/diskp/snapraid.parity
    content /var/snapraid/snapraid.content
    content /mnt/disk1/snapraid.content
    content /mnt/disk2/snapraid.content
    data d1 /mnt/disk1/
    data d2 /mnt/disk2/
    data d3 /mnt/disk3/

Если вы используете Windows, вам следует использовать формат пути Windows,
с буквами дисков и обратными слешами вместо прямых.

    parity E:\snapraid.parity
    content C:\snapraid\snapraid.content
    content F:\array\snapraid.content
    content G:\array\snapraid.content
    data d1 F:\array\
    data d2 G:\array\
    data d3 H:\array\

Если у вас много дисков и заканчиваются буквы дисков, вы можете монтировать
диски непосредственно в подпапки. См.:

    https://www.google.com/search?q=Windows+mount+point

На этом этапе вы готовы запустить команду `sync` для создания
информации четности.

    snapraid sync

Этот процесс может занять несколько часов в первый раз, в зависимости от размера
данных, уже присутствующих на дисках. Если диски пустые,
процесс происходит немедленно.

Вы можете остановить его в любое время, нажав Ctrl+C, и при следующем запуске он
возобновит работу с того места, где был прерван.

Когда эта команда завершится, ваши данные ЗАЩИЩЕНЫ.

Теперь вы можете начать использовать свой массив, как вам угодно, и периодически
обновлять информацию четности, запуская команду `sync`.

4.1 Скрабирование (Scrubbing)
-----------------------------

Для периодической проверки данных и четности на наличие ошибок, вы можете
запустить команду `scrub`.

    snapraid scrub

Эта команда сравнивает данные в вашем массиве с хэшем, вычисленным
во время команды `sync`, для проверки целостности.

Каждый запуск команды проверяет примерно 8% массива, исключая данные,
уже проверенные за предыдущие 10 дней.
Вы можете использовать опцию -p, --plan, чтобы указать другое количество,
и опцию -o, --older-than, чтобы указать другой возраст в днях.
Например, для проверки 5% массива на наличие блоков старше 20 дней, используйте:

    snapraid -p 5 -o 20 scrub

Если во время процесса обнаруживаются скрытые ошибки или ошибки ввода/вывода,
соответствующие блоки помечаются как плохие в файле `content`
и перечисляются в команде `status`.

    snapraid status

Чтобы исправить их, вы можете использовать команду `fix`, фильтруя плохие блоки
с помощью опции -e, --filter-error:

    snapraid -e fix

При следующем `scrub` ошибки исчезнут из отчета `status`,
если они действительно исправлены. Чтобы ускорить процесс, вы можете использовать
-p bad для проверки только блоков, помеченных как плохие.

    snapraid -p bad scrub

Запуск `scrub` на несинхронизированном массиве может сообщить об ошибках, вызванных
удаленными или измененными файлами. Эти ошибки сообщаются в выводе `scrub`,
но соответствующие блоки не помечаются как плохие.

4.2 Объединение (Pooling)
-------------------------

Примечание: Функция объединения (pooling), описанная ниже, была заменена инструментом
mergerfs, который теперь является рекомендуемым вариантом для пользователей Linux
в сообществе SnapRAID. Mergerfs предоставляет более гибкий и эффективный
способ объединения нескольких дисков в единую точку монтирования,
обеспечивая беспрепятственный доступ к файлам по всему массиву без
опоры на символические ссылки. Он хорошо интегрируется со SnapRAID для
защиты четности и обычно используется в установках, таких как OpenMediaVault (OMV)
или пользовательских конфигурациях NAS.

Чтобы все файлы в вашем массиве отображались в одном дереве каталогов,
вы можете включить функцию `pooling`. Она создает виртуальное
представление всех файлов в вашем массиве только для чтения, используя
символические ссылки.

Вы можете настроить каталог `pooling` в файле конфигурации с помощью:

    pool /pool

или, если вы используете Windows, с помощью:

    pool C:\pool

а затем запустить команду `pool` для создания или обновления виртуального представления.

    snapraid pool

Если вы используете платформу Unix и хотите предоставить общий доступ к этому каталогу
по сети как для машин Windows, так и для Unix, вы должны добавить
следующие опции в ваш /etc/samba/smb.conf:

    # В глобальном разделе smb.conf
    unix extensions = no

    # В разделе общего ресурса smb.conf
    [pool]
    comment = Pool
    path = /pool
    read only = yes
    guest ok = yes
    wide links = yes
    follow symlinks = yes

В Windows совместное использование символических ссылок по сети требует, чтобы клиенты
разрешали их удаленно. Чтобы включить это, помимо предоставления общего доступа
к каталогу pool, вы также должны предоставить общий доступ ко всем дискам
независимо, используя имена дисков, определенные в файле конфигурации, в качестве
точек общего доступа. Вы также должны указать в опции `share` файла
конфигурации путь UNC Windows, который удаленные клиенты должны использовать
для доступа к этим общим дискам.

Например, работая с сервера с именем `darkstar`, вы можете использовать
опции:

    data d1 F:\array\
    data d2 G:\array\
    data d3 H:\array\
    pool C:\pool
    share \\darkstar

и предоставить общий доступ к следующим каталогам по сети:

    \\darkstar\pool -> C:\pool
    \\darkstar\d1 -> F:\array
    \\darkstar\d2 -> G:\array
    \\darkstar\d3 -> H:\array

чтобы разрешить удаленным клиентам доступ ко всем файлам по адресу \\darkstar\pool.

Вам также может потребоваться настроить удаленные клиенты для включения доступа к
удаленным символическим ссылкам с помощью команды:

    fsutil behavior set SymlinkEvaluation L2L:1 R2R:1 L2R:1 R2L:1

4.3 Восстановление удаленных файлов (Undeleting)
------------------------------------------------

SnapRAID функционирует скорее как программа резервного копирования, чем как система RAID,
и может использоваться для восстановления или отмены удаления файлов до их
предыдущего состояния с помощью опции -f, --filter:

    snapraid fix -f FILE

или для каталога:

    snapraid fix -f DIR/

Вы также можете использовать его для восстановления только случайно удаленных файлов внутри
каталога с помощью опции -m, --filter-missing, которая восстанавливает
только отсутствующие файлы, оставляя все остальные нетронутыми.

    snapraid fix -m -f DIR/

Или для восстановления всех удаленных файлов на всех дисках с помощью:

    snapraid fix -m

4.4 Восстановление (Recovering)
-------------------------------

Случилось худшее, и вы потеряли один или несколько дисков!

НЕ ПАНИКУЙТЕ! Вы сможете их восстановить!

Первое, что вы должны сделать, это избегать дальнейших изменений в вашем дисковом массиве.
Отключите любые удаленные подключения к нему и любые запланированные процессы,
включая любое запланированное ночное sync или scrub SnapRAID.

Затем приступайте к следующим шагам.

---- 4.4.1 STEP 1 -> Reconfigure ----
Вам нужно место для восстановления, в идеале на дополнительных
запасных дисках, но внешнего USB-диска или удаленного диска будет достаточно.

Измените файл конфигурации SnapRAID, чтобы опция `data` или `parity`
отказавшего диска указывала на место с достаточным пустым
пространством для восстановления файлов.

Например, если диск `d1` вышел из строя, измените с:

    data d1 /mnt/disk1/

на:

    data d1 /mnt/new_spare_disk/

Если восстанавливаемый диск является диском четности, обновите соответствующую опцию `parity`.
Если у вас несколько отказавших дисков, обновите все их опции конфигурации.

---- 4.4.2 STEP 2 -> Fix ----
Запустите команду fix, сохраняя журнал во внешнем файле с помощью:

    snapraid -d NAME -l fix.log fix

Где NAME — это имя диска, например `d1` в нашем предыдущем примере.
Если восстанавливаемый диск является диском четности, используйте имена `parity`, `2-parity`
и т. д.
Если у вас несколько отказавших дисков, используйте несколько опций -d, чтобы указать
их все.

Эта команда займет много времени.

Убедитесь, что у вас есть несколько гигабайт свободного места для хранения файла fix.log.
Запустите ее с диска с достаточным свободным местом.

Теперь вы восстановили все, что можно было восстановить. Если некоторые файлы
частично или полностью невосстановимы, они будут переименованы с добавлением
расширения `.unrecoverable`.

Вы можете найти подробный список всех невосстановимых блоков в файле fix.log,
проверяя все строки, начинающиеся с `unrecoverable:`.

Если вы не удовлетворены восстановлением, вы можете повторять его столько
раз, сколько пожелаете.

Например, если вы удалили файлы из массива после последнего
`sync`, это может привести к тому, что некоторые файлы не будут восстановлены.
В этом случае вы можете повторить `fix`, используя опцию -i, --import,
указав, где эти файлы находятся сейчас, чтобы снова включить их в
процесс восстановления.

Если вы удовлетворены восстановлением, вы можете продолжить,
но учтите, что после синхронизации вы больше не сможете повторить команду `fix`!

---- 4.4.3 STEP 3 -> Check ----
В качестве осторожной проверки, вы можете теперь запустить команду `check`, чтобы убедиться,
что все в порядке на восстановленном диске.

    snapraid -d NAME -a check

Где NAME — это имя диска, например `d1` в нашем предыдущем примере.

Опции -d и -a говорят SnapRAID проверить только указанный диск
и игнорировать все данные четности.

Эта команда займет много времени, но если вы не чрезмерно осторожны,
вы можете ее пропустить.

---- 4.4.4 STEP 4 -> Sync ----
Запустите команду `sync`, чтобы ресинхронизировать массив с новым диском.

    snapraid sync

Если все восстановлено, эта команда выполняется немедленно.


5 Команды (COMMANDS)
====================

SnapRAID предоставляет несколько простых команд, которые позволяют:

* Вывести статус массива -> `status`
* Управлять дисками -> `smart`, `probe`, `up`, `down`
* Создать точку резервного копирования/восстановления -> `sync`
* Периодически проверять данные -> `scrub`
* Восстановить последнюю точку резервного копирования/восстановления -> `fix`.

Команды должны быть написаны строчными (маленькими) буквами.

5.1 status
----------

Печатает сводку состояния дискового массива.

Она включает информацию о фрагментации четности, о том, насколько старые
блоки без проверки, и все записанные скрытые ошибки,
возникшие во время scrubbing.

Представленная информация относится к последнему времени, когда вы
запускали `sync`. Более поздние изменения не учитываются.

Если были обнаружены плохие блоки, перечисляются их номера.
Чтобы исправить их, вы можете использовать команду `fix -e`.

Он также показывает график, представляющий последнее время, когда каждый блок
был проверен (`scrubbed`) или синхронизирован (`synced`). Проверенные блоки
обозначены символом `*`, блоки, синхронизированные, но еще не проверенные,
символом `o`.

Ничего не изменяется.

5.2 smart
---------

Печатает отчет SMART всех дисков в системе.

Он включает оценку вероятности сбоя в следующем году,
позволяя планировать плановую замену дисков, которые показывают
подозрительные атрибуты.

Эта оценка вероятности получена путем корреляции атрибутов SMART
дисков с данными Backblaze, доступными по адресу:

    https://www.backblaze.com/hard-drive-test-data.html

Если SMART сообщает, что диск выходит из строя, для этого диска
выводится `FAIL` или `PREFAIL`, и SnapRAID возвращает ошибку.
В этом случае немедленная замена диска настоятельно рекомендуется.

Другие возможные строки статуса:
    logfail - В прошлом некоторые атрибуты были ниже
        порогового значения.
    logerr - Журнал ошибок устройства содержит ошибки.
    selferr - Журнал самотестирования устройства содержит ошибки.

Если указана опция -v, --verbose, предоставляется более глубокий
статистический анализ. Этот анализ может помочь вам решить, нужно ли вам
больше или меньше четности.

Эта команда использует инструмент `smartctl` и эквивалентна запуску
`smartctl -a` на всех устройствах.

Если ваши устройства не обнаруживаются автоматически правильно, вы можете указать
пользовательскую команду, используя опцию `smartctl` в файле
конфигурации.

Ничего не изменяется.

5.3 probe
---------

Печатает состояние POWER всех дисков в системе.

`Standby` означает, что диск не вращается. `Active` означает,
что диск вращается.

Эта команда использует инструмент `smartctl` и эквивалентна запуску
`smartctl -n standby -i` на всех устройствах.

Если ваши устройства не обнаруживаются автоматически правильно, вы можете указать
пользовательскую команду, используя опцию `smartctl` в файле
конфигурации.

Ничего не изменяется.

5.4 up
------

Раскручивает все диски массива.

Вы можете раскрутить только определенные диски, используя опцию -d, --filter-disk.

Раскручивание всех дисков одновременно требует много энергии.
Убедитесь, что ваш блок питания может это выдержать.

Ничего не изменяется.

5.5 down
--------

Останавливает вращение всех дисков массива.

Эта команда использует инструмент `smartctl` и эквивалентна запуску
`smartctl -s standby,now` на всех устройствах.

Вы можете остановить вращение только определенных дисков, используя опцию -d, --filter-disk.

Чтобы автоматически остановить вращение при ошибке, вы можете использовать опцию
-s, --spin-down-on-error с любой другой командой, что эквивалентно
ручному запуску `down` при возникновении ошибки.

Ничего не изменяется.

5.6 diff
--------

Перечисляет все файлы, измененные с момента последнего `sync`, для которых
требуется пересчитать данные четности.

Эта команда не проверяет данные файла, а только метку времени файла,
размер и inode.

После перечисления всех измененных файлов представляется сводка изменений,
сгруппированных по:
    equal - Файлы, не измененные по сравнению с предыдущим состоянием.
    added - Добавленные файлы, которых не было раньше.
    removed - Удаленные файлы.
    updated - Файлы с другим размером или меткой времени, что означает, что они
        были изменены.
    moved - Файлы, перемещенные или переименованные на том же диске с
        сохранением того же inode. Они идентифицируются по совпадению
        inode, размера и метки времени, но имеют другой путь. Имя файла
        также может отличаться.
    copied - файлы, скопированные на тот же или другой диск, где
        исходный файл все еще существует.
        Они идентифицируются по совпадению имени, размера и метки
        времени.
        Если дробная часть метки времени равна нулю, для идентификации
        должен совпадать полный путь, а не только имя.
    relocated - Файлы, перемещенные в другой каталог или на другой диск,
        где исходный файл исчез, а inode не сохранился.
        Они идентифицируются по совпадению имени, размера и метки
        времени. Если дробная часть метки времени равна нулю, для
        идентификации должен совпадать полный путь. В отличие от файлов
        'moved', перемещенные (relocated) файлы требуют, чтобы имя файла
        оставалось прежним.
    restored - файлы с другим inode, но совпадающим каталогом,
        именем, размером и меткой времени.
        Обычно это файлы, восстановленные после удаления.

Если требуется `sync`, код возврата процесса равен 2, а не
по умолчанию 0. Код возврата 1 используется для общего условия ошибки.

Ничего не изменяется.

5.7 sync
--------

Обновляет информацию четности. Все измененные файлы
в дисковом массиве считываются, и соответствующие данные четности
обновляются.

Вы можете остановить этот процесс в любое время, нажав Ctrl+C,
не теряя уже проделанной работы.
При следующем запуске процесс `sync` возобновится с того места,
где был прерван.

Если во время процесса обнаруживаются скрытые ошибки или ошибки ввода/вывода,
соответствующие блоки помечаются как плохие.

Файлы идентифицируются по пути и/или inode и проверяются по
размеру и метке времени.
Если размер файла или метка времени отличаются, данные четности
пересчитываются для всего файла.
Если файл перемещен или переименован на том же диске, сохраняя
тот же inode, четность не пересчитывается.
Если файл перемещен на другой диск, четность пересчитывается,
но ранее вычисленная информация хэша сохраняется.

Файлы `content` и `parity` изменяются при необходимости.
Файлы в массиве НЕ изменяются.

5.8 scrub
---------

Проверяет массив, проверяя на наличие скрытых ошибок или ошибок ввода/вывода
на дисках данных и четности.

Каждый вызов проверяет примерно 8% массива, исключая
данные, уже проверенные за последние 10 дней.
Это означает, что проверка раз в неделю гарантирует, что каждый бит данных
проверяется хотя бы раз в три месяца.

Вы можете определить другой план или объем проверки, используя опцию -p, --plan,
которая принимает:
bad - Проверить блоки, помеченные как плохие.
new - Проверить только что синхронизированные блоки, которые еще не были проверены.
full - Проверить все.
0-100 - Проверить указанный процент блоков.

Если вы указываете процентное значение, вы также можете использовать опцию -o, --older-than,
чтобы определить, насколько старым должен быть блок.
Сначала проверяются самые старые блоки, обеспечивая оптимальную проверку.
Если вы хотите проверить только что синхронизированные блоки, которые еще не были проверены,
используйте опцию `-p new`.

Чтобы получить подробности о статусе проверки, используйте команду `status`.

При обнаружении любой скрытой ошибки или ошибки ввода/вывода соответствующие блоки
помечаются как плохие в файле `content`.
Эти плохие блоки перечисляются в `status` и могут быть исправлены с помощью `fix -e`.
После исправления при следующем scrub они будут перепроверены, и если
обнаружатся исправленными, плохая метка будет удалена.
Чтобы проверить только плохие блоки, вы можете использовать команду `scrub -p bad`.

Рекомендуется запускать `scrub` только на синхронизированном массиве, чтобы избежать
сообщений об ошибках, вызванных несинхронизированными данными. Эти ошибки
распознаются как не являющиеся скрытыми ошибками, и блоки не помечаются
как плохие, но такие ошибки сообщаются в выводе команды.

Файл `content` изменяется для обновления времени последней проверки
для каждого блока и для пометки плохих блоков.
Файлы `parity` НЕ изменяются.
Файлы в массиве НЕ изменяются.

5.9 fix
-------

Восстанавливает все файлы и данные четности.

Все файлы и данные четности сравниваются с состоянием, сохраненным во время
последней синхронизации `sync`. Если обнаружено отличие, оно возвращается к сохраненному состоянию.

ВНИМАНИЕ!
Команда `fix` не делает различий между ошибками и преднамеренными изменениями.
Она безоговорочно возвращает состояние файлов к моменту последней `sync`.

Если не указана другая опция, обрабатывается весь массив.
Используйте опции фильтрации, чтобы выбрать подмножество файлов или дисков для работы.

Чтобы исправить только блоки, помеченные как плохие во время `sync` и `scrub`,
используйте опцию -e, --filter-error.
В отличие от других опций фильтрации, эта применяет исправления только к файлам,
которые не были изменены с момента последнего `sync`.

SnapRAID переименовывает все файлы, которые не могут быть исправлены, добавляя
расширение `.unrecoverable`.

Перед исправлением сканируется весь массив, чтобы найти файлы, перемещенные
с момента последней операции `sync`.
Эти файлы идентифицируются по их метке времени, игнорируя их имя
и каталог, и используются в процессе восстановления при необходимости.
Если вы переместили некоторые из них за пределы массива, вы можете использовать опцию
-i, --import, чтобы указать дополнительные каталоги для сканирования.

Файлы идентифицируются только по пути, а не по inode.

Файл `content` НЕ изменяется.
Файлы `parity` изменяются при необходимости.
Файлы в массиве изменяются при необходимости.

5.10 check
----------

Проверяет все файлы и данные четности.

Он работает как `fix`, но только имитирует восстановление, и никакие изменения
не записываются в массив.

Эта команда в основном предназначена для ручной проверки,
например, после процесса восстановления или в других особых условиях.
Для периодических и запланированных проверок используйте `scrub`.

Если вы используете опцию -a, --audit-only, проверяются только данные
файла, а данные четности игнорируются для
более быстрого выполнения.

Файлы идентифицируются только по пути, а не по inode.

Ничего не изменяется.

5.11 list
---------

Перечисляет все файлы, содержащиеся в массиве на момент
последнего `sync`.

С -v или --verbose также отображается время с точностью до доли секунды.

Ничего не изменяется.

5.12 dup
--------

Перечисляет все дублирующиеся файлы. Два файла считаются равными, если их
хэши совпадают. Данные файла не считываются; используются только
предварительно вычисленные хэши.

Ничего не изменяется.

5.13 pool
---------

Создает или обновляет виртуальное представление всех
файлов в вашем дисковом массиве в каталоге `pooling`.

Файлы не копируются, а связываются с помощью
символических ссылок.

При обновлении все существующие символические ссылки и пустые
подкаталоги удаляются и заменяются новым
представлением массива. Любые другие обычные файлы остаются на месте.

Ничего не изменяется за пределами каталога pool.

5.14 devices
------------

Печатает низкоуровневые устройства, используемые массивом.

Эта команда отображает ассоциации устройств в массиве
и в основном предназначена как интерфейс для скриптов.

Первые два столбца — это низкоуровневый идентификатор устройства и путь.
Следующие два столбца — это высокоуровневый идентификатор устройства и путь.
Последний столбец — это имя диска в массиве.

В большинстве случаев у вас есть одно низкоуровневое устройство для каждого диска в
массиве, но в некоторых более сложных конфигурациях у вас может быть несколько
низкоуровневых устройств, используемых одним диском в массиве.

Ничего не изменяется.

5.15 touch
----------

Устанавливает произвольную метку времени с точностью до доли секунды для всех файлов,
у которых она установлена в ноль.

Это улучшает способность SnapRAID распознавать перемещенные
и скопированные файлы, так как делает метку времени почти уникальной,
уменьшая возможные дубликаты.

Более конкретно, если метка времени с точностью до доли секунды не равна нулю,
перемещенный или скопированный файл идентифицируется как таковой, если он совпадает
по имени, размеру и метке времени. Если метка времени с точностью до доли секунды
равна нулю, он считается копией только в том случае, если полностью совпадают
полный путь, размер и метка времени.

Метка времени с точностью до секунды не изменяется,
поэтому все даты и время ваших файлов будут сохранены.

5.16 rehash
-----------

Планирует перехэширование всего массива.

Эта команда изменяет используемый тип хэша, обычно при обновлении
с 32-разрядной системы на 64-разрядную, для переключения с
MurmurHash3 на более быстрый SpookyHash.

Если вы уже используете оптимальный хэш, эта команда
ничего не делает и информирует вас, что никакие действия не требуются.

Перехэширование не выполняется немедленно, а происходит
постепенно во время `sync` и `scrub`.

Вы можете проверить состояние перехэширования с помощью `status`.

Во время перехэширования SnapRAID сохраняет полную функциональность,
за единственным исключением, что `dup` не может обнаружить дублирующиеся
файлы, использующие другой хэш.

5.17 locate
-----------

Находит файлы, хранящиеся на дисках четности. Для каждого найденного файла
выводится его расположение внутри файла четности и количество занимаемых
им фрагментов.

Вы можете использовать параметр -t, --tail, чтобы ограничить операцию файлами,
занимающими указанную хвостовую часть четности.

Если вы хотите перераспределить эти файлы, вы можете использовать параметр
-W, --force-realloc-tail.
Имейте в виду, что такие файлы не будут защищены четностью во время процесса
перераспределения.


6 Параметры (OPTIONS)
=====================

SnapRAID предоставляет следующие опции:

    -c, --conf CONFIG
        Выбирает файл конфигурации для использования. Если не указан, в Unix
        используется файл `/usr/local/etc/snapraid.conf`, если он существует,
        в противном случае `/etc/snapraid.conf`.
        В Windows используется файл `snapraid.conf` в том же
        каталоге, что и `snapraid.exe`.

    -f, --filter PATTERN
        Фильтрует файлы для обработки в `check` и `fix`.
        Обрабатываются только файлы, соответствующие указанному шаблону.
        Эту опцию можно использовать несколько раз.
        Подробнее о спецификациях шаблонов см. в разделе PATTERN.
        В Unix убедитесь, что символы глоббинга заключены в кавычки, если используются.
        Эту опцию можно использовать только с `check` и `fix`.
        Ее нельзя использовать с `sync` и `scrub`, так как они всегда
        обрабатывают весь массив.

    -d, --filter-disk NAME
        Фильтрует диски для обработки в `check`, `fix`, `up` и `down`.
        Вы должны указать имя диска, определенное в файле конфигурации.
        Вы также можете указать диски четности с именами: `parity`, `2-parity`,
        `3-parity` и т. д., чтобы ограничить операции конкретным диском четности.
        Если вы комбинируете несколько опций --filter, --filter-disk и --filter-missing,
        выбираются только файлы, соответствующие всем фильтрам.
        Эту опцию можно использовать несколько раз.
        Эту опцию можно использовать только с `check`, `fix`, `up` и `down`.
        Ее нельзя использовать с `sync` и `scrub`, так как они всегда
        обрабатывают весь массив.

    -m, --filter-missing
        Фильтрует файлы для обработки в `check` и `fix`.
        Обрабатываются только файлы, отсутствующие или удаленные из массива.
        При использовании с `fix`, это действует как команда `undelete`.
        Если вы комбинируете несколько опций --filter, --filter-disk и --filter-missing,
        выбираются только файлы, соответствующие всем фильтрам.
        Эту опцию можно использовать только с `check` и `fix`.
        Ее нельзя использовать с `sync` и `scrub`, так как они всегда
        обрабатывают весь массив.

    -e, --filter-error
        Обрабатывает файлы с ошибками в `check` и `fix`.
        Он обрабатывает только файлы, блоки которых помечены скрытыми
        ошибками или ошибками ввода/вывода во время `sync` и `scrub`, как
        перечислено в `status`.
        Эту опцию можно использовать только с `check` и `fix`.

    -p, --plan PERC|bad|new|full
        Выбирает план проверки (`scrub`). Если PERC — это числовое значение от 0 до 100,
        оно интерпретируется как процент блоков для проверки.
        Вместо процента вы можете указать план:
        `bad` проверяет плохие блоки, `new` проверяет блоки, которые еще не были проверены,
        и `full` проверяет все.
        Эту опцию можно использовать только с `scrub`.

    -o, --older-than DAYS
        Выбирает самую старую часть массива для обработки в `scrub`.
        DAYS — это минимальный возраст в днях для блока, который будет проверен;
        по умолчанию — 10.
        Блоки, помеченные как плохие, всегда проверяются независимо от этой опции.
        Эту опцию можно использовать только с `scrub`.

    -a, --audit-only
        В `check`, проверяет хэш файлов без
        проверки данных четности.
        Если вы заинтересованы только в проверке данных файла, эта
        опция может значительно ускорить процесс проверки.
        Эту опцию можно использовать только с `check`.

    -h, --pre-hash
        В `sync`, запускает предварительную фазу хэширования всех новых данных
        для дополнительной проверки перед вычислением четности.
        Обычно в `sync` предварительное хэширование не выполняется, и новые
        данные хэшируются непосредственно перед вычислением четности, когда они
        считываются в первый раз.
        Этот процесс происходит, когда система находится под
        тяжелой нагрузкой, со всеми вращающимися дисками и занятым процессором.
        Это экстремальное условие для машины, и если у нее есть
        скрытая аппаратная проблема, скрытые ошибки могут остаться незамеченными,
        потому что данные еще не хэшированы.
        Чтобы избежать этого риска, вы можете включить режим `pre-hash`, чтобы
        все данные считывались дважды для обеспечения их целостности.
        Эта опция также проверяет файлы, перемещенные внутри массива,
        чтобы убедиться, что операция перемещения прошла успешно, и, при необходимости,
        позволяет запустить операцию исправления (`fix`) перед продолжением.
        Эту опцию можно использовать только с `sync`.

    -i, --import DIR
        Импортирует из указанного каталога любые файлы, удаленные
        из массива после последнего `sync`.
        Если у вас все еще есть такие файлы, они могут использоваться `check`
        и `fix` для улучшения процесса восстановления.
        Файлы считываются, включая подкаталоги, и идентифицируются
        независимо от их имени.
        Эту опцию можно использовать только с `check` и `fix`.

    -s, --spin-down-on-error
        При любой ошибке останавливает вращение всех управляемых дисков перед выходом с
        ненулевым кодом состояния. Это предотвращает оставление дисков
        активными и вращающимися после прерванной операции,
        помогая избежать ненужного нагрева и энергопотребления.
        Используйте эту опцию, чтобы гарантировать безопасную остановку дисков,
        даже когда команда завершается неудачей.

    -w, --bw-limit RATE
        Применяет глобальное ограничение пропускной способности для всех дисков. RATE — это
        количество байтов в секунду. Вы можете указать множитель,
        например K, M, G или T (например, --bw-limit 1G).

    -t, --tail SIZE
        Ограничивает список файлов теми, которые используют не более
        указанного размера хвоста дисков четности.
        Можно использовать множители, такие как K, M, G или T (например, --tail 1G).
        Этот параметр действителен только при использовании вместе с
        командой `locate`.

    -A, --stats
        Включает расширенный вид статуса, который показывает дополнительную информацию.
        На экране отображаются два графика:
        Первый график показывает количество буферизованных полос для каждого
        диска, а также путь к файлу, к которому в данный момент осуществляется
        доступ на этом диске. Обычно самый медленный диск не будет иметь
        доступного буфера, что определяет максимально достижимую
        пропускную способность.
        Второй график показывает процент времени, потраченного на ожидание
        за последние 100 секунд. Ожидается, что самый медленный диск
        вызовет большую часть времени ожидания, в то время как другие диски должны
        иметь мало или совсем не иметь времени ожидания, потому что они могут
        использовать свои буферизованные полосы.
        Этот график также показывает время, потраченное на ожидание
        вычислений хэша и вычислений RAID.
        Все вычисления выполняются параллельно с дисковыми операциями.
        Следовательно, пока есть измеримое время ожидания для
        хотя бы одного диска, это указывает на то, что ЦП достаточно быстр, чтобы
        справляться с рабочей нагрузкой.

    -Z, --force-zero
        Форсирует небезопасную операцию синхронизации файла с нулевым
        размером, который ранее был ненулевым.
        Если SnapRAID обнаруживает такое условие, он прекращает выполнение,
        если вы не укажете эту опцию.
        Это позволяет легко обнаружить, когда после сбоя системы
        некоторые доступные файлы были усечены.
        Это возможное условие в Linux с файловыми системами ext3/ext4.
        Эту опцию можно использовать только с `sync`.

    -E, --force-empty
        Форсирует небезопасную операцию синхронизации диска, на котором
        отсутствуют все исходные файлы.
        Если SnapRAID обнаруживает, что все файлы, изначально присутствующие
        на диске, отсутствуют или перезаписаны, он прекращает выполнение,
        если вы не укажете эту опцию.
        Это позволяет легко обнаружить, когда файловая система данных не
        смонтирована.
        Эту опцию можно использовать только с `sync`.

    -U, --force-uuid
        Форсирует небезопасную операцию синхронизации, проверки и исправления
        с дисками, у которых изменился UUID.
        Если SnapRAID обнаруживает, что у некоторых дисков изменился UUID,
        он прекращает выполнение, если вы не укажете эту опцию.
        Это позволяет обнаружить, когда ваши диски смонтированы в
        неправильных точках монтирования.
        Однако допускается однократное изменение UUID с
        одиночной четностью, и больше с множественной четностью, потому что это
        нормальный случай при замене дисков после восстановления.
        Эту опцию можно использовать только с `sync`, `check` или
        `fix`.

    -D, --force-device
        Форсирует небезопасную операцию исправления с недоступными дисками
        или с дисками на том же физическом устройстве.
        Например, если вы потеряли два диска данных и у вас есть запасной диск для восстановления
        только первого, вы можете игнорировать второй недоступный диск.
        Или, если вы хотите восстановить диск в свободное место, оставшееся на
        уже используемом диске, совместно использующем то же физическое устройство.
        Эту опцию можно использовать только с `fix`.

    -N, --force-nocopy
        В `sync`, `check` и `fix`, отключает эвристику обнаружения копирования.
        Без этой опции SnapRAID предполагает, что файлы с одинаковыми
        атрибутами, такими как имя, размер и метка времени, являются копиями с
        одинаковыми данными.
        Это позволяет идентифицировать скопированные или перемещенные файлы с одного диска
        на другой и повторно использовать уже вычисленную информацию хэша
        для обнаружения скрытых ошибок или восстановления отсутствующих файлов.
        В некоторых редких случаях это поведение может привести к ложным срабатываниям
        или замедлению процесса из-за большого количества проверок хэша, и эта
        опция позволяет решить такие проблемы.
        Эту опцию можно использовать только с `sync`, `check` и `fix`.

    -F, --force-full
        В `sync`, форсирует полный пересчет четности.
        Эту опцию можно использовать, когда вы добавляете новый уровень четности или если
        вы вернулись к старому файлу content, используя более свежие данные четности.
        Вместо того чтобы воссоздавать четность с нуля, это позволяет
        повторно использовать хэши, присутствующие в файле content, для проверки данных
        и поддержания защиты данных во время процесса `sync` с использованием
        существующих данных четности.
        Эту опцию можно использовать только с `sync`.

    -R, --force-realloc
        В `sync`, форсирует полное перераспределение файлов и перестроение четности.
        Эту опцию можно использовать для полного перераспределения всех файлов,
        удаления фрагментации, при этом повторно используя хэши, присутствующие в файле content,
        для проверки данных.
        Эту опцию можно использовать только с `sync`.
        ВНИМАНИЕ! Эта опция предназначена только для экспертов, и
        настоятельно не рекомендуется ее использовать.
        У вас НЕТ защиты данных во время операции `sync`.

    -W, --force-realloc-tail SIZE
        Работает как -R, --force-realloc, но ограничивается указанной хвостовой
        частью (последние SIZE байт) каждого файла четности.
        Принудительно перераспределяет (перемещает) любые фрагменты/блоки файлов,
        хранящиеся в данный момент в этой хвостовой части, позволяя разместить
        их в любом месте файла(ов) четности, где есть свободное место
        (включая существующие пустоты).
        Основная цель этого параметра — уменьшить занимаемый на диске
        размер файла четности.
        Если перераспределение успешно очистит всю хвостовую часть
        (в ней не останется блоков), файл четности будет обрезан, высвобождая
        неиспользуемое хвостовое пространство.
        Можно использовать множители, такие как K, M, G или T (например,
        --force-realloc-tail 1G).
        Вы можете использовать locate -t, --tail, чтобы заранее узнать
        затронутые файлы.
        ВНИМАНИЕ!
        Этот параметр предназначен только для экспертов, и его настоятельно
        не рекомендуется использовать.
        Во время операции `sync` защита данных для затронутых файлов
        ОТСУТСТВУЕТ.

    -l, --log FILE
        Записывает подробный журнал в указанный файл.
        Если эта опция не указана, непредвиденные ошибки выводятся
        на экран, что потенциально может привести к чрезмерному выводу в случае
        множества ошибок. Когда указана -l, --log, на
        экран выводятся только фатальные ошибки, которые приводят к остановке
        SnapRAID.
        Если путь начинается с `>>`, файл открывается
        в режиме добавления. Вхождения `%D` и `%T` в имени
        заменяются датой и временем в формате ГГГГММДД и
        ЧЧММСС. В пакетных файлах Windows вы должны удвоить
        символ `%`, например, result-%%D.log. Чтобы использовать `>>`, вы должны
        заключить имя в кавычки, например, `">>result.log"`.
        Для вывода журнала на стандартный вывод или стандартную ошибку,
        вы можете использовать `">&1"` и `">&2"` соответственно.
        Описание тегов журнала см. в файле snapraid_log.txt или man-странице.

    -L, --error-limit NUMBER
        Устанавливает новый лимит ошибок до остановки выполнения.
        По умолчанию SnapRAID останавливается, если обнаруживает более 100
        ошибок ввода/вывода, что указывает на вероятный сбой диска.
        Эта опция влияет на `sync` и `scrub`, которым разрешено
        продолжать работу после первого набора дисковых ошибок, чтобы попытаться
        завершить свои операции.
        Однако `check` и `fix` всегда останавливаются при первой ошибке.

    -S, --start BLKSTART
        Начинает обработку с указанного
        номера блока. Это может быть полезно для повторной попытки проверить
        или исправить конкретные блоки в случае поврежденного диска.
        Эта опция в основном предназначена для расширенного ручного восстановления
        и поддерживается только командами `check` и `fix`.

    -B, --count BLKCOUNT
        Обрабатывает только указанное количество блоков.
        Эта опция в основном предназначена для расширенного ручного восстановления
        и поддерживается только командами `check` и `fix`.

    -C, --gen-conf CONTENT
        Генерирует фиктивный файл конфигурации из существующего
        файла content.
        Файл конфигурации записывается на стандартный вывод
        и не перезаписывает существующий.
        Этот файл конфигурации также содержит информацию,
        необходимую для восстановления точек монтирования дисков в случае, если вы
        потеряете всю систему.

    -v, --verbose
        Печатает больше информации на экран.
        Если указана один раз, печатает исключенные файлы
        и дополнительную статистику.
        Эта опция не влияет на файлы журнала.

    -q, --quiet
        Печатает меньше информации на экран.
        Если указана один раз, удаляет индикатор выполнения; дважды,
        текущие операции; трижды, информационные
        сообщения; четырежды, сообщения о статусе.
        Фатальные ошибки всегда выводятся на экран.
        Эта опция не влияет на файлы журнала.

    -H, --help
        Печатает краткий экран справки.

    -V, --version
        Печатает версию программы.


7 Конфигурация (CONFIGURATION)
==============================

SnapRAID требует файл конфигурации, чтобы знать, где находится ваш дисковый массив
и где хранить информацию четности.

В Unix используется файл `/usr/local/etc/snapraid.conf`, если он существует,
в противном случае `/etc/snapraid.conf`.
В Windows используется файл `snapraid.conf` в том же
каталоге, что и `snapraid.exe`.

Он должен содержать следующие опции (чувствительные к регистру):

7.1 parity FILE [,FILE] ...
---------------------------

Определяет файлы для использования для хранения информации четности.
Четность обеспечивает защиту от одного сбоя диска,
подобно RAID5.

Вы можете указать несколько файлов, которые должны быть на разных дисках.
Когда файл больше не может расти, используется следующий.
Общее доступное пространство должно быть по крайней мере таким же большим, как самый большой диск данных в
массиве.

Вы можете добавить дополнительные файлы четности позже, но вы
не можете переупорядочить или удалить их.

Сохранение дисков четности зарезервированными для четности гарантирует, что
они не станут фрагментированными, улучшая производительность.

В Windows 256 МБ остается неиспользованным на каждом диске, чтобы избежать
предупреждения о полных дисках.

Эта опция является обязательной и может использоваться только один раз.

7.2 (2,3,4,5,6)-parity FILE [,FILE] ...
---------------------------------------

Определяет файлы для использования для хранения дополнительной информации четности.

Для каждого указанного уровня четности включается один дополнительный уровень защиты:

* 2-parity включает двойную четность RAID6.
* 3-parity включает тройную четность.
* 4-parity включает четверную четность.
* 5-parity включает пятерную четность.
* 6-parity включает шестерную четность.

Каждый уровень четности требует наличия всех предыдущих уровней четности.

Применяются те же соображения, что и для опции `parity`.

Эти опции являются необязательными и могут использоваться только один раз.

7.3 z-parity FILE [,FILE] ...
-----------------------------

Определяет альтернативный файл и формат для хранения тройной четности.

Эта опция является альтернативой `3-parity`, в основном предназначенной для
слабых процессоров, таких как ARM или AMD Phenom, Athlon и Opteron,
которые не поддерживают набор инструкций SSSE3. В таких случаях она
обеспечивает лучшую производительность.

Этот формат похож на тот, который используется ZFS RAIDZ3, но быстрее.
Как и ZFS, он не работает за пределами тройной четности.

При использовании `3-parity` вы будете предупреждены, если рекомендуется использовать
формат `z-parity` для повышения производительности.

Возможно преобразование из одного формата в другой путем настройки
файла конфигурации с желаемым файлом z-parity или 3-parity
и использования `fix` для его воссоздания.

7.4 content FILE
----------------

Определяет файл для использования для хранения списка и контрольных сумм всех
файлов, присутствующих в вашем дисковом массиве.

Он может быть размещен на диске, используемом для данных, четности, или
любом другом доступном диске.
Если вы используете диск данных, этот файл автоматически исключается
из процесса `sync`.

Эта опция является обязательной и может использоваться несколько раз для сохранения
нескольких копий одного и того же файла.

Вы должны хранить как минимум одну копию для каждого используемого диска четности
плюс одну. Использование дополнительных копий не повредит.

7.5 data NAME DIR
-----------------

Определяет имя и точку монтирования дисков данных в
массиве. NAME используется для идентификации диска и должно
быть уникальным. DIR — это точка монтирования диска в
файловой системе.

Вы можете изменять точку монтирования по мере необходимости, пока вы
сохраняете NAME фиксированным.

Однако настроенный путь должен постоянно указывать на те же
базовые данные. Если путь содержит символические ссылки,
их целевые объекты должны оставаться неизменными. Перенаправление
таких ссылок для смены каталога данных на лету не поддерживается.

Вы должны использовать одну опцию для каждого диска данных в массиве.

Вы можете переименовать диск позже, изменив NAME непосредственно
в файле конфигурации, а затем запустив команду `sync`.
В случае переименования, ассоциация выполняется с использованием сохраненного
UUID дисков.

7.6 extra NAME DIR
------------------

Определяет имя и точку монтирования дополнительных дисков для
мониторинга с помощью команд `smart` и `probe`.

Это полезно для мониторинга дисков, которые не являются частью
массива, но необходимы для функционирования системы, таких как
загрузочный диск.

Обратите внимание, что такие диски не затрагиваются командами `up` и
`down`, так как предполагается, что они всегда вращаются.

7.7 snapshot
------------

Включает использование снимков файловой системы для команд `sync`, `scrub`,
`check` и `fix`.

Если опция включена, SnapRAID создает снимок только для чтения каждой поддерживаемой
файловой системы данных в начале операции 'sync'. Это обеспечивает стабильный срез
каждой файловой системы, предотвращая изменение данных, используемых для вычисления
четности, последующими модификациями.

Это значительно улучшает восстановление: если файл удаляется из живой файловой системы,
он остается сохраненным в снимке. Это предотвращает «нарушение» четности
для этого блока, гарантируя, что вы все еще сможете успешно восстановить данные
в случае сбоя другого диска.

Эта опция применяется исключительно к дискам с данными, отформатированным в файловых
системах Btrfs, Bcachefs или ZFS в Linux и NTFS в Windows.
Диски четности или диски с данными, использующие другие файловые системы, всегда будут использовать
живую версию файловой системы.

Создание и удаление снимков требуют прав администратора.
Убедитесь, что SnapRAID запущен с необходимыми привилегиями (например, sudo), когда
включена эта опция.

Подробное объяснение жизненного цикла снимков см. в разделе SNAPSHOTS.

7.8 nohidden
------------

Исключает все скрытые файлы и каталоги.
В Unix скрытые файлы — это те, которые начинаются с `.`.
В Windows — это те, у которых есть скрытый атрибут.

7.9 exclude/include PATTERN
---------------------------

Определяет шаблоны файлов или каталогов для исключения или включения
в процесс синхронизации.
Все шаблоны обрабатываются в указанном порядке.

Если первый совпадающий шаблон — это `exclude`, файл
исключается. Если это `include`, файл включается.
Если ни один шаблон не совпадает, файл исключается, если последний
указанный шаблон — это `include`, или включается, если последний шаблон
— это `exclude`.

Обратите внимание, что фильтрация выполняется иерархически во время
обхода каталогов. Если каталог совпадает с правилом `exclude`, весь
каталог пропускается (отсекается), и любые правила `include` для
файлов или подкаталогов внутри него не будут оцениваться.

Подробнее о спецификациях шаблонов см. в разделе PATTERN.

Эту опцию можно использовать несколько раз.

7.10 blocksize SIZE_IN_KIBIBYTES
--------------------------------

Определяет базовый размер блока в кибибайтах для четности.
Один кибибайт — это 1024 байта.

Размер блока по умолчанию — 256, что должно работать в большинстве случаев.

ВНИМАНИЕ! Эта опция предназначена только для экспертов, и
настоятельно не рекомендуется изменять это значение. Чтобы изменить это значение в
будущем, вам потребуется воссоздать всю четность!

Причина использовать другой размер блока — если у вас много маленьких
файлов, порядка миллионов.

Для каждого файла, даже если всего несколько байтов, выделяется целый блок четности,
и при большом количестве файлов это может привести к значительным неиспользуемым
пространствам четности.
Когда вы полностью заполните диск четности, вам не будет
разрешено добавлять больше файлов на диски данных.
Однако потерянная четность не накапливается на дисках данных. Потерянное пространство,
возникающее из-за большого числа файлов на диске данных, ограничивает только
объем данных на этом диске данных, а не на других.

В качестве приближения вы можете предположить, что половина размера блока
теряется для каждого файла. Например, при 100 000 файлов и размере блока 256 КиБ
вы потеряете 12,8 ГБ четности, что может привести к
уменьшению доступного пространства на диске данных на 12,8 ГБ.

Вы можете проверить количество потерянного пространства на каждом диске с помощью `status`.
Это количество пространства, которое вы должны оставить свободным на дисках
данных или использовать для файлов, не включенных в массив.
Если это значение отрицательное, это означает, что вы близки к заполнению
четности, и оно представляет пространство, которое вы все еще можете потерять.

Чтобы избежать этой проблемы, вы можете использовать больший раздел для четности.
Например, если раздел четности на 12,8 ГБ больше, чем диски данных,
у вас есть достаточно дополнительного пространства для обработки до 100 000
файлов на каждом диске данных без каких-либо потерь пространства.

Хитрость для получения большего раздела четности в Linux — отформатировать его
командой:

    mkfs.ext4 -m 0 -T largefile4 DEVICE

Это приводит к примерно 1,5% дополнительного пространства, приблизительно 60 ГБ для
диска 4 ТБ, что позволяет разместить около 460 000 файлов на каждом диске данных без
каких-либо потерь пространства.

7.11 hashsize SIZE_IN_BYTES
---------------------------

Определяет размер хэша в байтах для сохраненных блоков.

Размер хэша по умолчанию — 16 байт (128 бит), что должно работать
в большинстве случаев.

ВНИМАНИЕ! Эта опция предназначена только для экспертов, и
настоятельно не рекомендуется изменять это значение. Чтобы изменить это значение в
будущем, вам потребуется воссоздать всю четность!

Причина использовать другой размер хэша — если ваша система имеет
ограниченную память. Как правило, SnapRAID обычно требует
1 ГиБ ОЗУ на каждые 16 ТБ данных в массиве.

В частности, для хранения хэшей данных SnapRAID требует
приблизительно TS*(1+HS)/BS байт ОЗУ,
где TS — это общий размер в байтах вашего дискового массива, BS —
размер блока в байтах, и HS — размер хэша в байтах.

Например, при 8 дисках по 4 ТБ, размере блока 256 КиБ
(1 КиБ = 1024 байта) и размере хэша 16, вы получаете:

RAM = (8 * 4 * 10^12) * (1+16) / (256 * 2^10) = 1.93 GiB

Переключение на размер хэша 8, вы получаете:

RAM = (8 * 4 * 10^12) * (1+8) / (256 * 2^10) = 1.02 GiB

Переключение на размер блока 512, вы получаете:

RAM = (8 * 4 * 10^12) * (1+16) / (512 * 2^10) = 0.96 GiB

Переключение как на размер хэша 8, так и на размер блока 512, вы получаете:

RAM = (8 * 4 * 10^12) * (1+8) / (512 * 2^10) = 0.51 GiB

7.12 autosave SIZE_IN_GIGABYTES
-------------------------------

Автоматически сохраняет состояние при синхронизации или проверке после
обработки указанного количества ГБ.
Эта опция полезна, чтобы избежать перезапуска длительных команд `sync`
с нуля, если они были прерваны сбоем машины или любым другим событием.

7.13 temp_limit TEMPERATURE_CELSIUS
-----------------------------------

Устанавливает максимально допустимую температуру диска в Цельсиях. Если указано,
SnapRAID периодически проверяет температуру всех дисков с помощью
инструмента smartctl. Текущие температуры дисков отображаются во время
работы SnapRAID. Если какой-либо диск превышает этот лимит, все операции
останавливаются, и диски останавливают вращение (переходят в режим ожидания) на время,
определенное опцией `temp_sleep`. После периода ожидания операции
возобновляются, потенциально снова приостанавливаясь, если лимит температуры
достигается еще раз.

Во время работы SnapRAID также анализирует кривую нагрева каждого
диска и оценивает долгосрочную установившуюся температуру, которую они,
как ожидается, достигнут, если активность продолжится. Оценка выполняется
только после того, как температура диска увеличилась четыре раза,
что гарантирует наличие достаточного количества данных для установления
надежной тенденции.
Эта прогнозируемая установившаяся температура показывается в скобках рядом с
текущим значением и помогает оценить, достаточно ли
охлаждение системы. Эта оценочная температура предназначена только
для информации и не влияет на поведение SnapRAID. Действия программы
основываются исключительно на фактических измеренных температурах дисков.

Для выполнения этого анализа SnapRAID требуется эталон для температуры
системы. Сначала он пытается прочитать его из доступных аппаратных
датчиков. Если ни один системный датчик не может быть доступен, он использует
самую низкую температуру диска, измеренную в начале выполнения, в качестве
резервного эталона.

Обычно SnapRAID показывает только температуру самого горячего диска.
Чтобы отобразить температуру всех дисков, используйте опцию -A или --stats.

7.14 temp_sleep TIME_IN_MINUTES
-------------------------------

Устанавливает время ожидания, в минутах, когда достигается предел температуры.
В течение этого периода диски остаются остановленными. По умолчанию — 5 минут.

7.15 pool DIR
-------------

Определяет каталог объединения (pooling), где создается виртуальное представление
дискового массива с помощью команды `pool`.

Каталог должен уже существовать.

7.16 share UNC_DIR
------------------

Определяет путь UNC Windows, необходимый для удаленного доступа к дискам.

Если указана эта опция, символические ссылки, созданные в каталоге pool,
используют этот путь UNC для доступа к дискам.
Без этой опции сгенерированные символические ссылки используют только локальные пути,
что не позволяет предоставлять общий доступ к каталогу pool по сети.

Символические ссылки формируются с использованием указанного пути UNC, добавлением
имени диска, как указано в опции `data`, и, наконец, добавлением
каталога и имени файла.

Эта опция требуется только для Windows.

7.17 smartctl DISK/PARITY OPTIONS...
------------------------------------

Определяет пользовательские опции smartctl для получения атрибутов SMART для
каждого диска. Это может потребоваться для контроллеров RAID и некоторых USB-дисков,
которые не могут быть обнаружены автоматически. Заполнитель %s заменяется
именем устройства, но он необязателен для фиксированных устройств, таких как
контроллеры RAID.

DISK — это то же имя диска, указанное в опции `data`.
PARITY — это одно из имен четности: `parity`, `2-parity`, `3-parity`,
`4-parity`, `5-parity`, `6-parity` или `z-parity`.

В указанных OPTIONS строка `%s` заменяется
именем устройства. Для контроллеров RAID устройство,
вероятно, фиксировано, и вам может не потребоваться использовать `%s`.

Вы также можете указать пользовательскую строку параметров информации с помощью
тега `[info: ...]`, чтобы заменить параметр по умолчанию `-a`.

Возможные опции см. в документации smartmontools:

    https://www.smartmontools.org/wiki/Supported_RAID-Controllers
    https://www.smartmontools.org/wiki/Supported_USB-Devices

Например:

    smartctl d1 [info: -H -i -c -A] -d sat %s
    smartctl parity -d sat %s

7.18 smartignore DISK/PARITY ATTR [ATTR...]
-------------------------------------------

Игнорирует указанный атрибут SMART при вычислении вероятности
сбоя диска. Эта опция полезна, если диск сообщает необычные или
вводящие в заблуждение значения для конкретного атрибута.

DISK — это то же имя диска, указанное в опции `data`.
PARITY — это одно из имен четности: `parity`, `2-parity`, `3-parity`,
`4-parity`, `5-parity`, `6-parity` или `z-parity`.
Специальное значение * может использоваться для игнорирования атрибута на всех дисках.

Можно указать несколько атрибутов, разделенных пробелами.
Каждый атрибут может быть указан как число от 1 до 255 или как имя,
нечувствительное к регистру (например, `Current_Pending_Sector`).

Например, чтобы игнорировать атрибуты `Current Pending Sector Count` и
`Reallocated Sectors Count` на всех дисках по их номеру или имени:

    smartignore * 197 5
    smartignore * Current_Pending_Sector Reallocated_Sector_Ct

Чтобы игнорировать их только на первом диске четности:

    smartignore parity 197 5

7.19 Примеры (Examples)
-----------------------

Пример типичной конфигурации для Unix:

    parity /mnt/diskp/snapraid.parity
    content /mnt/diskp/snapraid.content
    content /var/snapraid/snapraid.content
    data d1 /mnt/disk1/
    data d2 /mnt/disk2/
    data d3 /mnt/disk3/
    exclude /lost+found/
    exclude /tmp/
    smartctl d1 [info: -H -i -c -A] -d sat %s
    smartctl d2 -d usbjmicron %s
    smartctl parity -d areca,1/1 /dev/sg0
    smartctl 2-parity -d areca,2/1 /dev/sg0

Пример типичной конфигурации для Windows:

    parity E:\snapraid.parity
    content E:\snapraid.content
    content C:\snapraid\snapraid.content
    data d1 G:\array\
    data d2 H:\array\
    data d3 I:\array\
    exclude Thumbs.db
    exclude \$RECYCLE.BIN
    exclude \System Volume Information
    smartctl d1 [info: -H -i -c -A] -d sat %s
    smartctl d2 -d usbjmicron %s
    smartctl parity -d areca,1/1 /dev/arcmsr0
    smartctl 2-parity -d areca,2/1 /dev/arcmsr0


8 Снимки (SNAPSHOTS)
====================

Если в конфигурации включена опция снимков, SnapRAID использует снимки
файловой системы для сохранения стабильности данных, считываемых во время
операции, даже если файлы в живых файловых системах впоследствии изменяются
или удаляются.

Управление снимками происходит полностью автоматически и прозрачно.
Вы можете продолжать использовать SnapRAID точно так же, как и раньше, получая
дополнительную защиту, обеспечиваемую снимками, которые полностью обрабатываются в
фоновом режиме.

Это дает два основных преимущества:

Согласованность — Файлы, измененные в живой файловой системе во время длительного
    процесса sync или scrub, не вызовут несоответствия четности или прерывания
    операций, поскольку каждая файловая система со снимком остается неизменной
    на протяжении всей операции.
Восстановление — Если файл обновляется или удаляется из живой файловой системы,
    он остается сохраненным в снимке. Если сбой диска произойдет
    до запуска следующей синхронизации sync, SnapRAID использует данные, сохраненные
    в снимке, для реконструкции отказавшего диска.

    В случае сбоя диска во время активного процесса sync,
    SnapRAID также может автоматически читать как из снимка предыдущего
    вычисления четности, так и из текущего.
    Это максимизирует вероятность полного восстановления, предоставляя
    доступ к точным блокам данных, необходимым для решения уравнений четности,
    даже если эти блоки были изменены или удалены между синхронизациями.

    Без снимков обновленный или удаленный файл на исправном диске
    приводит к отсутствию блоков данных, которые могут потребоваться для
    восстановления других отказавших дисков.

Снимки создаются только для дисков с данными и только в том случае, если базовая
файловая система поддерживает эту функциональность. Диски четности всегда используют
живую файловую систему.

В настоящее время это поддерживается на Btrfs, Bcachefs и ZFS в Linux
и на NTFS в Windows.

Вы можете комбинировать диски с данными с различными файловыми системами. Только те из них,
которые поддерживают снимки, будут использовать их, в то время как другие диски продолжат
работать напрямую с живой файловой системой.

Создание и удаление снимков требуют прав администратора.
Убедитесь, что SnapRAID запущен с необходимыми привилегиями (например, sudo),
когда снимки включены.

8.1 Поведение команд при использовании снимков
----------------------------------------------

Команды `sync` и `scrub` используют снимки для дисков с данными, чьи
файловые системы их поддерживают. На диске со снимком команда видит
стабильный образ файловой системы, не затронутый одновременными изменениями
в живой файловой системе.
Во время `sync` новый снимок создается независимо для каждой поддерживаемой
файловой системы данных. Эти снимки в совокупности предоставляют данные,
используемые для вычисления четности.
Напротив, команда `scrub` использует последний снимок, созданный во время
самой последней синхронизации, чтобы поддерживать надежную точку отсчета,
соответствующую существующей четности.

Для команд `check` и `fix` использование последнего снимка
зависит от того, нацелены ли конкретные диски с помощью опции
-d, --filter-disk.

Диск, явно выбранный с помощью -d («цель» операции),
всегда использует живую файловую систему. Для `fix` это позволяет восстановить
данные на активную замену диска. Для `check` это позволяет симулировать
операцию `fix` при тех же условиях.

Доступ ко всем остальным дискам с данными («справочным» дискам) будет осуществляться через
их снимки. Это гарантирует, что даже если вы изменяете файлы
на своих исправных дисках во время восстановления, SnapRAID
имеет стабильную, замороженную точку отсчета для решения уравнений четности.

Если опция -d не предоставлена, SnapRAID предполагает, что операция применяется
ко всему массиву; в этом случае `check` и `fix` будут использовать исключительно
живые файловые системы.

Все остальные команды работают исключительно с живой файловой системой.


9 Жизненный цикл снимков (SNAPSHOTS LIFECYCLE)
==============================================

SnapRAID управляет тремя конкретными снимками, `stable`, `pending` и `scan`,
внутри скрытого каталога в корне каждого подтома данных.
В Btrfs, Bcachefs и NTFS используется каталог `.snapraid/`,
в ZFS — стандартный `.zfs/snapshot/`.

Снимок `stable` представляет собой состояние последней успешно
завершенной синхронизации `sync`, содержащей точные данные, использованные для
вычисления текущей четности. Он служит основным источником данных
для команд `scrub`, `check` и `fix`.

Снимок `scan` — это временный образ, создаваемый в начале
`sync` для обеспечения замороженного состояния для сканирования и вычисления четности.
После сканирования и сохранения нового состояния содержимого он заменяет предыдущий
снимок `pending`.

Снимок `pending` — это образ, используемый прерванной синхронизацией `sync`.
После успешного завершения операции предыдущий снимок `stable`
удаляется, а снимок `pending` повышается в статусе, чтобы
занять его место в качестве нового стабильного ориентира.

Если процесс `sync` прерывается, снимок `pending` сохраняется.
Последующие команды `scrub`, `check` и `fix` будут использовать этот
ожидающий снимок, так как он соответствует состоянию файловой системы, записанному в
файле .content, даже если четность синхронизирована лишь частично.

В случае прерывания `sync` команды `check` и `fix`
также читают данные из снимка `stable` для извлечения блоков данных
из файлов, которые были обновлены или удалены во время синхронизации.
Это возможно потому, что файл .content сохраняет метаданные для
всех измененных или удаленных файлов на протяжении всего процесса sync.
Эта историческая информация очищается только после успешного завершения sync
и сохранения финальной версии файла .content.

Если `sync` перезапускается после прерывания, существующий
ожидающий (pending) снимок удаляется, и создается новый для
фиксации текущего состояния живой файловой системы.
Однако, если `sync` был прерван, избегайте изменения, удаления,
замены или перемещения файлов до тех пор, пока последующий `sync` не завершится
успешно. Четность все еще может содержать блоки, вычисленные на основе снимка,
использованного прерванной синхронизацией. Более поздняя синхронизация может
заменить этот снимок, сделав промежуточные версии файлов недоступными для
восстановления.

9.1 Внешнее резервное копирование со снимками файловой системы (External backups with filesystem snapshots)
-----------------------------------------------------------------------------------------------------------

Когда снимки файловой системы включены, SnapRAID обращается к снимкам или
создает их в корне каждого подтома, тома или набора данных (dataset).

Простой способ избежать любых конфликтов со сторонними инструментами —
указать в директиве `data` обычный подкаталог внутри подтома или тома
(например, `/mnt/subvol/data` вместо `/mnt/subvol`). SnapRAID всегда
создает каталог снимков в корне подтома (например,
`/mnt/subvol/.snapraid/`), оставив подкаталог данных чистым, благодаря
чему снимки останутся снаружи и будут невидимы для программ резервного
копирования, работающих внутри него.

В противном случае, если настроенный каталог `data` сам по себе является
корнем подтома или тома, SnapRAID создает каталог `.snapraid/` прямо внутри
него (в Btrfs, Bcachefs и NTFS). Хотя SnapRAID автоматически исключает этот
каталог из собственного сканирования, внешние утилиты резервного
копирования или синхронизации файлов обнаружат его. Если каталог не
исключен, они могут войти в снимки или ссылки на каталоги и скопировать
все замороженное дерево данных, дублируя файлы и исчерпывая место в
хранилище резервных копий. Всегда настраивайте внешние утилиты резервного
копирования на исключение каталога `.snapraid/`.

В ZFS снимки доступны через стандартный виртуальный каталог
`.zfs/snapshot/`, а не через `.snapraid/`. По умолчанию (`snapdir=hidden`)
ZFS скрывает этот каталог из списков директорий, поэтому внешние утилиты
резервного копирования не будут сканировать его. Если вы включили
`snapdir=visible`, обязательно настройте утилиты резервного копирования на
исключение каталога `.zfs/`.


10 Шаблон (PATTERN)
===================

Шаблоны обеспечивают гибкий способ фильтрации файлов для включения или
исключения. Используя символы подстановки (globbing), вы можете определить правила,
которые соответствуют конкретным именам файлов или целым структурам каталогов без
ручного перечисления каждого пути.

Вопросительный знак `?` соответствует любому одиночному символу, кроме
разделителя каталогов. Это делает его полезным для сопоставления имен файлов с
переменными символами, при этом шаблон ограничивается одним уровнем каталога.

Одиночная звездочка `*` соответствует любой последовательности символов, но, как и
вопросительный знак, она никогда не пересекает границы каталогов. Она останавливается на
прямой косой черте, что делает ее подходящей для сопоставления внутри одного
компонента пути. Это стандартное поведение подстановочных знаков, знакомое
по оболочке (shell).

Символ подстановки двойная звездочка `**` сопоставляется через разделители
каталогов только тогда, когда он примыкает к разделителю каталогов (перед ним
или после него стоит косая черта). В этой форме он соответствует нулю или
более символам на нескольких уровнях каталогов. Например, `foo/**/bar`
соответствует `foo/bar`, `foo/a/bar` и `foo/a/b/bar`; `**/build` соответствует
`build` и `foo/bar/build`; а `src/**.js` соответствует `src/main.js` и
`src/ui/components/main.js`.
Автономная форма `/**/` не принимается в качестве полного шаблона.

Когда `**` не примыкает к косой черте, он ведет себя как `*` и не
соответствует разделителям каталогов. Например, `**.jpg` соответствует
`photo.jpg` в текущем каталоге, но не соответствует `dir/photo.jpg`. Для этой
цели используйте `**/*.jpg`.

Классы символов с использованием квадратных скобок `[]` соответствуют одному символу из
заданного набора или диапазона. Как и другие односимвольные шаблоны, они
не соответствуют разделителям каталогов. Классы поддерживают диапазоны и отрицание с
использованием восклицательного знака.

Фундаментальное различие, которое следует помнить, заключается в том, что `*`, `?` и классы
символов соблюдают границы каталогов и соответствуют только внутри одного
компонента пути, в то время как `**` может соответствовать через разделители
каталогов только тогда, когда примыкает к косой черте.

Существует четыре различных типа шаблонов:

    FILE
        Выбирает любой файл с именем FILE.
        Этот шаблон применяется только к файлам, но не к директориям.

    DIR/
        Выбирает любую директорию с именем DIR и все, что находится внутри нее.
        Этот шаблон применяется только к директориям, но не к файлам.

    /PATH/FILE
        Выбирает точно указанный путь к файлу. Этот шаблон применяется
        только к файлам, но не к директориям.

    /PATH/DIR/
        Выбирает точно указанный путь к директории и все, что находится
        внутри нее. Этот шаблон применяется только к директориям, но не к файлам.

Когда вы указываете абсолютный путь, начинающийся с /, он применяется к
корневому каталогу массива, а не к корневому каталогу локальной файловой системы.

В Windows вы можете использовать обратную косую черту \ вместо прямой /.
Системные каталоги Windows, точки соединения, точки монтирования и другие
специальные каталоги Windows рассматриваются как файлы, что означает, что для их
исключения вы должны использовать правило файла, а не каталога.

Если имя файла содержит символы `*`, `?`, `[`,
или `]`, вы должны экранировать их, чтобы избежать их интерпретации как
символов глоббинга. В Unix символом экранирования является `\`; в Windows — `^`.
Когда шаблон находится в командной строке, вы должны удвоить символ
экранирования, чтобы избежать его интерпретации командной оболочкой.

В файле конфигурации вы можете использовать различные стратегии для фильтрации
файлов для обработки.
Самый простой подход — использовать только правила `exclude` для удаления всех
файлов и каталогов, которые вы не хотите обрабатывать. Например:

    # Исключает любой файл с именем `*.unrecoverable`
    exclude *.unrecoverable
    # Исключает корневой каталог `/lost+found`
    exclude /lost+found/
    # Исключает любой подкаталог с именем `tmp`
    exclude tmp/

Противоположный подход — определить только файлы, которые вы хотите обрабатывать, используя
только правила `include`. Например:

    # Включает только некоторые каталоги
    include /movies/
    include /musics/
    include /pictures/

Конечный подход — смешивать правила `exclude` и `include`. В этом случае
порядок правил важен. Более ранние правила имеют
преимущество над более поздними.
Для упрощения вы можете сначала перечислить все правила `exclude`, а затем
все правила `include`. Например:

    # Исключает любой файл с именем `*.unrecoverable`
    exclude *.unrecoverable
    # Исключает любой подкаталог с именем `tmp`
    exclude tmp/
    # Включает только некоторые каталоги
    include /movies/
    include /musics/
    include /pictures/

Обратите внимание, что исключение каталога (с помощью DIR/ или /PATH/DIR/)
предотвращает вход SnapRAID в этот каталог и его сканирование.
Следовательно, невозможно повторно включить файл или подкаталог,
находящийся внутри исключенного родительского каталога, поскольку сканер
никогда не переходит в него.

Например, следующая конфигурация НЕ включит `file.dat`, поскольку
`/keep/` отсекается до того, как `file.dat` сможет быть проверен:

    # НЕ работает как ожидается: /keep/ полностью пропускается
    include /keep/file.dat
    exclude /keep/

Чтобы исключить файлы внутри каталога, сохранив определенные файлы,
исключайте шаблон файлов внутри каталога, а не сам каталог:

    # Работает: /keep/ сканируется, но остальные файлы внутри него исключаются
    include /keep/file.dat
    exclude /keep/*

В командной строке, используя опцию -f, вы можете использовать только шаблоны `include`.
Например:

    # Проверяет только файлы .mp3.
    # В Unix используйте кавычки, чтобы избежать расширения глоббинга оболочкой.
    snapraid -f "*.mp3" check

В Unix при использовании символов глоббинга в командной строке вы должны
заключить их в кавычки, чтобы предотвратить их расширение оболочкой.


11 Файл исключений (IGNORE FILE)
================================

В дополнение к глобальным правилам в файле конфигурации, вы можете
размещать файлы `.snapraidignore` в любом каталоге внутри массива для
определения децентрализованных правил исключения.

Правила, определенные в `.snapraidignore`, применяются после правил в
конфигурационном файле. Это означает, что они имеют более высокий приоритет
и могут использоваться для исключения файлов, которые ранее были включены
глобальной конфигурацией. Фактически, если локальное правило совпадает, файл
исключается независимо от глобальных настроек включения.

Логика шаблонов в `.snapraidignore` повторяет глобальную конфигурацию, но
привязывает шаблоны к каталогу, в котором находится файл:

    FILE
        Выбирает любой файл с именем FILE в этом каталоге или ниже.
        Здесь действуют те же правила подстановки, что и в глобальном шаблоне.

    DIR/
        Выбирает любой каталог с именем DIR и все его содержимое,
        находящееся в этом каталоге или ниже.

    /PATH/FILE
        Выбирает точно указанный файл относительно местоположения
        файла `.snapraidignore`.

    /PATH/DIR/
        Выбирает точно указанный каталог и все его содержимое
        относительно местоположения файла `.snapraidignore`.

В отличие от глобальной конфигурации, файлы `.snapraidignore` поддерживают
только правила исключения; вы не можете использовать шаблоны `include` или отрицание (!).

Например, если у вас есть `.snapraidignore` в `/mnt/disk1/projects/`:

    # Исключает ТОЛЬКО /mnt/disk1/projects/output.bin
    /output.bin
    # Исключает любой каталог с именем `build` внутри projects/
    build/
    # Исключает любой .tmp файл внутри projects/ или его подпапок
    *.tmp


12 Содержимое (CONTENT)
=======================

SnapRAID хранит список и контрольные суммы ваших файлов в файле content.

Это бинарный файл, который перечисляет все файлы, присутствующие в вашем дисковом массиве,
вместе со всеми контрольными суммами для проверки их целостности.

Файл content считывается и записывается командами `sync`, `scrub`,
`touch` и `rehash`. Он считывается командами `status`, `diff`, `check`,
`fix`, `list`, `dup`, `locate` и `pool`, и полностью игнорируется
командами `smart`, `probe`, `up`, `down` и `devices`.


13 Четность (PARITY)
====================

SnapRAID хранит информацию четности вашего массива в файлах parity.

Это бинарные файлы, содержащие вычисленную четность всех
блоков, определенных в файле `content`.

Эти файлы считываются и записываются командами `sync` и `fix` и
только считываются командами `scrub` и `check`.


14 Кодировка (ENCODING)
=======================

SnapRAID в Unix игнорирует любое кодирование. Он считывает и хранит
имена файлов с тем же кодированием, которое используется файловой системой.

В Windows все имена, считанные из файловой системы, преобразуются и
обрабатываются в формате UTF-8.

Чтобы имена файлов печатались правильно, вы должны установить консоль Windows
в режим UTF-8 командой `chcp 65001` и использовать
шрифт TrueType, такой как `Lucida Console`, в качестве шрифта консоли.
Это влияет только на печатаемые имена файлов; если вы
перенаправляете вывод консоли в файл, результирующий файл всегда
в формате UTF-8.


15 Код возврата (EXIT CODE)
===========================

SnapRAID завершает работу со следующими кодами ошибок:

0 - Все в порядке.
1 - Команда обнаружила ошибки.
2 - Команда `diff` определила, что все в порядке, но требуется `sync`.
3 - Команда дискового устройства (`probe`, `smart`, `devices`, `up`,
    `down`) завершена, но по крайней мере одна файловая система работает
    в деградированном режиме с отсутствующими устройствами.


16 Известные проблемы (KNOWN ISSUES)
====================================

16.1 Границы файловой системы
-----------------------------

SnapRAID не пересекает границы файловых систем, точек монтирования или
подтомов при сканировании диска данных. При обнаружении такой границы
SnapRAID сообщает ПРЕДУПРЕЖДЕНИЕ и не выполняет сканирование за ее пределами.

Файлы, расположенные за такими границами, не включаются в диск данных и
должны настраиваться отдельно, если их необходимо защитить.

16.2 Точки монтирования со снимками файловой системы
----------------------------------------------------

Когда снимки файловой системы включены, вложенные точки монтирования и
bind-монтирования внутри диска данных не поддерживаются.

Точки монтирования являются частью пространства имен монтирования работающей
системы и не сохраняются в снимках файловой системы. Следовательно, при
сканировании снимка каталог, скрытый точкой монтирования в активной файловой
системе, может стать видимым.

Не размещайте вложенные точки монтирования или bind-монтирования внутри дисков
данных, когда включены снимки файловой системы.

16.3 Несколько конфигураций со снимками файловой системы
--------------------------------------------------------

Поддержка снимков не может безопасно совместно использоваться несколькими
независимыми конфигурациями SnapRAID, использующими одно и то же
пространство имен снимков файловой системы.

В Btrfs и Bcachefs только одна конфигурация SnapRAID с включенной поддержкой
снимков может использовать каталоги данных в пределах одного и того же
подтома. В ZFS то же ограничение применяется к датасету, а в NTFS — к тому.

Несколько конфигураций, использующих одно и то же пространство имен снимков,
работают с одними и теми же снимками `stable`, `pending` и `scan`. Запуск
одной конфигурации может перезаписать или удалить снимки восстановления,
необходимые другой.

16.4 Изменения файлов на месте без изменения временных меток
------------------------------------------------------------

SnapRAID обнаруживает изменения файлов путем сравнения размеров файлов и
временных меток модификации (mtime).

Если приложение изменяет файл на месте без изменения его размера или
обновления временной метки модификации, "diff" и "sync" не обнаружат
изменение файла, и его четность не будет обновлена.

Чтобы SnapRAID гарантированно распознал такие изменения, обновите временную
метку модификации файла (например, с помощью утилиты "touch"). В противном
случае различие будет обнаружено только как несоответствие хэша во время
последующего "scrub" или "check".

16.5 Сопоставление регистра символов non-ASCII в Windows
--------------------------------------------------------

SnapRAID использует стандартную, предсказуемую кодировку UTF-8 на всех
платформах, ограничивая нечувствительное к регистру сопоставление символами
ASCII.

Файловые системы Windows страдают от устаревшего архитектурного решения,
навязывающего нечувствительность к регистру для имен файлов Unicode с помощью
произвольных, зависящих от системы таблиц сопоставления. В результате Windows
искажает реальность файловой системы, обрабатывая совершенно разные
последовательности байтов Unicode так, как если бы они были одним и тем же
файлом.

Например, `À.txt` и `à.txt` — это разные имена Unicode, однако Windows
нелогично считает их идентичными, тогда как SnapRAID сохраняет их подлинное
различие.

Это ограничение вызвано непоследовательной обработкой имен файлов Unicode в
Windows и ее упорным стремлением к псевдонимизации без учета регистра. Чтобы
предотвратить расхождения, возникающие из-за преобразования регистра в Windows,
всегда указывайте точный регистр для любых символов non-ASCII в путях
конфигурации и фильтрах.

16.6 Восстановление с частичным fix
-----------------------------------

Когда `fix` ограничен с помощью `-S, --start` или `-B, --count`,
SnapRAID работает только с выбранными блоками и не выполняет финализацию
на уровне файлов или помещение в карантин.

Если в результате восстановления получаются данные наилучшей попытки (best-effort),
для которых нельзя доказать, что они соответствуют текущему содержимому, такие
блоки все равно могут быть записаны под обычным именем файла. Неопределенность,
связанная с этими восстановленными блоками, не сохраняется после завершения команды.

Как следствие, последующий `fix` будет рассматривать эти читаемые блоки как
корректные данные файла и не попытается восстановить их снова. Это может привести
к тому, что последующее восстановление сообщит об успехе, оставив в файле
неполные или устаревшие данные.

Параметры `-S` и `-B` предназначены только для расширенного ручного
восстановления, обычно после сбоя обычного `fix`. Если частичный `fix` сообщает
о невосстановимых данных, удалите или переименуйте затронутые файлы перед
попыткой повторного восстановления либо проверьте их содержимое вручную.

16.7 Жесткие ссылки NTFS и исключенные пути
-------------------------------------------

В NTFS записи каталогов кэшируют размер файла и временные метки независимо
для каждой жесткой ссылки. Когда файл изменяется через одну ссылку, записи
каталогов других ссылок, указывающих на тот же файл, могут сохранять
устаревшие метаданные до тех пор, пока к ним не будет осуществлен доступ.

SnapRAID автоматически обнаруживает и нормализует это состояние всякий
раз, когда во время сканирования обнаруживаются как минимум две жесткие
ссылки на один и тот же файл. Однако если сканируется только одна жесткая
ссылка, тогда как другие исключены фильтрами или находятся за пределами
пути диска данных, SnapRAID не может обнаружить коллизию inode и полагается
на кэшированные метаданные единственной видимой ссылки.

Следовательно, изменения, внесенные через исключенную или внешнюю жесткую
ссылку, могут остаться незамеченными SnapRAID до тех пор, пока метаданные
включенной ссылки не будут обновлены операционной системой (например,
когда к файлу обращаются или открывают его по этому пути).

Чтобы избежать этого ограничения, не изменяйте защищенные файлы через
жесткие ссылки, исключенные из SnapRAID, либо убедитесь, что все жесткие
ссылки на файл включены в сканирование, чтобы SnapRAID мог их нормализовать.

16.8 Восстановление после прерванного sync с несколькими четностями
-------------------------------------------------------------------

В массиве с несколькими дисками четности прерванный `sync` может оставить
уровни четности временно рассинхронизированными относительно друг друга.
Например, четность 1 уже может содержать обновленные данные, тогда как
четность 2 все еще содержит старые данные.

Во время выполнения `check` или `fix` SnapRAID проверяет различные
комбинации четностей и проверяет восстановленные данные по известным
хэшам блоков (охватывающим блок целиком, обычно 256 КиБ).

Если SnapRAID пытается выполнить восстановление, используя
несогласованную смесь старой и новой четности, линейные уравнения RAID
дадут некорректные данные. Чтобы такая недействительная комбинация была
ошибочно принята, уравнения должны были бы случайно восстановить хотя бы
один полный блок размером 256 КиБ настолько идеально, чтобы его хэш
совпал, тогда как другие несинхронизированные блоки в том же страйпе
будут восстановлены с ошибочными данными.

Этот сценарий не зависит от коллизии хэшей; напротив, сами уравнения
смешанной четности должны были бы случайно воспроизвести точное исходное
содержимое 256-КиБ блока. Хотя это математически возможно при специально
подготовленных или сильно повторяющихся данных, на реальных данных это
практически невозможно.

Если все диски исправны, завершение прерванного `sync` перед внесением
дальнейших изменений устраняет эту неоднозначность. Если диск вышел из
строя и требуется восстановление, избегайте изменения дисков данных перед
запуском `check` или `fix`.

16.9 Зарезервированные имена файлов и каталогов
-----------------------------------------------

SnapRAID резервирует некоторые имена файлов, каталогов и снимков для
своих внутренних операций. Не используйте эти имена для пользовательских
данных:

.snapraidignore - Локальный файл правил исключения.
.snapraid - Каталог-контейнер снимков.
snapraid-* - Имена снимков ZFS, управляемых SnapRAID.
*.unrecoverable - Поврежденные файлы, помещенные в карантин во время
    восстановления.
CONTENT.tmp - Временный файл для обновлений файла content.
CONTENT.lock - Файл блокировки файла content.
PARITY.spaceholder - Временный файл резервирования места при выделении
    четности в Windows.

Использование этих имен для несвязанных данных может привести к тому,
что файлы или снимки будут проигнорированы, ошибочно приняты за метаданные,
перезаписаны, переименованы или удалены.

В Windows все варианты регистра также зарезервированы, даже в каталогах
NTFS, настроенных с учетом регистра (например, .SNAPRAIDIGNORE, .SnapRaid,
CONTENT.TMP и CONTENT.Lock).


17 Перевод (TRANSLATION)
========================

Этот документ является автоматическим переводом английского руководства.
Обратитесь к английскому руководству за официальной версией.


18 Авторские права (COPYRIGHT)
==============================

Этот файл защищен авторским правом (C) 2026 Andrea Mazzoleni


19 См. также (SEE ALSO)
=======================

snapraid_log(1), snapraidd(1), rsync(1)