ish-app/ish
Fork: 874 Star: 16666 (更新于 2024-08-11 16:05:43)
license: NOASSERTION
Language: C .
Linux shell for iOS
最后发布版本: builds/699 ( 2024-07-22 14:15:44)
iSH
A project to get a Linux shell running on iOS, using usermode x86 emulation and syscall translation.
For the current status of the project, check the issues tab, and the commit logs.
- App Store page
- TestFlight beta
- Discord server
- Wiki with help and tutorials
- README中文 (如若未能保持最新,请提交PR以更新)
Hacking
This project has a git submodule, make sure to clone with --recurse-submodules
or run git submodule update --init
after cloning.
You'll need these things to build the project:
- Python 3
- Meson (
pip3 install meson
)
- Meson (
- Ninja
- Clang and LLD (on mac,
brew install llvm
, on linux,sudo apt install clang lld
orsudo pacman -S clang lld
or whatever) - sqlite3 (this is so common it may already be installed on linux and is definitely already installed on mac. if not, do something like
sudo apt install libsqlite3-dev
) - libarchive (
brew install libarchive
,sudo port install libarchive
,sudo apt install libarchive-dev
) TODO: bundle this dependency
Build for iOS
Open the project in Xcode, open iSH.xcconfig, and change ROOT_BUNDLE_IDENTIFIER
to something unique. You'll also need to update the development team ID in the project (not target!) build settings. Then click Run. There are scripts that should do everything else automatically. If you run into any problems, open an issue and I'll try to help.
Build command line tool for testing
To set up your environment, cd to the project and run meson build
to create a build directory in build
. Then cd to the build directory and run ninja
.
To set up a self-contained Alpine linux filesystem, download the Alpine minirootfs tarball for i386 from the Alpine website and run ./tools/fakefsify
, with the minirootfs tarball as the first argument and the name of the output directory as the second argument. Then you can run things inside the Alpine filesystem with ./ish -f alpine /bin/sh
, assuming the output directory is called alpine
. 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.)
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. I use it for debugging. Requires 64-bit Linux 4.11 or later.
Logging
iSH has several logging channels which can be enabled at build time. By default, all of them are disabled. To enable them:
- In Xcode: Set the
ISH_LOG
setting in iSH.xcconfig to a space-separated list of log channels. - With Meson (command line tool for testing): Run
meson configure -Dlog="<space-separated list of log channels>"
.
Available channels:
-
strace
: The most useful channel, logs the parameters and return value of almost every system call. -
instr
: Logs every instruction executed by the emulator. This slows things down a lot. -
verbose
: Debug logs that don't fit into another category. - Grep for
DEFAULT_CHANNEL
to see if more log channels have been added since this list was updated.
A note on the interpreter
Possibly the most interesting thing I wrote as part of iSH is the interpreter. It's not quite a JIT since it doesn't target machine code. 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. The result is a speedup of roughly 3-5x compared to emulation using a simpler switch dispatch.
Unfortunately, I made the decision to write nearly all of the gadgets in assembly language. This was probably a good decision with regards to performance (though I'll never know for sure), but a horrible decision with regards to readability, maintainability, and my sanity. The amount of bullshit I've had to put up with from the compiler/assembler/linker is insane. It's like there's a demon in there that makes sure my code is sufficiently deformed, and if not, makes up stupid reasons why it shouldn't compile. In order to stay sane while writing this code, I've had to ignore best practices in code structure and naming. You'll find macros and variables with such descriptive names as ss
and s
and a
. Assembler macros nested beyond belief. And to top it off, there are almost no comments.
So a warning: Long-term exposure to this code may cause loss of sanity, nightmares about GAS macros and linker errors, or any number of other debilitating side effects. This code is known to the State of California to cause cancer, birth defects, and reproductive harm.
最近版本更新:(数据更新于 2024-07-22 18:24:54)
2024-07-22 14:15:44 builds/699
2024-07-21 14:14:59 builds/698
2024-07-20 14:15:55 builds/697
2024-07-18 14:15:26 builds/696
2024-07-17 14:16:32 builds/695
2024-07-16 14:15:33 builds/694
2024-07-14 14:15:41 builds/693
2024-07-13 14:15:14 builds/692
2024-06-25 14:15:17 builds/691
2024-06-22 14:14:58 builds/690
主题(topics):
emulator, hacktoberfest, ios, linux
ish-app/ish同语言 C最近更新仓库
2024-09-06 10:44:50 EdgeTX/edgetx
2024-09-02 22:32:10 confluentinc/librdkafka
2024-09-01 21:25:25 ACINQ/phoenix
2024-09-01 06:03:50 c3lang/c3c
2024-08-30 13:44:08 BasedHardware/omi
2024-08-26 07:23:15 Next-Flip/Momentum-Firmware