svn commit: r50613 - head/en_US.ISO8859-1/books/handbook/virtualization

[Sevan Janiyan]

Author: sevan
Date: Tue Aug  1 11:09:01 2017
New Revision: 50613
URL: https://svnweb.freebsd.org/changeset/doc/50613

Log:
  The handbook currently states that USB passthrough is not possible without an extension pack.
  This is incorrect, virtualbox-ose is merely limited to emulating a USB1.1 host controller.
  
  PR:		220350
  Submitted by:	Johannes Jost Meixner
  Approved by:	bcr (mentor)
  Differential Revision:	https://reviews.freebsd.org/D11685

Modified:
  head/en_US.ISO8859-1/books/handbook/virtualization/chapter.xml

Modified: head/en_US.ISO8859-1/books/handbook/virtualization/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/handbook/virtualization/chapter.xml	Tue Aug  1 09:55:45 2017	(r50612)
+++ head/en_US.ISO8859-1/books/handbook/virtualization/chapter.xml	Tue Aug  1 11:09:01 2017	(r50613)
@@ -920,11 +920,26 @@ perm    vboxnetctl 0660</programlisting>
     <sect2 xml:id="virtualization-virtualbox-usb-support">
       <title>&virtualbox; USB Support</title>
 
-      <para>The <application>&virtualbox;</application> extension
-	pack is not available for &os; hosts.  Without the extension
-	pack, the &os; host cannot pass <acronym>USB</acronym>
-	ports through to guest operating systems.</para>
-    </sect2>
+      <para><application>&virtualbox;</application> can be configured
+      to pass <acronym>USB</acronym> devices through to the guest
+      operating system.  The host controller of the OSE version is
+      limited to emulating <acronym>USB</acronym> 1.1 devices until
+      the extension pack supporting <acronym>USB</acronym> 2.0 and 3.0
+      devices becomes available on &os;.</para>
+
+      <para>For <application>&virtualbox;</application> to be
+      aware of <acronym>USB</acronym> devices attached to the
+      machine, the user needs to be a member of the <systemitem
+      class="groupname">operator</systemitem> group.</para>
+
+      <screen>&prompt.root; <userinput>pw groupmod operator -m
+      <replaceable>yourusername</replaceable></userinput></screen>
+
+      <para>Restart the login session and
+      <application>&virtualbox;</application> for these changes to take
+      effect, and create <acronym>USB</acronym> filters as
+      necessary.</para>
+      </sect2>
 
     <sect2 xml:id="virtualization-virtualbox-host-dvd-cd-access">
       <title>&virtualbox; Host