aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorAutomerger Merge Worker <android-build-automerger-merge-worker@system.gserviceaccount.com>2022-11-08 01:08:12 +0000
committerGerrit Code Review <noreply-gerritcodereview@google.com>2022-11-08 01:08:12 +0000
commit24c8543263fbcb9527f0e98f7831c6712e1b8117 (patch)
treea89d66a3f0b36b902084111a7a3796e4ec477438
parent120323c4be13020d927e3d26d382509f38d943e3 (diff)
parentf642cc489baf4f445b49ce8bbbc68f1626afc6e0 (diff)
downloadcommon-main-16k.tar.gz
Merge "Merge "Add content about support system_dlkm partition" am: 7572416973" into main-16kmain-16k
-rw-r--r--README.md31
1 files changed, 30 insertions, 1 deletions
diff --git a/README.md b/README.md
index 0938785..fcb14e6 100644
--- a/README.md
+++ b/README.md
@@ -3,7 +3,36 @@
This document introduces special GSI settings for facilitating xTS-on-GSI with
a single image.
-## Changes in runtime resource overlays (RRO)
+### Support system_dlkm partition
+
+```
+[BoardConfigGsiCommon.mk]
+
+BOARD_USES_SYSTEM_DLKMIMAGE := true
+BOARD_SYSTEM_DLKMIMAGE_FILE_SYSTEM_TYPE := ext4
+TARGET_COPY_OUT_SYSTEM_DLKM := system_dlkm
+
+[gsi_release.mk]
+
+PRODUCT_BUILD_SYSTEM_DLKM_IMAGE := false
+```
+
+Starting from Android 13, all devices must include a [system_dlkm partition].
+GSI enables system_dlkm to support the devices with system_dlkm partition,
+and be compatible with old devices without a system_dlkm partition.
+
+With these configurations, `/system/system_dlkm` would not be created.
+Instead, a `/system/lib/modules` -> `/system_dlkm/lib/modules` symlink is
+created.
+
+For device without system_dlkm partition, the symlink would be dangling.
+The dangling symlink shouldn't be followed anyway because the device doesn't
+use system_dlkm.
+
+For device with system_dlkm, they can load modules via that path normally like
+when they are using their original system image.
+
+[system_dlkm partition]: https://source.android.com/docs/core/architecture/bootloader/partitions/gki-partitions
### SystemUI overlays