在 Ubuntu 22.04 上编译以下使用 OpenSSL 库的程序时，发生了 undefined reference to `OPENSSL_init_crypto' 这一链接错误：

1
2
3
4
5

#include <openssl/evp.h>

int main() {
    OPENSSL_add_all_algorithms_noconf();
}

1
2
3
4

$ gcc -lssl -lcrypto foo.c
/usr/bin/ld: /tmp/ccHvEUdz.o: in function `main':
foo.c:(.text+0x13): undefined reference to `OPENSSL_init_crypto'
collect2: error: ld returned 1 exit status

与此同时，我在一个干净的 NixOS 系统中尝试了编译同一个文件，是能成功的：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26

{
  description = "A very basic flake";

  inputs = {
    nixpkgs.url = "github:nixos/nixpkgs?ref=nixos-unstable";
  };

  outputs =
    { self, nixpkgs }:
    let
      system = "x86_64-linux";
      pkgs = import nixpkgs { inherit system; };
    in
    {
      devShells.${system}.default = pkgs.mkShell {
        buildInputs = with pkgs; [
            openssl
        ];

        nativeBuildInputs = with pkgs; [
            gcc11
            pkg-config
        ];
      };
    };
}

1
2
3
4

NixOS$ pkg-config --cflags --libs openssl
-I/nix/store/xm6d1ig9ff7zkid1gvzsbig45m2pnlaz-openssl-3.3.2-dev/include -L/nix/store/m8gwqmn8k3jm0gbcia358mz4y00lgmbc-openssl-3.3.2/lib -lssl -lcrypto
NixOS$ gcc $(pkg-config --libs openssl) foo.c
NixOS$ ./a.out

承

为了排查问题，首先确认相关库的版本是否正确。注意在 Ubuntu 22.04 上，OpenSSL 的打包粒度很细，我把相关的包都重装了一遍（实际上还做了一堆别的检查，从略）：

1

# apt reinstall openssl libssl3 libssl-dev

接下来确认使用的 linking flags 是否正确：

1
2

$ pkg-config --cflags --libs openssl
-lssl -lcrypto

可见我使用的编译参数与 pkg-config 推荐的一样。接下来我们查看 GCC 实际使用的 .so 文件是什么：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

$ gcc --verbose -Wl,--verbose foo.c
(...略...)
/usr/bin/ld: mode elf_x86_64
(...略...)
attempt to open /usr/lib/gcc/x86_64-linux-gnu/11/libssl.so failed
attempt to open /usr/lib/gcc/x86_64-linux-gnu/11/libssl.a failed
attempt to open /usr/lib/gcc/x86_64-linux-gnu/11/../../../x86_64-linux-gnu/libssl.so succeeded
/usr/lib/gcc/x86_64-linux-gnu/11/../../../x86_64-linux-gnu/libssl.so
attempt to open /usr/lib/gcc/x86_64-linux-gnu/11/libcrypto.so failed
attempt to open /usr/lib/gcc/x86_64-linux-gnu/11/libcrypto.a failed
attempt to open /usr/lib/gcc/x86_64-linux-gnu/11/../../../x86_64-linux-gnu/libcrypto.so succeeded
/usr/lib/gcc/x86_64-linux-gnu/11/../../../x86_64-linux-gnu/libcrypto.so
(...略...)
/usr/bin/ld: /tmp/ccJpwMbq.o: in function `main':
foo.c:(.text+0x13): undefined reference to `OPENSSL_init_crypto'
/usr/bin/ld: link errors found, deleting executable `a.out'
collect2: error: ld returned 1 exit status

可见 ld 实际使用的是 /usr/lib/x86_64-linux-gnu/lib{ssl,crypto}.so 两个文件。我们使用 nm -D 命令查看相关符号是否存在：

1
2
3
4

$ nm -D /usr/lib/x86_64-linux-gnu/libssl.so | rg OPENSSL_init_crypto
                 U OPENSSL_init_crypto@OPENSSL_3.0.0
$ nm -D /usr/lib/x86_64-linux-gnu/libcrypto.so | rg OPENSSL_init_crypto
00000000001bf600 T OPENSSL_init_crypto@@OPENSSL_3.0.0

根据 nm(1p)：

1
2
3
4

"T"
"t" The symbol is in the text (code) section.

"U" The symbol is undefined.

可见 libcrypto.so 中确实定义了 OPENSSL_init_crypto 这一符号。这可奇了，为什么 ld 就是找不到它呢？

转

经过痛苦而无益的尝试，小编突然发现，只要把链接参数和源文件的顺序调转一下，就能在 Ubuntu 上成功编译了：

1
2
3
4
5
6

$ gcc -lssl -lcrypto foo.c
/usr/bin/ld: /tmp/ccIqp0ls.o: in function `main':
foo.c:(.text+0x13): undefined reference to `OPENSSL_init_crypto'
collect2: error: ld returned 1 exit status
$ gcc foo.c -lssl -lcrypto
$ ./a.out

相对地，在 NixOS 上，参数的顺序并无影响：

1
2

NixOS$ gcc $(pkg-config --libs openssl) foo.c
NixOS$ gcc foo.c $(pkg-config --libs openssl)

结

其实这一切背后的原因与 --{,no-}as-needed 这一组链接参数有关。具体的细节在 Why does the order in which libraries are linked sometimes cause errors in GCC? - Stack Overflow 这个 Stack Overflow 回答里科普得很清楚，就不多介绍啦。

需要注意的是，这两个参数的影响除了编译成功与否之外，还反映在最终的可执行文件上：如果实际上没有引用库的内容，则 --as-needed 实际上不会将可执行文件链接过去（可以使用 ldd 确认）。

由此可见，虽然 pkg-config 确实能给出（推荐的）编译参数，但怎样把这些编译参数正确地整合到编译命令里（对于没有经验的人来说）还是一件大麻烦。所以，有没有相关的编译命令自动生成 / 验证 / 修复工具（的需求）？

救救孩子……

• 设备：Redmi Note 12 Turbo
• 系统：MIUI Global 14.0.7，欧洲版（EEA，非 xiaomi.eu）

目标 / The Challenge

在上述环境下用上公交卡。

步骤 / Our Approach

1. 安装 Magisk，获取 root 权限；
2. 下载并安装 Xiaomi Wallet / com.mipay.wallet 和 Mi Smart Cards / com.miui.tsmclient；
3. 在 /data/adb/service.d 下创建一个脚本文件 set_se.sh，并赋予可执行权限。下面的命令可通过电脑端 adb shell 或手机端 Termux 执行：

   1 2 3 4 5 6 7 8 9

   $ su # cd /data/adb/service.d # echo 'resetprop ro.vendor.se.type HCE,UICC,eSE' > set_se.sh # chmod +x set_se.sh # ls -l total 4 -rwxr-xr-x 1 root root 41 2023-05-09 00:43 set_se.sh # cat set_se.sh resetprop ro.vendor.se.type HCE,UICC,eSE

4. 重启，启动小米钱包的公交卡功能，按照提示打开 NFC 设置，将默认付款应用设为内置安全模块。

每步都干了啥？

• 安装 Xiaomi Wallet——就是小米钱包啦。
• 安装 Mi Smart Cards——为了让钱包的界面顶部出现交通卡那一栏图标。
• 创建 set_se.sh——这是一个 Magisk 启动脚本，通过修改系统属性让默认付款应用中出现我们需要的选项。

相关工作 / Related Work

• MIUI EU 欧洲版 本地化 Magisk 模块 – Koizumi’s Blog——非 EU 版的我强上后喜提 bootloop……
• MIUI 国际版/EU 安装小米钱包 傻瓜教程 - 知乎——有点复杂。
• 小米錢包在歐版本安裝教學(免root 免magisk)~小米12 s Ultra試過OK~ - Mobile01——装上这两个 App 之后能打开钱包，但无法将其设为默认付款应用（没有所谓的內建安全模組）。
• MIUI 9 欧洲版移植小米公交、支付等服务 - V2EX——是这个楼让我知道要更改 build.prop，但热更改似乎不起作用。尝试用启动脚本修改，于是就解决了。

1
2
3
4
5
6
7
8
9
10
11
12

:root[sessionrestored]
     #navigator-toolbox:not([inFullscreen="true"]):not(:focus-within):not(:hover) #nav-bar,
:root[sessionrestored]
     #navigator-toolbox:not([inFullscreen="true"]):not(:focus-within):not(:hover) #PersonalToolbar {
    height: 0 !important;
    min-height: 0 !important;
    opacity: 0 !important;
}

#navigator-toolbox:not([inFullscreen="true"]) {
    --tab-min-height: 28px !important;
}

效果如图：

tl; dr: 我需要使用mitmproxy截获微信的一些HTTP通讯内容（不需要修改），具体而言是某几个网页的源代码．如果你不知道什么是maimai，那么现在你可以直接跳到第二节啦．

起因其实是顺着某bot找到了这个舞萌 DX 查分器，这里是它的使用方法．很遗憾，这3种方法对此刻的我而言都有某种不便之处……不过，这3种方法的本质显然都是提取微信上某个网页的源代码，因此我研究之后选择用mitmproxy（Fiddler Everywhere要收费）人工截取数据，然后上传给查分器．

启动mitmproxy

首先需要安装mitmproxy，用包管理器当然是最方便的：

1

# pacman -S mitmproxy

mitmproxy提供3个命令：mitmproxy、mitmweb和mitmdump，分别是它的TUI、网页和CLI版本，这里我只用到后两者．直接在终端输入mitmweb即可启动：

1
2
3

# mitmweb
Web server listening at http://127.0.0.1:8081/
Proxy server listening at http://*:8080

它会自动在浏览器中打开http://127.0.0.1:8081/，可以看到一个简单的抓包界面．接下来需要对手机进行配置．

配置Android系统

这里不同厂商/版本/语言的Android肯定有差异，请自行适配．

首先需要让手机使用mitmproxy的代理．先让电脑和手机处于同一个网络下，然后打开Settings→Wi-Fi & Network→Wi-Fi，点按当前使用的wifi右侧的齿轮进入Network details页面，然后点击右上角的铅笔，在Advanced options→Proxy中填入代理信息：种类为Manual，Proxy hostname为电脑的IP，Proxy port为8080．

