428 lines
17 KiB
Kotlin
428 lines
17 KiB
Kotlin
package be.mygod.librootkotlinx
|
|
|
|
import android.content.Context
|
|
import android.os.Looper
|
|
import android.os.Parcelable
|
|
import android.os.RemoteException
|
|
import android.util.Log
|
|
import androidx.collection.LongSparseArray
|
|
import androidx.collection.set
|
|
import androidx.collection.valueIterator
|
|
import eu.chainfire.librootjava.AppProcess
|
|
import eu.chainfire.librootjava.RootJava
|
|
import kotlinx.coroutines.*
|
|
import kotlinx.coroutines.channels.*
|
|
import kotlinx.coroutines.sync.Mutex
|
|
import kotlinx.coroutines.sync.withLock
|
|
import java.io.*
|
|
import java.lang.ref.WeakReference
|
|
import java.util.*
|
|
import java.util.concurrent.CountDownLatch
|
|
import kotlin.system.exitProcess
|
|
|
|
class RootServer @JvmOverloads constructor(private val warnLogger: (String) -> Unit = { Log.w(TAG, it) }) {
|
|
private sealed class Callback {
|
|
abstract fun cancel()
|
|
abstract fun shouldRemove(result: Byte): Boolean
|
|
abstract operator fun invoke(input: DataInputStream, result: Byte)
|
|
|
|
class Ordinary(private val classLoader: ClassLoader?,
|
|
private val callback: CompletableDeferred<Parcelable?>) : Callback() {
|
|
override fun cancel() = callback.cancel()
|
|
override fun shouldRemove(result: Byte) = true
|
|
override fun invoke(input: DataInputStream, result: Byte) {
|
|
when (result.toInt()) {
|
|
SUCCESS -> callback.complete(input.readParcelable(classLoader))
|
|
EX_GENERIC -> callback.completeExceptionally(RemoteException(input.readUTF()))
|
|
EX_PARCELABLE -> callback.completeExceptionally(RemoteException().initCause(
|
|
input.readParcelable<Parcelable>(classLoader) as Throwable?))
|
|
else -> throw IllegalArgumentException("Unexpected result $result")
|
|
}
|
|
}
|
|
}
|
|
|
|
class Channel(private val classLoader: ClassLoader?,
|
|
private val channel: SendChannel<Parcelable?>,
|
|
private val server: RootServer,
|
|
private val index: Long) : Callback() {
|
|
var active = true
|
|
val finish: CompletableDeferred<Unit> = CompletableDeferred()
|
|
override fun cancel() = finish.cancel()
|
|
override fun shouldRemove(result: Byte) = result.toInt() != SUCCESS
|
|
override fun invoke(input: DataInputStream, result: Byte) {
|
|
when (result.toInt()) {
|
|
// the channel we are supporting should never block
|
|
SUCCESS -> check(try {
|
|
channel.offer(input.readParcelable(classLoader))
|
|
} catch (closed: Throwable) {
|
|
active = false
|
|
GlobalScope.launch(Dispatchers.Unconfined) { sendClosed() }
|
|
finish.completeExceptionally(closed)
|
|
return
|
|
})
|
|
EX_GENERIC -> finish.completeExceptionally(RemoteException(input.readUTF()))
|
|
EX_PARCELABLE -> finish.completeExceptionally(RemoteException().initCause(
|
|
input.readParcelable<Parcelable>(classLoader) as Throwable?))
|
|
CHANNEL_CONSUMED -> finish.complete(Unit)
|
|
else -> throw IllegalArgumentException("Unexpected result $result")
|
|
}
|
|
}
|
|
|
|
suspend fun sendClosed() = server.execute(ChannelClosed(index))
|
|
}
|
|
}
|
|
|
|
private lateinit var process: Process
|
|
private lateinit var worker: Thread
|
|
/**
|
|
* Thread safety: needs to be protected by mutex.
|
|
*/
|
|
private lateinit var output: DataOutputStream
|
|
|
|
@Volatile
|
|
var active = false
|
|
private var counter = 0L
|
|
private val callbackListenerExit = CompletableDeferred<Unit>()
|
|
private val callbackLookup = LongSparseArray<Callback>()
|
|
private val mutex = Mutex()
|
|
|
|
/**
|
|
* If we encountered unexpected output from stderr during initialization, its content will be stored here.
|
|
*
|
|
* It is advised to read this after initializing the instance.
|
|
*/
|
|
fun readUnexpectedStderr(): String? {
|
|
var available = process.errorStream.available()
|
|
return if (available <= 0) null else String(ByteArrayOutputStream().apply {
|
|
while (available > 0) {
|
|
val bytes = ByteArray(available)
|
|
val len = process.errorStream.read(bytes)
|
|
if (len < 0) throw EOFException() // should not happen
|
|
write(bytes, 0, len)
|
|
available = process.errorStream.available()
|
|
}
|
|
}.toByteArray())
|
|
}
|
|
|
|
private fun BufferedReader.lookForToken(token: String) {
|
|
while (true) {
|
|
val line = readLine() ?: throw EOFException()
|
|
if (line.endsWith(token)) {
|
|
val extraLength = line.length - token.length
|
|
if (extraLength > 0) warnLogger(line.substring(0, extraLength))
|
|
break
|
|
}
|
|
warnLogger(line)
|
|
}
|
|
}
|
|
private fun doInit(context: Context, niceName: String) {
|
|
val writer: DataOutputStream
|
|
val reader: BufferedReader
|
|
try {
|
|
process = ProcessBuilder("su").start()
|
|
val token1 = UUID.randomUUID().toString()
|
|
writer = DataOutputStream(process.outputStream.buffered())
|
|
writer.writeBytes("echo $token1\n")
|
|
writer.flush()
|
|
reader = process.inputStream.bufferedReader()
|
|
reader.lookForToken(token1)
|
|
} catch (e: Exception) {
|
|
throw NoShellException(e)
|
|
}
|
|
if (DEBUG) Log.d(TAG, "Root shell initialized")
|
|
|
|
val appProcess = AppProcess.getAppProcess()
|
|
val token2 = UUID.randomUUID().toString()
|
|
writer.writeBytes(RootJava.getLaunchString(context.packageCodePath + " exec", // hack: plugging in exec
|
|
RootServer::class.java.name, appProcess, AppProcess.guessIfAppProcessIs64Bits(appProcess),
|
|
arrayOf("$token2\n"), niceName))
|
|
writer.flush()
|
|
reader.lookForToken(token2) // wait for ready signal
|
|
output = writer
|
|
require(!active)
|
|
active = true
|
|
if (DEBUG) Log.d(TAG, "Root server initialized")
|
|
}
|
|
|
|
private fun callbackSpin() {
|
|
val input = DataInputStream(process.inputStream.buffered())
|
|
while (active) {
|
|
val index = try {
|
|
input.readLong()
|
|
} catch (_: EOFException) {
|
|
break
|
|
}
|
|
val result = input.readByte()
|
|
val callback = mutex.synchronized {
|
|
callbackLookup[index]!!.also { if (it.shouldRemove(result)) callbackLookup.remove(index) }
|
|
}
|
|
if (DEBUG) Log.d(TAG, "Received callback #$index: $result")
|
|
callback(input, result)
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Initialize a RootServer synchronously, can throw a lot of exceptions.
|
|
*
|
|
* @param context Any [Context] from the app.
|
|
* @param niceName Name to call the rooted Java process.
|
|
*/
|
|
suspend fun init(context: Context, niceName: String = "${context.packageName}:root") {
|
|
val future = CompletableDeferred<Unit>()
|
|
worker = Thread {
|
|
try {
|
|
doInit(context, niceName)
|
|
future.complete(Unit)
|
|
} catch (e: Throwable) {
|
|
future.completeExceptionally(e)
|
|
callbackListenerExit.complete(Unit)
|
|
return@Thread
|
|
}
|
|
try {
|
|
callbackSpin()
|
|
} catch (e: Throwable) {
|
|
callbackListenerExit.completeExceptionally(e)
|
|
return@Thread
|
|
} finally {
|
|
if (DEBUG) Log.d(TAG, "Waiting for exit")
|
|
process.waitFor()
|
|
runBlocking { closeInternal(true) }
|
|
}
|
|
check(process.errorStream.available() == 0) // stderr should not be used
|
|
callbackListenerExit.complete(Unit)
|
|
}
|
|
worker.start()
|
|
future.await()
|
|
}
|
|
/**
|
|
* Convenience function that initializes and also logs warnings to [Log].
|
|
*/
|
|
suspend fun initAndroidLog(context: Context, niceName: String = "${context.packageName}:root") = try {
|
|
init(context, niceName)
|
|
} finally {
|
|
readUnexpectedStderr()?.let { Log.e(TAG, it) }
|
|
}
|
|
|
|
/**
|
|
* Caller should check for active.
|
|
*/
|
|
private fun sendLocked(command: Parcelable) {
|
|
output.writeParcelable(command)
|
|
output.flush()
|
|
if (DEBUG) Log.d(TAG, "Sent #$counter: $command")
|
|
counter++
|
|
}
|
|
|
|
suspend fun execute(command: RootCommandOneWay) = mutex.withLock { if (active) sendLocked(command) }
|
|
@Throws(RemoteException::class)
|
|
suspend inline fun <reified T : Parcelable?> execute(command: RootCommand<T>) =
|
|
execute(command, T::class.java.classLoader)
|
|
@Throws(RemoteException::class)
|
|
suspend fun <T : Parcelable?> execute(command: RootCommand<T>, classLoader: ClassLoader?): T {
|
|
val future = CompletableDeferred<T>()
|
|
mutex.withLock {
|
|
if (active) {
|
|
@Suppress("UNCHECKED_CAST")
|
|
callbackLookup[counter] = Callback.Ordinary(classLoader, future as CompletableDeferred<Parcelable?>)
|
|
sendLocked(command)
|
|
} else future.cancel()
|
|
}
|
|
return future.await()
|
|
}
|
|
|
|
@ExperimentalCoroutinesApi
|
|
@Throws(RemoteException::class)
|
|
inline fun <reified T : Parcelable?> create(command: RootCommandChannel<T>, scope: CoroutineScope) =
|
|
create(command, scope, T::class.java.classLoader)
|
|
@ExperimentalCoroutinesApi
|
|
@Throws(RemoteException::class)
|
|
fun <T : Parcelable?> create(command: RootCommandChannel<T>, scope: CoroutineScope,
|
|
classLoader: ClassLoader?) = scope.produce<T>(
|
|
capacity = command.capacity.also {
|
|
when (it) {
|
|
Channel.UNLIMITED, Channel.CONFLATED -> { }
|
|
else -> throw IllegalArgumentException("Unsupported channel capacity $it")
|
|
}
|
|
}) {
|
|
@Suppress("UNCHECKED_CAST")
|
|
val callback = Callback.Channel(classLoader, this as SendChannel<Parcelable?>, this@RootServer, counter)
|
|
mutex.withLock {
|
|
if (active) {
|
|
callbackLookup[counter] = callback
|
|
sendLocked(command)
|
|
} else callback.finish.cancel()
|
|
}
|
|
try {
|
|
callback.finish.await()
|
|
} finally {
|
|
if (callback.active) withContext(NonCancellable) { callback.sendClosed() }
|
|
callback.active = false
|
|
}
|
|
}
|
|
|
|
private suspend fun closeInternal(fromWorker: Boolean = false) = mutex.withLock {
|
|
if (active) {
|
|
active = false
|
|
if (DEBUG) Log.d(TAG, "Shutting down from client")
|
|
sendLocked(Shutdown())
|
|
output.close()
|
|
process.outputStream.close()
|
|
if (DEBUG) Log.d(TAG, "Client closed")
|
|
}
|
|
if (fromWorker) {
|
|
for (callback in callbackLookup.valueIterator()) callback.cancel()
|
|
callbackLookup.clear()
|
|
}
|
|
}
|
|
/**
|
|
* Shutdown the instance gracefully.
|
|
*/
|
|
suspend fun close() {
|
|
closeInternal()
|
|
callbackListenerExit.await()
|
|
}
|
|
|
|
companion object {
|
|
/**
|
|
* If set to true, debug information will be printed to logcat.
|
|
*/
|
|
@JvmStatic
|
|
var DEBUG = false
|
|
|
|
private const val TAG = "RootServer"
|
|
private const val SUCCESS = 0
|
|
private const val EX_GENERIC = 1
|
|
private const val EX_PARCELABLE = 2
|
|
private const val CHANNEL_CONSUMED = 3
|
|
|
|
private inline fun <reified T : Parcelable> DataInputStream.readParcelable(
|
|
classLoader: ClassLoader? = T::class.java.classLoader
|
|
) = ByteArray(readInt()).also { readFully(it) }.toParcelable<T>(classLoader)
|
|
private fun DataOutputStream.writeParcelable(data: Parcelable?, parcelableFlags: Int = 0) {
|
|
val bytes = data.toByteArray(parcelableFlags)
|
|
writeInt(bytes.size)
|
|
write(bytes)
|
|
}
|
|
|
|
private inline fun <T> Mutex.synchronized(crossinline block: () -> T): T = runBlocking {
|
|
withLock { block() }
|
|
}
|
|
|
|
@JvmStatic
|
|
fun main(args: Array<String>) {
|
|
Thread.setDefaultUncaughtExceptionHandler { thread, throwable ->
|
|
Log.e(TAG, "Uncaught exception from $thread", throwable)
|
|
exitProcess(1)
|
|
}
|
|
rootMain(args)
|
|
exitProcess(0) // there might be other non-daemon threads
|
|
}
|
|
|
|
private fun DataOutputStream.pushThrowable(callback: Long, e: Throwable) {
|
|
writeLong(callback)
|
|
if (e is Parcelable) {
|
|
writeByte(EX_PARCELABLE)
|
|
writeParcelable(e)
|
|
} else {
|
|
writeByte(EX_GENERIC)
|
|
writeUTF(StringWriter().also {
|
|
e.printStackTrace(PrintWriter(it))
|
|
}.toString())
|
|
}
|
|
flush()
|
|
}
|
|
private fun DataOutputStream.pushResult(callback: Long, result: Parcelable?) {
|
|
writeLong(callback)
|
|
writeByte(SUCCESS)
|
|
writeParcelable(result)
|
|
flush()
|
|
}
|
|
|
|
private fun rootMain(args: Array<String>) {
|
|
require(args.isNotEmpty())
|
|
RootJava.restoreOriginalLdLibraryPath()
|
|
val mainInitialized = CountDownLatch(1)
|
|
val main = Thread({
|
|
@Suppress("DEPRECATION")
|
|
Looper.prepareMainLooper()
|
|
mainInitialized.countDown()
|
|
Looper.loop()
|
|
}, "main")
|
|
main.start()
|
|
val job = Job()
|
|
val defaultWorker by lazy {
|
|
mainInitialized.await()
|
|
CoroutineScope(Dispatchers.Main.immediate + job)
|
|
}
|
|
val callbackWorker = newSingleThreadContext("callbackWorker")
|
|
val channels = LongSparseArray<WeakReference<ReceiveChannel<Parcelable?>>>()
|
|
|
|
// thread safety: usage of output should be guarded by callbackWorker
|
|
val output = DataOutputStream(System.out.buffered().apply {
|
|
val writer = writer()
|
|
writer.appendln(args[0]) // echo ready signal
|
|
writer.flush()
|
|
})
|
|
// thread safety: usage of input should be in main thread
|
|
val input = DataInputStream(System.`in`.buffered())
|
|
var counter = 0L
|
|
if (DEBUG) Log.d(TAG, "Server entering main loop")
|
|
loop@ while (true) {
|
|
val command = try {
|
|
input.readParcelable<Parcelable>(RootServer::class.java.classLoader)
|
|
} catch (e: EOFException) {
|
|
break
|
|
}
|
|
val callback = counter
|
|
if (DEBUG) Log.d(TAG, "Received #$callback: $command")
|
|
when (command) {
|
|
is ChannelClosed -> channels[command.index]?.get()?.cancel()
|
|
is RootCommandOneWay -> defaultWorker.launch {
|
|
try {
|
|
command.execute()
|
|
} catch (e: Throwable) {
|
|
Log.e(command.javaClass.simpleName, "Unexpected exception in RootCommandOneWay", e)
|
|
}
|
|
}
|
|
is RootCommand<*> -> defaultWorker.launch {
|
|
val result = try {
|
|
val result = command.execute();
|
|
{ output.pushResult(callback, result) }
|
|
} catch (e: Throwable) {
|
|
{ output.pushThrowable(callback, e) }
|
|
}
|
|
withContext(callbackWorker) { result() }
|
|
}
|
|
is RootCommandChannel<*> -> defaultWorker.launch {
|
|
val result = try {
|
|
command.create(defaultWorker).also {
|
|
channels[callback] = WeakReference(it)
|
|
}.consumeEach { result ->
|
|
withContext(callbackWorker) { output.pushResult(callback, result) }
|
|
};
|
|
@Suppress("BlockingMethodInNonBlockingContext") {
|
|
output.writeByte(CHANNEL_CONSUMED)
|
|
output.writeLong(callback)
|
|
output.flush()
|
|
}
|
|
} catch (e: Throwable) {
|
|
{ output.pushThrowable(callback, e) }
|
|
} finally {
|
|
channels.remove(callback)
|
|
}
|
|
withContext(callbackWorker) { result() }
|
|
}
|
|
is Shutdown -> break@loop
|
|
else -> throw IllegalArgumentException("Unrecognized input: $command")
|
|
}
|
|
counter++
|
|
}
|
|
job.cancel()
|
|
if (DEBUG) Log.d(TAG, "Clean up initiated before exit. Jobs: ${job.children.joinToString()}")
|
|
if (runBlocking { withTimeoutOrNull(5000) { job.join() } } == null) {
|
|
Log.w(TAG, "Clean up timeout: ${job.children.joinToString()}")
|
|
} else if (DEBUG) Log.d(TAG, "Clean up finished, exiting")
|
|
}
|
|
}
|
|
}
|