summaryrefslogtreecommitdiffstats
path: root/README
diff options
context:
space:
mode:
authorGravatar Martin Szulecki2020-06-08 13:54:27 +0200
committerGravatar Martin Szulecki2020-06-08 13:54:27 +0200
commitd544d9d53a18de3435cc75a3804a81a2068fd3b0 (patch)
treebfe556ba9dd224d06a2fa33008148b8ae383b01b /README
parentd173fd9b3243e9a2d5703271e2aa646050ca996e (diff)
downloadifuse-d544d9d53a18de3435cc75a3804a81a2068fd3b0.tar.gz
ifuse-d544d9d53a18de3435cc75a3804a81a2068fd3b0.tar.bz2
Convert README to markdown, update content and links
Diffstat (limited to 'README')
-rw-r--r--README132
1 files changed, 0 insertions, 132 deletions
diff --git a/README b/README
deleted file mode 100644
index 067e222..0000000
--- a/README
+++ /dev/null
@@ -1,132 +0,0 @@
-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>
-
-If ideviceinstaller is installed, obtain the 'appid' (bundle identifier) using:
- $ ideviceinstaller -l
-
-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