Doc building for ios

This currently does not work.

Options

Option 1: Convert Rust's LLVM bitcode to C-code

rustc foo.rs -o foo.stage2 -O --save-temps
llc -march=c foo.bc -o foo.c

Option 2: Use Rust's Android-ARM assembler code

TODO: something using rustc --emit-llvm -S --target=arm-linux-androideabi

Option 3: Add native iOS-support to Rust

1. Adjust src/rt/rust_builtin.cpp:

#ifdef __APPLE__
    #include <TargetConditionals.h>
    #include <mach/mach_time.h>

    #if defined(TARGET_OS_IPHONE)
        extern char **environ;
    #else
        #include <crt_externs.h>
    #endif
#endif

and

rust_env_pairs() {
#ifdef __APPLE__ && !defined(TARGET_OS_IPHONE)
    char **environ = *_NSGetEnviron();
#endif

1. Adjust src/rt/arch/arm/_context.S:

#if defined(__APPLE__)
.align 2
#else
.align
#endif

1. Adjust src/rt/arch/arm/record_sp.S:

#if defined(__APPLE__)
.align 2
#else
.align
#endif

1. Build Rust:

mkdir build; cd build
../configure --target-triples=arm-apple-darwin
make VERBOSE=1

1. Use Rust:

rustc --target=arm-apple-darwin foo.rs

TODO

• Compilation currently fails with

  /Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin/clang '-D_LARGEFILE_SOURCE' '-D_FILE_OFFSET_BITS=64' '-DHAVE_CONFIG_H' '-D_DARWIN_USE_64_BIT_INODE=1' '-DNDEBUG' -I../../../../src/libuv/include -I../../../../src/libuv/src  -Os -gdwarf-2 -fvisibility=hidden -Wnewline-eof -arch i386 -Wall -Wendif-labels -W -Wno-unused-parameter -fstrict-aliasing -MMD -MF ./.deps/obj.target/libuv/src/fs-poll.o.d.raw -DRUST_DEBUG -fno-omit-frame-pointer -O2 -fPIC -std=gnu99  -c -o obj.target/libuv/src/fs-poll.o ../../../../src/libuv/src/fs-poll.c
In file included from ../../../../src/libuv/src/fs-poll.c:22:
In file included from ../../../../src/libuv/include/uv.h:48:
../../../../src/libuv/include/uv-errno.h:25:10: fatal error: 'errno.h' file not found

Possible adjustments

• Compilation:
  • Compile twice, with both -arch armv7 and -arch armv7s (A6 processor) ?
    • See https://github.com/ghc-ios/ghc-ios-scripts/blob/master/arm-apple-darwin10-gcc
• Code:
  • src/librustc/back/arm.rs
  • src/rt/arch/arm/record_sp.S

Resources

• https://github.com/mozilla/rust/issues/6170
• ARM Machine Directives: .align
• Building a GHC cross-compiler for Apple iOS targets
• Doc building for android
• environ.7: _NSGetEnviron()
• iOS ABI Function Call Guide
• llc
• llvm-dis
• Note seeing LLVM output from rust