|
 |
3d8e2c8 |
.\" Hey, EMACS: -*- nroff -*-
|
|
|
3d8e2c8 |
.\" (C) Copyright 2013 Apollon Oikonomopoulos <apoikos@debian.org>
|
|
|
3d8e2c8 |
.\"
|
|
|
3d8e2c8 |
.\" First parameter, NAME, should be all caps
|
|
|
3d8e2c8 |
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
|
|
|
3d8e2c8 |
.\" other parameters are allowed: see man(7), man(1)
|
|
|
3d8e2c8 |
.TH JMTPFS 1 "May 30, 2013"
|
|
|
3d8e2c8 |
.\" Please adjust this date whenever revising the manpage.
|
|
|
3d8e2c8 |
.\"
|
|
|
3d8e2c8 |
.\" Some roff macros, for reference:
|
|
|
3d8e2c8 |
.\" .nh disable hyphenation
|
|
|
3d8e2c8 |
.\" .hy enable hyphenation
|
|
|
3d8e2c8 |
.\" .ad l left justify
|
|
|
3d8e2c8 |
.\" .ad b justify to both left and right margins
|
|
|
3d8e2c8 |
.\" .nf disable filling
|
|
|
3d8e2c8 |
.\" .fi enable filling
|
|
|
3d8e2c8 |
.\" .br insert line break
|
|
|
3d8e2c8 |
.\" .sp <n> insert n+1 empty lines
|
|
|
3d8e2c8 |
.\" for manpage-specific macros, see man(7)
|
|
|
3d8e2c8 |
.SH NAME
|
|
|
3d8e2c8 |
jmptfs \- FUSE based filesystem for accessing MTP devices
|
|
|
3d8e2c8 |
.SH SYNOPSIS
|
|
|
3d8e2c8 |
.B jmtpfs
|
|
|
3d8e2c8 |
.RI [ options ] " " MOUNTPOINT
|
|
|
3d8e2c8 |
.SH DESCRIPTION
|
|
|
3d8e2c8 |
.B jmtpfs
|
|
|
3d8e2c8 |
is a FUSE and libmtp based filesystem for accessing MTP (Media Transfer
|
|
|
3d8e2c8 |
Protocol) devices. It was specifically designed for exchaning files between
|
|
|
3d8e2c8 |
Linux (and Mac OS X) systems and newer Android devices that support MTP but not
|
|
|
3d8e2c8 |
USB Mass Storage.
|
|
|
3d8e2c8 |
|
|
|
3d8e2c8 |
The goal is to create a well-behaved filesystem, allowing tools like
|
|
|
3d8e2c8 |
.BR find (1)
|
|
|
3d8e2c8 |
and
|
|
|
3d8e2c8 |
.BR rsync (1)
|
|
|
3d8e2c8 |
to work as expected. MTP file types are set automatically based on file
|
|
|
3d8e2c8 |
type detection using
|
|
|
3d8e2c8 |
.BR libmagic (3) "" .
|
|
|
3d8e2c8 |
Setting the file type is necessary for some Android applications, like Gallery,
|
|
|
3d8e2c8 |
to be able to find and use the files uploaded to the device.
|
|
|
3d8e2c8 |
.SH USAGE
|
|
|
3d8e2c8 |
For regular use, simply specifying a MOUNTPOINT will have the first available
|
|
|
3d8e2c8 |
MTP device mounted under it. Mounted devices should be unmounted using
|
|
|
3d8e2c8 |
.IP
|
|
|
3d8e2c8 |
.BR fusermount " " -u "" " " MOUNTPOINT
|
|
|
3d8e2c8 |
.PP
|
|
|
3d8e2c8 |
(see
|
|
|
3d8e2c8 |
.BR fusermount (1)
|
|
|
3d8e2c8 |
for more details).
|
|
|
3d8e2c8 |
|
|
|
3d8e2c8 |
.BR Note:
|
|
|
3d8e2c8 |
most (if not all) Android phones have to be unlocked when first accessed over MTP; if
|
|
|
3d8e2c8 |
you get an input/output error on the mountpoint, unlock the phone and retry.
|
|
|
3d8e2c8 |
.SH OPTIONS
|
|
|
3d8e2c8 |
.B jmtpfs
|
|
|
3d8e2c8 |
accepts the following options:
|
|
|
3d8e2c8 |
.TP
|
|
|
3d8e2c8 |
.B \-h
|
|
|
3d8e2c8 |
Show summary of options.
|
|
|
3d8e2c8 |
.TP
|
|
|
3d8e2c8 |
.B \-V, \-\-version
|
|
|
3d8e2c8 |
Show the program version.
|
|
|
3d8e2c8 |
.TP
|
|
|
3d8e2c8 |
.B \-l, \-\-listDevices
|
|
|
3d8e2c8 |
List all available MTP devices.
|
|
|
3d8e2c8 |
.TP
|
|
|
3d8e2c8 |
\fB\-device\fR=\fI<busnum>\fR,\fI<devnum>\fR
|
|
|
3d8e2c8 |
Specify the device to mount. If unspecified, the first device found is used.
|
|
|
3d8e2c8 |
.PP
|
|
|
3d8e2c8 |
In addition to these options, all options supported by
|
|
|
3d8e2c8 |
.BR fuse (8)
|
|
|
3d8e2c8 |
are available. See
|
|
|
3d8e2c8 |
.B jmtpfs -h
|
|
|
3d8e2c8 |
for more information.
|
|
|
3d8e2c8 |
.SH SEE ALSO
|
|
|
3d8e2c8 |
.BR fuse (8),
|
|
|
3d8e2c8 |
.BR fusermount (1)
|
|
|
3d8e2c8 |
.SH AUTHORS
|
|
|
3d8e2c8 |
jmtpfs was written by Jason Ferrara <jason.ferrara@jacquette.com>.
|
|
|
3d8e2c8 |
|
|
|
3d8e2c8 |
This manual page was written by Apollon Oikonomopoulos <apoikos@debian.org>, for
|
|
|
3d8e2c8 |
the Debian project (but may be used by others).
|