Files
Triforce-Source/docs/linux-update-sysroot.md
ruckus7382sfgsgdf 34b3683441 Triforce v0.2.0
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-10 19:32:48 -06:00

19 lines
992 B
Markdown

# Sysroot library aliases in Linux update parts
The AppImage's selected system libraries are copied by value into its sysroot.
Some host distributions make a development alias such as libmvec.so an absolute
symlink. Keeping that target would either depend on the player's host filesystem
or be rejected by a strict updater. Dereferencing the
source alias while copying preserves its bytes and attributes inside the part.
The internal relative lib -> usr/lib sysroot layout remains a link. Existing
parts carrying absolute links are not retroactively rewritten. For legacy
sysroot parts only, the updater rebases absolute links to relative links when
their targets exist and resolve inside that sysroot. Absolute links in other
parts, missing or circular targets, and paths that escape the sysroot remain
errors.
Tests execute the production copy loop with synthetic library inputs, then
package and unpack the resulting sysroot, alongside legacy-link and
hostile-archive regression cases.