Magisk/docs
LoveSy af01a36296 Refactor magic mount to support overlayfs
Previously, magic mount creates its own mirror devices and mount
mirror mount points. With these mirror mount points, magic mount
can get the original files and directory trees. However, some
devices use overlayfs to modify some mount points, and thus after
magic mount, the overlayed files are missing because the mirror
mount points do not contain the overlayed files. To address this
issue and make magic mount more compatible, this patch refactors
how magic mount works.

The new workflows are as follows:
1. make MAGISKTMP a private mount point so that we can create the
   private mount points there
2. for mirror mount points, we instead of creating our own mirror
   devices and mount the mirror mount points, we "copy" the
   original mount points by recursively mounting /
3. to prevent magic mount affecting the mirror mount points, we
   recursively set the mirror mount points private
4. to trace the mount points we created for reverting mounts, we
   again make the mirror mount points shared, and by this way we
   create a new peer group for each mirror mount points
5. as for tracing the newly created tmpfs mount point by magic
   mount, we create a dedicated tmpfs mount point for them, namely
   worker mount point, and obviously, it is shared as in a newly
   created peer group for tracing
6. when reverting mount points by magic mount, we can then trace
   the peer group id and unmount the mount points whose peer group
   ids are created by us

The advantages are as follows:
1. it is more compatible, (e.g., with overlayfs, fix #2359)
2. it can mount more partitions for which previous implementation
   cannot create mirror mount points (fix #3338)
2023-02-25 18:19:46 -08:00
..
images Replace logo 2022-06-05 05:34:19 -07:00
releases Update v25.2 docs 2022-07-20 20:09:02 -07:00
app_changes.md Fix typos 2023-01-18 16:35:37 +08:00
boot.md Update docs to use the Magisk Manager's revised name 2021-03-29 09:14:21 -07:00
changes.md Fix typos 2023-01-18 16:35:37 +08:00
details.md Misc QoL changes 2022-05-06 01:01:58 -07:00
faq.md Update documentation 2022-01-25 02:32:52 -08:00
guides.md Refactor magic mount to support overlayfs 2023-02-25 18:19:46 -08:00
install.md Update install.md 2022-12-23 17:21:44 -08:00
ota.md Fix typos 2023-01-18 16:35:37 +08:00
README.md Remove deploy.md 2022-01-25 04:26:59 -08:00
tools.md Update v25.1 docs 2022-06-19 02:35:05 -07:00