Skip to content

Commit 32a5a4e

Browse files
author
Mattijs Korpershoek
committed
feat(android): kernel: Add note for btrfs hangs
According to the kleaf documentation[1], there is a known issue when using btrfs build to build kernels Document the --workaround_btrfs_b292212788 flag as recommended by the docs. [1] https://android.googlesource.com/kernel/build/+/refs/heads/main/kleaf/docs/errors.md#build-hangs-on-btrfs Signed-off-by: Mattijs Korpershoek <[email protected]>
1 parent 4819a76 commit 32a5a4e

File tree

1 file changed

+10
-3
lines changed

1 file changed

+10
-3
lines changed

source/android/Foundational_Components_Kernel.rst

Lines changed: 10 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -48,9 +48,16 @@ Building everything from scratch
4848
$ export DIST_DIR=${YOUR_PATH}/ti-aosp-15/device/ti/am62x-kernel/kernel/${TARGET_KERNEL_USE}
4949
$ tools/bazel run //common:ti_dist -- --dist_dir=$DIST_DIR
5050
51-
Android uses Kleaf, a Bazel-based build system to build the kernel.
52-
AOSP documentation can be found `here <https://source.android.com/docs/setup/build/building-kernels?hl=fr>`__ and
53-
Kleaf documentation `here <https://android.googlesource.com/kernel/build/+/refs/heads/main/kleaf/README.md>`__
51+
Android uses Kleaf, a Bazel-based build system to build the kernel.
52+
AOSP documentation can be found `here <https://source.android.com/docs/setup/build/building-kernels?hl=fr>`__ and
53+
Kleaf documentation `here <https://android.googlesource.com/kernel/build/+/refs/heads/main/kleaf/README.md>`__
54+
55+
.. attention::
56+
57+
Kernel builds hangs when using the ``btrfs`` file system.
58+
This is a known issue according to the `kleaf documentation <https://android.googlesource.com/kernel/build/+/refs/heads/main/kleaf/docs/errors.md#build-hangs-on-btrfs>`_
59+
Make sure to pass the ``--workaround_btrfs_b292212788`` flag to bazel when using ``btrfs``.
60+
5461

5562
Rebuilding faster
5663
=================

0 commit comments

Comments
 (0)