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
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
|
About
=====
A fuse filesystem implementation to access the contents of iOS devices.
Requirements
============
Development Packages of:
libfuse (and the associated kernel modules)
libimobiledevice
libplist
Software:
usbmuxd
make
autoheader
automake
autoconf
libtool
pkg-config
gcc
Installation
============
To compile run:
./autogen.sh
./configure
make
sudo make install
Of course you could already use the tool from the src/ directory locally.
Usage
=====
To mount the media partition from the device:
$ ifuse <mountpoint>
Note:
If you mount your device as regular user, the system might complain that
the file /etc/fuse.conf is not readable. It means you do not belong to the
'fuse' group (see below).
To unmount as a regular user you must run:
$ fusermount -u <mountpoint>
By default, ifuse (via the AFC protocol) gives access to the '/var/root/Media/'
chroot on the device (containing music/pictures). This is the right and safe
way to access the device. However, if the device has been jailbroken, a full
view of the device's filesystem might be available using the following command
when mounting:
$ ifuse --root <mountpoint>
Note that only PwnageTool and older jailbreak software installs the necessary
AFC2 service on the device to enable root filesystem usage. For instance
blackra1n does not install it and thus does not enable root filesystem access!
Use with care as the AFC protocol was not made to access the root filesystem.
If using libimobiledevice >= 1.1.0, ifuse can also be used with the iTunes
file/document sharing feature. It allows you to exchange files with an
application on the device directly through it's documents folder by specifing
the application identifier like this:
$ ifuse --documents <appid> <mountpoint>
The following example mounts the documents folder of the VLC app to /mnt:
$ ifuse --documents org.videolan.vlc-ios /mnt
It is also possible to mount the sandboxed root folder of an application
using the --container parameter:
$ ifuse --container <appid> <mountpoint>
Addtional help can be shown using:
$ ifuse --help
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?
===============
Home:
http://www.libimobiledevice.org
Code:
git clone http://git.sukimashita.com/ifuse.git
Code (Mirror):
git clone https://github.com/libimobiledevice/ifuse.git
Tickets:
https://github.com/libimobiledevice/ifuse/issues
Mailing List:
http://lists.libimobiledevice.org/mailman/listinfo/libimobiledevice-devel
IRC:
irc://irc.freenode.net#libimobiledevice
Credits
=======
Apple, iPhone, iPod, iPad, Apple TV and iPod Touch are trademarks of Apple Inc.
ifuse is an independent software program and has not been
authorized, sponsored, or otherwise approved by Apple Inc.
README Updated on:
2013-11-12
|
