Android 11 以降で利用可能なアプリケーション バイナリ インターフェース(ABI)モニタリング ツールを使用して、Android カーネルのカーネル内 ABI を安定させることができます。このツールは、既存のカーネル バイナリ(vmlinux
+ GKI モジュール)から ABI 表現を収集して比較します。これらの ABI 表現は、.stg
ファイルとシンボルリストです。この表現がビューを提供するインターフェースを、カーネル モジュール インターフェース(KMI)と呼びます。このツールを使用して、KMI の変更を追跡し、軽減できます。
ABI モニタリング ツールは AOSP で開発されたもので、STG(または Android 13 以前では libabigail
)を使用して表現を生成し、比較します。
このページでは、このツールや、ABI 表現の収集と分析のプロセス、カーネル内 ABI を安定させるための ABI 表現の使用方法について説明します。また、Android カーネルの変更に貢献するための情報も提供します。
プロセス
カーネルの ABI を分析するには複数のステップが必要ですが、そのほとんどは自動化できます。
以下の手順は、サポートされているツールチェーン(ビルド済みの Clang ツールチェーンなど)を使用してビルドできるカーネルの場合に使用できます。repo manifests
は、すべての Android 共通カーネル ブランチと複数のデバイス固有カーネルで使用できます。これにより、分析用のカーネル ディストリビューションをビルドするときに正しいツールチェーンが使用されるようになります。
シンボルリスト
KMI には、カーネル内のすべてのシンボルや、30,000 以上のエクスポートされたシンボルがすべて含まれているわけではありません。代わりに、ベンダー モジュールで使用できるシンボルは、カーネルツリーのルートで公開されているシンボルリスト ファイルのセットに明示的にリストされます。すべてのシンボルリスト ファイル内のすべてのシンボルを合わせたものが、安定版として維持される KMI シンボルのセットとなります。シンボルリスト ファイルの一例を挙げると abi_gki_aarch64_db845c であり、DragonBoard 845c に必要なシンボルを宣言しています。
シンボルリストにリストされているシンボルと、関連する構造および定義のみが、KMI の一部とみなされます。必要なシンボルが存在しない場合は、シンボルリストの変更を送信できます。新しいインターフェースがシンボルリストに含まれると、KMI の一部として記載され、安定版として維持されます。ブランチが固定された後でシンボルリストから削除または変更されることはありません。
Android 共通カーネル(ACK)の各 KMI カーネル ブランチには、独自のシンボルリストのセットがあります。異なる KMI カーネル ブランチ間で ABI の安定性を提供する試みは行われていません。たとえば、android12-5.10
の KMI は、android13-5.10
の KMI から完全に独立しています。
ABI ツールは、KMI シンボルリストを使用して、安定性のモニタリングが必要となるインターフェースを限定します。メイン シンボルリストには、GKI カーネル モジュールで必要なシンボルが含まれています。ベンダーは、使用するインターフェースが ABI の互換性を維持できるように、追加のシンボルリストを送信して更新する必要があります。たとえば、android13-5.15
のシンボルリストのリストについては、https://android.googlesource.com/kernel/common/+/refs/heads/android13-5.15/android
をご覧ください。
シンボルリストには、特定のベンダーまたはデバイスに必要と報告されたシンボルが含まれています。ツールで使用されるシンボルの完全なリストは、すべての KMI シンボルリスト ファイルを結合したものです。ABI ツールにより、関数のシグネチャやネストされたデータ構造など、各シンボルの詳細が決定されます。
KMI が固定された場合でも、既存の KMI インターフェースに変更を加えることはできません。これらは安定しています。ただし、既存の ABI の安定性に影響しない限り、KMI にはいつでも自由にシンボルを追加できます。新しく追加されたシンボルは、KMI シンボルリストで引用されるとすぐに安定版として維持されます。シンボルは、そのシンボルに依存するデバイスが出荷されていないことを確認できた場合を除き、カーネルのリストから削除しないでください。
デバイスの KMI シンボルリストは、シンボルリストの使用方法の手順に沿って生成できます。多くのパートナーは、ACK ごとに 1 つのシンボルリストを送信しますが、これは厳格な要件ではありません。メンテナンスに役立つ場合は、複数のシンボルリストを送信できます。
KMI を拡張する
KMI シンボルと関連構造は安定版として維持されます(つまり、固定された KMI があるカーネルにおいて安定したインターフェースを破壊する変更は認められません)。その一方で、GKI カーネルは拡張可能なままであるため、年内後半に出荷されるデバイスでは、KMI が固定される前にすべての依存関係を定義する必要はありません。KMI を拡張するには、新規または既存のエクスポートされたカーネル関数の KMI に新しいシンボルを追加します。この処理は KMI が固定されている場合でも可能です。KMI の互換性を損なわなければ、新しいカーネルパッチも使用できます。
KMI の互換性の問題について
カーネルにはソースがあり、それらのソースからバイナリがビルドされます。ABI モニタリングの対象となるカーネル ブランチには、現在の GKI ABI を表現する ABI が(.stg
ファイルの形式で)含まれています。バイナリ(vmlinux
、Image
、および任意の GKI モジュール)がビルドされた後、バイナリから ABI 表現を抽出できます。カーネルソース ファイルに変更を加えると、バイナリに影響を及ぼし、抽出された .stg
も影響を受ける可能性があります。AbiAnalyzer
アナライザは、コミットされた .stg
ファイルと、ビルド アーティファクトから抽出されたファイルを比較し、セマンティックの違いが見つかった場合は Gerrit で変更に Lint-1 ラベルを設定します。
ABI の互換性の問題に対処する
一例として、次のパッチは非常に明白な ABI の互換性の問題をもたらします。
diff --git a/include/linux/mm_types.h b/include/linux/mm_types.h
index 42786e6364ef..e15f1d0f137b 100644
--- a/include/linux/mm_types.h
+++ b/include/linux/mm_types.h
@@ -657,6 +657,7 @@ struct mm_struct {
ANDROID_KABI_RESERVE(1);
} __randomize_layout;
+ int tickle_count;
/*
* The mm_cpumask needs to be at the end of mm_struct, because it
* is dynamically sized based on nr_cpu_ids.
このパッチを適用してビルド ABI を実行すると、ツールはゼロ以外のエラーコードで終了し、次のような ABI の違いを報告します。
function symbol 'struct block_device* I_BDEV(struct inode*)' changed
CRC changed from 0x8d400dbd to 0xabfc92ad
function symbol 'void* PDE_DATA(const struct inode*)' changed
CRC changed from 0xc3c38b5c to 0x7ad96c0d
function symbol 'void __ClearPageMovable(struct page*)' changed
CRC changed from 0xf489e5e8 to 0x92bd005e
... 4492 omitted; 4495 symbols have only CRC changes
type 'struct mm_struct' changed
byte size changed from 992 to 1000
member 'int tickle_count' was added
member 'unsigned long cpu_bitmap[0]' changed
offset changed by 64
ビルド時に検出された ABI の違い
エラーの最も一般的な理由は、ドライバがカーネルのシンボルリストにない新しいシンボルを使用していることです。
シンボルがシンボルリスト(android/abi_gki_aarch64
)に含まれていない場合は、最初にそのシンボルが EXPORT_SYMBOL_GPL(symbol_name)
でエクスポートされていることを確認してから、ABI XML 表現とシンボルを更新する必要があります。たとえば、次の変更を行うと、新しい増分 FS 機能が android-12-5.10
ブランチに追加され、シンボルリストと ABI XML 表現が更新されます。
- 機能変更の例は aosp/1345659 にあります。
- シンボルリストの例は aosp/1346742 にあります。
- ABI XML の変更例は aosp/1349377 にあります。
シンボルがエクスポート済み(自分でエクスポートしたか、以前にエクスポート済み)であるが他のドライバによって使用されていない場合、次のようなビルドエラーが発生する可能性があります。
Comparing the KMI and the symbol lists:
+ build/abi/compare_to_symbol_list out/$BRANCH/common/Module.symvers out/$BRANCH/common/abi_symbollist.raw
ERROR: Differences between ksymtab and symbol list detected!
Symbols missing from ksymtab:
Symbols missing from symbol list:
- simple_strtoull
この問題を解決するには、カーネルと ACK の両方で KMI シンボルリストを更新します(ABI 表現を更新するをご覧ください)。ACK 内の ABI XML とシンボルリストを更新する例については、aosp/1367601 を参照してください。
カーネル ABI の互換性の問題を解決する
カーネル ABI の互換性の問題に対処するには、ABI を変更しないようにコードをリファクタリングするか、ABI 表現を更新します。次の図を参考に、現在の状況に最適な方法を決定してください。
図 1. ABI の互換性の問題の解決
コードをリファクタリングして ABI の変更を回避する
既存の ABI が変更されないようにします。多くの場合、コードをリファクタリングすると、ABI に影響する変更を削除できます。
構造体フィールドの変更をリファクタリングする。変更によりデバッグ機能の ABI を変更する場合は、フィールド(構造体とソースの参照)を囲む
#ifdef
を追加し、#ifdef
に使用するCONFIG
が本番環境の defconfig とgki_defconfig
で無効になるようにします。ABI の互換性を損なうことなくデバッグ構成を構造体に追加する方法の例については、このパッチセットをご覧ください。コアカーネルを変更しないように機能をリファクタリングする。パートナー モジュールをサポートするために新しい機能を ACK に追加する必要がある場合は、カーネル ABI の変更を回避するために、変更の ABI 部分をリファクタリングしてください。カーネル ABI を変更せずに既存のカーネル ABI を使用して機能を追加する例については、aosp/1312213 を参照してください。
互換性が損なわれた ABI を Android Gerrit で修正する
カーネル ABI の互換性を意図的に損なったのでなければ、ABI モニタリング ツールで提供されるガイダンスに沿って調査する必要があります。互換性の問題のよくある原因は、変更されたデータ構造と関連するシンボル CRC の変更、またはそのいずれかにつながる構成オプションの変更です。まずは、ツールで見つかった問題に対処します。
ABI の結果をローカルで再現できます。カーネルとその ABI 表現をビルドするをご覧ください。
Lint-1 ラベルについて
固定 KMI または確定済み KMI を含むブランチに変更をアップロードする場合は、その変更において、互換性のない形で安定版 ABI に影響しないように AbiAnalyzer
を渡す必要があります。このプロセスでは、AbiAnalyzer
はビルド(通常のビルドに続いて ABI の抽出および比較の各ステップを実行する拡張ビルド)の際に作成される ABI レポートを探します。
AbiAnalyzer
は、空ではないレポートを検出すると、Lint-1 ラベルを設定します。解決される(パッチセットが Lint+1 ラベルを受け取る)まで、変更の送信はブロックされます。
カーネル ABI を更新する
ABI の変更が避けられない場合は、コードの変更、ABI 表現、シンボルリストを ACK に適用する必要があります。GKI の互換性を損なわずに Lint-1 ラベルを受け取らないようにするには、次の手順を行います。
パッチセットのコードレビュー +2 を受け取るまで待ちます。
コードの変更と ABI の更新の変更を統合します。
ABI コードの変更を ACK にアップロードする
ACK ABI を更新する方法は、変更の種類によって異なります。
ABI の変更が CTS テストまたは VTS テストに影響する機能に関連する場合、通常はその変更をそのまま ACK で選べます。次に例を示します。
- 音声が機能するには aosp/1289677 が必要です。
- USB が機能するには、aosp/1295945 が必要です。
ABI の変更が ACK と共有可能な機能に対するものである場合、その変更をそのまま ACK で選べます。たとえば、以下の変更は CTS テストや VTS テストでは必要ありませんが、ACK で共有しても問題ありません。
- aosp/1250412 は熱的機能の変更です。
- aosp/1288857 は
EXPORT_SYMBOL_GPL
の変更です。
ABI の変更により、ACK に含める必要のない新機能が導入された場合は、次のセクションで説明するように、スタブを使用してシンボルを ACK に導入できます。
ACK にスタブを使用する
スタブは、パフォーマンスや電源の変更など、ACK にメリットがないコアカーネルの変更にのみ必要です。以下では、GKI の ACK でのスタブと部分的な選択の例を示します。
コア分離機能スタブ(aosp/1284493)。この機能は ACK では必須ではありませんが、モジュールでシンボルを使用するには、そのシンボルが ACK に存在する必要があります。
ベンダー モジュールのプレースホルダ シンボル(aosp/1288860)。
プロセスごとの
mm
イベント トラッキング機能の ABI のみの選択(aosp/1288454)。元のパッチは ACK で選択され、task_struct
とmm_event_count
の ABI 差分の解決に必要な変更のみが含まれています。このパッチは、最終メンバーを含むようにmm_event_type
列挙型も更新します。新しい ABI フィールドの追加以外の操作も必要となる熱的構造体 ABI の変更を部分的に選択しました。
パッチ aosp/1255544 はパートナー カーネルと ACK の間の ABI の違いを解決しました。
パッチ aosp/1291018 は以前のパッチの GKI テスト中に見つかった機能に関する問題を修正しました。この修正には、複数の温度帯を単一のセンサーに登録するようにセンサー パラメータ構造体を初期化することも含まれていました。
CONFIG_NL80211_TESTMODE
ABI の変更(aosp/1344321)。このパッチにより、ABI に必要な構造体の変更が追加され、追加されたフィールドにより機能面の差異が生じないようになりました。これにより、パートナーが本番環境カーネルにCONFIG_NL80211_TESTMODE
を組み込み、GKI のコンプライアンスを維持できるようになりました。
実行時に KMI を適用する
GKI カーネルは TRIM_UNUSED_KSYMS=y
構成オプションと UNUSED_KSYMS_WHITELIST=<union
of all symbol lists>
構成オプションを使用して、エクスポートされるシンボル(EXPORT_SYMBOL_GPL()
を使用してエクスポートされるシンボルなど)をシンボルリストにあるものに限定します。その他のシンボルはすべてエクスポートされません。また、エクスポートされていないシンボルを必要とするモジュールの読み込みは拒否されます。この制限はビルド時に適用され、欠落しているエントリにはフラグが設定されます。
開発には、シンボルをカットしない GKI カーネルビルドを使用できます(つまり、通常エクスポートされるシンボルはすべて使用できます)。これらのビルドを見つけるには、ci.android.com で kernel_debug_aarch64
ビルドを探します。
モジュール バージョニングを使用して KMI を適用する
汎用カーネル イメージ(GKI)カーネルは、実行時に KMI コンプライアンスを適用するための追加の手段として、モジュール バージョニング(CONFIG_MODVERSIONS
)を使用します。モジュール バージョニングでは、モジュールの予想される KMI が vmlinux
KMI と一致しない場合、モジュール読み込み時に巡回冗長検査(CRC)の不一致エラーが発生することがあります。シンボル module_layout()
の CRC 不一致によりモジュール読み込み時に発生する一般的なエラーの例を次に示します。
init: Loading module /lib/modules/kernel/.../XXX.ko with args ""
XXX: disagrees about version of symbol module_layout
init: Failed to insmod '/lib/modules/kernel/.../XXX.ko' with args ''
モジュール バージョニングの使用
モジュール バージョニングが有用である理由として、次の点が挙げられます。
モジュール バージョニングは、データ構造の公開設定の変更を捕捉します。モジュールが不透明なデータ構造、つまり KMI に含まれないデータ構造を変更する場合、将来的に構造が変更されるとモジュールの互換性が破られます。
例として、
struct device
のfwnode
フィールドについて考えてみましょう。このフィールドは、device->fw_node
のフィールドを変更したり、そのサイズについて推測したりできないように、モジュールに対して不透明でなければなりません。ただし、モジュールに
<linux/fwnode.h>
が(直接的または間接的に)含まれている場合、struct device
のfwnode
フィールドは不透明でなくなります。すると、モジュールはdevice->fwnode->dev
またはdevice->fwnode->ops
を変更できます。このシナリオには次のような理由から、問題があります。コアカーネル コードで内部データ構造に対して行っている仮定が破られる可能性があります。
将来のカーネル更新で
struct fwnode_handle
(fwnode
のデータ型)が変更された場合、モジュールが新しいカーネルで機能しなくなります。さらに、バイナリ表現の検査だけでは捕捉できない方法で内部データ構造を直接操作して KMI の互換性を破るため、stgdiff
は違いを示しません。
現在のモジュールが後日、互換性のない新しいカーネルによって読み込まれたときは、KMI 互換ではないとみなされます。カーネルと KMI 互換でないモジュールを誤って読み込まないように、モジュール バージョニングではランタイム チェックが追加されます。このチェックにより、KMI で検出されない非互換性によって発生する、デバッグが困難なランタイムの問題とカーネル クラッシュが防止されます。
モジュール バージョニングを有効にすると、このような問題をすべて回避できます。
デバイスを起動せずに CRC 不一致を確認する
stgdiff
は、他の ABI の違いを報告するとともに、カーネルを比較して CRC 不一致を報告します。
さらに、CONFIG_MODVERSIONS
が有効になっている完全なカーネルビルドは、通常のビルドプロセスの一環として Module.symvers
ファイルを生成します。このファイルの行は、カーネル(vmlinux
)とモジュールによってエクスポートされるシンボルごとに 1 行ずつです。各行は、CRC 値、シンボル名、シンボル名前空間、シンボルをエクスポートしている vmlinux
またはモジュール名、エクスポート タイプ(EXPORT_SYMBOL
と EXPORT_SYMBOL_GPL
など)で構成されています。
GKI ビルドとお使いのビルドの間で Module.symvers
ファイルを比較して、vmlinux
によってエクスポートされたシンボルの CRC の違いを確認できます。vmlinux
によってエクスポートされたシンボルに CRC 値の違いがあり、かつ、そのシンボルがデバイスに読み込むモジュールのいずれかで使用されている場合、そのモジュールは読み込まれません。
ビルド アーティファクトがすべてあるわけでなく、GKI カーネルとカーネルの vmlinux
ファイルがあるだけの場合は、両方のカーネルで次のコマンドを実行し、出力を比較することで、特定のシンボルの CRC 値を比較できます。
nm <path to vmlinux>/vmlinux | grep __crc_<symbol name>
たとえば、次のコマンドは、module_layout
シンボルの CRC 値を確認します。
nm vmlinux | grep __crc_module_layout
0000000008663742 A __crc_module_layout
CRC 不一致を解決する
モジュールの読み込み時に発生した CRC 不一致を解決する方法は次のとおりです。
次のコマンドに示すように
--kbuild_symtypes
オプションを使用して、GKI カーネルとデバイス カーネルをビルドします。tools/bazel run --kbuild_symtypes //common:kernel_aarch64_dist
このコマンドにより、
.o
ファイルごとに.symtypes
ファイルが生成されます。詳しくは、Kleaf のKBUILD_SYMTYPES
をご覧ください。Android 13 以前の場合は、次のコマンドに示すように、カーネルのビルドに使用するコマンドの先頭に
KBUILD_SYMTYPES=1
を追加して、GKI カーネルとデバイス カーネルをビルドします。KBUILD_SYMTYPES=1 BUILD_CONFIG=common/build.config.gki.aarch64 build/build.sh
build_abi.sh,
を使用する場合、KBUILD_SYMTYPES=1
フラグはすでに暗黙的に設定されています。次のコマンドを使用して、CRC 不一致のシンボルがエクスポートされている
.c
ファイルを探します。cd common && git grep EXPORT_SYMBOL.*module_layout kernel/module.c:EXPORT_SYMBOL(module_layout);
この
.c
ファイルには、GKI 内の対応する.symtypes
ファイルと、デバイス カーネルのビルド アーティファクトが含まれます。次のコマンドを使用して.c
ファイルを見つけます。cd out/$BRANCH/common && ls -1 kernel/module.* kernel/module.o kernel/module.o.symversions kernel/module.symtypes
.c
ファイルの特性は次のとおりです。.c
ファイルの形式は、シンボルごとに 1 行です(非常に長い場合もあります)。行頭の
[s|u|e|etc]#
は、シンボルがデータ型[struct|union|enum|etc]
であることを示しています。次に例を示します。t#bool typedef _Bool bool
行頭に
#
プレフィックスがない場合は、シンボルが関数であることを示しています。次に例を示します。find_module s#module * find_module ( const char * )
2 つのファイルを比較し、違いをすべて修正します。
ケース 1: データ型の表示による違い
一方のカーネルがモジュールに対してシンボルまたはデータ型を不透明にし、他方のカーネルはそうでない場合、その違いは 2 つのカーネルの .symtypes
ファイルの間に現れます。一方のカーネルの .symtypes
ファイルにはシンボルの UNKNOWN
があり、他方のカーネルの .symtypes
ファイルにはシンボルまたはデータ型の展開ビューがあります。
たとえば、カーネルの include/linux/device.h
ファイルに次の行を追加すると、CRC 不一致が発生します。そのうちの 1 つは module_layout()
のものです。
#include <linux/fwnode.h>
そのシンボルの module.symtypes
を比較すると、次のような違いが表示されます。
$ diff -u <GKI>/kernel/module.symtypes <your kernel>/kernel/module.symtypes
--- <GKI>/kernel/module.symtypes
+++ <your kernel>/kernel/module.symtypes
@@ -334,12 +334,15 @@
...
-s#fwnode_handle struct fwnode_handle { UNKNOWN }
+s#fwnode_reference_args struct fwnode_reference_args { s#fwnode_handle * fwnode ; unsigned int nargs ; t#u64 args [ 8 ] ; }
...
カーネルに UNKNOWN
の値があり、GKI カーネルにシンボルの展開ビューがある場合(ほとんどありません)は、最新の Android 共通カーネルをカーネルに統合して、最新の GKI カーネルベースを使用できるようにします。
ほとんどの場合、GKI カーネルには UNKNOWN
の値がありますが、カーネルに加えられた変更により、カーネルにはシンボルの内部詳細があります。これは、カーネルのファイルのいずれかが、GKI カーネルには存在しない #include
を追加したためです。
多くの場合、修正は genksyms
で新しい #include
を非表示にするだけで済みます。
#ifndef __GENKSYMS__
#include <linux/fwnode.h>
#endif
それ以外の場合、違いの原因となっている #include
を特定するには、次の手順を実施します。
違いがあるシンボルまたはデータ型を定義しているヘッダー ファイルを開きます。たとえば
struct fwnode_handle
の場合はinclude/linux/fwnode.h
を編集します。ヘッダー ファイルの先頭に次のコードを追加します。
#ifdef CRC_CATCH #error "Included from here" #endif
CRC 不一致があるモジュールの
.c
ファイルで、#include
行より前に、次の行を最初の行として追加します。#define CRC_CATCH 1
モジュールをコンパイルします。結果のビルド時エラーは、この CRC 不一致の原因となったヘッダー ファイル
#include
のチェーンを示しています。次に例を示します。In file included from .../drivers/clk/XXX.c:16:` In file included from .../include/linux/of_device.h:5: In file included from .../include/linux/cpu.h:17: In file included from .../include/linux/node.h:18: .../include/linux/device.h:16:2: error: "Included from here" #error "Included from here"
#include
のチェーン内のリンクの 1 つは、カーネルで行われた変更によるものであり、GKI カーネルにはありません。変更を確認して、カーネルで元に戻すか、ACK にアップロードして統合します。
ケース 2: データ型の変更による違い
シンボルまたはデータ型の CRC 不一致が表示の違いによるものではない場合は、データ型自体が実際に変更(追加、削除、または変更)されたことによるものです。
たとえば、カーネルに次の変更を加えると、多くのシンボルがこの種の変更によって間接的に影響を受けるため、いくつかの CRC 不一致が発生します。
diff --git a/include/linux/iommu.h b/include/linux/iommu.h
--- a/include/linux/iommu.h
+++ b/include/linux/iommu.h
@@ -259,7 +259,7 @@ struct iommu_ops {
void (*iotlb_sync)(struct iommu_domain *domain);
phys_addr_t (*iova_to_phys)(struct iommu_domain *domain, dma_addr_t iova);
phys_addr_t (*iova_to_phys_hard)(struct iommu_domain *domain,
- dma_addr_t iova);
+ dma_addr_t iova, unsigned long trans_flag);
int (*add_device)(struct device *dev);
void (*remove_device)(struct device *dev);
struct iommu_group *(*device_group)(struct device *dev);
そのうちの 1 つの CRC 不一致は devm_of_platform_populate()
のものです。
そのシンボルの .symtypes
ファイルを比較すると、次のようになります。
$ diff -u <GKI>/drivers/of/platform.symtypes <your kernel>/drivers/of/platform.symtypes
--- <GKI>/drivers/of/platform.symtypes
+++ <your kernel>/drivers/of/platform.symtypes
@@ -399,7 +399,7 @@
...
-s#iommu_ops struct iommu_ops { ... ; t#phy
s_addr_t ( * iova_to_phys_hard ) ( s#iommu_domain * , t#dma_addr_t ) ; int
( * add_device ) ( s#device * ) ; ...
+s#iommu_ops struct iommu_ops { ... ; t#phy
s_addr_t ( * iova_to_phys_hard ) ( s#iommu_domain * , t#dma_addr_t , unsigned long ) ; int ( * add_device ) ( s#device * ) ; ...
変更された型を特定する方法は次のとおりです。
ソースコード(通常は
.h
ファイル)内でシンボルの定義を探します。- お使いのカーネルと GKI カーネルの間のシンボルの違いを確認するには、次のコマンドを実行してコミットを見つけます。
git blame
- 削除されたシンボルを特定するには(一方のツリーでシンボルが削除されていて、それを他方のツリーでも削除したい場合)、その行を削除した変更を見つける必要があります。行が削除されたツリーで、次のコマンドを使用します。
git log -S "copy paste of deleted line/word" -- <file where it was deleted>
返されたコミットのリストを確認し、変更または削除を見つけます。おそらく最初のコミットが探しているものです。そうでない場合は、コミットが見つかるまでリスト内を探します。
変更を特定したら、カーネルで元に戻すか、ACK にアップロードして統合します。