Skip site navigation (1)Skip section navigation (2)
Date:      Mon, 19 Nov 2012 03:01:21 GMT
From:      Yuri <yuri@tsoft.com>
To:        freebsd-gnats-submit@FreeBSD.org
Subject:   docs/173710: Added section "MTP storage" to handbook
Message-ID:  <201211190301.qAJ31LUV040040@red.freebsd.org>
Resent-Message-ID: <201211190310.qAJ3A0Or081716@freefall.freebsd.org>

next in thread | raw e-mail | index | archive | help

>Number:         173710
>Category:       docs
>Synopsis:       Added section "MTP storage" to handbook
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Mon Nov 19 03:10:00 UTC 2012
>Closed-Date:
>Last-Modified:
>Originator:     Yuri
>Release:        9.1-RC3
>Organization:
n/a
>Environment:
>Description:
Adding section for MTP protocol: http://en.wikipedia.org/wiki/Media_Transfer_Protocol

It is widely used today in place of umass USB interface in smartphones, digital cameras and music players and deserves its own section in handbook. This will automatically answer some user questions when they want to use such devices with FreeBSD.

>How-To-Repeat:

>Fix:


Patch attached with submission follows:

Index: disks/chapter.xml
===================================================================
--- disks/chapter.xml	(revision 40088)
+++ disks/chapter.xml	(working copy)
@@ -940,10 +940,50 @@
     </sect2>
 
     <sect2>
+      <title>MTP storage</title>
+      <para>Some modern smartphones, music players and cameras adopted
+        &microsoft; protocol Media Transfer Protocol (MTP) as a way to
+        share files through the USB connection. Such device can be
+        identified by the presence of the USB interface with interface
+        id equal to 0x5. MTP, contrary to USB mass storage, shares files
+        and directories, not the media itself. MTP isn't as well supported
+        as USB mass storage by operating systems.</para>
+
+      <para><application>gphotofs</application> from the port
+        <filename role="package">graphics/fusefs-gphotofs</filename> allows
+        to mount MTP as a virtual <quote>fuse</quote> filesystem.
+        Kernel module <filename>fuse.ko</filename>, which is part of
+        <filename role="package">sysutils/fusefs-kmod</filename> port, should
+        be loaded which can either be done from the command line:</para>
+
+        <screen>&prompt.root; <userinput>kldload /usr/local/modules/fuse.ko</userinput></screen>
+
+        <para>or, in order to make it persistent during reboots,
+          by adding the appropriate line to the file
+          <filename>/boot/loader.conf</filename>:</para>
+
+        <programlisting>fuse_load="YES"</programlisting>
+
+        <para>and another line to the file
+          <filename>/etc/rc.conf</filename>:</para>
+
+        <programlisting>fusefs_enable="YES"</programlisting>
+
+        <para>Once fuse kernel module is loaded and MTP device
+          is attached, run the command to mount it as a virtual
+          file system:
+
+        <screen>&prompt.root; <userinput>gphotofs /some/mount/point</userinput></screen>
+
+        <para>This command leaves <application>gphotofs</application>
+          running as a daemon to serve file system requests.</para>
+    </sect2>
+
+    <sect2>
       <title>Further Reading</title>
 
       <para>Beside the <link linkend="disks-adding">Adding
-	  Disks</link> and <link linkend="mount-unmount">Mounting and
+	Disks</link> and <link linkend="mount-unmount">Mounting and
 	Unmounting File Systems</link> sections, reading various
 	manual pages may be also useful: &man.umass.4;,
 	&man.camcontrol.8;, and &man.usbconfig.8; under &os;&nbsp; 8.X


>Release-Note:
>Audit-Trail:
>Unformatted:



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201211190301.qAJ31LUV040040>