summaryrefslogtreecommitdiffstats
path: root/README
diff options
context:
space:
mode:
authorGravatar Matt Colyer2008-07-30 23:50:39 -0700
committerGravatar Matt Colyer2008-07-30 23:50:39 -0700
commit47d60e2b9f8ddec18107cee21e046cd4df50fdef (patch)
treea62e8401b521f54c592ea2c27f92cabf08890ca0 /README
parentd4c28088e8d189469d42ff57372eb7c9d0e75496 (diff)
downloadlibimobiledevice-47d60e2b9f8ddec18107cee21e046cd4df50fdef.tar.gz
libimobiledevice-47d60e2b9f8ddec18107cee21e046cd4df50fdef.tar.bz2
Added documentation and licensing information.
Diffstat (limited to 'README')
-rw-r--r--README47
1 files changed, 47 insertions, 0 deletions
diff --git a/README b/README
new file mode 100644
index 0000000..f387f69
--- /dev/null
+++ b/README
@@ -0,0 +1,47 @@
+INSTALLATION
+================================================================================
+
+You must have:
+ libgnutls-dev
+ libusb-dev
+ libfuse-dev (and the associated kernel modules)
+ libglib2.0-dev
+ libxml2-dev
+ make
+ autoheader
+ automake
+ autoconf
+ gcc
+
+IMPORTANT: You must edit src/ifuse.c and src/main.c and replace your HostID
+from the plist file stored by iTunes. You can find these lines because they are
+currently commented out. In Windows this file is located in:
+
+C:\Documents and Settings\Your Username\Application Data\Apple Computer\Lockdown\<device serial number>.plist
+
+IMPORTANT: You must also have a public certificate for the device located in
+the root directory of the source named hostcert.pem. This can also be extracted
+from the above file.
+
+To compile run:
+ ./autogen.sh
+ ./configure
+ make
+
+USAGE
+================================================================================
+
+There are currently 2 executables iphoneclient and ifuse, located in src/.
+
+iphoneclient is a basic commandline interface, it just runs a few various operations.
+
+ifuse is a Fuse filesystem which allows you to mount your iPhone to a directory
+like this:
+
+ ./src/ifuse mountpoint
+
+To unmount:
+ umount mountpoint
+
+Currently the ifuse filesystem is read-only, until the development has
+progressed further.