update readme file
This commit is contained in:
Peter Hatina
parent
41cfc9bace
commit
6194d98049
48
README
48
README
|
|
@ -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
|
||||
|
|
@ -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"
|
||||
Loading…
Reference in New Issue