Skip to content
ItsPhysipPublic

About

Static termux/proot builds for ULS (Universal Linux Shell)

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

9 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

uls-proot

Static proot builds for ULS. ULS runs a Linux rootfs on an Android phone over ADB, with proot as the sandbox.

The source is ItsPhysip/proot, branch uls: termux/proot plus a few fixes that are waiting upstream. Its ULS-CHANGES.md lists each change with its date and upstream PR. Every binary is built by CI in this repository from a pinned commit of that branch. Release assets carry SHA-256 sums, and ULS's catalog pins those sums.

Why termux/proot

Until now ULS used stock proot-me v5.3.0. On Android kernels ≥ 5.8 several path-taking syscalls reach the kernel with the guest path untranslated, and one crashes proot outright. Measured on a Samsung Galaxy S26 Ultra (SM-S948B) (kernel 6.12, Android 16), with no ULS compatibility shims loaded:

Problem proot-me 5.3.0 proot-me 5.4.1 termux/proot
faccessat2: pacman, bash [ -r ], glibc realpath("dir/") broken broken on arm64 (support is x86_64-only) fixed
openat2: resolves against the host (/system opens) leaks leaks fixed
readlinkat(fd, ""): assertion kills the sandbox (systemd-tmpfiles) crashes fixed fixed
fchmodat2: untranslated, so host-only paths are acted on (/system → EROFS) broken broken broken; fixed in the uls branch (termux/proot#400)
link2symlink (-l): file destroyed once a name's intermediate suffixes run out (dpkg backups) — — destroyed; fixed in the uls branch (termux/proot#394)

The Android SELinux issues that aren't proot's (socket files, hard links, audit netlink) are handled by ULS's libc shims. termux/proot already reports the peer's emulated uid for SO_PEERCRED, which the shims alone can't.

Build

INSTALL_DEPS=1 ./build.sh     # Debian/Ubuntu; output in dist/

The script builds static talloc from the Samba tarball (sha256-checked), fetches termux/proot at the pinned commit, applies patches/, and links a static binary with clang. It then runs a proot -r / /bin/true self-test and writes dist/BUILDINFO-<arch>.

Arch Built on Tested on a device
aarch64 native arm64 runner yes (Galaxy S26 Ultra, SM-S948B)
x86_64 native x86_64 runner no
armv7 armhf container under qemu-user no

Releasing

Push a tag named uls-<short fork commit>-r<n> (for example uls-f2cbc4f-r1). CI builds all three architectures and publishes a release whose title is the tag. The earlier termux-d4d2a19-r1 release was built from stock termux/proot plus two patches.

Licence

proot is free software under the GNU General Public License, version 2. See COPYING, which comes from upstream unchanged. The build files here, and the changes in the fork, are distributed under the same licence. The fork's changes are listed with dates in its ULS-CHANGES.md, and each one is a separate commit.

About

Static termux/proot builds for ULS (Universal Linux Shell)

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages