From owner-freebsd-doc@FreeBSD.ORG Mon Nov 19 03:10:00 2012 Return-Path: Delivered-To: freebsd-doc@smarthost.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id A4F829E7 for ; Mon, 19 Nov 2012 03:10:00 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:1900:2254:206c::16:87]) by mx1.freebsd.org (Postfix) with ESMTP id 7BBD58FC12 for ; Mon, 19 Nov 2012 03:10:00 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.5/8.14.5) with ESMTP id qAJ3A0CT081717 for ; Mon, 19 Nov 2012 03:10:00 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id qAJ3A0Or081716; Mon, 19 Nov 2012 03:10:00 GMT (envelope-from gnats) Resent-Date: Mon, 19 Nov 2012 03:10:00 GMT Resent-Message-Id: <201211190310.qAJ3A0Or081716@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Yuri Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id BCB1890D for ; 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 ; 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 ; 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 To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-3.1 Subject: docs/173710: Added section "MTP storage" to handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 19 Nov 2012 03:10:00 -0000 >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 @@ + MTP storage + Some modern smartphones, music players and cameras adopted + µsoft; 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. + + gphotofs from the port + graphics/fusefs-gphotofs allows + to mount MTP as a virtual fuse filesystem. + Kernel module fuse.ko, which is part of + sysutils/fusefs-kmod port, should + be loaded which can either be done from the command line: + + &prompt.root; kldload /usr/local/modules/fuse.ko + + or, in order to make it persistent during reboots, + by adding the appropriate line to the file + /boot/loader.conf: + + fuse_load="YES" + + and another line to the file + /etc/rc.conf: + + fusefs_enable="YES" + + Once fuse kernel module is loaded and MTP device + is attached, run the command to mount it as a virtual + file system: + + &prompt.root; gphotofs /some/mount/point + + This command leaves gphotofs + running as a daemon to serve file system requests. + + + Further Reading Beside the Adding - Disks and Mounting and + Disks and Mounting and Unmounting File Systems sections, reading various manual pages may be also useful: &man.umass.4;, &man.camcontrol.8;, and &man.usbconfig.8; under &os;  8.X >Release-Note: >Audit-Trail: >Unformatted: