Skip to content

openiboot installation

boxingcow edited this page Mar 20, 2011 · 13 revisions

How to install openiboot :

(You’ll find the same instructions in RUNNING in openiboot folder.)

Requirements

  • A PC running a Linux operating system
    • git revision control system. This package is called “git-core” in some operating systems, such as Ubuntu.
  • A “pwned” iPhone or iPod Touch. A device can be “pwned” using either the Pwnage Tool or QuickPwn, both of which are available at http://blog.iphone-dev.org/ .

Check out the code:

git clone git://github.com/planetbeing/iphonelinux.git
cd iphonelinux/

The following is a general copy/paste of the RUNNING in openiboot folder:

Building openiboot for the first time:

  1. Build an ARM toolchain (only needs to be done once):
    1. Run, as root:
      toolchain/build-toolchain.sh make
    2. Wait, for a long time, as the toolchain is compiled.
  2. Compile OpeniBoot:
    1. To run openiboot from the recovery mode (a.k.a iboot), you’ll need to create an img3 image.
    2. Build: (A system capable of running x86 Linux binaries is required. If compiling on 64-bit linux, you may need libc6-dev-i386 and type export ARCH=x86_64 before you proceed with the next steps.)
      1. For iPod touch, run:
        PLATFORM=IPOD make openiboot.img3
      2. For iPhone 2G, run:
        PLATFORM=IPHONE make openiboot.img3
      3. For iPhone 3G, run:
        PLATFORM=3G make openiboot.img3
      4. If you have linker problems with mk8900image please see Common Issues and Questions
    3. Compile all in client/ :
      cd client && make all && cd ..
      (requires libusb, libreadline and pthread)
    4. sudo client/loadibec openiboot.img3
    5. Run the client:
      sudo client/oibc
  3. To install openiboot in the NOR (optional): run “install” in openiboot client (to uninstall, restore/update/run QuickPwn)

Updating an existing openiboot installation:

  1. Pull the new code from Git: (“git pull” if you already downloaded the code using Git)
  2. Compile openiboot, but this time you don’t have to make an img3 image:
    1. For iPod Touch, run:
      PLATFORM=IPOD make
    2. For iPhone 2G, run:
      PLATFORM=IPHONE make
    3. For iPhone 3G, run:
      PLATFORM=3G make
  3. Compile all in client/:
    cd client && make all && cd ..
    (requires libusb, libreadline and pthread)
  4. Launch openiboot, using the menu on the device.
  5. Run the client:
    sudo client/oibc
  6. Copy the openiboot binary in the device memory:
    !openiboot.bin
  7. Jump to it:
    go 0×09000000
  8. Relaunch openiboot console using the menu on the device.
  9. Relaunch the client:
    sudo client/oibc
  10. Install the new version:
    install