MOffice

Windows: безопасное сохранение и метаданные

8 октября 2026. Сессия 1, фаза B; нативная приёмка Windows остаётся NOT_RUN. Реализация находится в meridian-file-platform; meridian-core сохраняет #![forbid(unsafe_code)]. Внешние зависимости не добавлены.

Результат и порядок записи

Запись готовит отдельный файл в том же каталоге и меняет документ одной операцией после сериализации, переноса метаданных, синхронизации и повторной проверки назначения. Ошибка переноса возвращается вызывающему; исходник остаётся на месте, интерфейс сохраняет правки и предлагает отдельную копию. Разделение жёстких ссылок обычным Save запрещено.

  1. Удержать исходный дескриптор с правами чтения/записи; проверить read-only, число ссылок, неподдерживаемые file attributes и доступную protection policy.
  2. Создать CREATE_NEW с защищённой DACL текущего эффективного пользователя. Descriptor передаётся в CreateFileW: унаследованный читатель не получает доступ до первой записи. Приватность дополнительно читается обратно; требуется FILE_PERSISTENT_ACLS.
  3. Записать основной поток. Из исходного дескриптора перечислить ADS, проверить имена, размеры и identity открытого stream; перенести данные на удерживаемый pending handle.
  4. Восстановить creation time и обычные атрибуты, owner/group, DACL и доступный mandatory integrity label. Проверить SID, порядок ACE, protection и полный набор named streams. Mtime относится к новому сохранению. Ошибка чтения не заменяется пустой ACL/списком.
  5. Синхронизировать потоки и основной файл, выполнить проверку конфликта вызывающего, повторно проверить текущий target и удерживаемый original на read-only/hard links.
  6. Закрыть original и вызвать SetFileInformationByHandle(FileRenameInfo) для открытого pending объекта. Подмена его прежнего имени не подменяет устанавливаемые байты.
  7. После успеха пометить guard committed. При отказе/unwind пометить собственный pending handle FileDispositionInfo до закрытия. Созданное право DELETE сохраняется у handle после переноса DACL, запрещающей новое открытие для удаления.

Протокол общего MOffice lock остаётся обязательным. Другой процесс, игнорирующий lock, может изменить target после последней проверки; перенос на held handle закрывает именно подмену источника commit, а не все гонки назначения/каталога.

Почему ADS записываются через handle

Повторное CREATE_NEW по pending:stream могло бы создать поток у файла, которым другой процесс заменил временное имя. BackupWrite с BACKUP_ALTERNATE_DATA адресует наш открытый pending handle; bProcessSecurity=FALSE не восстанавливает чужую ACL и не включает privileges. Оpaque context закрывается на каждом завершении/отказе. Заголовок сериализуется как 20 bytes без C tail padding; длина UTF-16 указана в bytes. Основной поток документа в него не попадает.

Пакеты ограничены 64 КиБ данных; короткие данные включаются в первый header/name packet, остаток следующих пакетов не бывает короче 33 bytes. Это соблюдает требование размера буфера BackupWrite больше WIN32_STREAM_ID. Данные читаются до заявленного размера; ранний EOF, рост, ошибка flush и изменение inventory прерывают сохранение.

Имена сохраняются как UTF-16, включая unpaired surrogates. Проверяются offsets/alignment, нулевые и нечётные длины, переполнения, отрицательные размеры, дубликаты, разделители и stream type. Inventory ограничен 1 МиБ; потоковые данные этим пределом не обрезаются. Пустой source inventory принимается только при пустом destination inventory и повторной проверке source. Неудачная enumeration считается пустой лишь когда volume flags доказывают отсутствие поддержки named streams.

Права и системные структуры

Проверяется эффективный thread token; при отсутствии impersonation используется свой process token. Запрашивается только TOKEN_QUERY; привилегии и чужие tokens не меняются. SID/ACL storage, security descriptors и handles имеют отдельные RAII lifetimes. Все raw вызовы содержат комментарии о размере, alignment, владении и времени жизни аргументов.

FILE_ID_INFO сравнивает volume и полный 128-bit ID исходника/ADS. FILE_RENAME_INFO использует classic class 3, null RootDirectory и counted absolute UTF-16 path. FILE_DISPOSITION_INFO.DeleteFile — однобайтовый BOOLEAN, не четырёхбайтовый BOOL. Для ACL сравниваются содержательные ACE, а не свободные байты выделенного ACL buffer.

Owner/group изменяются только если SID отличаются. DACL передаётся с protected/unprotected policy и читается обратно после возможного пересчёта inheritance. Настоящая NULL DACL источника сохраняется как таковая; ошибка чтения никогда не превращается в NULL DACL. Mandatory label запрашивается отдельно от привилегированного audit SACL. Обнаруженный SE_SACL_PROTECTED приводит к отказу: его перенос требует отдельного права и приёмки.

Проверки и оставшаяся приёмка

Разработка проверена на macOS: 47 core + 6 portable stream-parser tests PASS. Строгий cargo clippy --all-targets --locked -- -D warnings для изменённых крейтов прошёл на Windows GNU и MSVC через изолированный официальный Rust std 1.99.0 sysroot. Эти команды проверяют compilation, включая native-test source; Windows-процессы не запускались.

Portable regressions проверяют повреждённые/truncated записи, UTF-16 без потерь, default/named/empty/large streams, packed header, overflow и packet boundaries. Общие core-тесты проверяют hard link, появившийся после сериализации, в final validation и у ранее отсутствовавшего target. На Windows также подготовлены независимые fixtures:

Нужен настоящий Windows NTFS host для выполнения этих fixtures и проверки ABI/runtime. Успешный перенос отличающегося owner, protected mandatory label, audit ACL и metadata failure после частичного переноса требуют отдельных нативных доказательств. API self-check, GNU/MSVC compilation и Linux/macOS результаты не закрывают эти требования.

Необходимы дальнейшие протоколы и проверки для network/FAT/ReFS, EFS/compression/sparse/cloud attributes, привилегированной security policy, extended attributes, power loss и полной подмены destination/directory. Текущий adapter явно отказывает при неподдерживаемых flags или отсутствии проверяемой приватности. Полная фаза B и общий выпуск остаются открытыми.

Основания API