然后需要导入根证书．在浏览器中打开http://mitm.it这个网址（若不出意外，此时终端里应该显示一些连接的信息），按网页上的提示下载用于Android的证书．对于Android 11以上的版本，安装此证书的步骤为：打开Settings→Security & Lock Screen→Encryption & credentials→Install a certificate，种类选择CA certificate，然后选择刚才下载的证书文件即可．如果使用完毕要删除此证书，则要在Encryption & credentials→Trusted credentials→User下操作．

为了测试配置是否正确，你可以使用Chrome（Firefox一贯只使用它自己的证书数据库）随便访问一个使用HTTPS加密的网站．如果Chrome没有报证书错误，而你在电脑的网页界面中能看到此次通讯的明文，说明你成功了．

进行捕获

首先当然要让微信在使用代理的情况下完成你需要捕获的通讯，因此请自行按需操作．不过如果你本来的目的跟我一样是查分，请回到第一节看链接里的“使用方法”．注意mitmproxy加、解密可能需要一段时间，请耐心等待网页加载完和/或多试几次．

提取需要的数据

估计mitmproxy已经捕获到完整的通讯过程后，就要想办法将真正需要的部分提取出来．

方法一：使用filter

实际上在mitmproxy的网页界面上可以直接过滤出需要的flow．点击最上面的写着Search的搜索框，就会弹出一个各种filter的介绍，这里不详细说明了（因为我没有用过）．注意这些filter在mitmproxy的其余两种界面中同样可以使用．

方法二：写一个addon

点击网页界面左上角的蓝色mitmproxy按钮，选择弹出的菜单中的Save一项，将本次捕获的内容保存下来——下文假设你保存在了./flows．（这个文件也可以在网页界面中打开．）

这里只放一段代码，不介绍概念，如果你像我一样只是想查分应当可以原封不动地使用，否则可以按需修改：

1
2
3
4
5
6
7
8
9
10
11
12
13
14

def response(flow):
    if 'diff=' in flow.request.path and 'text/html' in flow.response.headers['content-type']:
        print(flow.request.path)
        if not flow.response.content:
            print('Empty reponse, skipping')
            return
        path = './' + flow.request.path.split('&')[-1] + '.html'
        try:
            with open(path, 'w') as f:
                f.write(flow.response.content.decode())
            print('Saved as', path)
        except Exception as e:
            print('Save error: ')
            print(e)

将其保存为./print.py，然后执行如下命令：

1

$ mitmdump -nqr flows -s print.py

当前目录下的diff=*.html就是我们需要的那些网页文件了．

上述代码的作用是：对于每一个flow（其实是对于response这个事件），如果其请求的路径包含diff=，且响应的内容属于text/html类型，就将响应的内容保存在一个HTML文件中．想知道这些变量的具体类型和含义，比如flow.response，请参阅官方文档．

上面命令的参数含义如下：-n表示不启动代理服务；-q表示quiet，在这里主要作用是不显示每条flow的介绍（你可以去掉这个参数看看输出是什么样）；-r表示加载后面的文件中的flows；-s表示执行后面的脚本．详细的介绍请参看mitmdump --help．

结语

因为我的需求仅仅只是提取几个微信局域网生态内的网页的源代码，所以这份介绍就到这里——更深入的我也不会．真正卡住我的其实是安装证书那一步，因为Android 11的“设置”中安装证书的入口至少有两处，然而只有正文中写的那个入口可以成功安装mitmproxy提供的根证书，另外搞懂addon的写法也稍微花了一点工夫．

然而使我大费周章的根源（之一）其实只是这样一句话：

为了你的帐号安全，此微信号不能登录网页微信。

Shame on you, WeChat.

安装crossdev

1

# emerge -av sys-devel/crossdev

创建 overlay

然后先来建立一个 overlay，让crossdev自动把生成的 ebuild 放在里面^[1]：

1
2
3
4

# mkdir -p /var/db/repos/cross-riscv64-linux-gnu/{profiles,metadata}
# echo 'cross-riscv64-linux-gnu' > /var/db/repos/cross-riscv64-linux-gnu/profiles/repo_name
# echo 'masters = gentoo' > /var/db/repos/cross-riscv64-linux-gnu/metadata/layout.conf
# chown -R portage:portage /var/db/repos/cross-riscv64-linux-gnu

这里的riscv64-linux-gnu是Target Triple，后面还会用到．

注意如果用 Git 方式同步gentoo源（或者其他Manifest文件不含 ebuild 的校验码的方式），需要在layout.conf里添加一行：

1

echo 'thin-manifests = true' >> /var/db/repos/cross-riscv64-linux-gnu/metadata/layout.conf

最后启用这个 overlay．在/etc/portage/repos.conf/crossdev.conf中写入：

1
2
3
4
5

[cross-riscv64-linux-gnu]
location = /var/db/repos/cross-riscv64-linux-gnu
priority = 10
masters = gentoo
auto-sync = no

构建工具链

执行以下命令安装工具链：

1

# crossdev --stable --ex-gdb -t riscv64-linux-gnu -oS gentoo

此处各个参数的含义如下：

• --stable表示安装稳定 keyword 的版本，不带--stable会安装最新版（~*）；
• --ex-gdb表示除了 GCC 等基本工具外还要安装 GDB；
• -t指定 target triple，可以用crossdev -t help列出合法的值；
• -oS表示从哪些 overlay 里找 ebuild，这里指定gentoo是因为crossdev不知为什么默认会使用gentoo-zh里的gdb．

可能会因为/etc/portage/package.mask等配置文件存在但不是目录而失败，这时只要把它们转换成目录即可（创建同名目录，把原来的配置文件变成目录下的一个普通文件）．

执行完该命令后会得到/usr/riscv64-linux-gnu这个目录．

可以试着编译一个简单的程序：

1
2
3
4
5
6
7
8
9
10
11
12
13

$ cd /tmp
$ cat > hello.c
#include <stdio.h>

int main()
{
    printf("hello, world\n");
}
$ riscv64-linux-gnu-gcc -o hello hello.c
$ file hello
hello: ELF 64-bit LSB pie executable, UCB RISC-V, version 1 (SYSV), dynamically linked, interpreter /lib/ld-linux-riscv64-lp64d.so.1, for GNU/Linux 4.15.0, not stripped
$ ./hello
bash: ./hello: cannot execute binary file: Exec format error

安装 QEMU

可以用 QEMU 来直接运行 riscv64 程序．首先要启用 QEMU 模拟 riscv64 架构的功能，比如在/etc/portage/package.use中添加

1

app-emulation/qemu qemu_softmmu_targets_riscv64 qemu_user_targets_riscv64

然后重新安装 QEMU：

1

# emerge -av qemu

现在可以试着运行上面编译的hello程序：

1
2

$ qemu-riscv64 -L /usr/riscv64-linux-gnu /tmp/hello
hello, world

本文适用于如下软件版本：

• 写作时间点的Gentoo Linux
• Quartus Prime Lite 18.1

在写作时间点，Quartus Prime的最新版本为20.1．如果你被允许使用新于本文的Quartus版本，建议优先使用新版本以减少兼容性问题．

如果你使用ArchLinux，可以尝试AUR中的相关包，无需手动安装，详见参考文献．

如果你不知道怎么在Quartus中创建一个工程，也不知道ModelSim是什么，那么你需要的不只是这份文档．本文的目的仅仅是教你如何在较新的Linux系统上使Quartus Prime Lite 18.1+ModelSim正常运行．

以下主要分为四个部分：下载安装、Quartus（本体）、ModelSim、USB Blaster．

下载安装

软件可以直接从Download Center for FPGAs下载到（需注册）．直接下载Quartus-lite-18.1.0.625-linux.tar即可．

如果点击“I Agree”后没有自动开始下载，可以使用浏览器的“审查元素”截获产生的网络请求的响应内容．得到的链接无需登录，可以直接用wget等工具下载．这里不放出．

在网页上的“Updates”选项卡下可以下载到18.1.1.646版本的更新，只有安装完软件本体后才能装上．本文对应的是更新过的版本，但应该对未更新的版本也有效（未测试）．

下载完成后解压并执行setup.sh．在“Select Components”这一步注意不要选择“ModelSim - Intel FPGA Edition”（非Starter Edition），否则安装完后启动Quartus时会要求你提供许可．

Quartus

安装完Quartus，桌面上应该会多出一个Quartus图标．但如果你使用的是Gentoo等软件版本较新的发行版，大概率是无法直接通过图标启动Quartus的．如果你试图使用命令行启动Quartus，你会得到如下的结果：

1
2

$ ./quartus
quartus: error while loading shared libraries: libpng12.so.0: cannot open shared object file: No such file or directory

这提示我们缺少libpng-1.2．因此只需要把它装上即可：

• 对于Gentoo，安装libpng-compat:1.2．
• 对于其他发行版，安装libpng12或其他名字类似的包．

这应该已经足够让Quartus跑起来了．

ModelSim

启动ModelSim才是困难的部分．

设置路径

这一步非常重要．

首先创建一个工程和相应的Test Bench．打开Tools→Options，在General→EDA Tool Options下找到ModelSim-Altera这一项．把原本的目录换成：

1

<安装目录>/intelFPGA_lite/18.1/modelsim_ase/bin

为了确认，你填写的路径下应该有一个符号链接vsim，指向../vco．

（为什么不使用默认的modelsim_ase/linuxaloem？因为这个目录下是裸的二进制文件，我们接下来在脚本中配置的环境变量对它们无效．）

当你想单独启动ModelSim的时候，你也应该直接执行符号链接vsim．（但在你完成下面的步骤之前，你应该是没有办法做到这件事情的．）

安装32位库

现在试试Tools→Run Simulation Tool→RTL Simulation，不出所料应该会弹出一个错误提示：

Nativelink Error
Can’t launch ModelSim-Altera Simulation software（中略）Check the NativeLink log file（中略）for detailed error messages

出现这个错误的原因是你安装的ModelSim是32位版本，而系统中没有安装所有它需要的32位库．你可以在Install dependencies中找到一个完整的列表，此处引用如下：

Let us first install the native versions of the required packages: expat fontconfig freetype2 xorg-fonts-type1 glibc gtk2 libcanberra libpng libpng12 libice libsm util-linux ncurses tcl tcllib^AUR zlib libx11 libxau libxdmcp libxext libxft libxrender libxt libxtst ld-lsb.
And the multilib versions: lib32-expat lib32-fontconfig lib32-freetype2 lib32-glibc lib32-gtk2 lib32-libcanberra lib32-libpng lib32-libpng12 lib32-libice lib32-libsm lib32-util-linux lib32-ncurses lib32-zlib lib32-libx11 lib32-libxau lib32-libxdmcp lib32-libxext lib32-libxft lib32-libxrender lib32-libxt lib32-libxtst.
You are now ready to install and launch Quartus Prime.

注意这些包名都是Arch Linux的，在其他发行版上可能有类似但不同的名字．在Gentoo上一部分包被称作xxx-compat，比如在我的机器上唯一缺少的库是libncurses.so.5，属于ncurses-compat:5.9．注意lib32前缀对应到USE flagabi_x86_32．

如果不确定，可以用下面的命令找出ModelSim需要但系统中缺少的库：

1
2

cd <安装目录>/intelFPGA_lite/18.1/modelsim_ase/linuxaloem
find . -executable -exec ldd {} + 2> /dev/null | grep 'not found'

如果所有依赖都已经安装完毕，上述命令应该没有任何输出．

修改vco

安装了这么多包，胜利就在眼前了……？好像并不是这样．

再次执行RTL Simulation，尽管主窗口下半部分的Messages中显示Successfully launched NativeLink simulation，但除此之外什么也没有发生．

接下来我们需要许多命令行操作．请打开终端并切换到你刚刚在EDA Tool Options→ModelSim-Altera下填写的路径：

1

cd <安装目录>/intelFPGA_lite/18.1/modelsim_ase/bin

现在执行vsim：

1
2

$ ./vsim
Error: cannot find "./../linux_rh60/vsim"

原来，vsim指向的vco是一个Shell脚本，其中对当前内核版本做了判断．对于未知的内核版本，它会从../linux_rh60这个不存在的位置寻找相应的二进制文件！现在修改这个脚本，让它找到正确的目录../linux，注意需要先对它加上写权限：

1
2

chmod u+w ../vco
sed -i 's/linux_rh60/linux/g' ../vco

现在执行./vsim，应该不会报找不到./../linux_rh60/vsim的错误了——取而代之的是下面这个错误：

1
2

（前略）
** Fatal: Read failure in vlm process (0,0)

解决方案见下一节．

FreeType和Fontconfig

ArchWiki上已经提供了对该错误的解决方案．简而言之，这是FreeType版本过新引起的错误．然而对于较新的发行版，官方源中已经难以找到相应版本的库了．如果你使用其他发行版，可能可以从一些存档网站找到旧版的包；而如果你使用Gentoo，那么你需要手动下载freetype-2.4.12.tar.bz2并编译——注意你需要的是32位库．

A Guide on Getting ModelSim to Work on Linux提供了此处的详细步骤（稍有改动）：

1
2
3
4
5

cd ~/Downloads
tar jxvf freetype-2.4.12.tar.bz2
cd freetype-2.4.12
./configure --build=i686-pc-linux-gnu "CFLAGS=-m32" "CXXFLAGS=-m32" "LDFLAGS=-m32"
make -j8

然后回到<安装目录>/intelFPGA_lite/18.1/modelsim_ase，执行：

1
2

mkdir lib32
cp ~/Downloads/freetype-2.4.12/objs/.libs/libfreetype.so* ./lib32

接下来，你需要让ModelSim使用你刚刚编译的FreeType库．而且因为这个库版本太老，我们不希望把它直接安装在系统中．打开../vco，找到这一行：

1

dir=`dirname $arg0`

在后面添加一行：

1

export LD_LIBRARY_PATH=${dir}/lib32

重新运行./vsim……等一下，怎么还是报错？

1
2
3

$ ./vsim
（前略）
** Fatal: Read failure in vlm process (0,0)

这其实是因为Fontconfig与FreeType的版本不匹配（可以使用GDB跟踪发现）．万能的ArchWiki上又提供了解决方案：使用fontconfig-2.12.6．

取得旧版本fontconfig的方法与上面大致相同．如果你直接编译，可以使用以下命令：

1
2
3
4

mkdir image
./configure --build=i686-pc-linux-gnu --host=i686-pc-linux-gnu --disable-static --disable-docs --prefix=${PWD}/image
make -j8
make install # 当屏幕上显示fc-cache -s -f -v时就可以Ctrl-C了

则安装产生的目录结构位于./image．

如果你使用Gentoo，也可以让Portage帮你编译：

1
2

cd /var/db/repos/gentoo/media-libs/fontconfig
PORTAGE_TMPDIR=/tmp USE=abi_x86_32 ebuild fontconfig-2.12.6.ebuild clean install

