Ultra Legacy Integration guide

[backslashxx]

This guide is mostly for 3.18 / 3.10 / 3.4 and 3.0.

If you're planning to integrate KernelSU on an ultra-legacy device, yep this is the thread for you.
Aside from standard Legacy 4.x fixes, this repo's KernelSU also has adaptations for Ultra-Legacy.
Reference: f2afcfa...8301c4c

Lets start,

Main issue on 3.x is that, theres no LSM_HOOK_INIT / security_add_hooks.
So make sure to apply

• manual security hooks v1.7 #7

Make sure to build your KernelSU with CONFIG_KSU_LSM_SECURITY_HOOKS=n ‼️
Now that's done, follow manual hook guide from here

• scope-minimized manual hooks v1.6 #5

Make sure to use what's appropriate to your kernel!

as for kernel side changes

for 3.18 and below you probably need:

• kernel: groups: expose groups_sort

for 3.4 and below you also need:

• fs: export kernel_write

for 3.10 / 3.4 / 3.0

Since you're likely building your kernel without CONFIG_UIDGID_STRICT_TYPE_CHECKS, we have to patch this on KernelSU side.
if this is disabled, uid is not kuid_t, so we have to remove .val as uid is uid_t already, and theres no uid.val

• you can run kuid_ul_fix.sh inside the driver directory
• another option is to apply: KernelSU: adapt to CONFIG_UIDGID_STRICT_TYPE_CHECKS=n ^[3]

[3]: _{inlining a massive ifdef for this was evaluated, but since it is too nasty and very few builds 3.10 and older, just edit it yourself.}

Thats it!

show deprecated

READ: THESE ARE NOW USELESS

THIS IS HERE JUST FOR REFERENCE PURPOSES

• BACKPORT: fs/readdir: provide iterate_dir ^[2] (optional)
  [2]: _{iterate_dir -> vfs_readdir fallback was added so this is now optional}
• ARM: provide current_user_stack_pointer - solved by 5b47e46
• UPSTREAM: Provide a binary to hex conversion function - a weak symbol is now provided

extras

• if youre building with an old compiler, you probably have to build ksu with -Wno-error or cast all PTR_ERR to int
  apply either:
  • KernelSU: adapt to old compilers (-Wint-conversion)

[backslashxx]

here are sample integrations:

• Linux 3.18 - samsung universal7880 by @cyberc3dr
• Linux 3.10 - Mi 4c / libra
• Linux 3.0 - Galaxy S3 / i9300

[backslashxx]

While this makes it look really easy, integrating kernelsu is still not for the inept.
This thread is meant to be a small guide, not a thread to spoonfeed you.

and no I am NOT building your KernelSU.

another note, if its not from this repo, I won't help you. It's just too hard to track everything.