ARMv5向けリンク時の'undefined reference to __atomic_load_8'を修正する

問題

ARMv5(armel/armv5te)向けにクロスコンパイルすると、コンパイルは成功するのにリンクが次で失敗します:

errors.txt
undefined reference to `__atomic_load_8'
undefined reference to `__atomic_fetch_add_8'
undefined reference to `__atomic_store_8'

原因

ARMv5には64ビットアトミック命令がありません(LDREXD/STREXDはARMv6K以降)。コードがstd::atomic<uint64_t>(または8バイトの__atomic_*ビルトイン)を使うと、GCCはlibatomicに存在するヘルパー関数への呼び出しを生成します — これらはカーネル支援やロックで実装されています。リンクエラーはlibatomicがリンクされていないことを意味します。

修正

libatomicをリンクします:

link.sh
armv5l-linux-musleabi-g++ -static -o app app.o ... -latomic

CMakeの落とし穴:位置が重要

-latomicは、それを参照するオブジェクトファイルと静的ライブラリの後に来る必要があります — リンカは左から右へ解決します。CMakeツールチェーンファイルでCMAKE_EXE_LINKER_FLAGSには入れないでください(ライブラリの前に来て何も解決しません)。リンク行の末尾に追加されるCMAKE_<LANG>_STANDARD_LIBRARIESを使います:

toolchain-armv5l-musl.cmake
set(CMAKE_EXE_LINKER_FLAGS_INIT "-static")
set(CMAKE_C_STANDARD_LIBRARIES   "-latomic")
set(CMAKE_CXX_STANDARD_LIBRARIES "-latomic")

結果の確認

check.sh
file app
# ELF 32-bit LSB ... ARM, EABI5 ... statically linked
armv5l-linux-musleabi-nm app | grep __atomic   # should show resolved/defined

同じカテゴリの類似記事をチェック: C/C++ 組み込み Linux