mirror of
https://github.com/topjohnwu/Magisk.git
synced 2024-11-27 12:05:30 +00:00
Add bootstages docs
This commit is contained in:
parent
29bb5840b5
commit
e9c17a3ef7
@ -1,9 +1,15 @@
|
|||||||
# Magisk Documentations
|
# Magisk Documentations
|
||||||
#### (Updated on 2017.8.15 for Magisk v13.5+)
|
|
||||||
|
|
||||||
|
## Document Changelog
|
||||||
|
- 2017.8.15
|
||||||
|
- Initial version for Magisk v13.5+
|
||||||
|
|
||||||
|
## Table of Content
|
||||||
|
|
||||||
|
- [Introduction](#introduction)
|
||||||
- Magisk Details
|
- Magisk Details
|
||||||
- [Introduction](#introduction)
|
- [Procedure Diagram](https://cdn.rawgit.com/topjohnwu/Magisk/cc1809688299f1f8b5db494a234850852712c0c9/docs/procedures.html)
|
||||||
- **(Important!)** [Procedure Diagram](https://cdn.rawgit.com/topjohnwu/Magisk/cc1809688299f1f8b5db494a234850852712c0c9/docs/procedures.html)
|
- [Boot Stages](bootstages.md)
|
||||||
- [Available Applets](applets.md)
|
- [Available Applets](applets.md)
|
||||||
- [magisk](applets.md#magisk)
|
- [magisk](applets.md#magisk)
|
||||||
- [su](applets.md#su)
|
- [su](applets.md#su)
|
||||||
@ -18,8 +24,4 @@
|
|||||||
## Introduction
|
## Introduction
|
||||||
Magisk is a suite of open source tools for devices running Android version higher than 5.0 Lollipop (API 21). It provides an environment which covers most Android aftermarket customization like root, boot scripts, SELinux patches, and also acts as a **Systemless Interface** to alter the system (or vendor) arbitrarily while the actual partitions stay completely intact, all of which accomplished by only patching the boot image, and adding some files into `/data`.
|
Magisk is a suite of open source tools for devices running Android version higher than 5.0 Lollipop (API 21). It provides an environment which covers most Android aftermarket customization like root, boot scripts, SELinux patches, and also acts as a **Systemless Interface** to alter the system (or vendor) arbitrarily while the actual partitions stay completely intact, all of which accomplished by only patching the boot image, and adding some files into `/data`.
|
||||||
|
|
||||||
## Document Changelog
|
|
||||||
- 2017.8.15
|
|
||||||
- Initial version
|
|
||||||
|
|
||||||
|
|
||||||
|
25
docs/bootstages.md
Normal file
25
docs/bootstages.md
Normal file
@ -0,0 +1,25 @@
|
|||||||
|
# Boot Stages
|
||||||
|
If you are working on complicated projects, you shall need more control to the whole process. Magisk can run scripts in different boot stages, so you can fine tune exactly what you want to do. It's recommended to read this documentation along with the procedure graph.
|
||||||
|
|
||||||
|
- post-fs mode
|
||||||
|
- **This stage is BLOCKING. Boot process will NOT continue until everything is done, or 20 seconds has passed**
|
||||||
|
- Happens after most partitions are mounted, except `/data`
|
||||||
|
- Magisk will bind mount files under `/cache/magisk_mount/system` to corresponding paths
|
||||||
|
- It is only **Simple Mount**, which means it will replace existing files, but cannot add/remove files.
|
||||||
|
- post-fs-data mode
|
||||||
|
- **This stage is BLOCKING. Boot process will NOT continue until everything is done, or 60 seconds has passed**
|
||||||
|
- Happens after `/data` is ready (including the case when `/data` is encrypted)
|
||||||
|
- Happens before Zygote and system servers are started (which means pretty much everything)
|
||||||
|
- Mirrors will be mounted. These mirrors play a critical part in **Magic Mount**
|
||||||
|
- `/data/magisk.img` will be merged, trimmed, and mounted to `/magisk`
|
||||||
|
- Magisk will run scripts under `/magisk/.core/post-fs-data.d`
|
||||||
|
- Magisk will run scripts: `/magisk/$MODID/post-fs-data.sh` (placed in each module directory)
|
||||||
|
- Magisk will finally **Magisk Mount** module files
|
||||||
|
- late_start service mode
|
||||||
|
- **This stage is NON-BLOCKING, it will run in parallel with other processes**
|
||||||
|
- Happens when class late_start is started
|
||||||
|
- Put time consuming but non time critical tasks here. Boot process will be stuck if it took too long to finish your tasks in previous modes
|
||||||
|
- SELinux is guaranteed to be fully patched in this stage; **it is recommended to run most scripts in this stage**, unless your scripts require some time critical operations
|
||||||
|
- Magisk will run scripts under `/magisk/.core/service.d`
|
||||||
|
- Magisk will run scripts: `/magisk/$MODID/service.sh` (placed in each module directory)
|
||||||
|
|
Loading…
Reference in New Issue
Block a user