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 | # потом привязывает копию по выбранному пути. |
| 41 | set -eu |
| 42 | |
| 43 | prefix=${1:-} |
| 44 | [ -n "$prefix" ] || { echo "нужен аргумент: каталог комплекта" >&2; exit 2; } |
| 45 | prefix=$(cd "$prefix" && pwd) |
| 46 | |
| 47 | ld="$prefix/lib/ld-linux-x86-64.so.2" |
| 48 | [ -x "$ld" ] || { echo "не найден загрузчик $ld — это не комплект" >&2; exit 2; } |
| 49 | |
| 50 | # patchelf вызывается через загрузчик явно: его собственный PT_INTERP на |
| 51 | # этот момент может указывать ещё на прошлый каталог (или на каталог |
| 52 | # машины сборки), и запустить его обычным способом нельзя. |
| 53 | run() { |
| 54 | tool=$1 |
| 55 | shift |
| 56 | "$ld" --library-path "$prefix/lib" "$prefix/bin/$tool" "$@" |
| 57 | } |
| 58 | |
| 59 | echo "Привязка комплекта к $prefix" |
| 60 | |
| 61 | # Первым делом — что комплект вообще исполняем на этой машине. Проверка |
| 62 | # не формальная: ниже наличие интерпретатора у файла определяется по |
| 63 | # тому, отработал ли `patchelf --print-interpreter`, и его ошибки там |
| 64 | # намеренно проглатываются (у библиотек интерпретатора нет, и это норма). |
| 65 | # Если бы `patchelf` не запускался вовсе, «нет интерпретатора» вернулось |
| 66 | # бы для КАЖДОГО файла, скрипт молча не сделал бы ничего и отрапортовал |
| 67 | # успех — а сломалось бы позже и в другом месте. Ровно это и случилось |
| 68 | # при первой проверке на Debian: `chl` запускался системным загрузчиком |
| 69 | # и падал на «version GLIBC_2.39 not found». |
| 70 | if ! run patchelf --version >/dev/null 2>&1; then |
| 71 | echo "не запускается patchelf из комплекта — комплект собран неправильно" >&2 |
| 72 | echo "подробности:" >&2 |
| 73 | run patchelf --version >&2 || true |
| 74 | exit 1 |
| 75 | fi |
| 76 | |
| 77 | # --- 0. Сверка glibc --------------------------------------------------- |
| 78 | # Комплект со своей glibc работает, только если она не старше хостовой: |
| 79 | # в наш процесс попадают библиотеки хоста (драйверы Mesa, libGL, |
| 80 | # libvulkan — их мы намеренно не бандлим), собранные против хостовой |
| 81 | # glibc, и наша обязана уметь всё, что умеет та. Обратное направление |
| 82 | # безопасно и на нём всё держится. Случай «хост новее» — не отказ |
| 83 | # ставиться, а предупреждение: он маловероятен (Mesa почти не |
| 84 | # использует свежих символов glibc), но если что-то потом не заработает, |
| 85 | # человек должен знать, где искать. |
| 86 | if [ -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 |
| 105 | fi |
| 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. |
| 117 | for 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 |
| 135 | done |
| 136 | |
| 137 | # --- 1. PT_INTERP ------------------------------------------------------ |
| 138 | # Исполняемый файл от библиотеки отличаем по самому наличию |
| 139 | # интерпретатора: у библиотек его нет, и patchelf сообщает об этом |
| 140 | # ошибкой. |
| 141 | failed="$prefix/.relocate-failed" |
| 142 | rm -f "$failed" |
| 143 | find "$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 |
| 162 | done |
| 163 | if [ -e "$failed" ]; then |
| 164 | rm -f "$failed" |
| 165 | exit 1 |
| 166 | fi |
| 167 | |
| 168 | # --- 2. Каталог вспомогательных процессов WebKitGTK -------------------- |
| 169 | # Целевой путь короче исходного и лежит в /run/user/<uid> — каталоге, |
| 170 | # который создаёт logind с правами 0700 на владельца. В /tmp такой путь |
| 171 | # вести нельзя: подменив там символьную ссылку, чужой процесс подсунул |
| 172 | # бы свой WebKitWebProcess. |
| 173 | webkit_lib="$prefix/lib/libwebkitgtk-6.0.so.4" |
| 174 | runtime=${XDG_RUNTIME_DIR:-/run/user/$(id -u)} |
| 175 | if [ -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 |
| 228 | fi |
| 229 | |
| 230 | # --- 3. Кэш загрузчиков gdk-pixbuf ------------------------------------- |
| 231 | loaders="$prefix/lib/gdk-pixbuf-2.0/2.10.0/loaders" |
| 232 | if [ -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" |
| 236 | fi |
| 237 | |
| 238 | # Кэш модулей GIO: в нём только имена, но пересобрать дешевле, чем |
| 239 | # потом разбираться, почему libgiognutls не подхватился и у встроенного |
| 240 | # браузера нет HTTPS. |
| 241 | [ -d "$prefix/lib/gio/modules" ] && run gio-querymodules "$prefix/lib/gio/modules" |
| 242 | |
| 243 | # --- 4. Конфиги загрузчиков glycin ------------------------------------- |
| 244 | for 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" |
| 247 | done |
| 248 | |
| 249 | echo "Готово." |
| 250 |