3.8 KiB
sys-patch
A script-like system module that patches fs, es and ldr on boot.
Config
sys-patch features a simple config. This can be manually editied or updated using the overlay.
the config file can be found in /config/sys-patch/config.ini, if the file does not exist, the file will be created when sys-patch is run.
[options]
patch_sysmmc=1 ; 1=(default) patch sysmmc, 0=don't patch sysmmc
patch_emummc=1 ; 1=(default) patch emummc, 0=don't patch emummc
logging=1 ; 1=(default) output /config/sys-patch/log.ini 0=no log
version_skip=1 ; 1=(default) skips out of date patterns, 0=search all patterns
Overlay
the overlay can be used to change the config options and to see what patches are applied (if any).
- Unpatched means the patch wasn't applied (likely not found).
- Patched (green) means it was patched by sys-patch.
- Patched (yellow) means it was already patched, likely by sigpatches or a custom atmosphere build.
Building
prerequisites
- install devkitpro
git clone --recurse-submodules https://github.com/ITotalJustice/sys-patch.git
cd sys-patch
make
the output of out/ can be copied to your sd card. for the sysmodule to take effect, rebot your switch, or, use sysmodules overlay to start it.
What is being patched?
Here's a quick run down of what's being patched
- fs
- es
- ldr
fs and es need new patches after every new fw version.
ldr on the other hand needs new patches after every new atmosphere release. this is due to ldr service being reimplemented by atmosphere. in fw 10.0.0, a new check was added to ofw which we needed to patch out. As atmosphere closely follows what ofw does, it also added this check. This is why a new patch is needed per atmosphere update.
How does it work?
it uses a collection of patterns to find the piece of code to patch. alternatively, it could just use offsets, however this would mean this tool would have to be updated after every new fw update, that's not ideal.
the patches are applied at boot, then, the sysmod stops running. the memory footpint of the sysmod is very very small, only using 16kib in total. the size of the binary itself is only ~50kib! this doesnt really mean much, but im pretty proud of it :)
Does this mean i should stop downloading / using sigpatches?
No, i would personally recommend continuing to use sigpatches. Reason being is that should this tool ever break, i likely wont be quick to fix it.
If i am using sigpatches already, is there any point in using this as well?
Yes, in 2 niche cases.
-
A new ldr patch needs to be created after every atmosphere update. Sometimes, a new silent atmosphere update is released. This tool will always patch ldr without having to update patches.
-
Building atmosphere from src will require you to generate a new ldr patch for that custom built atmosphere. This is easy enough due to the public scripts / tools that exist out there, however this will always be able to
Also, if you forget to update your patches when you update fw / atmosphere, this sysmod should be able to patch everything just fine! so it's nice to have as a fallback.
Credits / Thanks
software is built on the shoulders of giants. this tool wouldn't be possible wthout these people: