Meta Module Mount

About 684 wordsAbout 2 min

2025-01-30

Meta module mount is a way to achieve file system mounting by installing specialized meta modules, which is one of the main mounting schemes supported by FolkPatch.

Working Principle

Core mechanism of meta module mount:

Mount Trigger: When system starts, the startup script of meta module is executed
File Mapping: Meta module maps files in module directory to system partition
Overlay Mechanism: Supports overlay and merging of multiple module files
Persistence: Mount results remain effective after restart

Supported Mount Technologies

Technology	Description	Compatibility
Magic Mount	Mount method used by Magisk, implemented via creating symbolic links	Widely supported
Overlayfs	Overlay file system provided by Linux kernel, better performance	KernelSU/APatch
Bind Mount	Direct bind mount, simple and efficient	Universal

Features

Advantages

Strong Compatibility: Supports various module types and complex mount needs
Modular Design: Can manage mount behavior of each module individually
Community Support: Utilize mature meta module ecosystem
Rich Functions: Supports multiple mount technologies and configuration options
Good Stability: Tested and optimized for a long time

Limitations

Notes

May conflict with other Root toolchains
Requires extra storage space to store meta modules
Configuration is relatively complex, requires certain technical basis
May affect startup speed in some cases

Configuration Method

Install FolkPatch Meta Module

Download Meta Module
- Visit FolkPatch official repository
- Download latest version of FolkMeta module
- Ensure version matches FolkPatch version

Install Meta Module

# Install via FolkPatch
1. Open FolkPatch App
2. Enter "Module" page
3. Click "Install Module"
4. Select downloaded FolkMeta.zip
5. Wait for installation to complete and restart

Verify Installation
- Check if meta module runs normally after restart
- Check FolkPatch log to confirm mount status

Enable Meta Module Support

Configure in FolkPatch settings:

Open FolkPatch App
Enter "Settings" -> "Basic Settings" -> "Advanced Settings"
Disable "Enable Mount System" option (to avoid conflict)
Save settings and restart device

Install and Manage Modules

Install modules needing mount:

Download module ZIP file
Click "Install Module" in FolkPatch module page
Select module file and install
Restart device to make mount effective

Module Mount Control:

Module Directory Structure:
/data/adb/modules/
└── module_name/
    ├── module.prop      # Module info
    ├── system/          # System files (will be mounted)
    ├── post-fs-data.sh  # Startup script
    └── skip_mount       # Empty file, if exists, system directory will not be mounted

Usage Scenes

Recommended Situations

✅ Multi-Module Environment

Need to use multiple mount-type modules simultaneously
Dependencies exist between modules
Need complex file overlay logic

✅ Cooperate with Other Toolchains

Use Magisk, KernelSU or APatch simultaneously
Need cross-toolchain module compatibility
Use universal module format

✅ Advanced Function Needs

Need specific mount mechanism (like Overlayfs)
Need custom mount script
Need file interaction between modules

Not Recommended Situations

❌ Simple Needs

Only need a few basic modules
Pursue concise system architecture
Limited device performance

❌ Compatibility Issues

Meta module version mismatch with system version
Conflict with other components
Frequently encounter mount errors

Q: How to check if meta module is working normally?

A: Can check via following ways:

View Mount Points
```
mount | grep -E "(magic|overlay|bind)"
```
Check Module Status
- Enter FolkPatch "Module" page
- View module status indicator
Check Logs
- Enter "Log" page
- Search for mount related logs

Q: What to do if meta module mount fails?

A: Troubleshooting steps:

Check Version Compatibility
- Confirm FolkMeta version matches FolkPatch version
- Check if system version is supported

Check Logs

# Check kernel log
dmesg | grep -i mount

# Check FolkPatch log
cat /data/adb/folkpatch/logs/folkpatch.log

Common Problem Solutions
- Reinstall meta module
- Clean up conflicting mount points
- Check storage space
Temporary Solution
- Switch to built-in mount mode
- Enter safe mode to troubleshoot

Q: Can I use multiple meta modules at the same time?

A: Generally not recommended:

Multiple meta modules may cause conflicts
Mount order is uncertain
May cause system instability
Recommended to use only one meta module

Built-in Mount - Understand FolkPatch Built-in Mount Scheme
Lite Mode - Lightweight Running Mode
Mount Implementation Overview - Comparison of Three Mount Modes

Copyright

License under:Attribution 4.0 International (CC-BY-4.0)