b89d6311ff
结论：按 LinuxCNC rs274ngc_pre.cc save_parameters() 的 .new、.bak、unlink/link/rename 顺序补强 OPFS/app/browser smoke 守卫，并验证临时参数文件不会残留在 OPFS。
104 lines
5.7 KiB
Bash
Executable File
104 lines
5.7 KiB
Bash
Executable File
#!/usr/bin/env bash
|
|
set -euo pipefail
|
|
|
|
cd "$(dirname "$0")"
|
|
|
|
# LinuxCNC source basis: this guard ties browser OPFS parameter persistence to
|
|
# interp_internal.hh defaults and rs274ngc_pre.cc restore_parameters() /
|
|
# save_parameters() file semantics. It validates bridge policy only; it does not
|
|
# add CNC behavior or expand smoke parsing.
|
|
linuxcnc_root=${LINUXCNC_ROOT:-../linuxcnc}
|
|
linuxcnc_root=$(cd "$linuxcnc_root" && pwd)
|
|
|
|
grep -F '#define RS274NGC_PARAMETER_FILE_NAME_DEFAULT "rs274ngc.var"' \
|
|
"$linuxcnc_root/src/emc/rs274ngc/interp_internal.hh" >/dev/null
|
|
grep -F '#define RS274NGC_PARAMETER_FILE_BACKUP_SUFFIX ".bak"' \
|
|
"$linuxcnc_root/src/emc/rs274ngc/interp_internal.hh" >/dev/null
|
|
grep -F 'int Interp::restore_parameters(const char *filename)' \
|
|
"$linuxcnc_root/src/emc/rs274ngc/rs274ngc_pre.cc" >/dev/null
|
|
grep -F 'int Interp::save_parameters(const char *filename,' \
|
|
"$linuxcnc_root/src/emc/rs274ngc/rs274ngc_pre.cc" >/dev/null
|
|
grep -F 'std::string tempfile = std::string(filename) + ".new";' \
|
|
"$linuxcnc_root/src/emc/rs274ngc/rs274ngc_pre.cc" >/dev/null
|
|
grep -F '+ RS274NGC_PARAMETER_FILE_BACKUP_SUFFIX;' \
|
|
"$linuxcnc_root/src/emc/rs274ngc/rs274ngc_pre.cc" >/dev/null
|
|
grep -F 'unlink(bakfile.c_str());' \
|
|
"$linuxcnc_root/src/emc/rs274ngc/rs274ngc_pre.cc" >/dev/null
|
|
grep -F 'if(link(filename, bakfile.c_str()) < 0)' \
|
|
"$linuxcnc_root/src/emc/rs274ngc/rs274ngc_pre.cc" >/dev/null
|
|
grep -F 'if(rename(tempfile.c_str(), filename) < 0)' \
|
|
"$linuxcnc_root/src/emc/rs274ngc/rs274ngc_pre.cc" >/dev/null
|
|
|
|
grep -F 'RS274NGC_PARAMETER_FILE_NAME_DEFAULT` as `rs274ngc.var`' \
|
|
docs/linuxcnc-opfs-source-map.md >/dev/null
|
|
grep -F 'RS274NGC_PARAMETER_FILE_BACKUP_SUFFIX` as `.bak`' \
|
|
docs/linuxcnc-opfs-source-map.md >/dev/null
|
|
grep -F '`Interp::restore_parameters()` for parameter-file reads' \
|
|
docs/linuxcnc-opfs-source-map.md >/dev/null
|
|
grep -F '`Interp::save_parameters()` for `filename + ".new"`' \
|
|
docs/linuxcnc-opfs-source-map.md >/dev/null
|
|
grep -F 'unlinks `filename + ".bak"`, links the' \
|
|
docs/linuxcnc-opfs-source-map.md >/dev/null
|
|
grep -F 'must not add independent filesystem behavior or expand the temporary smoke parser' \
|
|
docs/linuxcnc-opfs-source-map.md >/dev/null
|
|
grep -F 'parseFileWithParameterFile()' docs/linuxcnc-opfs-source-map.md >/dev/null
|
|
grep -F 'OPFS Coverage' docs/linuxcnc-opfs-source-map.md >/dev/null
|
|
grep -F '| `web/src/wasm-core.js` |' docs/linuxcnc-opfs-source-map.md >/dev/null
|
|
grep -F '| `web/src/app.js` |' docs/linuxcnc-opfs-source-map.md >/dev/null
|
|
grep -F '| `web/test-browser-wasm-smoke-opfs-basic-sections.js` |' docs/linuxcnc-opfs-source-map.md >/dev/null
|
|
grep -F '| `web/test-browser-wasm-smoke-opfs-parameter-sections.js` |' docs/linuxcnc-opfs-source-map.md >/dev/null
|
|
grep -F '| `web/test-browser-wasm-smoke-opfs-mirror-sections.js` |' docs/linuxcnc-opfs-source-map.md >/dev/null
|
|
grep -F '| `web/test-browser-wasm-smoke-app-sections.js` |' docs/linuxcnc-opfs-source-map.md >/dev/null
|
|
|
|
grep -F 'const LINUXCNC_DEFAULT_PARAMETER_FILE = "rs274ngc.var";' web/src/wasm-core.js >/dev/null
|
|
grep -F '`${LINUXCNC_DEFAULT_PARAMETER_FILE}.new`' web/src/wasm-core.js >/dev/null
|
|
grep -F '`${LINUXCNC_DEFAULT_PARAMETER_FILE}.bak`' web/src/wasm-core.js >/dev/null
|
|
grep -F 'LinuxCNC source basis: rs274ngc_pre.cc restore_parameters() reads the' web/src/wasm-core.js >/dev/null
|
|
grep -F 'before replacing the main file and managing filename + ".bak".' web/src/wasm-core.js >/dev/null
|
|
grep -F 'app frame did not clean up LinuxCNC temporary parameter file in OPFS' \
|
|
web/test-browser-wasm-smoke-app-sections.js >/dev/null
|
|
grep -F 'OPFS cannot be disabled in browser contexts with OPFS support' web/src/wasm-core.js >/dev/null
|
|
grep -F 'const events = await simulator.parseFileWithParameterFile(programPath, parameterPath, "linuxcnc", parseOptions);' \
|
|
web/src/app.js >/dev/null
|
|
grep -F 'OPFS workspace is required for browser program parsing' web/src/app.js >/dev/null
|
|
grep -F 'runSection("opfs parameter restore in new instance"' test-web-wasm-browser-smoke.sh >/dev/null
|
|
grep -F 'runSection("opfs invalid parameter restore failures"' test-web-wasm-browser-smoke.sh >/dev/null
|
|
grep -F 'runSection("opfs stale parameter state cleanup"' test-web-wasm-browser-smoke.sh >/dev/null
|
|
grep -F 'runSection("opfs program parse and restore"' test-web-wasm-browser-smoke.sh >/dev/null
|
|
grep -F 'runSection("browser app opfs restore"' test-web-wasm-browser-smoke.sh >/dev/null
|
|
|
|
if grep -R -n -E 'localStorage|sessionStorage|indexedDB|showOpenFilePicker|showSaveFilePicker|showDirectoryPicker|webkitRequestFileSystem|FileReader' web/src; then
|
|
echo "browser app/wasm code must not add filesystem persistence outside OPFS" >&2
|
|
exit 1
|
|
fi
|
|
|
|
python3 - <<'PY'
|
|
from pathlib import Path
|
|
|
|
source_map = Path("docs/linuxcnc-opfs-source-map.md").read_text(encoding="utf-8")
|
|
coverage_entries = [
|
|
"web/src/wasm-core.js",
|
|
"web/src/app.js",
|
|
"web/test-browser-wasm-smoke-opfs-basic-sections.js",
|
|
"web/test-browser-wasm-smoke-opfs-parameter-sections.js",
|
|
"web/test-browser-wasm-smoke-opfs-mirror-sections.js",
|
|
"web/test-browser-wasm-smoke-app-sections.js",
|
|
]
|
|
for entry in coverage_entries:
|
|
if f"| `{entry}` |" not in source_map:
|
|
raise SystemExit(f"docs/linuxcnc-opfs-source-map.md missing OPFS coverage entry: {entry}")
|
|
|
|
required_phrases = [
|
|
"programs/current.ngc",
|
|
"parameters/rs274ngc.var",
|
|
"LinuxCNC `read_text()`",
|
|
"`.new`, `.bak`, failure, and stale-state semantics",
|
|
'unlinks `filename + ".bak"`',
|
|
"OPFS/WASM mirror persistence",
|
|
"app-level OPFS program, parameter, backup, and reload behavior",
|
|
]
|
|
for phrase in required_phrases:
|
|
if phrase not in source_map:
|
|
raise SystemExit(f"docs/linuxcnc-opfs-source-map.md missing OPFS coverage phrase: {phrase}")
|
|
PY
|