From cd03b977e440843ece4056c6c16cdbdad0563cb0 Mon Sep 17 00:00:00 2001
From: RealStickman <mrc@frm01.net>
Date: Fri, 29 Jul 2022 15:18:18 +0200
Subject: [PATCH] Add lineageos build instructions

---
 arch-config/Dokumente/lineageos-build.md | 84 ++++++++++++++++++++++++
 1 file changed, 84 insertions(+)
 create mode 100644 arch-config/Dokumente/lineageos-build.md

diff --git a/arch-config/Dokumente/lineageos-build.md b/arch-config/Dokumente/lineageos-build.md
new file mode 100644
index 00000000..9a409bee
--- /dev/null
+++ b/arch-config/Dokumente/lineageos-build.md
@@ -0,0 +1,84 @@
+# Build LineageOS
+https://wiki.lineageos.org/devices/oneplus3/build
+https://dzx.fr/blog/how-to-compile-the-wireguard-kernel-module-for-lineageos/
+
+## Preparing environment
+I'll be using a container to keep my main system clean  
+
+Adapted from [How to build LineageOS inside a container](https://dzx.fr/blog/how-to-build-lineageos-inside-a-container/)  
+
+```
+$ podman run -itd --name lineageos-build \
+    -v /mnt/storage/lineageos-build:/var/lineageos-build \
+    -v /home/marc/lineageos-cache:/var/lineageos-cache \
+    docker.io/ubuntu:jammy-20220531
+```
+
+Enter the newly created container  
+`$ podman exec -it lineageos-build bash`  
+
+Install the necessary packages  
+`# apt update`  
+`# apt install bc bison build-essential ccache curl flex g++-multilib gcc-multilib git gnupg gperf imagemagick lib32ncurses5-dev lib32readline-dev lib32z1-dev liblz4-tool libncurses5 libncurses5-dev libsdl1.2-dev libssl-dev libxml2 libxml2-utils lzop pngcrush rsync schedtool squashfs-tools xsltproc zip zlib1g-dev python-is-python3 vim`  
+
+Add an unpriviledged user for building  
+Make sure it can access the lineageos folders mounted  
+`# adduser --disabled-password (user)`  
+`# chown (user):(user) -R /var/lineageos-*`  
+`# su exu`  
+
+Set cache and export to bashrc  
+Create the file `~/.config/ccache/ccache.conf`  
+```
+max_size = 30G
+cache_dir = /var/lineageos-cache
+```
+
+`$ echo 'export USE_CCACHE=1' >> ~/.bashrc`  
+
+### Install repo tool
+```
+$ mkdir -p ~/.local/bin/
+$ source ~/.profile
+```
+
+```
+$ curl https://storage.googleapis.com/git-repo-downloads/repo > ~/.local/bin/repo
+$ chmod a+x ~/.local/bin/repo
+```
+
+```
+$ git config --global user.email mrc@frm01.net
+$ git config --global user.name RealStickman
+```
+
+### Get source lineage code
+```
+$ mkdir -p /var/lineageos-build/lineage/
+$ cd /var/lineageos-build/lineage/
+```
+
+Initialize the repo  
+`$ repo init -u https://github.com/LineageOS/android.git -b lineage-18.1`  
+
+Sync repo content  
+This can take a long time  
+`$ repo sync --force-sync`  
+
+Repo fetches the latest version automatically, so we can use a symlink  
+`$ ln -sf /var/lineageos-build/lineage/.repo/repo/repo ~/.local/bin/repo`  
+
+### Download device source files
+Activate the build environment  
+`$ . ./build/envsetup.sh`  
+
+Finally, download device specific source files  
+`$ breakfast DEVICE_CODENAME`  
+
+## Start build
+Full build  
+`$ brunch marlin`  
+
+Kernel only  
+`$ mka bootimage`  
+