Project Chimera
Меню

Исходники

250 строк · 17 КиБ

packaging/bundle/relocate.sh

1#!/bin/sh
2# Привязка комплекта к каталогу, в который его положили.
3#
4# Комплект переносим не полностью: четыре вещи в нём знают абсолютные
5# пути, а узнать их при сборке нельзя — каталог выбирает человек.
6#
7# 1. **PT_INTERP исполняемых файлов.** Комплект везёт свою glibc
8# (почему — см. `build-payload.sh`), а поле «каким загрузчиком меня
9# запускать» в ELF обязано быть абсолютным путём: ни `$ORIGIN`, ни
10# относительных путей формат здесь не допускает. Библиотекам это не
11# нужно — у них путь к соседям задан RUNPATH `$ORIGIN`, прописанным
12# ещё при сборке. А вспомогательные процессы (WebKitWebProcess и
13# компания, загрузчики glycin) запускает не шелл и не мы, а
14# библиотека — по абсолютному пути, без всякого окружения. Оставить
15# им PT_INTERP хоста означало бы: загрузчик хоста (например glibc
16# 2.36 на Debian 12) пытается загрузить нашу libc.so.6 (2.44) и
17# падает на «version GLIBC_PRIVATE not defined».
18#
19# 2. **Каталог вспомогательных процессов WebKitGTK.** Он вкомпилирован
20# в `libwebkitgtk-6.0.so.4` строкой `/usr/lib/webkitgtk-6.0`, и
21# переменной окружения для него не существует (проверено по самой
22# библиотеке: `WEBKIT_INJECTED_BUNDLE_PATH` и
23# `WEBKIT_DISABLE_SANDBOX_…` в ней есть, `WEBKIT_EXEC_PATH` — нет,
24# его убрали вместе с переходом на API 6.0). Писать в `/usr` мы не
25# можем: установка без root — требование. Поэтому строка правится
26# на месте — тем же приёмом, которым это делает Tauri
27# (tauri-apps/tauri#2940). Править можно только на **не более
28# длинную**: сдвинуть данные в `.rodata` нельзя. Куда именно и
29# почему — в doc-комментарии `chl_core::portable::webkit_exec_link`.
30#
31# 3. **Кэш загрузчиков gdk-pixbuf** (`loaders.cache`) — текстовый файл
32# с абсолютным путём к каждому `.so`.
33#
34# 4. **Конфиги загрузчиков glycin** — строка `Exec=` с абсолютным
35# путём к процессу-загрузчику.
36#
37# Скрипт идемпотентен: его можно звать повторно и на уже привязанном
38# комплекте — ровно это и происходит, когда установщик сначала
39# запускает мастер из распакованного во временный каталог комплекта, а
40# потом привязывает копию по выбранному пути.
41set -eu
42
43prefix=${1:-}
44[ -n "$prefix" ] || { echo "нужен аргумент: каталог комплекта" >&2; exit 2; }
45prefix=$(cd "$prefix" && pwd)
46
47ld="$prefix/lib/ld-linux-x86-64.so.2"
48[ -x "$ld" ] || { echo "не найден загрузчик $ld — это не комплект" >&2; exit 2; }
49
50# patchelf вызывается через загрузчик явно: его собственный PT_INTERP на
51# этот момент может указывать ещё на прошлый каталог (или на каталог
52# машины сборки), и запустить его обычным способом нельзя.
53run() {
54 tool=$1
55 shift
56 "$ld" --library-path "$prefix/lib" "$prefix/bin/$tool" "$@"
57}
58
59echo "Привязка комплекта к $prefix"
60
61# Первым делом — что комплект вообще исполняем на этой машине. Проверка
62# не формальная: ниже наличие интерпретатора у файла определяется по
63# тому, отработал ли `patchelf --print-interpreter`, и его ошибки там
64# намеренно проглатываются (у библиотек интерпретатора нет, и это норма).
65# Если бы `patchelf` не запускался вовсе, «нет интерпретатора» вернулось
66# бы для КАЖДОГО файла, скрипт молча не сделал бы ничего и отрапортовал
67# успех — а сломалось бы позже и в другом месте. Ровно это и случилось
68# при первой проверке на Debian: `chl` запускался системным загрузчиком
69# и падал на «version GLIBC_2.39 not found».
70if ! run patchelf --version >/dev/null 2>&1; then
71 echo "не запускается patchelf из комплекта — комплект собран неправильно" >&2
72 echo "подробности:" >&2
73 run patchelf --version >&2 || true
74 exit 1
75fi
76
77# --- 0. Сверка glibc ---------------------------------------------------
78# Комплект со своей glibc работает, только если она не старше хостовой:
79# в наш процесс попадают библиотеки хоста (драйверы Mesa, libGL,
80# libvulkan — их мы намеренно не бандлим), собранные против хостовой
81# glibc, и наша обязана уметь всё, что умеет та. Обратное направление
82# безопасно и на нём всё держится. Случай «хост новее» — не отказ
83# ставиться, а предупреждение: он маловероятен (Mesa почти не
84# использует свежих символов glibc), но если что-то потом не заработает,
85# человек должен знать, где искать.
86if [ -f "$prefix/lib/glibc-version" ] && command -v getconf >/dev/null 2>&1; then
87 ours=$(cat "$prefix/lib/glibc-version")
88 # Разбор оболочкой, а не `awk`. `getconf` печатает «glibc 2.44», взять
89 # второе слово — одна подстановка. Зависеть ради этого от awk нельзя: в
90 # базовом образе openSUSE Tumbleweed его нет, и при `set -e` вся
91 # раскладка обрывалась на `awk: command not found` — то есть
92 # необязательная проверка версии убивала установку целиком. Поймано
93 # добавлением openSUSE в матрицу дистрибутивов.
94 theirs=$(getconf GNU_LIBC_VERSION 2>/dev/null || true)
95 theirs=${theirs#* }
96 if [ -n "$theirs" ] && [ "$ours" != "$theirs" ]; then
97 newest=$(printf '%s\n%s\n' "$ours" "$theirs" | sort -V | tail -1)
98 if [ "$newest" = "$theirs" ]; then
99 echo "ВНИМАНИЕ: glibc в системе ($theirs) новее, чем в комплекте ($ours)." >&2
100 echo " Комплект рассчитан на обратное. Если графика или встроенный" >&2
101 echo " браузер будут вести себя странно, дело почти наверняка в этом:" >&2
102 echo " нужен установщик, собранный на более свежем дистрибутиве." >&2
103 fi
104 fi
105fi
106
107# --- 0б. Сверка libwayland-client -------------------------------------
108# Единственная системная библиотека с настоящим минимумом версии:
109# 1.22. Метаданные интерфейсов Wayland (wl_surface версии 6 и прочие)
110# лежат внутри самой libwayland-client, GTK 4.22 просит версии, которых
111# в 1.21 нет, и композитор закрывает соединение. Человек при этом видит
112# только «Error 0 (Success) dispatching to Wayland display» и пустой
113# экран — поэтому говорим заранее, на установке. Проверено на Debian 12
114# (1.21 — окна нет; подменили ту же библиотеку на 1.26 — окно есть).
115# Версия берётся из имени файла за soname-ссылкой: soname .so.0.23.1 —
116# это релиз 1.23.1.
117for d in /usr/lib/x86_64-linux-gnu /usr/lib64 /usr/lib /lib/x86_64-linux-gnu; do
118 [ -e "$d/libwayland-client.so.0" ] || continue
119 wl=$(basename "$(readlink -f "$d/libwayland-client.so.0")")
120 case "$wl" in
121 libwayland-client.so.0.*)
122 wl_ver="1.${wl#libwayland-client.so.0.}"
123 if [ "$(printf '%s\n1.22\n' "$wl_ver" | sort -V | head -1)" = "$wl_ver" ] \
124 && [ "$wl_ver" != "1.22" ]; then
125 echo "ВНИМАНИЕ: libwayland-client в системе $wl_ver, нужна 1.22 или новее." >&2
126 echo " Под Wayland окно лаунчера не откроется: GTK просит у композитора" >&2
127 echo " версии интерфейсов, которых в этой libwayland нет. Свою копию" >&2
128 echo " привезти нельзя — её грузит Mesa системы. Варианты: сеанс X11" >&2
129 echo " (GDK_BACKEND=x11) или дистрибутив посвежее (Debian 13," >&2
130 echo " Ubuntu 24.04, Fedora 40, Arch, SteamOS 3.5 и новее)." >&2
131 fi
132 ;;
133 esac
134 break
135done
136
137# --- 1. PT_INTERP ------------------------------------------------------
138# Исполняемый файл от библиотеки отличаем по самому наличию
139# интерпретатора: у библиотек его нет, и patchelf сообщает об этом
140# ошибкой.
141failed="$prefix/.relocate-failed"
142rm -f "$failed"
143find "$prefix/bin" "$prefix/libexec" -type f 2>/dev/null | while read -r f; do
144 case "$f" in
145 # Сам patchelf не патчим — он бы менял файл, который прямо сейчас
146 # отображён в память как код исполняющегося процесса, и получал бы
147 # за это SIGBUS. Проверено на живом запуске. И не надо: patchelf,
148 # как и две query-утилиты рядом, мы всегда зовём через загрузчик
149 # явно (функция `run` выше), а при явном вызове загрузчика поле
150 # PT_INTERP файла не используется вовсе.
151 */bin/patchelf) continue ;;
152 esac
153 if run patchelf --print-interpreter "$f" >/dev/null 2>&1; then
154 run patchelf --set-interpreter "$ld" "$f" || {
155 echo "не удалось привязать $f" >&2
156 # Через файл, а не `exit 1`: тело `while` в конвейере — это
157 # подоболочка, и её `exit` завершил бы только её, оставив скрипт
158 # рапортовать об успехе.
159 : > "$failed"
160 }
161 fi
162done
163if [ -e "$failed" ]; then
164 rm -f "$failed"
165 exit 1
166fi
167
168# --- 2. Каталог вспомогательных процессов WebKitGTK --------------------
169# Целевой путь короче исходного и лежит в /run/user/<uid> — каталоге,
170# который создаёт logind с правами 0700 на владельца. В /tmp такой путь
171# вести нельзя: подменив там символьную ссылку, чужой процесс подсунул
172# бы свой WebKitWebProcess.
173webkit_lib="$prefix/lib/libwebkitgtk-6.0.so.4"
174runtime=${XDG_RUNTIME_DIR:-/run/user/$(id -u)}
175if [ -f "$webkit_lib" ]; then
176 if [ ! -d "$runtime" ] || [ "$(stat -c %u "$runtime")" != "$(id -u)" ] \
177 || [ "$(stat -c %a "$runtime")" != 700 ]; then
178 echo "Не найден личный runtime-каталог: $runtime. Встроенный браузер не привязан." >&2
179 exit 1
180 else
181 orig='/usr/lib/webkitgtk-6.0'
182 budget=${#orig}
183 name=$(printf 'chl-webkit')
184 while [ $((${#runtime} + 1 + ${#name})) -gt "$budget" ] && [ -n "$name" ]; do
185 name=${name%?}
186 done
187 if [ -z "$name" ]; then
188 echo "Путь $runtime слишком длинный — встроенный браузер не привязан." >&2
189 exit 1
190 else
191 target="$runtime/$name"
192 # Замена дополняется нулями до длины исходной строки: короче
193 # можно, длиннее нельзя, сдвигать данные в .rodata — нет.
194 #
195 # Правятся ВСЕ вхождения `/usr/lib/webkitgtk-6.0`, включая то, с
196 # которого начинается `/usr/lib/webkitgtk-6.0/injected-bundle/`:
197 # эта вторая строка после правки станет просто `<target>`, то
198 # есть каталогом самих процессов. Это не потеря — путь к
199 # injected-bundle всё равно задаётся переменной
200 # `WEBKIT_INJECTED_BUNDLE_PATH` (её выставляет
201 # `chl_core::portable`), а на случай, если её кто-то затрёт,
202 # рядом с процессами лежит ссылка на ту же библиотеку, так что
203 # искать её в `<target>` тоже сработает.
204 # Хвост нулями пишется `dd` из /dev/zero, а не строкой от `awk`.
205 # Ради одного padding-а тянуть awk нельзя: в базовом образе openSUSE
206 # Tumbleweed его нет, и раскладка обрывалась на
207 # `awk: command not found`. `dd` тут и так рядом, вторым вызовом.
208 pad_len=$((budget - ${#target}))
209 patched=0
210 for off in $(LC_ALL=C grep -aboF -- "$orig" "$webkit_lib" 2>/dev/null | cut -d: -f1); do
211 printf '%s' "$target" | dd of="$webkit_lib" bs=1 seek="$off" conv=notrunc status=none
212 if [ "$pad_len" -gt 0 ]; then
213 dd if=/dev/zero of="$webkit_lib" bs=1 count="$pad_len" \
214 seek=$((off + ${#target})) conv=notrunc status=none
215 fi
216 patched=$((patched + 1))
217 done
218 ln -sf injected-bundle/libwebkitgtkinjectedbundle.so \
219 "$prefix/libexec/webkitgtk-6.0/libwebkitgtkinjectedbundle.so" 2>/dev/null || true
220 if ! LC_ALL=C grep -aqF -- "$target" "$webkit_lib" \
221 || LC_ALL=C grep -aqF -- "$orig" "$webkit_lib"; then
222 echo "Не удалось привязать WebKitGTK: неизвестная раскладка библиотеки." >&2
223 exit 1
224 fi
225 echo " WebKitGTK: процессы через $target"
226 fi
227 fi
228fi
229
230# --- 3. Кэш загрузчиков gdk-pixbuf -------------------------------------
231loaders="$prefix/lib/gdk-pixbuf-2.0/2.10.0/loaders"
232if [ -d "$loaders" ]; then
233 GDK_PIXBUF_MODULEDIR="$loaders" \
234 run gdk-pixbuf-query-loaders > "$loaders/../loaders.cache.new"
235 mv "$loaders/../loaders.cache.new" "$loaders/../loaders.cache"
236fi
237
238# Кэш модулей GIO: в нём только имена, но пересобрать дешевле, чем
239# потом разбираться, почему libgiognutls не подхватился и у встроенного
240# браузера нет HTTPS.
241[ -d "$prefix/lib/gio/modules" ] && run gio-querymodules "$prefix/lib/gio/modules"
242
243# --- 4. Конфиги загрузчиков glycin -------------------------------------
244for conf in "$prefix"/share/glycin-loaders/*/conf.d/*.conf; do
245 [ -f "$conf" ] || continue
246 sed -i "s|^\(Exec *= *\).*/glycin-|\1$prefix/libexec/glycin-loaders/2+/glycin-|" "$conf"
247done
248
249echo "Готово."
250