这会把旧版的fontconfig安装到/tmp/portage/media-libs/fontconfig-2.12.6/image这个目录中．其中usr/lib下的才是32位库，可以用file命令确认：

1
2

$ file libfontconfig.so.1.10.1
libfontconfig.so.1.10.1: ELF 32-bit LSB shared object, Intel 80386, version 1 (SYSV), dynamically linked, stripped

接下来把所有的32位so文件转移到lib32下，再一次启动vsim．

如果你成功了——别急，先试试RTL Simulation．如果也没有问题，恭喜，你不需要看下去了；上面编译Fontconfig的目录也可以删掉了．

如果没有成功——请不要删除上面得到的image目录．它对我们还有用处．

修改fonts.conf

网上大多数资料顶多只告诉你降级fontconfig这一步．但很不幸，我做完上述步骤（实际上不包括更改ModelSim-Altera所在路径这一步）后还是卡住了：

1
2
3

$ ./vsim
Reading pref.tcl
Fontconfig error: Cannot load default config file

然后终端就……没有反应了．没有输出，vsim也不会自己结束，只能C-z然后kill %1．

启发我的是放置N分钟后ModelSim的GUI突然成功显示这件事．类似的现象我在另一个软件上也遇到过：Telegram starts slow on Linux · Issue #4240 · telegramdesktop/tdesktop，而当时的情况跟现在如出一辙：软件使用了（bundle了）比系统版本更低的fontconfig！而之所以ModelSim需要花费这么长的时间来启动，想必是因为它需要时间来重新缓存所有的字体．

具体排查过程略过，最后的解决方案是从刚刚的image目录（即旧版fontconfig安装的目录）找到etc/fonts.conf，把它复制到~/.fonts.conf.legacy，然后编辑复制得到的文件．

一方面我们不需要它缓存太多字体．ModelSim在我的机器上只用到Courier和unifont这两个字体，因此可以删去原有的

1
2
3

<dir>/usr/share/fonts</dir>
<dir prefix="xdg">fonts</dir>
<dir>~/.fonts</dir>

等行，换成

1
2

<dir>/usr/share/fonts/unifont</dir>
<dir>/usr/share/fonts/Type1</dir>

如果有其他需要缓存的字体目录，也可以在这里加入．

另一方面，我们不希望让旧版、新版Fontconfig的字体缓存混在一起，因此我们创建一个新的缓存目录：

1

mkdir ~/.cache/fontconfig-old

然后再次编辑~/.fonts.conf.legacy，去掉原来的缓存设置：

1
2
3

<cachedir>/tmp/fontconfig-2.12.6/image/var/cache/fontconfig</cachedir>
<cachedir prefix="xdg">fontconfig</cachedir>
<cachedir>~/.fontconfig</cachedir>

然后加上

1

<cachedir>~/.cache/fontconfig-old</cachedir>

保存！

接下来再编辑vco（如果一开始没有更改ModelSim-Altera工具的路径，就会产生命令行中执行./vsim可以调出GUI，但无法由Quartus启动ModelSim的现象），在我们曾经编辑过的export LD_LIBRARY_PATH=${dir}/lib32这一行下面，添加一行

1

export FONTCONFIG_FILE="${HOME}/.fonts.conf.legacy"

这样，我们的ModelSim不但使用了正确的旧版32位fontconfig-2.12.6，还使用了适合这个旧版Fontconfig的配置文件．还有什么理由阻止ModelSim的启动呢？

现在再分别试试./vsim和RTL Simulation吧！如果依然失败……

要不，出去买张彩票？

USB Blaster

这一部分不需要很多特别的设置，以下内容来自ArchWiki：

编辑/etc/udev/rules.d/51-altera-usb-blaster.rules，添加：

1
2
3
4
5

SUBSYSTEM=="usb", ATTR{idVendor}=="09fb", ATTR{idProduct}=="6001", MODE="0666"
SUBSYSTEM=="usb", ATTR{idVendor}=="09fb", ATTR{idProduct}=="6002", MODE="0666"
SUBSYSTEM=="usb", ATTR{idVendor}=="09fb", ATTR{idProduct}=="6003", MODE="0666"
SUBSYSTEM=="usb", ATTR{idVendor}=="09fb", ATTR{idProduct}=="6010", MODE="0666"
SUBSYSTEM=="usb", ATTR{idVendor}=="09fb", ATTR{idProduct}=="6810", MODE="0666"

然后重新加载udev rules：

1

# udevadm control --reload

如果依然无法检测到设备，请参考USB Blaster not working．

Troubleshooting

Failed to obtain lock: couldn't open "/home/<USER>/.modelsim_lock": file already exists

用ps找出所有vsim相关进程并kill掉，然后删除该文件即可．

ModelSim字体太小

这是小问题．在Tools→Edit Preferences→Fonts中换用大号字体即可．注意应用设置后的实际显示大小可能比预览的要小．

参考文献

1. Altera Design Software - ArchWiki
2. A Guide on Getting ModelSim to Work on Linux
3. DoodleTs: Running ModelSim-Altera from the Quartus Prime Lite IDE under Linux

听说不少人一放假就喜欢装黑苹果，然而手上并没有Hackintosh-friendly的机器的我，只能用重装Gentoo的方式来祭奠一下逝去的青春啦（悲）。

这里随便记录一些安装和配置过程中的琐事，便于日后查询。

持续更新中。

Major Changes (since 2019?)

Portage

• 由portage管理的源（？）的默认位置统一移到了/var/db/repos，官方源（原/usr/portage）现在在/var/db/repos/gentoo。
• emerge现在不会再默认帮你选择一个作为依赖安装的不稳定包的版本了，如果需要的话要加上参数--autounmask=y。
  • 这实际上是https://bugs.gentoo.org/658648.

Non-Portage

• 本来安装流程里/etc/timezone是个符号链接，现在它变成了一个文本文件，里面直接写时区，比如Asia/Tokyo。

配置

全盘加密（LUKS）

这里有一个Handbook里没有明确指出的地方：如果你使用systemd，需要启用cryptsetup这个USE。

否则你是没有systemd-cryptsetup-generator来帮你生成systemd-cryptsetup@.service的，这样你的分区就没有办法在启动时被解密。

Overlay

• 以前overlay一般交给layman管理，缺点是layman -S需要在eix-sync之前单独执行。（还是我的用法不对？）
  这次读wiki的时候发现了eselect repository（app-eselect/eselect-repository）这个新玩意，用法很简单：

  • eselect repository list列出所有repo；
  • eselect repository enable/disable启用或禁用某个repo。注意这并不会把该repo的内容同步下来，所以你还要运行一次eix-sync。

  这样启用的repo的配置可以在/etc/portage/repos.conf/eselect-repo.conf里找到。

  • FYI：在repos.gentoo.org可以看到一个现存repo的列表，并且区分了官方和非官方源。

