/libiosexec

an execve shim to allow executing shell scripts on ios

Primary LanguageCBSD 2-Clause "Simplified" LicenseBSD-2-Clause

libiosexec

An execv shim that allows executing shell scripts on iOS.

Installation

A build of libiosexec is provided on Procursus, which you can install if your device is already setup with the build system.

Alternatively, you can compile libiosexec on your device using Git and Make. Run the commands below to build the project

make install DESTDIR="/install/path"

There are other variables you can specify when building; checkout the Makefile.

Usage

There's not that much to say here; simply define the symbols in your project/script

/* Wrapper functions to make iOS shells scripts function correctly */
#include <libiosexec.h>

Note that this implementation follows FreeBSD/Linux behavior of not splitting the argument passed to the shebang, unlike macOS which does.