Konfigurasikan fitur kernel sebagai modul GKI

Halaman ini membahas cara mengonfigurasi fitur kernel baru sebagai modul GKI atau mengonfigurasi fitur kernel bawaan yang sudah ada sebagai modul GKI.

Konfigurasikan fitur baru sebagai modul GKI

  1. Untuk fitur baru, edit gki_defconfig dan setel item konfigurasi fitur kernel yang diperlukan dari n ke m ( =m ). Tetapkan pengaturan ini di arch/arm64/configs/gki_defconfig dan arch/x86/configs/gki_defconfig .

  2. Tambahkan file KO ( .ko ) yang dihasilkan untuk fitur tersebut ke bagian COMMON_GKI_MODULES_LIST dari common/modules.bzl . Tambahkan file dalam urutan yang diurutkan. Jika Anda tidak yakin dengan semua file yang dihasilkan, build akan gagal dan mencantumkan semua file KO yang diperlukan untuk ditambahkan ke daftar.

  3. Tambahkan kumpulan file KO yang sama dari langkah 2, yang diurutkan dalam urutan menaik untuk penelusuran biner saat runtime, ke common/android/gki_{ARCH}_protected_modules untuk menetapkan modul sebagai modul GKI yang dilindungi. Perbarui daftar ekspor yang dilindungi untuk menyertakan ekspor dari modul yang baru ditambahkan di common/android/abi_gki_protected_exports_{ARCH} menggunakan tools/bazel run //common:kernel_aarch64_abi_update_protected_exports untuk aarch64 . Modul yang ditetapkan sebagai modul GKI yang dilindungi masih harus disetujui oleh Google untuk menjadi modul resmi yang dilindungi.

  4. Pastikan file KO yang baru ditambahkan dari langkah 2 disalin ke out/<androidX-YZ>/dist/system_dlkm.img dan out/ androidX-YZ /dist/system_dlkm_staging_archive.tar.gz . Modul dalam arsip system_dlkm_staging_archive.tar.gz dapat digunakan sebagai input untuk menghasilkan system_dlkm.img di platform build.

  5. Kirimkan perubahan Anda untuk ditinjau. Modul GKI adalah fitur kernel khusus Android, sehingga patch konversi modul tidak perlu dikirimkan ke upstream. Namun, Anda harus mengikuti panduan lain untuk mengirimkan patch Android Common Kernel (ACK) .

Konfigurasikan fitur bawaan kernel sebagai modul GKI

  1. Untuk fitur kernel bawaan yang sudah ada, edit gki_defconfig dan setel item konfigurasi fitur kernel yang diperlukan dari y ke m ( =m ). Tetapkan pengaturan ini di arch/arm64/configs/gki_defconfig dan arch/x86/configs/gki_defconfig .

  2. Tambahkan file KO ( .ko ) yang dihasilkan untuk fitur tersebut ke bagian COMMON_GKI_MODULES_LIST dari common/modules.bzl . Tambahkan file dalam urutan yang diurutkan. Jika Anda tidak yakin dengan semua file yang dihasilkan, build akan gagal dan mencantumkan semua file KO yang diperlukan untuk ditambahkan ke daftar.

  3. Tambahkan kumpulan file KO yang sama dari langkah 2, yang diurutkan dalam urutan menaik untuk penelusuran biner saat runtime, ke common/android/gki_{ARCH}_protected_modules untuk menetapkan modul sebagai modul GKI yang dilindungi. Perbarui daftar ekspor yang dilindungi untuk menyertakan ekspor dari modul yang baru ditambahkan di common/android/abi_gki_protected_exports_{ARCH} menggunakan tools/bazel run //common:kernel_aarch64_abi_update_protected_exports untuk aarch64 . Modul yang ditetapkan sebagai modul GKI yang dilindungi masih harus disetujui oleh Google untuk menjadi modul resmi yang dilindungi.

  4. Pastikan file modul KO yang baru dikonversi dari langkah 2 disalin ke out/<androidX-YZ>/dist/system_dlkm.img dan out/ androidX-YZ /dist/system_dlkm_staging_archive.tar.gz . Modul dalam arsip system_dlkm_staging_archive.tar.gz dapat digunakan sebagai input untuk menghasilkan system_dlkm.img di platform build.

  5. Kirimkan perubahan Anda untuk ditinjau. Modul GKI adalah fitur kernel khusus Android, sehingga patch konversi modul tidak perlu dikirimkan ke upstream. Namun, Anda harus mengikuti panduan lain untuk mengirimkan patch Android Common Kernel (ACK) .

Ubah modul GKI yang dilindungi menjadi tidak terlindungi

  1. Hapus modul yang sedang dikonversi dari dilindungi ke tidak dilindungi dari daftar modul yang dilindungi di common/android/gki_protected_modules .

  2. Perbarui daftar ekspor yang dilindungi untuk mengecualikan ekspor dari modul tidak terlindungi yang baru dikonversi di common/android/abi_gki_protected_exports_{ARCH} menggunakan tools/bazel run //common:kernel_aarch64_abi_update_protected_exports untuk aarch64 .

  3. Kirimkan perubahan Anda untuk ditinjau. Modul GKI adalah fitur kernel khusus Android, sehingga patch konversi modul tidak perlu dikirimkan ke upstream. Namun, Anda harus mengikuti panduan lain untuk mengirimkan patch Android Common Kernel (ACK) .

Panduan cepat resolusi pelanggaran simbol modul GKI

Jika modul yang tidak ditandatangani melanggar perlindungan simbol yang diterapkan pada modul GKI, ada dua jenis error yang mungkin terjadi selama pemuatan modul, sehingga mengakibatkan kegagalan.

1. Modul yang tidak ditandatangani menggunakan simbol yang dilindungi

Kesalahan:

module: Protected symbol: some_kernel_function (err -13)

Menyebabkan:

File module.ko adalah modul vendor yang tidak ditandatangani dan berupaya menyelesaikan simbol yang diekspor modul GKI some_kernel_function selama pemuatan, tanpa dicantumkan dalam daftar simbol vendor.

Resolusi:

Jika module.ko bukan modul GKI yang dilindungi, memperbarui daftar simbol akan mengatasi kesalahan dengan menyertakan some_kernel_function dalam daftar simbol vendor. Alternatifnya, gunakan module.ko versi GKI.

2. Modul yang tidak ditandatangani mengekspor simbol yang dilindungi

Kesalahan:

module: exports protected symbol some_kernel_function

Menyebabkan:

Modul yang mengekspor some_kernel_function adalah modul GKI yang dilindungi, dan module.ko kemungkinan merupakan versi khusus modul tersebut yang tidak ditandatangani. Saat module.ko mencoba mengekspor some_kernel_function , yang hanya dapat diekspor oleh modul GKI yang ditandatangani, pemuatan gagal dengan pesan ini.

Resolusi:

Hal ini dapat diperbaiki dengan menggunakan versi GKI dari modul yang mengekspor some_kernel_function , jika modul yang tidak ditandatangani adalah versi khusus.