Every source file in ui, app, game, formats, cli, audio and launch that had none now starts with a short English comment: what it implements, what state it owns and how it relates to its neighbours (request/acknowledge flow, pairs of files, random generator use). Comment lines only; the full build and the runnable tests are unchanged. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
59 lines
1.9 KiB
C++
59 lines
1.9 KiB
C++
// SPDX-License-Identifier: GPL-3.0-only
|
|
// Implementation of the .FBM savegame container (fbm.hpp): fbm_encrypt()/fbm_decrypt() are the
|
|
// stream cipher whose key changes by 0x29 per byte, and load_savegame() finds the "KRON_FBM"
|
|
// magic, splits the plain header from the encrypted stream, decrypts it and verifies the
|
|
// one-byte checksum, which is reported in Savegame::checksum_ok (not thrown). The decrypted
|
|
// stream is interpreted by savestate.cpp. Pure functions, no state.
|
|
#include "formats/fbm.hpp"
|
|
|
|
#include <algorithm>
|
|
#include <cstring>
|
|
|
|
namespace bmh {
|
|
|
|
void fbm_decrypt(uint8_t* data, size_t n, uint8_t key) {
|
|
for (size_t i = 0; i < n; i++) {
|
|
data[i] = uint8_t((data[i] - key) ^ key);
|
|
key = uint8_t(key - 0x29);
|
|
}
|
|
}
|
|
|
|
void fbm_encrypt(uint8_t* data, size_t n, uint8_t key) {
|
|
for (size_t i = 0; i < n; i++) {
|
|
data[i] = uint8_t((data[i] ^ key) + key);
|
|
key = uint8_t(key - 0x29);
|
|
}
|
|
}
|
|
|
|
Savegame load_savegame(const std::filesystem::path& path) {
|
|
Bytes d = read_file(path);
|
|
static const char magic[] = "KRON_FBM";
|
|
auto it = std::search(d.begin(), d.end(), magic, magic + 8);
|
|
if (it == d.end()) throw FormatError("FBM: magic KRON_FBM not found");
|
|
size_t m = size_t(it - d.begin());
|
|
if (m + 26 > d.size()) throw FormatError("FBM: truncated header");
|
|
|
|
Savegame s;
|
|
s.plain_header.assign(d.begin(), it);
|
|
size_t p = m + 10; // "KRON_FBM\0" + 1 byte
|
|
s.id1 = le32(d, p);
|
|
p += 4;
|
|
s.version.assign(reinterpret_cast<const char*>(&d[p]), strnlen(reinterpret_cast<const char*>(&d[p]), 6));
|
|
p += 6;
|
|
s.id2 = le32(d, p);
|
|
p += 4;
|
|
s.random = d[p++];
|
|
s.key = d[p++];
|
|
|
|
s.stream.assign(d.begin() + p, d.end() - 1);
|
|
s.checksum = d.back();
|
|
fbm_decrypt(s.stream.data(), s.stream.size(), s.key);
|
|
|
|
uint8_t sum = s.key;
|
|
for (uint8_t b : s.stream) sum = uint8_t(sum + b);
|
|
s.checksum_ok = sum == s.checksum;
|
|
return s;
|
|
}
|
|
|
|
} // namespace bmh
|