TheArchive/Magisk
1
0
Fork 0
mirror of https://github.com/topjohnwu/Magisk.git synced 2024-11-23 18:15:30 +00:00
Code Issues Packages Projects Releases Wiki Activity

Update docs

Browse Source 
Close #823
This commit is contained in:
topjohnwu 2018-12-09 14:49:35 -05:00
parent c75512ba6e
commit fd5e42698c
3 changed files with 12 additions and 20 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
docs/README.md
View File

@ -1,5 +1,5 @@
# Magisk Documentations # Magisk Documentations
(Updated on 2018.10.16) (Updated on 2018.12.9)
- [Tutorials](tutorials.md) - [Tutorials](tutorials.md)
- [OTA Installation](tutorials.md#ota-installation) - [OTA Installation](tutorials.md#ota-installation)

28
docs/details.md
View File

@ -1,7 +1,7 @@
# Magisk Details # Magisk Details
## File Structure ## File Structure
### Paths in "sbin tmpfs overlay" ### Paths in "sbin tmpfs overlay"
sbin tmpfs overlay is the key to hiding Magisk from detection. All Magisk binaries, applets, mirrors, mountpoints, loop devices, and other trivial stuffs are all located in the `tmpfs` mounted on `/sbin`. MagiskHide can just simply unmount `/sbin` and the bind mounts into `/system` and `/vendor` to hide all modifications easily. sbin tmpfs overlay is the key to hiding Magisk from detection. All Magisk binaries, applets, mirrors, mountpoints, loop devices, and other trivial stuffs are all located in the `tmpfs` mounted on `/sbin`. MagiskHide can just simply unmount `/sbin` and the bind mounts into `/system` and `/vendor` to hide all modifications easily.
``` ```
# The actual Magisk binary # The actual Magisk binary
@ -14,7 +14,7 @@ sbin tmpfs overlay is the key to hiding Magisk from detection. All Magisk binari
# are all in PATH for apps and shell to access them # are all in PATH for apps and shell to access them
# Other crazy stuffs are stored in this directory # Other crazy stuffs are stored in this directory
MAGISKTMP=/sbin/.core MAGISKTMP=/sbin/.magisk
# Magisk BusyBox path # Magisk BusyBox path
BBPATH=$MAGISKTMP/busybox BBPATH=$MAGISKTMP/busybox
@ -58,7 +58,13 @@ The solution of both situations above is to use `/data/magisk` when `/data/adb`
``` ```
SECURE_DIR=/data/adb SECURE_DIR=/data/adb
# Magisk image, storing modules and scripts # Folder storing scripts that should be executed in post-fs-data mode
POSTFSDATA_DIR=$SECURE_DIR/post-fs-data.d
# Folder storing scripts that should be executed in service mode
SERVICE_DIR=$SECURE_DIR/service.d
# Magisk image, storing modules
MAINIMG=$SECURE_DIR/magisk.img MAINIMG=$SECURE_DIR/magisk.img
# The image to store updated modules when installing # The image to store updated modules when installing
@ -82,21 +88,7 @@ SIMPLEMOUNT=$SECURE_DIR/magisk_simple
``` ```
### Paths in `$MAINIMG` ### Paths in `$MAINIMG`
Each folder in `$MAINIMG` is a Magisk module, except the folder `.core` which stores files that are unrelated to any modules. Each folder in `$MAINIMG` is a Magisk module. There used to be a folder `.core`, which is no longer used since v18.0.
```
# The directory storing all non-module files
COREDIR=$MOUNTPATH/.core
# MagiskHide hidelist
HIDELIST=$COREDIR/hidelist
# Folder storing scripts that should be executed in post-fs-data mode
POSTFSDATA_DIR=$COREDIR/post-fs-data.d
# Folder storing scripts that should be executed in service mode
SERVICE_DIR=$COREDIR/service.d
```
### Final Words ### Final Words
The file structure of Magisk is designed in a weird and overly complicated way. But all of these quirks are done to properly support hiding modifications from detection. These design choices are mostly what makes Magisk difficult to implement properly and maintain. The file structure of Magisk is designed in a weird and overly complicated way. But all of these quirks are done to properly support hiding modifications from detection. These design choices are mostly what makes Magisk difficult to implement properly and maintain.

2
docs/install.md
View File

@ -86,7 +86,7 @@ chmod 755 /sbin
chcon u:object_r:magisk_file:s0 /sbin chcon u:object_r:magisk_file:s0 /sbin
# Add files to /sbin # Add files to /sbin
./magiskpolicy -x magisk /sbin/magisk ./magiskinit -x magisk /sbin/magisk
cp -a magiskpolicy /sbin cp -a magiskpolicy /sbin
/sbin/magisk --install /sbin /sbin/magisk --install /sbin