Project Chimera
Меню

Исходники

225 строк · 12 КиБ

code/crates/chl-wine/examples/reg_patch_diff.rs

1//! Проверка боем: применяет `.reg`-патч двумя способами — прямой записью
2//! (`Prefix::apply_reg_patch_direct`, см. `chl_wine::registry`) и настоящим
3//! `regedit.exe` внутри Wine (`Prefix::apply_reg_patch`) — каждый на своей
4//! свежей `--reflink=auto`-копии одного и того же эталонного префикса.
5//!
6//! Печатает две вещи для каждого ключа, который патч реально трогает:
7//! содержимое этого ключа после прямой записи и после `regedit.exe` —
8//! **это и есть настоящая проверка**, а не общий diff всего файла. Общий
9//! diff тоже печатается (для информации), но его нельзя использовать как
10//! критерий: `regedit.exe` — это настоящий процесс Wine, и один его запуск
11//! попутно гоняет `wineboot`-хозяйство (сброс `PendingFileRenameOperations`,
12//! досоздание отсутствующих служебных ключей типа `RunServices` и т.п.) —
13//! шум, никак не связанный с патчем и не воспроизводимый прямой записью
14//! именно потому, что она не поднимает процесс Wine вообще. Игнорировать
15//! этот шум в общем diff — не натяжка, а ровно то, ради чего вообще
16//! стоило переходить на прямую запись.
17//!
18//! Это ручной инструмент для разового (и, если формат патчей когда-нибудь
19//! изменится, повторного) обоснования прямой записи реестра — см.
20//! `ROADMAP.md`, пункт «Запись в реестр напрямую, без запуска regedit в
21//! префиксе», и заголовок `chl_wine::registry`.
22//!
23//! **Безопасность**: копирует эталонный префикс, сам его не трогает.
24//! `<каталог-для-копий>` должен быть отдельным пустым (или неважным)
25//! каталогом — сюда пишутся `<имя-патча>/direct/` и `<имя-патча>/regedit/`.
26//!
27//! **Важно про identity префикса**: у `system.reg`/`user.reg` есть
28//! встроенный SID пользователя (см. заголовок `chl_wine::registry`), и
29//! `regedit.exe` при старте (через `wineboot`) сверяет его с текущим
30//! `$USER`/UID. Если несовпадение — Wine молча заводит НОВЫЙ профиль
31//! пользователя поверх старого, что выглядит как гигантский посторонний
32//! diff, не имеющий отношения к патчу. Поэтому `<эталонный-префикс>`
33//! должен быть создан `wineboot` в ТОЙ ЖЕ среде (тот же `$USER`/окружение),
34//! в которой будет запущен этот инструмент — не бери для этого боевой
35//! префикс игрока, если не уверен, что среда совпадает.
36//!
37//! Использование:
38//! ```text
39//! cargo run --release -p chl-wine --example reg_patch_diff -- \
40//! <эталонный-префикс> <wine-loader> <каталог-для-копий> <патч.reg> [ещё патчи...]
41//! ```
42use std::collections::BTreeMap;
43use std::path::{Path, PathBuf};
44use std::process::Command;
45
46use anyhow::{Context, Result, bail};
47use chl_wine::prefix::Prefix;
48use chl_wine::registry::{self, Hive};
49
50fn reflink_copy(from: &Path, to: &Path) -> Result<()> {
51 if let Some(parent) = to.parent() {
52 std::fs::create_dir_all(parent).ok();
53 }
54 if to.exists() {
55 std::fs::remove_dir_all(to).with_context(|| format!("не удаляется старое {}", to.display()))?;
56 }
57 let status = Command::new("cp")
58 .args(["-a", "--reflink=auto"])
59 .arg(from)
60 .arg(to)
61 .status()
62 .context("не запускается cp")?;
63 if !status.success() {
64 bail!("cp завершился с ошибкой: {} -> {}", from.display(), to.display());
65 }
66 Ok(())
67}
68
69/// Убирает то, что легитимно отличается между двумя независимыми записями
70/// одного и того же ключа: `#time=` (Windows FILETIME записи) и число
71/// после заголовка ключа (тот же момент, но в секундах Unix) — оба просто
72/// «когда это в последний раз записали», не часть смысла патча.
73fn normalize(content: &str) -> String {
74 content
75 .lines()
76 .map(|line| {
77 if line.starts_with("#time=") {
78 "#time=T".to_string()
79 } else if line.starts_with('[') {
80 match line.rfind(']') {
81 Some(idx) => format!("{}] T", &line[..idx]),
82 None => line.to_string(),
83 }
84 } else {
85 line.to_string()
86 }
87 })
88 .collect::<Vec<_>>()
89 .join("\n")
90}
91
92fn main() -> Result<()> {
93 let args: Vec<String> = std::env::args().collect();
94 if args.len() < 5 {
95 bail!(
96 "использование: {} <эталонный-префикс> <wine-loader> <каталог-для-копий> <патч.reg> [ещё патчи...]",
97 args[0]
98 );
99 }
100 let base = PathBuf::from(&args[1]);
101 let wine_loader = PathBuf::from(&args[2]);
102 let work = PathBuf::from(&args[3]);
103 let patches = &args[4..];
104
105 if !base.join("system.reg").is_file() {
106 bail!("{} не похож на префикс — нет system.reg", base.display());
107 }
108 std::fs::create_dir_all(&work)?;
109 let env: BTreeMap<String, String> = BTreeMap::new();
110
111 let mut any_key_mismatch = false;
112 for patch_str in patches {
113 let patch = Path::new(patch_str);
114 let stem = patch.file_stem().and_then(|s| s.to_str()).unwrap_or("patch");
115 println!("=== {} ===", patch.display());
116
117 let patch_bytes = std::fs::read(patch).with_context(|| format!("не читается {}", patch.display()))?;
118 let parsed = registry::parse_reg_patch(&patch_bytes)
119 .with_context(|| format!("не разобран {}", patch.display()))?;
120
121 let direct_dir = work.join(stem).join("direct");
122 let regedit_dir = work.join(stem).join("regedit");
123 reflink_copy(&base, &direct_dir)?;
124 reflink_copy(&base, &regedit_dir)?;
125
126 let direct_pfx = Prefix::new(&direct_dir);
127 let regedit_pfx = Prefix::new(&regedit_dir);
128
129 direct_pfx
130 .apply_reg_patch_direct(patch)
131 .with_context(|| format!("прямая запись: {}", patch.display()))?;
132 regedit_pfx
133 .apply_reg_patch(&wine_loader, &env, patch)
134 .with_context(|| format!("regedit.exe: {}", patch.display()))?;
135
136 // 1) Целевая проверка: содержимое КАЖДОГО ключа, который патч
137 // реально трогает, должно совпасть (без учёта времени записи).
138 for section in &parsed.sections {
139 let file_name = match section.hive {
140 Hive::LocalMachine => "system.reg",
141 Hive::CurrentUser => "user.reg",
142 };
143 let direct_content = std::fs::read_to_string(direct_dir.join(file_name))?;
144 let regedit_content = std::fs::read_to_string(regedit_dir.join(file_name))?;
145
146 let direct_block = registry::extract_key_block(&direct_content, &section.path)?;
147 let regedit_block = registry::extract_key_block(&regedit_content, &section.path)?;
148
149 let label = if section.delete_key {
150 format!("[-{}]", section.path)
151 } else {
152 format!("[{}]", section.path)
153 };
154
155 // Сравниваем не текст, а разобранные значения, отсортированные
156 // по имени: у regedit.exe и порядок значений внутри ключа, и
157 // иногда сама запись (`str(2):` вместо `hex(2):` для одного и
158 // того же REG_EXPAND_SZ) не совпадают с тем, что пишет прямая
159 // запись, — оставаясь при этом тем же самым значением. Текстовый
160 // diff на этом бы соврал.
161 let parsed_values = |block: &Option<String>| -> Result<Option<Vec<(String, registry::RegValue)>>> {
162 match block {
163 None => Ok(None),
164 Some(b) => {
165 let mut v = registry::parse_block_values(b)?;
166 v.sort_by_key(|a| a.0.to_lowercase());
167 Ok(Some(v))
168 }
169 }
170 };
171 let direct_values = parsed_values(&direct_block)?;
172 let regedit_values = parsed_values(&regedit_block)?;
173
174 match (direct_values, regedit_values) {
175 (None, None) => println!(" {label}: ключа нет ни там, ни там (согласуется с удалением)"),
176 (Some(a), Some(b)) if a == b => {
177 println!(" {label}: совпадает (значения и содержимое идентичны, без учёта порядка/записи типа)")
178 }
179 (a, b) => {
180 any_key_mismatch = true;
181 println!(" {label}: РАСХОЖДЕНИЕ В САМОМ ПАТЧЕННОМ КЛЮЧЕ");
182 println!(" direct: {a:?}");
183 println!(" regedit: {b:?}");
184 }
185 }
186 }
187
188 // 2) Общий diff файла — для информации, не для вердикта (см. шапку
189 // файла: regedit.exe тянет за собой шум wineboot).
190 for name in ["system.reg", "user.reg"] {
191 let a = normalize(&std::fs::read_to_string(direct_dir.join(name))?);
192 let b = normalize(&std::fs::read_to_string(regedit_dir.join(name))?);
193 if a == b {
194 continue;
195 }
196 let ta = work.join(stem).join(format!("norm-direct-{name}"));
197 let tb = work.join(stem).join(format!("norm-regedit-{name}"));
198 std::fs::write(&ta, &a)?;
199 std::fs::write(&tb, &b)?;
200 let diff = Command::new("diff")
201 .args(["-u", "--label", "direct", "--label", "regedit"])
202 .arg(&ta)
203 .arg(&tb)
204 .output()?;
205 let diff_lines = String::from_utf8_lossy(&diff.stdout).lines().count();
206 println!(
207 " ({name}: общий diff файла — {diff_lines} строк, ожидаемо из-за wineboot-хозяйства \
208 внутри regedit.exe; полный текст: {})",
209 ta.with_file_name(format!("full-diff-{name}.txt")).display()
210 );
211 std::fs::write(
212 ta.with_file_name(format!("full-diff-{name}.txt")),
213 &diff.stdout,
214 )?;
215 }
216 }
217
218 if any_key_mismatch {
219 println!("\nЕсть расхождение в содержимом хотя бы одного патченного ключа — смотри выше.");
220 std::process::exit(1);
221 }
222 println!("\nВсе патченные ключи: прямая запись и regedit.exe дали одинаковый результат.");
223 Ok(())
224}
225