feat(iSH): add build and header synchronization scripts for iSH integration

Signed-off-by: 7HR4IZ3 <90985774+7HR4IZ3@users.noreply.github.com>

Author: 7HR4IZ3

scripts/build-ish.sh

@@ -0,0 +1,38 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+if [[ "$(uname -s)" != "Darwin" ]]; then
+  echo "This script is intended for macOS with Xcode installed."
+  exit 1
+fi
+
+if ! command -v xcodebuild >/dev/null 2>&1; then
+  echo "xcodebuild not found. Install Xcode and Command Line Tools."
+  exit 1
+fi
+
+ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+ISH_DIR="$ROOT_DIR/third_party/ish"
+OUTPUT_DIR="$ROOT_DIR/third_party/ish/build"
+
+if [[ ! -d "$ISH_DIR" ]]; then
+  echo "iSH source not found at $ISH_DIR"
+  exit 1
+fi
+
+mkdir -p "$OUTPUT_DIR"
+
+# NOTE: You need to identify the correct scheme/target from iSH.xcodeproj.
+# Run: xcodebuild -list -project third_party/ish/iSH.xcodeproj
+# Then update SCHEME below.
+SCHEME="iSHLinux"
+
+xcodebuild \
+  -project "$ISH_DIR/iSH.xcodeproj" \
+  -scheme "$SCHEME" \
+  -configuration Release \
+  -sdk iphoneos \
+  BUILD_DIR="$OUTPUT_DIR" \
+  build
+
+echo "Build complete. Locate lib outputs under $OUTPUT_DIR"

scripts/sync-ish-headers.sh

@@ -0,0 +1,12 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+ISH_DIR="$ROOT_DIR/third_party/ish"
+DEST_DIR="$ROOT_DIR/src/plugins/terminal/src/ios/ish/include"
+
+mkdir -p "$DEST_DIR"
+
+cp "$ISH_DIR/app/LinuxInterop.h" "$DEST_DIR/"
+cp "$ISH_DIR/app/Terminal.h" "$DEST_DIR/"
+

src/plugins/terminal/src/ios/IshRootfs.c

@@ -0,0 +1,21 @@
+#include "IshRootfs.h"
+#include <stdlib.h>
+#include <string.h>
+
+static char *ish_root_path = NULL;
+
+void IshSetRootPath(const char *path) {
+    if (!path) {
+        return;
+    }
+    free(ish_root_path);
+    ish_root_path = strdup(path);
+}
+
+__attribute__((weak)) const char *DefaultRootPath(void) {
+    return ish_root_path ? ish_root_path : "";
+}
+
+__attribute__((weak)) void ReportPanic(const char *message) {
+    (void)message;
+}

src/plugins/terminal/src/ios/IshRootfs.h

@@ -0,0 +1,11 @@
+#import <Foundation/Foundation.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+void IshSetRootPath(const char *path);
+
+#ifdef __cplusplus
+}
+#endif

src/plugins/terminal/src/ios/ish/include/LinuxInterop.h

@@ -0,0 +1,71 @@
+//
+//  LinuxInterop.h
+//  iSH
+//
+//  Created by Theodore Dubois on 7/3/21.
+//
+
+#ifndef LinuxInterop_h
+#define LinuxInterop_h
+
+#ifndef __KERNEL__
+#include <sys/types.h>
+#else
+#include <linux/types.h>
+#include <linux/fs.h>
+#endif
+
+void async_do_in_irq(void (^block)(void));
+void async_do_in_workqueue(void (^block)(void));
+void async_do_in_ios(void (^block)(void));
+void sync_do_in_workqueue(void (^block)(void (^done)(void)));
+
+// call into ios from kernel:
+
+void actuate_kernel(const char *cmdline);
+
+void ReportPanic(const char *message);
+void ConsoleLog(const char *data, unsigned len);
+const char *DefaultRootPath(void);
+
+typedef const void *nsobj_t;
+nsobj_t objc_get(nsobj_t object);
+void objc_put(nsobj_t object);
+
+struct linux_tty {
+    struct linux_tty_callbacks *ops;
+};
+struct linux_tty_callbacks {
+    void (*can_output)(struct linux_tty *tty);
+    void (*send_input)(struct linux_tty *tty, const char *data, size_t length);
+    void (*resize)(struct linux_tty *tty, int cols, int rows);
+    void (*hangup)(struct linux_tty *tty);
+};
+
+#ifdef __KERNEL__
+struct file *ios_pty_open(nsobj_t *terminal_out);
+#endif
+
+nsobj_t Terminal_terminalWithType_number(int type, int number);
+void Terminal_setLinuxTTY(nsobj_t _self, struct linux_tty *tty);
+int Terminal_sendOutput_length(nsobj_t _self, const char *data, int size);
+int Terminal_roomForOutput(nsobj_t _self);
+
+nsobj_t UIPasteboard_get(void);
+long UIPasteboard_changeCount(void);
+void UIPasteboard_set(const char *data, size_t len);
+size_t NSData_length(nsobj_t data);
+const void *NSData_bytes(nsobj_t data);
+
+// call into kernel from ios:
+
+typedef void (^StartSessionDoneBlock)(int retval, int pid, nsobj_t terminal);
+void linux_start_session(const char *exe, const char *const *argv, const char *const *envp, StartSessionDoneBlock done);
+
+void linux_sethostname(const char *hostname);
+
+ssize_t linux_read_file(const char *path, char *buf, size_t size);
+ssize_t linux_write_file(const char *path, const char *buf, size_t size);
+int linux_remove_directory(const char *path);
+
+#endif /* LinuxInterop_h */

src/plugins/terminal/src/ios/ish/include/Terminal.h

@@ -0,0 +1,41 @@
+//
+//  Terminal.h
+//  iSH
+//
+//  Created by Theodore Dubois on 10/18/17.
+//
+
+#import <UIKit/UIKit.h>
+#import <WebKit/WebKit.h>
+
+struct tty;
+
+@interface Terminal : NSObject
+
++ (Terminal *)terminalWithType:(int)type number:(int)number;
+#if !ISH_LINUX
+// Returns a strong struct tty and a Terminal that has a weak reference to the same tty
++ (Terminal *)createPseudoTerminal:(struct tty **)tty;
+#endif
+
++ (Terminal *)terminalWithUUID:(NSUUID *)uuid;
+@property (readonly) NSUUID *uuid;
+
++ (void)convertCommand:(NSArray<NSString *> *)command toArgs:(char *)argv limitSize:(size_t)maxSize;
+
+- (int)sendOutput:(const void *)buf length:(int)len;
+- (void)sendInput:(NSData *)input;
+
+- (NSString *)arrow:(char)direction;
+
+// Make this terminal no longer be the singleton terminal with its type and number. Will happen eventually if all references go away, but sometimes you want it to happen now.
+- (void)destroy;
+
+@property (readonly) WKWebView *webView;
+@property (nonatomic) BOOL enableVoiceOverAnnounce;
+// Use KVO on this
+@property (readonly) BOOL loaded;
+
+@end
+
+extern struct tty_driver ios_console_driver;

third_party/ish

@@ -0,0 +1 @@
+Subproject commit 5534d5ac5358574049311fb247fe92bfb808134a