aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorSzuWei Lin <szuweilin@google.com>2022-11-08 01:37:32 +0000
committerAutomerger Merge Worker <android-build-automerger-merge-worker@system.gserviceaccount.com>2022-11-08 01:37:32 +0000
commit0e612c22dc561299594f040f9159e5cfea436a6e (patch)
treea89d66a3f0b36b902084111a7a3796e4ec477438
parentaf74d9fd1926221b7178d4fbae0c7ee5c49ac334 (diff)
parentca3b60361256cc97d839b2e235f78cc2f45d52d8 (diff)
downloadcommon-0e612c22dc561299594f040f9159e5cfea436a6e.tar.gz
Merge "Add content about support system_dlkm partition" am: 7572416973 am: ca3b603612
Original change: https://android-review.googlesource.com/c/device/generic/common/+/2286974 Change-Id: I4eb1602e963f96572eaf87abf9125105f3bd0758 Signed-off-by: Automerger Merge Worker <android-build-automerger-merge-worker@system.gserviceaccount.com>
-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