• 一个overlay里常常有一大堆的包，而你一般只需要其中的少数几个。为了防止这种“命名空间污染”和可能带来的依赖问题，可以每添加一个overlay就在package.mask里加上：

  1	*/*::name-of-the-overlay

  然后只把需要的包unmask掉即可。

  • 注：实际上这种做法可能不小心unmask掉该overlay在profiles里面mask掉的包。当然你也可以只unmask掉你需要的版本，但这样比较麻烦，而且包不会被自动更新。
  • 为了同样的目的有时还需要设置不同源的优先级。注意overlay默认优先级是比gentoo要高的。

蓝牙

按照wiki上操作即可，但要记得启用bluetooth.service（systemd）。

NVIDIA Optimus

已经有有热心人士为Gentoo打包了Optimus Manager（见gpo.zugaina.org），直接用上面的方法添加jorgicio这个源并安装optimus-manager及optimus-manager-qt即可。

安装完以后做以下两件事：

• /usr/bin/prime-switch-boot这个脚本需要Python ≥ 3.7，如果执行python3启动的是较低的版本，需要在eselect python里切换到3.7以上。
• 创建/etc/X11/xorg.conf.d目录，optimus-manager需要在那里生成配置文件。

然后让optimus-manager.service和optimus-manager-qt自动启动即可。如果显示Hybrid模式并能启动nvidia-settings说明成功了。

软件

Haskell

建议添加haskell这个overlay（同样由官方维护），里面有最新的GHC。

想省下编译GHC的时间，启用binary这个USE即可。

另外，建议全部相关的包都使用haskell源里的版本而非gentoo里的版本，否则可能产生循环依赖等问题。

npm

直接安装net-libs/nodejs即可。但官方不推荐越过portage安装全局包，作为workaround可以在~/.npmrc里加上这么一行：

1

prefix=/home/<USER>/.node

然后把相应路径添加到$PATH里。

Wine

官方源里现在有四个版本的Wine本体：virtual/wine和app-emulation/wine-{vanilla,staging,any}。官方推荐直接安装virtual/wine即可，它会按照你的USE flag自动选择合适的wine版本（有staging时优先选择wine-staging，否则优先选择wine-vanilla）。

但我明明在package.use里加了staging啊，为什么还是自动选择了wine-vanilla？

emerge表示staging并没有启用并且画了个括号（(-staging)）。百度了一下发现大概是这个USE flag被禁用的意思。原来在我的profile（/var/db/repos/gentoo/profiles/arch/amd64/package.use.stable.mask）里面有这么一行：

1

virtual/wine staging

解决方案也很简单，在package.accept_keywords里加上virtual/wine ~amd64就行了。

Firefox

字体fallback不正确

如果Firefox会在某些时候选择错误的字体——比如，用sans-serif显示一段中文，当font-weight是400、500、600的时候用的字体各不相同（！），试着在about:config里把gfx.font_rendering.fontconfig.max_generic_substitutions调成一个较大的值。

杂项

fsck.f2fs

装完系统以后发现启动异常地快（本来fsck.f2fs在内核版本变更的时候会花很长时间来进行检查），看日志（journalctl -u systemd-fsck-root.service）发现根文件系统的检查直接被跳过了：

fsck.f2fs doesn't exist, not checking file system.

原来其他的fsck们都在/sbin里，而fsck.f2fs在/usr/sbin下面（为啥呢……），所以没有被默认包含在initramfs里面。所以我们只需要在dracut.conf里加上（详见dracut.conf (5)）

1

fscks="umount mount /usr/sbin/fsck* /sbin/fsck* xfs_db xfs_check xfs_repair e2fsck jfs_fsck reiserfsck btrfsck"

然后dracut --force重新构建initramfs即可。

保存编译进度

FEATURES="keepwork"，用完以后记得关上，不然编译产生的临时文件会一直积累。

这个功能好像存在很久很久了，为什么我之前都不知道（悲）。

KDE Application Menu Button Does Not Work for Electron Apps

解决方案在这里：安装dev-libs/libdbusmenu即可（我启用了gtk和gtk3两个USE flag）。

注 这是KDE的一个小功能，可以把窗口的菜单栏变成titlebar上的一个按钮。你可以在System Settings的Application Style->Window Decorations->Titlebar Buttons里找到它。

一些有趣的包

cppman （app-doc/cppman）

C++文档from cpluscplus.com & cppreference.com，详见https://github.com/aitjcize/cppman。

碎碎念

• 虽然很多官方源里缺少的包在overlay里可以找到，但比较分散，而且找overlay还要借助gpo.zugaina.org，总体确实不如AUR方便。
• 编译耗时太长了 都用Gentoo了还在意编译时长
• 拿到静态库比Arch容易太多了（虽然主要是交作业需要），启用static-libs即可。
  • 题外话：由于Arch坚持只ship动态库的做法，官方源里一个叫haskell-yesod-default的包在本文写作时间点的版本号达到了惊人的1.2.0-**732**，真是活久见。
• eix打起来比pacman -Ss快多了——这一点当然很重要，要知道有个函数叫creat……
• media-fonts下面那一堆~amd64的keyword有点让人疑惑（尤其是{un,}stable共存的）：一个unstable的字体是啥样的啊……

后续计划

LFS（逃）

1

SQLSTATE[42S22]: Column not found: 1054 Unknown column 'entity' in 'where clause'

幸而手动加上这一列以后就能正常完成更新了，顺带复习了一下SQL（逃

1

ALTER TABLE "oc_flow_operation" ADD entity varchar(256) COLLATE utf8mb4_bin NOT NULL DEFAULT '';

P. S. GitHub上亦有此issue，看起来受影响的人还不少……见Issue while upgrading to 18 Beta1 (SQL, related to Flow) · Issue #18265 · nextcloud/server.

问题

详细症状如下：

• 能成功休眠；
• 重启后加载完休眠映像后迅速黑屏，这时reisub无效且硬盘灯不亮；
• 日志结束在PM: hibernation entry处.

解决方案

一番周折后开始考虑内核问题. 在archlinux_pkg_linux directory listing可以找到linux这个包的所有历史版本. 用二分法可以锁定到是4.16.7版本的某些更新内容导致了唤醒失败，于是找到了这个页面：199747 – resume from hibernate results in kernel panic (bisected).

（报告人表示重启后Caps Lock狂闪，然而神舟的这台笔记本并没有键盘指示灯……）

网页上给出的一种解决方案是把intel_lpss_pci这个模块放在initramfs里面. 在Arch Linux上编辑/etc/mkinitcpio.conf：

1

MODULES=(... intel_lpss_pci ...)

然后重新生成initramfs：

1

# mkinitcpio -P

重启后应该就可以正常唤醒了.

Troubleshooting

触摸板

执行上述步骤可以正常唤醒，然而唤醒以后触摸板会死掉.

按照网页上的提示，需要在唤醒后重新加载intel_lpss_pci这个模块。创建/etc/systemd/system/touchpad-after-resume.service并添加以下内容：

1
2
3
4
5
6
7
8
9
10

[Unit]
Description=Reload touchpad
After=sleep.target suspend.target hibernate.target hybrid-sleep.target

[Service]
Type=oneshot
ExecStart=sh -c 'modprobe -r intel_lpss_pci && modprobe intel_lpss_pci'

[Install]
WantedBy=sleep.target suspend.target hibernate.target hybrid-sleep.target

然后启用这个unit.

1

# systemctl enable touchpad-after-resume

现在触摸板可以在唤醒后正常工作了，但是所有设置（滚动、单击、移动速度……）全都会被重置，只有在系统设置里把触摸板设置重新应用一次解决方案在下面：

Update 2020-01-19: 今天发现写在/etc/X11/xorg.conf.d/30-touchpad.conf里的触摸板设置会在唤醒后（实际上应该是X重新检测到触摸板的时候）自动应用，所以只需要把相关设置放在这个文件里即可. 步骤如下：

1. 执行xinput，找到写有Touchpad之类字眼的那一行，记住id=后的数字；
2. 用xinput list-props <id>列出触摸板设置，重点关注与Default不一样的值；
3. 创建/etc/X11/xorg.conf.d/30-touchpad.conf，写入如下内容：

1
2
3
4
5

Section "InputClass"
    Identifier "Touchpad"
    Driver "libinput"
    ...
EndSection

然后参照libinput(4)把触摸板设置翻译成Xorg配置文件的格式，填在…的地方就可以啦.