update readme file

This commit is contained in:
Peter Hatina 2013-12-03 19:52:12 +01:00
parent 41cfc9bace
commit 6194d98049
2 changed files with 86 additions and 48 deletions

48
README
View File

@ -1,48 +0,0 @@
1. ABSTRACT
===========
SIMPLE-MTPFS (Simple Media Transfer Protocol FileSystem) is a file system for
Linux (and other operating systems with a FUSE implementation, such as Mac OS X
or FreeBSD) capable of operating on files on MTP devices attached via
USB to local machine. On the local computer where the SIMPLE-MTPFS is
mounted, the implementation makes use of the FUSE (Filesystem in Userspace)
kernel module. The practical effect of this is that the end user can seamlessly
interact with MTP device files.
2. LATEST VERSION
=================
Latest version of the software can be found on:
https://github.com/phatina/simple-mtpfs
3. MOUNTING
===========
To mount MTP-based device to your local filesystem, simply run:
simple-mtpfs <mountpoint>
To unmount MTP device, use following:
fusermount -u <mountpoint>
4. INSTALLING
=============
Simple-mtpfs depends on fuse (version >2.8) and libmtp. It also requires the C++
compiler to support c++11 standard.
To install the driver, follow these steps:
mkdir build && cd build
../configure
make
make install (as root)
The project can be set to use custom directory for temporary files. To configure
the simple-mtpfs to use desired temporary directory, add --with-tmpdir=TMPDIR
option to configure script. Default value for temporary directory is "/tmp".
If you got the sources from git repository, first you have to run:
./autogen.sh

86
README.md Normal file
View File

@ -0,0 +1,86 @@
ABOUT
=====
SIMPLE-MTPFS (Simple Media Transfer Protocol FileSystem) is a file system for
Linux (and other operating systems with a FUSE implementation, such as Mac OS X
or FreeBSD) capable of operating on files on MTP devices attached via USB to
local machine. On the local computer where the SIMPLE-MTPFS is mounted, the
implementation makes use of the FUSE (Filesystem in Userspace) kernel module.
The practical effect of this is that the end user can seamlessly interact with
MTP device files.
LATEST VERSION
==============
Latest sources of the software can be found at: [simple-mtpfs][]
INSTALLATION
============
Simple-mtpfs depends on fuse (version >= **2.7.3**) and libmtp. It also
requires the C++ compiler to support **C++11** standard.
To install the driver, follow these steps:
$ mkdir build && cd build
$ ../configure
$ make
$ make install (as root)
Due to MTP nature, it is necessary to use a folder, where the temporary files
downloaded will be downloaded. The project can be configured to use custom
directory for such files. To configure the simple-mtpfs to use desired
temporary directory, add `--with-tmpdir=TMPDIR` option to configure script.
Default value for temporary directory is `/tmp`.
If you got the sources from git repository, first you have to run:
$ ./autogen.sh
MOUNTING
========
To mount MTP-based device to your local filesystem, simply run:
$ simple-mtpfs mountpoint [options]
If you have more than one MTP device attached to the computer, it is possible
to specify which device, you are willing to mount. Either by entering its **order
number** or special file usually placed in `/dev`:
MOUNTING BY NUMBER
------------------
$ simple-mtpfs --device <number> mountpoint [options]
Where the `<number>` should contain a numeric order of the device, you are
about to mount. To get a list of all attached devices, execute following:
$ simple-mtpfs --list-devices
<number>: <device name>
<number>: <device name>
...
MOUNTING BY SPECIAL FILE
------------------------
Enter special device file as the first argument to simple-mtpfs. The special device
file is usually named as `/dev/libmtp-*`.
$ simple-mtpfs <device> mountpoint [options]
UNMOUNTING
==========
To unmount MTP device, execute following command:
$ fusermount -u <mountpoint>
BUG REPORTS
===========
Report bugs to [phatina@gmail.com](mailto:phatina@gmail.com) or
[simple-mtpfs issues][].
[simple-mtpfs]: https://github.com/phatina/simple-mtpfs "simple-mtpfs repository on github"
[simple-mtpfs issues]: https://github.com/phatina/simple-mtpfs/issues "Report a bug"