The result is a speedup of roughly 3-5x compared to pure emulation. Instead it generates an array of pointers to functions called gadgets, and each gadget ends with a tailcall to the next function like the threaded code technique used by some Forth interpreters.

It’s not actually a JIT since it doesn’t target machine code. Possibly the most interesting thing I wrote as part of iSH is the JIT.

Grep for DEFAULT_CHANNEL to see if more log channels have been added since this list was updated.

verbose: Debug logs that don’t fit into another category.

instr: Logs every instruction executed by the emulator.

strace: The most useful channel, logs the parameters and return value of almost every system call.

With Meson (command line tool for testing): Run meson configure -Dlog='.

In Xcode: Set the ISH_LOG setting in iSH.xcconfig to a space-separated list of log channels.

ISH has several logging channels which can be enabled at build time. You can replace ish with tools/ptraceomatic to run the program in a real process and single step and compare the registers at each step. If tools/fakefsify doesn’t exist for you in your build directory, that might be because it couldn’t find libarchive on your system (see above for ways to install it.)

ish -f alpine /bin/login -f root, assuming the output directory is called alpine. Then you can run things inside the Alpine filesystem with. tools/fakefsify, with the minirootfs tarball as the first argument and the name of the output directory as the second argument. To set up a self-contained Alpine linux filesystem, download the Alpine minirootfs tarball for i386 from the Alpine website and run. Then cd to the build directory and run ninja. To set up your environment, cd to the project and run meson build to create a build directory in build. If you run into any problems, open an issue and I’ll try to help.

There are scripts that should do everything else automatically. Open the project in Xcode, open iSH.xcconfig, and change ROOT_BUNDLE_IDENTIFIER to something unique.

libarchive ( brew install libarchive, sudo port install libarchive, sudo apt install libarchive-dev) TODO: bundle this dependency.

if not, do something like sudo apt install libsqlite3-dev)

sqlite3 (this is so common it may already be installed on linux and is definitely already installed on mac.

Clang and LLD (on mac, brew install llvm, on linux, sudo apt install clang lldor sudo pacman -S clang lld or whatever).

You’ll need these things to build the project: This project has a git submodule, make sure to clone with -recurse-submodules or run git submodule update -initafter cloning.

README in Chinese (may be out of date, if so send PRs).

ISH is a project to get a Linux shell running on iOS, using usermode x86 emulation and syscall translation.įor the current status of the project, check the issues tab, and the commit logs.

Kali linux emulator mac