summaryrefslogtreecommitdiffstats
path: root/README
blob: e4dcab4b37d5f5abf6805c43e9992cc329bb2541 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
INSTALLATION
================================================================================

For:
	Apple iPhone/iPod Touch 1.0/1.1/1.1.1/1.2/1.3/2.0+
	+ iPod USB cable

You must have:
	libiphone 
	libfuse-dev (and the associated kernel modules)
	libglib2.0-dev
	make
	autoheader
	automake
	autoconf
	gcc

To compile run:
	./autogen.sh
	./configure
	make
	sudo make install  # (if you want to install it into your system directories)

On Ubuntu/Debian, you can do:
	sudo apt-get install build-essential automake autoconf \
          libfuse-dev libglib2.0-dev

(make sure that you have compiled libiphone first)


USAGE
================================================================================

Now comes the fun bit!

To mount:

	mount -t ifuse <device file> <mountpoint> (if installed to /sbin)

	./mount.fuse.ifuse <device file> <mountpoint> (for local access)

Note: the device file is not important and can be anything but it will show up
in the mtab, so sometimes it's useful.

To unmount:
	umount <mountpoint>

Currently ifuse (via the AFC protocol) only gives access to the
'/var/root/Media/' chroot on the iPhone (containing music/pictures). However,
if the device has been jailedbreaked a full view of the iPhone's filesystem
will be available with the following command 

	./mount.fuse.ifuse --afc <device file> <mountpoint>

==== Setting up FUSE ====

Note that on some systems, you may have to load the 'fuse' kernel
module first and to ensure that you are a member of the 'fuse' group:

	sudo modprobe fuse
	sudo adduser $USER fuse

You can check your membership of the 'fuse' group with:

	id | grep fuse && echo yes! || echo not yet...

If you have just added yourself, you will need to logout and log back
in for the group change to become visible.


== Who/what/where? ==

wiki:
	http://matt.colyer.name/projects/iphone-linux/index.php?title=Main_Page

code:
	git clone git://github.com/MattColyer/ifuse.git

mailing list:
	http://lists.mattcolyer.com/listinfo.cgi/iphone-linux-dev-mattcolyer.com

updated:
	2009-03-23