What is pts-multi
pts-multi is a collection of tools for manipulating PTS pseudo terminals in Android which came out of my experimentation after the upgrade to Android 4.3.
The result of these experiments is pts-daemon, which is very similar to other superuser daemons (eg. Superuser or SuperSU). The main difference is that my goal is on users launching root shells with proper terminal handling, while most superuser apps focus is on application running commands as root.
The tools are in a multi-call binary, and includes:
pts-daemon- A daemon which, if run at startup as root, will allow users to launch and attach any native application to an existing pesudo-terminal. Access is controlled via a password.
pts-passwd- A utility which allows you to set/change the password used by pts-daemon.
pts-shell- A frontend which creates a pseudo-terminal, attaches its own standard input/output/error to this terminal, then contacts pts-daemon to attach an application (eg. a busybox shell) to this pseudo-terminal.
pts-wrap- A small utility which creates a pseudo-terminal, then attaches its own standard input/output/error to this pseudo-terminal.
pts-exec- A small utility which daemonizes an application then attaches its standard input/output/error to a pseudo-terminal.
You can read more about this project or download a prebuilt update ZIP from here.
Building the binary
After cloning the git repository,
$ cd pts-multi/jni
- Open Makefile in an editor and make sure
NDK_PATHis set to your NDK directory.
Binaries are created in jni/x86_bin/ and update_zip/
An update ZIP file is automatically created and placed in the source tree's root.
Once the daemon is installed (eg. via the update.zip method), you'll need to run
pts-passwd at least once (as root) to set the password.
After that, you may execute
pts-shell <path to application>
At any time to request the daemon to launch the given application. Note that pts-shell does NOT need (and, in fact, should not) be run from a root shell. Before launching the application as root, pts-shell will ask for the password as set by pts-passwd. To prevent this password prompting, you can supply this password in the environment variable
PTS_AUTH. For example, a script could do the following:
export PTS_AUTH="abcxyz" pts-shell /system/bin/sh
and pts-shell will not prompt for a password.
pts-exec and pts-wrap
(a.k.a. non-daemon usage)
In a regular terminal, run
pts-wrap. Observe the name of the pseudo-terminal which was created. (eg. /dev/pts/2)
pts-exec as root like so:
pts-exec <pseudo-terminal name> <path to application>
The application should be launched and attached to the pseudo-terminal.