From nobody@FreeBSD.org  Mon Nov 19 03:01:21 2012
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52])
	by hub.freebsd.org (Postfix) with ESMTP id BCB1890D
	for <freebsd-gnats-submit@FreeBSD.org>; Mon, 19 Nov 2012 03:01:21 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from red.freebsd.org (red.freebsd.org [IPv6:2001:4f8:fff6::22])
	by mx1.freebsd.org (Postfix) with ESMTP id 985478FC13
	for <freebsd-gnats-submit@FreeBSD.org>; Mon, 19 Nov 2012 03:01:21 +0000 (UTC)
Received: from red.freebsd.org (localhost [127.0.0.1])
	by red.freebsd.org (8.14.5/8.14.5) with ESMTP id qAJ31LxV040048
	for <freebsd-gnats-submit@FreeBSD.org>; Mon, 19 Nov 2012 03:01:21 GMT
	(envelope-from nobody@red.freebsd.org)
Received: (from nobody@localhost)
	by red.freebsd.org (8.14.5/8.14.5/Submit) id qAJ31LUV040040;
	Mon, 19 Nov 2012 03:01:21 GMT
	(envelope-from nobody)
Message-Id: <201211190301.qAJ31LUV040040@red.freebsd.org>
Date: Mon, 19 Nov 2012 03:01:21 GMT
From: Yuri <yuri@tsoft.com>
To: freebsd-gnats-submit@FreeBSD.org
Subject: Added section "MTP storage" to handbook
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>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:
