chore: 规范标点
This commit is contained in:
pluv committed
1 parent
15e79887fa
commit
3dd2231c70
81 files changed
+1751
-1751
No files matched your search
+35
-35
@@ -1,7 +1,7 @@
|
||||
#!/bin/sh
|
||||
# build-static-deps.sh - 造一份"musl 工具链编出来的静态 libcurl", 给 make static 用.
|
||||
#
|
||||
# 为什么需要它：发行版的 libcurl.a 是针对 glibc 编的, 跟 musl 混link会得到一堆
|
||||
# 为什么需要它: 发行版的 libcurl.a 是针对 glibc 编的, 跟 musl 混link会得到一堆
|
||||
# "undefined reference to __libc_start_main". 所以必须自己用 musl 工具链把
|
||||
# libcurl 和它的依赖 (zlib、OpenSSL)编一遍.
|
||||
#
|
||||
@@ -46,7 +46,7 @@ need() {
|
||||
need make
|
||||
need "$CC"
|
||||
need perl # OpenSSL 的 Configure
|
||||
# 下载靠它. 以前这里写的是 `need curl || true` —— 那是**假的容错**：need 失败时
|
||||
# 下载靠它. 以前这里写的是 `need curl || true` —— 那是**假的容错**: need 失败时
|
||||
# 直接 exit, `|| true` 根本执行不到 (那句注释"下面会再确认"也不成立). 于是缺
|
||||
# curl 时脚本会一路跑到 fetch, 最后报"所有候选地址都不可用 / 要么是没网, 要么
|
||||
# 是版本号写错了", 把人引去查网络和版本号 —— 而真正的原因是工具没装.
|
||||
@@ -57,7 +57,7 @@ need tar
|
||||
# OpenSSL 的 Configure 要一个明确的 target 名, 它**不做**自动探测. 以前这里
|
||||
# 写死 linux-x86_64, 于是在 aarch64/riscv64 上会去编 x86 的汇编, 直接失败 ——
|
||||
# 而这个脚本的产物恰恰是"拷到别的机器也能跑"的静态件.
|
||||
# 认不出来时**不猜**：猜错的后果是编出一堆看着像成功、其实不对的东西.
|
||||
# 认不出来时**不猜**: 猜错的后果是编出一堆看着像成功、其实不对的东西.
|
||||
OPENSSL_TARGET=${OPENSSL_TARGET:-}
|
||||
if [ -z "$OPENSSL_TARGET" ]; then
|
||||
case "$(uname -m)" in
|
||||
@@ -71,7 +71,7 @@ if [ -z "$OPENSSL_TARGET" ]; then
|
||||
loongarch64) OPENSSL_TARGET=linux64-loongarch64 ;; # 3.1+ 才有
|
||||
*)
|
||||
echo "认不出这台机器的架构 ($(uname -m)), 而 OpenSSL 的 Configure" >&2
|
||||
echo "需要一个明确的 target 名. 请显式指定, 例如：" >&2
|
||||
echo "需要一个明确的 target 名. 请显式指定, 例如: " >&2
|
||||
echo " OPENSSL_TARGET=linux-aarch64 $0" >&2
|
||||
echo " (可用的 target 见 OpenSSL 源码里的 Configurations/10-main.conf)" >&2
|
||||
exit 1 ;;
|
||||
@@ -80,27 +80,27 @@ fi
|
||||
|
||||
# 刻意**不带** -fno-pie. 依赖库编成默认的 PIE 兼容代码就行 —— PIC 代码放进
|
||||
# 非 PIE 可执行文件是合法的, 最后那一步由 ligent 自己用 -no-pie 决定.
|
||||
# 反过来 (依赖 -fno-pie、链接却不带 -no-pie)会立刻炸：这些项目在 make 里
|
||||
# 反过来 (依赖 -fno-pie、链接却不带 -no-pie)会立刻炸: 这些项目在 make 里
|
||||
# 还会顺手链几个测试程序, 而那些链接用的是默认的 PIE, 于是
|
||||
# relocation R_X86_64_32 against ... can not be used when making a PIE object
|
||||
# 而且 zlib 的 configure 探测 vsnprintf 也会因此失败, 悄悄退化成不安全的
|
||||
# vsprintf 版本 (实测踩过).
|
||||
# 体积优先. 静态产物是"拷过去就能跑"的发布件, 不是拿来调试的, 所以这里的
|
||||
# 取舍和普通构建相反 —— 目标是越小越好. 三组开关要一起上才有意义：
|
||||
# 取舍和普通构建相反 —— 目标是越小越好. 三组开关要一起上才有意义:
|
||||
# -Os 别做以体积换速度的展开/内联
|
||||
# -ffunction-sections 依赖库也按函数分段, 这样最后链接时
|
||||
# -fdata-sections --gc-sections 才**丢得掉**没被引用的部分
|
||||
# -fno-*-unwind-tables C 代码不需要 C++ 异常和栈回溯, .eh_frame 全省
|
||||
# 实测 (连同 Makefile 那侧的 strip 等一起)：6.24 MB → 3.29 MB.
|
||||
# 其中这一半的功劳很大：libcurl+OpenSSL 的 .text 从 3.45 MB 掉到 2.41 MB ——
|
||||
# 实测 (连同 Makefile 那侧的 strip 等一起): 6.24 MB → 3.29 MB.
|
||||
# 其中这一半的功劳很大: libcurl+OpenSSL 的 .text 从 3.45 MB 掉到 2.41 MB ——
|
||||
# 静态归档里本来就有一大堆我们永远走不到的算法和协议实现.
|
||||
# 想回到调试友好 (-O2、保留 unwind 表)：CFLAGS_COMMON="-O2 $0"
|
||||
# 想回到调试友好 (-O2、保留 unwind 表): CFLAGS_COMMON="-O2 $0"
|
||||
CFLAGS_COMMON=${CFLAGS_COMMON:-"-Os -ffunction-sections -fdata-sections -fno-asynchronous-unwind-tables -fno-unwind-tables"}
|
||||
|
||||
# musl-gcc 只搜 /usr/lib/musl/include, **不搜 /usr/include**, 于是内核的 UAPI
|
||||
# 头 (linux/mman.h、asm/*.h 这些)找不到 —— OpenSSL 就死在这一步：
|
||||
# 头 (linux/mman.h、asm/*.h 这些)找不到 —— OpenSSL 就死在这一步:
|
||||
# fatal error: linux/mman.h: No such file or directory
|
||||
# 用 -idirafter：musl 自己的头优先, /usr/include 只在 musl 没有时兜底.
|
||||
# 用 -idirafter: musl 自己的头优先, /usr/include 只在 musl 没有时兜底.
|
||||
# 直接写 -I 会让 glibc 的头盖过 musl 的, 那是另一个坑.
|
||||
UAPI_INC="-idirafter /usr/include"
|
||||
|
||||
@@ -110,14 +110,14 @@ UAPI_INC="-idirafter /usr/include"
|
||||
# 记得把 BUILD_DEFS 加一**才能被发现; 忘了就继续用旧参数编出来的库, 症状是
|
||||
# "我明明加了个 --disable-x, 怎么产物一点没变".
|
||||
|
||||
# zlib 只要 --static：我们要的是 libz.a
|
||||
# zlib 只要 --static: 我们要的是 libz.a
|
||||
ZLIB_CONFIGURE_ARGS="--static"
|
||||
|
||||
# OpenSSL：no-shared 只出 .a; no-tests 少编一堆测试程序 (省几分钟);
|
||||
# OpenSSL: no-shared 只出 .a; no-tests 少编一堆测试程序 (省几分钟);
|
||||
# no-legacy 去掉已淘汰的算法 (体积).
|
||||
OPENSSL_CONFIGURE_ARGS="no-shared no-tests no-legacy"
|
||||
|
||||
# curl：ligent 只用 chat/completions 一个端点, 所以只要能发 HTTPS 的那部分.
|
||||
# curl: ligent 只用 chat/completions 一个端点, 所以只要能发 HTTPS 的那部分.
|
||||
# --disable-* FTP/邮件/字典/… 这些协议编进来纯属占地
|
||||
# --without-* 静态链接下每个"可选增强"都会再拖一串依赖进来 (libpsl、idn2、
|
||||
# brotli、zstd、nghttp2/3…), 而 ligent 一个都不用
|
||||
@@ -138,21 +138,21 @@ mkdir -p "$SRC" "$PREFIX"
|
||||
# 编译选项变了就得把依赖整个重建. 否则下面每个守卫都会看到 libz.a 已存在而
|
||||
# 直接跳过, 于是你一直用着旧选项编出来的库, 而且**看不出来** —— 症状是
|
||||
# "我明明加了 -Os, 怎么产物一点没小".
|
||||
# 这和 Makefile 里"对象目录按编译器/插桩分标签"是同一个坑的两处：make 和这个
|
||||
# 这和 Makefile 里"对象目录按编译器/插桩分标签"是同一个坑的两处: make 和这个
|
||||
# 脚本都只看文件在不在, 看不见命令行变了.
|
||||
STAMP="$PREFIX/.build-flags"
|
||||
# BUILD_DEFS：配方版本号, 留给"改了脚本逻辑、但 WANT 里的文本一个字都没变"的
|
||||
# BUILD_DEFS: 配方版本号, 留给"改了脚本逻辑、但 WANT 里的文本一个字都没变"的
|
||||
# 改动 (比如换了一种绕坑的处理方式). 凡是会改变产物内容的改动都要加一.
|
||||
#
|
||||
# 注意它现在**不再是唯一的触发源**：编译选项、三个版本号、OpenSSL target、
|
||||
# 注意它现在**不再是唯一的触发源**: 编译选项、三个版本号、OpenSSL target、
|
||||
# 每个库的 configure 参数都直接进了下面的 WANT, 改它们会自动触发重建, 不需要
|
||||
# 谁记得来这里加一 —— 以前 configure 参数不在 WANT 里, 全靠这个手写数字兜着,
|
||||
# 而人是会忘的 (忘了就是"一直用旧参数编出来的库, 看不出来").
|
||||
# 已有的历史值：1 = 加了体积优先的 CFLAGS; 2 = configure 期间藏起 .pc 文件;
|
||||
# 已有的历史值: 1 = 加了体积优先的 CFLAGS; 2 = configure 期间藏起 .pc 文件;
|
||||
# 3 = 架构与 configure 参数进指纹 (本版).
|
||||
BUILD_DEFS=3
|
||||
|
||||
# 多行参数折叠成一行：好塞进戳文件, 也好肉眼比对
|
||||
# 多行参数折叠成一行: 好塞进戳文件, 也好肉眼比对
|
||||
flatten() {
|
||||
printf '%s' "$1" | tr -s '[:space:]' ' ' | sed 's/^ *//; s/ *$//'
|
||||
}
|
||||
@@ -164,7 +164,7 @@ WANT="defs=$BUILD_DEFS | CC=$CC | zlib=$ZLIB_VER openssl=$OPENSSL_VER curl=$CURL
|
||||
| curl:[$(flatten "$CURL_CONFIGURE_ARGS")]"
|
||||
if [ ! -f "$STAMP" ] && [ -f "$PREFIX/lib/libz.a" ]; then
|
||||
# 有库却没有选项记录 —— 那是**旧版脚本**编的, 不知道用的什么选项.
|
||||
# 这一条不能省：没有它, 下面的判断会认为"stamp 不存在 = 不用重建",
|
||||
# 这一条不能省: 没有它, 下面的判断会认为"stamp 不存在 = 不用重建",
|
||||
# 然后我们就给旧库写上一个声称是新选项的 stamp, 把它洗白成"新的".
|
||||
echo "== 这个前缀没有编译选项记录 (旧版脚本编的), 重建以确认选项一致"
|
||||
rm -rf "$PREFIX"
|
||||
@@ -208,8 +208,8 @@ fetch() {
|
||||
echo " 这个地址不行, 换下一个"
|
||||
rm -f "$out.part"
|
||||
done
|
||||
echo " 下载 $(basename "$out") 失败：所有候选地址都不可用. " >&2
|
||||
echo " 要么是没网, 要么是版本号写错了. 可以指定版本重来, 例如：" >&2
|
||||
echo " 下载 $(basename "$out") 失败: 所有候选地址都不可用. " >&2
|
||||
echo " 要么是没网, 要么是版本号写错了. 可以指定版本重来, 例如: " >&2
|
||||
echo " ZLIB=1.3.1 OPENSSL=3.5.0 CURL=8.11.1 $0" >&2
|
||||
exit 1
|
||||
}
|
||||
@@ -269,30 +269,30 @@ if [ ! -x "$PREFIX/bin/curl-config" ]; then
|
||||
|
||||
# ---- configure 期间把 .pc 文件藏起来, 别让它走 pkg-config ----
|
||||
#
|
||||
# curl 的 configure 是这么挑 OpenSSL 的 (--with-openssl 给的是自定义前缀)：
|
||||
# curl 的 configure 是这么挑 OpenSSL 的 (--with-openssl 给的是自定义前缀):
|
||||
# OPENSSL_PCDIR="$OPT_OPENSSL/lib/pkgconfig"
|
||||
# if test -f "$OPENSSL_PCDIR/openssl.pc"; then PKGTEST="yes" # 用 pkg-config
|
||||
# ...
|
||||
# if test "$PKGTEST" != "yes"; then
|
||||
# SSL_LDFLAGS="-L$PREFIX_OPENSSL/lib" # 直接给目录, 路径原样
|
||||
#
|
||||
# 走 pkg-config 那条路会出事：configure 开头就 `LC_ALL=C; export LC_ALL`
|
||||
# 走 pkg-config 那条路会出事: configure 开头就 `LC_ALL=C; export LC_ALL`
|
||||
# (autoconf 的标准开头, 脚本外面设 LC_ALL 压不住它), 而 pkg-config 在
|
||||
# C locale 下用 isprint() 判断字节要不要转义 —— 每个 >= 0x80 的字节都被判成
|
||||
# "不可打印", 于是它给路径里每个非 ASCII 字节前面加个反斜杠：
|
||||
# "不可打印", 于是它给路径里每个非 ASCII 字节前面加个反斜杠:
|
||||
# -L/…/开发/… -> -L/…/\开\发/…
|
||||
# \ 后面跟 E5 不是合法续字节, 所以那串是**非法 UTF-8**. curl 拿到就写进
|
||||
# curl-config、libcurl.pc 和一堆 Makefile (实测 26 个文件).
|
||||
#
|
||||
# 后果不只是难看：之后 `make static` 里 `curl-config --static-libs` 一打印,
|
||||
# 后果不只是难看: 之后 `make static` 里 `curl-config --static-libs` 一打印,
|
||||
# 坏字节就顺着工具输出进了对话历史, 服务端会以
|
||||
# invalid unicode code point
|
||||
# 拒掉**整个**请求, 而且坏数据已在历史里, 之后每次请求都失败.
|
||||
#
|
||||
# 本仓库路径带中文, 所以必中; 纯 ASCII 路径的人永远碰不到.
|
||||
# 让 .pc 暂时消失, curl 就退回上面那条"直接给目录"的路, 路径干干净净.
|
||||
# 藏而不是删：这些 .pc 是 OpenSSL/zlib 正常安装的一部分, 别人可能要用.
|
||||
# PCDIR/PCHIDE 和恢复用的 trap 在脚本开头 (restore_pc)：这几步要几分钟,
|
||||
# 藏而不是删: 这些 .pc 是 OpenSSL/zlib 正常安装的一部分, 别人可能要用.
|
||||
# PCDIR/PCHIDE 和恢复用的 trap 在脚本开头 (restore_pc): 这几步要几分钟,
|
||||
# 中途 Ctrl-C 很常见, 不能让 .pc 在没人知道的情况下"消失"一段.
|
||||
restore_pc # 上一次被打断留下的隐藏目录, 先放回去
|
||||
if [ -d "$PCDIR" ]; then mv "$PCDIR" "$PCHIDE"; fi
|
||||
@@ -318,7 +318,7 @@ fi
|
||||
# 光看文件在不在不够 —— 要真的**链一个用 curl 的静态程序**, 才能证明这份
|
||||
# 前缀是可用的 (静态链接最常栽在依赖顺序和缺库上, 而那只在链接时暴露).
|
||||
echo
|
||||
echo "== 自检：编一个最小程序并静态链接"
|
||||
echo "== 自检: 编一个最小程序并静态链接"
|
||||
CHECK="$SRC/check.c"
|
||||
cat > "$CHECK" <<'EOF'
|
||||
#include <curl/curl.h>
|
||||
@@ -336,7 +336,7 @@ LIBS=$("$PREFIX/bin/curl-config" --static-libs)
|
||||
if ldd "$SRC/check" 2>&1 | grep -q "not a dynamic executable\|statically linked\|不是动态可执行文件"; then
|
||||
echo " 静态链接成功, 且确实不依赖动态库"
|
||||
else
|
||||
echo " 注意：ldd 没说它是静态的, 检查一下下面这行输出：" >&2
|
||||
echo " 注意: ldd 没说它是静态的, 检查一下下面这行输出: " >&2
|
||||
ldd "$SRC/check" 2>&1 | head -3 >&2
|
||||
fi
|
||||
|
||||
@@ -345,19 +345,19 @@ fi
|
||||
# 于是会进工具输出、进对话历史、最后进请求体. 一旦含非法字节, 服务端会以
|
||||
# "invalid unicode code point" 拒掉整个请求 —— 而且坏数据已经留在历史里,
|
||||
# 之后每次请求都会失败. 上面 curl 那段的长注释解释了坏字节是怎么来的.
|
||||
# 用 iconv 做往返校验：截断的/被转义的序列都会被它拒掉. 没有 iconv 就跳过.
|
||||
# 用 iconv 做往返校验: 截断的/被转义的序列都会被它拒掉. 没有 iconv 就跳过.
|
||||
if command -v iconv >/dev/null 2>&1; then
|
||||
if "$PREFIX/bin/curl-config" --static-libs 2>/dev/null \
|
||||
| iconv -f UTF-8 -t UTF-8 > /dev/null 2>&1; then
|
||||
echo " curl-config --static-libs 输出是合法 UTF-8"
|
||||
else
|
||||
echo " 错误：curl-config --static-libs 的输出含非法 UTF-8. " >&2
|
||||
echo " 错误: curl-config --static-libs 的输出含非法 UTF-8. " >&2
|
||||
echo " 这通常意味着 configure 走了 pkg-config 那条路 (见上面 curl 那段). " >&2
|
||||
echo " 删掉这个前缀重跑本脚本：rm -rf \"$PREFIX\"" >&2
|
||||
echo " 删掉这个前缀重跑本脚本: rm -rf \"$PREFIX\"" >&2
|
||||
exit 1
|
||||
fi
|
||||
fi
|
||||
|
||||
echo
|
||||
echo "依赖就绪：$PREFIX"
|
||||
echo "接下来： make static"
|
||||
echo "依赖就绪: $PREFIX"
|
||||
echo "接下来: make static"
|
||||
Reference in new issue
Block a user