Index: trunk/doc/manual/en_US/man_VBoxHeadless.xml
===================================================================
--- trunk/doc/manual/en_US/man_VBoxHeadless.xml	(revision 82044)
+++ trunk/doc/manual/en_US/man_VBoxHeadless.xml	(revision 82044)
@@ -0,0 +1,228 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+    manpage, user manual, usage: VBoxHeadless
+
+    Copyright (C) 2006-2019 Oracle Corporation
+
+    This file is part of VirtualBox Open Source Edition (OSE), as
+    available from http://www.virtualbox.org. This file is free software;
+    you can redistribute it and/or modify it under the terms of the GNU
+    General Public License (GPL) as published by the Free Software
+    Foundation, in version 2 as it comes in the "COPYING" file of the
+    VirtualBox OSE distribution. VirtualBox OSE is distributed in the
+    hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
+ -->
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+  "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"[
+<!ENTITY % all.entities SYSTEM "all-entities.ent">
+%all.entities;
+]>
+<refentry id="vboxmanage-vboxheadless" lang="en">
+  <refentryinfo>
+    <pubdate>August 2019</pubdate>
+    <title>VBoxHeadless</title>
+  </refentryinfo>
+
+  <refmeta>
+    <refentrytitle>VBoxHeadless</refentrytitle>
+    <manvolnum>1</manvolnum>
+  </refmeta>
+
+  <refnamediv>
+    <refname>VBoxHeadless</refname>
+    <refpurpose>&product-name; remote desktop server</refpurpose>
+    <refclass>Oracle VM VirtualBox</refclass>
+  </refnamediv>
+
+  <refsynopsisdiv>
+    <cmdsynopsis id="synopsis-vboxmanage-vboxheadless">
+      <command>VBoxHeadless</command> 
+      <arg>--startvm=<group>
+          <arg choice="plain"><replaceable>uuid</replaceable></arg>
+          <arg choice="plain"><replaceable>vmname</replaceable></arg>
+        </group></arg>      
+      <arg>--vrde=<group choice="plain">
+          <arg choice="plain">on</arg>
+          <arg choice="plain">off</arg>
+          <arg choice="plain">config</arg>
+        </group></arg>      
+      <arg>--vrdeproperty=<replaceable>prop-name</replaceable>=[<replaceable>prop-value</replaceable>]</arg>      
+      <arg>--settingspw=[<replaceable>password</replaceable>]</arg>      
+      <arg>--settingspwfile=<replaceable>password-file</replaceable></arg>      
+      <arg>--start-paused=<replaceable>vmname</replaceable></arg>      
+      <arg>--capture</arg>     
+      <arg>--width=<replaceable>width</replaceable></arg>      
+      <arg>--height=<replaceable>height</replaceable></arg>      
+      <arg>--bitrate=<replaceable>bit-rate</replaceable></arg>     
+      <arg>--filename=<replaceable>filename</replaceable></arg>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+
+  <refsect1>
+    <title>Description</title>
+    <para>
+      The <command>VBoxHeadless</command> command is an alternate front
+      end that enables you to remotely manage virtual machines (VMs).
+      The front end is a CLI rather than the VirtualBox Manager
+      graphical user interface (GUI).
+    </para>
+    <para>
+      For information about using this command, see
+      <xref linkend="vboxheadless" />.
+    </para>
+    <refsect2 id="vboxmanage-vboxheadless-command-options">
+      <title>Command Options</title>
+      <variablelist>
+        <varlistentry>
+          <term><option>--startvm=<replaceable>uuid</replaceable> | <replaceable>vmname</replaceable></option></term>
+          <listitem><para>
+              Specifies the Universally Unique Identifier (UUID) or name
+              of the VM to start.
+            </para><para>
+              Use the <command>VBoxManage list vms</command> command to
+              obtain VM information.
+            </para><para>
+              The short versions of this option are <option>-s</option>
+              and <option>-startvm</option>.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--vrde=on | off | config</option></term>
+          <listitem><para>
+              Specifies how to use the VRDP server. The default value is
+              <literal>config</literal>. Valid values are as follows:
+            </para><itemizedlist>
+              <listitem><para>
+                  <literal>on</literal> enables the VRDP server.
+                </para><screen>VBoxHeadless --startvm=<replaceable>vmname</replaceable> --vrde=on</screen></listitem>
+              <listitem><para>
+                  <literal>off</literal> disables the VRDP server.
+                </para><screen>VBoxHeadless --startvm=<replaceable>vmname</replaceable> --vrde=off</screen></listitem>
+              <listitem><para>
+                  <literal>config</literal> enables the VRDP server
+                  depending on the VM configuration.
+                </para><screen>VBoxHeadless --startvm=<replaceable>vmname</replaceable> --vrde=config</screen></listitem>
+            </itemizedlist><para>
+              The short version of this option is <option>-v</option>.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--vrdeproperty=<replaceable>prop-name</replaceable>=<replaceable>prop-value</replaceable></option></term>
+          <listitem><para>
+              Specifies a value for one of the following properties:
+            </para><itemizedlist>
+              <listitem><para>
+                  The <literal>TCP/Ports</literal> property value is a
+                  comma-separated list of ports to which the VRDE server
+                  can bind. Use a hyphen (<literal>-</literal>) between
+                  two port numbers to specify a range of ports.
+                </para></listitem>
+              <listitem><para>
+                  The <literal>TCP/Address</literal> property value is
+                  the interface IP address to which to bind the VRDE
+                  server.
+                </para></listitem>
+            </itemizedlist></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--settingspw=[<replaceable>password</replaceable>]</option></term>
+          <listitem><para>
+              Specifies a settings password to access encrypted
+              settings. If you do not specify the password on the
+              command line, <command>VBoxHeadless</command> prompts you
+              for the password.
+            </para><remark>
+              This design does not conform to Oracle's security
+              guidelines. You should not be able to specify a password
+              on the command line because the password can be seen in a
+              process listing.
+            </remark></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--settingspwfile=<replaceable>password-file</replaceable></option></term>
+          <listitem><para>
+              Specifies the file that contains the settings password.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--start-paused=<replaceable>vmname</replaceable></option></term>
+          <listitem><para>
+              Starts the specified VM in the paused state.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--capture</option></term>
+          <listitem><para>
+              Records the VM screen output to a file. In addition to
+              this option, you must use the <option>--filename</option>
+              option to specify the name of the file.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--width=<replaceable>width</replaceable></option></term>
+          <listitem><para>
+              Specifies the frame width of the recording in pixels. This
+              option is associated with the <option>--capture</option>
+              option.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--height=<replaceable>height</replaceable></option></term>
+          <listitem><para>
+              Specifies the frame height of the recording in pixels.
+              This option is associated with the
+              <option>--capture</option> option.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--bitrate=<replaceable>bit-rate</replaceable></option></term>
+          <listitem><para>
+              Specifies the bit rate of the recording in kilobits per
+              second. This option is associated with the
+              <option>--capture</option> option.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--filename=<replaceable>filename</replaceable></option></term>
+          <listitem><para>
+              Specifies the name of the file in which to store the
+              recording. The codec used is based on the file extension
+              that you choose. You must specify this option if you use
+              the <option>--capture</option> option.
+            </para><remark>
+              Where can we get information about the file extensions
+              that are supported?
+            </remark></listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+  </refsect1>
+
+  <refsect1>
+    <title>Examples</title>
+    <remark role="help-scope" condition="GLOBAL"/>
+    <para>
+      The following command starts the <literal>ol7u4</literal> VM:
+    </para>
+<screen>$ VBoxHeadless --startvm "ol7u4"</screen>
+    <para>
+      The following command starts the <literal>ol7u6</literal> VM in
+      the Paused state.
+    </para>
+<screen>$ VBoxHeadless --startvm "ol7u6" --start-paused</screen>
+    <para>
+      The following command starts the <literal>ol7u6</literal> VM and
+      records the session. The recording is saved to the
+      <filename>ol7u6-recording</filename> WebM file.
+    </para>
+<screen>$ VBoxHeadless --startvm "ol7u6" --capture --filename ol7u6-recording.webm</screen>
+  </refsect1>
+
+  <refsect1>
+    <title>See Also</title>
+    <para>
+      <xref linkend="vboxmanage-list" />,
+      <xref linkend="vboxmanage-startvm" />
+    </para>
+  </refsect1>
+</refentry>
Index: trunk/doc/manual/en_US/man_VBoxManage-adoptstate.xml
===================================================================
--- trunk/doc/manual/en_US/man_VBoxManage-adoptstate.xml	(revision 82044)
+++ trunk/doc/manual/en_US/man_VBoxManage-adoptstate.xml	(revision 82044)
@@ -0,0 +1,99 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+    manpage, user manual, usage: VBoxManage adoptstate
+
+    Copyright (C) 2006-2019 Oracle Corporation
+
+    This file is part of VirtualBox Open Source Edition (OSE), as
+    available from http://www.virtualbox.org. This file is free software;
+    you can redistribute it and/or modify it under the terms of the GNU
+    General Public License (GPL) as published by the Free Software
+    Foundation, in version 2 as it comes in the "COPYING" file of the
+    VirtualBox OSE distribution. VirtualBox OSE is distributed in the
+    hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
+ -->
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+  "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"[
+<!ENTITY % all.entities SYSTEM "all-entities.ent">
+%all.entities;
+]>
+<refentry id="vboxmanage-adoptstate" lang="en">
+  <refentryinfo>
+    <pubdate>August 2019</pubdate>
+    <title>VBoxManage adoptstate</title>
+  </refentryinfo>
+
+  <refmeta>
+    <refentrytitle>VBoxManage-adoptstate</refentrytitle>
+    <manvolnum>1</manvolnum>
+  </refmeta>
+
+  <refnamediv>
+    <refname>VBoxManage-adoptstate</refname>
+    <refpurpose>change a virtual machine's state based on a saved state file</refpurpose>
+    <refclass>Oracle VM VirtualBox</refclass>
+  </refnamediv>
+
+  <refsynopsisdiv>
+    <cmdsynopsis id="synopsis-vboxmanage-adoptstate">
+<!-- The 'id' is mandatory and must start with 'synopsis-'. -->
+      <command>VBoxManage adoptstate</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg choice="req"><replaceable>state-filename</replaceable></arg>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+
+  <refsect1>
+    <title>Description</title>
+    <para>
+      The <command>VBoxManage adoptstate</command> command enables you
+      to change the state of a virtual machine (VM) to a state described
+      in a saved state file (<filename>.sav</filename>). This action is
+      referred to as a VM <emphasis>adopting</emphasis> a saved state
+      file. The saved state file must be separate from the VM
+      configuration.
+    </para>
+    <para>
+      When you start the VM after adopting the saved state, the VM
+      restores its state from the saved state file.
+    </para>
+    <para>
+      Only use this command for custom deployments.
+    </para>
+    <variablelist>
+      <varlistentry>
+        <term><replaceable>uuid</replaceable> | <replaceable>vmname</replaceable></term>
+        <listitem><para>
+            Specifies the Universally Unique Identifier (UUID) or name
+            of the VM.
+          </para></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><replaceable>state-filename</replaceable></term>
+        <listitem><para>
+            Specifies the name of the saved state file.
+          </para></listitem>
+      </varlistentry>
+    </variablelist>
+  </refsect1>
+
+  <refsect1>
+    <title>Examples</title>
+    <remark role="help-scope" condition="GLOBAL" />
+    <para>
+      The following command starts a VM called <literal>vm2</literal>
+      using a saved state file called <filename>mystate.sav</filename>.
+    </para>
+<screen>$ VBoxManage adoptstate vm2 /home/user/mystate.sav</screen>
+  </refsect1>
+
+  <refsect1>
+    <title>See Also</title>
+    <para>
+      <xref linkend="vboxmanage-discardstate"/>
+    </para>
+  </refsect1>
+</refentry>
Index: trunk/doc/manual/en_US/man_VBoxManage-bandwidthctl.xml
===================================================================
--- trunk/doc/manual/en_US/man_VBoxManage-bandwidthctl.xml	(revision 82044)
+++ trunk/doc/manual/en_US/man_VBoxManage-bandwidthctl.xml	(revision 82044)
@@ -0,0 +1,296 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+         manpage, user manual, usage: VBoxManage bandwidthctl
+
+    Copyright (C) 2006-2019 Oracle Corporation
+
+    This file is part of VirtualBox Open Source Edition (OSE), as
+    available from http://www.virtualbox.org. This file is free software;
+    you can redistribute it and/or modify it under the terms of the GNU
+    General Public License (GPL) as published by the Free Software
+    Foundation, in version 2 as it comes in the "COPYING" file of the
+    VirtualBox OSE distribution. VirtualBox OSE is distributed in the
+    hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
+ -->
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+  "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"[
+<!ENTITY % all.entities SYSTEM "all-entities.ent">
+%all.entities;
+]>
+<refentry id="vboxmanage-bandwidthctl" lang="en">
+  <refentryinfo>
+    <pubdate>September 2019</pubdate>
+    <title>VBoxManage bandwidthctl</title>
+  </refentryinfo>
+
+  <refmeta>
+    <refentrytitle>VBoxManage-bandwidthctl</refentrytitle>
+    <manvolnum>1</manvolnum>
+  </refmeta>
+
+  <refnamediv>
+    <refname>VBoxManage-bandwidthctl</refname>
+    <refpurpose>manage bandwidth groups</refpurpose>
+    <refclass>Oracle VM VirtualBox</refclass>
+  </refnamediv>
+
+  <refsynopsisdiv>
+    <cmdsynopsis id="synopsis-vboxmanage-bandwidthctl-add">
+<!-- The 'id' is mandatory and must start with 'synopsis-'. -->
+      <command>VBoxManage bandwidthctl</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg choice="plain">add</arg>
+      <arg choice="req"><replaceable>bandwidth-group-name</replaceable></arg>
+      <arg choice="req">--limit=<replaceable>bandwidth-limit</replaceable>[k|m|g|K|M|G]</arg>
+      <arg choice="req">--type=disk|network</arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-bandwidthctl-list">
+      <command>VBoxManage bandwidthctl</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg choice="plain">list</arg>
+      <arg>--machinereadable</arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-bandwidthctl-remove">
+      <command>VBoxManage bandwidthctl</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg choice="plain">remove</arg>
+      <arg choice="req"><replaceable>bandwidth-group-name</replaceable></arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-bandwidthctl-set">
+      <command>VBoxManage bandwidthctl</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg choice="plain">set</arg>
+      <arg choice="req"><replaceable>bandwidth-group-name</replaceable></arg>
+      <arg choice="req">--limit=<replaceable>bandwidth-limit</replaceable>[k|m|g|K|M|G]</arg>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+
+  <refsect1>
+    <title>Description</title>
+    <para>
+      The <command>VBoxManage bandwidthctl</command> command enables you
+      to manage bandwidth groups for virtual machines (VMs). A bandwidth
+      group specifies the bandwidth limit for the disks or for the
+      network adapters of a VM.
+    </para>
+    <para>
+      Note that a network bandwidth limit applies only to the outbound
+      traffic from the VM. The inbound traffic is unlimited.
+    </para>
+    <refsect2 id="vboxmanage-bandwidthctl-add">
+      <title>Create a Bandwidth Group</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage bandwidthctl add</command> command
+        creates a bandwidth group for the specified VM. You must specify
+        whether the bandwidth group is for disks or for networks, and
+        specify the bandwidth limit.
+      </para>
+      <variablelist>
+        <varlistentry>
+          <term><replaceable>uuid</replaceable> | <replaceable>vmname</replaceable></term>
+          <listitem><para>
+              Specifies the Universally Unique Identifier (UUID) or the
+              name of the VM.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option><replaceable>bandwidth-group-name</replaceable></option></term>
+          <listitem><para>
+              Specifies the name of the bandwidth group.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--type=disk|network</option></term>
+          <listitem><para>
+              Specifies the type of the bandwidth group:
+              <literal>disk</literal> and <literal>network</literal>.
+              For more information, see
+              <xref linkend="storage-bandwidth-limit" /> or
+              <xref linkend="network_bandwidth_limit" />.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--limit=<replaceable>bandwidth-limit</replaceable>[k|m|g|K|M|G]</option></term>
+          <listitem><para>
+              Specifies the bandwidth limit for a bandwidth group. The
+              default unit is megabytes per second. You can modify this
+              value while the VM is running.
+            </para><para>
+              You can change the unit by appending one of the following
+              unit specifiers to the bandwidth limit:
+            </para><itemizedlist>
+              <listitem><para>
+                  <literal>k</literal> &ndash; kilobits per second
+                </para></listitem>
+              <listitem><para>
+                  <literal>m</literal> &ndash; megabits per second
+                </para></listitem>
+              <listitem><para>
+                  <literal>g</literal> &ndash; gigabits per second
+                </para></listitem>
+              <listitem><para>
+                  <literal>K</literal> &ndash; kilobytes per second
+                </para></listitem>
+              <listitem><para>
+                  <literal>M</literal> &ndash; megabytes per second
+                </para></listitem>
+              <listitem><para>
+                  <literal>G</literal> &ndash; gigabytes per second
+                </para></listitem>
+            </itemizedlist></listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+    <refsect2 id="vboxmanage-bandwidthctl-list">
+      <title>List Bandwidth Groups</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage bandwidthctl list</command> command
+        lists the all the bandwidth groups that have been defined for
+        the specified VM. Use the <option>--machinereadable</option>
+        option to produce the output in a machine-readable format, which
+        uses name-value pairs.
+      </para>
+      <variablelist>
+        <varlistentry>
+          <term><replaceable>uuid</replaceable> | <replaceable>vmname</replaceable></term>
+          <listitem><para>
+              Specifies the UUID or the name of the VM.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--machinereadable</option></term>
+          <listitem><para>
+              Outputs the information about the bandwidth groups in
+              name-value pairs.
+            </para></listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+    <refsect2 id="vboxmanage-bandwidthctl-remove">
+      <title>Remove a Bandwidth Group</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage bandwidthctl remove</command> command
+        removes a bandwidth group.
+      </para>
+      <note>
+        <para>
+          To successfully remove a bandwidth group, ensure that it is
+          not referenced by any disk or adapter in the running VM.
+        </para>
+      </note>
+      <variablelist>
+        <varlistentry>
+          <term><replaceable>uuid</replaceable> | <replaceable>vmname</replaceable></term>
+          <listitem><para>
+              Specifies the UUID or the name of the VM.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option><replaceable>bandwidth-group-name</replaceable></option></term>
+          <listitem><para>
+              Specifies the name of the bandwidth group.
+            </para></listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+    <refsect2 id="vboxmanage-bandwidthctl-set">
+      <title>Modify the Bandwidth Limit of a Bandwidth Group</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage bandwidthctl set</command> command
+        modifies the bandwidth limit for a bandwidth group.
+      </para>
+      <variablelist>
+        <varlistentry>
+          <term><replaceable>uuid</replaceable> | <replaceable>vmname</replaceable></term>
+          <listitem><para>
+              Specifies the UUID or the name of the VM.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option><replaceable>bandwidth-group-name</replaceable></option></term>
+          <listitem><para>
+              Specifies the name of the bandwidth group.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--limit=<replaceable>bandwidth-limit</replaceable>[k|m|g|K|M|G]</option></term>
+          <listitem><para>
+              Specifies the bandwidth limit for a bandwidth group. The
+              default unit is megabytes per second. You can modify this
+              value while the VM is running.
+            </para><para>
+              You can change the unit by appending one of the following
+              unit specifiers to the bandwidth limit:
+            </para><itemizedlist>
+              <listitem><para>
+                  <literal>k</literal> &ndash; kilobits per second
+                </para></listitem>
+              <listitem><para>
+                  <literal>m</literal> &ndash; megabits per second
+                </para></listitem>
+              <listitem><para>
+                  <literal>g</literal> &ndash; gigabits per second
+                </para></listitem>
+              <listitem><para>
+                  <literal>K</literal> &ndash; kilobytes per second
+                </para></listitem>
+              <listitem><para>
+                  <literal>M</literal> &ndash; megabytes per second
+                </para></listitem>
+              <listitem><para>
+                  <literal>G</literal> &ndash; gigabytes per second
+                </para></listitem>
+            </itemizedlist></listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+  </refsect1>
+
+  <refsect1>
+    <title>Examples</title>
+    <remark role="help-scope" condition="GLOBAL"/>
+    <para>
+      The following example shows how to use the <command>VBoxManage
+      bandwidthctl</command> command to create the
+      <literal>Literal</literal> bandwidth group and set the limit to 20
+      Mbps. Then use the <command>VBoxManage modifyvm</command> command
+      to assign this bandwidth group to the first and second adapters of
+      the <literal>vm1</literal> VM.
+    </para>
+<screen>$ VBoxManage bandwidthctl "vm1" add Limit --type network --limit 20m
+$ VBoxManage modifyvm "vm1" --nicbandwidthgroup1 Limit
+$ VBoxManage modifyvm "vm1" --nicbandwidthgroup2 Limit</screen>
+    <para>
+      You can dynamically modify the limit of a bandwidth group while
+      the VM is running. The following example shows how to modify the
+      limit for the <literal>Limit</literal> bandwidth group from 20
+      Mbps to 100 kbps:
+    </para>
+<screen>$ VBoxManage bandwidthctl "vm1" set Limit --limit 100k</screen>
+    <para>
+      The following command disables shaping for all adapters in the
+      <literal>Limit</literal> bandwidth group by specifying a limit of
+      zero (<literal>0</literal>):
+    </para>
+<screen>$ VBoxManage bandwidthctl "vm1" set Limit --limit 0</screen>
+  </refsect1>
+</refentry>
Index: trunk/doc/manual/en_US/man_VBoxManage-checkmediumpwd.xml
===================================================================
--- trunk/doc/manual/en_US/man_VBoxManage-checkmediumpwd.xml	(revision 82044)
+++ trunk/doc/manual/en_US/man_VBoxManage-checkmediumpwd.xml	(revision 82044)
@@ -0,0 +1,102 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+         manpage, user manual, usage: VBoxManage checkmediumpwd
+
+    Copyright (C) 2006-2019 Oracle Corporation
+
+    This file is part of VirtualBox Open Source Edition (OSE), as
+    available from http://www.virtualbox.org. This file is free software;
+    you can redistribute it and/or modify it under the terms of the GNU
+    General Public License (GPL) as published by the Free Software
+    Foundation, in version 2 as it comes in the "COPYING" file of the
+    VirtualBox OSE distribution. VirtualBox OSE is distributed in the
+    hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
+ -->
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+  "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"[
+<!ENTITY % all.entities SYSTEM "all-entities.ent">
+%all.entities;
+]>
+<refentry id="vboxmanage-checkmediumpwd" lang="en">
+  <refentryinfo>
+    <pubdate>August 2019</pubdate>
+    <title>VBoxManage checkmediumpwd</title>
+  </refentryinfo>
+
+  <refmeta>
+    <refentrytitle>VBoxManage-checkmediumpwd</refentrytitle>
+    <manvolnum>1</manvolnum>
+  </refmeta>
+
+  <refnamediv>
+    <refname>VBoxManage-checkmediumpwd</refname>
+    <refpurpose>check encryption password on a DEK-encrypted medium or a disk image</refpurpose>
+    <refclass>Oracle VM VirtualBox</refclass>
+  </refnamediv>
+
+  <refsynopsisdiv>
+    <cmdsynopsis id="synopsis-vboxmanage-checkmediumpwd">
+<!-- The 'id' is mandatory and must start with 'synopsis-'. -->
+      <command>VBoxManage checkmediumpwd</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>filename</replaceable></arg>
+      </group>
+      <arg choice="req"><replaceable>password-file</replaceable></arg>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+
+  <refsect1>
+    <title>Description</title>
+    <para>
+      The <command>VBoxManage checkmediumpwd</command> command checks
+      the current encryption password on a DEK-encrypted medium or a
+      disk image. See <xref linkend="diskencryption-encryption" />.
+    </para>
+    <para>
+      The command response indicates if the specified password is
+      correct.
+    </para>
+    <variablelist>
+      <varlistentry>
+        <term><replaceable>uuid</replaceable>|<replaceable>filename</replaceable></term>
+        <listitem><para>
+            Specifies the Universally Unique Identifier (UUID) or the
+            absolute path name of the medium or image.
+          </para></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><replaceable>password-file</replaceable></term>
+        <listitem><para>
+            Specifies the password identifier to check. The password
+            identifier can be the absolute path name of a password file
+            on the host OS or the dash character (<literal>-</literal>)
+            to prompt you for the password on the command line.
+          </para></listitem>
+      </varlistentry>
+    </variablelist>
+  </refsect1>
+
+  <refsect1>
+    <title>Examples</title>
+    <remark role="help-scope" condition="GLOBAL" />
+    <para>
+      The following example checks the encryption password for the
+      <filename>ol7u4-1.vdi</filename> disk image. The password
+      identifier is a file called <filename>pwfile</filename>.
+    </para>
+    <para>
+      The command returns a message indicating that the specified
+      password is correct.
+    </para>
+<screen>$ VBoxManage checkmediumpwd "$HOME/VirtualBox VMs/ol7u4/ol7u4-1.vdi" /home/user/pwfile
+  The given password is correct</screen>
+  </refsect1>
+
+  <refsect1>
+    <title>See Also</title>
+    <para>
+      <xref linkend="vboxmanage-encryptmedium" />
+    </para>
+  </refsect1>
+</refentry>
Index: trunk/doc/manual/en_US/man_VBoxManage-clonemedium.xml
===================================================================
--- trunk/doc/manual/en_US/man_VBoxManage-clonemedium.xml	(revision 82044)
+++ trunk/doc/manual/en_US/man_VBoxManage-clonemedium.xml	(revision 82044)
@@ -0,0 +1,203 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+    manpage, user manual, usage: VBoxManage clonemedium
+
+    Copyright (C) 2006-2019 Oracle Corporation
+
+    This file is part of VirtualBox Open Source Edition (OSE), as
+    available from http://www.virtualbox.org. This file is free software;
+    you can redistribute it and/or modify it under the terms of the GNU
+    General Public License (GPL) as published by the Free Software
+    Foundation, in version 2 as it comes in the "COPYING" file of the
+    VirtualBox OSE distribution. VirtualBox OSE is distributed in the
+    hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
+ -->
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+  "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"[
+<!ENTITY % all.entities SYSTEM "all-entities.ent">
+%all.entities;
+]>
+<refentry id="vboxmanage-clonemedium" lang="en">
+  <refentryinfo>
+    <pubdate>August 2019</pubdate>
+    <title>VBoxManage clonemedium</title>
+  </refentryinfo>
+
+  <refmeta>
+    <refentrytitle>VBoxManage-clonemedium</refentrytitle>
+    <manvolnum>1</manvolnum>
+  </refmeta>
+
+  <refnamediv>
+    <refname>VBoxManage-clonemedium</refname>
+    <refpurpose>create a clone of a medium</refpurpose>
+    <refclass>Oracle VM VirtualBox</refclass>
+  </refnamediv>
+
+  <refsynopsisdiv>
+    <cmdsynopsis id="synopsis-vboxmanage-clonemedium">
+<!-- The 'id' is mandatory and must start with 'synopsis-'. -->
+      <command>VBoxManage clonemedium</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>source-medium</replaceable></arg>
+      </group>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>target-medium</replaceable></arg>
+      </group>
+      <group>
+        <arg choice="plain">disk</arg>
+        <arg choice="plain">dvd</arg>
+        <arg choice="plain">floppy</arg>
+      </group>
+      <arg>--existing</arg>
+      <arg>--format=<group choice="plain">
+          <arg choice="plain">VDI</arg>
+          <arg choice="plain">VMDK</arg>
+          <arg choice="plain">VHD</arg>
+          <arg choice="plain">RAW</arg>
+          <arg choice="plain"><replaceable>other</replaceable></arg>
+        </group></arg>
+      <arg>--variant=Standard,Fixed,Split2G,Stream,ESX</arg>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+
+  <refsect1>
+    <title>Description</title>
+    <para>
+      The <command>VBoxManage clonemedium</command> command enables you
+      to clone an existing medium (virtual disk, DVD, or floppy), which
+      is typically an image file. Only the Universally Unique Identifier
+      (UUID) differs between the original image and the cloned image.
+    </para>
+    <para>
+      You can use the Virtual Media Manager to transfer the cloned image
+      to another host system or reimport it into &product-name;. See
+      <xref linkend="vdis" /> and <xref linkend="cloningvdis" />.
+    </para>
+    <variablelist>
+      <varlistentry>
+        <term><replaceable>uuid</replaceable> | <replaceable>source-medium</replaceable></term>
+        <listitem><para>
+            Specifies the UUID or the absolute or relative file name of
+            the source medium to clone. You can specify the UUID of the
+            medium only if it is registered. Use the <command>VBoxManage
+            list hdds</command> command to list registered images.
+          </para></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><replaceable>uuid</replaceable> | <replaceable>target-medium</replaceable></term>
+        <listitem><para>
+            Specifies the UUID or the absolute or relative file name of
+            the target (clone) medium. You can specify the UUID of the
+            target medium only if it is registered. Use the
+            <command>VBoxManage list hdds</command> command to list
+            registered images.
+          </para></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><literal>disk</literal> | <literal>dvd</literal> | <literal>floppy</literal></term>
+        <listitem><para>
+            Specifies the type of the medium to clone. Valid values are
+            <literal>disk</literal>, <literal>dvd</literal>, and
+            <literal>floppy</literal>. The default value is
+            <literal>disk</literal>.
+          </para></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--existing</option></term>
+        <listitem><para>
+            Performs the clone operation by overwriting an existing
+            target medium. The result is that only the portion of the
+            source medium that fits into the existing target medium is
+            copied.
+          </para><para>
+            If the target medium is smaller than the source, only the
+            portion of the source medium up to the size of the target
+            medium is copied.
+          </para><para>
+            If the target medium is larger than the source, the
+            remaining part of the target medium is unchanged.
+          </para></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--format</option></term>
+        <listitem><para>
+            Specifies the file format of the target medium if it differs
+            from the format of the source medium. Valid values are
+            <literal>VDI</literal>, <literal>VMDK</literal>,
+            <literal>VHD</literal>, <literal>RAW</literal>, and
+            <replaceable>other</replaceable>.
+          </para><remark>
+            What file formats can <replaceable>other</replaceable> be?
+          </remark></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--variant=Standard,Fixed,Split2G,Stream,ESX</option></term>
+        <listitem><para>
+            Specifies the file format variant for the target medium,
+            which is a comma-separated list of variants. Following are
+            the valid values:
+          </para><itemizedlist>
+            <listitem><para>
+                <literal>Standard</literal> is the default disk image
+                type, which has a dynamically allocated file size.
+              </para></listitem>
+            <listitem><para>
+                <literal>Fixed</literal> uses a disk image that has a
+                fixed file size.
+              </para></listitem>
+            <listitem><para>
+                <literal>Split2G</literal> indicates that the disk image
+                is split into 2GB segments. This value is for VMDK only.
+              </para></listitem>
+            <listitem><para>
+                <literal>Stream</literal> optimizes the disk image for
+                downloading. This value is for VMDK only.
+              </para></listitem>
+            <listitem><para>
+                <literal>ESX</literal> is used for some VMWare products.
+                This value is for VMDK only.
+              </para></listitem>
+          </itemizedlist><para>
+            Note that not all variant combinations are valid. Specifying
+            incompatible variant values in the list will produce an
+            error message.
+          </para></listitem>
+      </varlistentry>
+    </variablelist>
+    <note>
+      <para>
+        For compatibility with earlier versions of &product-name;, you
+        can use the <command>clonevdi</command> and
+        <command>clonehd</command> commands instead of the
+        <command>clonemedium</command> command.
+      </para>
+    </note>
+  </refsect1>
+
+  <refsect1>
+    <title>Examples</title>
+    <remark role="help-scope" condition="GLOBAL" />
+    <para>
+      The following command creates a clone of the
+      <filename>disk01.vdi</filename> disk image file. The clone is
+      called <filename>disk02.vdi</filename>.
+    </para>
+<screen>$ VBoxManage clonemedium disk01.vdi disk02.vdi</screen>
+    <para>
+      The following command creates a clone of the
+      <filename>disk01.vdi</filename> disk image file. The clone is in
+      VMDK format and is called <filename>disk02.vmdk</filename>.
+    </para>
+<screen>$ VBoxManage clonemedium disk01.vdi disk02.vmdk --format VMDK</screen>
+  </refsect1>
+
+  <refsect1>
+    <title>See Also</title>
+    <para>
+      <xref linkend="vboxmanage-list" />
+    </para>
+  </refsect1>
+</refentry>
Index: trunk/doc/manual/en_US/man_VBoxManage-closemedium.xml
===================================================================
--- trunk/doc/manual/en_US/man_VBoxManage-closemedium.xml	(revision 82044)
+++ trunk/doc/manual/en_US/man_VBoxManage-closemedium.xml	(revision 82044)
@@ -0,0 +1,108 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+         manpage, user manual, usage: VBoxManage closemedium
+
+    Copyright (C) 2006-2019 Oracle Corporation
+
+    This file is part of VirtualBox Open Source Edition (OSE), as
+    available from http://www.virtualbox.org. This file is free software;
+    you can redistribute it and/or modify it under the terms of the GNU
+    General Public License (GPL) as published by the Free Software
+    Foundation, in version 2 as it comes in the "COPYING" file of the
+    VirtualBox OSE distribution. VirtualBox OSE is distributed in the
+    hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
+ -->
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+  "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"[
+<!ENTITY % all.entities SYSTEM "all-entities.ent">
+%all.entities;
+]>
+<refentry id="vboxmanage-closemedium" lang="en">
+  <refentryinfo>
+    <pubdate>August 2019</pubdate>
+    <title>VBoxManage closemedium</title>
+  </refentryinfo>
+
+  <refmeta>
+    <refentrytitle>VBoxManage-closemedium</refentrytitle>
+    <manvolnum>1</manvolnum>
+  </refmeta>
+
+  <refnamediv>
+    <refname>VBoxManage-closemedium</refname>
+    <refpurpose>remove a hard disk, DVD, or floppy image from the media registry</refpurpose>
+    <refclass>Oracle VM VirtualBox</refclass>
+  </refnamediv>
+
+  <refsynopsisdiv>
+    <cmdsynopsis id="synopsis-vboxmanage-closemedium">
+<!-- The 'id' is mandatory and must start with 'synopsis-'. -->
+      <command>VBoxManage closemedium</command>
+      <group>
+        <arg choice="plain">disk</arg>
+        <arg choice="plain">dvd</arg>
+        <arg choice="plain">floppy</arg>
+      </group>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>filename</replaceable></arg>
+      </group>
+      <arg>--delete</arg>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+
+  <refsect1>
+    <title>Description</title>
+    <para>
+      The <command>VBoxManage closemedium</command> command removes a
+      hard disk, DVD, or floppy image from the list of known media used
+      by &product-name;. The image is then unavailable for selection in
+      the Virtual Media Manager.
+    </para>
+    <para>
+      To use this command, the image must not be attached to any VMs.
+    </para>
+    <para>
+      Optionally, you can request that the image be deleted.
+    </para>
+    <variablelist>
+      <varlistentry>
+        <term>disk|dvd|floppy</term>
+        <listitem><para>
+            Specifies the type of medium. Valid values are
+            <literal>disk</literal> (hard drive),
+            <literal>dvd</literal>, or <literal>floppy</literal>.
+          </para></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><replaceable>uuid</replaceable>|<replaceable>filename</replaceable></term>
+        <listitem><para>
+            Specifies the Universally Unique Identifier (UUID) or
+            absolute path name of the medium or image.
+          </para></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--delete</option></term>
+        <listitem><para>
+            Deletes the image file.
+          </para></listitem>
+      </varlistentry>
+    </variablelist>
+  </refsect1>
+
+  <refsect1>
+    <title>Examples</title>
+    <remark role="help-scope" condition="GLOBAL" />
+    <para>
+      The following command removes the disk image file called
+      <filename>disk01.vdi</filename> from the registry.
+    </para>
+<screen>$ VBoxManage closemedium disk01.vdi</screen>
+    <para>
+      The following command removes the disk image file called
+      <filename>disk01.vdi</filename> from the registry and deletes the
+      image file.
+    </para>
+<screen>$ VBoxManage closemedium disk01.vdi --delete</screen>
+  </refsect1>
+</refentry>
Index: trunk/doc/manual/en_US/man_VBoxManage-controlvm.xml
===================================================================
--- trunk/doc/manual/en_US/man_VBoxManage-controlvm.xml	(revision 82044)
+++ trunk/doc/manual/en_US/man_VBoxManage-controlvm.xml	(revision 82044)
@@ -0,0 +1,2081 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+         manpage, user manual, usage: VBoxManage controlvm
+
+    Copyright (C) 2006-2019 Oracle Corporation
+
+    This file is part of VirtualBox Open Source Edition (OSE), as
+    available from http://www.virtualbox.org. This file is free software;
+    you can redistribute it and/or modify it under the terms of the GNU
+    General Public License (GPL) as published by the Free Software
+    Foundation, in version 2 as it comes in the "COPYING" file of the
+    VirtualBox OSE distribution. VirtualBox OSE is distributed in the
+    hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
+ -->
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+  "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"[
+<!ENTITY % all.entities SYSTEM "all-entities.ent">
+%all.entities;
+]>
+<refentry id="vboxmanage-controlvm" lang="en">
+  <refentryinfo>
+    <pubdate>September 2019</pubdate>
+    <title>VBoxManage controlvm</title>
+  </refentryinfo>
+
+  <refmeta>
+    <refentrytitle>VBoxManage-controlvm</refentrytitle>
+    <manvolnum>1</manvolnum>
+  </refmeta>
+
+  <refnamediv>
+    <refname>VBoxManage-controlvm</refname>
+    <refpurpose>change state and settings for a running virtual machine</refpurpose>
+    <refclass>Oracle VM VirtualBox</refclass>
+  </refnamediv>
+
+  <refsynopsisdiv>
+    <cmdsynopsis id="synopsis-vboxmanage-controlvm-pause">
+<!-- The 'id' is mandatory and must start with 'synopsis-'. -->
+      <command>VBoxManage controlvm</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg choice="plain">pause</arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-controlvm-resume">
+      <command>VBoxManage controlvm</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg choice="plain">resume</arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-controlvm-reset">
+      <command>VBoxManage controlvm</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg choice="plain">reset</arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-controlvm-poweroff">
+      <command>VBoxManage controlvm</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg choice="plain">poweroff</arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-controlvm-savestate">
+      <command>VBoxManage controlvm</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg choice="plain">savestate</arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-controlvm-acpipowerbutton">
+      <command>VBoxManage controlvm</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg choice="plain">acpipowerbutton</arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-controlvm-acpisleepbutton">
+      <command>VBoxManage controlvm</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg choice="plain">acpisleepbutton</arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-controlvm-keyboardputscancode">
+      <command>VBoxManage controlvm</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg choice="plain">keyboardputscancode</arg>
+      <arg choice="req"><replaceable>hex</replaceable></arg>
+      <arg rep="repeat"><replaceable>hex</replaceable></arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-controlvm-keyboardputstring">
+      <command>VBoxManage controlvm</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg choice="plain">keyboardputstring</arg>
+      <arg choice="req"><replaceable>string</replaceable></arg>
+      <arg rep="repeat"><replaceable>string</replaceable></arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-controlvm-keyboardputfile">
+      <command>VBoxManage controlvm</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg choice="plain">keyboardputfile</arg>
+      <arg choice="req"><replaceable>filename</replaceable></arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-controlvm-setlinkstate">
+      <command>VBoxManage controlvm</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg choice="plain">setlinkstate<replaceable>N</replaceable></arg>
+      <group choice="req">
+        <arg choice="plain">on</arg>
+        <arg choice="plain">off</arg>
+      </group>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-controlvm-nic">
+      <command>VBoxManage controlvm</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg choice="plain">nic<replaceable>N</replaceable></arg>
+      <group choice="req">
+        <arg choice="plain">null</arg>
+        <arg choice="plain">nat</arg>
+        <arg choice="plain">bridged</arg>
+        <arg choice="plain">intnet</arg>
+        <arg choice="plain">hostonly</arg>
+        <arg choice="plain">generic</arg>
+        <arg choice="plain">natnetwork</arg>
+      </group>
+      <arg><replaceable>device-name</replaceable></arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-controlvm-nictrace">
+      <command>VBoxManage controlvm</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg choice="plain">nictrace<replaceable>N</replaceable></arg>
+      <group choice="req">
+        <arg choice="plain">on</arg>
+        <arg choice="plain">off</arg>
+      </group>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-controlvm-nictracefile">
+      <command>VBoxManage controlvm</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg choice="plain">nictracefile<replaceable>N</replaceable></arg>
+      <arg choice="req"><replaceable>filename</replaceable></arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-controlvm-nicproperty">
+      <command>VBoxManage controlvm</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg choice="plain">nicproperty<replaceable>N</replaceable></arg>
+      <arg choice="req"><replaceable>prop-name</replaceable>=<arg><replaceable>prop-value</replaceable></arg></arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-controlvm-nicpromisc">
+      <command>VBoxManage controlvm</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg choice="plain">nicpromisc<replaceable>N</replaceable></arg>
+      <group choice="req">
+        <arg choice="plain">deny</arg>
+        <arg choice="plain">allow-vms</arg>
+        <arg choice="plain">allow-all</arg>
+      </group>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-controlvm-natpf">
+      <command>VBoxManage controlvm</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg choice="plain">natpf<replaceable>N</replaceable></arg>
+      <group choice="req">
+        <arg choice="plain">[<replaceable>rulename</replaceable>]<arg choice="plain">,tcp</arg></arg>
+        <arg choice="plain">udp,<arg><replaceable>host-IP</replaceable></arg>,<arg choice="plain"><replaceable>hostport</replaceable>,</arg><arg><replaceable>guest-IP</replaceable></arg>,<arg choice="plain"><replaceable>guestport</replaceable></arg></arg>
+      </group>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-controlvm-natpf-delete">
+      <command>VBoxManage controlvm</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg choice="plain">natpf<replaceable>N</replaceable> delete</arg>
+       
+      <arg choice="req"><replaceable>rulename</replaceable></arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-controlvm-guestmemoryballoon">
+      <command>VBoxManage controlvm</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg choice="plain">guestmemoryballoon</arg>
+      <arg choice="req"><replaceable>balloon-size</replaceable></arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-controlvm-usbattach">
+      <command>VBoxManage controlvm</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg choice="plain">usbattach</arg>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>address</replaceable></arg>
+      </group>
+      <arg>--capturefile=<replaceable>filename</replaceable></arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-controlvm-usbdetach">
+      <command>VBoxManage controlvm</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg choice="plain">usbdetach</arg>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>address</replaceable></arg>
+      </group>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-controlvm-audioin">
+      <command>VBoxManage controlvm</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg choice="plain">audioin</arg>
+      <group choice="req">
+        <arg choice="plain">on</arg>
+        <arg choice="plain">off</arg>
+      </group>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-controlvm-audioout">
+      <command>VBoxManage controlvm</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg choice="plain">audioout</arg>
+      <group choice="req">
+        <arg choice="plain">on</arg>
+        <arg choice="plain">off</arg>
+      </group>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-controlvm-clipboard">
+      <command>VBoxManage controlvm</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg choice="plain">clipboard</arg>
+      <group choice="req">
+        <arg choice="plain">disabled</arg>
+        <arg choice="plain">hosttoguest</arg>
+        <arg choice="plain">guesttohost</arg>
+        <arg choice="plain">bidirectional</arg>
+      </group>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-controlvm-draganddrop">
+      <command>VBoxManage controlvm</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg choice="plain">draganddrop</arg>
+      <group choice="req">
+        <arg choice="plain">disabled</arg>
+        <arg choice="plain">hosttoguest</arg>
+        <arg choice="plain">guesttohost</arg>
+        <arg choice="plain">bidirectional</arg>
+      </group>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-controlvm-vrde">
+      <command>VBoxManage controlvm</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg choice="plain">vrde</arg>
+      <group choice="req">
+        <arg choice="plain">on</arg>
+        <arg choice="plain">off</arg>
+      </group>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-controlvm-vrdeport">
+      <command>VBoxManage controlvm</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg choice="plain">vrdeport</arg>
+      <arg choice="req"><replaceable>port</replaceable></arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-controlvm-vrdeproperty">
+      <command>VBoxManage controlvm</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg choice="plain">vrdeproperty</arg>
+      <arg choice="req"><replaceable>prop-name</replaceable>=<arg><replaceable>prop-value</replaceable></arg></arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-controlvm-vrdevideochannelquality">
+      <command>VBoxManage controlvm</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg choice="plain">vrdevideochannelquality</arg>
+      <arg choice="req"><replaceable>percentage</replaceable></arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-controlvm-setvideomodehint">
+      <command>VBoxManage controlvm</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg choice="plain">setvideomodehint</arg>
+      <arg choice="req"><replaceable>xres</replaceable></arg>
+      <arg choice="req"><replaceable>yres</replaceable></arg>
+      <arg choice="req"><replaceable>bpp</replaceable></arg>
+      <arg><arg><replaceable>display</replaceable></arg><group>
+          <arg choice="plain">enabled:yes | no</arg>
+          <arg><replaceable>x-origin</replaceable>&nbsp;<replaceable>y-origin</replaceable></arg>
+        </group></arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-controlvm-setscreenlayout">
+      <command>VBoxManage controlvm</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg choice="plain">setscreenlayout</arg>
+      <arg choice="req"><replaceable>display</replaceable></arg>
+      <group choice="req">
+        <arg choice="plain">on</arg>
+        <arg choice="plain">primary <replaceable>x-origin</replaceable>&nbsp;<replaceable>y-origin</replaceable>&nbsp;<replaceable>x-resolution</replaceable>&nbsp;<replaceable>y-resolution</replaceable>&nbsp;<replaceable>bpp</replaceable></arg>
+        <arg choice="plain">off</arg>
+      </group>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-controlvm-screenshotpng">
+      <command>VBoxManage controlvm</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg choice="plain">screenshotpng</arg>
+      <arg choice="req"><replaceable>filename</replaceable></arg>
+      <arg><replaceable>display</replaceable></arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-controlvm-recording">
+      <command>VBoxManage controlvm</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg choice="plain">recording</arg>
+      <group choice="req">
+        <arg choice="plain">on</arg>
+        <arg choice="plain">off</arg>
+      </group>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-controlvm-recordingscreens">
+      <command>VBoxManage controlvm</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg choice="plain">recording screens</arg>
+      <group choice="req">
+        <arg choice="plain">all</arg>
+        <arg choice="plain">none</arg>
+        <arg choice="plain"><replaceable>screen</replaceable>,[<replaceable>screen</replaceable>...]</arg>
+      </group>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-controlvm-recordingfilename">
+      <command>VBoxManage controlvm</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg choice="plain">recording filename</arg>
+      <arg choice="req">filename</arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-controlvm-recordingvideores">
+      <command>VBoxManage controlvm</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg choice="plain">recording videores</arg>
+      <arg choice="req"><replaceable>width</replaceable>x<replaceable>height</replaceable></arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-controlvm-recordingvideorate">
+      <command>VBoxManage controlvm</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg choice="plain">recording videorate</arg>
+      <arg choice="req"><replaceable>rate</replaceable></arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-controlvm-recordingvideofps">
+      <command>VBoxManage controlvm</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg choice="plain">recording videofps</arg>
+      <arg choice="req"><replaceable>fps</replaceable></arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-controlvm-recordingmaxtime">
+      <command>VBoxManage controlvm</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg choice="plain">recording maxtime</arg>    
+      <arg choice="req"><replaceable>sec</replaceable></arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-controlvm-recordingmaxfilesize">
+      <command>VBoxManage controlvm</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg choice="plain">recording maxfilesize</arg>
+      <arg choice="req"><replaceable>MB</replaceable></arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-controlvm-setcredentials">
+      <command>VBoxManage controlvm</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg choice="plain">setcredentials</arg>
+      <arg choice="req"><replaceable>username</replaceable></arg>
+      <arg choice="plain">--passwordfile=<group choice="req">
+          <arg choice="plain"><replaceable>filename</replaceable></arg>
+          <arg choice="plain"><replaceable>password</replaceable></arg>
+        </group></arg>
+      <arg choice="req"><replaceable>domain-name</replaceable></arg>
+      <arg choice="plain">--allowlocallogon=<group choice="req">
+          <arg choice="plain">yes</arg>
+          <arg choice="plain">no</arg>
+        </group></arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-controlvm-teleport">
+      <command>VBoxManage controlvm</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg choice="plain">teleport</arg>
+      <arg choice="req">--host=<replaceable>host-name</replaceable></arg>
+      <arg choice="req">--port=<replaceable>port-name</replaceable></arg>
+      <arg>--maxdowntime=<replaceable>msec</replaceable></arg>
+      <group>
+        <arg choice="plain">--passwordfile=<replaceable>filename</replaceable></arg>
+        <arg choice="plain">--password=<replaceable>password</replaceable></arg>
+      </group>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-controlvm-plugcpu">
+      <command>VBoxManage controlvm</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg choice="plain">plugcpu</arg>
+      <arg choice="req"><replaceable>ID</replaceable></arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-controlvm-unplugcpu">
+      <command>VBoxManage controlvm</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg choice="plain">unplugcpu</arg>
+      <arg choice="req"><replaceable>ID</replaceable></arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-controlvm-cpuexecutioncap">
+      <command>VBoxManage controlvm</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg choice="plain">cpuexecutioncap</arg>
+      <arg choice="req"><replaceable>num</replaceable></arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-controlvm-vmprocesspriority">
+      <command>VBoxManage controlvm</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg choice="plain">vm-process-priority</arg>
+      <group choice="req">
+        <arg choice="plain">default</arg>
+        <arg choice="plain">flat</arg>
+        <arg choice="plain">low</arg>
+        <arg choice="plain">normal</arg>
+        <arg choice="plain">high</arg>
+      </group>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-controlvm-webcam-attach">
+      <command>VBoxManage controlvm</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg choice="plain">webcam attach</arg>
+      <arg><replaceable>pathname</replaceable><arg><replaceable>settings</replaceable></arg></arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-controlvm-webcam-detach">
+      <command>VBoxManage controlvm</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg choice="plain">webcam detach</arg>
+      <arg><replaceable>pathname</replaceable></arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-controlvm-webcam-list">
+      <command>VBoxManage controlvm</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg choice="plain">webcam list</arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-controlvm-addencpassword">
+      <command>VBoxManage controlvm</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg choice="plain">addencpassword</arg>
+      <arg choice="req"><replaceable>ID</replaceable></arg>
+      <group choice="req">
+        <arg choice="plain"><replaceable>password-file</replaceable></arg>
+        <arg choice="plain">-</arg>
+      </group>
+      <arg>--removeonsuspend=<group choice="plain">
+          <arg choice="plain">yes</arg>
+          <arg choice="plain">no</arg>
+        </group></arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-controlvm-removeencpassword">
+      <command>VBoxManage controlvm</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg choice="plain">removeencpassword</arg>
+      <arg choice="req"><replaceable>ID</replaceable></arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-controlvm-removeallencpasswords">
+      <command>VBoxManage controlvm</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg choice="plain">removeallencpasswords</arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-controlvm-changeuartmode">
+      <command>VBoxManage controlvm</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg choice="plain">changeuartmode<replaceable>N</replaceable></arg>
+      <group choice="plain">
+        <arg choice="plain">disconnected</arg>
+        <arg choice="plain">server <replaceable>pipe-name</replaceable></arg>
+        <arg choice="plain">client <replaceable>pipe-name</replaceable></arg>
+        <arg choice="plain">tcpserver <replaceable>port</replaceable></arg>
+        <arg choice="plain">tcpclient <replaceable>hostname</replaceable>:<replaceable>port</replaceable></arg>
+        <arg choice="plain">file <replaceable>filename</replaceable></arg>
+        <arg choice="plain"><replaceable>device-name</replaceable></arg>
+      </group>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+
+  <refsect1>
+    <title>Description</title>
+    <para>
+      The <command>VBoxManage controlvm</command> command enables you to
+      change the state of a running virtual machine (VM). The following
+      sections describe the subcommands that you can use:
+    </para>
+    <refsect2 id="vboxmanage-controlvm-pause">
+      <title>Pause a Virtual Machine</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage controlvm
+        <replaceable>vmname</replaceable> pause</command> command
+        temporarily stops the execution of a VM. When paused, the VM's
+        state is not permanently changed.
+      </para>
+      <para>
+        The VM window appears as gray and the title bar of the window
+        indicates that the VM is currently Paused. This action is
+        equivalent to selecting <emphasis role="bold">Pause</emphasis>
+        from the <emphasis role="bold">Machine</emphasis> menu of the
+        GUI.
+      </para>
+    </refsect2>
+    <refsect2 id="vboxmanage-controlvm-resume">
+      <title>Resume a Paused Virtual Machine</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage controlvm
+        <replaceable>vmname</replaceable> resume</command> command
+        restarts the execution of a paused VM. This action is equivalent
+        to selecting <emphasis role="bold">Resume</emphasis> from the
+        <emphasis role="bold">Machine</emphasis> menu of the GUI.
+      </para>
+    </refsect2>
+    <refsect2 id="vboxmanage-controlvm-reset">
+      <title>Reset a Virtual Machine</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage controlvm
+        <replaceable>vmname</replaceable> reset</command> command
+        performs a cold reset the VM. This command has the same effect
+        on a VM as pressing the Reset button on a physical computer.
+      </para>
+      <para>
+        The cold reboot immediately restarts and reboots the guest
+        operating system (OS). The state of the VM is not saved prior to
+        the reset, so data might be lost. This action is equivalent to
+        selecting <emphasis role="bold">Reset</emphasis> from the
+        <emphasis role="bold">Machine</emphasis> menu of the GUI.
+      </para>
+    </refsect2>
+    <refsect2 id="vboxmanage-controlvm-poweroff">
+      <title>Power Off a Virtual Machine</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage controlvm
+        <replaceable>vmname</replaceable> poweroff</command> command
+        powers off the VM. This command has the same effect on a VM as
+        pulling the power cable on a physical computer.
+      </para>
+      <para>
+        The state of the VM is not saved prior to poweroff, so data
+        might be lost. This action is equivalent to selecting
+        <emphasis role="bold">Close</emphasis> from the
+        <emphasis role="bold">Machine</emphasis> menu of the GUI or to
+        clicking the VM window's Close button, and then selecting
+        <emphasis role="bold">Power Off the Machine</emphasis>.
+      </para>
+      <para>
+        When in the powered off state, you can restart the VM. See
+        <xref linkend="vboxmanage-startvm" />.
+      </para>
+    </refsect2>
+    <refsect2 id="vboxmanage-controlvm-savestate">
+      <title>Save the State of a Virtual Machine</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage controlvm
+        <replaceable>vmname</replaceable> savestate</command> command
+        saves the current state of the VM to disk and then stops the VM.
+      </para>
+      <para>
+        This action is equivalent to selecting
+        <emphasis role="bold">Close</emphasis> from the
+        <emphasis role="bold">Machine</emphasis> menu of the GUI or to
+        clicking the VM window's Close button, and then selecting
+        <emphasis role="bold">Save the Machine State</emphasis>.
+      </para>
+      <para>
+        When in the powered off state, you can restart the VM.
+      </para>
+    </refsect2>
+    <refsect2 id="vboxmanage-controlvm-acpipowerbutton">
+      <title>Send an APCI Shutdown Signal to a Virtual Machine</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage controlvm
+        <replaceable>vmname</replaceable> acpipowerbutton</command>
+        command sends an ACPI shutdown signal to the VM. This command
+        has the same effect on a VM as pressing the Power button on a
+        physical computer.
+      </para>
+      <para>
+        So long as the VM runs a guest OS that provides ACPI support,
+        this command triggers a proper shutdown mechanism from within
+        the VM.
+      </para>
+    </refsect2>
+    <refsect2 id="vboxmanage-controlvm-acpisleepbutton">
+      <title>Send an APCI Sleep Signal to a Virtual Machine</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage controlvm
+        <replaceable>vmname</replaceable> acpisleepbutton</command>
+        command sends an ACPI sleep signal to the VM.
+      </para>
+      <para>
+        So long as the VM runs a guest OS that provides ACPI support,
+        this command triggers a proper sleep mechanism from within the
+        VM.
+      </para>
+    </refsect2>
+    <refsect2 id="vboxmanage-controlvm-keyboardputscancode">
+      <title>Send Keyboard Scancodes to a Virtual Machine</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage controlvm
+        <replaceable>vmname</replaceable> keyboardputscancode</command>
+        command sends keyboard scancode commands to the VM.
+      </para>
+      <para>
+        For information about keyboard scancodes, see
+        <ulink url="http://www.win.tue.nl/~aeb/linux/kbd/scancodes-1.html" />.
+      </para>
+    </refsect2>
+    <refsect2 id="vboxmanage-controlvm-keyboardputstring">
+      <title>Send Keyboard Strings to a Virtual Machine</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage controlvm
+        <replaceable>vmname</replaceable> keyboardputstring</command>
+        command sends keyboard strings to the VM.
+      </para>
+    </refsect2>
+    <refsect2 id="vboxmanage-controlvm-keyboardputfile">
+      <title>Send a File to a Virtual Machine</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage controlvm
+        <replaceable>vmname</replaceable> keyboardputfile</command>
+        command sends a file to the VM.
+      </para>
+    </refsect2>
+    <refsect2 id="vboxmanage-controlvm-teleport">
+      <title>Configure a Virtual Machine Target for Teleporting</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage controlvm
+        <replaceable>vmname</replaceable> teleport</command> command
+        initiates a teleporting operation between the specified VM and
+        the specified host system. See <xref linkend="teleporting" />.
+      </para>
+      <para>
+        If you specify a password, it must match the password you
+        specified when you issued the <command>VBoxManage
+        modifyvm</command> command for the target machine.
+      </para>
+      <variablelist>
+        <varlistentry>
+          <term><option>--host=<replaceable>hostname</replaceable></option></term>
+          <listitem><para>
+              Specifies the name of the VM.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--port=<replaceable>port</replaceable></option></term>
+          <listitem><para>
+              Specifies the port on the VM that should listen for a
+              teleporting request from other VMs. The port number can be
+              any free TCP/IP port number, such as
+              <literal>6000</literal>.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--maxdowntime=<replaceable>msec</replaceable></option></term>
+          <listitem><para>
+              Specifies the maximum downtime, in milliseconds, for the
+              teleporting target VM.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--password=<replaceable>password</replaceable></option></term>
+          <listitem><para>
+              Specifies the password that the source machine uses for
+              the teleporting request. The request succeeds only if the
+              source machine specifies the same password.
+            </para><remark>
+              This design does not conform to Oracle's security
+              guidelines. You should not be able to specify a password
+              on the command line because the password can be seen in a
+              process listing.
+            </remark><para>
+              The <option>--password</option> is mutually exclusive with
+              the <option>--passwordfile</option> option.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--passwordfile=<replaceable>filename</replaceable></option></term>
+          <listitem><para>
+              Specifies the file from which to obtain the password that
+              the source machine uses for the teleporting request. The
+              request succeeds only if the source machine specifies the
+              same password.
+            </para><para>
+              When you specify a file name of <literal>stdin</literal>,
+              you can read the password from standard input.
+            </para><para>
+              The <option>--passwordfile</option> is mutually exclusive
+              with the <option>--password</option> option.
+            </para></listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+    <refsect2 id="vboxmanage-controlvm-setlinkstate">
+      <title>Set the Link State for a Virtual Machine</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        <command>VBoxManage controlvm <replaceable>vmname</replaceable>
+        setlinkstate<replaceable>N</replaceable></command> command
+        enables you to connect or disconnect the virtual network cable
+        from the network interface instance
+        (<replaceable>N</replaceable>). Valid values are
+        <literal>on</literal> and <literal>off</literal>. The default
+        value is <literal>on</literal>.
+      </para>
+      <para>
+        Before connecting the virtual network cable, use the
+        <command>VBoxManage controlvm
+        nictracefile<replaceable>N</replaceable></command> command at
+        runtime to specify the name of the file in which to log the
+        trace. Otherwise, use the <command>VBoxManage modifyvm
+        --nictracefile<replaceable>N</replaceable>=<replaceable>filename</replaceable></command>
+        command to specify the name of the file.
+      </para>
+      <para>
+        This subcommand does not affect the VM's running state directly.
+      </para>
+    </refsect2>
+    <refsect2 id="vboxmanage-controlvm-nic">
+      <title>Set the Type of Networking to Use for a Virtual Machine</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage controlvm
+        <replaceable>vmname</replaceable>
+        nic<replaceable>N</replaceable></command> command specifies the
+        type of networking to use on the specified VM's virtual network
+        card. <replaceable>N</replaceable> numbering begins with
+        <literal>1</literal>.
+      </para>
+      <para>
+        The following valid network types are also described in
+        <xref linkend="networkingmodes" />:
+      </para>
+      <itemizedlist>
+        <listitem><para>
+            <literal>null</literal> specifies that the VM is is not
+            connected to the host system.
+          </para></listitem>
+        <listitem><para>
+            <literal>nat</literal> specifies that the VM uses network
+            address translation (NAT).
+          </para></listitem>
+        <listitem><para>
+            <literal>bridged</literal> specifies that the VM uses
+            bridged networking.
+          </para></listitem>
+        <listitem><para>
+            <literal>intnet</literal> specifies that the VM communicates
+            with other VMs by using internal networking.
+          </para></listitem>
+        <listitem><para>
+            <literal>hostonly</literal> specifies that the VM uses
+            host-only networking.
+          </para></listitem>
+        <listitem><para>
+            <literal>natnetwork</literal> specifies that the VM uses NAT
+            networking.
+          </para></listitem>
+        <listitem><para>
+            <literal>generic</literal> specifies that the VM has access
+            to rarely used submodes
+          </para></listitem>
+      </itemizedlist>
+      <para>
+        This subcommand does not affect the VM's running state directly.
+      </para>
+    </refsect2>
+    <refsect2 id="vboxmanage-controlvm-nictrace">
+      <title>Trace the Network Traffic of a Virtual Machine</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage controlvm
+        <replaceable>vmname</replaceable>
+        nictrace<replaceable>N</replaceable></command> command enables
+        you to trace the network traffic on the specified virtual
+        network card (<replaceable>N</replaceable>).
+        <replaceable>N</replaceable> numbering begins with
+        <literal>1</literal>. Valid values are <literal>on</literal> and
+        <literal>off</literal>. The default value is
+        <literal>off</literal>.
+      </para>
+      <para>
+        When set to <literal>on</literal>, use the same value of
+        <replaceable>N</replaceable> for the <command>VBoxManage
+        controlvm <replaceable>vmname</replaceable>
+        nictracefile<replaceable>N</replaceable></command> command that
+        you use to specify the path name to the log file in which to
+        write trace output.
+      </para>
+      <para>
+        This subcommand does not affect the VM's running state directly.
+      </para>
+    </refsect2>
+    <refsect2 id="vboxmanage-controlvm-nictracefile">
+      <title>Specify the Network Traffic Trace Log File for a Virtual Machine</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage controlvm
+        <replaceable>vmname</replaceable>
+        nictracefile<replaceable>N</replaceable></command> command
+        enables you to specify the name of the network traffic trace log
+        file for the specified virtual network card
+        (<replaceable>N</replaceable>). <replaceable>N</replaceable>
+        numbering begins with <literal>1</literal>. Ensure that you use
+        the same value of <replaceable>N</replaceable> as you used for
+        the <command>VBoxManage controlvm
+        <replaceable>vmname</replaceable>
+        nic<replaceable>N</replaceable></command> and
+        <command>VBoxManage controlvm <replaceable>vmname</replaceable>
+        nictrace<replaceable>N</replaceable></command> commands.
+      </para>
+      <para>
+        This subcommand does not affect the VM's running state directly.
+      </para>
+    </refsect2>
+    <refsect2 id="vboxmanage-controlvm-nicpromisc">
+      <title>Specify the Promiscuous Mode to Use for a Virtual Machine</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage controlvm
+        <replaceable>vmname</replaceable>
+        nicpromisc<replaceable>N</replaceable></command> command enables
+        you to specify how to handle promiscuous mode for a bridged
+        network. The default value of <literal>deny</literal> hides any
+        traffic that is not intended for this VM. The
+        <literal>allow-vms</literal> value hides all host traffic from
+        this VM but enables the VM to see traffic to and from other VMs.
+        The <literal>allow-all</literal> value removes this restriction
+        completely.
+      </para>
+      <para>
+        This subcommand does not affect the VM's running state directly.
+      </para>
+    </refsect2>
+    <refsect2 id="vboxmanage-controlvm-nicproperty">
+      <title>Specify the Network Backend Property Values for a Virtual Machine</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage controlvm
+        <replaceable>vmname</replaceable>
+        nicproperty<replaceable>N</replaceable>
+        <replaceable>prop-name</replaceable>="<replaceable>prop-value</replaceable>"</command>
+        command, in combination with <literal>nicgenericdrv</literal>,
+        enables you to pass property values to rarely-used network
+        backends.
+      </para>
+      <para>
+        Those properties are backend engine-specific, and are different
+        between UDP Tunnel and the VDE backend drivers. See
+        <xref linkend="network_udp_tunnel" />.
+      </para>
+      <para>
+        This subcommand does not affect the VM's running state directly.
+      </para>
+    </refsect2>
+    <refsect2 id="vboxmanage-controlvm-natpf">
+      <title>Specify a NAT Port Forwarding Rule for a Virtual Machine</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage controlvm
+        <replaceable>vmname</replaceable>
+        natpf<replaceable>N</replaceable></command> command specifies a
+        NAT port-forwarding rule. See <xref linkend="natforward"/>.
+      </para>
+      <para>
+        This subcommand does not affect the VM's running state directly.
+      </para>
+    </refsect2>
+    <refsect2 id="vboxmanage-controlvm-natpf-delete">
+      <title>Delete a NAT Port Forwarding Rule for a Virtual Machine</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage controlvm
+        <replaceable>vmname</replaceable>
+        natpf<replaceable>N</replaceable> delete</command> deletes the
+        specified NAT port-forwarding rule. See
+        <xref linkend="natforward"/>.
+      </para>
+      <para>
+        This subcommand does not affect the VM's running state directly.
+      </para>
+    </refsect2>
+    <refsect2 id="vboxmanage-controlvm-guestmemoryballoon">
+      <title>Change Size of a Virtual Machine's Guest Memory Balloon</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage controlvm
+        <replaceable>vmname</replaceable> guestmemoryballoon</command>
+        command changes the size of the guest memory balloon. The guest
+        memory balloon is the memory allocated by the &product-name;
+        Guest Additions from the guest OS and returned to the hypervisor
+        for reuse by other VMs. The value you specify is in megabytes.
+        See <xref linkend="guestadd-balloon" />.
+      </para>
+      <para>
+        This subcommand does not affect the VM's running state directly.
+      </para>
+    </refsect2>
+    <refsect2 id="vboxmanage-controlvm-usbattach">
+      <title>Make a Host System USB Device Visible to a Virtual Machine</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage controlvm
+        <replaceable>vmname</replaceable> usbattach</command> command
+        dynamically attaches a host USB device to the VM, which makes it
+        visible. You do not need to create a filter.
+      </para>
+      <para>
+        Specify a USB device by its Universally Unique Identifier (UUID)
+        or by its address on the host system. Use the
+        <command>VBoxManage list usbhost</command> command to obtain
+        information about USB devices on the host system.
+      </para>
+      <para>
+        Use the <option>--capturefile</option> option to specify the
+        absolute path of a file in which to write logging data.
+      </para>
+      <para>
+        This subcommand does not affect the VM's running state directly.
+      </para>
+    </refsect2>
+    <refsect2 id="vboxmanage-controlvm-usbdetach">
+      <title>Make a Host System USB Device Invisible to a Virtual Machine</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage controlvm
+        <replaceable>vmname</replaceable> usbdetach</command> command
+        dynamically detaches a host USB device from the VM, which makes
+        it invisible. You do not need to create a filter.
+      </para>
+      <para>
+        Specify a USB device by its UUID or by its address on the host
+        system. Use the <command>VBoxManage list usbhost</command>
+        command to obtain information about USB devices on the host
+        system.
+      </para>
+      <para>
+        This subcommand does not affect the VM's running state directly.
+      </para>
+    </refsect2>
+    <refsect2 id="vboxmanage-controlvm-audioin">
+      <title>Enable or Disable Audio Capture From the Host System</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage controlvm
+        <replaceable>vmname</replaceable> audioin</command> command
+        specifies whether to enable or disable audio capture from the
+        host system. Valid values are <literal>on</literal>, which
+        enables audio capture and <literal>off</literal>, which disables
+        audio capture. The default value is <literal>off</literal>.
+      </para>
+      <para>
+        This subcommand does not affect the VM's running state directly.
+      </para>
+    </refsect2>
+    <refsect2 id="vboxmanage-controlvm-audioout">
+      <title>Enable or Disable Audio Playback From a Virtual Machine</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage controlvm
+        <replaceable>vmname</replaceable> audioout</command> command
+        specifies whether to enable or disable audio playback from the
+        guest VM. Valid values are <literal>on</literal>, which enables
+        audio playback and <literal>off</literal>, which disables audio
+        playback. The default value is <literal>off</literal>.
+      </para>
+      <para>
+        This subcommand does not affect the VM's running state directly.
+      </para>
+    </refsect2>
+    <refsect2 id="vboxmanage-controlvm-clipboard">
+      <title>Specify How to Share The Host OS or Guest OS Clipboard</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage controlvm
+        <replaceable>vmname</replaceable> clipboard</command> command
+        specifies how to share the guest or host OS's clipboard with the
+        host system or VM. Valid values are <literal>disabled</literal>,
+        <literal>hosttoguest</literal>, <literal>guesttohost</literal>,
+        and <literal>bidirectional</literal>. The default value is
+        <literal>disabled</literal>. See
+        <xref linkend="generalsettings" />.
+      </para>
+      <para>
+        This feature requires that the &product-name; Guest Additions
+        are installed in the VM.
+      </para>
+      <para>
+        This subcommand does not affect the VM's running state directly.
+      </para>
+    </refsect2>
+    <refsect2 id="vboxmanage-controlvm-draganddrop">
+      <title>Set the Drag and Drop Mode Between the Host System and a Virtual Machine</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage controlvm
+        <replaceable>vmname</replaceable> draganddrop</command> command
+        specifies the current drag and drop mode to use between the host
+        system and the VM. Valid values are <literal>disabled</literal>,
+        <literal>hosttoguest</literal>, <literal>guesttohost</literal>,
+        and <literal>bidirectional</literal>. The default value is
+        <literal>disabled</literal>. See
+        <xref linkend="guestadd-dnd" />.
+      </para>
+      <para>
+        This feature requires that the &product-name; Guest Additions
+        are installed in the VM.
+      </para>
+      <para>
+        This subcommand does not affect the VM's running state directly.
+      </para>
+    </refsect2>
+    <refsect2 id="vboxmanage-controlvm-vrde">
+      <title>Enable or Disable the VRDE Server</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage controlvm
+        <replaceable>vmname</replaceable> vrde</command> command enables
+        or disables the VirtualBox Remote Desktop Extension (VRDE)
+        server, if installed. Valid values are <literal>on</literal> and
+        <literal>off</literal>. The default value is
+        <literal>off</literal>.
+      </para>
+      <para>
+        This subcommand does not affect the VM's running state directly.
+      </para>
+    </refsect2>
+    <refsect2 id="vboxmanage-controlvm-vrdeport">
+      <title>Specify VRDE Server Ports</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage controlvm
+        <replaceable>vmname</replaceable> vrdeport</command> command
+        specifies the port or range of ports to which the VRDE server
+        can bind. The default value is <literal>default</literal> or
+        <literal>0</literal>, which is the standard RDP port,
+        <literal>3389</literal>.
+      </para>
+      <para>
+        Also see the <option>--vrdeport</option> option description in
+        <xref linkend="vboxmanage-modifyvm" />.
+      </para>
+      <para>
+        This subcommand does not affect the VM's running state directly.
+      </para>
+    </refsect2>
+    <refsect2 id="vboxmanage-controlvm-vrdeproperty">
+      <title>Specify VRDE Server Port Numbers and IP Addresses</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage controlvm
+        <replaceable>vmname</replaceable> vrdeproperty</command> command
+        specifies the port numbers and IP address on the VM to which the
+        VRDE server can bind.
+      </para>
+      <para>
+        This subcommand does not affect the VM's running state directly.
+      </para>
+      <itemizedlist>
+        <listitem><para>
+            <literal>TCP/Ports</literal> specifies a port or a range of
+            ports to which the VRDE server can bind. The default value
+            is <literal>default</literal> or <literal>0</literal>, which
+            is the standard RDP port, <literal>3389</literal>.
+          </para><para>
+            Also see the <option>--vrdeport</option> option description
+            in <xref linkend="vboxmanage-modifyvm" />.
+          </para></listitem>
+        <listitem><para>
+            <literal>TCP/Address</literal> specifies the IP address of
+            the host network interface to which the VRDE server binds.
+            When specified, the server accepts to connect only on the
+            specified host network interface.
+          </para><para>
+            Also see the <option>--vrdeaddress</option> option
+            description in <xref linkend="vboxmanage-modifyvm" />.
+          </para></listitem>
+        <listitem><para>
+            <literal>VideoChannel/Enabled</literal> specifies whether to
+            enable the VirtualBox Remote Desktop Protocol (VRDP) video
+            channel. Valid values are <literal>1</literal> to enable the
+            video channel and <literal>0</literal> to disable the video
+            channel. The default value is <literal>off</literal>. See
+            <xref linkend="vrde-videochannel" />.
+          </para></listitem>
+        <listitem><para>
+            <literal>VideoChannel/Quality</literal> specifies the JPEG
+            compression level on the VRDE server video channel. Valid
+            values are between 10% and 100%, inclusive. Lower values
+            mean lower quality but higher compression. The default value
+            is <literal>100</literal>. See
+            <xref linkend="vrde-videochannel" />.
+          </para></listitem>
+        <listitem><para>
+            <literal>VideoChannel/DownscaleProtection</literal>
+            specifies whether to enable the video channel downscale
+            protection feature. Specify <literal>1</literal> to enable
+            the feature. This feature is disabled by default.
+          </para><para>
+            When enabled, if the video's size equals the shadow buffer
+            size, the video is shown in full-screen mode. If the video's
+            size is between full-screen mode and the downscale
+            threshold, the video is not shown as it might be an
+            application window that is unreadable when downscaled. When
+            disabled, the downscale protection feature always attempts
+            to show videos.
+          </para></listitem>
+        <listitem><para>
+            <literal>Client/DisableDisplay</literal> specifies whether
+            to disable the VRDE server display feature. Valid values are
+            <literal>1</literal> to disable the feature and null
+            (<literal>&ldquo;&rdquo;</literal>) to enable the feature.
+            The default value is null. See
+            <xref linkend="vrde-customization"/>.
+          </para></listitem>
+        <listitem><para>
+            <literal>Client/DisableInput</literal> specifies whether to
+            disable the VRDE server input feature. Valid values are
+            <literal>1</literal> to disable the feature and null
+            (<literal>&ldquo;&rdquo;</literal>) to enable the feature.
+            The default value is <literal>1</literal>. See
+            <xref linkend="vrde-customization"/>.
+          </para></listitem>
+        <listitem><para>
+            <literal>Client/DisableAudio</literal> specifies whether to
+            disable the VRDE server audio feature. Valid values are
+            <literal>1</literal> to disable the feature and null
+            (<literal>&ldquo;&rdquo;</literal>) to enable the feature.
+            The default value is <literal>1</literal>. See
+            <xref linkend="vrde-customization"/>.
+          </para></listitem>
+        <listitem><para>
+            <literal>Client/DisableUSB</literal> specifies whether to
+            disable the VRDE server USB feature. Valid values are
+            <literal>1</literal> to disable the feature and null
+            (<literal>&ldquo;&rdquo;</literal>) to enable the feature.
+            The default value is <literal>1</literal>. See
+            <xref linkend="vrde-customization"/>.
+          </para></listitem>
+        <listitem><para>
+            <literal>Client/DisableClipboard</literal> specifies whether
+            to disable the VRDE clipboard feature. Valid values are
+            <literal>1</literal> to disable the feature and null
+            (<literal>&ldquo;&rdquo;</literal>) to enable the feature.
+            To reenable the feature, use
+            <literal>Client/DisableClipboard=</literal>. The default
+            value is <literal>1</literal>. See
+            <xref linkend="vrde-customization"/>.
+          </para></listitem>
+        <listitem><para>
+            <literal>Client/DisableUpstreamAudio</literal> specifies
+            whether to disable the VRDE upstream audio feature. Valid
+            values are <literal>1</literal> to disable the feature and
+            null (<literal>&ldquo;&rdquo;</literal>) to enable the
+            feature. To reenable the feature, use
+            <literal>Client/DisableUpstreamAudio=</literal>. The default
+            value is <literal>1</literal>. See
+            <xref linkend="vrde-customization"/>.
+          </para></listitem>
+        <listitem><para>
+            <literal>Client/DisableRDPDR</literal> specifies whether to
+            disable the RDP Device Redirection For Smart Cards feature
+            on the VRDE server. Valid values are <literal>1</literal> to
+            disable the feature and null
+            (<literal>&ldquo;&rdquo;</literal>) to enable the feature.
+            The default value is <literal>1</literal>. See
+            <xref linkend="vrde-customization"/>.
+          </para></listitem>
+        <listitem><para>
+            <literal>H3DRedirect/Enabled</literal> specifies whether to
+            enable the VRDE server 3D redirection feature. Valid values
+            are <literal>1</literal> to enable the feature and null
+            (<literal>&ldquo;&rdquo;</literal>) to disable the feature.
+            See <xref linkend="vrde-customization"/>.
+          </para></listitem>
+        <listitem><para>
+            <literal>Security/Method</literal> specifies the security
+            method to use for a connection. See
+            <xref linkend="vrde-crypt" />.
+          </para><itemizedlist>
+            <listitem><para>
+                <literal>Negotiate</literal> accepts both enhanced (TLS)
+                and standard RDP security connections. The security
+                method is negotiated with the client. This is the
+                default value.
+              </para></listitem>
+            <listitem><para>
+                <literal>RDP</literal> accepts only standard RDP
+                security connections.
+              </para></listitem>
+            <listitem><para>
+                <literal>TLS</literal> accepts only enhanced RDP
+                security connections. The client must support TLS.
+              </para></listitem>
+          </itemizedlist></listitem>
+        <listitem><para>
+            <literal>Security/ServerCertificate</literal> specifies the
+            absolute path of the server certificate to use for a
+            connection. See <xref linkend="vrde-crypt" />.
+          </para></listitem>
+        <listitem><para>
+            <literal>Security/ServerPrivateKey</literal> specifies the
+            absolute path of the server private key. See
+            <xref linkend="vrde-crypt" />.
+          </para></listitem>
+        <listitem><para>
+            <literal>Security/CACertificate</literal> specifies the
+            absolute path of the CA self-signed certificate. See
+            <xref linkend="vrde-crypt" />.
+          </para></listitem>
+        <listitem><para>
+            <literal>Audio/RateCorrectionMode</literal> specifies the
+            rate correction mode to use.
+          </para><itemizedlist>
+            <listitem><para>
+                <literal>VRDP_AUDIO_MODE_VOID</literal> indicates that
+                no mode is specified. Use this value to unset any audio
+                mode that is already set.
+              </para></listitem>
+            <listitem><para>
+                <literal>VRDP_AUDIO_MODE_RC</literal> specifies to use
+                the rate correction mode.
+              </para></listitem>
+            <listitem><para>
+                <literal>VRDP_AUDIO_MODE_LPF</literal> specifies to use
+                the low pass filter mode.
+              </para></listitem>
+            <listitem><para>
+                <literal>VRDP_AUDIO_MODE_CS</literal> specifies to use
+                the client sync mode to prevent underflow or overflow of
+                the client queue.
+              </para></listitem>
+          </itemizedlist></listitem>
+        <listitem><para>
+            <literal>Audio/LogPath</literal> specifies the absolute path
+            of the audio log file.
+          </para></listitem>
+      </itemizedlist>
+    </refsect2>
+    <refsect2 id="vboxmanage-controlvm-vrdevideochannelquality">
+      <title>Specify the Image Quality for VRDP Video Redirection</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage controlvm
+        <replaceable>vmname</replaceable>
+        vrdevideochannelquality</command> command sets the image
+        quality, as a JPEG compression level value, for video
+        redirection. Valid values are between 10% and 100%, inclusive.
+        Lower values mean lower quality but higher compression. See
+        <xref linkend="vrde-videochannel" />.
+      </para>
+      <para>
+        This subcommand does not affect the VM's running state directly.
+      </para>
+    </refsect2>
+    <refsect2 id="vboxmanage-controlvm-setvideomodehint">
+      <title>Specify the Video Mode for the Guest VM</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage controlvm
+        <replaceable>vmname</replaceable> setvideomodehint</command>
+        command specifies the video mode for the guest VM to use. You
+        must have the &product-name; Guest Additions installed. Note
+        that this feature does not work for all guest systems.
+      </para>
+      <para>
+        This subcommand does not affect the VM's running state directly.
+      </para>
+    </refsect2>
+    <refsect2 id="vboxmanage-controlvm-setscreenlayout">
+      <title>Specify the Screen Layout for a Display on the Guest VM</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage controlvm
+        <replaceable>vmname</replaceable> setscreenlayout</command>
+        command can be used to configure multiscreen displays. The
+        specified screen on the guest VM can be enabled or disabled, or
+        a custom screen layout can be configured.
+      </para>
+      <para>
+        This subcommand does not affect the VM's running state directly.
+      </para>
+    </refsect2>
+    <refsect2 id="vboxmanage-controlvm-screenshotpng">
+      <title>Take a Screen Shot of the Virtual Machine Display</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage controlvm
+        <replaceable>vmname</replaceable> screenshotpng</command>
+        command takes a screenshot of the guest display and saves it as
+        PNG in the specified file.
+      </para>
+      <para>
+        This subcommand does not affect the VM's running state directly.
+      </para>
+      <itemizedlist>
+        <listitem><para>
+            <replaceable>filename</replaceable> specifies the name of
+            the PNG file to create.
+          </para></listitem>
+        <listitem><para>
+            <replaceable>display</replaceable> specifies the display
+            number for the screen shot. For a single monitor guest
+            display, this is <literal>0</literal>.
+          </para></listitem>
+      </itemizedlist>
+    </refsect2>
+    <refsect2 id="vboxmanage-controlvm-recording">
+      <title>Enable or Disable the Recording of a Virtual Machine Session</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage controlvm
+        <replaceable>vmname</replaceable> recording</command> command
+        enables or disables the recording of a VM session into a
+        WebM/VP8 file. Valid values are <literal>on</literal>, which
+        begins recording when the VM session starts and
+        <literal>off</literal>, which disables recording. The default
+        value is <literal>off</literal>.
+      </para>
+      <para>
+        This subcommand does not affect the VM's running state directly.
+      </para>
+    </refsect2>
+    <refsect2 id="vboxmanage-controlvm-recordingscreens">
+      <title>Specify the Virtual Machine Screens to Record</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage controlvm
+        <replaceable>vmname</replaceable> recording screens</command>
+        command enables you to specify which VM screens to record. The
+        recording for each screen that you specify is saved to its own
+        file in the machine folder. You cannot modify this setting while
+        recording is enabled.
+      </para>
+      <para>
+        This subcommand does not affect the VM's running state directly.
+      </para>
+      <itemizedlist>
+        <listitem><para>
+            <literal>all</literal> specifies that you record all VM
+            screens.
+          </para></listitem>
+        <listitem><para>
+            <literal>none</literal> specifies that you do not record any
+            VM screens.
+          </para></listitem>
+        <listitem><para>
+            <replaceable>screen-ID</replaceable> specifies one or more
+            VM screens to record.
+          </para></listitem>
+      </itemizedlist>
+    </refsect2>
+    <refsect2 id="vboxmanage-controlvm-recordingfilename">
+      <title>Specify the File in Which to Save Virtual Machine Recording</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage controlvm
+        <replaceable>vmname</replaceable> recording filename</command>
+        command specifies the file in which to save the recording. You
+        cannot modify this setting while recording is enabled.
+      </para>
+      <para>
+        The default setting is to store a recording in the machine
+        folder, using the VM name as the file name, with a
+        <filename>webm</filename> file name extension.
+      </para>
+      <para>
+        This subcommand does not affect the VM's running state directly.
+      </para>
+    </refsect2>
+    <refsect2 id="vboxmanage-controlvm-recordingvideores">
+      <title>Specify the Resolution of the Recorded Video</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        <command>VBoxManage controlvm <replaceable>vmname</replaceable>
+        recording videores</command> command specifies the resolution of
+        the recorded video in pixels. You cannot modify this setting
+        while recording is enabled.
+      </para>
+      <para>
+        Use the Settings tool to view the video recording settings,
+        which are based on the resolution (frame size). See the Frame
+        Size field on the Recording tab of the Display page to view the
+        default value.
+      </para>
+      <para>
+        This subcommand does not affect the VM's running state directly.
+      </para>
+      <para>
+        Specify the resolution as
+        <replaceable>width</replaceable><literal>x</literal><replaceable>height</replaceable>:
+      </para>
+      <itemizedlist>
+        <listitem><para>
+            <replaceable>width</replaceable> specifies the width in
+            pixels.
+          </para></listitem>
+        <listitem><para>
+            <replaceable>height</replaceable> specifies the height in
+            pixels.
+          </para></listitem>
+      </itemizedlist>
+    </refsect2>
+    <refsect2 id="vboxmanage-controlvm-recordingvideorate">
+      <title>Specify the Bit Rate of the Video</title>
+      <remark role="help-copy-synopsis"/>
+<!-- @todo r=andy Clarify rate. -->
+      <para>
+        The <command>VBoxManage controlvm
+        <replaceable>vmname</replaceable> recording videorate</command>
+        command specifies the bit rate,
+        <replaceable>bit-rate</replaceable>, of the video in kilobits
+        per second. Increasing this value improves the appearance of the
+        video at the cost of an increased file size. You cannot modify
+        this setting while recording is enabled.
+      </para>
+      <para>
+        Use the Settings tool to view the video recording settings,
+        which are based on the frame size. See the Video Quality field
+        on the Recording tab of the Display page to view the default
+        value.
+      </para>
+      <para>
+        This subcommand does not affect the VM's running state directly.
+      </para>
+    </refsect2>
+    <refsect2 id="vboxmanage-controlvm-recordingvideofps">
+      <title>Specify the Maximum Frequency of the Video</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage controlvm
+        <replaceable>vmname</replaceable> recording videofps</command>
+        command specifies the maximum frequency of the video to record.
+        Video frequency is measured in frames per second (FPS). The
+        recording skips any frames that have a frequency higher than the
+        specified maximum. Increasing the frequency reduces the number
+        of skipped frames and increases the file size. You cannot modify
+        this setting while recording is enabled.
+      </para>
+      <para>
+        Use the Settings tool to view the video recording settings,
+        which are based on the frame size. See the Frame Rate field on
+        the Recording tab of the Display page to view the default value.
+      </para>
+      <para>
+        This subcommand does not affect the VM's running state directly.
+      </para>
+    </refsect2>
+    <refsect2 id="vboxmanage-controlvm-recordingmaxtime">
+      <title>Specify the Maximum Amount of Time to Record Video</title>
+      <remark role="help-copy-synopsis"/>
+<!-- @todo r=andy Clarify time format. -->
+      <para>
+        The <command>VBoxManage controlvm
+        <replaceable>vmname</replaceable> recording maxtime</command>
+        command specifies the maximum amount time to record in seconds.
+        The recording stops after the specified number of seconds
+        elapses. If this value is zero, the recording continues until
+        you stop the recording.
+      </para>
+      <para>
+        This subcommand does not affect the VM's running state directly.
+      </para>
+    </refsect2>
+    <refsect2 id="vboxmanage-controlvm-recordingmaxfilesize">
+      <title>Specify the Maximum Size of the Recorded Video</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage controlvm
+        <replaceable>vmname</replaceable> recording
+        maxfilesize</command> command specifies the maximum size of the
+        recorded video file in megabytes. The recording stops when the
+        file reaches the specified size. If this value is zero, the
+        recording continues until you stop the recording. You cannot
+        modify this setting while recording is enabled.
+      </para>
+      <para>
+        This subcommand does not affect the VM's running state directly.
+      </para>
+    </refsect2>
+    <refsect2 id="vboxmanage-controlvm-setcredentials">
+      <title>Specify Credentials for Remote Logins on Windows Virtual Machines</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>setcredentials</command> command enables you to
+        specify the credentials for remotely logging in to Windows VMs.
+        See <xref linkend="autologon" />.
+      </para>
+      <para>
+        This subcommand does not affect the VM's running state directly.
+      </para>
+      <itemizedlist>
+        <listitem><para>
+            <replaceable>username</replaceable> specifies the user name
+            with which to log in to the Windows VM.
+          </para></listitem>
+        <listitem><para>
+            <option>--passwordfile=<replaceable>filename</replaceable></option>
+            specifies the file from which to obtain the password for
+            <replaceable>username</replaceable>.
+          </para><para>
+            The <option>--passwordfile</option> is mutually exclusive
+            with the <option>--password</option> option.
+          </para></listitem>
+        <listitem><para>
+            <option>--password=<replaceable>password</replaceable></option>
+            specifies the password for
+            <replaceable>username</replaceable>.
+          </para><remark>
+            This design does not conform to Oracle's security
+            guidelines. You should not be able to specify a password on
+            the command line because the password can be seen in a
+            process listing.
+          </remark><para>
+            The <option>--password</option> is mutually exclusive with
+            the <option>--passwordfile</option> option.
+          </para></listitem>
+        <listitem><para>
+            <option>--allowlocallogin</option> specifies whether to
+            enable or disable local logins. Valid values are
+            <literal>on</literal> to enable local logins and
+            <literal>off</literal> to disable local logins.
+          </para></listitem>
+      </itemizedlist>
+    </refsect2>
+    <refsect2 id="vboxmanage-controlvm-plugcpu">
+      <title>Add a Virtual CPU to a Virtual Machine</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage controlvm
+        <replaceable>vmname</replaceable> plugcpu</command> command adds
+        a virtual CPU to the specified VM if CPU hot-plugging is
+        enabled. <replaceable>ID</replaceable> specifies the index of
+        the virtual CPU to be added and must be a number from 0 to the
+        maximum number of CPUs configured.
+      </para>
+      <para>
+        This subcommand does not affect the VM's running state directly.
+      </para>
+    </refsect2>
+    <refsect2 id="vboxmanage-controlvm-unplugcpu">
+      <title>Remove a Virtual CPU From a Virtual Machine</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage controlvm
+        <replaceable>vmname</replaceable> unplugcpu</command> command
+        removes a virtual CPU from the specified VM if CPU hot-plugging
+        is enabled. <replaceable>ID</replaceable> specifies the index of
+        the virtual CPU to be removed and must be a number from 0 to the
+        maximum number of CPUs configured. You cannot remove CPU 0.
+      </para>
+      <para>
+        This subcommand does not affect the VM's running state directly.
+      </para>
+    </refsect2>
+    <refsect2 id="vboxmanage-controlvm-cpuexecutioncap">
+      <title>Set the Maximum Amount of Physical CPU Time Used by a Virtual CPU</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage controlvm
+        <replaceable>vmname</replaceable> cpuexecutioncap</command>
+        command specifies how the maximum amount of physical CPU time
+        used by a virtual CPU. Valid values are a percentage between
+        <literal>1</literal> and <literal>100</literal>. A value of
+        <literal>50</literal> specifies that a single virtual CPU can
+        use up to 50% of a physical CPU. The default value is
+        <literal>100</literal>.
+      </para>
+      <para>
+        This subcommand does not affect the VM's running state directly.
+      </para>
+    </refsect2>
+    <refsect2 id="vboxmanage-controlvm-vmprocesspriority">
+      <title>Change the Priority of a VM Process</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage controlvm
+        <replaceable>vmname</replaceable> vm-process-priority</command>
+        command specifies the priority scheme of the VM process to use
+        when starting the specified VM and while the VM runs.
+      </para>
+      <para>
+        Valid values are <literal>default</literal>,
+        <literal>flat</literal>, <literal>low</literal>,
+        <literal>normal</literal>, and <literal>high</literal>.
+      </para>
+      <para>
+        This subcommand does not affect the VM's running state directly.
+      </para>
+    </refsect2>
+    <refsect2 id="vboxmanage-controlvm-webcam-attach">
+      <title>Attach a Webcam to a Virtual Machine</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage controlvm
+        <replaceable>vmname</replaceable> webcam attach</command>
+        command attaches a webcam to a running VM. Specify the webcam as
+        the absolute path of the webcam on the host OS or as an alias.
+        Use the <command>VBoxManage list webcams</command> command to
+        obtain the webcam alias.
+      </para>
+      <para>
+        Note that the <literal>.0</literal> alias is the default video
+        input device on the host OS. <literal>.1</literal> is the first
+        video input device, <literal>.2</literal> is the second video
+        input device, and so on. The order of the devices is specific to
+        the host system.
+      </para>
+      <para>
+        You can specify optional settings in the form of
+        semi-colon-separated (<literal>;</literal>) name-value pairs.
+        These properties enable you to configure the emulated webcam
+        device.
+      </para>
+      <para>
+        The following settings are supported:
+      </para>
+      <variablelist>
+        <varlistentry>
+          <term><literal>MaxFramerate</literal></term>
+          <listitem><para>
+              Specifies the highest rate at which to send video frames
+              to the VM. The rate is in frames per second. Higher frame
+              rates increase CPU load, so you can use this setting to
+              reduce CPU load. The default value is <literal>no maximum
+              limit</literal>. This value enables the VM to use any
+              frame rate supported by the webcam.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><literal>MaxPayloadTransferSize</literal></term>
+          <listitem><para>
+              Specifies the maximum number of bytes that the VM receives
+              from the emulated webcam in one buffer. The default
+              setting is <literal>3060</literal> bytes, which is used by
+              some webcams. If the VM is able to use larger buffers,
+              higher values might reduce CPU load slightly. Note that
+              some guest OSes might not suppport higher
+              <literal>MaxPayloadTransferSize</literal> values.
+            </para></listitem>
+        </varlistentry>
+      </variablelist>
+      <para>
+        This subcommand does not affect the VM's running state directly.
+      </para>
+    </refsect2>
+    <refsect2 id="vboxmanage-controlvm-webcam-detach">
+      <title>Detach a Webcam From a Virtual Machine</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage controlvm
+        <replaceable>vmname</replaceable> webcam detach</command>
+        command detaches a webcam from a running VM. Specify the webcam
+        as the absolute path of the webcam on the host OS or as an
+        alias. Use the <command>VBoxManage list webcams</command> to
+        obtain the webcam alias.
+      </para>
+      <para>
+        When a webcam device is detached from the host, the host OS
+        determines how the emulated webcam behaves.
+      </para>
+      <itemizedlist>
+        <listitem><para>
+            <emphasis role="bold">Windows hosts:</emphasis> The emulated
+            webcam device is detached from the VM automatically.
+          </para></listitem>
+        <listitem><para>
+            <emphasis role="bold">Mac OS X hosts that run at least OS X
+            10.7:</emphasis> The emulated webcam device remains attached
+            to the VM and you must detach it manually by using the
+            <command>VBoxManage controlvm webcam detach</command>
+            command.
+          </para></listitem>
+        <listitem><para>
+            <emphasis role="bold">Linux hosts:</emphasis> The emulated
+            webcam device is detached from the VM automatically only if
+            the webcam is actively streaming video. If the emulated
+            webcam is inactive, manually detach it by using the
+            <command>VBoxManage controlvm
+            <replaceable>vmname</replaceable> webcam detach</command>
+            command.
+          </para></listitem>
+      </itemizedlist>
+      <para>
+        This subcommand does not affect the VM's running state directly.
+      </para>
+    </refsect2>
+    <refsect2 id="vboxmanage-controlvm-webcam-list">
+      <title>List the Webcams Attached to a Virtual Machine</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage controlvm
+        <replaceable>vmname</replaceable> webcam list</command> command
+        lists webcams that are attached to the running VM. The output
+        shows a list of absolute paths or aliases that attached the
+        webcams to the VM by using the <command>VBoxManage controlvm
+        <replaceable>vmname</replaceable> webcam attach</command>
+        command.
+      </para>
+      <para>
+        This subcommand does not affect the VM's running state directly.
+      </para>
+    </refsect2>
+    <refsect2 id="vboxmanage-controlvm-addencpassword">
+      <title>Set an Encryption Password for a Virtual Machine</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage controlvm
+        <replaceable>vmname</replaceable> addencpassword</command>
+        command provides the <replaceable>vmname</replaceable> encrypted
+        VM with the encryption password to enable a headless start.
+        Specify the absolute path of a password file on the host system.
+        If <replaceable>filename</replaceable> is <literal>-</literal>,
+        <command>VBoxManage</command> prompts for the encryption
+        password.
+      </para>
+      <para>
+        Use the <option>--removeonsuspend</option> option to specify
+        whether to save the passsword or clear it from VM memory when
+        the VM is suspended.
+      </para>
+      <para>
+        If the VM is suspended and the password is cleared, use the
+        <command>VBoxManage controlvm <replaceable>vmname</replaceable>
+        addencpassword</command> to provide the password to resume
+        execution on the VM. Use this feature when you do not want to
+        store the password in VM memory while the VM is suspended by a
+        host suspend event.
+      </para>
+      <note>
+        <para>
+          You can encrypt data stored on hard disk images used by the
+          VM. &product-name; uses the AES algorithm in XTS mode and
+          supports 128-bit or 256-bit data encryption keys (DEK). The
+          encrypted DEK is stored in the medium properties and is
+          decrypted during VM startup when you provide the encryption
+          password.
+        </para>
+      </note>
+      <para>
+        Use the <command>VBoxManage encryptmedium</command> command to
+        create a DEK encrypted medium. See
+        <xref linkend="diskencryption-encryption" />.
+      </para>
+      <para>
+        The &product-name; GUI prompts you for the encryption password
+        when you start an encrypted VM.
+      </para>
+      <para>
+        Use the following command to perform a headless start of an
+        encrypted VM:
+      </para>
+<screen>
+          $ VBoxManage startvm <replaceable>vmname</replaceable> --type headless
+        </screen>
+      <para>
+        Then, use the following command to provide the encryption
+        password:
+      </para>
+<screen>
+          $ VBoxManage <replaceable>vmname</replaceable> controlvm addencpassword <replaceable>vmname</replaceable> -
+          Password: <replaceable>encryption-password</replaceable>
+        </screen>
+      <para>
+        This subcommand does not affect the VM's running state directly.
+      </para>
+    </refsect2>
+    <refsect2 id="vboxmanage-controlvm-removeencpassword">
+      <title>Disable an Encryption Password for a Virtual Machine</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage controlvm
+        <replaceable>vmname</replaceable> removeencpassword</command>
+        command disables a specific encryption password for all
+        encrypted media attached to the VM.
+      </para>
+      <para>
+        <replaceable>ID</replaceable> is the password identifier for the
+        encryption password that you want to disable.
+      </para>
+      <para>
+        This subcommand does not affect the VM's running state directly.
+      </para>
+    </refsect2>
+    <refsect2 id="vboxmanage-controlvm-removeallencpasswords">
+      <title>Disable All Encryption Passwords for a Virtual Machine</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage controlvm
+        <replaceable>vmname</replaceable>
+        removeallencpasswords</command> command disables all encryption
+        passwords for all encrypted media attached to the VM.
+      </para>
+      <para>
+        This subcommand does not affect the VM's running state directly.
+      </para>
+    </refsect2>
+    <refsect2 id="vboxmanage-controlvm-changeuartmode">
+      <title>Change the Connection Mode for a Virtual Serial Port on a Virtual
+        Machine</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage controlvm
+        <replaceable>vmname</replaceable> changeuartmode</command>
+        command changes the connection mode for the specified virtual
+        serial port. Valid serial port values are integers that start
+        from <literal>1</literal>.
+      </para>
+      <para>
+        This subcommand does not affect the VM's running state directly.
+      </para>
+      <variablelist>
+        <varlistentry>
+          <term>disconnected</term>
+          <listitem><para>
+              Disconnects the device.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>server <replaceable>pipe-name</replaceable></term>
+          <listitem><para>
+              Specifies the pipe name of the server.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>client <replaceable>pipe-name</replaceable></term>
+          <listitem><para>
+              Specifies the pipe name of the client.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>tcpserver <replaceable>port</replaceable></term>
+          <listitem><para>
+              Specifies the port number of the TCP server.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>tcpclient <replaceable>hostname</replaceable>:<replaceable>port</replaceable></term>
+          <listitem><para>
+              Specifies the host name and port number of the TCP client.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>file <replaceable>filename</replaceable></term>
+          <listitem><para>
+              Specifies the name of the file.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><replaceable>device-name</replaceable></term>
+          <listitem><para>
+              Specifies the name of the device.
+            </para></listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+  </refsect1>
+
+  <refsect1>
+    <title>Examples</title>
+    <remark role="help-scope" condition="GLOBAL" />
+    <para>
+      The following command temporarily stops the execution of the
+      <filename>ol7</filename> VM.
+    </para>
+<screen>$ VBoxManage controlvm ol7 pause</screen>
+    <para>
+      The following command configures shared clipboard operation for
+      the <filename>ol7</filename> VM. Copying of clipboard data is
+      allowed in both directions between the host and guest.
+    </para>
+<screen>$ VBoxManage controlvm ol7 clipboard bidirectional</screen>
+  </refsect1>
+
+  <refsect1>
+    <title>See Also</title>
+    <para>
+      <xref linkend="vboxmanage-list" />,
+      <xref linkend="vboxmanage-modifyvm" />,
+      <xref linkend="vboxmanage-startvm" />
+    </para>
+  </refsect1>
+</refentry>
Index: trunk/doc/manual/en_US/man_VBoxManage-convertfromraw.xml
===================================================================
--- trunk/doc/manual/en_US/man_VBoxManage-convertfromraw.xml	(revision 82044)
+++ trunk/doc/manual/en_US/man_VBoxManage-convertfromraw.xml	(revision 82044)
@@ -0,0 +1,239 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+    manpage, user manual, usage: VBoxManage convertfromraw
+
+    Copyright (C) 2006-2019 Oracle Corporation
+
+    This file is part of VirtualBox Open Source Edition (OSE), as
+    available from http://www.virtualbox.org. This file is free software;
+    you can redistribute it and/or modify it under the terms of the GNU
+    General Public License (GPL) as published by the Free Software
+    Foundation, in version 2 as it comes in the "COPYING" file of the
+    VirtualBox OSE distribution. VirtualBox OSE is distributed in the
+    hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
+ -->
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+  "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"[
+<!ENTITY % all.entities SYSTEM "all-entities.ent">
+%all.entities;
+]>
+<refentry id="vboxmanage-convertfromraw" lang="en">
+  <refentryinfo>
+    <pubdate>September 2019</pubdate>
+    <title>VBoxManage convertfromraw</title>
+  </refentryinfo>
+
+  <refmeta>
+    <refentrytitle>VBoxManage-convertfromraw</refentrytitle>
+    <manvolnum>1</manvolnum>
+  </refmeta>
+
+  <refnamediv>
+    <refname>VBoxManage-convertfromraw</refname>
+    <refpurpose>convert a raw disk image to a virtual disk image</refpurpose>
+    <refclass>Oracle VM VirtualBox</refclass>
+  </refnamediv>
+
+  <refsynopsisdiv>
+<!-- The 'id' is mandatory and must start with 'synopsis-'. -->
+    <cmdsynopsis id="synopsis-vboxmanage-convertfromraw-file">
+      <command>VBoxManage convertfromraw</command> 
+      <arg choice="req"><replaceable>inputfile</replaceable></arg>
+      <arg choice="req"><replaceable>outputfile</replaceable></arg>
+      <arg>--format=<group choice="plain">
+          <arg choice="plain">VDI</arg>
+          <arg choice="plain">VMDK</arg>
+          <arg choice="plain">VHD</arg>
+        </group></arg>
+      <arg>--uuid=<replaceable>uuid</replaceable></arg>
+      <arg>--variant=Standard,Fixed,Split2G,Stream,ESX</arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-convertfromraw-stdin">
+      <command>VBoxManage convertfromraw stdin</command> 
+      <arg choice="req"><replaceable>outputfile</replaceable></arg>
+      <arg>--format=<group choice="plain">
+          <arg choice="plain">VDI</arg>
+          <arg choice="plain">VMDK</arg>
+          <arg choice="plain">VHD</arg>
+        </group></arg>
+      <arg>--uuid=<replaceable>uuid</replaceable></arg>
+      <arg>--variant=Standard,Fixed,Split2G,Stream,ESX</arg>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+
+  <refsect1>
+    <title>Description</title>
+    <para>
+      The <command>VBoxManage convertfromraw</command> command enables
+      you to convert a raw disk image to an &product-name; virtual disk
+      image (VDI).
+    </para>
+    <note>
+      <para>
+        For compatibility with earlier versions of &product-name;, you
+        can use the <command>VBoxManage convertdd</command> command
+        instead of the <command>VBoxManage convertfromraw</command>
+        command.
+      </para>
+    </note>
+    <refsect2 id="vboxmanage-convertfromraw-file">
+      <title>Convert a Raw Disk File to a Virtual Disk Image File</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage convertfromraw</command> command
+        converts the specified raw disk image input file to an
+        &product-name; VDI file.
+      </para>
+      <variablelist>
+        <varlistentry>
+          <term><replaceable>inputfile</replaceable></term>
+          <listitem><para>
+              Specifies the name of the raw disk image file to convert.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><replaceable>outputfile</replaceable></term>
+          <listitem><para>
+              Specifies the name of the file in which to write the VDI
+              output.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--format=VDI | VMDK | VHD</option></term>
+          <listitem><para>
+              Specifies the format of the disk image to create. Valid
+              values are <literal>VDI</literal>,
+              <literal>VMDK</literal>, and <literal>VHD</literal>. The
+              default format is <literal>VDI</literal>.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--uuid=<replaceable>uuid</replaceable></option></term>
+          <listitem><para>
+              Specifies the Universally Unique Identifier (UUID) of the
+              output file.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--variant=Standard,Fixed,Split2G,Stream,ESX</option></term>
+          <listitem><para>
+              Specifies any required file format variants for the output
+              file. This is a comma-separated list of variant values.
+              Following are the valid values:
+            </para><itemizedlist>
+              <listitem><para>
+                  <literal>Standard</literal> is the default disk image
+                  type, which has a dynamically allocated file size.
+                </para></listitem>
+              <listitem><para>
+                  <literal>Fixed</literal> uses a disk image that has a
+                  fixed file size.
+                </para></listitem>
+              <listitem><para>
+                  <literal>Split2G</literal> indicates that the disk
+                  image is split into 2GB segments. This value is for
+                  VMDK only.
+                </para></listitem>
+              <listitem><para>
+                  <literal>Stream</literal> optimizes the disk image for
+                  downloading. This value is for VMDK only.
+                </para></listitem>
+              <listitem><para>
+                  <literal>ESX</literal> is used for some VMWare
+                  products. This value is for VMDK only.
+                </para></listitem>
+            </itemizedlist><para>
+              Note that not all variant combinations are valid.
+              Specifying incompatible variant values in the list will
+              produce an error message.
+            </para></listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+    <refsect2 id="vboxmanage-convertfromraw-stdin">
+      <title>Convert Raw Data From Standard Input to a Virtual Disk Image File</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage convertfromraw stdin</command> command
+        reads the content of the disk image from standard input.
+        Consider using this form of the command in a pipe sequence.
+      </para>
+      <variablelist>
+        <varlistentry>
+          <term><replaceable>outputfile</replaceable></term>
+          <listitem><para>
+              Specifies the name of the file in which to write the VDI
+              output.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--format=VDI | VMDK | VHD</option></term>
+          <listitem><para>
+              Specifies the format of the disk image to create. Valid
+              values are <literal>VDI</literal>,
+              <literal>VMDK</literal>, and <literal>VHD</literal>. The
+              default format is <literal>VDI</literal>.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--uuid=<replaceable>uuid</replaceable></option></term>
+          <listitem><para>
+              Specifies the UUID of the output file.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--variant=Standard,Fixed,Split2G,Stream,ESX</option></term>
+          <listitem><para>
+              Specifies any required file format variants for the output
+              file. This is a comma-separated list of variant values.
+              Following are the valid values:
+            </para><itemizedlist>
+              <listitem><para>
+                  <literal>Standard</literal> is the default disk image
+                  type, which has a dynamically allocated file size.
+                </para></listitem>
+              <listitem><para>
+                  <literal>Fixed</literal> uses a disk image that has a
+                  fixed file size.
+                </para></listitem>
+              <listitem><para>
+                  <literal>Split2G</literal> indicates that the disk
+                  image is split into 2GB segments. This value is for
+                  VMDK only.
+                </para></listitem>
+              <listitem><para>
+                  <literal>Stream</literal> optimizes the disk image for
+                  downloading. This value is for VMDK only.
+                </para></listitem>
+              <listitem><para>
+                  <literal>ESX</literal> is used for some VMWare
+                  products. This value is for VMDK only.
+                </para></listitem>
+            </itemizedlist><para>
+              Note that not all variant combinations are valid.
+              Specifying incompatible variant values in the list will
+              produce an error message.
+            </para></listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+  </refsect1>
+
+  <refsect1>
+    <title>Examples</title>
+    <remark role="help-scope" condition="GLOBAL" />
+    <para>
+      The following command converts the raw disk image input file
+      <filename>disk01.raw</filename>. The output file is a VDI disk
+      image called <filename>disk02.vdi</filename>.
+    </para>
+<screen>$ VBoxManage convertfromraw disk01.raw disk02.vdi</screen>
+    <para>
+      The following command converts the raw disk image input file
+      <filename>disk01.raw</filename>. The output file is a VMDK disk
+      image called <filename>disk02.vmdk</filename>.
+    </para>
+<screen>$ VBoxManage convertfromraw disk01.raw disk02.vmdk --format VMDK</screen>
+  </refsect1>
+</refentry>
Index: trunk/doc/manual/en_US/man_VBoxManage-createmedium.xml
===================================================================
--- trunk/doc/manual/en_US/man_VBoxManage-createmedium.xml	(revision 82044)
+++ trunk/doc/manual/en_US/man_VBoxManage-createmedium.xml	(revision 82044)
@@ -0,0 +1,180 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+         manpage, user manual, usage: VBoxManage createmedium
+
+    Copyright (C) 2006-2019 Oracle Corporation
+
+    This file is part of VirtualBox Open Source Edition (OSE), as
+    available from http://www.virtualbox.org. This file is free software;
+    you can redistribute it and/or modify it under the terms of the GNU
+    General Public License (GPL) as published by the Free Software
+    Foundation, in version 2 as it comes in the "COPYING" file of the
+    VirtualBox OSE distribution. VirtualBox OSE is distributed in the
+    hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
+ -->
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+  "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"[
+<!ENTITY % all.entities SYSTEM "all-entities.ent">
+%all.entities;
+]>
+<refentry id="vboxmanage-createmedium" lang="en">
+  <refentryinfo>
+    <pubdate>August 2019</pubdate>
+    <title>VBoxManage createmedium</title>
+  </refentryinfo>
+
+  <refmeta>
+    <refentrytitle>VBoxManage-createmedium</refentrytitle>
+    <manvolnum>1</manvolnum>
+  </refmeta>
+
+  <refnamediv>
+    <refname>VBoxManage-createmedium</refname>
+    <refpurpose>create a new medium</refpurpose>
+    <refclass>Oracle VM VirtualBox</refclass>
+  </refnamediv>
+
+  <refsynopsisdiv>
+    <cmdsynopsis id="synopsis-vboxmanage-createmedium">
+<!-- The 'id' is mandatory and must start with 'synopsis-'. -->
+      <command>VBoxManage createmedium</command>
+      <group>
+        <arg choice="plain"><replaceable>disk</replaceable></arg>
+        <arg choice="plain"><replaceable>dvd</replaceable></arg>
+        <arg choice="plain"><replaceable>floppy</replaceable></arg>
+      </group>
+      <arg choice="req">--filename=<replaceable>filename</replaceable></arg>
+      <group choice="opt">
+        <arg choice="plain">--size=<replaceable>megabytes</replaceable></arg>
+        <arg choice="plain">--sizebyte=<replaceable>bytes</replaceable></arg>
+      </group>
+      <arg>--diffparent=<group choice="plain">
+          <arg choice="plain"><replaceable>UUID</replaceable></arg>
+          <arg choice="plain"><replaceable>filename</replaceable></arg>
+        </group></arg>
+      <arg>--format=<group choice="plain">
+          <arg choice="plain"><replaceable>VDI</replaceable></arg>
+          <arg choice="plain"><replaceable>VMDK</replaceable></arg>
+          <arg choice="plain"><replaceable>VHD</replaceable></arg>
+        </group></arg>
+      <arg>--variant Standard,Fixed,Split2G,Stream,ESX,Formatted</arg>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+
+  <refsect1>
+    <title>Description</title>
+    <para>
+      The <command>VBoxManage createmedium</command> command creates a
+      new medium, such as a disk image file.
+    </para>
+    <note>
+      <para>
+        For compatibility with earlier versions of &product-name;, you
+        can use the <command>createvdi</command> and
+        <command>createhd</command> commands instead of the
+        <command>createmedium</command> command.
+      </para>
+    </note>
+    <variablelist>
+      <varlistentry>
+        <term>disk | dvd | floppy</term>
+        <listitem><para>
+            Specifies the media type. The default value is
+            <literal>disk</literal>.
+          </para></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--filename=<replaceable>filename</replaceable></option></term>
+        <listitem><para>
+            Specifies the absolute path name to a file on the host file
+            system.
+          </para></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--size=<replaceable>megabytes</replaceable></option></term>
+        <listitem><para>
+            Specifies the image capacity in one megabyte units.
+          </para></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--sizebyte=<replaceable>bytes</replaceable></option></term>
+        <listitem><para>
+            Specifies the image capacity in one byte units.
+          </para></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--diffparent=<replaceable>UUID</replaceable> | <replaceable>filename</replaceable></option></term>
+        <listitem><para>
+            Specifies the Universally Unique Identifier (UUID) or
+            absolute path name of a differencing image parent file on
+            the host file system.
+          </para><para>
+            Use this file to share a base box disk image among VMs.
+          </para></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--format=VDI | VMDK | VHD</option></term>
+        <listitem><para>
+            Specifies the file format of the output file. Valid formats
+            are <literal>VDI</literal>, <literal>VMDK</literal>, and
+            <literal>VHD</literal>. The default format is
+            <literal>VDI</literal>.
+          </para></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--variant=Standard,Fixed,Split2G,Stream,ESX, Formatted</option></term>
+        <listitem><para>
+            Specifies the file format variant for the target medium,
+            which is a comma-separated list of variants. Following are
+            the valid values:
+          </para><itemizedlist>
+            <listitem><para>
+                <literal>Standard</literal> is the default disk image
+                type, which has a dynamically allocated file size.
+              </para></listitem>
+            <listitem><para>
+                <literal>Fixed</literal> uses a disk image that has a
+                fixed file size.
+              </para></listitem>
+            <listitem><para>
+                <literal>Split2G</literal> indicates that the disk image
+                is split into 2GB segments. This value is for VMDK only.
+              </para></listitem>
+            <listitem><para>
+                <literal>Stream</literal> optimizes the disk image for
+                downloading. This value is for VMDK only.
+              </para></listitem>
+            <listitem><para>
+                <literal>ESX</literal> is used for some VMWare products.
+                This value is for VMDK only.
+              </para></listitem>
+            <listitem><para>
+                <literal>Formatted</literal>
+              </para><para>
+                For floppy images only. Formats the medium
+                automatically.
+              </para></listitem>
+          </itemizedlist><para>
+            Note that not all variant combinations are valid. Specifying
+            incompatible variant values in the list will produce an
+            error message.
+          </para></listitem>
+      </varlistentry>
+    </variablelist>
+  </refsect1>
+
+  <refsect1>
+    <title>Examples</title>
+    <remark role="help-scope" condition="GLOBAL" />
+    <para>
+      The following command creates a new disk image file called
+      <filename>disk01.vdi</filename>. The file size is 1024 megabytes.
+    </para>
+<screen>$ VBoxManage createmedium --filename disk01.vdi --size 1024</screen>
+    <para>
+      The following command creates a new floppy disk image file called
+      <filename>floppy01.vdi</filename>. The file size is 1 megabyte.
+    </para>
+<screen>$ VBoxManage createmedium floppy --filename floppy01.img --size 1</screen>
+  </refsect1>
+</refentry>
Index: trunk/doc/manual/en_US/man_VBoxManage-createvm.xml
===================================================================
--- trunk/doc/manual/en_US/man_VBoxManage-createvm.xml	(revision 82044)
+++ trunk/doc/manual/en_US/man_VBoxManage-createvm.xml	(revision 82044)
@@ -0,0 +1,163 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+    manpage, user manual, usage: VBoxManage createvm
+
+    Copyright (C) 2006-2019 Oracle Corporation
+
+    This file is part of VirtualBox Open Source Edition (OSE), as
+    available from http://www.virtualbox.org. This file is free software;
+    you can redistribute it and/or modify it under the terms of the GNU
+    General Public License (GPL) as published by the Free Software
+    Foundation, in version 2 as it comes in the "COPYING" file of the
+    VirtualBox OSE distribution. VirtualBox OSE is distributed in the
+    hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
+ -->
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+  "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"[
+<!ENTITY % all.entities SYSTEM "all-entities.ent">
+%all.entities;
+]>
+<refentry id="vboxmanage-createvm" lang="en">
+  <refentryinfo>
+    <pubdate>August 2019</pubdate>
+    <title>VBoxManage createvm</title>
+  </refentryinfo>
+
+  <refmeta>
+    <refentrytitle>VBoxManage-createvm</refentrytitle>
+    <manvolnum>1</manvolnum>
+  </refmeta>
+
+  <refnamediv>
+    <refname>VBoxManage-createvm</refname>
+    <refpurpose>create a new virtual machine</refpurpose>
+    <refclass>Oracle VM VirtualBox</refclass>
+  </refnamediv>
+
+  <refsynopsisdiv>
+    <cmdsynopsis id="synopsis-vboxmanage-createvm">
+<!-- The 'id' is mandatory and must start with 'synopsis-'. -->
+      <command>VBoxManage createvm</command> 
+      <arg choice="req">--name=<replaceable>name</replaceable></arg>
+      <arg>--basefolder=<replaceable>basefolder</replaceable></arg>
+      <arg>--default</arg>
+      <arg>--group=<replaceable>group-ID</replaceable>, ...</arg>
+      <arg>--ostype=<replaceable>ostype</replaceable></arg>
+      <arg>--register</arg>
+      <arg>--uuid=<replaceable>uuid</replaceable></arg>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+
+  <refsect1>
+    <title>Description</title>
+    <para>
+      The <command>VBoxManage createvm</command> command creates a new
+      XML virtual machine (VM) definition file.
+    </para>
+    <para>
+      You must specify the name of the VM by using <option>--name
+      <replaceable>name</replaceable></option>. This name is used by
+      default as the name of the settings file that has the
+      <filename>.vbox</filename> extension and the machine folder, which
+      is a subfolder of the <filename>$HOME/VirtualBox VMs</filename>
+      directory.
+    </para>
+    <para>
+      Ensure that the VM name conforms to the host OS file name
+      requirements. If you later rename the VM, the file and folder
+      names will be updated to match the new name automatically.
+    </para>
+  </refsect1>
+
+  <refsect1>
+    <title>Command Options</title>
+    <para>
+      In addition to specifying the name or UUID of the VM, which is
+      required, you can specify any of the following options:
+    </para>
+    <variablelist>
+      <varlistentry>
+        <term><option>--basefolder=<replaceable>basefolder</replaceable></option></term>
+        <listitem><para>
+            Specifies the name of the folder in which to save the
+            machine configuration file for the new VM.
+          </para><para>
+            Note that the names of the file and the folder do not change
+            if you rename the VM.
+          </para></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--default</option></term>
+        <listitem><para>
+            Applies a default hardware configuration for the specified
+            guest OS. By default, the VM is created with minimal
+            hardware.
+          </para></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--group=<replaceable>group-ID</replaceable>, ...</option></term>
+        <listitem><para>
+            Assigns the VM to the specified groups. If you specify more
+            than one group, separate each group name with a comma.
+          </para><para>
+            Note that each group is identified by a group ID that starts
+            with a slash character (<literal>/</literal>) so that groups
+            can be nested. By default, a VM is always assigned
+            membership to the <literal>/</literal> group.
+          </para></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--ostype=<replaceable>ostype</replaceable></option></term>
+        <listitem><para>
+            Specifies the guest OS to run in the VM. Run the
+            <command>VBoxManage list ostypes</command> command to see
+            the available OS types.
+          </para></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--register</option></term>
+        <listitem><para>
+            Registers the VM with your &product-name; installation. By
+            default, the <command>VBoxManage createvm</command> command
+            creates only the XML configuration for the VM but does not
+            register the VM. If you do not register the VM at creation,
+            you can run the <command>VBoxManage registervm</command>
+            command after you create the VM.
+          </para></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--uuid=<replaceable>uuid</replaceable></option></term>
+        <listitem><para>
+            Specifies the Universally Unique Identifier (UUID) of the
+            VM. Ensure that this UUID is unique within the
+            &product-name; namespace of the host or of its VM group
+            memberships if you decide to register the VM. By default,
+            &product-name; command provides the UUID.
+          </para></listitem>
+      </varlistentry>
+    </variablelist>
+  </refsect1>
+
+  <refsect1>
+    <title>Examples</title>
+    <remark role="help-scope" condition="GLOBAL" />
+    <para>
+      The following command creates a VM called <literal>vm2</literal>
+      where you plan to run a 64-bit version of Oracle Linux.
+    </para>
+<screen>$ VBoxManage createvm --name "vm2" --ostype "Oracle_64"</screen>
+    <para>
+      The following command creates and registers a VM called
+      <literal>vm3</literal>.
+    </para>
+<screen>$ VBoxManage createvm --name "vm3" --register</screen>
+  </refsect1>
+
+  <refsect1>
+    <title>See Also</title>
+    <para>
+      <xref linkend="vboxmanage-list" />,
+      <xref linkend="vboxmanage-registervm" />
+    </para>
+  </refsect1>
+</refentry>
Index: trunk/doc/manual/en_US/man_VBoxManage-discardstate.xml
===================================================================
--- trunk/doc/manual/en_US/man_VBoxManage-discardstate.xml	(revision 82044)
+++ trunk/doc/manual/en_US/man_VBoxManage-discardstate.xml	(revision 82044)
@@ -0,0 +1,91 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+    manpage, user manual, usage: VBoxManage discardstate
+
+    Copyright (C) 2006-2019 Oracle Corporation
+
+    This file is part of VirtualBox Open Source Edition (OSE), as
+    available from http://www.virtualbox.org. This file is free software;
+    you can redistribute it and/or modify it under the terms of the GNU
+    General Public License (GPL) as published by the Free Software
+    Foundation, in version 2 as it comes in the "COPYING" file of the
+    VirtualBox OSE distribution. VirtualBox OSE is distributed in the
+    hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
+ -->
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+  "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"[
+<!ENTITY % all.entities SYSTEM "all-entities.ent">
+%all.entities;
+]>
+<refentry id="vboxmanage-discardstate" lang="en">
+  <refentryinfo>
+    <pubdate>August 2019</pubdate>
+    <title>VBoxManage discardstate</title>
+  </refentryinfo>
+
+  <refmeta>
+    <refentrytitle>VBoxManage-discardstate</refentrytitle>
+    <manvolnum>1</manvolnum>
+  </refmeta>
+
+  <refnamediv>
+    <refname>VBoxManage-discardstate</refname>
+    <refpurpose>discard the saved state of a virtual machine</refpurpose>
+    <refclass>Oracle VM VirtualBox</refclass>
+  </refnamediv>
+
+  <refsynopsisdiv>
+    <cmdsynopsis id="synopsis-vboxmanage-discardstate">
+<!-- The 'id' is mandatory and must start with 'synopsis-'. -->
+      <command>VBoxManage discardstate</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+
+  <refsect1>
+    <title>Description</title>
+    <para>
+      The <command>VBoxManage discardstate</command> command discards
+      the saved state of a virtual machine (VM) that is not currently
+      running. This command causes the VM's operating system to restart
+      the next time you start the VM.
+    </para>
+    <note>
+      <para>
+        Where possible, avoid performing this action. The effects of
+        this command are equivalent to unplugging the power cable on a
+        physical machine.
+      </para>
+    </note>
+    <variablelist>
+      <varlistentry>
+        <term><replaceable>uuid</replaceable>|<replaceable>vmname</replaceable></term>
+        <listitem><para>
+            Specifies the Universally Unique Identifier (UUID) or name
+            of the VM.
+          </para></listitem>
+      </varlistentry>
+    </variablelist>
+  </refsect1>
+
+  <refsect1>
+    <title>Examples</title>
+    <remark role="help-scope" condition="GLOBAL" />
+    <para>
+      The following command discards the saved state file for the VM
+      called <filename>vm2</filename>. When you next start the VM, the
+      VM's operating system is restarted.
+    </para>
+<screen>$ VBoxManage discardstate vm2</screen>
+  </refsect1>
+
+  <refsect1>
+    <title>See Also</title>
+    <para>
+      <xref linkend="vboxmanage-adoptstate"/>
+    </para>
+  </refsect1>
+</refentry>
Index: trunk/doc/manual/en_US/man_VBoxManage-encryptmedium.xml
===================================================================
--- trunk/doc/manual/en_US/man_VBoxManage-encryptmedium.xml	(revision 82044)
+++ trunk/doc/manual/en_US/man_VBoxManage-encryptmedium.xml	(revision 82044)
@@ -0,0 +1,163 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+         manpage, user manual, usage: VBoxManage encryptmedium
+
+    Copyright (C) 2006-2019 Oracle Corporation
+
+    This file is part of VirtualBox Open Source Edition (OSE), as
+    available from http://www.virtualbox.org. This file is free software;
+    you can redistribute it and/or modify it under the terms of the GNU
+    General Public License (GPL) as published by the Free Software
+    Foundation, in version 2 as it comes in the "COPYING" file of the
+    VirtualBox OSE distribution. VirtualBox OSE is distributed in the
+    hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
+ -->
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+  "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"[
+<!ENTITY % all.entities SYSTEM "all-entities.ent">
+%all.entities;
+]>
+<refentry id="vboxmanage-encryptmedium" lang="en">
+  <refentryinfo>
+    <pubdate>August 2019</pubdate>
+    <title>VBoxManage encryptmedium</title>
+  </refentryinfo>
+
+  <refmeta>
+    <refentrytitle>VBoxManage-encryptmedium</refentrytitle>
+    <manvolnum>1</manvolnum>
+  </refmeta>
+
+  <refnamediv>
+    <refname>VBoxManage-encryptmedium</refname>
+    <refpurpose>manage a DEK-encrypted medium or image</refpurpose>
+    <refclass>Oracle VM VirtualBox</refclass>
+  </refnamediv>
+
+  <refsynopsisdiv>
+    <cmdsynopsis id="synopsis-vboxmanage-encryptmedium">
+<!-- The 'id' is mandatory and must start with 'synopsis-'. -->
+      <command>VBoxManage encryptmedium</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>filename</replaceable></arg>
+      </group>
+      <arg>--cipher=<replaceable>cipher-ID</replaceable></arg>
+      <arg>--newpassword=<replaceable>password</replaceable></arg>
+      <arg>--newpasswordid=<replaceable>password-ID</replaceable></arg>
+      <arg>--oldpassword=<replaceable>password</replaceable></arg>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+
+  <refsect1>
+    <title>Description</title>
+    <para>
+      The <command>VBoxManage encryptmedium</command> command enables
+      you to create and manage a DEK-encrypted medium or image. You can
+      encrypt an image, decrypt an image, and change the encryption
+      password of an image. See
+      <xref linkend="diskencryption-encryption" />.
+    </para>
+    <variablelist>
+      <varlistentry>
+        <term><replaceable>uuid</replaceable> | <replaceable>filename</replaceable></term>
+        <listitem><para>
+            Specifies the Universally Unique Identifier (UUID) or the
+            absolute path name of the medium or image to encrypt.
+          </para></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--newpassword=<replaceable>password</replaceable></option></term>
+        <listitem><para>
+            Specifies the new encryption password.
+            <replaceable>password</replaceable> is either the absolute
+            path name of a password file on the host operating system or
+            <literal>-</literal>, which prompts you for the password.
+          </para><para>
+            You must use the <option>--newpasswordid</option> option
+            with this <option>--newpassword</option> option.
+          </para></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--oldpassword=<replaceable>password</replaceable></option></term>
+        <listitem><para>
+            Specifies the original encryption password.
+            <replaceable>password</replaceable> is either the absolute
+            path name of a password file on the host operating system or
+            <literal>-</literal>, which prompts you for the original
+            password.
+          </para><para>
+            This option enables you to gain access to an encrypted
+            medium or image to do the following:
+          </para><itemizedlist>
+            <listitem><para>
+                Decrypt an encrypted image by using this option by
+                itself.
+              </para></listitem>
+            <listitem><para>
+                Change the password of the encrypted image by using the
+                <option>--newpassword</option> option.
+              </para></listitem>
+            <listitem><para>
+                Change the encryption cipher of the image by using the
+                <option>--cipher</option> option.
+              </para></listitem>
+          </itemizedlist></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--cipher=<replaceable>cipher-ID</replaceable></option></term>
+        <listitem><para>
+            Specifies the cipher to use for encryption. Valid values are
+            <literal>AES-XTS128-PLAIN64</literal> or
+            <literal>AES-XTS256-PLAIN64</literal>.
+          </para><para>
+            This option enables you to set up or change encryption on
+            the medium or image.
+          </para></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--newpasswordid=<replaceable>password-ID</replaceable></option></term>
+        <listitem><para>
+            Specifies a new password identifier that is used for correct
+            identification when supplying multiple passwords during VM
+            startup.
+          </para><para>
+            If you use the same password and password identifier when
+            encrypting multiple images, you need to supply the password
+            only one time during VM startup.
+          </para></listitem>
+      </varlistentry>
+    </variablelist>
+  </refsect1>
+
+  <refsect1>
+    <title>Examples</title>
+    <remark role="help-scope" condition="GLOBAL"/>
+    <para>
+      The following example shows how to encrypt the
+      <filename>ol7u4-1.vdi</filename> image by using the
+      <literal>AES-XTS128-PLAIN64</literal> cipher, specifying a
+      password identifier of <literal>1001</literal>, and using the
+      <filename>$HOME/pwfile</filename> password file:
+    </para>
+<screen>$ VBoxManage encryptmedium "$HOME/VirtualBox VMs/ol7u4/ol7u4-1.vdi" \
+  --cipher="AES-XTS128-PLAIN64" --newpasswordid="1001" --newpassword=$HOME/pwfile</screen>
+    <para>
+      The following example shows how to decrypt an encrypted image
+      called <filename>ol7u4-2.vdi</filename>:
+    </para>
+<screen>$ VBoxManage encryptmedium "$HOME/VirtualBox VMs/ol7u4/ol7u4-2.vdi" \
+  --oldpassword=- 
+  Password: <replaceable>original-password</replaceable></screen>
+    <para>
+      The following example shows how to change the password for an
+      encrypted image called <filename>ol7u4-3.vdi</filename>. The
+      command reads the original password from the
+      <filename>$HOME/pwfile.orig</filename> file, reads the new
+      password from the <filename>$HOME/pwfile</filename> file, and
+      assigns a password identifier of <literal>1001</literal>.
+    </para>
+<screen>$ VBoxManage encryptmedium "$HOME/VirtualBox VMs/ol7u4/ol7u4-3.vdi" \
+  --oldpassword=$HOME/pwfile.orig --newpassword=$HOME/pwfile --newpasswordid="1001"</screen>
+  </refsect1>
+</refentry>
Index: trunk/doc/manual/en_US/man_VBoxManage-export.xml
===================================================================
--- trunk/doc/manual/en_US/man_VBoxManage-export.xml	(revision 82044)
+++ trunk/doc/manual/en_US/man_VBoxManage-export.xml	(revision 82044)
@@ -0,0 +1,436 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+         manpage, user manual, usage: VBoxManage export
+
+    Copyright (C) 2006-2019 Oracle Corporation
+
+    This file is part of VirtualBox Open Source Edition (OSE), as
+    available from http://www.virtualbox.org. This file is free software;
+    you can redistribute it and/or modify it under the terms of the GNU
+    General Public License (GPL) as published by the Free Software
+    Foundation, in version 2 as it comes in the "COPYING" file of the
+    VirtualBox OSE distribution. VirtualBox OSE is distributed in the
+    hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
+ -->
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+  "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"[
+<!ENTITY % all.entities SYSTEM "all-entities.ent">
+%all.entities;
+]>
+<refentry id="vboxmanage-export" lang="en">
+  <refentryinfo>
+    <pubdate>November 2019</pubdate>
+    <title>VBoxManage export</title>
+  </refentryinfo>
+
+  <refmeta>
+    <refentrytitle>VBoxManage-export</refentrytitle>
+    <manvolnum>1</manvolnum>
+  </refmeta>
+
+  <refnamediv>
+    <refname>VBoxManage-export</refname>
+    <refpurpose>export a virtual machine to a virtual appliance or to a cloud service</refpurpose>
+    <refclass>Oracle VM VirtualBox</refclass>
+  </refnamediv>
+
+  <refsynopsisdiv>
+    <cmdsynopsis id="synopsis-vboxmanage-export-ovf">
+<!-- The 'id' is mandatory and must start with 'synopsis-'. -->
+      <command>VBoxManage export</command> 
+      <arg choice="req"><replaceable>machines</replaceable></arg>      
+      <arg choice="req">--output=<replaceable>name</replaceable></arg>
+      <group>
+        <arg choice="plain">--legacy09</arg>
+        <arg choice="plain">--ovf09</arg>
+        <arg choice="plain">--ovf10</arg>
+        <arg choice="plain">--ovf20</arg>
+        <arg choice="plain">--opc10</arg>
+      </group>
+      <arg>--manifest</arg>      
+      <arg>--iso</arg>      
+      <arg>--options=<group choice="plain">
+          <arg choice="plain">manifest</arg>
+          <arg choice="plain">iso</arg>
+          <arg choice="plain">nomacs</arg>
+          <arg choice="plain">nomacsbutnat</arg>
+        </group></arg>     
+      <arg>--vsys=<replaceable>virtual-system-number</replaceable></arg>      
+      <arg>--description=<replaceable>description-info</replaceable></arg>      
+      <arg>--eula=<replaceable>license-text</replaceable></arg>      
+      <arg>--eulafile=<replaceable>filename</replaceable></arg>     
+      <arg>--product=<replaceable>product-name</replaceable></arg>     
+      <arg>--producturl=<replaceable>product-URL</replaceable></arg>    
+      <arg>--vendor=<replaceable>vendor-name</replaceable></arg>      
+      <arg>--vendorurl=<replaceable>vendor-URL</replaceable></arg>     
+      <arg>--version=<replaceable>version-info</replaceable></arg>     
+      <arg>--vmname=<replaceable>vmname</replaceable></arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-export-cloud">
+      <command>VBoxManage export</command> 
+      <arg choice="req"><replaceable>machine</replaceable></arg>     
+      <arg choice="req">--output=<replaceable>cloud-service-provider</replaceable></arg>     
+      <arg>--vmname=<replaceable>vmname</replaceable></arg>     
+      <arg>--cloud=<replaceable>virtual-system-number</replaceable></arg>      
+      <arg>--cloudprofile=<replaceable>cloud-profile-name</replaceable></arg>     
+      <arg>--cloudshape=<replaceable>cloud-shape-name</replaceable></arg>     
+      <arg>--clouddomain=<replaceable>cloud-domain</replaceable></arg>     
+      <arg>--clouddisksize=<replaceable>disk-size-in-GB</replaceable></arg>     
+      <arg>--cloudbucket=<replaceable>bucket-name</replaceable></arg>     
+      <arg>--cloudocivcn=<replaceable>OCI-VCN-ID</replaceable></arg>     
+      <arg>--cloudocisubnet=<replaceable>OCI-subnet-ID</replaceable></arg>      
+      <arg>--cloudkeepobject=<group choice="plain">
+          <arg choice="plain">true</arg>
+          <arg choice="plain">false</arg>
+        </group></arg>     
+      <arg>--cloudlaunchinstance=<group choice="plain">
+          <arg choice="plain">true</arg>
+          <arg choice="plain">false</arg>
+        </group></arg>    
+      <arg>--cloudlaunchmode=<group choice="plain">
+          <arg choice="plain">EMULATED</arg>
+          <arg choice="plain">PARAVIRTUALIZED</arg>
+        </group></arg>     
+      <arg>--cloudpublicip=<group choice="plain">
+          <arg choice="plain">true</arg>
+          <arg choice="plain">false</arg>
+        </group></arg>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+
+  <refsect1>
+    <title>Description</title>
+    <para>
+      The <command>VBoxManage export</command> command enables you to
+      export one or more virtual machines (VMs) from &product-name;. You
+      can export the VM to one of the following:
+    </para>
+    <itemizedlist>
+      <listitem><para>
+          <emphasis role="bold">Virtual appliance in OVF
+          format.</emphasis> Includes the copying of its virtual disk
+          images to compressed VMDK.
+        </para></listitem>
+      <listitem><para>
+          <emphasis role="bold">Cloud service such as &oci;.</emphasis>
+          Exports a single VM in VMDK format.
+        </para></listitem>
+    </itemizedlist>
+    <para>
+      For more information about exporting VMs from &product-name;, see
+      <xref linkend="ovf" />
+    </para>
+    <refsect2 id="vboxmanage-export-ovf">
+      <title>Export a Virtual Machine to an OVF Virtual Appliance</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage export</command> command enables you to
+        export a VM as a virtual appliance in OVF format.
+      </para>
+      <variablelist>
+        <varlistentry>
+          <term><replaceable>machines</replaceable></term>
+          <listitem><para>
+              Specifies a comma-separated list of one or more machines
+              to export to the same OVF file.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--output=<replaceable>filename</replaceable></option></term>
+          <listitem><para>
+              Specifies the target OVF file. The file can be OVF, OVA,
+              or a ZIP file compressed with the <command>gzip</command>
+              command. Because the directory that contains the target
+              OVF file will also store the exported disk images in the
+              compressed VMDK format, ensure that this directory has
+              sufficient disk space in which to store the images.
+            </para><para>
+              The short form of this option is <option>-o</option>.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--legacy09</option></term>
+          <listitem><para>
+              Exports in OVF 0.9 legacy mode if the virtualization
+              product is not fully compatible with the OVF 1.0 standard.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--ovf09</option></term>
+          <listitem><para>
+              Exports in OVF 0.9 format.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--ovf10</option></term>
+          <listitem><para>
+              Exports in OVF 1.0 format.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--ovf20</option></term>
+          <listitem><para>
+              Exports in OVF 2.0 format.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--opc10</option></term>
+          <listitem><para>
+              Exports in &oci; format.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--manifest</option></term>
+          <listitem><para>
+              Creates a manifest of the exported files.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--iso</option></term>
+          <listitem><para>
+              Creates an ISO file.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--options=<replaceable>argument</replaceable></option></term>
+          <listitem><para>
+              Specifies information to control the exact content of the
+              appliance file. Specify one or more comma-separated
+              arguments:
+            </para><variablelist>
+              <varlistentry>
+                <term><literal>manifest</literal></term>
+                <listitem><para>
+                    Produces a manifest file that detects corrupted
+                    appliances on import.
+                  </para></listitem>
+              </varlistentry>
+              <varlistentry>
+                <term><literal>iso</literal></term>
+                <listitem><para>
+                    Exports DVD images in an ISO file.
+                  </para></listitem>
+              </varlistentry>
+              <varlistentry>
+                <term><literal>nomacs</literal></term>
+                <listitem><para>
+                    Excludes all MAC addresses.
+                  </para></listitem>
+              </varlistentry>
+              <varlistentry>
+                <term><literal>nomacsbutnat</literal></term>
+                <listitem><para>
+                    Excludes all MAC addresses except for those in a NAT
+                    network.
+                  </para></listitem>
+              </varlistentry>
+            </variablelist></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--description=<replaceable>description-info</replaceable></option></term>
+          <listitem><para>
+              Specifies a description of the VM.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--eula=<replaceable>license-text</replaceable></option></term>
+          <listitem><para>
+              Specifies end-user license text.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--eulafile=<replaceable>filename</replaceable></option></term>
+          <listitem><para>
+              Specifies an end-user license file.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--product=<replaceable>product-name</replaceable></option></term>
+          <listitem><para>
+              Specifies a product name.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--producturl=<replaceable>product-URL</replaceable></option></term>
+          <listitem><para>
+              Specifies a product URL.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--vendor=<replaceable>vendor-name</replaceable></option></term>
+          <listitem><para>
+              Specifies a vendor name.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--vendorurl=<replaceable>vendor-URL</replaceable></option></term>
+          <listitem><para>
+              Specifies a vendor URL.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--version=<replaceable>version-info</replaceable></option></term>
+          <listitem><para>
+              Specifies version information.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--vmname=<replaceable>vmname</replaceable></option></term>
+          <listitem><para>
+              Specifies the name of the exported VM.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--vsys=<replaceable>virtual-system-number</replaceable></option></term>
+          <listitem><para>
+              Specifies the number of the virtual system.
+            </para></listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+    <refsect2 id="vboxmanage-export-cloud">
+      <title>Export a Virtual Machine to &oci;</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage export</command> command enables you to
+        export a VM to a cloud service provider such as &oci;. By
+        default, the exported disk image is converted into stream VMDK
+        format. This ensures compatibility with &oci;.
+      </para>
+      <para>
+        Some of the following options are configuration settings for the
+        VM instance. As a result, specify an Oracle Cloud Identifier
+        (OCID) for a resource. Use the &oci; Console to view OCIDs.
+      </para>
+      <variablelist>
+        <varlistentry>
+          <term><option>--output=<replaceable>cloud-service-provider</replaceable></option></term>
+          <listitem><para>
+              Specifies the short name of the cloud service provider to
+              which you export the VM. For &oci;, specify
+              <literal>OCI://</literal>.
+            </para><para>
+              The short form of this option is <option>-o</option>.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--cloud=<replaceable>number-of-virtual-system</replaceable></option></term>
+          <listitem><para>
+              Specifies a number that identifies the VM to export.
+              Numbering starts at <literal>0</literal> for the first VM.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--vmname=<replaceable>vmname</replaceable></option></term>
+          <listitem><para>
+              Specifies the name of the exported VM, which is used as
+              the VM instance name in &oci;.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--cloudprofile=<replaceable>cloud-profile-name</replaceable></option></term>
+          <listitem><para>
+              Specifies the cloud profile to use to connect to the cloud
+              service provider. The cloud profile contains your &oci;
+              account details, such as your user OCID and the
+              fingerprint for your public key.
+            </para><para>
+              To use a cloud profile, you must have the required
+              permissions on &oci;.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--cloudshape=<replaceable>cloud-shape-name</replaceable></option></term>
+          <listitem><para>
+              Specifies the shape used by the VM instance. The shape
+              defines the number of CPUs and the amount of memory that
+              is allocated to the VM instance. Ensure that the shape is
+              compatible with the exported image.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--clouddomain=<replaceable>cloud-domain</replaceable></option></term>
+          <listitem><para>
+              Specifies the availability domain to use for the VM
+              instance. Enter the full name of the availability domain.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--clouddisksize=<replaceable>disk-size-in-GB</replaceable></option></term>
+          <listitem><para>
+              Specifies the amount of disk space, in gigabytes, to use
+              for the exported disk image. Valid values are from 50 GB
+              to 300 GB.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--cloudbucket=<replaceable>bucket-name</replaceable></option></term>
+          <listitem><para>
+              Specifies the bucket in which to store uploaded files. In
+              &oci;, a bucket is a logical container for storing
+              objects.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--cloudocivcn=<replaceable>OCI-VCN-ID</replaceable></option></term>
+          <listitem><para>
+              Specifies the OCID of the virtual cloud network (VCN) to
+              use for the VM instance.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--cloudocisubnet=<replaceable>OCI-subnet-ID</replaceable></option></term>
+          <listitem><para>
+              Specifies the OCID of the VCN subnet to use for the VM
+              instance.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--cloudkeepobject=true | false</option></term>
+          <listitem><para>
+              Specifies whether to store the exported disk image in
+              Oracle Object Storage.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--cloudlaunchinstance=true | false</option></term>
+          <listitem><para>
+              Specifies whether to start the VM instance after the
+              export to &oci; completes.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--cloudlaunchinstance=EMULATED | PARAVIRTUALIZED</option></term>
+          <listitem><para>
+              Specifies the launch mode used for the instance.
+              Paravirtualized mode gives improved performance.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--cloudpublicip=true | false</option></term>
+          <listitem><para>
+              Specifies whether to enable a public IP address for the VM
+              instance.
+            </para></listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+  </refsect1>
+
+  <refsect1>
+    <title>Example</title>
+    <remark role="help-scope" condition="GLOBAL"/>
+    <para>
+      The following example shows how to export the
+      <literal>myVM</literal> VM to &oci;. The command's option
+      arguments describe the configuration of the
+      <literal>myVM_Cloud</literal> VM in &oci;.
+    </para>
+<screen># VBoxManage export myVM --output=OCI:// --cloud=0 --vmname=myVM_Cloud \
+--cloudprofile="standard user" --cloudbucket=myBucket \
+--cloudshape=VM.Standard2.1 --clouddomain=US-ASHBURN-AD-1 --clouddisksize=50  \
+--cloudocivcn=ocid1.vcn.oc1.iad.aaaa... --cloudocisubnet=ocid1.subnet.oc1.iad.aaaa... \
+--cloudkeepobject=true --cloudlaunchinstance=true --cloudpublicip=true</screen>
+  </refsect1>
+</refentry>
Index: trunk/doc/manual/en_US/man_VBoxManage-getextradata.xml
===================================================================
--- trunk/doc/manual/en_US/man_VBoxManage-getextradata.xml	(revision 82044)
+++ trunk/doc/manual/en_US/man_VBoxManage-getextradata.xml	(revision 82044)
@@ -0,0 +1,141 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+    manpage, user manual, usage: VBoxManage getextradata
+
+    Copyright (C) 2006-2019 Oracle Corporation
+
+    This file is part of VirtualBox Open Source Edition (OSE), as
+    available from http://www.virtualbox.org. This file is free software;
+    you can redistribute it and/or modify it under the terms of the GNU
+    General Public License (GPL) as published by the Free Software
+    Foundation, in version 2 as it comes in the "COPYING" file of the
+    VirtualBox OSE distribution. VirtualBox OSE is distributed in the
+    hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
+ -->
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+  "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"[
+<!ENTITY % all.entities SYSTEM "all-entities.ent">
+%all.entities;
+]>
+<refentry id="vboxmanage-getextradata" lang="en">
+  <refentryinfo>
+    <pubdate>August 2019</pubdate>
+    <title>VBoxManage getextradata</title>
+  </refentryinfo>
+
+  <refmeta>
+    <refentrytitle>VBoxManage-getextradata</refentrytitle>
+    <manvolnum>1</manvolnum>
+  </refmeta>
+
+  <refnamediv>
+    <refname>VBoxManage-getextradata</refname>
+    <refpurpose>view keyword values that are associated with a virtual machine or
+      configuration</refpurpose>
+    <refclass>Oracle VM VirtualBox</refclass>
+  </refnamediv>
+
+  <refsynopsisdiv>
+    <cmdsynopsis id="synopsis-vboxmanage-getextradata">
+<!-- The 'id' is mandatory and must start with 'synopsis-'. -->
+      <command>VBoxManage getextradata</command>
+      <group choice="req">
+        <arg choice="plain">global</arg>
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <group choice="plain">
+        <arg choice="req"><replaceable>keyword</replaceable></arg>
+        <arg choice="opt">enumerate</arg>
+      </group>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+
+  <refsect1>
+    <title>Description</title>
+    <para>
+      The <command>VBoxManage getextradata</command> command enables you
+      to retrieve keyword data that is associated with a virtual machine
+      (VM) or with an &product-name; configuration.
+    </para>
+    <variablelist>
+      <varlistentry>
+        <term><literal>global</literal></term>
+        <listitem><para>
+            Specifies to retrieve information about the configuration
+            rather than a VM.
+          </para></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><replaceable>uuid</replaceable> | <replaceable>vmname</replaceable></term>
+        <listitem><para>
+            Specifies the Universally Unique Identifier (UUID) or name
+            of the VM.
+          </para></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><literal>enumerate</literal></term>
+        <listitem><para>
+            Shows all keyword values for the specified VM or
+            configuration.
+          </para></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><replaceable>keyword</replaceable></term>
+        <listitem><para>
+            Specifies the keyword for which to retrieve its value.
+          </para></listitem>
+      </varlistentry>
+    </variablelist>
+  </refsect1>
+
+  <refsect1>
+    <title>Examples</title>
+    <remark role="help-scope" condition="GLOBAL"/>
+    <para>
+      The following command retrieves the <literal>installdate</literal>
+      keyword value for the <literal>Fedora5</literal> VM:
+    </para>
+<screen>$ VBoxManage getextradata Fedora5 installdate
+VirtualBox Command Line Management Interface Version <replaceable>version-number</replaceable>
+(C) 2005-2019 Oracle Corporation
+All rights reserved.
+
+Value: 2006.01.01</screen>
+    <para>
+      The following command retrieves the information for all keywords
+      of the <literal>OracleLinux7u4</literal> VM:
+    </para>
+<screen>$ VBoxManage getextradata OracleLinux7u4 enumerate
+Key: GUI/LastCloseAction, Value: PowerOff
+Key: GUI/LastGuestSizeHint, Value: 1048,696
+Key: GUI/LastNormalWindowPosition, Value: 851,286,1048,738</screen>
+    <para>
+      The following command retrieves the information for all keywords
+      in the configuration:
+    </para>
+<screen>$ VBoxManage getextradata global enumerate
+Key: GUI/Details/Elements, Value: general,system,preview,display,storage,audio,network,usb,sharedFolders,description
+Key: GUI/DetailsPageBoxes, Value: general,system,preview,display,storage,audio,network,usb,sharedFolders,description
+Key: GUI/GroupDefinitions/, Value: m=43349dd8-2aa3-41b8-988f-0e255ce68090,m=9ebcd81e-5231-48ce-a27d-28218757f3fe,m=c690e8b1-93a0-4c95-9cd7-6437fff93251,m=f7c1e10d-3722-4891-887e-07b3c4104946
+Key: GUI/HideDescriptionForWizards, Value: NewVM
+Key: GUI/LastItemSelected, Value: m=ol7u4
+Key: GUI/LastWindowPosition, Value: 951,510,960,520
+Key: GUI/RecentFolderCD, Value: C:/Users/user1
+Key: GUI/RecentListCD, Value: C:\Users\user1\V1.iso,C:\Users\user1\V2.iso,C:\Users\user1\V3.iso
+Key: GUI/SplitterSizes, Value: 318,637
+Key: GUI/SuppressMessages, Value: remindAboutMouseIntegration,remindAboutAutoCapture
+Key: GUI/Toolbar/MachineTools/Order, Value: Details
+Key: GUI/Tools/LastItemsSelected, Value: Welcome,Details
+Key: GUI/UpdateCheckCount, Value: 71
+Key: GUI/UpdateDate, Value: 1 d, 2019-04-10, stable, 5.2.22
+Key: GUI/VirtualMediaManager/Details/Expanded, Value: true</screen>
+  </refsect1>
+
+  <refsect1>
+    <title>See Also</title>
+    <para>
+      <xref linkend="vboxmanage-setextradata" />
+    </para>
+  </refsect1>
+</refentry>
Index: trunk/doc/manual/en_US/man_VBoxManage-guestcontrol.xml
===================================================================
--- trunk/doc/manual/en_US/man_VBoxManage-guestcontrol.xml	(revision 82044)
+++ trunk/doc/manual/en_US/man_VBoxManage-guestcontrol.xml	(revision 82044)
@@ -0,0 +1,1319 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+         manpage, user manual, usage: VBoxManage guestcontrol
+
+    Copyright (C) 2006-2019 Oracle Corporation
+
+    This file is part of VirtualBox Open Source Edition (OSE), as
+    available from http://www.virtualbox.org. This file is free software;
+    you can redistribute it and/or modify it under the terms of the GNU
+    General Public License (GPL) as published by the Free Software
+    Foundation, in version 2 as it comes in the "COPYING" file of the
+    VirtualBox OSE distribution. VirtualBox OSE is distributed in the
+    hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
+ -->
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+  "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"[
+<!ENTITY % all.entities SYSTEM "all-entities.ent">
+%all.entities;
+]>
+<refentry id="vboxmanage-guestcontrol" lang="en">
+  <refentryinfo>
+    <pubdate>September 2019</pubdate>
+    <title>VBoxManage guestcontrol</title>
+  </refentryinfo>
+
+  <refmeta>
+    <refentrytitle>VBoxManage-guestcontrol</refentrytitle>
+    <manvolnum>1</manvolnum>
+  </refmeta>
+
+  <refnamediv>
+    <refname>VBoxManage-guestcontrol</refname>
+    <refpurpose>control a virtual machine from the host system</refpurpose>
+    <refclass>Oracle VM VirtualBox</refclass>
+  </refnamediv>
+
+  <refsynopsisdiv>
+    <cmdsynopsis id="synopsis-vboxmanage-guestcontrol-run">
+<!-- The 'id' is mandatory and must start with 'synopsis-'. -->
+      <command>VBoxManage guestcontrol</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg choice="plain">run</arg>
+      <arg>--domain=<replaceable>domainname</replaceable></arg>
+      <arg>--dos2unix</arg>
+      <arg>--exe=<replaceable>filename</replaceable></arg>
+      <arg>--ignore-orphaned-processes</arg>
+      <group>
+        <arg choice="plain">--no-wait-stderr</arg>
+        <arg choice="plain">--wait-stderr</arg>
+      </group>
+      <group>
+        <arg choice="plain">--no-wait-stdout</arg>
+        <arg choice="plain">--wait-stdout</arg>
+      </group>
+      <group>
+        <arg choice="plain">--passwordfile=<replaceable>password-file</replaceable></arg>
+        <arg choice="plain">--password=<replaceable>password</replaceable></arg>
+      </group>
+      <arg>--profile</arg>
+      <arg>--putenv=<replaceable>var-name</replaceable>=[<replaceable>value</replaceable>]</arg>
+      <arg>--quiet</arg>
+      <arg>--timeout=<replaceable>msec</replaceable></arg>
+      <arg>--unix2dos</arg>
+      <arg>--unquoted-args</arg>
+      <arg>--username=<replaceable>username</replaceable></arg>
+      <arg>--verbose</arg>
+      <arg choice="req">-- <replaceable>program/arg0</replaceable> <arg rep="repeat"><replaceable>argument</replaceable></arg></arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-guestcontrol-start">
+      <command>VBoxManage guestcontrol</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg choice="plain">start</arg>
+      <arg>--domain=<replaceable>domainname</replaceable></arg>
+      <arg>--exe=<replaceable>filename</replaceable></arg>
+      <arg>--ignore-orphaned-processes</arg>
+      <group>
+        <arg choice="plain">--passwordfile=<replaceable>password-file</replaceable></arg>
+        <arg choice="plain">--password=<replaceable>password</replaceable></arg>
+      </group>
+      <arg>--profile</arg>
+      <arg>--putenv=<replaceable>var-name</replaceable>=[<replaceable>value</replaceable>]</arg>
+      <arg>--quiet</arg>
+      <arg>--timeout=<replaceable>msec</replaceable></arg>
+      <arg>--unquoted-args</arg>
+      <arg>--username=<replaceable>username</replaceable></arg>
+      <arg>--verbose</arg>
+      <arg choice="req">-- <replaceable>program/arg0</replaceable> <arg rep="repeat"><replaceable>argument</replaceable></arg></arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-guestcontrol-copyfrom-hostdest">
+      <command>VBoxManage guestcontrol</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg choice="plain">copyfrom</arg>
+      <arg>--domain=<replaceable>domainname</replaceable></arg>
+      <arg>--follow</arg>
+      <group>
+        <arg choice="plain">--passwordfile=<replaceable>password-file</replaceable></arg>
+        <arg choice="plain">--password=<replaceable>password</replaceable></arg>
+      </group>
+      <arg>--quiet</arg>
+      <arg>--recursive</arg>
+      <arg>--username=<replaceable>username</replaceable></arg>
+      <arg>--verbose</arg>
+      <arg choice="req"><replaceable>guest-source0</replaceable></arg>
+      <arg choice="plain"><replaceable>guest-source1</replaceable> [...]</arg>
+      <arg choice="req"><replaceable>host-destination</replaceable></arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-guestcontrol-copyfrom-hostdestdir">
+      <command>VBoxManage guestcontrol</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg choice="plain">copyfrom</arg>
+      <arg>--domain=<replaceable>domainname</replaceable></arg>
+      <arg>--follow</arg>
+      <group>
+        <arg choice="plain">--passwordfile=<replaceable>password-file</replaceable></arg>
+        <arg choice="plain">--password=<replaceable>password</replaceable></arg>
+      </group>
+      <arg>--quiet</arg>
+      <arg>--recursive</arg>
+      <arg>--target-directory=<replaceable>host-destination-dir</replaceable></arg>
+      <arg>--username=<replaceable>username</replaceable></arg>
+      <arg>--verbose</arg>
+      <arg choice="req"><replaceable>guest-source0</replaceable></arg>
+      <arg choice="plain"><replaceable>guest-source1</replaceable> [...]</arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-guestcontrol-copyto-hostdest">
+      <command>VBoxManage guestcontrol</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg choice="plain">copyto</arg>
+      <arg>--domain=<replaceable>domainname</replaceable></arg>
+      <arg>--follow</arg>
+      <group>
+        <arg choice="plain">--passwordfile=<replaceable>password-file</replaceable></arg>
+        <arg choice="plain">--password=<replaceable>password</replaceable></arg>
+      </group>
+      <arg>--quiet</arg>
+      <arg>--recursive</arg>
+      <arg>--username=<replaceable>username</replaceable></arg>
+      <arg>--verbose</arg>
+      <arg choice="req"><replaceable>host-source0</replaceable></arg>
+      <arg choice="plain"><replaceable>host-source1</replaceable> [...]</arg>
+      <arg choice="req"><replaceable>guest-destination</replaceable></arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-guestcontrol-copyto-hostdestdir">
+      <command>VBoxManage guestcontrol</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg choice="plain">copyto</arg>
+      <arg>--domain=<replaceable>domainname</replaceable></arg>
+      <arg>--follow</arg>
+      <group>
+        <arg choice="plain">--passwordfile=<replaceable>password-file</replaceable></arg>
+        <arg choice="plain">--password=<replaceable>password</replaceable></arg>
+      </group>
+      <arg>--quiet</arg>
+      <arg>--recursive</arg>
+      <arg>--target-directory=<replaceable>guest-destination-dir</replaceable></arg>
+      <arg>--username=<replaceable>username</replaceable></arg>
+      <arg>--verbose</arg>
+      <arg choice="req"><replaceable>host-source0</replaceable></arg>
+      <arg choice="plain"><replaceable>host-source1</replaceable> [...]</arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-guestcontrol-mkdir">
+      <command>VBoxManage guestcontrol</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg choice="plain">mkdir</arg>
+      <arg>--domain=<replaceable>domainname</replaceable></arg>
+      <arg>--mode=<replaceable>mode</replaceable></arg>
+      <arg>--parents</arg>
+      <group>
+        <arg choice="plain">--passwordfile=<replaceable>password-file</replaceable></arg>
+        <arg choice="plain">--password=<replaceable>password</replaceable></arg>
+      </group>
+      <arg>--quiet</arg>
+      <arg>--username=<replaceable>username</replaceable></arg>
+      <arg>--verbose</arg>
+      <arg choice="req" rep="repeat"><replaceable>guest-directory</replaceable></arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-guestcontrol-rmdir">
+      <command>VBoxManage guestcontrol</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg choice="plain">rmdir</arg>
+      <arg>--domain=<replaceable>domainname</replaceable></arg>
+      <group>
+        <arg choice="plain">--passwordfile=<replaceable>password-file</replaceable></arg>
+        <arg choice="plain">--password=<replaceable>password</replaceable></arg>
+      </group>
+      <arg>--quiet</arg>
+      <arg>--recursive</arg>
+      <arg>--username=<replaceable>username</replaceable></arg>
+      <arg>--verbose</arg>
+      <arg choice="req" rep="repeat"><replaceable>guest-directory</replaceable></arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-guestcontrol-rm">
+      <command>VBoxManage guestcontrol</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg choice="plain">rm</arg>
+      <arg>--domain=<replaceable>domainname</replaceable></arg>
+      <arg>--force</arg>
+      <group>
+        <arg choice="plain">--passwordfile=<replaceable>password-file</replaceable></arg>
+        <arg choice="plain">--password=<replaceable>password</replaceable></arg>
+      </group>
+      <arg>--quiet</arg>
+      <arg>--username=<replaceable>username</replaceable></arg>
+      <arg>--verbose</arg>
+      <arg choice="req" rep="repeat"><replaceable>guest-directory</replaceable></arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-guestcontrol-mv">
+      <command>VBoxManage guestcontrol</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg choice="plain">mv</arg>
+      <arg>--domain=<replaceable>domainname</replaceable></arg>
+      <group>
+        <arg choice="plain">--passwordfile=<replaceable>password-file</replaceable></arg>
+        <arg choice="plain">--password=<replaceable>password</replaceable></arg>
+      </group>
+      <arg>--quiet</arg>
+      <arg>--username=<replaceable>username</replaceable></arg>
+      <arg>--verbose</arg>
+      <arg choice="req" rep="repeat"><replaceable>source</replaceable></arg>
+      <arg choice="req"><replaceable>destination-directory</replaceable></arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-guestcontrol-mktemp">
+      <command>VBoxManage guestcontrol</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg choice="plain">mktemp</arg>
+      <arg>--domain=<replaceable>domainname</replaceable></arg>
+      <arg>--mode=<replaceable>mode</replaceable></arg>
+      <group>
+        <arg choice="plain">--passwordfile=<replaceable>password-file</replaceable></arg>
+        <arg choice="plain">--password=<replaceable>password</replaceable></arg>
+      </group>
+      <arg>--quiet</arg>
+      <arg>--secure</arg>
+      <arg>--tmpdir=<replaceable>directory-name</replaceable></arg>
+      <arg>--username=<replaceable>username</replaceable></arg>
+      <arg>--verbose</arg>
+      <arg choice="req"><replaceable>template-name</replaceable></arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-guestcontrol-stat">
+      <command>VBoxManage guestcontrol</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg choice="plain">stat</arg>
+      <arg>--domain=<replaceable>domainname</replaceable></arg>
+      <group>
+        <arg choice="plain">--passwordfile=<replaceable>password-file</replaceable></arg>
+        <arg choice="plain">--password=<replaceable>password</replaceable></arg>
+      </group>
+      <arg>--quiet</arg>
+      <arg>--username=<replaceable>username</replaceable></arg>
+      <arg>--verbose</arg>
+      <arg choice="req"><replaceable>filename</replaceable></arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-guestcontrol-list">
+      <command>VBoxManage guestcontrol</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg choice="plain">list</arg>
+      <group choice="req">
+        <arg choice="plain">all</arg>
+        <arg choice="plain">files</arg>
+        <arg choice="plain">processes</arg>
+        <arg choice="plain">sessions</arg>
+      </group>
+      <arg>--quiet</arg>
+      <arg>--verbose</arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-guestcontrol-closeprocess">
+      <command>VBoxManage guestcontrol</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg choice="plain">closeprocess</arg>
+      <group>
+        <arg choice="plain">--session-id=<replaceable>ID</replaceable></arg>
+        <arg choice="plain">--session-name=<replaceable>name-or-pattern</replaceable></arg>
+      </group>
+      <arg>--quiet</arg>
+      <arg>--verbose</arg>
+      <arg choice="req" rep="repeat"><replaceable>PID</replaceable></arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-guestcontrol-closesession">
+      <command>VBoxManage guestcontrol</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg choice="plain">closesession</arg>
+      <group>
+        <arg choice="plain">--all</arg>
+        <arg choice="plain">--session-id=<replaceable>ID</replaceable></arg>
+        <arg choice="plain">--session-name=<replaceable>name-or-pattern</replaceable></arg>
+      </group>
+      <arg>--quiet</arg>
+      <arg>--verbose</arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-guestcontrol-updatega">
+      <command>VBoxManage guestcontrol</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg choice="plain">updatega</arg>
+      <arg>--quiet</arg>
+      <arg>--verbose</arg>
+      <arg>--source=<replaceable>guest-additions.ISO</replaceable></arg>
+      <arg>--wait-start</arg>
+      <arg>-- <arg rep="repeat"><replaceable>argument</replaceable></arg></arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-guestcontrol-watch">
+      <command>VBoxManage guestcontrol</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg choice="plain">watch</arg>
+      <arg>--quiet</arg>
+      <arg>--verbose</arg>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+
+  <refsect1>
+    <title>Description</title>
+    <para>
+      The <command>VBoxManage guestcontrol</command> command enables you
+      to control a guest virtual machine (VM) from the host system. See
+      <xref linkend="guestadd-guestcontrol" />.
+    </para>
+    <refsect2>
+      <title>Common Options and Operands</title>
+      <para>
+        The following options can be used by any of the
+        <command>VBoxManage guestcontrol</command> subcommands:
+      </para>
+      <variablelist>
+        <varlistentry>
+          <term><replaceable>uuid</replaceable>|<replaceable>vmname</replaceable></term>
+          <listitem><para>
+              Specifies the Universally Unique Identifier (UUID) or name
+              of the VM.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--quiet</option></term>
+          <listitem><para>
+              Specifies that the command produce quieter output.
+            </para><para>
+              The short form of this option is <option>-q</option>.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--verbose</option></term>
+          <listitem><para>
+              Specifies that the command produce more detailed output.
+            </para><para>
+              The short form of this option is <option>-v</option>.
+            </para></listitem>
+        </varlistentry>
+      </variablelist>
+      <para>
+        Some of the <command>VBoxManage guestcontrol</command>
+        subcommands require that you provide guest credentials for
+        authentication. The subcommands are:
+        <command>copyfrom</command>, <command>copyto</command>,
+        <command>mkdir</command>, <command>mktemp</command>,
+        <command>mv</command>, <command>rmdir</command>,
+        <command>rm</command>, <command>run</command>,
+        <command>start</command>, and <command>stat</command>.
+      </para>
+      <para>
+        While you cannot perform anonymous executions, a user account
+        password is optional and depends on the guest's OS security
+        policy. If a user account does not have an associated password,
+        specify an empty password. On OSes such as Windows, you might
+        need to adjust the security policy to permit user accounts with
+        an empty password. In additional, global domain rules might
+        apply and therefore cannot be changed.
+      </para>
+      <para>
+        The following options are used for authentication on the guest
+        VM:
+      </para>
+      <variablelist>
+        <varlistentry>
+          <term><option>--domain=<replaceable>domainname</replaceable></option></term>
+          <listitem><para>
+              Specifies the user domain for Windows guest VMs.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--password=<replaceable>password</replaceable></option></term>
+          <listitem><para>
+              Specifies the password for the specified user. If you do
+              not specify a password on the command line or if the
+              password file is empty, the specified user has a null
+              password.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--passwordfile=<replaceable>filename</replaceable></option></term>
+          <listitem><para>
+              Specifies the absolute path to a file on the guest OS that
+              contains the password for the specified user. If the
+              password file is empty or if you do not specify a password
+              on the command line, the specified user has a null
+              password.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--username=<replaceable>username</replaceable></option></term>
+          <listitem><para>
+              Specifies an existing user on the guest OS that runs the
+              process. If unspecified, the host user runs the process.
+            </para></listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+    <refsect2>
+      <title>Guest Process Restrictions</title>
+      <para>
+        By default, you can run up to five guest processes
+        simultaneously. If a new guest process starts and would exceed
+        this limit, the oldest not-running guest process is discarded to
+        run the new process. You cannot retrieve output from a discarded
+        guest process. If all five guest processes are active and
+        running, attempting to start a new guest process fails.
+      </para>
+      <para>
+        You can modify the guest process execution limit in two ways:
+      </para>
+      <itemizedlist>
+        <listitem><para>
+            Use the <command>VBoxManage setproperty</command> command to
+            update the
+            <literal>/VirtualBox/GuestAdd/VBoxService/--control-procs-max-kept</literal>
+            guest property value.
+          </para></listitem>
+        <listitem><para>
+            Use the <command>VBoxService</command> command and specify
+            the
+            <option>--control-procs-max-kept=<replaceable>value</replaceable></option>
+            option.
+          </para></listitem>
+      </itemizedlist>
+      <para>
+        After you change the limit, you must restart the guest OS.
+      </para>
+      <para>
+        You can serve an unlimited number guest processes by specifing a
+        value of <literal>0</literal>, however this action is not
+        recommended.
+      </para>
+    </refsect2>
+    <refsect2 id="vboxmanage-guestcontrol-run">
+      <title>Run a Command on the Guest Virtual Machine</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage guestcontrol
+        <replaceable>vmname</replaceable> run</command> command enables
+        you to execute a program on the guest VM. Standard input,
+        standard output, and standard error are redirected from the VM
+        to the host system until the program completes.
+      </para>
+      <note>
+        <para>
+          The Windows OS imposes certain limitations for graphical
+          applications. See <xref linkend="KnownIssues" />.
+        </para>
+      </note>
+      <variablelist>
+        <varlistentry>
+          <term><option>--exe=<replaceable>path-to-executable</replaceable></option></term>
+          <listitem><para>
+              Specifies the absolute path of the executable program to
+              run on the guest VM. For example:
+              <filename>C:\Windows\System32\calc.exe</filename>.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--timeout=<replaceable>msec</replaceable></option></term>
+          <listitem><para>
+              Specifies the maximum amount of time, in milliseconds,
+              that the program can run. While the program runs,
+              <command>VBoxManage</command> receives its output.
+            </para><para>
+              If you do not specify a timeout value,
+              <command>VBoxManage</command> waits indefinitely for the
+              process to end, or for an error to occur.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--putenv=<replaceable>NAME</replaceable>=[<replaceable>value</replaceable>]</option></term>
+          <listitem><para>
+              Sets, modifies, and unsets environment variables in the
+              guest VM environment.
+            </para><para>
+              When you create a guest process, it runs with the default
+              standard guest OS environment. Use this option to modify
+              environment variables in that default environment.
+            </para><para>
+              Use the
+              <option>--putenv=<replaceable>NAME</replaceable>=[<replaceable>value</replaceable>]</option>
+              option to set or modify the environment variable specified
+              by <replaceable>NAME</replaceable>.
+            </para><para>
+              Use the
+              <option>--putenv=<replaceable>NAME</replaceable>=[<replaceable>value</replaceable>]</option>
+              option to unset the environment variable specified by
+              <replaceable>NAME</replaceable>.
+            </para><para>
+              Ensure that any environment variable name or value that
+              includes spaces is enclosed by quotes.
+            </para><para>
+              Specify a <option>--putenv</option> option for each
+              environment variable that you want to modify.
+            </para><para>
+              The short form of this option is <option>-E</option>.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--unquoted-args</option></term>
+          <listitem><para>
+              Disables the escaped double quoting of arguments that you
+              pass to the program. For example,
+              <literal>\"fred\"</literal>.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--ignore-orphaned-processes</option></term>
+          <listitem><para>
+              Ignores orphaned processes. Not yet implemented.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--profile</option></term>
+          <listitem><para>
+              Uses a shell profile to specify the environment to use.
+              Not yet implemented.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--no-wait-stdout</option></term>
+          <listitem><para>
+              Does not wait for the guest process to end or receive its
+              exit code and any failure explanation.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--wait-stdout</option></term>
+          <listitem><para>
+              Waits for the guest process to end to receive its exit
+              code and any failure explanation. The
+              <command>VBoxManage</command> command receives the
+              standard output of the guest process while the process
+              runs.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--no-wait-stderr</option></term>
+          <listitem><para>
+              Does not wait for the guest process to end to receive its
+              exit code, error messages, and flags.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--wait-stderr</option></term>
+          <listitem><para>
+              Waits for the guest process to end to receive its exit
+              code, error messages, and flags. The
+              <command>VBoxManage</command> command receives the
+              standard error of the guest process while the process
+              runs.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--dos2unix</option></term>
+          <listitem><para>
+              Transform DOS or Windows guest output to UNIX or Linux
+              output. This transformation changes CR + LF line endings
+              to LF. Not yet implemented.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--unix2dos</option></term>
+          <listitem><para>
+              Transform UNIX or Linux guest output to DOS or Windows
+              output. This transformation changes LF line endings to CR
+              + LF.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>-- <replaceable>program/arg0</replaceable> [<replaceable>argument</replaceable>...]</option></term>
+          <listitem><para>
+              Specifies the name of the program and any arguments to
+              pass to the program.
+            </para><para>
+              Ensure that any command argument that includes spaces is
+              enclosed by quotes.
+            </para></listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+    <refsect2 id="vboxmanage-guestcontrol-start">
+      <title>Start a Command on the Guest Virtual Machine</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage guestcontrol
+        <replaceable>vmname</replaceable> start</command> command
+        enables you to execute a guest program until it completes.
+      </para>
+      <note>
+        <para>
+          The Windows OS imposes certain limitations for graphical
+          applications. See <xref linkend="KnownIssues" />.
+        </para>
+      </note>
+    </refsect2>
+    <refsect2 id="vboxmanage-guestcontrol-copyfrom-hostdest">
+      <title>Copy a File From the Guest Virtual Machine to the Host System</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage guestcontrol
+        <replaceable>vmname</replaceable> copyfrom</command> command
+        enables you to copy a file from the guest VM to the host system.
+      </para>
+      <variablelist>
+        <varlistentry>
+          <term><option>--follow</option></term>
+          <listitem><para>
+              Enables following of symbolic links on the guest file
+              system.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--recursive</option></term>
+          <listitem><para>
+              Recursively copies files and directories from the
+              specified directory on the guest VM.
+            </para><para>
+              The short form of this option is <option>-R</option>.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><literal><replaceable>guest-source0</replaceable> [<replaceable>guest-source1</replaceable> [...]]</literal></term>
+          <listitem><para>
+              Specifies the absolute path of one or more files to copy
+              from the guest VM. For example,
+              <filename>C:\Windows\System32\calc.exe</filename>. You can
+              use wildcards to specify multiple files. For example,
+              <filename>C:\Windows\System*\*.dll</filename>.
+            </para></listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+    <refsect2 id="vboxmanage-guestcontrol-copyfrom-hostdestdir">
+      <title>Copy a File From the Guest Virtual Machine to a Directory on the Host
+        System</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage guestcontrol
+        <replaceable>vmname</replaceable> copyfrom</command> command
+        enables you to copy a file from the guest VM to the host system.
+      </para>
+      <variablelist>
+        <varlistentry>
+          <term><option>--follow</option></term>
+          <listitem><para>
+              Enables following of symbolic links on the guest file
+              system.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--recursive</option></term>
+          <listitem><para>
+              Recursively copies files and directories from the
+              specified directory on the guest VM.
+            </para><para>
+              The short form of this option is <option>-R</option>.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--target-directory=<replaceable>host-dst-dir</replaceable></option></term>
+          <listitem><para>
+              Specifies the absolute path of the destination directory
+              on the host system. For example,
+              <filename>C:\Temp</filename>.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><literal><replaceable>guest-source0</replaceable> [<replaceable>guest-source1</replaceable> [...]]</literal></term>
+          <listitem><para>
+              Specifies the absolute path of one or more the files to
+              copy from the guest VM. For example,
+              <filename>C:\Windows\System32\calc.exe</filename>. You can
+              use wildcards to specify multiple files. For example,
+              <filename>C:\Windows\System*\*.dll</filename>.
+            </para></listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+    <refsect2 id="vboxmanage-guestcontrol-copyto-hostdest">
+      <title>Copy a File to the Guest Virtual Machine From the Host System</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage guestcontrol
+        <replaceable>vmname</replaceable> copyto</command> command
+        enables you to copy a file from the host system to the guest VM.
+      </para>
+      <variablelist>
+        <varlistentry>
+          <term><option>--follow</option></term>
+          <listitem><para>
+              Enables following of symbolic links on the host system.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--recursive</option></term>
+          <listitem><para>
+              Recursively copies files and directories from the
+              specified directory on the host system.
+            </para><para>
+              The short form of this option is <option>-R</option>.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><literal><replaceable>host-source0</replaceable> [<replaceable>host-source1</replaceable> [...]]</literal></term>
+          <listitem><para>
+              Specifies the absolute path of one or more the files to
+              copy from the host system. For example,
+              <filename>C:\Windows\System32\calc.exe</filename>. You can
+              use wildcards to specify multiple files. For example,
+              <filename>C:\Windows\System*\*.dll</filename>.
+            </para></listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+    <refsect2 id="vboxmanage-guestcontrol-copyto-hostdestdir">
+      <title>Copy a File to a Directory on the Guest Virtual Machine From the Host
+        System</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage guestcontrol
+        <replaceable>vmname</replaceable> copyto</command> command
+        enables you to copy a file from the host system to the guest VM.
+      </para>
+      <variablelist>
+        <varlistentry>
+          <term><option>--follow</option></term>
+          <listitem><para>
+              Enables following of symbolic links on the host system.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--recursive</option></term>
+          <listitem><para>
+              Recursively copies files and directories from the
+              specified directory on the host system.
+            </para><para>
+              The short form of this option is <option>-R</option>.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--target-directory=<replaceable>guest-dst-dir</replaceable></option></term>
+          <listitem><para>
+              Specifies the absolute path of the destination directory
+              on the guest VM. For example,
+              <filename>C:\Temp</filename>.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><literal><replaceable>host-source0</replaceable> [<replaceable>host-source1</replaceable> [...]]</literal></term>
+          <listitem><para>
+              Specifies the absolute path of one or more the files to
+              copy from the host system. For example,
+              <filename>C:\Windows\System32\calc.exe</filename>. You can
+              use wildcards to specify multiple files. For example,
+              <filename>C:\Windows\System*\*.dll</filename>.
+            </para></listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+    <refsect2 id="vboxmanage-guestcontrol-mkdir">
+      <title>Create a Directory on the Guest Virtual Machine</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage guestcontrol
+        <replaceable>vmname</replaceable> mkdir</command> command
+        enables you to create one or more directories on the guest VM.
+      </para>
+      <para>
+        Alternate forms of this subcommand are <command>md</command>,
+        <command>createdir</command>, and
+        <command>createdirectory</command>.
+      </para>
+      <variablelist>
+        <varlistentry>
+          <term><option>--parents</option></term>
+          <listitem><para>
+              Creates any of the missing parent directories of the
+              specified directory.
+            </para><para>
+              For example, if you attempt to create the
+              <filename>D:\Foo\Bar</filename> directory and the
+              <filename>D:\Foo</filename> directory does not exist,
+              using the <option>--parents</option> creates the missing
+              <filename>D:\Foo</filename> directory. However, if you
+              attempt to create the <filename>D:\Foo\Bar</filename> and
+              do not specify the <option>--parents</option> option, the
+              command fails.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--mode=<replaceable>mode</replaceable></option></term>
+          <listitem><para>
+              Specifies the permission mode to use for the specified
+              directory. If you specify the <option>--parents</option>
+              option, the mode is used for the associated parent
+              directories, as well. <replaceable>mode</replaceable> is a
+              four-digit octal mode such as <literal>0755</literal>.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><literal><replaceable>guest-dir</replaceable> [<replaceable>guest-dir</replaceable>...]</literal></term>
+          <listitem><para>
+              Specifies an absolute path of one or more directories to
+              create on the guest VM. For example,
+              <filename>D:\Foo\Bar</filename>.
+            </para><para>
+              If all of the associated parent directories do not exist
+              on the guest VM, you must specify the
+              <option>--parents</option> option.
+            </para><para>
+              You must have sufficient rights on the guest VM to create
+              the specified directory and its parent directories.
+            </para></listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+    <refsect2 id="vboxmanage-guestcontrol-rmdir">
+      <title>Remove a Directory From the Guest Virtual Machine</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage guestcontrol
+        <replaceable>vmname</replaceable> rmdir</command> command
+        enables you to delete the specified directory from the guest VM.
+      </para>
+      <para>
+        Alternate forms of this subcommand are
+        <command>removedir</command> and
+        <command>removedirectory</command>.
+      </para>
+      <variablelist>
+        <varlistentry>
+          <term><option>--recursive</option></term>
+          <listitem><para>
+              Recursively removes directories from the specified from
+              the guest VM.
+            </para><para>
+              The short form of this option is <option>-R</option>.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><literal><replaceable>guest-dir</replaceable> [<replaceable>guest-dir</replaceable>...]</literal></term>
+          <listitem><para>
+              Specifies an absolute path of one or more directories to
+              remove from the guest VM. You can use wildcards to specify
+              the directory names. For example,
+              <filename>D:\Foo\*Bar</filename>.
+            </para><para>
+              You must have sufficient rights on the guest VM to remove
+              the specified directory and its parent directories.
+            </para></listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+    <refsect2 id="vboxmanage-guestcontrol-rm">
+      <title>Remove a File From the Guest Virtual Machine</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage guestcontrol
+        <replaceable>vmname</replaceable> rm</command> command enables
+        you to delete the specified files from the guest VM.
+      </para>
+      <para>
+        The alternate form of this subcommand is
+        <command>removefile</command>.
+      </para>
+      <variablelist>
+        <varlistentry>
+          <term><option>--force</option></term>
+          <listitem><para>
+              Forces the operation and overrides any confirmation
+              requests.
+            </para><para>
+              The short form of this option is <option>-f</option>.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><literal><replaceable>guest-file</replaceable> [<replaceable>guest-file</replaceable>...]</literal></term>
+          <listitem><para>
+              Specifies an absolute path of one or more file to remove
+              from the guest VM. You can use wildcards to specify the
+              file names. For example,
+              <filename>D:\Foo\Bar\text*.txt</filename>.
+            </para><para>
+              You must have sufficient rights on the guest VM to remove
+              the specified file.
+            </para></listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+    <refsect2 id="vboxmanage-guestcontrol-mv">
+      <title>Rename a File or Directory on the Guest Virtual Machine</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage guestcontrol
+        <replaceable>vmname</replaceable> mv</command> command enables
+        you to rename files and directories on the guest VM.
+      </para>
+      <para>
+        Alternate forms of this subcommand are <command>move</command>,
+        <command>ren</command>, and <command>rename</command>.
+      </para>
+      <variablelist>
+        <varlistentry>
+          <term><literal><replaceable>guest-source</replaceable> [<replaceable>guest-source</replaceable>...]</literal></term>
+          <listitem><para>
+              Specifies an absolute path of a file or a single directory
+              to move or rename on the guest VM. You can use wildcards
+              to specify the file names.
+            </para><para>
+              You must have sufficient rights on the guest VM to access
+              the specified file or directory.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><replaceable>dest</replaceable></term>
+          <listitem><para>
+              Specifies the absolute path of the renamed file or
+              directory, or the destination directory to which to move
+              the files. If you move only one file,
+              <replaceable>dest</replaceable> can be a file or a
+              directory, otherwise <replaceable>dest</replaceable> must
+              be a directory.
+            </para><para>
+              You must have sufficient rights on the guest VM to access
+              the destination file or directory.
+            </para></listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+    <refsect2 id="vboxmanage-guestcontrol-mktemp">
+      <title>Create a Temporary File or Directory on the Guest Virtual Machine</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage guestcontrol
+        <replaceable>vmname</replaceable> mktemp</command> command
+        enables you to create a temporary file or temporary directory on
+        the guest VM. You can use this command to assist with the
+        subsequent copying of files from the host system to the guest
+        VM. By default, this command creates the file or directory in
+        the guest VM's platform-specific <filename>temp</filename>
+        directory.
+      </para>
+      <para>
+        Alternate forms of this subcommand are
+        <command>createtemp</command> and
+        <command>createtemporary</command>.
+      </para>
+      <variablelist>
+        <varlistentry>
+          <term><option>--directory</option></term>
+          <listitem><para>
+              Creates a temporary directory that is specified by the
+              <replaceable>template</replaceable> operand.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--secure</option></term>
+          <listitem><para>
+              Enforces secure file and directory creation by setting the
+              permission mode to <literal>0755</literal>. Any operation
+              that cannot be performed securely fails.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--mode=<replaceable>mode</replaceable></option></term>
+          <listitem><para>
+              Specifies the permission mode to use for the specified
+              directory. <replaceable>mode</replaceable> is a four-digit
+              octal mode such as <literal>0755</literal>.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--tmpdir=<replaceable>directory</replaceable></option></term>
+          <listitem><para>
+              Specifies the absolute path of the directory on the guest
+              VM in which to create the specified file or directory. If
+              unspecified, <replaceable>directory</replaceable> is the
+              platform-specific <filename>temp</filename> directory.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><replaceable>template</replaceable></term>
+          <listitem><para>
+              Specifies a template file name for the temporary file,
+              without a directory path. The template file name must
+              contain at least one sequence of three consecutive X
+              characters, or must end in X.
+            </para></listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+    <refsect2 id="vboxmanage-guestcontrol-stat">
+      <title>Show a File or File System Status on the Guest Virtual Machine</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage guestcontrol
+        <replaceable>vmname</replaceable> stat</command> command enables
+        you to show the status of files or file systems on the guest VM.
+      </para>
+      <variablelist>
+        <varlistentry>
+          <term><literal><replaceable>file</replaceable> [<replaceable>file</replaceable> ...]</literal></term>
+          <listitem><para>
+              Specifies an absolute path of a file or file system on the
+              guest VM. For example,
+              <filename>/home/foo/a.out</filename>.
+            </para><para>
+              You must have sufficient rights on the guest VM to access
+              the specified files or file systems.
+            </para></listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+    <refsect2 id="vboxmanage-guestcontrol-list">
+      <title>List the Configuration and Status Information for a Guest Virtual
+        Machine</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage guestcontrol
+        <replaceable>vmname</replaceable> list</command> command enables
+        you to list guest control configuration and status information.
+        For example, the output shows open guest sessions, guest
+        processes, and files.
+      </para>
+      <variablelist>
+        <varlistentry>
+          <term><literal>all</literal>|<literal>sessions</literal>|<literal>processes</literal>|<literal>files</literal></term>
+          <listitem><para>
+              Indicates the type of information to show.
+              <literal>all</literal> shows all available data,
+              <literal>sessions</literal> shows guest sessions,
+              <literal>processes</literal> shows processes, and
+              <literal>files</literal> shows files.
+            </para></listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+    <refsect2 id="vboxmanage-guestcontrol-closeprocess">
+      <title>Terminate a Process in a Guest Virtual Machine Session</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage guestcontrol
+        <replaceable>vmname</replaceable> closeprocess</command> command
+        enables you to terminate a guest process that runs in a guest
+        session. Specify the process by using a process identifier (PID)
+        and the session by using the session ID or name.
+      </para>
+      <variablelist>
+        <varlistentry>
+          <term><option>--session-id=<replaceable>ID</replaceable></option></term>
+          <listitem><para>
+              Specifies the ID of the guest session.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--session-name=<replaceable>name</replaceable>|<replaceable>pattern</replaceable></option></term>
+          <listitem><para>
+              Specifies the name of the guest session. Use a pattern
+              that contains wildcards to specify multiple sessions.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><literal><replaceable>PID</replaceable> [<replaceable>PID</replaceable> ...]</literal></term>
+          <listitem><para>
+              Specifies the list of PIDs of guest processes to
+              terminate.
+            </para></listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+    <refsect2 id="vboxmanage-guestcontrol-closesession">
+      <title>Close a Guest Virtual Machine Session</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage guestcontrol
+        <replaceable>vmname</replaceable> closesession</command> command
+        enables you to close a guest session. Specify the guest session
+        either by session ID or by name.
+      </para>
+      <variablelist>
+        <varlistentry>
+          <term><option>--session-id=<replaceable>ID</replaceable></option></term>
+          <listitem><para>
+              Specifies the ID of the guest session.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--session-name=<replaceable>name</replaceable>|<replaceable>pattern</replaceable></option></term>
+          <listitem><para>
+              Specifies the name of the guest session. Use a pattern
+              that contains wildcards to specify multiple sessions.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--all</option></term>
+          <listitem><para>
+              Closes all guest sessions.
+            </para></listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+    <refsect2 id="vboxmanage-guestcontrol-updatega">
+      <title>Update the Guest Additions Software on the Guest Virtual Machine</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage guestcontrol
+        <replaceable>vmname</replaceable> updatega</command> command
+        enables you to update the Guest Additions software installed in
+        the specified guest VM.
+      </para>
+      <para>
+        Alternate forms of this subcommand are
+        <command>updateadditions</command> and
+        <command>updateguestadditions</command>.
+      </para>
+      <variablelist>
+        <varlistentry>
+          <term><option>--source=<replaceable>new-iso-path</replaceable></option></term>
+          <listitem><para>
+              Specifies the absolute path of the Guest Additions update
+              <filename>.ISO</filename> file on the guest VM.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--wait-start</option></term>
+          <listitem><para>
+              Starts the <command>VBoxManage</command> update process on
+              the guest VM and then waits for the Guest Additions update
+              to begin before terminating the
+              <command>VBoxManage</command> process.
+            </para><para>
+              By default, the <command>VBoxManage</command> command
+              waits for the Guest Additions update to complete before it
+              terminates. Use this option when a running
+              <command>VBoxManage</command> process affects the
+              interaction between the installer and the guest OS.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>-- <replaceable>argument</replaceable> [<replaceable>argument</replaceable> ...]</option></term>
+          <listitem><para>
+              Specifies optional command-line arguments to pass to the
+              Guest Additions updater. You might use the
+              <option>--</option> option to pass the appropriate updater
+              arguments to retrofit features that are not yet installed.
+            </para><para>
+              Ensure that any command argument that includes spaces is
+              enclosed by quotes.
+            </para></listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+    <refsect2 id="vboxmanage-guestcontrol-watch">
+      <title>Show Current Guest Control Activity</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage guestcontrol
+        <replaceable>vmname</replaceable> watch</command> command
+        enables you to show current guest control activity.
+      </para>
+    </refsect2>
+  </refsect1>
+
+  <refsect1>
+    <title>Examples</title>
+    <remark role="help-scope" condition="GLOBAL"/>
+    <para>
+      The following <command>VBoxManage guestcontrol run</command>
+      command executes the <command>ls -l /usr</command> command on the
+      <literal>My OL VM</literal> Oracle Linux VM as the
+      <literal>user1</literal> user.
+    </para>
+<screen>
+$ VBoxManage --nologo guestcontrol "My OL VM" run --exe "/bin/ls" \
+--username user1 --passwordfile pw.txt --wait-stdout -- -l /usr
+</screen>
+    <para>
+      The <option>--exe</option> option specifies the absolute path of
+      the command to run in the guest VM, <filename>/bin/ls</filename>.
+      Use the <option>--</option> option to pass any arguments that
+      follow it to the <command>ls</command> command.
+    </para>
+    <para>
+      Use the <option>--username</option> option to specify the user
+      name, <literal>user1</literal> and use the
+      <option>--passwordfile</option> option to specify the name of a
+      file that includes the password for the <literal>user1</literal>
+      user, <filename>pw.txt</filename>.
+    </para>
+    <para>
+      The <option>--wait-stdout</option> option waits for the
+      <command>ls</command> guest process to complete before providing
+      the exit code and the command output. The
+      <option>--nologo</option> option suppresses the output of the logo
+      information.
+    </para>
+    <para>
+      The following <command>VBoxManage guestcontrol run</command>
+      command executes the <command>ipconfig</command> command on the
+      <literal>My Win VM</literal> Windows VM as the
+      <literal>user1</literal> user. Standard input, standard output,
+      and standard error are redirected from the VM to the host system
+      until the program completes.
+    </para>
+<screen>
+$ VBoxManage --nologo guestcontrol "My Win VM" run \
+--exe "c:\\windows\\system32\\ipconfig.exe" \
+--username user1 --passwordfile pw.txt --wait-stdout
+</screen>
+    <para>
+      The <option>--exe</option> specifies the absolute path of command
+      to run in the guest VM,
+      <filename>c:\windows\system32\ipconfig.exe</filename>. The double
+      backslashes shown in this example are required only on UNIX host
+      systems.
+    </para>
+    <para>
+      Use the <option>--username</option> option to specify the user
+      name, <literal>user1</literal> and use the
+      <option>--passwordfile</option> option to specify the name of a
+      file that includes the password for the <literal>user1</literal>
+      user, <filename>pw.txt</filename>.
+    </para>
+    <para>
+      The <option>--wait-stdout</option> option waits for the
+      <command>ls</command> guest process to complete before providing
+      the exit code and the command output. The
+      <option>--nologo</option> option to suppress the output of the
+      logo information.
+    </para>
+    <para>
+      The following <command>VBoxManage guestcontrol start</command>
+      command executes the <command>ls -l /usr</command> command on the
+      <literal>My OL VM</literal> Oracle Linux VM until the program
+      completes.
+    </para>
+<screen>
+$ VBoxManage --nologo guestcontrol "My Win VM" start \
+--exe "c:\\windows\\system32\\ipconfig.exe" \
+--username user1 --passwordfile pw.txt --wait-stdout
+</screen>
+  </refsect1>
+</refentry>
Index: trunk/doc/manual/en_US/man_VBoxManage-guestproperty.xml
===================================================================
--- trunk/doc/manual/en_US/man_VBoxManage-guestproperty.xml	(revision 82044)
+++ trunk/doc/manual/en_US/man_VBoxManage-guestproperty.xml	(revision 82044)
@@ -0,0 +1,325 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+    manpage, user manual, usage: VBoxManage guestproperty
+
+    Copyright (C) 2006-2019 Oracle Corporation
+
+    This file is part of VirtualBox Open Source Edition (OSE), as
+    available from http://www.virtualbox.org. This file is free software;
+    you can redistribute it and/or modify it under the terms of the GNU
+    General Public License (GPL) as published by the Free Software
+    Foundation, in version 2 as it comes in the "COPYING" file of the
+    VirtualBox OSE distribution. VirtualBox OSE is distributed in the
+    hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
+ -->
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+  "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"[
+<!ENTITY % all.entities SYSTEM "all-entities.ent">
+%all.entities;
+]>
+<refentry id="vboxmanage-guestproperty" lang="en">
+  <refentryinfo>
+    <pubdate>September 2019</pubdate>
+    <title>VBoxManage guestproperty</title>
+  </refentryinfo>
+
+  <refmeta>
+    <refentrytitle>VBoxManage-guestproperty</refentrytitle>
+    <manvolnum>1</manvolnum>
+  </refmeta>
+
+  <refnamediv>
+    <refname>VBoxManage-guestproperty</refname>
+    <refpurpose>manage virtual machine guest properties</refpurpose>
+    <refclass>Oracle VM VirtualBox</refclass>
+  </refnamediv>
+
+  <refsynopsisdiv>
+<!-- The 'id' is mandatory and must start with 'synopsis-'. -->
+    <cmdsynopsis id="synopsis-vboxmanage-guestproperty-get">
+      <command>VBoxManage guestproperty get</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg choice="req"><replaceable>property-name</replaceable></arg>
+      <arg>--verbose</arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-guestproperty-enumerate">
+      <command>VBoxManage guestproperty enumerate</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg>--patterns=<replaceable>patterns</replaceable></arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-guestproperty-set">
+      <command>VBoxManage guestproperty set</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg choice="req"><replaceable>property-name</replaceable></arg>
+      <arg><replaceable>property-value</replaceable><arg>--flags=<replaceable>flags</replaceable></arg></arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-guestproperty-unset">
+      <command>VBoxManage guestproperty unset</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg choice="req"><replaceable>property-name</replaceable></arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-guestproperty-wait">
+      <command>VBoxManage guestproperty wait</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg choice="req"><replaceable>patterns</replaceable></arg>
+      <arg>--timeout=<replaceable>msec</replaceable></arg>
+      <arg>--fail-on-timeout</arg>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+
+  <refsect1>
+    <title>Description</title>
+    <para>
+      The <command>VBoxManage guestproperty</command> command enables
+      you to set or retrieve the properties of a running virtual machine
+      (VM). See <xref linkend="guestadd-guestprops" />. Guest properties
+      are arbitrary name-value string pairs that can be written to and
+      read from by either the guest or the host. As a result, these
+      properties can be used as a low-volume communication channel for
+      strings provided that a guest is running and has the Guest
+      Additions installed. In addition, the Guest Additions
+      automatically set and maintain values whose keywords begin with
+      <literal>/VirtualBox/</literal>.
+    </para>
+    <refsect2>
+      <title>General Command Operand</title>
+      <variablelist>
+        <varlistentry>
+          <term><replaceable>uuid</replaceable>|<replaceable>vmname</replaceable></term>
+          <listitem><para>
+              Specifies the Universally Unique Identifier (UUID) or name
+              of the VM.
+            </para></listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+    <refsect2 id="vboxmanage-guestproperty-enumerate">
+      <title>List All Properties for a Virtual Machine</title>
+      <para>
+        The <command>VBoxManage guestproperty enumerate</command>
+        command lists each guest property and value for the specified
+        VM. Note that the output is limited if the guest's service
+        process cannot be contacted, for example because the VM is not
+        running or because the Guest Additions are not installed.
+      </para>
+      <variablelist>
+        <varlistentry>
+          <term><option>--patterns=<replaceable>pattern</replaceable></option></term>
+          <listitem><para>
+              Filters the list of properties based on the specified
+              pattern, which can contain the following wildcard
+              characters:
+            </para><variablelist>
+              <varlistentry>
+                <term><literal>*</literal> (asterisk)</term>
+                <listitem><para>
+                    Represents any number of characters. For example,
+                    the <literal>/VirtualBox*</literal> pattern matches
+                    all properties that begin with
+                    <literal>/VirtualBox</literal>.
+                  </para></listitem>
+              </varlistentry>
+              <varlistentry>
+                <term><literal>?</literal> (question mark)</term>
+                <listitem><para>
+                    Represents a single arbitrary character. For
+                    example, the <literal>fo?</literal> pattern matches
+                    both <literal>foo</literal> and
+                    <literal>for</literal>.
+                  </para></listitem>
+              </varlistentry>
+              <varlistentry>
+                <term><literal>|</literal> (pipe)</term>
+                <listitem><para>
+                    Specifies multiple alternative patterns. For
+                    example, the <literal>s*|t*</literal> pattern
+                    matches any property that begins with
+                    <literal>s</literal> or <literal>t</literal>.
+                  </para></listitem>
+              </varlistentry>
+            </variablelist></listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+    <refsect2 id="vboxmanage-guestproperty-get">
+      <title>Retrieve a Property Value for a Virtual Machine</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage guestproperty get</command> command
+        retrieves the value of the specified property. If the property
+        cannot be found, for example because the guest is not running,
+        the command issues the following message:
+      </para>
+<screen>No value set!</screen>
+      <variablelist>
+        <varlistentry>
+          <term><replaceable>property-name</replaceable></term>
+          <listitem><para>
+              Specifies the name of the property.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--verbose</option></term>
+          <listitem><para>
+              Provides the property value, timestamp, and any specified
+              value attributes.
+            </para></listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+    <refsect2 id="vboxmanage-guestproperty-set">
+      <title>Set a Property Value for a Virtual Machine</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage guestproperty set</command> command
+        enables you to set a guest property by specifying the property
+        and its value. If you omit the value, the property is deleted.
+      </para>
+      <variablelist>
+        <varlistentry>
+          <term><replaceable>property-name</replaceable></term>
+          <listitem><para>
+              Specifies the name of the property.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><replaceable>property-value</replaceable></term>
+          <listitem><para>
+              Specifies the value of the property. If no value is
+              specified, any existing value is removed.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--flags=<replaceable>flags</replaceable></option></term>
+          <listitem><para>
+              Specify the additional attributes of the value. The
+              following attributes can be specified as a comma-separated
+              list:
+            </para><variablelist>
+              <varlistentry>
+                <term><literal>TRANSIENT</literal></term>
+                <listitem><para>
+                    Removes the value with the VM data when the VM
+                    exits.
+                  </para></listitem>
+              </varlistentry>
+              <varlistentry>
+                <term><literal>TRANSRESET</literal></term>
+                <listitem><para>
+                    Removes the value when the VM restarts or exits.
+                  </para></listitem>
+              </varlistentry>
+              <varlistentry>
+                <term><literal>RDONLYGUEST</literal></term>
+                <listitem><para>
+                    Specifies that the value can be changed only by the
+                    host and that the guest can read the value.
+                  </para></listitem>
+              </varlistentry>
+              <varlistentry>
+                <term><literal>RDONLYHOST</literal></term>
+                <listitem><para>
+                    Specifies that the value can be changed only by the
+                    guest and that the host can read the value.
+                  </para></listitem>
+              </varlistentry>
+              <varlistentry>
+                <term><literal>READONLY</literal></term>
+                <listitem><para>
+                    Specifies that the value cannot be changed.
+                  </para></listitem>
+              </varlistentry>
+            </variablelist></listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+    <refsect2 id="vboxmanage-guestproperty-wait">
+      <title>Wait for a Property Value to Be Created, Deleted, or Changed</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage guestproperty wait</command> command
+        waits for a particular value that is described by the pattern
+        string to change, to be deleted, or to be created.
+      </para>
+      <variablelist>
+        <varlistentry>
+          <term><replaceable>patterns</replaceable></term>
+          <listitem><para>
+              Specifies a pattern that matches the properties on which
+              you want to wait. For information about the pattern
+              wildcards, see the description of the
+              <option>--patterns</option> option.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--timeout<replaceable>msec</replaceable></option></term>
+          <listitem><para>
+              Specifies the number of microseconds to wait.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--fail-on-timeout</option></term>
+          <listitem><para>
+              Specifies that the command fails if the timeout is
+              reached.
+            </para></listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+    <refsect2 id="vboxmanage-guestproperty-unset">
+      <title>Unset a Virtual Machine Property Value</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage guestproperty unset</command> command
+        unsets the value of a guest property.
+      </para>
+      <para>
+        The alternate form of this subcommand is
+        <command>delete</command>.
+      </para>
+      <variablelist>
+        <varlistentry>
+          <term><replaceable>property-name</replaceable></term>
+          <listitem><para>
+              Specifies the name of the property.
+            </para></listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+  </refsect1>
+
+  <refsect1>
+    <title>Examples</title>
+    <remark role="help-scope" condition="GLOBAL" />
+    <para>
+      The following command lists the guest properties and their values
+      for the <literal>win8</literal> VM.
+    </para>
+<screen>$ VBoxManage guestproperty enumerate win8</screen>
+    <para>
+      The following command creates a guest property called
+      <literal>region</literal> for the <literal>win8</literal> VM. The
+      value of the property is set to <literal>west</literal>.
+    </para>
+<screen>$ VBoxManage guestproperty set win8 region west</screen>
+  </refsect1>
+</refentry>
Index: trunk/doc/manual/en_US/man_VBoxManage-hostonlyif.xml
===================================================================
--- trunk/doc/manual/en_US/man_VBoxManage-hostonlyif.xml	(revision 82044)
+++ trunk/doc/manual/en_US/man_VBoxManage-hostonlyif.xml	(revision 82044)
@@ -0,0 +1,190 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+    manpage, user manual, usage: VBoxManage hostonlyif
+
+    Copyright (C) 2006-2019 Oracle Corporation
+
+    This file is part of VirtualBox Open Source Edition (OSE), as
+    available from http://www.virtualbox.org. This file is free software;
+    you can redistribute it and/or modify it under the terms of the GNU
+    General Public License (GPL) as published by the Free Software
+    Foundation, in version 2 as it comes in the "COPYING" file of the
+    VirtualBox OSE distribution. VirtualBox OSE is distributed in the
+    hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
+ -->
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+  "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"[
+<!ENTITY % all.entities SYSTEM "all-entities.ent">
+%all.entities;
+]>
+<refentry id="vboxmanage-hostonlyif" lang="en">
+  <refentryinfo>
+    <pubdate>September 2019</pubdate>
+    <title>VBoxManage hostonlyif</title>
+  </refentryinfo>
+
+  <refmeta>
+    <refentrytitle>VBoxManage-hostonlyif</refentrytitle>
+    <manvolnum>1</manvolnum>
+  </refmeta>
+
+  <refnamediv>
+    <refname>VBoxManage-hostonlyif</refname>
+    <refpurpose>manage host-only network interfaces</refpurpose>
+    <refclass>Oracle VM VirtualBox</refclass>
+  </refnamediv>
+
+  <refsynopsisdiv>
+<!-- The 'id' is mandatory and must start with 'synopsis-'. -->
+    <cmdsynopsis id="synopsis-vboxmanage-hostonlyif-ipconfig">
+      <command>VBoxManage hostonlyif ipconfig</command> 
+      <arg choice="req"><replaceable>ifname</replaceable></arg>
+      <group>
+        <arg choice="plain">--dhcp</arg>
+        <arg choice="plain">--ip=<replaceable>IPv4-address</replaceable> <arg>--netmask=<replaceable>IPv4-netmask</replaceable></arg></arg>
+        <arg choice="plain">--ipv6=<replaceable>IPv6-address</replaceable> <arg>--netmasklengthv6=<replaceable>length</replaceable></arg></arg>
+      </group>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-hostonlyif-create">
+      <command>VBoxManage hostonlyif create</command>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-hostonlyif-remove">
+      <command>VBoxManage hostonlyif remove</command> 
+      <arg choice="req"><replaceable>ifname</replaceable></arg>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+
+  <refsect1>
+    <title>Description</title>
+    <para>
+      The <command>VBoxManage hostonlyif</command> command enables you
+      to change the IP configuration of a host-only network interface.
+      For a description of host-only networking, see
+      <xref linkend="network_hostonly" />. Each host-only network
+      interface is identified by a name and can either use the internal
+      DHCP server or a manual IP configuration, both IPv4 and IPv6.
+    </para>
+    <refsect2 id="vboxmanage-hostonlyif-ipconfig">
+      <title>Configure a Host-Only Interface</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage hostonlyif ipconfig</command> command
+        configures a host-only interface.
+      </para>
+      <variablelist>
+        <varlistentry>
+          <term><replaceable>ifname</replaceable></term>
+          <listitem><para>
+              Specifies the name of the network interface. The name is
+              of the form
+              <literal>vboxnet</literal><replaceable>N</replaceable>
+              where <replaceable>N</replaceable> is the interface
+              instance.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--dhcp</option></term>
+          <listitem><para>
+              Uses DHCP for the network interface.
+            </para><para>
+              You cannot use this option with the <option>--ip</option>,
+              <option>--ipv6</option>, <option>--netmask</option>, and
+              <option>--netmasklengthv6</option> options.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--ip=<replaceable>IPv4-address</replaceable></option></term>
+          <listitem><para>
+              Specifies the IPv4 IP address for the network interface.
+            </para><para>
+              You cannot use this option with the
+              <option>--dhcp</option>, <option>--ipv6</option>, and
+              <option>--netmasklengthv6</option> options.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--netmask=<replaceable>IPv4-netmask</replaceable></option></term>
+          <listitem><para>
+              Specifies the IPv4 netmask of the network interface. The
+              default value is <literal>255.255.255.0</literal>.
+            </para><para>
+              You can use this option only with the
+              <option>--ip</option> option.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--ipv6=<replaceable>IPv6-address</replaceable></option></term>
+          <listitem><para>
+              Specifies the IPv6 IP address for the network interface.
+            </para><para>
+              You cannot use this option with the
+              <option>--dhcp</option>, <option>--ip</option>, and
+              <option>--netmask</option> options.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--netmasklengthv6=<replaceable>length</replaceable></option></term>
+          <listitem><para>
+              Specifies the length of the IPv6 network interface. The
+              default value is <literal>64</literal>.
+            </para><para>
+              You can use this option only with the
+              <option>--ipv6</option> option.
+            </para></listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+    <refsect2 id="vboxmanage-hostonlyif-create">
+      <title>Create a Network Interface on the Host System</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage hostonlyif create</command> command
+        creates a new host-only network interface on the host operating
+        system (OS). The network interface name is of the form
+        <literal>vboxnet</literal><replaceable>N</replaceable> where
+        <replaceable>N</replaceable> is the interface instance. You must
+        run this command before you can attach virtual machines (VMs) to
+        the host-only network.
+      </para>
+    </refsect2>
+    <refsect2 id="vboxmanage-hostonlyif-remove">
+      <title>Remove a Network Interface From the Host System</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage hostonlyif remove</command> command
+        removes the specified host-only network interface from the host
+        OS.
+      </para>
+      <variablelist>
+        <varlistentry>
+          <term><replaceable>ifname</replaceable></term>
+          <listitem><para>
+              Specifies the name of the network interface. The name is
+              of the form
+              <literal>vboxnet</literal><replaceable>N</replaceable>
+              where <replaceable>N</replaceable> is the interface
+              instance.
+            </para></listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+  </refsect1>
+
+  <refsect1>
+    <title>Examples</title>
+    <remark role="help-scope" condition="GLOBAL" />
+    <para>
+      The following command creates a new host-only network interface.
+    </para>
+<screen>$ VBoxManage hostonlyif create
+0%...10%...20%...30%...40%...50%...60%...70%...80%...90%...100%
+Interface 'vboxnet2' was successfully created</screen>
+    <para>
+      The following command configures the IPv4 address for the
+      <literal>vboxnet2</literal> host-only network interface.
+    </para>
+<screen>$ VBoxManage hostonlyif ipconfig vboxnet2 --ip 10.0.2.18</screen>
+  </refsect1>
+</refentry>
Index: trunk/doc/manual/en_US/man_VBoxManage-import.xml
===================================================================
--- trunk/doc/manual/en_US/man_VBoxManage-import.xml	(revision 82044)
+++ trunk/doc/manual/en_US/man_VBoxManage-import.xml	(revision 82044)
@@ -0,0 +1,218 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+         manpage, user manual, usage: VBoxManage import
+
+    Copyright (C) 2006-2019 Oracle Corporation
+
+    This file is part of VirtualBox Open Source Edition (OSE), as
+    available from http://www.virtualbox.org. This file is free software;
+    you can redistribute it and/or modify it under the terms of the GNU
+    General Public License (GPL) as published by the Free Software
+    Foundation, in version 2 as it comes in the "COPYING" file of the
+    VirtualBox OSE distribution. VirtualBox OSE is distributed in the
+    hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
+ -->
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+  "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"[
+<!ENTITY % all.entities SYSTEM "all-entities.ent">
+%all.entities;
+]>
+<refentry id="vboxmanage-import" lang="en">
+  <refentryinfo>
+    <pubdate>August 2019</pubdate>
+    <title>VBoxManage import</title>
+  </refentryinfo>
+
+  <refmeta>
+    <refentrytitle>VBoxManage-import</refentrytitle>
+    <manvolnum>1</manvolnum>
+  </refmeta>
+
+  <refnamediv>
+    <refname>VBoxManage-import</refname>
+    <refpurpose>import a virtual appliance in OVF format and create virtual machines</refpurpose>
+    <refclass>Oracle VM VirtualBox</refclass>
+  </refnamediv>
+
+  <refsynopsisdiv>
+    <cmdsynopsis id="synopsis-vboxmanage-import">
+<!-- The 'id' is mandatory and must start with 'synopsis-'. -->
+      <command>VBoxManage import</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>ovfname</replaceable></arg>
+        <arg choice="plain"><replaceable>ovaname</replaceable></arg>
+      </group>
+      <arg>--dry-run</arg>
+      <arg>--options=<group choice="plain">
+          <arg choice="plain">keepallmacs</arg>
+          <arg choice="plain">keepnatmacs</arg>
+          <arg choice="plain">keepdisknames</arg>
+          <arg choice="plain">importtovdi</arg>
+        </group></arg>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+
+  <refsect1>
+    <title>Description</title>
+    <para>
+      The <command>VBoxManage import</command> command imports a virtual
+      appliance in OVF or OVA format by copying virtual disk images and
+      by creating virtual machines (VMs) in &product-name;. See
+      <xref linkend="ovf" />.
+    </para>
+    <para>
+      You must specify the path name of an OVF file or OVA archive to
+      use as input. Also, ensure that any disk images are in the same
+      directory as the OVF file or OVA archive.
+    </para>
+    <para>
+      Note that any options you specify to control the imported virtual
+      appliance or to modify the import parameters rely on the contents
+      of the OVF file.
+    </para>
+    <para>
+      Before you use the import operation to create the VM, perform a
+      dry run to verify the correctness of your configuration.
+    </para>
+    <refsect2>
+      <title>Common Options</title>
+      <variablelist>
+        <varlistentry>
+          <term><replaceable>ovfname</replaceable> | <replaceable>ovaname</replaceable></term>
+          <listitem><para>
+              Specifies the name of the OVF file or OVA archive that
+              describes the appliance.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--dry-run</option></term>
+          <listitem><para>
+              Performs a dry run of the <command>VBoxManage
+              import</command> command before you perform the actual
+              import operation. A dry run operation does the following:
+            </para><itemizedlist>
+              <listitem><para>
+                  Outputs a description of the appliance's contents
+                  based on the specified OVF or OVA file.
+                </para></listitem>
+              <listitem><para>
+                  Shows how the appliance would be imported into
+                  &product-name;. In addition, the output shows any
+                  options that you can use to change the import
+                  behavior.
+                </para></listitem>
+            </itemizedlist><para>
+              The shortened form of this option is <option>-n</option>.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--options keepallmacs | keepnatmacs | keepdisknames | importtovdi</option></term>
+          <listitem><para>
+              Enables you to fine tune the import operation.
+            </para><para>
+              Valid arguments are as follows:
+            </para><itemizedlist>
+              <listitem><para>
+                  <literal>keepallmacs</literal>: Specifies that the MAC
+                  addresses of every virtual network card are left
+                  unchanged.
+                </para></listitem>
+              <listitem><para>
+                  <literal>keepnatmacs</literal>: Specifies that the MAC
+                  addresses of every virtual network card are left
+                  unchanged if the network type is NAT.
+                </para></listitem>
+              <listitem><para>
+                  <literal>keepdisknames</literal>: Specifies that all
+                  new disk images are assigned the same names as the
+                  originals.
+                </para></listitem>
+              <listitem><para>
+                  <literal>importtovdi</literal>: Specifies that all new
+                  disk images are in VDI file format.
+                </para></listitem>
+            </itemizedlist></listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+  </refsect1>
+
+  <refsect1>
+    <title>Examples</title>
+    <remark role="help-scope" condition="GLOBAL"/>
+    <para>
+      The following example performs the dry run of an import operation
+      for a sample appliance that contains a Windows 10 guest:
+    </para>
+<screen>$ VBoxManage import Windows10.ovf --dry-run
+Interpreting Windows10.ovf...
+OK.
+Virtual system 0:
+ 0: Suggested OS type: "Windows10_64"
+    (change with "--vsys 0 --ostype &lt;type&gt;"; use "list ostypes" to list all)
+ 1: Suggested VM name "win10-appliance"
+    (change with "--vsys 0 --vmname &lt;name&gt;")
+ 2: Suggested VM group "/"
+    (change with "--vsys 0 --group &lt;group&gt;")
+ 3: Suggested VM settings file name "/home/user1/VirtualBox VMs/win10-appliance/win10-appliance.vbox"
+    (change with "--vsys 0 --settingsfile &lt;filename&gt;")
+ 4: Suggested VM base folder "/home/user1/VirtualBox VMs"
+    (change with "--vsys 0 --basefolder &lt;path&gt;")
+ 5: End-user license agreement
+    (display with "--vsys 0 --eula show";
+    accept with "--vsys 0 --eula accept")
+ 6: Number of CPUs: 1
+    (change with "--vsys 0 --cpus &lt;n&gt;")
+ 7: Guest memory: 1024 MB (change with "--vsys 0 --memory &lt;MB&gt;")
+ 8: Sound card (appliance expects "ensoniq1371", can change on import)
+    (disable with "--vsys 0 --unit 5 --ignore")
+ 9: USB controller
+    (disable with "--vsys 0 --unit 6 --ignore")
+10: Network adapter: orig bridged, config 2, extra type=bridged
+11: Floppy
+    (disable with "--vsys 0 --unit 8 --ignore")
+12: SCSI controller, type BusLogic
+    (change with "--vsys 0 --unit 9 --scsitype {BusLogic|LsiLogic}";
+    disable with "--vsys 0 --unit 9 --ignore")
+13: IDE controller, type PIIX4
+    (disable with "--vsys 0 --unit 10 --ignore")
+14: Hard disk image: source image=Windows10.vmdk,
+      target path=/home/user1/disks/Windows10.vmdk, controller=9;channel=0
+    (change controller with "--vsys 0 --unit 11 --controller &lt;id&gt;";
+    disable with "--vsys 0 --unit 11 --ignore")</screen>
+    <para>
+      The dry run output lists and numbers the individual configuration
+      items that are described in the <filename>Windows10.ovf</filename>
+      file. Some of the items include information about how to disable
+      or change the configuration of the item.
+    </para>
+    <para>
+      You can disable many of the items by using the <option>--vsys
+      <replaceable>X</replaceable> --unit <replaceable>Y</replaceable>
+      --ignore</option> options. <replaceable>X</replaceable> is the
+      number of the virtual system. The value is <literal>0</literal>
+      unless the appliance includes several virtual system descriptions.
+      <replaceable>Y</replaceable> is the configuration item number.
+    </para>
+    <para>
+      Item 1 in the example command output specifies the name of the
+      target machine. Items 12 and 13 specify the IDE and SCSI hard disk
+      controllers, respectively.
+    </para>
+    <para>
+      Item 14 indicates the hard disk image and the
+      <option>--controller</option> option specifies the device on which
+      the image resides. The default value is specified in the OVF file.
+    </para>
+    <para>
+      You can combine several items for the same virtual system by
+      specifying the same value for the <option>--vsys</option> option.
+      For example use the following command to import a machine as
+      described in the OVF, exclude the sound card and USB controller
+      and specify that the disk image is connected to the IDE controller
+      instead of the SCSI controller.
+    </para>
+<screen>$ VBoxManage import Windows10.ovf --vsys 0 --unit 8 --ignore \
+  --unit 9 --ignore --unit 14 --controller 13</screen>
+  </refsect1>
+</refentry>
Index: trunk/doc/manual/en_US/man_VBoxManage-list.xml
===================================================================
--- trunk/doc/manual/en_US/man_VBoxManage-list.xml	(revision 82044)
+++ trunk/doc/manual/en_US/man_VBoxManage-list.xml	(revision 82044)
@@ -0,0 +1,523 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+    manpage, user manual, usage: VBoxManage list
+
+    Copyright (C) 2006-2019 Oracle Corporation
+
+    This file is part of VirtualBox Open Source Edition (OSE), as
+    available from http://www.virtualbox.org. This file is free software;
+    you can redistribute it and/or modify it under the terms of the GNU
+    General Public License (GPL) as published by the Free Software
+    Foundation, in version 2 as it comes in the "COPYING" file of the
+    VirtualBox OSE distribution. VirtualBox OSE is distributed in the
+    hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
+ -->
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+  "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"[
+<!ENTITY % all.entities SYSTEM "all-entities.ent">
+%all.entities;
+]>
+<refentry id="vboxmanage-list" lang="en">
+  <refentryinfo>
+    <pubdate>September 2019</pubdate>
+    <title>VBoxManage list</title>
+  </refentryinfo>
+
+  <refmeta>
+    <refentrytitle>VBoxManage-list</refentrytitle>
+    <manvolnum>1</manvolnum>
+  </refmeta>
+
+  <refnamediv>
+    <refname>VBoxManage-list</refname>
+    <refpurpose>view system information and VM configuration details</refpurpose>
+    <refclass>Oracle VM VirtualBox</refclass>
+  </refnamediv>
+
+  <refsynopsisdiv>
+    <cmdsynopsis id="synopsis-vboxmanage-list-bridgedifs">
+<!-- The 'id' is mandatory and must start with 'synopsis-'. -->
+      <command>VBoxManage list</command> 
+      <arg>--long</arg>
+      <arg>--sorted</arg>
+      <arg choice="plain">bridgedifs</arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-list-cloudprofiles">
+      <command>VBoxManage list</command> 
+      <arg>--long</arg>
+      <arg>--sorted</arg>
+      <arg choice="plain">cloudprofiles</arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-list-cloudproviders">
+      <command>VBoxManage list</command> 
+      <arg>--long</arg>
+      <arg>--sorted</arg>
+      <arg choice="plain">cloudproviders</arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-list-dhcpservers">
+      <command>VBoxManage list</command> 
+      <arg>--long</arg>
+      <arg>--sorted</arg>
+      <arg choice="plain">dhcpservers</arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-list-dvds">
+      <command>VBoxManage list</command> 
+      <arg>--long</arg>
+      <arg>--sorted</arg>
+      <arg choice="plain">dvds</arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-list-extpacks">
+      <command>VBoxManage list</command> 
+      <arg>--long</arg>
+      <arg>--sorted</arg>
+      <arg choice="plain">extpacks</arg>
+    </cmdsynopsis>
+    <cmdsynopsis id="synopsis-vboxmanage-list-floppies">
+      <command>VBoxManage list</command> 
+      <arg>--long</arg>
+      <arg>--sorted</arg>
+      <arg choice="plain">floppies</arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-list-groups">
+      <command>VBoxManage list</command> 
+      <arg>--long</arg>
+      <arg>--sorted</arg>
+      <arg choice="plain">groups</arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-list-hddbackends">
+      <command>VBoxManage list</command> 
+      <arg>--long</arg>
+      <arg>--sorted</arg>
+      <arg choice="plain">hddbackends</arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-list-hdds">
+      <command>VBoxManage list</command> 
+      <arg>--long</arg>
+      <arg>--sorted</arg>
+      <arg choice="plain">hdds</arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-list-hostcpuids">
+      <command>VBoxManage list</command> 
+      <arg>--long</arg>
+      <arg>--sorted</arg>
+      <arg choice="plain">hostcpuids</arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-list-hostdvds">
+      <command>VBoxManage list</command> 
+      <arg>--long</arg>
+      <arg>--sorted</arg>
+      <arg choice="plain">hostdvds</arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-list-hostfloppies">
+      <command>VBoxManage list</command> 
+      <arg>--long</arg>
+      <arg>--sorted</arg>
+      <arg choice="plain">hostfloppies</arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-list-hostinfo">
+      <command>VBoxManage list</command> 
+      <arg>--long</arg>
+      <arg>--sorted</arg>
+      <arg choice="plain">hostinfo</arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-list-hostonlyifs">
+      <command>VBoxManage list</command> 
+      <arg>--long</arg>
+      <arg>--sorted</arg>
+      <arg choice="plain">hostonlyifs</arg>
+    </cmdsynopsis>
+    
+    <cmdsynopsis id="synopsis-vboxmanage-list-intnets">
+      <command>VBoxManage list</command> 
+      <arg>--long</arg>
+      <arg>--sorted</arg>
+      <arg choice="plain">intnets</arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-list-natnets">
+      <command>VBoxManage list</command> 
+      <arg>--long</arg>
+      <arg>--sorted</arg>
+      <arg choice="plain">natnets</arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-list-ostypes">
+      <command>VBoxManage list</command> 
+      <arg>--long</arg>
+      <arg>--sorted</arg>
+      <arg choice="plain">ostypes</arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-list-runningvms">
+      <command>VBoxManage list</command> 
+      <arg>--long</arg>
+      <arg>--sorted</arg>
+      <arg choice="plain">runningvms</arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-list-screenshotformats">
+      <command>VBoxManage list</command> 
+      <arg>--long</arg>
+      <arg>--sorted</arg>
+      <arg choice="plain">screenshotformats</arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-list-systemproperties">
+      <command>VBoxManage list</command> 
+      <arg>--long</arg>
+      <arg>--sorted</arg>
+      <arg choice="plain">systemproperties</arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-list-usbfilters">
+      <command>VBoxManage list</command> 
+      <arg>--long</arg>
+      <arg>--sorted</arg>
+      <arg choice="plain">usbfilters</arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-list-usbhost">
+      <command>VBoxManage list</command> 
+      <arg>--long</arg>
+      <arg>--sorted</arg>
+      <arg choice="plain">usbhost</arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-list-vms">
+      <command>VBoxManage list</command> 
+      <arg>--long</arg>
+      <arg>--sorted</arg>
+      <arg choice="plain">vms</arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-list-webcams">
+      <command>VBoxManage list</command> 
+      <arg>--long</arg>
+      <arg>--sorted</arg>
+      <arg choice="plain">webcams</arg>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+
+  <refsect1>
+    <title>Description</title>
+    <para>
+      The <command>VBoxManage list</command> subcommands enable you to
+      obtain information about the &product-name; software and the VMs
+      that you create.
+    </para>
+    <refsect2 id="vboxmanage-list-common-options">
+      <title>Common Options</title>
+      <variablelist>
+        <varlistentry>
+          <term><option>--long</option></term>
+          <listitem><para>
+              Shows detailed information about each VM and its
+              configuration. The short form of this option is
+              <option>-l</option>.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--sorted</option></term>
+          <listitem><para>
+              Sorts the list of VM entries alphabetically. The short
+              form of this option is <option>-s</option>.
+            </para></listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+    <refsect2 id="vboxmanage-list-bridgedifs">
+      <title>List the Bridged Network Interfaces on the Host System</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage list bridgedifs</command> command lists
+        the bridged network interfaces that are currently available on
+        the host system. The output shows detailed configuration
+        information about each interface.
+      </para>
+    </refsect2>
+    <refsect2 id="vboxmanage-list-cloudprofiles">
+      <title>List the Cloud Profiles</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage list cloudprofiles</command> command
+        lists the cloud profiles that have been configured. A cloud
+        profile contains settings for a cloud service account.
+      </para>
+    </refsect2>
+    <refsect2 id="vboxmanage-list-cloudproviders">
+      <title>List the Cloud Providers</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage list cloudproviders</command> command
+        lists the cloud providers that are supported by &product-name;.
+        Oracle Cloud Infrastructure is an example of a cloud provider.
+      </para>
+    </refsect2>
+    <refsect2 id="vboxmanage-list-dhcpservers">
+      <title>List the DHCP Servers That Are Available on the Host System</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage list dhcpservers</command> command lists
+        the DHCP servers that are currently available on the host
+        system. The output shows detailed configuration information
+        about each DHCP server.
+      </para>
+    </refsect2>
+    <refsect2 id="vboxmanage-list-dvds">
+      <title>List the DVD Virtual Disk Images</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage list dvds</command> command shows
+        information about the DVD virtual disk images that are currently
+        in use by the &product-name; software. For each image, the
+        output shows all the settings, the UUIDs associated with the
+        image by &product-name;, and all files associated with the
+        image.
+      </para>
+      <para>
+        This command performs the same function as the Virtual Media
+        Manager.
+      </para>
+    </refsect2>
+    <refsect2 id="vboxmanage-list-extpacks">
+      <title>List the Installed &product-name; Extension Packs</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage list extpacks</command> command shows
+        all &product-name; extension packs that are currently installed.
+      </para>
+    </refsect2>
+    <refsect2 id="vboxmanage-list-floppies">
+      <title>List the Floppy Disk Virtual Disk Images</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage list floppies</command> command shows
+        information about the floppy disk images that are currently in
+        use by the &product-name; software. For each image, the output
+        shows all the settings, the UUIDs associated with the image by
+        &product-name;, and all files associated with the image.
+      </para>
+      <para>
+        This command performs the same function as the Virtual Media
+        Manager.
+      </para>
+    </refsect2>
+    <refsect2 id="vboxmanage-list-groups">
+      <title>List Information about Virtual Machine Groups</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage list groups</command> command shows
+        detailed information about VM groups.
+      </para>
+    </refsect2>
+    <refsect2 id="vboxmanage-list-hddbackends">
+      <title>List the Virtual Disk Backends</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage list hddbackends</command> command lists
+        all known virtual disk backends of the &product-name; software.
+        For each such format, such as VDI, VMDK, or RAW, this command
+        lists the backend's capabilities and configuration.
+      </para>
+    </refsect2>
+    <refsect2 id="vboxmanage-list-hdds">
+      <title>List the Hard Disk Virtual Disk Images</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage list hdds</command> command shows
+        information about the hard disk virtual disk images that are
+        currently in use by the &product-name; software. For each image,
+        the output shows all the settings, the UUIDs associated with the
+        image by &product-name;, and all files associated with the
+        image.
+      </para>
+      <para>
+        This command performs the same function as the Virtual Media
+        Manager.
+      </para>
+    </refsect2>
+    <refsect2 id="vboxmanage-list-hostcpuids">
+      <title>List the CPUID Information for the Host System CPUs</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage list hostcpuids</command> command lists
+        CPUID information for each CPU on the host system. Use this
+        information to perform a more fine grained analyis of the host
+        system's virtualization capabilities.
+      </para>
+    </refsect2>
+    <refsect2 id="vboxmanage-list-hostdvds">
+      <title>List the DVD Interfaces on the Host System</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage list hostdvds</command> command lists
+        the DVD interfaces on the host system. Each DVD entry includes
+        the name used to access them from within &product-name;.
+      </para>
+    </refsect2>
+    <refsect2 id="vboxmanage-list-hostfloppies">
+      <title>List the Floppy Disk Interfaces on the Host System</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage list hostfloppies</command> command
+        lists the floppy disk interfaces on the host system. Each floppy
+        disk entry includes the name used to access them from within
+        &product-name;.
+      </para>
+    </refsect2>
+    <refsect2 id="vboxmanage-list-hostinfo">
+      <title>List Information About the Host System</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage list hostinfo</command> command shows
+        information about the host system. The output includes
+        information about the CPUs, memory, and the OS version.
+      </para>
+    </refsect2>
+    <refsect2 id="vboxmanage-list-hostonlyifs">
+      <title>List the Host-Only Network Interfaces on the Host System</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage list hostonlyifs</command> command lists
+        the host-only network interfaces that are currently available on
+        the host system. The output shows detailed configuration
+        information about each interface.
+      </para>
+    </refsect2>
+    <refsect2 id="vboxmanage-list-intnets">
+      <title>List Internal Networks</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage list intnets</command> command shows
+        information about the internal networks.
+      </para>
+    </refsect2>
+    <refsect2 id="vboxmanage-list-natnets">
+      <title>List the NAT Network Interfaces on the Host System</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage list natnets</command> command lists the
+        NAT network interfaces that are currently available on the host
+        system.
+      </para>
+    </refsect2>
+    <refsect2 id="vboxmanage-list-ostypes">
+      <title>List the Guest Operating Systems</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage list ostypes</command> command lists all
+        guest operating systems (OSes) that are known to &product-name;.
+        Each OS entry includes an identifier, a description, a family
+        identifier, a family description, and whether the OS has 64-bit
+        support.
+      </para>
+      <para>
+        You can use these identifiers with the <command>VBoxManage
+        modifyvm</command> command.
+      </para>
+    </refsect2>
+    <refsect2 id="vboxmanage-list-runningvms">
+      <title>List the Running Virtual Machines</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage list runningvms</command> command lists
+        all virtual machines (VMs) that are currently running. By
+        default this displays a compact list that shows the name and
+        Universally Unique Identifier (UUID) of each VM.
+      </para>
+    </refsect2>
+    <refsect2 id="vboxmanage-list-screenshotformats">
+      <title>List the Available Screen Shot Formats</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage list screenshotformats</command> command
+        shows the list of available screen shot formats.
+      </para>
+    </refsect2>
+    <refsect2 id="vboxmanage-list-systemproperties">
+      <title>List System Properties</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage list systemproperties</command> command
+        shows some global &product-name; settings, such as minimum and
+        maximum guest RAM, virtual hard disk size, folder settings, and
+        the current authentication library in use.
+      </para>
+    </refsect2>
+    <refsect2 id="vboxmanage-list-usbfilters">
+      <title>List the Registered Global USB Filters</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage list usbfilters</command> command lists
+        all global USB filters registered with &product-name; and
+        displays the filter parameters. Global USB filters are for
+        devices which are accessible to all virtual machines.
+      </para>
+    </refsect2>
+    <refsect2 id="vboxmanage-list-usbhost">
+      <title>List the USB Devices on the Host System</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage list usbhost</command> command shows
+        information about the USB devices that are attached to the host
+        system. The output includes information that you can use to
+        construct USB filters and indicates whether the device is
+        currently in use by the host system.
+      </para>
+    </refsect2>
+    <refsect2 id="vboxmanage-list-vms">
+      <title>List Virtual Machines</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage list vms</command> command lists all
+        virtual machines (VMs) that are currently registered with
+        &product-name;. By default this command displays a compact list
+        that shows the name and UUID of each VM.
+      </para>
+    </refsect2>
+    <refsect2 id="vboxmanage-list-webcams">
+      <title>List the Webcams Attached to a Running Virtual Machine</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage list webcams</command> command shows the
+        list of webcams that are attached to the running VM.
+      </para>
+      <para>
+        The output is a list of absolute paths or aliases that are used
+        to attach the webcams to the VM by using the <command>VBoxManage
+        webcam attach</command> command.
+      </para>
+    </refsect2>
+  </refsect1>
+
+  <refsect1>
+    <title>Examples</title>
+    <remark role="help-scope" condition="GLOBAL" />
+    <para>
+      The following command lists the VM groups configured for
+      &product-name;.
+    </para>
+<screen>$ VBoxManage list groups
+"/Linux-VMs"
+"/Windows-VMs"</screen>
+    <para>
+      The following command lists the VMs that are currently running.
+    </para>
+<screen>$ VBoxManage list runningvms
+"ol7" {<replaceable>ol7-UUID</replaceable>}
+"win8" {<replaceable>win8-UUID</replaceable>}</screen>
+  </refsect1>
+</refentry>
Index: trunk/doc/manual/en_US/man_VBoxManage-mediumproperty.xml
===================================================================
--- trunk/doc/manual/en_US/man_VBoxManage-mediumproperty.xml	(revision 82044)
+++ trunk/doc/manual/en_US/man_VBoxManage-mediumproperty.xml	(revision 82044)
@@ -0,0 +1,209 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+         manpage, user manual, usage: VBoxManage mediumproperty
+
+    Copyright (C) 2006-2019 Oracle Corporation
+
+    This file is part of VirtualBox Open Source Edition (OSE), as
+    available from http://www.virtualbox.org. This file is free software;
+    you can redistribute it and/or modify it under the terms of the GNU
+    General Public License (GPL) as published by the Free Software
+    Foundation, in version 2 as it comes in the "COPYING" file of the
+    VirtualBox OSE distribution. VirtualBox OSE is distributed in the
+    hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
+ -->
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+  "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"[
+<!ENTITY % all.entities SYSTEM "all-entities.ent">
+%all.entities;
+]>
+<refentry id="vboxmanage-mediumproperty" lang="en">
+  <refentryinfo>
+    <pubdate>September 2019</pubdate>
+    <title>VBoxManage mediumproperty</title>
+  </refentryinfo>
+
+  <refmeta>
+    <refentrytitle>VBoxManage-mediumproperty</refentrytitle>
+    <manvolnum>1</manvolnum>
+  </refmeta>
+
+  <refnamediv>
+    <refname>VBoxManage-mediumproperty</refname>
+    <refpurpose>manage medium properties</refpurpose>
+    <refclass>Oracle VM VirtualBox</refclass>
+  </refnamediv>
+
+  <refsynopsisdiv>
+    <cmdsynopsis id="synopsis-vboxmanage-mediumproperty-set">
+<!-- The 'id' is mandatory and must start with 'synopsis-'. -->
+      <command>VBoxManage mediumproperty</command>
+      <group>
+        <arg choice="plain">disk</arg>
+        <arg choice="plain">dvd</arg>
+        <arg choice="plain">floppy</arg>
+      </group>
+      <arg choice="plain">set</arg>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>filename</replaceable></arg>
+      </group>
+      <arg choice="req"><replaceable>property-name</replaceable></arg>
+      <arg choice="req"><replaceable>property-value</replaceable></arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-mediumproperty-get">
+      <command>VBoxManage mediumproperty</command>
+      <group>
+        <arg choice="plain">disk</arg>
+        <arg choice="plain">dvd</arg>
+        <arg choice="plain">floppy</arg>
+      </group>
+      <arg choice="plain">get</arg>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>filename</replaceable></arg>
+      </group>
+      <arg choice="req"><replaceable>property-name</replaceable></arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-mediumproperty-delete">
+      <command>VBoxManage mediumproperty</command>
+      <group>
+        <arg choice="plain">disk</arg>
+        <arg choice="plain">dvd</arg>
+        <arg choice="plain">floppy</arg>
+      </group>
+      <arg choice="plain">delete</arg>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>filename</replaceable></arg>
+      </group>
+      <arg choice="req"><replaceable>property-name</replaceable></arg>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+
+  <refsect1>
+    <title>Description</title>
+    <para>
+      The <command>VBoxManage mediumproperty</command> command enables
+      you to set, retrieve, or delete a medium property.
+    </para>
+    <refsect2 id="vboxmanage-mediumproperty-set">
+      <title>Set a Medium Property</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage mediumproperty set</command> command
+        enables you to set a medium property.
+      </para>
+      <variablelist>
+        <varlistentry>
+          <term><literal>disk | dvd | floppy</literal></term>
+          <listitem><para>
+              Specifies the type of medium. Valid values are
+              <literal>disk</literal> (hard drive),
+              <literal>dvd</literal>, or <literal>floppy</literal>.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><replaceable>uuid</replaceable> | <replaceable>filename</replaceable></term>
+          <listitem><para>
+              Specifies the Universally Unique Identifier (UUID) or
+              absolute path name of the medium or image.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><replaceable>property-name</replaceable></term>
+          <listitem><para>
+              Specifies the name of the property.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><replaceable>property-value</replaceable></term>
+          <listitem><para>
+              Specifies the value of the specified property.
+            </para></listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+    <refsect2 id="vboxmanage-mediumproperty-get">
+      <title>Retrieve a Medium Property Value</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage mediumproperty get</command> command
+        enables you to retrieve the value of a medium property.
+      </para>
+      <variablelist>
+        <varlistentry>
+          <term><literal>disk | dvd | floppy</literal></term>
+          <listitem><para>
+              Specifies the type of medium. Valid values are
+              <literal>disk</literal> (hard drive),
+              <literal>dvd</literal>, or <literal>floppy</literal>.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><replaceable>uuid</replaceable> | <replaceable>filename</replaceable></term>
+          <listitem><para>
+              Specifies the Universally Unique Identifier (UUID) or
+              absolute path name of the medium or image.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><replaceable>property-name</replaceable></term>
+          <listitem><para>
+              Specifies the name of the property.
+            </para></listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+    <refsect2 id="vboxmanage-mediumproperty-delete">
+      <title>Delete a Medium Property</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage mediumproperty delete</command> command
+        enables you to delete a medium property.
+      </para>
+      <variablelist>
+        <varlistentry>
+          <term><literal>disk | dvd | floppy</literal></term>
+          <listitem><para>
+              Specifies the type of medium. Valid values are
+              <literal>disk</literal> (hard drive),
+              <literal>dvd</literal>, or <literal>floppy</literal>.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><replaceable>uuid</replaceable> | <replaceable>filename</replaceable></term>
+          <listitem><para>
+              Specifies the Universally Unique Identifier (UUID) or
+              absolute path name of the medium or image.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><replaceable>property-name</replaceable></term>
+          <listitem><para>
+              Specifies the name of the property.
+            </para></listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+  </refsect1>
+
+  <refsect1>
+    <title>Examples</title>
+    <remark role="help-scope" condition="GLOBAL" />
+    <para>
+      The following command sets the property called
+      <literal>prop1</literal> to <literal>val1</literal> for the
+      <filename>ol7.vdi</filename> disk image.
+    </para>
+<screen>$ VBoxManage mediumproperty disk set ol7.vdi prop1 val1</screen>
+    <para>
+      The following command gets the value of the property called
+      <literal>prop1</literal> for the <filename>ol7.vdi</filename> disk
+      image.
+    </para>
+<screen>$ VBoxManage mediumproperty disk get ol7.vdi prop1</screen>
+  </refsect1>
+</refentry>
Index: trunk/doc/manual/en_US/man_VBoxManage-metrics.xml
===================================================================
--- trunk/doc/manual/en_US/man_VBoxManage-metrics.xml	(revision 82044)
+++ trunk/doc/manual/en_US/man_VBoxManage-metrics.xml	(revision 82044)
@@ -0,0 +1,414 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+    manpage, user manual, usage: VBoxManage metrics
+
+    Copyright (C) 2006-2019 Oracle Corporation
+
+    This file is part of VirtualBox Open Source Edition (OSE), as
+    available from http://www.virtualbox.org. This file is free software;
+    you can redistribute it and/or modify it under the terms of the GNU
+    General Public License (GPL) as published by the Free Software
+    Foundation, in version 2 as it comes in the "COPYING" file of the
+    VirtualBox OSE distribution. VirtualBox OSE is distributed in the
+    hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
+ -->
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+  "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"[
+<!ENTITY % all.entities SYSTEM "all-entities.ent">
+%all.entities;
+]>
+<refentry id="vboxmanage-metrics" lang="en">
+  <refentryinfo>
+    <pubdate>September 2019</pubdate>
+    <title>VBoxManage metrics</title>
+  </refentryinfo>
+
+  <refmeta>
+    <refentrytitle>VBoxManage-metrics</refentrytitle>
+    <manvolnum>1</manvolnum>
+  </refmeta>
+
+  <refnamediv>
+    <refname>VBoxManage-metrics</refname>
+    <refpurpose>monitor system resource usage</refpurpose>
+    <refclass>Oracle VM VirtualBox</refclass>
+  </refnamediv>
+
+  <refsynopsisdiv>
+    <cmdsynopsis id="synopsis-vboxmanage-metrics-collect">
+      <command>VBoxManage metrics collect</command> 
+      <arg>--detach</arg>
+      <arg>--list</arg>
+      <arg>--period=<replaceable>seconds</replaceable></arg>
+      <arg>--samples=<replaceable>count</replaceable></arg>
+      <group>
+        <arg choice="plain">*</arg>
+        <arg choice="plain">host</arg>
+        <arg choice="plain"><replaceable>vmname</replaceable> <arg><replaceable>metric-list</replaceable></arg></arg>
+      </group>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-metrics-disable">
+      <command>VBoxManage metrics disable</command> 
+      <arg>--list</arg>
+      <group>
+        <arg choice="plain">*</arg>
+        <arg choice="plain">host</arg>
+        <arg choice="plain"><replaceable>vmname</replaceable> <arg><replaceable>metric-list</replaceable></arg></arg>
+      </group>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-metrics-enable">
+      <command>VBoxManage metrics enable</command> 
+      <arg>--list</arg>
+      <group>
+        <arg choice="plain">*</arg>
+        <arg choice="plain">host</arg>
+        <arg choice="plain"><replaceable>vmname</replaceable> <arg><replaceable>metric-list</replaceable></arg></arg>
+      </group>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-metrics-list">
+      <command>VBoxManage metrics list</command>
+      <group>
+        <arg choice="plain">*</arg>
+        <arg choice="plain">host</arg>
+        <arg choice="plain"><replaceable>vmname</replaceable> <arg><replaceable>metric-list</replaceable></arg></arg>
+      </group>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-metrics-query">
+      <command>VBoxManage metrics query</command>
+      <group>
+        <arg choice="plain">*</arg>
+        <arg choice="plain">host</arg>
+        <arg choice="plain"><replaceable>vmname</replaceable> <arg><replaceable>metric-list</replaceable></arg></arg>
+      </group>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-metrics-setup">
+      <command>VBoxManage metrics setup</command> 
+      <arg>--list</arg>
+      <arg>--period <replaceable>seconds</replaceable></arg>
+      <arg>--samples <replaceable>count</replaceable></arg>
+      <group>
+        <arg choice="plain">*</arg>
+        <arg choice="plain">host</arg>
+        <arg choice="plain"><replaceable>vmname</replaceable> <arg><replaceable>metric-list</replaceable></arg></arg>
+      </group>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+
+  <refsect1>
+    <title>Description</title>
+    <para>
+      The <command>VBoxManage metrics</command> command enables you to
+      monitor system resource usage for the host system and for virtual
+      machines (VMs). For example, you can monitor particular metrics,
+      such as the percentage of time CPUs spend executing in user mode
+      (<literal>CPU/Load/User</literal>) over a specified sampling
+      period.
+    </para>
+    <para>
+      While it runs, the <command>VBoxSVC</command> process collects and
+      saves the specified metric data internally. The
+      <command>VBoxSVC</command> process runs until shortly after you
+      close all VMs and frontends. Use the <command>VBoxManage metrics
+      query</command> command to retrieve data at any time.
+    </para>
+    <para>
+      By default, metrics are not collected unless you run the
+      <command>VBoxManage metrics setup</command> command to specify a
+      sampling interval in seconds and the number of metrics to save.
+    </para>
+    <para>
+      Note that you can enable metric collection only for started VMs.
+      Collected data and collection settings for a VM are discarded when
+      the VM shuts down.
+    </para>
+    <refsect2>
+      <title>Metrics</title>
+      <para>
+        The host and VMs have different sets of associated metrics,
+        which you can view by running the <command>VBoxManage metrics
+        list</command> command.
+      </para>
+      <para>
+        Each metric is represented as a string that is composed of a
+        category and a metric. Optionally, the metric string can include
+        any of the following: a submetric, a sub-submetric, and an
+        aggregate. The metric string has the following format:
+      </para>
+<screen><replaceable>category</replaceable>/<replaceable>metric</replaceable>[/<replaceable>submetric</replaceable>[/<replaceable>sub-submetric</replaceable>]][:<replaceable>aggregate</replaceable>]</screen>
+      <itemizedlist>
+        <listitem><para>
+            <replaceable>category</replaceable> is the resource type,
+            such as <literal>CPU</literal>, <literal>RAM</literal>,
+            <literal>FS</literal>, <literal>Net</literal>.
+          </para></listitem>
+        <listitem><para>
+            <replaceable>metric</replaceable> is a measurement type that
+            is associated with the resource category. For example, the
+            <literal>Load</literal> and <literal>MHz</literal> metrics
+            are associated with the <literal>CPU</literal> resource
+            category.
+          </para></listitem>
+        <listitem><para>
+            <replaceable>submetric</replaceable> is an optional
+            measurement type that is associated with the metric. For
+            example, the <literal>User</literal>,
+            <literal>Kernel</literal>, and <literal>Idle</literal>
+            submetrics are associated with the <literal>Load</literal>
+            metric.
+          </para></listitem>
+        <listitem><para>
+            <replaceable>sub-submetric</replaceable> is an optional
+            measurement type that is associated with the submetric. For
+            example, the <literal>Rx</literal> and <literal>Tx</literal>
+            sub-submetrics are associated with the
+            <literal>Rate</literal> submetric of the
+            <literal>Net</literal> resource category. The associated
+            metric is the network interface.
+          </para></listitem>
+        <listitem><para>
+            <replaceable>aggregate</replaceable> is an optional function
+            to provide minimum, maximum, and average measurements for a
+            resource category. For example, the
+            <literal>RAM/Usage/Free:min</literal> metric represents the
+            minimum amount of available memory found in all saved data
+            on the host system.
+          </para></listitem>
+      </itemizedlist>
+      <para>
+        By default, the <command>VBoxManage metrics</command> commands
+        operate on the host system and all VMs, and report on all
+        metrics. You can optionally limit these commands to operate on
+        the host system or on a particular VM, and report on a list of
+        one or more metrics.
+      </para>
+    </refsect2>
+    <refsect2 id="vboxmanage-metrics-common-options">
+      <title>Common Options</title>
+      <variablelist>
+        <varlistentry>
+          <term><literal>*</literal> | <literal>host</literal> | <replaceable>vmname</replaceable></term>
+          <listitem><para>
+              Specifies the component on which to operate. By default,
+              this command operates on the host system and all running
+              VMs.
+            </para><para>
+              If you specify <literal>host</literal>, the
+              <command>VBoxManage metrics</command> command operates on
+              the host system only. If you specify an asterisk
+              (<literal>*</literal>), the command operates on all VMs.
+              If you specify the name of a VM, the <command>VBoxManage
+              metrics</command> command operates on that VM.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><replaceable>metric-list</replaceable></term>
+          <listitem><para>
+              Specifies a comma-separated list of one or more metrics.
+            </para><para>
+              The form of the metric must include the
+              <replaceable>category</replaceable> and
+              <replaceable>metric</replaceable> part of the metric
+              string separated by a slash.
+            </para><para>
+              Note that the <command>VBoxManage metrics enable</command>
+              and <command>VBoxManage metrics disable</command> commands
+              require that you specify metrics as parameters. The
+              metrics must include only the resource category and metric
+              part, such as <literal>CPU/Load</literal> and
+              <literal>RAM/Usage</literal>.
+            </para></listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+    <refsect2 id="vboxmanage-metrics-collect">
+      <title>Collect Data Metrics</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage metrics collect</command> command
+        collects and outputs data periodically until you stop the
+        process by pressing Ctrl+C.
+      </para>
+      <variablelist>
+        <varlistentry>
+          <term><option>--detach</option></term>
+          <listitem><para>
+              Disables the collection of metric data, so no data is
+              output. Using this option is the same as running the
+              <command>VBoxManage metrics setup</command> command.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--list</option></term>
+          <listitem><para>
+              Shows which metrics match the specified filter.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--period=<replaceable>seconds</replaceable></option></term>
+          <listitem><para>
+              Specifies the number of seconds to wait between collecting
+              metric data samples. The default value is 1.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--samples=<replaceable>count</replaceable></option></term>
+          <listitem><para>
+              Specifies the number of metric data samples to save. To
+              view the saved data, use the <command>VBoxManage metrics
+              query</command> command. The default value is 1.
+            </para></listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+    <refsect2 id="vboxmanage-metrics-disable">
+      <title>Disable Metric Data Collection</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage metrics disable</command> command
+        suspends data collection. This action does not affect the data
+        collection properties or the collected data. Note that
+        specifying a submetric in the metric list does not disable its
+        underlying metrics.
+      </para>
+      <para>
+        Note that the <command>VBoxManage metrics disable</command>
+        command requires that you specify metrics as parameters. The
+        metrics must include only the resource category and metric part,
+        such as <literal>CPU/Load</literal> and
+        <literal>RAM/Usage</literal>.
+      </para>
+      <variablelist>
+        <varlistentry>
+          <term><option>--list</option></term>
+          <listitem><para>
+              Shows whether the command succeeded as expected.
+            </para></listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+    <refsect2 id="vboxmanage-metrics-enable">
+      <title>Enable Metric Data Collection</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage metrics enable</command> command resumes
+        data collection after it has been suspended by using the
+        <command>VBoxManage metrics disable</command> command. Note that
+        specifying a submetric in the metric list does not enable its
+        underlying metrics.
+      </para>
+      <para>
+        Unlike the <command>VBoxManage metrics setup</command> command,
+        the <command>VBoxManage metrics enable</command> command does
+        not discard previously collected samples for the specified set
+        of objects and metrics.
+      </para>
+      <para>
+        Note that the <command>VBoxManage metrics enable</command>
+        command requires that you specify metrics as parameters. The
+        metrics must include only the resource category and metric part,
+        such as <literal>CPU/Load</literal> and
+        <literal>RAM/Usage</literal>.
+      </para>
+      <variablelist>
+        <varlistentry>
+          <term><option>--list</option></term>
+          <listitem><para>
+              Shows whether the command succeeded as expected.
+            </para></listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+    <refsect2 id="vboxmanage-metrics-list">
+      <title>List Metric Values</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage metrics list</command> command shows the
+        metrics that are currently available. Note that VM-specific
+        metrics are shown only when that VM is running.
+      </para>
+    </refsect2>
+    <refsect2 id="vboxmanage-metrics-query">
+      <title>List Saved Metric Data</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage metrics query</command> command
+        retrieves and shows the saved metric data.
+      </para>
+      <para>
+        Note that the <command>VBoxManage metrics query</command>
+        command does not remove or flush saved data but older samples
+        are replaced by newer samples over time.
+      </para>
+    </refsect2>
+    <refsect2 id="vboxmanage-metrics-setup">
+      <title>Configure Metric-Gathering Properties</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage metrics setup</command> command
+        configures metric-gathering properties.
+      </para>
+      <para>
+        Note that this command discards any previously collected samples
+        for the specified set of objects and metrics. To enable or
+        disable metrics collection without discarding the data, use the
+        <command>VBoxManage metrics enable</command> command or the
+        <command>VBoxManage metrics disable</command> command,
+        respectively.
+      </para>
+      <variablelist>
+        <varlistentry>
+          <term><option>--list</option></term>
+          <listitem><para>
+              Shows which metrics have been modified as a result of the
+              command execution.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--period=<replaceable>seconds</replaceable></option></term>
+          <listitem><para>
+              Specifies the number of seconds to wait between collecting
+              metric data samples. The default value is 1.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--samples=<replaceable>count</replaceable></option></term>
+          <listitem><para>
+              Specifies the number of metric data samples to save. To
+              view the saved data, use the <command>VBoxManage metrics
+              query</command> command. The default value is 1.
+            </para></listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+  </refsect1>
+
+  <refsect1>
+    <title>Examples</title>
+    <remark role="help-scope" condition="GLOBAL"/>
+    <para>
+      The following example command enables the collection of host
+      processor and memory usage metrics every second. The
+      <option>--samples</option> option saves the five latest samples.
+    </para>
+<screen>$ VBoxManage metrics setup --period 1 --samples 5 host CPU/Load,RAM/Usage</screen>
+    <para>
+      The following command lists the metrics that are available to the
+      host system and VMs:
+    </para>
+<screen>$ VBoxManage metrics list</screen>
+    <para>
+      Note that the host system and VMs have different sets of metrics.
+    </para>
+    <para>
+      The following example shows how to query metric data about the CPU
+      time spent in user and kernel modes for the
+      <literal>test</literal> VM:
+    </para>
+<screen>$ VBoxManage metrics query test CPU/Load/User,CPU/Load/Kernel</screen>
+  </refsect1>
+</refentry>
Index: trunk/doc/manual/en_US/man_VBoxManage-modifymedium.xml
===================================================================
--- trunk/doc/manual/en_US/man_VBoxManage-modifymedium.xml	(revision 82044)
+++ trunk/doc/manual/en_US/man_VBoxManage-modifymedium.xml	(revision 82044)
@@ -0,0 +1,245 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+         manpage, user manual, usage: VBoxManage modifymedium
+
+    Copyright (C) 2006-2019 Oracle Corporation
+
+    This file is part of VirtualBox Open Source Edition (OSE), as
+    available from http://www.virtualbox.org. This file is free software;
+    you can redistribute it and/or modify it under the terms of the GNU
+    General Public License (GPL) as published by the Free Software
+    Foundation, in version 2 as it comes in the "COPYING" file of the
+    VirtualBox OSE distribution. VirtualBox OSE is distributed in the
+    hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
+ -->
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+  "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"[
+<!ENTITY % all.entities SYSTEM "all-entities.ent">
+%all.entities;
+]>
+<refentry id="vboxmanage-modifymedium" lang="en">
+  <refentryinfo>
+    <pubdate>August 2019</pubdate>
+    <title>VBoxManage modifymedium</title>
+  </refentryinfo>
+
+  <refmeta>
+    <refentrytitle>VBoxManage-modifymedium</refentrytitle>
+    <manvolnum>1</manvolnum>
+  </refmeta>
+
+  <refnamediv>
+    <refname>VBoxManage-modifymedium</refname>
+    <refpurpose>change the characteristics of an existing disk image</refpurpose>
+    <refclass>Oracle VM VirtualBox</refclass>
+  </refnamediv>
+
+  <refsynopsisdiv>
+    <cmdsynopsis id="synopsis-vboxmanage-modifymedium">
+<!-- The 'id' is mandatory and must start with 'synopsis-'. -->
+      <command>VBoxManage modifymedium</command>
+      <group>
+        <arg choice="plain">disk</arg>
+        <arg choice="plain">dvd</arg>
+        <arg choice="plain">floppy</arg>
+      </group>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>filename</replaceable></arg>
+      </group>
+      <arg>--autoreset=on | off</arg>
+      <arg>--compact</arg>
+      <arg>--description=<replaceable>description</replaceable></arg>
+      <arg>--move=<replaceable>pathname</replaceable></arg>
+      <arg>--property=<replaceable>name</replaceable>=[<replaceable>value</replaceable>]</arg>
+      <arg>--resize=<replaceable>megabytes</replaceable> | --resizebyte=<replaceable>bytes</replaceable></arg>
+      <arg>--setlocation=<replaceable>pathname</replaceable></arg>
+      <arg>--type=normal | writethrough | immutable | shareable | readonly | multiattach</arg>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+
+  <refsect1>
+    <title>Description</title>
+    <para>
+      The <command>VBoxManage modifymedium</command> command enables you
+      to change the characteristics of an existing disk image.
+    </para>
+    <note>
+      <para>
+        For compatibility with earlier versions of &product-name;, you
+        can use the <command>modifyvdi</command> and
+        <command>modifyhd</command> commands.
+      </para>
+    </note>
+    <variablelist>
+      <varlistentry>
+        <term>disk | dvd | floppy</term>
+        <listitem><para>
+            Specifies the media type of the image.
+          </para></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><replaceable>filename</replaceable></term>
+        <listitem><para>
+            Specifies the Universally Unique Identifier (UUID) or path
+            name of the disk image on the host file system. You can
+            specify the UUID only if the medium is registered. Use the
+            <command>VBoxManage list hdds</command> command to list the
+            registered images. You can specfy an absolute or relative
+            path to the medium.
+          </para></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--autoreset=on | off</option></term>
+        <listitem><para>
+            Specifies whether to automatically reset an immutable hard
+            disk on every virtual machine (VM) startup. This option is
+            only for immutable hard disks and the default value is
+            <literal>on</literal>. See <xref linkend="hdimagewrites" />.
+          </para></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--compact</option></term>
+        <listitem><para>
+            Compresses disk images by removing blocks that contain only
+            zeroes. This option shrinks a dynamically allocated image
+            and reduces the <emphasis>physical</emphasis> size of the
+            image without affecting the logical size of the virtual
+            disk.
+          </para><para>
+            You can use this option for base images and for differencing
+            images that are created as part of a snapshot.
+          </para><note>
+            <para>
+              Before you compress the image, you must use a suitable
+              software tool to zero out free space in the guest system.
+              For example:
+            </para>
+            <itemizedlist>
+              <listitem><para>
+                  <emphasis role="bold">Windows guests.</emphasis> Run
+                  the <command>sdelete -z</command> command.
+                </para></listitem>
+              <listitem><para>
+                  <emphasis role="bold">Linux guests.</emphasis> Use the
+                  <command>zerofree</command> utility, which supports
+                  <literal>ext2</literal> and <literal>ext3</literal>
+                  file systems.
+                </para></listitem>
+              <listitem><para>
+                  <emphasis role="bold">Mac OS X guests.</emphasis> Use
+                  the <command>diskutil secureErase freespace 0
+                  /</command> command.
+                </para></listitem>
+            </itemizedlist>
+          </note><para>
+            Note that you can only use this option to compress VDI
+            images. To compress non-VID images, you can zero out free
+            blocks and then clone the disk to any other dynamically
+            allocated format.
+          </para></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--description=<replaceable>description</replaceable></option></term>
+        <listitem><para>
+            Specifies a text description of the medium.
+          </para></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--move=<replaceable>pathname</replaceable></option></term>
+        <listitem><para>
+            Specifies a relative or absolute path to a medium on the
+            host system. Use this option to relocate a medium to a
+            different location on the host system.
+          </para></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--property=<replaceable>name</replaceable>=<replaceable>value</replaceable></option></term>
+        <listitem><para>
+            Specifies a property name and value for the medium.
+          </para></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--resize=<replaceable>size</replaceable></option></term>
+        <listitem><para>
+            Specifes the new capacity of an existing image in MB. You
+            can use this option only to expand the capacity of an image.
+            You can cannot shrink the capacity of an image.
+          </para><para>
+            Note that you can resize only dynamically allocated disk
+            images that use the VDI and VHD formats. This option adjusts
+            the <emphasis>logical</emphasis> size of a virtual disk and
+            has only a minor affect on the physical size.
+          </para><para>
+            For example, if your dynamically allocated 10 GB disk is
+            full, you can use the <option>--resize 15360</option> option
+            to increase the capacity of the existing disk to 15 GB
+            (15,360 MB). This operation enables you to avoid having to
+            create a new image and copy all data from within a VM.
+          </para><para>
+            Note that using this option only changes the capacity of the
+            drive. So, you might need to subsequently use a partition
+            management tool in the guest to adjust the main partition to
+            fill the drive.
+          </para></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--resizebyte=<replaceable>size</replaceable></option></term>
+        <listitem><para>
+            Specifes the new capacity of an existing image in bytes.
+            This option is similar to the <option>--resize</option>
+            option, but you specify the size in bytes instead of
+            megabytes.
+          </para></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--setlocation=<replaceable>pathname</replaceable></option></term>
+        <listitem><para>
+            Specifies the new location of the medium on the host system
+            after the medium has been moved. The path name can be
+            relative to the current directory or be absolute to the
+            root.
+          </para><para>
+            Note that the <command>VBoxManage modifymedium</command>
+            command does not perform any sanity checks on the path name
+            you specify. Ensure that the path name is valid.
+          </para></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--type</option></term>
+        <listitem><para>
+            Specifies the new mode type of an existing image. Valid
+            values are <literal>normal</literal>,
+            <literal>immutable</literal>,
+            <literal>writethrough</literal>,
+            <literal>multi-attach</literal>,
+            <literal>shareable</literal>, and
+            <literal>readonly</literal>. For descriptions of these mode
+            types, see <xref linkend="hdimagewrites" />.
+          </para></listitem>
+      </varlistentry>
+    </variablelist>
+  </refsect1>
+
+  <refsect1>
+    <title>Examples</title>
+    <remark role="help-scope" condition="GLOBAL" />
+    <para>
+      The following command modifies the description for the disk image
+      file called <filename>disk01.vdi</filename>.
+    </para>
+<screen>$ VBoxManage modifymedium disk disk01.vdi --description "Oracle Linux 7 image"</screen>
+    <para>
+      The following command modifies the write mode for the disk image
+      file called <filename>disk01.vdi</filename>.
+    </para>
+<screen>$ VBoxManage modifymedium disk disk01.vdi --type writethrough</screen>
+  </refsect1>
+
+  <refsect1>
+    <title>See Also</title>
+    <para>
+      <xref linkend="vboxmanage-list" />
+    </para>
+  </refsect1>
+</refentry>
Index: trunk/doc/manual/en_US/man_VBoxManage-modifyvm.xml
===================================================================
--- trunk/doc/manual/en_US/man_VBoxManage-modifyvm.xml	(revision 82044)
+++ trunk/doc/manual/en_US/man_VBoxManage-modifyvm.xml	(revision 82044)
@@ -0,0 +1,2470 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+         manpage, user manual, usage: VBoxManage modifyvm
+
+    Copyright (C) 2006-2019 Oracle Corporation
+
+    This file is part of VirtualBox Open Source Edition (OSE), as
+    available from http://www.virtualbox.org. This file is free software;
+    you can redistribute it and/or modify it under the terms of the GNU
+    General Public License (GPL) as published by the Free Software
+    Foundation, in version 2 as it comes in the "COPYING" file of the
+    VirtualBox OSE distribution. VirtualBox OSE is distributed in the
+    hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
+ -->
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+  "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"[
+<!ENTITY % all.entities SYSTEM "all-entities.ent">
+%all.entities;
+]>
+<refentry id="vboxmanage-modifyvm" lang="en">
+  <refentryinfo>
+    <pubdate>September 2019</pubdate>
+    <title>VBoxManage modifyvm</title>
+  </refentryinfo>
+
+  <refmeta>
+    <refentrytitle>VBoxManage-modifyvm</refentrytitle>
+    <manvolnum>1</manvolnum>
+  </refmeta>
+
+  <refnamediv>
+    <refname>VBoxManage-modifyvm</refname>
+    <refpurpose>Change settings for a virtual machine that is stopped</refpurpose>
+    <refclass>Oracle VM VirtualBox</refclass>
+  </refnamediv>
+
+  <refsynopsisdiv>
+    <cmdsynopsis id="synopsis-vboxmanage-modifyvm-general">
+<!-- The 'id' is mandatory and must start with 'synopsis-'. -->
+      <command>VBoxManage modifyvm</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg>--name=<replaceable>name</replaceable></arg>
+      <arg>--groups= <arg choice="plain"><replaceable>group</replaceable> [,<replaceable>group</replaceable>...]</arg></arg>
+      <arg>--description=<replaceable>description</replaceable></arg>
+      <arg>--ostype=<replaceable>OS-type</replaceable></arg>
+      <arg>--iconfile=<replaceable>filename</replaceable></arg>
+      <arg>--memory=<replaceable>size-in-MB</replaceable></arg>
+      <arg>--pagefusion=<group choice="plain">
+          <arg choice="plain">on</arg>
+          <arg choice="plain">off</arg>
+        </group></arg>
+      <arg>--vram=<replaceable>size-in-MB</replaceable></arg>
+      <arg>--acpi=<group choice="plain">
+          <arg choice="plain">on</arg>
+          <arg choice="plain">off</arg>
+        </group></arg>
+      <arg>--pciattach=<replaceable>host-PCI-address</replaceable></arg>
+      <arg>--pcidetach=<replaceable>host-PCI-address</replaceable></arg>
+      <arg>--ioapic=<group choice="plain">
+          <arg choice="plain">on</arg>
+          <arg choice="plain">off</arg>
+        </group></arg>
+      <arg>--hardwareuuid=<replaceable>UUID</replaceable></arg>
+      <arg>--cpus=<replaceable>CPU-count</replaceable></arg>
+      <arg>--cpuhotplug=<group choice="plain">
+          <arg choice="plain">on</arg>
+          <arg choice="plain">off</arg>
+        </group></arg>
+      <arg>--plugcpu=<replaceable>CPU-ID</replaceable></arg>
+      <arg>--unplugcpu=<replaceable>CPU-ID</replaceable></arg>
+      <arg>--cpuexecutioncap=<replaceable>number</replaceable></arg>
+      <arg>--pae=<group choice="plain">
+          <arg choice="plain">on</arg>
+          <arg choice="plain">off</arg>
+        </group></arg>
+      <arg>--longmode=<group choice="plain">
+          <arg choice="plain">on</arg>
+          <arg choice="plain">off</arg>
+        </group></arg>
+      <arg>--ibpb-on-vm-exit=<group choice="plain">
+          <arg choice="plain">on</arg>
+          <arg choice="plain">off</arg>
+        </group></arg>
+      <arg>--ibpb-on-vm-entry=<group choice="plain">
+          <arg choice="plain">on</arg>
+          <arg choice="plain">off</arg>
+        </group></arg>
+      <arg>--spec-ctrl=<group choice="plain">
+          <arg choice="plain">on</arg>
+          <arg choice="plain">off</arg>
+        </group></arg>
+      <arg>--l1d-flush-on-sched=<group choice="plain">
+          <arg choice="plain">on</arg>
+          <arg choice="plain">off</arg>
+        </group></arg>
+      <arg>--l1d-flush-on-vm-entry=<group choice="plain">
+          <arg choice="plain">on</arg>
+          <arg choice="plain">off</arg>
+        </group></arg>
+      <arg>--mds-clear-on-sched=<group choice="plain">
+          <arg choice="plain">on</arg>
+          <arg choice="plain">off</arg>
+        </group></arg>
+      <arg>--mds-clear-on-vm-entry=<group choice="plain">
+          <arg choice="plain">on</arg>
+          <arg choice="plain">off</arg>
+        </group></arg>
+      <arg>--cpu-profile=<group choice="plain">
+          <arg choice="plain">host</arg>
+          <arg choice="plain">Intel 8086</arg>
+          <arg choice="plain">Intel 80286</arg>
+          <arg choice="plain">Intel 80386</arg>
+        </group></arg>
+      <arg>--hpet=<group choice="plain">
+          <arg choice="plain">on</arg>
+          <arg choice="plain">off</arg>
+        </group></arg>
+      <arg>--hwvirtex=<group choice="plain">
+          <arg choice="plain">on</arg>
+          <arg choice="plain">off</arg>
+        </group></arg>
+      <arg>--triplefaultreset=<group choice="plain">
+          <arg choice="plain">on</arg>
+          <arg choice="plain">off</arg>
+        </group></arg>
+      <arg>--apic=<group choice="plain">
+          <arg choice="plain">on</arg>
+          <arg choice="plain">off</arg>
+        </group></arg>
+      <arg>--x2apic=<group choice="plain">
+          <arg choice="plain">on</arg>
+          <arg choice="plain">off</arg>
+        </group></arg>
+      <arg>--paravirtprovider=<group choice="plain">
+          <arg choice="plain">none</arg>
+          <arg choice="plain">default</arg>
+          <arg choice="plain">legacy</arg>
+          <arg choice="plain">minimal</arg>
+          <arg choice="plain">hyperv</arg>
+          <arg choice="plain">kvm</arg>
+        </group></arg>
+      <arg>--paravirtdebug= <arg choice="plain"><replaceable>key</replaceable>=<replaceable>value</replaceable> [,<replaceable>key</replaceable>=<replaceable>value</replaceable>...]</arg></arg>
+      <arg>--nestedpaging=<group choice="plain">
+          <arg choice="plain">on</arg>
+          <arg choice="plain">off</arg>
+        </group></arg>
+      <arg>--largepages=<group choice="plain">
+          <arg choice="plain">on</arg>
+          <arg choice="plain">off</arg>
+        </group></arg>
+      <arg>--vtxvpid=<group choice="plain">
+          <arg choice="plain">on</arg>
+          <arg choice="plain">off</arg>
+        </group></arg>
+      <arg>--vtxux=<group choice="plain">
+          <arg choice="plain">on</arg>
+          <arg choice="plain">off</arg>
+        </group></arg>
+      <arg>--accelerate3d=<group choice="plain">
+          <arg choice="plain">on</arg>
+          <arg choice="plain">off</arg>
+        </group></arg>
+      <arg>--accelerate2dvideo=<group choice="plain">
+          <arg choice="plain">on</arg>
+          <arg choice="plain">off</arg>
+        </group></arg>
+      <arg>--chipset=<group choice="plain">
+          <arg choice="plain">ich9</arg>
+          <arg choice="plain">piix3</arg>
+        </group></arg>
+      <arg>--bioslogofadein=<group choice="plain">
+          <arg choice="plain">on</arg>
+          <arg choice="plain">off</arg>
+        </group></arg>
+      <arg>--bioslogofadeout=<group choice="plain">
+          <arg choice="plain">on</arg>
+          <arg choice="plain">off</arg>
+        </group></arg>
+      <arg>--bioslogodisplaytime=<replaceable>msec</replaceable></arg>
+      <arg>--bioslogoimagepath=<replaceable>pathname</replaceable></arg>
+      <arg>--biosbootmenu=<group choice="plain">
+          <arg choice="plain">disabled</arg>
+          <arg choice="plain">menuonly</arg>
+          <arg choice="plain">messageandmenu</arg>
+        </group></arg>
+      <arg>--biosapic=<group choice="plain">
+          <arg choice="plain">disabled</arg>
+          <arg choice="plain">apic</arg>
+          <arg choice="plain">x2apic</arg>
+        </group></arg>
+      <arg>--biossystemtimeoffset=<replaceable>msec</replaceable></arg>
+      <arg>--biospxedebug=<group choice="plain">
+          <arg choice="plain">on</arg>
+          <arg choice="plain">off</arg>
+        </group></arg>
+      <arg>--boot<replaceable>X</replaceable>=<group choice="plain">
+          <arg choice="plain">none</arg>
+          <arg choice="plain">floppy</arg>
+          <arg choice="plain">dvd</arg>
+          <arg choice="plain">disk</arg>
+          <arg choice="plain">net</arg>
+        </group></arg>
+      <arg>--rtcuseutc=<group choice="plain">
+          <arg choice="plain">on</arg>
+          <arg choice="plain">off</arg>
+        </group></arg>
+      <arg>--graphicscontroller=<group choice="plain">
+          <arg choice="plain">none</arg>
+          <arg choice="plain">vboxvga</arg>
+          <arg choice="plain">vmsvga</arg>
+          <arg choice="plain">vboxsvga</arg>
+        </group></arg>
+      <arg>--snapshotfolder=<group choice="plain">
+          <arg choice="plain">default</arg>
+          <arg choice="plain"><replaceable>pathname</replaceable></arg>
+        </group></arg>
+      <arg>--firmware=<group choice="plain">
+          <arg choice="plain">bios</arg>
+          <arg choice="plain">efi</arg>
+          <arg choice="plain">efi32</arg>
+          <arg choice="plain">efi64</arg>
+        </group></arg>
+      <arg>--guestmemoryballoon=<replaceable>size-in-MB</replaceable></arg>
+      <arg>--defaultfrontend=<group choice="plain">
+          <arg choice="plain">default</arg>
+          <arg choice="plain"><replaceable>name</replaceable></arg>
+        </group></arg>
+      <arg>--nested-hw-virt=<group choice="plain">
+          <arg choice="plain">on</arg>
+          <arg choice="plain">off</arg>
+        </group></arg>
+      <arg>--vm-process-priority=<group choice="plain">
+          <arg choice="plain">default</arg>
+          <arg choice="plain">flat</arg>
+          <arg choice="plain">low</arg>
+          <arg choice="plain">normal</arg>
+          <arg choice="plain">high</arg>
+        </group></arg>
+    </cmdsynopsis>
+    
+    <cmdsynopsis id="synopsis-vboxmanage-modifyvm-networking">
+      <command>VBoxManage modifyvm</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg>--nic<replaceable>N</replaceable>=<group choice="plain">
+          <arg choice="plain">none</arg>
+          <arg choice="plain">null</arg>
+          <arg choice="plain">nat</arg>
+          <arg choice="plain">bridged</arg>
+          <arg choice="plain">intnet</arg>
+          <arg choice="plain">hostonly</arg>
+          <arg choice="plain">generic</arg>
+          <arg choice="plain">natnetwork</arg>
+        </group></arg>
+      <arg>--nictype<replaceable>N</replaceable>=<group choice="plain">
+          <arg choice="plain">Am79C970A</arg>
+          <arg choice="plain">Am79C973</arg>
+          <arg choice="plain">82540EM</arg>
+          <arg choice="plain">82543GC</arg>
+          <arg choice="plain">82545EM</arg>
+          <arg choice="plain">virtio</arg>
+        </group></arg>
+      <arg>--cableconnected<replaceable>N</replaceable>=<group choice="plain">
+          <arg choice="plain">on</arg>
+          <arg choice="plain">off</arg>
+        </group></arg>
+      <arg>--nictrace<replaceable>N</replaceable>=<group choice="plain">
+          <arg choice="plain">on</arg>
+          <arg choice="plain">off</arg>
+        </group></arg>
+      <arg>--nictracefile<replaceable>N</replaceable>=<replaceable>filename</replaceable></arg>
+      <arg>--nicproperty<replaceable>N</replaceable>=<replaceable>name</replaceable>= <arg><replaceable>value</replaceable></arg></arg>
+      <arg>--nicspeed<replaceable>N</replaceable>=<replaceable>kbps</replaceable></arg>
+      <arg>--nicbootprio<replaceable>N</replaceable>=<replaceable>priority</replaceable></arg>
+      <arg>--nicpromisc<replaceable>N</replaceable>=<group choice="plain">
+          <arg choice="plain">deny</arg>
+          <arg choice="plain">allow-vms</arg>
+          <arg choice="plain">allow-all</arg>
+        </group></arg>
+      <arg>--nicbandwidthgroup<replaceable>N</replaceable>=<group choice="plain">
+          <arg choice="plain">none</arg>
+          <arg choice="plain"><replaceable>name</replaceable></arg>
+        </group></arg>
+      <arg>--bridgeadapter<replaceable>N</replaceable>=<group choice="plain">
+          <arg choice="plain">none</arg>
+          <arg choice="plain"><replaceable>device-name</replaceable></arg>
+        </group></arg>
+      <arg>--hostonlyadapter<replaceable>N</replaceable>=<group choice="plain">
+          <arg choice="plain">none</arg>
+          <arg choice="plain"><replaceable>device-name</replaceable></arg>
+        </group></arg>
+      <arg>--intnet<replaceable>N</replaceable>=<replaceable>network-name</replaceable></arg>
+      <arg>--nat-network<replaceable>N</replaceable>=<replaceable>network-name</replaceable></arg>
+      <arg>--nicgenericdrv<replaceable>N</replaceable>=<replaceable>driver-name</replaceable></arg>
+      <arg>--macaddress<replaceable>N</replaceable>=<group choice="plain">
+          <arg choice="plain">auto</arg>
+          <arg choice="plain"><replaceable>MAC-address</replaceable></arg>
+        </group></arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-modifyvm-networking-nat">
+      <command>VBoxManage modifyvm</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg>--natnet<replaceable>N</replaceable>=<group choice="plain">
+          <arg choice="plain"><replaceable>network</replaceable></arg>
+          <arg choice="plain">default</arg>
+        </group></arg>
+      <arg>--natpf<replaceable>N</replaceable>=<group choice="plain">
+          <arg choice="plain">[<replaceable>rule-name</replaceable>],tcp</arg>
+          <arg choice="plain">udp,[<replaceable>host-IP</replaceable>],<replaceable>hostport</replaceable>,[<replaceable>guest-IP</replaceable>],<replaceable>guestport</replaceable></arg>
+        </group></arg>
+      <arg>--natpf<replaceable>N</replaceable>=delete=<replaceable>rule-name</replaceable></arg>
+      <arg>--nattftpprefix<replaceable>N</replaceable>=<replaceable>prefix</replaceable></arg>
+      <arg>--nattftpfile<replaceable>N</replaceable>=<replaceable>filename</replaceable></arg>
+      <arg>--nattftpserver<replaceable>N</replaceable>=<replaceable>IP-address</replaceable></arg>
+      <arg>--natbindip<replaceable>N</replaceable>=<replaceable>IP-address</replaceable></arg>
+      <arg>--natdnspassdomain<replaceable>N</replaceable>=<group choice="plain">
+          <arg choice="plain">on</arg>
+          <arg choice="plain">off</arg>
+        </group></arg>
+      <arg>--natdnsproxy<replaceable>N</replaceable>=<group choice="plain">
+          <arg choice="plain">on</arg>
+          <arg choice="plain">off</arg>
+        </group></arg>
+      <arg>--natdnshostresolver<replaceable>N</replaceable>=<group choice="plain">
+          <arg choice="plain">on</arg>
+          <arg choice="plain">off</arg>
+        </group></arg>
+      <arg>--natsettings<replaceable>N</replaceable>=[<replaceable>mtu</replaceable>],[<replaceable>socksnd</replaceable>],[<replaceable>sockrcv</replaceable>],[<replaceable>tcpsnd</replaceable>],[<replaceable>tcprcv</replaceable>]</arg>
+      <arg>--nataliasmode<replaceable>N</replaceable>=<group choice="plain">
+          <arg choice="plain">default</arg>
+          <arg choice="plain">[log],[proxyonly],[sameports]</arg>
+        </group></arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-modifyvm-other-hardware">
+      <command>VBoxManage modifyvm</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg>--mouse=<group choice="plain">
+          <arg choice="plain">ps2</arg>
+          <arg choice="plain">usb</arg>
+          <arg choice="plain">usbtablet</arg>
+          <arg choice="plain">usbmultitouch</arg>
+        </group></arg>
+      <arg>--keyboard=<group choice="plain">
+          <arg choice="plain">ps2</arg>
+          <arg choice="plain">usb</arg>
+        </group></arg>
+      <arg>--uart<replaceable>N</replaceable>=<group choice="plain">
+          <arg choice="plain">off</arg>
+          <arg choice="plain"><replaceable>IO-base</replaceable> <replaceable>IRQ</replaceable></arg>
+        </group></arg>
+      <arg>--uartmode<replaceable>N</replaceable>=<group choice="plain">
+          <arg choice="plain">disconnected</arg>
+          <arg choice="plain">server <replaceable>pipe</replaceable></arg>
+          <arg choice="plain">client <replaceable>pipe</replaceable></arg>
+          <arg choice="plain">tcpserver <replaceable>port</replaceable></arg>
+          <arg choice="plain">tcpclient <replaceable>hostname</replaceable>:<replaceable>port</replaceable></arg>
+          <arg choice="plain">file <replaceable>filename</replaceable></arg>
+          <arg choice="plain"><replaceable>device-name</replaceable></arg>
+        </group></arg>
+      <arg>--uarttype<replaceable>N</replaceable>=<group choice="plain">
+          <arg choice="plain">16450</arg>
+          <arg choice="plain">16550A</arg>
+          <arg choice="plain">16750</arg>
+        </group></arg>
+      <arg>--lptmode<replaceable>N</replaceable>=<replaceable>device-name</replaceable></arg>
+      <arg>--lpt<replaceable>N</replaceable>=<group choice="plain">
+          <arg choice="plain">off</arg>
+          <arg choice="plain"><replaceable>IO-base</replaceable> <replaceable>IRQ</replaceable></arg>
+        </group></arg>
+      <arg>--audio=<group choice="plain">
+          <arg choice="plain">none</arg>
+          <arg choice="plain">null</arg>
+          <arg choice="plain">dsound</arg>
+          <arg choice="plain">oss</arg>
+          <arg choice="plain">alsa</arg>
+          <arg choice="plain">pulse</arg>
+          <arg choice="plain">coreaudio</arg>
+        </group></arg>
+      <arg>--audiocontroller=<group choice="plain">
+          <arg choice="plain">ac97</arg>
+          <arg choice="plain">hda</arg>
+          <arg choice="plain">sb16</arg>
+        </group></arg>
+      <arg>--audiocodec=<group choice="plain">
+          <arg choice="plain">stac9700</arg>
+          <arg choice="plain">ad1980</arg>
+          <arg choice="plain">stac9221</arg>
+          <arg choice="plain">sb16</arg>
+        </group></arg>
+      <arg>--audioin=<group choice="plain">
+          <arg choice="plain">on</arg>
+          <arg choice="plain">off</arg>
+        </group></arg>
+      <arg>--audioout=<group choice="plain">
+          <arg choice="plain">on</arg>
+          <arg choice="plain">off</arg>
+        </group></arg>
+      <arg>--clipboard=<group choice="plain">
+          <arg choice="plain">disabled</arg>
+          <arg choice="plain">hosttoguest</arg>
+          <arg choice="plain">guesttohost</arg>
+          <arg choice="plain">bidirectional</arg>
+        </group></arg>
+      <arg>--draganddrop=<group choice="plain">
+          <arg choice="plain">disabled</arg>
+          <arg choice="plain">hosttoguest</arg>
+          <arg choice="plain">guesttohost</arg>
+          <arg choice="plain">bidirectional</arg>
+        </group></arg>
+      <arg>--monitorcount=<replaceable>number</replaceable></arg>
+      <arg>--usbehci=<group choice="plain">
+          <arg choice="plain">on</arg>
+          <arg choice="plain">off</arg>
+        </group></arg>
+      <arg>--usbohci=<group choice="plain">
+          <arg choice="plain">on</arg>
+          <arg choice="plain">off</arg>
+        </group></arg>
+      <arg>--usbxhci=<group choice="plain">
+          <arg choice="plain">on</arg>
+          <arg choice="plain">off</arg>
+        </group></arg>
+      <arg>--usbrename=<replaceable>old-name</replaceable> <replaceable>new-name</replaceable></arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-modifyvm-recording">
+      <command>VBoxManage modifyvm</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg>--recording=<group choice="plain">
+          <arg choice="plain">on</arg>
+          <arg choice="plain">off</arg>
+        </group></arg>
+      <arg>--recordingscreens=<group choice="plain">
+          <arg choice="plain">all</arg>
+          <arg choice="plain"><replaceable>screen-ID</replaceable> [<replaceable>screen-ID</replaceable>...]</arg>
+        </group></arg>
+      <arg>--recordingfile=<replaceable>filename</replaceable></arg>
+      <arg>--recordingmaxsize=<replaceable>MB</replaceable></arg>
+      <arg>--recordingmaxtime=<replaceable>msec</replaceable></arg>
+      <arg>--recordingopts= <arg choice="plain"><replaceable>key</replaceable>=<replaceable>value</replaceable> [,<replaceable>key</replaceable>=<replaceable>value</replaceable>...]</arg></arg>
+      <arg>--recordingvideofps=<replaceable>fps</replaceable></arg>
+      <arg>--recordingvideorate=<replaceable>rate</replaceable></arg>
+      <arg>--recordingvideores=<replaceable>width</replaceable> <replaceable>height</replaceable></arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-modifyvm-vrde">
+      <command>VBoxManage modifyvm</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg>--vrde=<group choice="plain">
+          <arg choice="plain">on</arg>
+          <arg choice="plain">off</arg>
+        </group></arg>
+      <arg>--vrdeproperty=<replaceable>property-name</replaceable>= <arg><replaceable>property-value</replaceable></arg></arg>
+      <arg>--vrdeextpack=<group choice="plain">
+          <arg choice="plain">default</arg>
+          <arg choice="plain"><replaceable>name</replaceable></arg>
+        </group></arg>
+      <arg>--vrdeport=<replaceable>port</replaceable></arg>
+      <arg>--vrdeaddress=<replaceable>hostip</replaceable></arg>
+      <arg>--vrdeauthtype=<group choice="plain">
+          <arg choice="plain">null</arg>
+          <arg choice="plain">external</arg>
+          <arg choice="plain">guest</arg>
+        </group></arg>
+      <arg>--vrdeauthlibrary=<group choice="plain">
+          <arg choice="plain">default</arg>
+          <arg choice="plain"><replaceable>name</replaceable></arg>
+        </group></arg>
+      <arg>--vrdemulticon=<group choice="plain">
+          <arg choice="plain">on</arg>
+          <arg choice="plain">off</arg>
+        </group></arg>
+      <arg>--vrdereusecon=<group choice="plain">
+          <arg choice="plain">on</arg>
+          <arg choice="plain">off</arg>
+        </group></arg>
+      <arg>--vrdevideochannel=<group choice="plain">
+          <arg choice="plain">on</arg>
+          <arg choice="plain">off</arg>
+        </group></arg>
+      <arg>--vrdevideochannelquality=<replaceable>percent</replaceable></arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-modifyvm-teleport">
+      <command>VBoxManage modifyvm</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg>--teleporter=<group choice="plain">
+          <arg choice="plain">on</arg>
+          <arg choice="plain">off</arg>
+        </group></arg>
+      <arg>--teleporterport=<replaceable>port</replaceable></arg>
+      <arg>--teleporteraddress=<group choice="plain">
+          <arg choice="plain"><replaceable>address</replaceable></arg>
+          <arg choice="plain">empty</arg>
+        </group></arg>
+      <arg>--teleporterpassword=<replaceable>password</replaceable></arg>
+      <arg>--teleporterpasswordfile=<group choice="plain">
+          <arg choice="plain"><replaceable>filename</replaceable></arg>
+          <arg choice="plain">stdin</arg>
+        </group></arg>
+      <arg>--cpuid-portability-level=<replaceable>level</replaceable></arg>
+      <arg>--cpuid-set=<replaceable>leaf</replaceable> <arg>:<replaceable>subleaf</replaceable></arg> <replaceable>eax</replaceable> <replaceable>ebx</replaceable> <replaceable>ecx</replaceable> <replaceable>edx</replaceable></arg>
+      <arg>--cpuid-remove=<replaceable>leaf</replaceable> <arg>:<replaceable>subleaf</replaceable></arg></arg>
+      <arg>--cpuidremoveall</arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-modifyvm-debugging">
+      <command>VBoxManage modifyvm</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg>--tracing-enabled=<group choice="plain">
+          <arg choice="plain">on</arg>
+          <arg choice="plain">off</arg>
+        </group></arg>
+      <arg>--tracing-config=<replaceable>string</replaceable></arg>
+      <arg>--tracing-allow-vm-access=<group choice="plain">
+          <arg choice="plain">on</arg>
+          <arg choice="plain">off</arg>
+        </group></arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-modifyvm-usbcardreader">
+      <command>VBoxManage modifyvm</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg>--usbcardreader=<group choice="plain">
+          <arg choice="plain">on</arg>
+          <arg choice="plain">off</arg>
+        </group></arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-modifyvm-autostart">
+      <command>VBoxManage modifyvm</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg>--autostart-enabled=<group choice="plain">
+          <arg choice="plain">on</arg>
+          <arg choice="plain">off</arg>
+        </group></arg>
+      <arg>--autostart-delay=<replaceable>seconds</replaceable></arg>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+
+  <refsect1>
+    <title>Description</title>
+    <para>
+      The <command>VBoxManage modifyvm</command> command enables you to
+      change the properties of a registered virtual machine (VM) that is
+      not running.
+    </para>
+    <para>
+      Most of these properties correspond to the VM settings that are
+      shown in each VM's <emphasis role="bold">Settings</emphasis>
+      dialog in the VirtualBox Manager. See
+      <xref linkend="BasicConcepts" />. However, some settings can only
+      be viewed and managed with the <command>VBoxManage</command>
+      command.
+    </para>
+    <para>
+      You can use the <command>VBoxManage modifyvm</command> command to
+      change VM settings only when the VM is powered off. The VM cannot
+      be running or in saved state when you use this command.
+    </para>
+    <para>
+      You can use the <command>VBoxManage controlvm</command> command to
+      dynamically change some VM machine settings while the VM is
+      running. See <xref linkend="vboxmanage-controlvm" />.
+    </para>
+    <refsect2 id="vboxmanage-modifyvm-general">
+      <title>General Settings</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The following options enable you to modify general information
+        about your VM.
+      </para>
+      <para>
+        The <command>VBoxManage modifyvm</command> command supports the
+        following options:
+      </para>
+      <variablelist>
+        <varlistentry>
+          <term><option>--name=<replaceable>vmname</replaceable></option></term>
+          <listitem><para>
+              Changes the name of the VM and its related internal VM
+              files. See <xref linkend="vboxmanage-createvm"/>.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--groups=<replaceable>group</replaceable></option></term>
+          <listitem><para>
+              Changes the group membership of a VM. Group names always
+              begin with a slash character (<literal>/</literal>) and
+              can be nested. By default, VMs are members of the
+              <literal>/</literal> group.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--description=<replaceable>desc</replaceable></option></term>
+          <listitem><para>
+              Changes the optional VM description. Use a description to
+              record details about the VM in a meaningful way. The GUI
+              interprets HTML markup while the <command>VBoxManage
+              modifyvm</command> command enables you include arbitrary
+              strings that can contain multiple lines.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--ostype=<replaceable>OS-type</replaceable></option></term>
+          <listitem><para>
+              Specifies the guest operating system (OS) to run in the
+              VM. Use the <command>VBoxManage list ostypes</command>
+              command to view the OS type identifiers.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--iconfile=<replaceable>filename</replaceable></option></term>
+          <listitem><para>
+              Specifies the absolute path to the &product-name; icon on
+              the host system. The icon is shown on the VM.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--memory=<replaceable>size</replaceable></option></term>
+          <listitem><para>
+              Specifies the amount of host system RAM to allocate to the
+              VM. The size is in MB. See
+              <xref linkend="gui-createvm" />.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--pagefusion=on | off</option></term>
+          <listitem><para>
+              Enables or disables the Page Fusion feature, which is
+              disabled by default. Use the Page Fusion feature to
+              minimize the memory duplication between VMs that have
+              similar configurations and that run on the same host
+              system. See <xref linkend="guestadd-pagefusion" />.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--vram=<replaceable>size</replaceable></option></term>
+          <listitem><para>
+              Specifies the amount of RAM to allocate to the virtual
+              graphics card. See <xref linkend="settings-display" />.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--acpi=on | off</option></term>
+          <listitem><para>
+              Determines whether the VM has ACPI support. See
+              <xref linkend="settings-motherboard" />.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--ioapic=on | off</option></term>
+          <listitem><para>
+              Determines whether the VM has I/O APIC support. See
+              <xref linkend="settings-motherboard" />.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--pciattach=<replaceable>host-PCI-address</replaceable>[@<replaceable>guest-PCI-host-bus-address</replaceable>]</option></term>
+          <listitem><para>
+              Attaches the specified PCI network controller on the host
+              to the guest VM. You can optionally specify the PCI bus on
+              the guest VM on which to attach the controller. See
+              <xref linkend="pcipassthrough" />.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--pcidetach=<replaceable>host-PCI-address</replaceable></option></term>
+          <listitem><para>
+              Detaches the specified PCI network controller from the
+              attached PCI bus on the guest VM. See
+              <xref linkend="pcipassthrough" />.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--hardwareuuid=<replaceable>uuid</replaceable></option></term>
+          <listitem><para>
+              Specifies the Universally Unique Identifier (UUID) to
+              present to the guest VM in memory tables (DMI/SMBIOS),
+              hardware, and VM properties. By default this hardware UUID
+              is the same as the VM UUID. Use this option when cloning a
+              VM. Note that the teleporting feature automatically
+              handles the UUID value.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--cpus=<replaceable>CPU-count</replaceable></option></term>
+          <listitem><para>
+              Specifies the number of virtual CPUs to assign to the VM.
+              See <xref linkend="settings-processor" />.
+            </para><para>
+              If CPU hot-plugging is enabled, this option specifies the
+              maximum number of virtual CPUs that can be plugged into
+              the VMs.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--cpuhotplug=on | off</option></term>
+          <listitem><para>
+              Enables or disables CPU hot-plugging. When enabled, you
+              can dynamically add virtual CPUs to a VM or remove virtual
+              CPUs from a VM. See <xref linkend="cpuhotplug" />.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--plugcpu=<replaceable>CPU-ID</replaceable></option></term>
+          <listitem><para>
+              Adds a virtual CPU to the VM.
+              <replaceable>CPU-ID</replaceable> is the index of the
+              virtual CPU to add. A valid index value is a number from
+              <literal>0</literal> to the maximum number of CPUs that
+              you configured by using the <option>--cpus</option>
+              option.
+            </para><para>
+              Only use this option if CPU hot-plugging is enabled.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--unplugcpu=<replaceable>CPU-ID</replaceable></option></term>
+          <listitem><para>
+              Removes a virtual CPU from the VM.
+              <replaceable>CPU-ID</replaceable> is the index of the
+              virtual CPU to remove. A valid index value is a number
+              from <literal>1</literal> to the maximum number of CPUs
+              that you configured by using the <option>--cpus</option>
+              option.
+            </para><para>
+              Only use this option if CPU hot-plugging is enabled.
+            </para><para>
+              Note that you cannot remove CPU 0.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--cpuexectioncap=<replaceable>percentage</replaceable></option></term>
+          <listitem><para>
+              Specifies how much CPU time a virtual CPU can use. A valid
+              value is from <literal>1</literal> to
+              <literal>100</literal>. A value of 50 indicates that a
+              single virtual CPU can use up to 50% of a single host CPU.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--pae=on | off</option></term>
+          <listitem><para>
+              Enables or disables physical address extension (PAE). See
+              <xref linkend="settings-processor" />.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--longmode=on | off</option></term>
+          <listitem><para>
+              Enables or disables long mode. See
+              <xref linkend="settings-processor" />.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--ibpb-on-vm-exit=on | off</option></term>
+          <listitem><para>
+              Enables use of Indirect Branch Prediction Barrier (IBPB)
+              on every VM exit.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--ibpb-on-vm-entry=on | off</option></term>
+          <listitem><para>
+              Enables use of Indirect Branch Prediction Barrier (IBPB)
+              on every VM entry.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--spec-ctrl=on | off</option></term>
+          <listitem><para>
+              Enables or disables the exposure of speculation control
+              interfaces to the guest VM. These interfaces must be
+              available on the host system.
+            </para><para>
+              Depending on the host CPU and the workload, enabling
+              speculation control might significantly reduce
+              performance.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--l1d-flush-on-sched=on | off</option></term>
+          <listitem><para>
+              Enables or disables level 1 data cache flushing when a
+              thread is scheduled to execute guest code. See
+              <xref linkend="sec-rec-cve-2018-3646" />.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--l1d-flush-on-vm-entry=on | off</option></term>
+          <listitem><para>
+              Enables or disables level 1 data cache flushing on every
+              VM entry. See <xref linkend="sec-rec-cve-2018-3646" />.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--mds-clear-on-sched=on | off</option></term>
+          <listitem><para>
+              Enables CPU buffer clearing when a thread is scheduled to
+              execute guest code. See
+              <xref linkend="sec-rec-cve-2018-12126-et-al" />.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--mds-clear-on-vm-entry=on | off</option></term>
+          <listitem><para>
+              Enables CPU buffer clearing on every VM entry. See
+              <xref linkend="sec-rec-cve-2018-12126-et-al" />.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--cpu-profile=host | Intel 8086 | Intel 80286 | Intel 80386</option></term>
+          <listitem><para>
+              Specifies the profile to use for guest CPU emulation.
+              Specify a value that is based on the host system CPU
+              (<literal>host</literal>) or one of the following older
+              Intel micro-architectures: <literal>8086</literal>,
+              <literal>80286</literal>, or <literal>80386</literal>.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--hpet=on | off</option></term>
+          <listitem><para>
+              Enables or disables a High Precision Event Timer (HPET)
+              that can replace a legacy system timer. This feature is
+              disabled by default. Note HPET is supported on Windows
+              versions starting with Vista.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--hwvirtex=on | off</option></term>
+          <listitem><para>
+              Enables or disables the use of hardware virtualization
+              extensions in the processor of the host system. Such
+              extensions are Intel VT-x or AMD-V. See
+              <xref linkend="hwvirt" />.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--triplefaultreset=on | off</option></term>
+          <listitem><para>
+              Enables or disables the resetting of the guest VM instead
+              of triggering a Guru Meditation. Some guest VMs raise a
+              triple fault to reset the CPU, so sometimes resetting the
+              guest VM is the best outcome. This option only applies to
+              guests that do not use symmetric multiprocessing (SMP).
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--apic=on | off</option></term>
+          <listitem><para>
+              Enables or disables I/O APIC. With I/O APIC, OSes can use
+              more than 16 interrupt requests (IRQs) to avoid IRQ
+              sharing and to improve reliability. I/O APIC is enabled by
+              default. See <xref linkend="settings-motherboard" />.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--x2apic=on | off</option></term>
+          <listitem><para>
+              Enables or disables the CPU x2APIC feature. CPU x2APIC
+              enables an OS to run more efficiently on high core count
+              configurations and to optimize interrupt distribution in
+              virtualized environments. This feature is enabled by
+              default.
+            </para><para>
+              Disable this feature when the OS that runs on a host
+              system or a guest VM is incompatible with CPU x2APIC.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--paravirtprovider=none | default | legacy | minimal | hyperv | kvm</option></term>
+          <listitem><para>
+              Specifies one of the following paravirtualization
+              interfaces to provide to the guest OS:
+            </para><itemizedlist>
+              <listitem><para>
+                  <literal>none</literal> does not expose any
+                  paravirtualization interface.
+                </para></listitem>
+              <listitem><para>
+                  <literal>default</literal> selects the appropriate
+                  interface based on the guest OS type when starting the
+                  VM. This is the default value used when creating new
+                  VMs.
+                </para></listitem>
+              <listitem><para>
+                  <literal>legacy</literal> selects a paravirtual
+                  interface for VMs that were created by older
+                  &product-name; versions.
+                </para></listitem>
+              <listitem><para>
+                  <literal>minimal</literal> is required for Mac OS X
+                  guest VMs.
+                </para></listitem>
+              <listitem><para>
+                  <literal>kvm</literal> is recommended for Linux guest
+                  VMs. See <xref linkend="gimproviders" />.
+                </para></listitem>
+              <listitem><para>
+                  <literal>hyperv</literal> is recommended for Windows
+                  guest VMs. See <xref linkend="gimproviders" />.
+                </para></listitem>
+            </itemizedlist></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--paravirtdebug=<replaceable>property</replaceable>=<replaceable>value</replaceable></option></term>
+          <listitem><para>
+              Specifies debugging properties that are specific to the
+              paravirtualization provider configured for the specified
+              VM. See <xref linkend="gimdebug" />.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--nestedpaging=on | off</option></term>
+          <listitem><para>
+              Enables or disables the nested paging feature in the
+              processor of the host system. This option is available
+              only when hardware virtualization is enabled. See
+              <xref linkend="hwvirt" /> and
+              <xref linkend="sec-rec-cve-2018-3646" />.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--largepages=on | off</option></term>
+          <listitem><para>
+              Enables or disables the hypervisor's use of large pages,
+              which can improve performance by up to 5%. The use of
+              large pages reduces TLB use and overhead. This option is
+              available only when both hardware virtualization and
+              nested paging are enabled.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--vtxvpid=on | off</option></term>
+          <listitem><para>
+              Enables or disables the use of the tagged TLB (VPID)
+              feature in the processor of your host system. See
+              <xref linkend="hwvirt" />. This option is available only
+              when hardware virtualization is enabled on Intel VT-x.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--vtxux=on | off</option></term>
+          <listitem><para>
+              Enables or disables the use of unrestricted guest mode for
+              executing the guest VM. This option is available only when
+              hardware virtualization is enabled on Intel VT-x.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--accelerated3d=on | off</option></term>
+          <listitem><para>
+              Enables or disables hardware 3D acceleration. This option
+              is available only when the Guest Additions are installed.
+              See <xref linkend="guestadd-3d" />.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--accelerated2dvideo=on | off</option></term>
+          <listitem><para>
+              Enables or disables 2D video acceleration. This option is
+              available only when the Guest Additions are installed. See
+              <xref linkend="guestadd-2d" />.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--chipset=piix3 | ich9</option></term>
+          <listitem><para>
+              Specify the Intel chipset for &product-name; to emulate.
+              The default value is the Intel PIIX3 chipset
+              (<literal>piix3</literal>).
+            </para><para>
+              Change this value only if you need to relax some of the
+              chipset constraints. See
+              <xref linkend="settings-motherboard" />.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--bioslogofacein=on | off</option></term>
+          <listitem><para>
+              Specifies whether the BIOS logo fades in on VM startup. By
+              default, an &product-name; logo is shown.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--bioslogofacein=on | off</option></term>
+          <listitem><para>
+              Specifies whether the BIOS logo fades out on VM startup.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--bioslogodisplaytime=<replaceable>msec</replaceable></option></term>
+          <listitem><para>
+              Specifies the amount of time in milliseconds that the BIOS
+              logo is visible.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--bioslogoimagepath=<replaceable>pathname</replaceable></option></term>
+          <listitem><para>
+              Replaces the existing BIOS logo with a different image.
+              The replacement image must be an uncompressed 256-color
+              bitmap file (BMP) that does not contain color space
+              information (Windows 3.0 format). Also ensure that the
+              image is no larger than 640 X 480 pixels.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--biosbootmenu=disabled | menuonly | messageandmenu</option></term>
+          <listitem><para>
+              Specifies whether the BIOS permits you to select a
+              temporary boot device. Valid values are:
+            </para><itemizedlist>
+              <listitem><para>
+                  <literal>disabled</literal> outputs the alternate boot
+                  device message and permits you to select a temporary
+                  boot device by pressing F12.
+                </para></listitem>
+              <listitem><para>
+                  <literal>menuonly</literal> suppresses the alternate
+                  boot device message, but permits you to select a
+                  temporary boot device by pressing F12.
+                </para></listitem>
+              <listitem><para>
+                  <literal>messageandmenu</literal> suppresses the
+                  alternate boot device message and prevents you from
+                  selecting a temporary boot device by pressing F12.
+                </para></listitem>
+            </itemizedlist></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--biosapic=x2apic | apic | disabled</option></term>
+          <listitem><para>
+              Specifies the APIC level of the firmware. Valid values
+              are: <literal>x2apic</literal>, <literal>apic</literal>,
+              and <literal>disabled</literal>. When the value is
+              <literal>disabled</literal>, neither the
+              <literal>apic</literal> nor the <literal>x2apic</literal>
+              version of the firmware is used.
+            </para><para>
+              Note that if you specify the <literal>x2apic</literal>
+              value and x2APIC is unsupported by the virtual CPU, the
+              APIC level downgrades to <literal>apic</literal>, if
+              supported. Otherwise, the APIC level downgrades to
+              <literal>disabled</literal>. Similarly, if you specify the
+              <literal>apic</literal> value and APIC is unsupported by
+              the virtual CPU, the APIC level downgrades to
+              <literal>disabled</literal>.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--biossystemtimeoffset=<replaceable>msec</replaceable></option></term>
+          <listitem><para>
+              Specifies the time offset in milliseconds of the guest VM
+              relative to the time on the host system. If the offset
+              value is positive, the guest VM time runs ahead of the
+              time on the host system.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--biospxedebug=on | off</option></term>
+          <listitem><para>
+              Enables or disable additional debugging output when using
+              the Intel PXE boot ROM. The debug output is written to the
+              release log file. See
+              <xref linkend="collect-debug-info" />.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--boot<replaceable>N</replaceable>=none | floppy | dvd | disk | net</option></term>
+          <listitem><para>
+              Enables you to specify the boot device order for the VM by
+              assigning one of the device types to each of the four boot
+              device slots that are represented by
+              <replaceable>N</replaceable> in the option name.
+            </para><para>
+              A value of 1 for <replaceable>N</replaceable> represents
+              the first boot device slot, and so on.
+            </para><para>
+              The device types are <literal>floppy</literal> for floppy
+              disks, <literal>dvd</literal> for DVDs or CDs,
+              <literal>disk</literal> for hard disks, and
+              <literal>net</literal> for a network device. A value of
+              <literal>none</literal> indicates that no boot device is
+              associated with the specified slot.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--rtcuseutc=on | off</option></term>
+          <listitem><para>
+              Specifies whether the real-time clock (RTC) uses
+              coordinated universal time (UTC). See
+              <xref linkend="settings-motherboard" />.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--graphicscontroller=none | vboxvga | vmsvga | vboxsvga</option></term>
+          <listitem><para>
+              Specifies the graphics controller type to use. See
+              <xref linkend="settings-screen" />.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--snapshotfolder=default | <replaceable>pathname</replaceable></option></term>
+          <listitem><para>
+              Specifies the name of the VM's snapshot storage folder. If
+              you specify <literal>default</literal>, the folder name is
+              <filename>Snapshots/</filename> in the machine folder.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--firmware=bios | efi | efi32 | efi64</option></term>
+          <listitem><para>
+              Specifies the firmware used to boot the VM. Valid values
+              are: <literal>bios</literal>, <literal>efi</literal>,
+              <literal>efi32</literal>, or <literal>efi64</literal>. Use
+              EFI values with care.
+            </para><para>
+              By default, BIOS firmware is used.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--guestmemoryballoon=<replaceable>size</replaceable></option></term>
+          <listitem><para>
+              Specifies the size of the guest memory balloon. The guest
+              memory balloon is the memory allocated by the Guest
+              Additions from the guest OS and returned to the hypervisor
+              for use by other VMs. Specify
+              <replaceable>size</replaceable> in megabytes. The default
+              value is <literal>0</literal> megabytes. See
+              <xref linkend="guestadd-balloon" />.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--defaultfrontend=default | <replaceable>name</replaceable></option></term>
+          <listitem><para>
+              Specifies the default frontend to use when starting the
+              specified VM. If you specify <literal>default</literal>,
+              the VM is shown in a window on the user's desktop. See
+              <xref linkend="vboxmanage-startvm" />.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--nested-hw-virt=on | off</option></term>
+          <listitem><para>
+              Enables or disables nested virtualization. See
+              <xref linkend="nested-virt" />.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--vm-process-priority=default | flat | low | normal | high</option></term>
+          <listitem><para>
+              Specifies the priority scheme of the VM process to use
+              when starting the specified VM and while the VM runs.
+            </para></listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+    <refsect2 id="vboxmanage-modifyvm-networking">
+      <title>Networking Settings</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The following options enable you to modify networking on your
+        VM. With all these options, <replaceable>N</replaceable> is an
+        integer greater than zero that represents the particular virtual
+        network adapter to configure.
+      </para>
+      <variablelist>
+        <varlistentry>
+          <term><option>--nic<replaceable>N</replaceable>=none | null | nat | natnetwork | bridged | intnet | hostonly | generic</option></term>
+          <listitem><para>
+              Configures the network type used by each virtual network
+              card in the VM.
+            </para><para>
+              The following valid values correspond to the modes
+              described in <xref linkend="networkingmodes" />:
+            </para><itemizedlist>
+              <listitem><para>
+                  <literal>none</literal> &ndash; No networking present
+                </para></listitem>
+              <listitem><para>
+                  <literal>null</literal> &ndash; Not connected to the
+                  host system
+                </para></listitem>
+              <listitem><para>
+                  <literal>nat</literal> &ndash; Use network address
+                  translation (NAT)
+                </para></listitem>
+              <listitem><para>
+                  <literal>natnetwork</literal> &ndash; Use a NAT
+                  metwork
+                </para></listitem>
+              <listitem><para>
+                  <literal>bridged</literal> &ndash; Use bridged
+                  networking
+                </para></listitem>
+              <listitem><para>
+                  <literal>intnet</literal> &ndash; Use internal
+                  networking
+                </para></listitem>
+              <listitem><para>
+                  <literal>hostonly</literal> &ndash; Use host-only
+                  networking
+                </para></listitem>
+              <listitem><para>
+                  <literal>generic</literal> &ndash; Access rarely used
+                  sub-modes
+                </para></listitem>
+            </itemizedlist></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--nictype<replaceable>N</replaceable>=Am79C970A | Am79C973 | 82540EM | 82543GC | 82545EM | virtio</option></term>
+          <listitem><para>
+              Identifies the type of networking hardware that
+              &product-name; presents to the guest VM for the specified
+              virtual network card. See <xref linkend="nichardware" />.
+            </para><para>
+              Valid values are as follows:
+            </para><itemizedlist>
+              <listitem><para>
+                  <literal>Am79C970A</literal> represents the AMD PCNet
+                  PCI II.
+                </para></listitem>
+              <listitem><para>
+                  <literal>Am79C973</literal> represents the AMD PCNet
+                  FAST III, which is the default value.
+                </para></listitem>
+              <listitem><para>
+                  <literal>82540EM</literal> represents the Intel
+                  PRO/1000 MT Desktop.
+                </para></listitem>
+              <listitem><para>
+                  <literal>82543GC</literal> represents the Intel
+                  PRO/1000 T Server.
+                </para></listitem>
+              <listitem><para>
+                  <literal>82545EM</literal> represents the Intel
+                  PRO/1000 MT Server.
+                </para></listitem>
+              <listitem><para>
+                  <literal>virtio</literal> represents a paravirtualized
+                  network adapter.
+                </para></listitem>
+            </itemizedlist></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--cableconnected<replaceable>N</replaceable>=on | off</option></term>
+          <listitem><para>
+              Temporarily disconnects a virtual network interface, as if
+              you pull a network cable from a physical network card. You
+              might use this option to reset certain software components
+              in the VM.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--nictrace<replaceable>N</replaceable>=on | off</option></term>
+          <listitem><para>
+              Enables or disables network tracing for the specified
+              virtual network card.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--nictracefile<replaceable>N</replaceable>=<replaceable>filename</replaceable></option></term>
+          <listitem><para>
+              Specifies the absolute path of the file in which to write
+              trace log information. Use this option if network tracing
+              is enabled.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--nicproperty<replaceable>N</replaceable>=<replaceable>name</replaceable>=<replaceable>value</replaceable></option></term>
+          <listitem><para>
+              Enables you to set property values and pass them to rarely
+              used network backends. To use this option, you must also
+              use the <option>--nicgenericdrv</option> option.
+            </para><para>
+              These properties are specific to the backend engine and
+              differ between the UDP Tunnel and the VDE backend drivers.
+              For property examples, see
+              <xref linkend="network_udp_tunnel" />.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--nicspeed<replaceable>N</replaceable>=<replaceable>kbps</replaceable></option></term>
+          <listitem><para>
+              Specifies the throughput rate in kilobits per second for
+              rarely used networking sub-modes such as VDE network and
+              UDP Tunnel. Use this option only if you used the
+              <option>--nic</option> option to enable generic networking
+              for the specified virtual network card.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--nicbootprio<replaceable>N</replaceable>=<replaceable>priority</replaceable></option></term>
+          <listitem><para>
+              Assigns a priority to each NIC that determines the order
+              in which that NIC is used to perform a PXE network boot.
+              The priority value is an integer in the range from
+              <literal>0</literal> to <literal>4</literal>. Priority
+              <literal>0</literal>, which is the default value, is the
+              lowest priority. Priority <literal>1</literal> is the
+              highest priority, and priorities <literal>3</literal> and
+              <literal>4</literal> are lower.
+            </para><para>
+              This option has an effect only when using the Intel PXE
+              boot ROM.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--nicpromisc<replaceable>N</replaceable>=deny | allow-vms | allow-all</option></term>
+          <listitem><para>
+              Enables you to specify whether to deny or allow
+              promiscuous mode for the specified VM virtual network
+              card. This option is relevant only for bridged networking.
+              Valid values are as follows:
+            </para><itemizedlist>
+              <listitem><para>
+                  <literal>deny</literal> hides any traffic that is not
+                  intended for the VM. This is the default value.
+                </para></listitem>
+              <listitem><para>
+                  <literal>allow-vms</literal> hides all host traffic
+                  from the VM, but allows the VM to see traffic to and
+                  from other VMs.
+                </para></listitem>
+              <listitem><para>
+                  <literal>allow-all</literal> allows the VM to see all
+                  traffic.
+                </para></listitem>
+            </itemizedlist></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--nicbandwidthgroup<replaceable>N</replaceable>=none | <replaceable>name</replaceable></option></term>
+          <listitem><para>
+              Adds or removes a bandwidth group assignment to the
+              specified virtual network interface. Valid values are as
+              follows:
+            </para><itemizedlist>
+              <listitem><para>
+                  <literal>none</literal> removes any current bandwidth
+                  group assignment from the specified virtual network
+                  interface.
+                </para></listitem>
+              <listitem><para>
+                  <replaceable>name</replaceable> adds a bandwidth group
+                  assignment to the specified virtual network interface.
+                </para></listitem>
+            </itemizedlist><para>
+              See <xref linkend="network_bandwidth_limit" />.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--bridgeadapter<replaceable>N</replaceable>=none | <replaceable>device-name</replaceable></option></term>
+          <listitem><para>
+              Specifies the host interface to use for the specified
+              virtual network interface. See
+              <xref linkend="network_bridged" />. Use this option only
+              if you used the <option>--nic</option> option to enable
+              bridged networking for the specified virtual network card.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--hostonlyadapter<replaceable>N</replaceable>=none | <replaceable>device-name</replaceable></option></term>
+          <listitem><para>
+              Specifies which host-only networking interface to use for
+              the specified virtual network interface. See
+              <xref linkend="network_hostonly" />. Use this option only
+              if you used the <option>--nic</option> option to enable
+              host-only networking for the specified virtual network
+              card.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--intnet<replaceable>N</replaceable>=<replaceable>network-name</replaceable></option></term>
+          <listitem><para>
+              Specifies the name of the internal network. See
+              <xref linkend="network_internal" />. Use this option only
+              if you used the <option>--nic</option> option to enable
+              internal networking for the specified virtual network
+              card.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--nat-network<replaceable>N</replaceable>=<replaceable>network-name</replaceable></option></term>
+          <listitem><para>
+              Specifies the name of the NAT network to which this
+              adapter is connected. Use this option only if the
+              networking type is <literal>natnetwork</literal>, not
+              <literal>nat</literal>.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--nicgenericdrv<replaceable>N</replaceable>=<replaceable>backend-driver</replaceable></option></term>
+          <listitem><para>
+              Enables you to access rarely used networking sub-modes,
+              such as VDE networks and UDP Tunnel. Use this option only
+              if you used the <option>--nic</option> option to enable
+              generic networking for a virtual network card.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--macaddress<replaceable>N</replaceable>=auto | <replaceable>MAC-address</replaceable></option></term>
+          <listitem><para>
+              Specifies the MAC address of the specified network adapter
+              on the VM. By default, &product-name; assigns a random MAC
+              address to each network adapter at VM creation.
+            </para></listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+    <refsect2 id="vboxmanage-modifyvm-networking-nat">
+      <title>NAT Networking Settings</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The following options use <replaceable>N</replaceable> to
+        specify the particular virtual network adapter to modify.
+      </para>
+      <variablelist>
+        <varlistentry>
+          <term><option>--natnet<replaceable>N</replaceable>=default | <replaceable>network</replaceable></option></term>
+          <listitem><para>
+              Specifies the IP address range to use for this network.
+              See <xref linkend="changenat" />. Use this option only if
+              the networking type is <literal>nat</literal>, not
+              <literal>natnetwork</literal>.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--natpf<replaceable>N</replaceable>=[<replaceable>name</replaceable>],tcp | udp,[<replaceable>host-IP</replaceable>],<replaceable>hostport</replaceable>,[<replaceable>guest-IP</replaceable>],<replaceable>guestport</replaceable></option></term>
+          <listitem><para>
+              Specifies the NAT port-forwarding rule to use. See
+              <xref linkend="natforward" />.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--natpf<replaceable>N</replaceable>=delete <replaceable>name</replaceable></option></term>
+          <listitem><para>
+              Specifies the NAT port-forwarding rule to delete. See
+              <xref linkend="natforward" />.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--nattftpprefix<replaceable>N</replaceable>=<replaceable>prefix</replaceable></option></term>
+          <listitem><para>
+              Specifies a prefix to use for the built-in TFTP server.
+              For example, you might use a prefix to indicate where the
+              boot file is located. See <xref linkend="nat-tftp" /> and
+              <xref linkend="nat-adv-tftp" />.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--nattftpfile<replaceable>N</replaceable>=<replaceable>boot-file</replaceable></option></term>
+          <listitem><para>
+              Specifies the name of the TFT boot file. See
+              <xref linkend="nat-adv-tftp" />.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--nattftpserver<replaceable>N</replaceable>=<replaceable>tftp-server</replaceable></option></term>
+          <listitem><para>
+              Specifies the address of the TFTP server from which to
+              boot. See <xref linkend="nat-adv-tftp" />.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--natbindip<replaceable>N</replaceable>=<replaceable>IP-address</replaceable></option></term>
+          <listitem><para>
+              Specifies an alternate IP address to which the NAT engine
+              binds. See <xref linkend="nat-adv-settings" />. By
+              default, &product-name;'s NAT engine routes TCP/IP packets
+              through the default interface assigned by the host's
+              TCP/IP stack.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--natdnspassdomain<replaceable>N</replaceable>=on | off</option></term>
+          <listitem><para>
+              Specifies whether the built-in DHCP server passes the
+              domain name for network name resolution.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--natdnsproxy<replaceable>N</replaceable>=on | off</option></term>
+          <listitem><para>
+              Specifies whether the NAT engine is the proxy for all
+              guest DNS requests to the host system's DNS servers. See
+              <xref linkend="nat-adv-dns" />.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--natdnshostresolver<replaceable>N</replaceable>=on | off</option></term>
+          <listitem><para>
+              Specifies whether the NAT engine uses the host system's
+              resolver mechanisms to handle DNS requests. See
+              <xref linkend="nat-adv-dns" />.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--natsettings<replaceable>N</replaceable>=[<replaceable>mtu</replaceable>],[<replaceable>socksnd</replaceable>],[<replaceable>sockrcv</replaceable>],[<replaceable>tcpsnd</replaceable>],[<replaceable>tcprcv</replaceable>]</option></term>
+          <listitem><para>
+              Specifies values for tuning NAT performance. See
+              <xref linkend="nat-adv-settings" />.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--nataliasmode<replaceable>N</replaceable>=default | [log],[proxyonly],[sameports]</option></term>
+          <listitem><para>
+              Specifies the behavior of the NAT engine core as follows:
+            </para><itemizedlist>
+              <listitem><para>
+                  <literal>log</literal> enables logging
+                </para></listitem>
+              <listitem><para>
+                  <literal>proxyonly</literal> switches off aliasing
+                  mode and makes NAT transparent
+                </para></listitem>
+              <listitem><para>
+                  <literal>sameports</literal> enforces that the NAT
+                  engine sends packets through the same port on which
+                  they originated
+                </para></listitem>
+              <listitem><para>
+                  <literal>default</literal> disables all aliasing modes
+                </para></listitem>
+            </itemizedlist><para>
+              For more information, see
+              <xref linkend="nat-adv-alias" />.
+            </para></listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+    <refsect2 id="vboxmanage-modifyvm-other-hardware">
+      <title>Other Hardware Settings</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The following options enable you to configure other hardware,
+        such as the serial port, monitor, audio device, USB ports, and
+        the clipboard, and drag-and-drop features.
+      </para>
+      <variablelist>
+        <varlistentry>
+          <term><option>--mouse=ps2 | usb | usbtablet | usbmultitouch</option></term>
+          <listitem><para>
+              Specifies the mode of the mouse to use in the VM. Valid
+              values are: <literal>ps2</literal>,
+              <literal>usb</literal>, <literal>usbtablet</literal>, and
+              <literal>usbmultitouch</literal>.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--keyboard=ps2 | usb</option></term>
+          <listitem><para>
+              Specifies the mode of the keyboard to use in the VM. Valid
+              values are: <literal>ps2</literal> and
+              <literal>usb</literal>.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--uart<replaceable>N</replaceable>=off | <replaceable>I/O-base</replaceable> <replaceable>IRQ</replaceable></option></term>
+          <listitem><para>
+              Configures virtual serial ports for the VM.
+              <replaceable>N</replaceable> represents the serial port to
+              modify. Valid values are <literal>off</literal> to disable
+              the port or an I/O base address and IRQ. For information
+              about the traditional COM port I/O base address and IRQ
+              values, see <xref linkend="serialports" />.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--uartmode<replaceable>N</replaceable>=<replaceable>mode</replaceable></option></term>
+          <listitem><para>
+              Specifies how &product-name; connects the specified
+              virtual serial port to the host system that runs the VM.
+              See <xref linkend="serialports" />.
+            </para><para>
+              Ensure that you first configure the virtual serial port by
+              using the
+              <option>--uart<replaceable>N</replaceable></option>
+              option.
+            </para><para>
+              Specify one of the following connection modes for each
+              port:
+            </para><itemizedlist>
+              <listitem><para>
+                  <literal>disconnected</literal> indicates that even
+                  though the serial port is shown to the guest VM, it is
+                  not connected. This state is like a physical COM port
+                  without a cable attached.
+                </para></listitem>
+              <listitem><para>
+                  <literal>server</literal>
+                  <replaceable>pipe-name</replaceable> creates the
+                  specified named pipe or local domain socket on the
+                  host system and connects the virtual serial device to
+                  it.
+                </para><para>
+                  On a Windows host system,
+                  <replaceable>pipe-name</replaceable> is a named pipe
+                  that has a name that uses the following form:
+                  <literal>\\.\<replaceable>pipe</replaceable>\</literal>.
+                </para><para>
+                  On a Linux host system,
+                  <replaceable>pipe-name</replaceable> is a local domain
+                  socket.
+                </para></listitem>
+              <listitem><para>
+                  <literal>client</literal>
+                  <replaceable>pipe-name</replaceable> connects the
+                  virtual serial device to the specified named pipe or
+                  local domain socket.
+                </para><para>
+                  Note that the named pipe or local domain socket must
+                  already exist.
+                </para></listitem>
+              <listitem><para>
+                  <literal>tcpserver</literal>
+                  <replaceable>port</replaceable> creates a TCP socket
+                  with the specified TCP port on the host system and
+                  connects the virtual serial device to it.
+                </para><para>
+                  For UNIX-like systems, use ports over 1024 for
+                  non-root users.
+                </para></listitem>
+              <listitem><para>
+                  <literal>tcpclient</literal>
+                  <replaceable>hostname</replaceable>:<replaceable>port</replaceable>
+                  connects the virtual serial device to the TCP socket.
+                </para><para>
+                  Note that the TCP socket must already exist.
+                </para></listitem>
+              <listitem><para>
+                  <literal>file</literal>
+                  <replaceable>filename</replaceable> redirects the
+                  serial port output to the specified raw file. Ensure
+                  that <replaceable>filename</replaceable> is the
+                  absolute path of the on the host system.
+                </para></listitem>
+              <listitem><para>
+                  <replaceable>device-name</replaceable>: specifies the
+                  device name of a physical hardware serial port on the
+                  specified host system to which the virtual serial port
+                  connects.
+                </para><para>
+                  Use this mode to connect a physical serial port to a
+                  VM.
+                </para><para>
+                  On a Windows host system, the device name is a COM
+                  port such as <literal>COM1</literal>. On a Linux host
+                  system, the device name is similar to
+                  <filename>/dev/ttyS0</filename>.
+                </para></listitem>
+            </itemizedlist></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--uarttype<replaceable>N</replaceable>=<replaceable>UART-type</replaceable></option></term>
+          <listitem><para>
+              Configures the UART type for the specified virtual serial
+              port (<replaceable>N</replaceable>). Valid values are
+              <literal>16450</literal>, <literal>16550A</literal>, and
+              <literal>16750</literal>. The default value is
+              <literal>16550A</literal>.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--lptmode<replaceable>N</replaceable>=<replaceable>device-name</replaceable></option></term>
+          <listitem><para>
+              Specifies the device name of the parallel port to use.
+              Ensure that you use this option before using the
+              <option>--lpt</option> option.
+            </para><para>
+              For a Windows host system, use a device name such as
+              <command>lpt1</command>. For a Linux host system, use a
+              device name such as <filename>/dev/lp0</filename>.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--lpt<replaceable>N</replaceable>=<replaceable>I/O-base</replaceable> <replaceable>IRQ</replaceable></option></term>
+          <listitem><para>
+              Specifies the I/O base address and IRQ of the parallel
+              port. Ensure that you use this option after using the
+              <option>--lptmode</option> option.
+            </para><para>
+              You can view the I/O base address and IRQ that the VM uses
+              for the parallel port in the Device Manager.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--audio=<replaceable>type</replaceable></option></term>
+          <listitem><para>
+              Specifies whether the VM has audio support, and if so,
+              which type. Valid audio type values are:
+              <literal>none</literal>, <literal>null</literal>,
+              <literal>dsound</literal>, <literal>oss</literal>,
+              <literal>alsa</literal>, <literal>pulse</literal>, and
+              <literal>coreaudio</literal>.
+            </para><para>
+              Note that the audio types are dependent on the host
+              operating system. Use the <command>VBoxManage
+              modifyvm</command> command usage output to determine the
+              supported audio types for your host system.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--audiocontroller=<replaceable>controller-type</replaceable></option></term>
+          <listitem><para>
+              Specifies the audio controller to be used with the VM.
+              Valid audio controller type values are:
+              <literal>ac97</literal>, <literal>hda</literal>, and
+              <literal>sb16</literal>.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--audiocodec=<replaceable>codec-type</replaceable></option></term>
+          <listitem><para>
+              Specifies the audio codec to be used with the VM. Valid
+              audio codec type values are: <literal>stac9700</literal>,
+              <literal>ad1980</literal>, <literal>stac9221</literal>,
+              and <literal>sb16</literal>.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--audioin=on|off</option></term>
+          <listitem><para>
+              Specifies whether to enable or disable audio capture from
+              the host system.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--audioout=on|off</option></term>
+          <listitem><para>
+              Specifies whether to enable or disable audio playback from
+              the guest VM.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--clipboard=<replaceable>value</replaceable></option></term>
+          <listitem><para>
+              Specifies how to share the guest VM or host system OS's
+              clipboard with the host system or guest VM, respectively.
+              Valid values are: <literal>disabled</literal>,
+              <literal>hosttoguest</literal>,
+              <literal>guesttohost</literal>, and
+              <literal>bidirectional</literal>. See
+              <xref linkend="generalsettings" />.
+            </para><para>
+              The clipboard feature is available only if you have the
+              Guest Additions be installed in the VM.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--draganddrop=<replaceable>value</replaceable></option></term>
+          <listitem><para>
+              Specifies how to use the drag and drop feature between the
+              host system and the VM. Valid values are:
+              <literal>disabled</literal>,
+              <literal>hosttoguest</literal>,
+              <literal>guesttohost</literal>, and
+              <literal>bidirectional</literal>. See
+              <xref linkend="guestadd-dnd" />.
+            </para><para>
+              The drag and drop feature is available only if you have
+              the Guest Additions be installed in the VM.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--monitorcount=<replaceable>count</replaceable></option></term>
+          <listitem><para>
+              Enables you to configure multiple monitors. See
+              <xref linkend="settings-display" />.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--usb=on | off</option></term>
+          <listitem><para>
+              Enables or disables the VM's virtual USB controller. See
+              <xref linkend="settings-usb" />.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--usbohci=on | off</option></term>
+          <listitem><para>
+              Enables or disables the VM's virtual USB 1.1 controller.
+              See <xref linkend="settings-usb" />.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--usbehci=on | off</option></term>
+          <listitem><para>
+              Enables or disables the VM's virtual USB 2.0 controller.
+              See <xref linkend="settings-usb" />.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--usbxhci=on | off</option></term>
+          <listitem><para>
+              Enables or disables the VM's virtual USB 3.0 controller.
+              See <xref linkend="settings-usb" />.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--usbrename=<replaceable>old-name</replaceable> <replaceable>new-name</replaceable></option></term>
+          <listitem><para>
+              Rename's the VM's virtual USB controller from
+              <replaceable>old-name</replaceable> to
+              <replaceable>new-name</replaceable>.
+            </para></listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+    <refsect2 id="vboxmanage-modifyvm-recording">
+      <title>Recording Settings</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The following options enable you to modify settings for video
+        recording, audio recording, or both.
+      </para>
+      <variablelist>
+        <varlistentry>
+          <term><option>--recording=on | off</option></term>
+          <listitem><para>
+              Enables or disables the recording of a VM session into a
+              WebM or VP8 file. When set to <literal>on</literal>,
+              recording begins when the VM session starts.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--recordingscreens=all | <replaceable>screen-ID</replaceable></option></term>
+          <listitem><para>
+              Enables you to specify the VM screens to record. The
+              recording for each screen is output to its own file. Valid
+              values are: <literal>all</literal>, which records all
+              screens, or one or more specified screens.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--recordingfile=<replaceable>filename</replaceable></option></term>
+          <listitem><para>
+              Specifies the name of the file in which to save the
+              recording.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--recordingmaxsize=<replaceable>MB</replaceable></option></term>
+          <listitem><para>
+              Specifies the maximum size of the recorded video file in
+              megabytes. When the file reaches the specified size,
+              recording stops. If the value is <literal>0</literal>,
+              recording continues until you manually stop recording.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--recordingmaxtime=<replaceable>seconds</replaceable></option></term>
+          <listitem><para>
+              Specifies the maximum amount of time to record in seconds.
+              When the specified time elapses, recording stops. If the
+              value is <literal>0</literal>, recording continues until
+              you manually stop recording.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--recordingopts=<replaceable>keyword</replaceable>=<replaceable>value</replaceable></option></term>
+          <listitem><para>
+              Specifies additional video-recording properties as a
+              comma-separated property keyword-value list. For example,
+              <literal>foo=bar,a=b</literal>.
+            </para><para>
+              Only use this option if you are an advanced user. For
+              information about keywords, see the <citetitle>Oracle VM
+              VirtualBox Programming Guide and Reference</citetitle>.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--recordingvideofps=<replaceable>fps</replaceable></option></term>
+          <listitem><para>
+              Specifies the maximum number of video frames per second
+              (FPS) to record. The recording ignores any frames that
+              have a higher frequency. When you increase the FPS, fewer
+              frames are ignored but the recording and the size of the
+              recording file increases.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--recordingvideorate=<replaceable>bit-rate</replaceable></option></term>
+          <listitem><para>
+              Specifies the bit rate of the video in kilobits per
+              second. When you increase the bit rate, the recording
+              appearance improves and the size of the recording file
+              increases.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--recordingvideores=<replaceable>width</replaceable>x<replaceable>height</replaceable></option></term>
+          <listitem><para>
+              Specifies the video resolution (width and height) of the
+              recorded video in pixels.
+            </para></listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+    <refsect2 id="vboxmanage-modifyvm-vrde">
+      <title>Remote Machine Settings</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The following options enable you to modify the VirtualBox Remote
+        Desktop Extension (VRDE) behavior.
+      </para>
+      <variablelist>
+        <varlistentry>
+          <term><option>--vrde=on | off</option></term>
+          <listitem><para>
+              Enables or disables the VRDE server.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--vrdeproperty=TCP/Ports=<replaceable>port</replaceable></option></term>
+          <listitem><para>
+              <replaceable>port</replaceable> is the port or port range
+              to which the VRDE server binds. The
+              <literal>default</literal> or <literal>0</literal> value
+              uses port <literal>3389</literal>, which is the standard
+              RDP port.
+            </para><para>
+              Also see the <option>--vrdeport</option> option
+              description.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--vrdeproperty=TCP/Address=<replaceable>IP-address</replaceable></option></term>
+          <listitem><para>
+              <replaceable>IP-address</replaceable> is the IP address of
+              the host network interface to which the VRDE server binds.
+              When specified, the server accepts connections only on the
+              host network interface at that IP address.
+            </para><para>
+              Also see the <option>--vrdeaddress</option> option
+              description.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--vrdeproperty=VideoChannel/Enabled=<replaceable>value</replaceable></option></term>
+          <listitem><para>
+              Specifies whether the VRDP video channel is on or off.
+              <literal>1</literal> means <literal>on</literal> and
+              <literal>0</literal> means <literal>off</literal>. See
+              <xref linkend="vrde-videochannel" />.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--vrdeproperty=Quality=<replaceable>value</replaceable></option></term>
+          <listitem><para>
+              Specifies a value between 10% and 100%, inclusive, that
+              represents the JPEG compression level on the VRDE server
+              video channel. A lower value produces lower JPEG quality
+              but higher compression. See
+              <xref linkend="vrde-videochannel" />.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--vrdeproperty=DownscaleProtection=<replaceable>value</replaceable></option></term>
+          <listitem><para>
+              Enables or disables the video downscale protection
+              feature. Valid values are <literal>1</literal> to enable
+              the feature and <literal>0</literal> to disable the
+              feature.
+            </para><para>
+              When this feature is enabled, &product-name; determines
+              whether to display the video:
+            </para><itemizedlist>
+              <listitem><para>
+                  When the video size equals the size of the shadow
+                  buffer, the video is considered to be full screen and
+                  is displayed.
+                </para></listitem>
+              <listitem><para>
+                  When the video size is between full screen and the
+                  downscale threshold, the video is not displayed. Such
+                  a video might be an application window, which is
+                  unreadable when downscaled.
+                </para></listitem>
+            </itemizedlist><para>
+              When this feature is disabled, an attempt is always made
+              to display a video.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--vrdeproperty=Client/DisableDisplay=1</option></term>
+          <listitem><para>
+              Disables the display VRDE server feature.
+            </para><para>
+              To reenable a feature, assign a null value. For example,
+              to reenable the display feature, specify the
+              <command>VBoxManage modifyvm
+              --vrdeproperty=Client/DisableDisplay=</command> command.
+              See <xref linkend="vrde-customization" />.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--vrdeproperty=DisableInput=1</option></term>
+          <listitem><para>
+              Disables the input VRDE server feature.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--vrdeproperty=DisableAudio=1</option></term>
+          <listitem><para>
+              Disables the audio VRDE server feature.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--vrdeproperty=DisableUSB=1</option></term>
+          <listitem><para>
+              Disables the USB VRDE server feature.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--vrdeproperty=Client/DisableClipboard=1</option></term>
+          <listitem><para>
+              Disables the clipboard VRDE server feature. To reenable
+              the feature, assign a null value. See
+              <xref linkend="vrde-customization" />.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--vrdeproperty=DisableUpstreamAudio=1</option></term>
+          <listitem><para>
+              Disables the upstream audio VRDE server feature. To
+              reenable the feature, assign a null value. See
+              <xref linkend="vrde-customization" />.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--vrdeproperty=Client/DisableRDPDR=1</option></term>
+          <listitem><para>
+              Disables the RDP device redirection for smart cards VRDE
+              server feature. To reenable this feature, assign a null
+              value.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--vrdeproperty=H3DRedirect/Enabled=1</option></term>
+          <listitem><para>
+              Enables the 3D redirection VRDE server feature. To disable
+              this feature, assign a null value.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--vrdeproperty=Security/Method=<replaceable>value</replaceable></option></term>
+          <listitem><para>
+              Specifies the following information that is required for a
+              connection:
+            </para><itemizedlist>
+              <listitem><para>
+                  <literal>Negotiate</literal> indicates that both
+                  Enhanced (TLS) and Standard RDP Security connections
+                  are permitted. The security method is negotiated with
+                  the client. This is the default value.
+                </para></listitem>
+              <listitem><para>
+                  <literal>RDP</literal> indicates that only Standard
+                  RDP Security is accepted.
+                </para></listitem>
+              <listitem><para>
+                  <literal>TLS</literal> indicates that only Enhanced
+                  RDP Security is accepted. The client must support TLS.
+                </para></listitem>
+            </itemizedlist><para>
+              See <xref linkend="vrde-crypt" />.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--vrdeproperty=ServerCertificate=<replaceable>value</replaceable></option></term>
+          <listitem><para>
+              Specifies the absolute path to the server certificate. See
+              <xref linkend="vrde-crypt" />.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--vrdeproperty=ServerPrivateKey=<replaceable>value</replaceable></option></term>
+          <listitem><para>
+              Specifies the absolute path to the server private key. See
+              <xref linkend="vrde-crypt" />.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--vrdeproperty=CACertificate=<replaceable>value</replaceable></option></term>
+          <listitem><para>
+              Specifies the absolute path to the CA self-signed
+              certificate. See <xref linkend="vrde-crypt" />.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--vrdeproperty Audio/RateCorrectionMode=<replaceable>value</replaceable></option></term>
+          <listitem><para>
+              Specifies the audio connection mode or the path to the
+              audio log file. Valid values are as follows:
+            </para><itemizedlist>
+              <listitem><para>
+                  <literal>VRDP_AUDIO_MODE_VOID</literal> is no mode.
+                  Use this value to unset any set audio mode.
+                </para></listitem>
+              <listitem><para>
+                  <literal>VRDP_AUDIO_MODE_RC</literal> is the rate
+                  correction mode.
+                </para></listitem>
+              <listitem><para>
+                  <literal>VRDP_AUDIO_MODE_LPF</literal> is the low pass
+                  filter mode.
+                </para></listitem>
+              <listitem><para>
+                  <literal>VRDP_AUDIO_MODE_CS</literal> is the client
+                  sync sync mode to prevent an underflow or overflow of
+                  the client queue.
+                </para></listitem>
+            </itemizedlist></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--vrdeproperty=LogPath=<replaceable>value</replaceable></option></term>
+          <listitem><para>
+              Specifies the absolute path to the audio log file.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--vrdeextpack=default | <replaceable>name</replaceable></option></term>
+          <listitem><para>
+              Specifies the library to use to access the VM remotely.
+              The <literal>default</literal> value uses the RDP code
+              that is part of the &product-name; Extension Pack.
+            </para><para>
+              To use the VRDE module in VNC, specify
+              <literal>VNC</literal>. See
+              <xref linkend="otherextpacks"/>.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--vrdereport=default | <replaceable>port</replaceable></option></term>
+          <listitem><para>
+              <replaceable>port</replaceable> is the port or port range
+              to which the VRDE server binds. The
+              <literal>default</literal> or <literal>0</literal> value
+              uses port <literal>3389</literal>, which is the standard
+              RDP port.
+            </para><para>
+              You can specify a comma-separated list of ports or port
+              ranges of ports. Use a dash between two port numbers to
+              specify a port range. The VRDE server binds to only one of
+              the available ports from the list. Only one machine can
+              use a given port at a time. For example, the
+              <option>--vrdeport=5000,5010-5012</option> option
+              specifies that server can bind to one of following ports:
+              <literal>5000</literal>, <literal>5010</literal>,
+              <literal>5011</literal>, or <literal>5012</literal>.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--vrdeaddress=<replaceable>IP-address</replaceable></option></term>
+          <listitem><para>
+              Specifies the IP address of the host network interface to
+              which the VRDE server binds. If you specify an IP address,
+              the server accepts connections only on the specified host
+              network interface.
+            </para><para>
+              Use this option to specify whether the VRDP server should
+              accept IPv4, IPv6, or both type of connections:
+            </para><itemizedlist>
+              <listitem><para>
+                  <emphasis role="bold">Only IPv4:</emphasis> Use the
+                  <option>--vrdeaddress="0.0.0.0"</option> option.
+                </para></listitem>
+              <listitem><para>
+                  <emphasis role="bold">Only IPv6:</emphasis> Use the
+                  <option>--vrdeaddress="::"</option> option.
+                </para></listitem>
+              <listitem><para>
+                  <emphasis role="bold">Both IPv6 and IPv4:</emphasis>
+                  Use the <option>--vrdeaddress=&ldquo;&rdquo;</option>
+                  option. This is the default value.
+                </para></listitem>
+            </itemizedlist></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--vrdeauthtype=null | external | guest</option></term>
+          <listitem><para>
+              Specify whether to use authorization and how to perform
+              authorization. See <xref linkend="vbox-auth" />. Valid
+              values are as follows:
+            </para><itemizedlist>
+              <listitem><para>
+                  <literal>null</literal> provides no authentication.
+                </para></listitem>
+              <listitem><para>
+                  <literal>external</literal> provides external
+                  authentication through an authentication library.
+                </para></listitem>
+              <listitem><para>
+                  <literal>guest</literal> performs authentication by
+                  using guest user accounts. This unsupported method
+                  requires that you install the Guest Additions on the
+                  VM.
+                </para></listitem>
+            </itemizedlist></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--vrdeauthlibrary=default | <replaceable>name</replaceable></option></term>
+          <listitem><para>
+              Specifies the library to use for RDP authentication. The
+              default library for external authentication is
+              <filename>VBoxAuth</filename>. See
+              <xref linkend="vbox-auth" />.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--vrdemulticon=on | off</option></term>
+          <listitem><para>
+              Enables or disables the multiple connections VRDE server
+              feature, if supported. See
+              <xref linkend="vrde-multiconnection" />.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--vrdereusecon=on | off</option></term>
+          <listitem><para>
+              Specifies how the VRDE server behaves when multiple
+              connections are disabled. When the value is
+              <literal>on</literal>, the server permits a new client to
+              connect and drops the existing connection. When the value
+              is <literal>off</literal>, a new connection is not
+              accepted if a client is already connected to the server.
+              This is the default value.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--vrdevideochannel=on | off</option></term>
+          <listitem><para>
+              Enables video redirection if supported by the VRDE server.
+              See <xref linkend="vrde-videochannel" />.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--vrdevideochannelquality=<replaceable>percent</replaceable></option></term>
+          <listitem><para>
+              Specifies the image quality for video redirection as a
+              value from 10 to 100 percent. The percentage represents
+              the JPEG compression level where a lower number diminishes
+              quality and provides higher compression. See
+              <xref linkend="vrde-videochannel" />.
+            </para></listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+    <refsect2 id="vboxmanage-modifyvm-teleport">
+      <title>Teleporting Settings</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The following options enable you to configure a machine as a
+        teleporting target. See <xref linkend="teleporting" />.
+      </para>
+      <variablelist>
+        <varlistentry>
+          <term><option>--teleporter=on | off</option></term>
+          <listitem><para>
+              Enables or disables the teleporter. When enabled, a
+              machine starts up and waits to receive a teleporting
+              request from the network instead of booting normally.
+            </para><para>
+              Teleporting requests are received on the port and address
+              specified using the following parameters.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--teleporterport=<replaceable>port</replaceable></option></term>
+          <listitem><para>
+              Specifies the port on which the VM listens to receive a
+              teleporting request from another VM.
+              <replaceable>port</replaceable> is any free TCP/IP port
+              number, such as <literal>6000</literal>. You must also
+              specify the <option>--teleporter</option> option.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--teleporteraddress=<replaceable>IP-address</replaceable></option></term>
+          <listitem><para>
+              Specifies the IP address on which the VM listens to
+              receive a teleporting request from another VM.
+              <replaceable>IP-address</replaceable> is any IP address or
+              host name and specifies the TCP/IP socket on which to
+              bind. The default IP address is
+              <literal>0.0.0.0</literal>, which represents any IP
+              address. You must also specify the
+              <option>--teleporter</option> option.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--teleporterpassword=<replaceable>password</replaceable></option></term>
+          <listitem><para>
+              Specifies the password to use for authentication. When
+              specified, the teleporting request only succeeds if the
+              password on the source machine is the same password as the
+              one you specify.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--teleporterpasswordfile=<replaceable>filename</replaceable></option></term>
+          <listitem><para>
+              Specifies a file that contains the password to use for
+              authentication. When specified, the teleporting request
+              only succeeds if the password on the source machine is the
+              same password as the one you specify in the password file.
+              A value of <literal>stdin</literal> reads the password
+              from standard input.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--cpuid=<replaceable>leaf</replaceable> <replaceable>eax</replaceable> <replaceable>ebx</replaceable> <replaceable>ecx</replaceable> <replaceable>edx</replaceable></option></term>
+          <listitem><para>
+              For advanced users only.
+            </para><para>
+              Restricts the virtual CPU capabilities that &product-name;
+              presents to the guest VM OS. This option affects what the
+              guest VM sees when it executes the
+              <literal>CPUID</literal> machine instruction.
+            </para><para>
+              Run the <command>VBoxManage modifyvm</command> command
+              with this option prior to a teleporting operation on both
+              the source and the target machines.
+            </para><para>
+              Use this option if a misbehaving application assumes that
+              certain CPU capabilities are present when they are not.
+              The meaning of the values is hardware dependent. See the
+              AMD or Intel processor documentation.
+            </para></listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+    <refsect2 id="vboxmanage-modifyvm-debugging">
+      <title>Debugging Settings</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        Only use the following options to perform low-level VM
+        debugging. These options are for advanced users only.
+      </para>
+      <variablelist>
+        <varlistentry>
+          <term><option>--tracing-enabled=on | off</option></term>
+          <listitem><para>
+              Enables or disables the trace buffer. Note that when
+              specified, the trace buffer consumes some memory and adds
+              overhead.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--tracing-config=<replaceable>config-string</replaceable></option></term>
+          <listitem><para>
+              Enables a tracing configuration that defines which group
+              of trace points are enabled.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--tracing-allow-vm-access=on | off</option></term>
+          <listitem><para>
+              Enables or disables VM access to the trace buffer. The
+              default value is <literal>off</literal>, which disables
+              access.
+            </para></listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+    <refsect2 id="vboxmanage-modifyvm-usbcardreader">
+      <title>USB Card Reader Settings</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The following options specify the access to a USB Card Reader by
+        the guest environment. A USB card reader can access data on
+        memory cards, such as CompactFlash (CF), Secure Digital (SD),
+        and MultiMediaCard (MMC).
+      </para>
+      <variablelist>
+        <varlistentry>
+          <term><option>--usbcardreader=on | off</option></term>
+          <listitem><para>
+              Enables or disables the USB card reader interface.
+            </para></listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+    <refsect2 id="vboxmanage-modifyvm-autostart">
+      <title>Autostarting VMs During Host System Boot</title>
+      <para>
+        The following options enable you to configure the VM autostart
+        feature, which automatically starts the VM at host system
+        boot-up. You must do some host system configuration before you
+        can use this feature. See <xref linkend="autostart" />.
+      </para>
+      <remark role="help-copy-synopsis"/>
+      <variablelist>
+        <varlistentry>
+          <term><option>--autostart-enabled=on | off</option></term>
+          <listitem><para>
+              Enables or disables VM autostart at host system boot-up
+              for the specified users.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--autostart-delay=<replaceable>seconds</replaceable></option></term>
+          <listitem><para>
+              Specifies the number of seconds after host system boot-up
+              to autostart the VM.
+            </para></listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+  </refsect1>
+
+  <refsect1>
+    <title>Examples</title>
+    <remark role="help-scope" condition="GLOBAL" />
+    <para>
+      The following command changes the description for the
+      <filename>ol7</filename> VM.
+    </para>
+<screen>$ VBoxManage modifyvm ol7 --description "Oracle Linux 7 with UEK4"</screen>
+    <para>
+      The following command enables VirtualBox Remote Display Protocol
+      (VRDP) support for the <filename>ol7</filename> VM.
+    </para>
+<screen>$ VBoxManage modifyvm ol7 --vrde on</screen>
+  </refsect1>
+
+  <refsect1>
+    <title>See Also</title>
+    <para>
+      <xref linkend="vboxmanage-controlvm" />,
+      <xref linkend="vboxmanage-createvm" />,
+      <xref linkend="vboxmanage-list" />,
+      <xref linkend="vboxmanage-startvm" />
+    </para>
+  </refsect1>
+</refentry>
Index: trunk/doc/manual/en_US/man_VBoxManage-movevm.xml
===================================================================
--- trunk/doc/manual/en_US/man_VBoxManage-movevm.xml	(revision 82044)
+++ trunk/doc/manual/en_US/man_VBoxManage-movevm.xml	(revision 82044)
@@ -0,0 +1,97 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+         manpage, user manual, usage: VBoxManage movevm
+
+    Copyright (C) 2006-2019 Oracle Corporation
+
+    This file is part of VirtualBox Open Source Edition (OSE), as
+    available from http://www.virtualbox.org. This file is free software;
+    you can redistribute it and/or modify it under the terms of the GNU
+    General Public License (GPL) as published by the Free Software
+    Foundation, in version 2 as it comes in the "COPYING" file of the
+    VirtualBox OSE distribution. VirtualBox OSE is distributed in the
+    hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
+ -->
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+  "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"[
+<!ENTITY % all.entities SYSTEM "all-entities.ent">
+%all.entities;
+]>
+<refentry id="vboxmanage-movevm" lang="en">
+  <refentryinfo>
+    <pubdate>August 2019</pubdate>
+    <title>VBoxManage movevm</title>
+  </refentryinfo>
+
+  <refmeta>
+    <refentrytitle>VBoxManage-movevm</refentrytitle>
+    <manvolnum>1</manvolnum>
+  </refmeta>
+
+  <refnamediv>
+    <refname>VBoxManage-movevm</refname>
+    <refpurpose>move a virtual machine to a new location on the host system</refpurpose>
+    <refclass>Oracle VM VirtualBox</refclass>
+  </refnamediv>
+
+  <refsynopsisdiv>
+    <cmdsynopsis id="synopsis-vboxmanage-movevm">
+<!-- The 'id' is mandatory and must start with 'synopsis-'. -->
+      <command>VBoxManage movevm</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg choice="req">--type=basic</arg>
+      <arg>--folder=<replaceable>folder-name</replaceable></arg>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+
+  <refsect1>
+    <title>Description</title>
+    <para>
+      The <command>VBoxManage movevm</command> command moves a virtual
+      machine (VM) to a new location on the host system.
+    </para>
+    <para>
+      When moved, all of the files that are associated with the VM, such
+      as settings files and disk image files, are moved to the new
+      location. The &product-name; configuration is updated
+      automatically.
+    </para>
+    <variablelist>
+      <varlistentry>
+        <term><replaceable>uuid</replaceable>|<replaceable>vmname</replaceable></term>
+        <listitem><para>
+            Specifies the Universally Unique Identifier (UUID) or name
+            of the VM to move.
+          </para></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--type=basic</option></term>
+        <listitem><para>
+            Specifies that the type of the move operation is basic.
+          </para></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--folder=<replaceable>folder-name</replaceable></option></term>
+        <listitem><para>
+            Specifies a full path name or relative path name of the new
+            location on the host file system.
+          </para></listitem>
+      </varlistentry>
+    </variablelist>
+  </refsect1>
+
+  <refsect1>
+    <title>Examples</title>
+    <remark role="help-scope" condition="GLOBAL" />
+    <para>
+      The following command moves the <filename>ol7</filename> VM to a
+      new location on the host system.
+    </para>
+<screen>$ VBoxManage movevm ol7 --folder "/home/testuser/vms" --type basic
+0%...10%...20%...30%...40%...50%...60%...70%...80%...90%...100%
+Machine has been successfully moved into /home/testuser/vms</screen>
+  </refsect1>
+</refentry>
Index: trunk/doc/manual/en_US/man_VBoxManage-natnetwork.xml
===================================================================
--- trunk/doc/manual/en_US/man_VBoxManage-natnetwork.xml	(revision 82044)
+++ trunk/doc/manual/en_US/man_VBoxManage-natnetwork.xml	(revision 82044)
@@ -0,0 +1,360 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+    manpage, user manual, usage: VBoxManage natnetwork
+
+    Copyright (C) 2006-2019 Oracle Corporation
+
+    This file is part of VirtualBox Open Source Edition (OSE), as
+    available from http://www.virtualbox.org. This file is free software;
+    you can redistribute it and/or modify it under the terms of the GNU
+    General Public License (GPL) as published by the Free Software
+    Foundation, in version 2 as it comes in the "COPYING" file of the
+    VirtualBox OSE distribution. VirtualBox OSE is distributed in the
+    hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
+ -->
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+  "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"[
+<!ENTITY % all.entities SYSTEM "all-entities.ent">
+%all.entities;
+]>
+<refentry id="vboxmanage-natnetwork" lang="en">
+  <refentryinfo>
+    <pubdate>September 2019</pubdate>
+    <title>VBoxManage natnetwork</title>
+  </refentryinfo>
+
+  <refmeta>
+    <refentrytitle>VBoxManage-natnetwork</refentrytitle>
+    <manvolnum>1</manvolnum>
+  </refmeta>
+
+  <refnamediv>
+    <refname>VBoxManage-natnetwork</refname>
+    <refpurpose>create, modify, and manage a NAT network</refpurpose>
+    <refclass>Oracle VM VirtualBox</refclass>
+  </refnamediv>
+
+  <refsynopsisdiv>
+    <cmdsynopsis id="synopsis-vboxmanage-natnetwork-add">
+<!-- The 'id' is mandatory and must start with 'synopsis-'. -->
+      <command>VBoxManage natnetwork add</command>
+      <group>
+        <arg choice="plain">--disable</arg>
+        <arg choice="plain">--enable</arg>
+      </group>
+      <arg choice="req">--netname=<replaceable>name</replaceable></arg>
+      <arg choice="req">--network=<replaceable>network</replaceable></arg>
+      <arg>--dhcp=on|off</arg>
+      <arg>--ipv6=on|off</arg>
+      <arg>--loopback-4=<replaceable>rule</replaceable></arg>
+      <arg>--loopback-6=<replaceable>rule</replaceable></arg>
+      <arg>--port-forward-4=<replaceable>rule</replaceable></arg>
+      <arg>--port-forward-6=<replaceable>rule</replaceable></arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-natnetwork-list">
+      <command>VBoxManage natnetwork list</command> 
+      <arg><replaceable>filter-pattern</replaceable></arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-natnetwork-modify">
+      <command>VBoxManage natnetwork modify</command> 
+      <arg>--dhcp=on|off</arg>
+      <group>
+        <arg choice="plain">--disable</arg>
+        <arg choice="plain">--enable</arg>
+      </group>
+      <arg choice="req">--netname=<replaceable>name</replaceable></arg>
+      <arg choice="req">--network=<replaceable>network</replaceable></arg>
+      <arg>--ipv6=on|off</arg>
+      <arg>--loopback-4=<replaceable>rule</replaceable></arg>
+      <arg>--loopback-6=<replaceable>rule</replaceable></arg>
+      <arg>--port-forward-4=<replaceable>rule</replaceable></arg>
+      <arg>--port-forward-6=<replaceable>rule</replaceable></arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-natnetwork-remove">
+      <command>VBoxManage natnetwork remove</command> 
+      <arg choice="req">--netname=<replaceable>name</replaceable></arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-natnetwork-start">
+      <command>VBoxManage natnetwork start</command> 
+      <arg choice="req">--netname=<replaceable>name</replaceable></arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-natnetwork-stop">
+      <command>VBoxManage natnetwork stop</command> 
+      <arg choice="req">--netname=<replaceable>name</replaceable></arg>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+
+  <refsect1>
+    <title>Description</title>
+    <para>
+      The <command>VBoxManage natnetwork</command> command enables you
+      to create, modify and manage a NAT network.
+    </para>
+    <para>
+      NAT networks use the Network Address Translation (NAT) service.
+      The service groups systems into a network and prevents external
+      systems from directly accessing the systems in the network. The
+      service also enables the systems in the network to communicate
+      with each other and with external systems by means of TCP and UDP
+      over IPv4 and IPv6.
+    </para>
+    <para>
+      A NAT service is attached to an internal network. For a VM to use
+      the NAT service, you must attach the VM to the internal network.
+      Specify the name of the internal network when you create the NAT
+      service. Note that the internal network is created if it does not
+      already exist.
+    </para>
+    <refsect2 id="vboxmanage-natnetwork-add">
+      <title>Add a NAT Network Service</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage natnetwork add</command> command creates
+        a new internal network interface, and adds a NAT network
+        service. You must use this command before you can attach the VM
+        to the NAT network.
+      </para>
+      <variablelist>
+        <varlistentry>
+          <term><option>--disable</option></term>
+          <listitem><para>
+              Disables the NAT network service.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--enable</option></term>
+          <listitem><para>
+              Enables the NAT network service.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--netname=<replaceable>name</replaceable></option></term>
+          <listitem><para>
+              Specifies the name of the new internal network interface
+              on the host OS.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--network</option></term>
+          <listitem><para>
+              Specifies the static or DHCP network address and mask of
+              the NAT service interface. By default, this value
+              specifies the static network address.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--dhcp</option></term>
+          <listitem><para>
+              Enables or disables the DHCP server that you specify by
+              using the <option>--netname</option> option.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--ipv6</option></term>
+          <listitem><para>
+              Enables or disables IPv6. By default, IPv6 is disabled and
+              IPv4 is enabled.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--loopback-4=<replaceable>rule</replaceable></option></term>
+          <listitem><para>
+              Enables an IPv4 loopback interface by using the specified
+              rule.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--loopback-6=<replaceable>rule</replaceable></option></term>
+          <listitem><para>
+              Enables an IPv6 loopback interface by using the specified
+              rule.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--port-forward-4=<replaceable>rule</replaceable></option></term>
+          <listitem><para>
+              Enables an IPv4 loopback interface by using the specified
+              rule.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--port-forward-6=<replaceable>rule</replaceable></option></term>
+          <listitem><para>
+              Enables IPv6 port forwarding by using the rule specified
+              by <replaceable>rule</replaceable>.
+            </para></listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+    <refsect2 id="vboxmanage-natnetwork-remove">
+      <title>Remove a NAT Network Service</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage natnetwork remove</command> command
+        removes the specified NAT network service.
+      </para>
+      <variablelist>
+        <varlistentry>
+          <term><option>--netname=<replaceable>name</replaceable></option></term>
+          <listitem><para>
+              Specifies the name of the NAT network service to remove.
+            </para></listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+    <refsect2 id="vboxmanage-natnetwork-start">
+      <title>Start a NAT Network Service</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage natnetwork start</command> command
+        starts a NAT network service and any associated DHCP server.
+      </para>
+      <variablelist>
+        <varlistentry>
+          <term><option>--netname=<replaceable>name</replaceable></option></term>
+          <listitem><para>
+              Specifies the name of the NAT network service to start.
+            </para></listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+    <refsect2 id="vboxmanage-natnetwork-stop">
+      <title>Stop a NAT Network Service</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage natnetwork stop</command> command stops
+        a NAT network service and any associated DHCP server.
+      </para>
+      <variablelist>
+        <varlistentry>
+          <term><option>--netname=<replaceable>name</replaceable></option></term>
+          <listitem><para>
+              Specifies the name of the NAT network service to stop.
+            </para></listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+    <refsect2 id="vboxmanage-natnetwork-list">
+      <title>List All NAT Network Services</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage natnetwork list</command> command lists
+        all NAT network services. You can use a pattern to show a subset
+        of the NAT network services.
+      </para>
+      <variablelist>
+        <varlistentry>
+          <term><replaceable>filter-pattern</replaceable></term>
+          <listitem><para>
+              Specifies an optional filtering pattern.
+            </para></listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+    <refsect2 id="vboxmanage-natnetwork-modify">
+      <title>Modify the Settings of a NAT Network Service</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage natnetwork modify</command> command
+        modifies the settings of an existing internal network interface.
+      </para>
+      <variablelist>
+        <varlistentry>
+          <term><option>--disable</option></term>
+          <listitem><para>
+              Disables the NAT network service.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--enable</option></term>
+          <listitem><para>
+              Enables the NAT network service.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--netname=<replaceable>name</replaceable></option></term>
+          <listitem><para>
+              Specifies the name of the new internal network interface
+              on the host OS.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--network</option></term>
+          <listitem><para>
+              Specifies the static or DHCP network address and mask of
+              the NAT service interface. By default, this value
+              specifies the static network address.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--dhcp</option></term>
+          <listitem><para>
+              Enables or disables the DHCP server that you specify by
+              using the <option>--netname</option> option.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--ipv6</option></term>
+          <listitem><para>
+              Enables or disables IPv6. By default, IPv6 is disabled and
+              IPv4 is enabled.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--loopback-4=<replaceable>rule</replaceable></option></term>
+          <listitem><para>
+              Enables an IPv4 loopback interface by using the specified
+              rule.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--loopback-6=<replaceable>rule</replaceable></option></term>
+          <listitem><para>
+              Enables an IPv6 loopback interface by using the specified
+              rule.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--port-forward-4=<replaceable>rule</replaceable></option></term>
+          <listitem><para>
+              Enables an IPv4 loopback interface by using the specified
+              rule.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--port-forward-6=<replaceable>rule</replaceable></option></term>
+          <listitem><para>
+              Enables IPv6 port forwarding by using the rule specified
+              by <replaceable>rule</replaceable>.
+            </para></listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+  </refsect1>
+
+  <refsect1>
+    <title>Examples</title>
+    <remark role="help-scope" condition="GLOBAL"/>
+    <para>
+      The following command shows how to create a NAT network for the
+      <literal>natnet1</literal> internal network that uses the
+      <literal>192.168.15.0/24</literal> network address and mask of the
+      NAT service interface. In this static configuration, the gateway
+      is assigned the <literal>192.168.15.1</literal> IP address by
+      default. Note that this IP address is the next address after the
+      network address that you specify with the
+      <option>--network</option> option.
+    </para>
+<screen>$ VBoxManage natnetwork add --netname natnet1 --network "192.168.15.0/24" --enable</screen>
+    <para>
+      The following command shows how to add a DHCP server to the
+      <literal>natnet1</literal> NAT network after creation:
+    </para>
+<screen>$ VBoxManage natnetwork modify --netname natnet1 --dhcp on</screen>
+  </refsect1>
+</refentry>
Index: trunk/doc/manual/en_US/man_VBoxManage-registervm.xml
===================================================================
--- trunk/doc/manual/en_US/man_VBoxManage-registervm.xml	(revision 82044)
+++ trunk/doc/manual/en_US/man_VBoxManage-registervm.xml	(revision 82044)
@@ -0,0 +1,92 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+    manpage, user manual, usage: VBoxManage registervm
+
+    Copyright (C) 2006-2019 Oracle Corporation
+
+    This file is part of VirtualBox Open Source Edition (OSE), as
+    available from http://www.virtualbox.org. This file is free software;
+    you can redistribute it and/or modify it under the terms of the GNU
+    General Public License (GPL) as published by the Free Software
+    Foundation, in version 2 as it comes in the "COPYING" file of the
+    VirtualBox OSE distribution. VirtualBox OSE is distributed in the
+    hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
+ -->
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+  "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"[
+<!ENTITY % all.entities SYSTEM "all-entities.ent">
+%all.entities;
+]>
+<refentry id="vboxmanage-registervm" lang="en">
+  <refentryinfo>
+    <pubdate>August 2019</pubdate>
+    <title>VBoxManage registervm</title>
+  </refentryinfo>
+
+  <refmeta>
+    <refentrytitle>VBoxManage-registervm</refentrytitle>
+    <manvolnum>1</manvolnum>
+  </refmeta>
+
+  <refnamediv>
+    <refname>VBoxManage-registervm</refname>
+    <refpurpose>register a virtual machine</refpurpose>
+    <refclass>Oracle VM VirtualBox</refclass>
+  </refnamediv>
+
+  <refsynopsisdiv>
+    <cmdsynopsis id="synopsis-vboxmanage-registervm">
+<!-- The 'id' is mandatory and must start with 'synopsis-'. -->
+      <command>VBoxManage registervm</command> 
+      <arg choice="req"><replaceable>filename</replaceable></arg>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+
+  <refsect1>
+    <title>Description</title>
+    <para>
+      The <command>VBoxManage registervm</command> command enables you
+      to create a virtual machine (VM) by importing an XML machine
+      configuration file into &product-name;. The VM cannot conflict
+      with a VM that is already registered in &product-name;. In
+      addition, the VM cannot have any hard disks or removable disks
+      attached. Ensure that the XML machine configuration file is in the
+      machines folder prior to registration.
+    </para>
+    <note>
+      <para>
+        When you use the <command>VBoxManage createvm</command> command
+        to create a VM, you can specify the <option>--register</option>
+        option to register the VM.
+      </para>
+    </note>
+    <variablelist>
+      <varlistentry>
+        <term><replaceable>filename</replaceable></term>
+        <listitem><para>
+            Specifies the XML machine configuration file. This file has
+            the <filename>.vbox</filename> file extension.
+          </para></listitem>
+      </varlistentry>
+    </variablelist>
+  </refsect1>
+
+  <refsect1>
+    <title>Examples</title>
+    <remark role="help-scope" condition="GLOBAL" />
+    <para>
+      The following command registers a VM called
+      <literal>vm2</literal>. The XML machine configuration file for the
+      VM is located in the default machines folder.
+    </para>
+<screen>$ VBoxManage registervm "/home/user/VirtualBox VMs/vm2/vm2.vbox"</screen>
+  </refsect1>
+
+  <refsect1>
+    <title>See Also</title>
+    <para>
+      <xref linkend="vboxmanage-createvm"/>,
+      <xref linkend="vboxmanage-unregistervm" />
+    </para>
+  </refsect1>
+</refentry>
Index: trunk/doc/manual/en_US/man_VBoxManage-setextradata.xml
===================================================================
--- trunk/doc/manual/en_US/man_VBoxManage-setextradata.xml	(revision 82044)
+++ trunk/doc/manual/en_US/man_VBoxManage-setextradata.xml	(revision 82044)
@@ -0,0 +1,112 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+    manpage, user manual, usage: VBoxManage setextradata
+
+    Copyright (C) 2006-2019 Oracle Corporation
+
+    This file is part of VirtualBox Open Source Edition (OSE), as
+    available from http://www.virtualbox.org. This file is free software;
+    you can redistribute it and/or modify it under the terms of the GNU
+    General Public License (GPL) as published by the Free Software
+    Foundation, in version 2 as it comes in the "COPYING" file of the
+    VirtualBox OSE distribution. VirtualBox OSE is distributed in the
+    hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
+ -->
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+  "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"[
+<!ENTITY % all.entities SYSTEM "all-entities.ent">
+%all.entities;
+]>
+<refentry id="vboxmanage-setextradata" lang="en">
+  <refentryinfo>
+    <pubdate>August 2019</pubdate>
+    <title>VBoxManage setextradata</title>
+  </refentryinfo>
+
+  <refmeta>
+    <refentrytitle>VBoxManage-setextradata</refentrytitle>
+    <manvolnum>1</manvolnum>
+  </refmeta>
+
+  <refnamediv>
+    <refname>VBoxManage-setextradata</refname>
+    <refpurpose>set a keyword value that is associated with a virtual machine or
+      configuration</refpurpose>
+    <refclass>Oracle VM VirtualBox</refclass>
+  </refnamediv>
+
+  <refsynopsisdiv>
+    <cmdsynopsis id="synopsis-vboxmanage-setextradata">
+<!-- The 'id' is mandatory and must start with 'synopsis-'. -->
+      <command>VBoxManage setextradata</command>
+      <group choice="req">
+        <arg choice="plain">global</arg>
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg choice="req"><replaceable>keyword</replaceable></arg>
+      <arg><replaceable>value</replaceable></arg>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+
+  <refsect1>
+    <title>Description</title>
+    <para>
+      The <command>VBoxManage setextradata</command> command enables you
+      to set a keyword value that is associated with a virtual machine
+      (VM) or with an &product-name; configuration.
+    </para>
+    <variablelist>
+      <varlistentry>
+        <term><literal>global</literal></term>
+        <listitem><para>
+            Sets information about the configuration rather than a VM.
+          </para></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><replaceable>uuid</replaceable>|<replaceable>vmname</replaceable></term>
+        <listitem><para>
+            Specifies the Universally Unique Identifier (UUID) or name
+            of the VM.
+          </para></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><replaceable>keyword</replaceable></term>
+        <listitem><para>
+            Specifies the keyword for which to set its value.
+          </para></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><replaceable>value</replaceable></term>
+        <listitem><para>
+            Specifies the keyword value. Specifying no value removes the
+            keyword.
+          </para></listitem>
+      </varlistentry>
+    </variablelist>
+  </refsect1>
+
+  <refsect1>
+    <title>Examples</title>
+    <remark role="help-scope" condition="GLOBAL"/>
+    <para>
+      The following command sets the <literal>installdate</literal>
+      keyword value for the <literal>Fedora5</literal> VM to
+      <literal>2019.01.01</literal>:
+    </para>
+<screen>$ VBoxManage setextradata Fedora5 installdate 2019.01.01</screen>
+    <para>
+      The following command unsets the value of the
+      <literal>installdate</literal> keyword for the
+      <literal>Fedora5</literal> VM:
+    </para>
+<screen>$ VBoxManage setextradata Fedora5 installdate</screen>
+  </refsect1>
+
+  <refsect1>
+    <title>See Also</title>
+    <para>
+      <xref linkend="vboxmanage-getextradata" />
+    </para>
+  </refsect1>
+</refentry>
Index: trunk/doc/manual/en_US/man_VBoxManage-setproperty.xml
===================================================================
--- trunk/doc/manual/en_US/man_VBoxManage-setproperty.xml	(revision 82044)
+++ trunk/doc/manual/en_US/man_VBoxManage-setproperty.xml	(revision 82044)
@@ -0,0 +1,208 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+    manpage, user manual, usage: VBoxManage setproperty
+
+    Copyright (C) 2006-2019 Oracle Corporation
+
+    This file is part of VirtualBox Open Source Edition (OSE), as
+    available from http://www.virtualbox.org. This file is free software;
+    you can redistribute it and/or modify it under the terms of the GNU
+    General Public License (GPL) as published by the Free Software
+    Foundation, in version 2 as it comes in the "COPYING" file of the
+    VirtualBox OSE distribution. VirtualBox OSE is distributed in the
+    hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
+ -->
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+  "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"[
+<!ENTITY % all.entities SYSTEM "all-entities.ent">
+%all.entities;
+]>
+<refentry id="vboxmanage-setproperty" lang="en">
+  <refentryinfo>
+    <pubdate>August 2019</pubdate>
+    <title>VBoxManage setproperty</title>
+  </refentryinfo>
+
+  <refmeta>
+    <refentrytitle>VBoxManage-setproperty</refentrytitle>
+    <manvolnum>1</manvolnum>
+  </refmeta>
+
+  <refnamediv>
+    <refname>VBoxManage-setproperty</refname>
+    <refpurpose>change global settings</refpurpose>
+    <refclass>Oracle VM VirtualBox</refclass>
+  </refnamediv>
+
+  <refsynopsisdiv>
+<!-- The 'id' is mandatory and must start with 'synopsis-'. -->
+    <cmdsynopsis id="synopsis-vboxmanage-setproperty">
+      <command>VBoxManage setproperty</command> 
+      <arg choice="req"><replaceable>property-name</replaceable></arg>
+      <arg choice="req"><replaceable>property-value</replaceable></arg>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+
+  <refsect1>
+    <title>Description</title>
+    <para>
+      The <command>VBoxManage setproperty</command> command enables you
+      to change global settings that affect the entire &product-name;
+      installation. Some of these settings correspond to the settings in
+      the <emphasis role="bold">Preferences</emphasis> dialog in the
+      VirtualBox Manager.
+    </para>
+    <para>
+      The following properties are available:
+    </para>
+    <variablelist>
+      <varlistentry>
+        <term><literal>autostartdbpath</literal></term>
+        <listitem><para>
+            Specifies the path to the autostart database. Valid values
+            are <literal>null</literal>, which disables the autostart
+            database, or the name of the folder that contains the
+            database. See <xref linkend="autostart" />.
+          </para></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><literal>defaultfrontend</literal></term>
+        <listitem><para>
+            Specifies the global default VM frontend. Valid values are
+            <literal>default</literal>, which specifies the default
+            frontend, or the name of the frontend to use.
+          </para></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><literal>hwvirtexclusive</literal></term>
+        <listitem><para>
+            Specifies whether &product-name; makes exclusive use of the
+            Intel VT-x or AMD-V hardware virtualization extensions of
+            the host system's processor. See <xref linkend="hwvirt" />.
+          </para><para>
+            Valid values are as follows:
+          </para><itemizedlist>
+            <listitem><para>
+                <literal>on</literal> enables &product-name; to make
+                exclusive use of these extensions. This is the default
+                value.
+              </para></listitem>
+            <listitem><para>
+                <literal>off</literal> shares these extensions with
+                other hypervisors that run simultaneously. Note that
+                disabling this setting has negative performance
+                implications.
+              </para></listitem>
+          </itemizedlist></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><literal>logginglevel</literal></term>
+        <listitem><para>
+            Specifies the VBoxSVC release logging details. See
+            <ulink url="http://www.virtualbox.org/wiki/VBoxLogging" />.
+          </para></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><literal>loghistorycount</literal></term>
+        <listitem><para>
+            Specifies the number of rotated VM logs to retain.
+          </para></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><literal>machinefolder</literal></term>
+        <listitem><para>
+            Specifies the default folder in which virtual machine (VM)
+            definitions are stored. Valid values are
+            <literal>default</literal>, which specifies the default
+            storage folder, or the name of the folder to use. See
+            <xref linkend="vboxconfigdata" />.
+          </para></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><literal>proxymode</literal></term>
+        <listitem><para>
+            Configures the mode for an HTTP proxy server. Valid values
+            are as follows:
+          </para><variablelist>
+            <varlistentry>
+              <term><literal>manual</literal></term>
+              <listitem><para>
+                  Configure the URL of a HTTP proxy server manually,
+                  using the <literal>proxyurl</literal> property value.
+                </para></listitem>
+            </varlistentry>
+            <varlistentry>
+              <term><literal>noproxy</literal></term>
+              <listitem><para>
+                  Do not use an HTTP proxy server. A direct connection
+                  to the Internet is used.
+                </para></listitem>
+            </varlistentry>
+            <varlistentry>
+              <term><literal>system</literal></term>
+              <listitem><para>
+                  Detect the proxy settings automatically for the host
+                  network. This is the default value.
+                </para></listitem>
+            </varlistentry>
+          </variablelist></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><literal>proxyurl</literal></term>
+        <listitem><para>
+            Specifies the URL for an HTTP proxy server when you specify
+            a manual proxy by setting the <literal>proxymode</literal>
+            property to <literal>manual</literal>.
+          </para></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><literal>vrdeauthlibrary</literal></term>
+        <listitem><para>
+            Specifies which library to use when external authentication
+            has been configured for a particular VM. Valid values are
+            <literal>default</literal>, which specifies the default
+            library, or the name of the library to use. See
+            <xref linkend="vbox-auth" />.
+          </para></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><literal>vrdeextpack</literal></term>
+        <listitem><para>
+            Specifies the library that implements the VirtualBox Remote
+            Desktop Extension (RDE). Valid values are
+            <literal>null</literal>, which disables the RDE, or the name
+            of the library to use.
+          </para></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><literal>websrvauthlibrary</literal></term>
+        <listitem><para>
+            Specifies which library the web service uses to authenticate
+            users. Valid values are <literal>default</literal>, which
+            specifies the default library, <literal>null</literal>,
+            which disables authentication, or the name of the library to
+            use. For information about the &product-name; web service,
+            see <xref linkend="VirtualBoxAPI" />.
+          </para></listitem>
+      </varlistentry>
+    </variablelist>
+  </refsect1>
+
+  <refsect1>
+    <title>Examples</title>
+    <remark role="help-scope" condition="GLOBAL" />
+    <para>
+      The following command configures &product-name; to use the
+      specified HTTP proxy server.
+    </para>
+<screen>$ VBoxManage setproperty proxymode manual
+$ VBoxManage setproperty proxyurl "http://myproxy.com:8080"</screen>
+  </refsect1>
+
+  <refsect1>
+    <title>See Also</title>
+    <para>
+      <xref linkend="vboxmanage-startvm" />
+    </para>
+  </refsect1>
+</refentry>
Index: trunk/doc/manual/en_US/man_VBoxManage-sharedfolder.xml
===================================================================
--- trunk/doc/manual/en_US/man_VBoxManage-sharedfolder.xml	(revision 82044)
+++ trunk/doc/manual/en_US/man_VBoxManage-sharedfolder.xml	(revision 82044)
@@ -0,0 +1,189 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+    manpage, user manual, usage: VBoxManage sharedfolder
+
+    Copyright (C) 2006-2019 Oracle Corporation
+
+    This file is part of VirtualBox Open Source Edition (OSE), as
+    available from http://www.virtualbox.org. This file is free software;
+    you can redistribute it and/or modify it under the terms of the GNU
+    General Public License (GPL) as published by the Free Software
+    Foundation, in version 2 as it comes in the "COPYING" file of the
+    VirtualBox OSE distribution. VirtualBox OSE is distributed in the
+    hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
+ -->
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+  "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"[
+<!ENTITY % all.entities SYSTEM "all-entities.ent">
+%all.entities;
+]>
+<refentry id="vboxmanage-sharedfolder" lang="en">
+  <refentryinfo>
+    <pubdate>September 2019</pubdate>
+    <title>VBoxManage sharedfolder</title>
+  </refentryinfo>
+
+  <refmeta>
+    <refentrytitle>VBoxManage-sharedfolder</refentrytitle>
+    <manvolnum>1</manvolnum>
+  </refmeta>
+
+  <refnamediv>
+    <refname>VBoxManage-sharedfolder</refname>
+    <refpurpose>add and remove shared folders</refpurpose>
+    <refclass>Oracle VM VirtualBox</refclass>
+  </refnamediv>
+
+  <refsynopsisdiv>
+    <cmdsynopsis id="synopsis-vboxmanage-sharedfolder-add">
+<!-- The 'id' is mandatory and must start with 'synopsis-'. -->
+      <command>VBoxManage sharedfolder add</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg choice="req">--name=<replaceable>name</replaceable></arg>
+      <arg choice="req">--hostpath=<replaceable>hostpath</replaceable></arg>
+      <arg>--automount</arg>
+      <arg>--readonly</arg>
+      <arg>--transient</arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-sharedfolder-remove">
+      <command>VBoxManage sharedfolder remove</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg choice="req">--name=<replaceable>name</replaceable></arg>
+      <arg>--transient</arg>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+
+  <refsect1>
+    <title>Description</title>
+    <para>
+      Shared folders enable you to share data between the host system
+      and guests. To use shared folders, you must first install the
+      &product-name; Guest Additions software on the guest OS.
+    </para>
+    <para>
+      The shared folder is associated with a share name and the full
+      path name of the folder or directory on the host system. The share
+      name is a unique name within the namespace of the host OS.
+    </para>
+    <refsect2 id="vboxmanage-sharedfolder-add">
+      <title>Add a Shared Folder</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage sharedfolder add</command> command
+        creates a shared folder. The folder you specify is on the host
+        computer. When configured, the contents of the folder on the
+        host system can be shared with the guest OS.
+      </para>
+      <variablelist>
+        <varlistentry>
+          <term><replaceable>uuid</replaceable>|<replaceable>vmname</replaceable></term>
+          <listitem><para>
+              Specifies the name or UUID of the guest VM that shares a
+              folder with the host system.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>--name=<replaceable>name</replaceable></term>
+          <listitem><para>
+              Specifies the name of the share, which is a unique name
+              within the namespace of the host OS.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>--hostpath=<replaceable>hostpath</replaceable></term>
+          <listitem><para>
+              Specifies the absolute path of the folder or directory on
+              the host OS to share with the guest OS.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>--automount</term>
+          <listitem><para>
+              Specifies that the share is automatically mounted. On
+              Linux distributions, the share is mounted at
+              <filename>/var/run/media/<replaceable>username</replaceable>/sf_<replaceable>sharename</replaceable></filename>
+              or
+              <filename>/media/sf_<replaceable>sharename</replaceable></filename>,
+              depending on your guest OS.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>--readonly</term>
+          <listitem><para>
+              Specifies that the share has only read-only access to
+              files at the host path.
+            </para><para>
+              By default, shared folders have read-write access to the
+              files at the host path. However on Linux distributions,
+              shared folders are mounted with 770 file permissions with
+              the <literal>root</literal> user and the
+              <literal>vboxsf</literal> group. By using this option, the
+              file permissions become 700.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>--transient</term>
+          <listitem><para>
+              Specifies that the share is transient, which means that it
+              can be added and removed at runtime and does not persist
+              after the VM stops.
+            </para></listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+    <refsect2 id="vboxmanage-sharedfolder-remove">
+      <title>Remove a Shared Folder</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage sharedfolder remove</command> command
+        removes a shared folder.
+      </para>
+      <variablelist>
+        <varlistentry>
+          <term><replaceable>uuid</replaceable>|<replaceable>vmname</replaceable></term>
+          <listitem><para>
+              Specifies the name or UUID of the guest VM that shares a
+              folder with the host system.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>--name=<replaceable>name</replaceable></term>
+          <listitem><para>
+              Specifies the name of the share to remove.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>--transient</term>
+          <listitem><para>
+              Specifies that the share is transient, which means that it
+              can be added and removed at runtime and does not persist
+              after the VM stops.
+            </para></listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+  </refsect1>
+
+  <refsect1>
+    <title>Examples</title>
+    <remark role="help-scope" condition="GLOBAL" />
+    <para>
+      The following command creates a shared folder called
+      <filename>o7share</filename> for the <filename>ol7</filename> VM.
+      The share is mounted automatically when the VM is started.
+    </para>
+<screen>$ VBoxManage sharedfolder add ol7 --name ol7share --hostpath "/home/user/ol7share" --automount</screen>
+    <para>
+      The following command removes the shared folder called
+      <filename>o7share</filename> for the <filename>ol7</filename> VM.
+    </para>
+<screen>$ VBoxManage sharedfolder remove ol7 --name ol7share</screen>
+  </refsect1>
+</refentry>
Index: trunk/doc/manual/en_US/man_VBoxManage-showmediuminfo.xml
===================================================================
--- trunk/doc/manual/en_US/man_VBoxManage-showmediuminfo.xml	(revision 82044)
+++ trunk/doc/manual/en_US/man_VBoxManage-showmediuminfo.xml	(revision 82044)
@@ -0,0 +1,131 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+         manpage, user manual, usage: VBoxManage showmediuminfo
+
+    Copyright (C) 2006-2019 Oracle Corporation
+
+    This file is part of VirtualBox Open Source Edition (OSE), as
+    available from http://www.virtualbox.org. This file is free software;
+    you can redistribute it and/or modify it under the terms of the GNU
+    General Public License (GPL) as published by the Free Software
+    Foundation, in version 2 as it comes in the "COPYING" file of the
+    VirtualBox OSE distribution. VirtualBox OSE is distributed in the
+    hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
+ -->
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+  "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"[
+<!ENTITY % all.entities SYSTEM "all-entities.ent">
+%all.entities;
+]>
+<refentry id="vboxmanage-showmediuminfo" lang="en">
+  <refentryinfo>
+    <pubdate>August 2019</pubdate>
+    <title>VBoxManage showmediuminfo</title>
+  </refentryinfo>
+
+  <refmeta>
+    <refentrytitle>VBoxManage-showmediuminfo</refentrytitle>
+    <manvolnum>1</manvolnum>
+  </refmeta>
+
+  <refnamediv>
+    <refname>VBoxManage-showmediuminfo</refname>
+    <refpurpose>show information about a medium</refpurpose>
+    <refclass>Oracle VM VirtualBox</refclass>
+  </refnamediv>
+
+  <refsynopsisdiv>
+    <cmdsynopsis id="synopsis-vboxmanage-showmediuminfo">
+<!-- The 'id' is mandatory and must start with 'synopsis-'. -->
+      <command>VBoxManage showmediuminfo</command>
+      <group>
+        <arg choice="plain">disk</arg>
+        <arg choice="plain">dvd</arg>
+        <arg choice="plain">floppy</arg>
+      </group>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>filename</replaceable></arg>
+      </group>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+
+  <refsect1>
+    <title>Description</title>
+    <para>
+      The <command>VBoxManage showmediuminfo</command> command shows the
+      following information about a medium:
+    </para>
+    <itemizedlist>
+      <listitem><para>
+          Size
+        </para></listitem>
+      <listitem><para>
+          Size on disk
+        </para></listitem>
+      <listitem><para>
+          Type
+        </para></listitem>
+      <listitem><para>
+          In use by virtual machines (VMs)
+        </para></listitem>
+    </itemizedlist>
+    <para>
+      The medium must be specified either by its UUID, if the medium is
+      registered, or by its filename. Registered images can be listed
+      using <command>VBoxManage list hdds</command>, <command>VBoxManage
+      list dvds</command>, or <command>VBoxManage list
+      floppies</command>, as appropriate.
+    </para>
+    <para>
+      For backward compatibility, you can also use the
+      <command>showvdiinfo</command> command to obtain information about
+      the medium.
+    </para>
+    <variablelist>
+      <varlistentry>
+        <term><literal>disk</literal> | <literal>dvd</literal> | <literal>floppy</literal></term>
+        <listitem><para>
+            Specifies the type of medium. Valid values are
+            <literal>disk</literal> (hard drive),
+            <literal>dvd</literal>, or <literal>floppy</literal>.
+          </para></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><replaceable>uuid</replaceable> | <replaceable>filename</replaceable></term>
+        <listitem><para>
+            Specifies the Universally Unique Identifier (UUID) or
+            absolute path name of the medium or image.
+          </para><para>
+            If the medium is registered, you can specify the UUID. You
+            can also list registered images by using the
+            <command>VBoxManage list hdds</command>, <command>VBoxManage
+            list dvds</command>, or <command>VBoxManage list
+            floppies</command> command.
+          </para></listitem>
+      </varlistentry>
+    </variablelist>
+  </refsect1>
+
+  <refsect1>
+    <title>Examples</title>
+    <remark role="help-scope" condition="GLOBAL" />
+    <para>
+      The following command shows information about the
+      <filename>disk01.vdi</filename> disk image:
+    </para>
+<screen>$ VBoxManage showmediuminfo disk01.vdi</screen>
+    <para>
+      The following command shows information about the
+      <filename>floppy01.img</filename> floppy disk image.
+    </para>
+<screen>$ VBoxManage showmediuminfo floppy floppy01.img</screen>
+  </refsect1>
+
+  <refsect1>
+    <title>See Also</title>
+    <para>
+      <xref linkend="vboxmanage-list" />
+    </para>
+  </refsect1>
+</refentry>
Index: trunk/doc/manual/en_US/man_VBoxManage-showvminfo.xml
===================================================================
--- trunk/doc/manual/en_US/man_VBoxManage-showvminfo.xml	(revision 82044)
+++ trunk/doc/manual/en_US/man_VBoxManage-showvminfo.xml	(revision 82044)
@@ -0,0 +1,177 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+    manpage, user manual, usage: VBoxManage showvminfo
+
+    Copyright (C) 2006-2019 Oracle Corporation
+
+    This file is part of VirtualBox Open Source Edition (OSE), as
+    available from http://www.virtualbox.org. This file is free software;
+    you can redistribute it and/or modify it under the terms of the GNU
+    General Public License (GPL) as published by the Free Software
+    Foundation, in version 2 as it comes in the "COPYING" file of the
+    VirtualBox OSE distribution. VirtualBox OSE is distributed in the
+    hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
+ -->
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+  "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"[
+<!ENTITY % all.entities SYSTEM "all-entities.ent">
+%all.entities;
+]>
+<refentry id="vboxmanage-showvminfo" lang="en">
+  <refentryinfo>
+    <pubdate>September 2019</pubdate>
+    <title>VBoxManage showvminfo</title>
+  </refentryinfo>
+
+  <refmeta>
+    <refentrytitle>VBoxManage-showvminfo</refentrytitle>
+    <manvolnum>1</manvolnum>
+  </refmeta>
+
+  <refnamediv>
+    <refname>VBoxManage-showvminfo</refname>
+    <refpurpose>show configuration information or log file contents for a virtual
+      machine</refpurpose>
+    <refclass>Oracle VM VirtualBox</refclass>
+  </refnamediv>
+
+  <refsynopsisdiv>
+    <cmdsynopsis id="synopsis-vboxmanage-showvminfo-default">
+<!-- The 'id' is mandatory and must start with 'synopsis-'. -->
+      <command>VBoxManage showvminfo</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg>--details</arg>
+      <arg>--machinereadable</arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-showvminfo-log">
+      <command>VBoxManage showvminfo</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg choice="req">--log=<replaceable>index</replaceable></arg>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+
+  <refsect1>
+    <title>Description</title>
+    <para>
+      The <command>VBoxManage showvminfo</command> command outputs
+      configuration information or log file contents for a specified
+      virtual machine (VM).
+    </para>
+    <refsect2 id="vboxmanage-showvminfo-default">
+      <title>Viewing Virtual Machine Information</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage showvminfo</command> command outputs
+        information about the specified VM in a detailed format or in a
+        machine-readable format.
+      </para>
+      <para>
+        The <command>VBoxManage showvminfo</command> command shows the
+        same information as the <command>VBoxManage list vms
+        --long</command> command for the specified VM.
+      </para>
+      <variablelist>
+        <varlistentry>
+          <term><option>--details</option></term>
+          <listitem><para>
+              Includes detailed information about the VM.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--machinereadable</option></term>
+          <listitem><para>
+              Specifies that the VM information be in a machine-readable
+              format.
+            </para></listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+    <refsect2 id="vboxmanage-showvminfo-log">
+      <title>Viewing Virtual Machine Log Contents</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage showvminfo --log</command> command
+        outputs the contents of one of the specified VM's log files.
+      </para>
+      <variablelist>
+        <varlistentry>
+          <term><option>--log=<replaceable>index</replaceable></option></term>
+          <listitem><para>
+              Specifies a numerical index that identifies the log file.
+            </para><para>
+              The index value starts at <literal>0</literal>, which
+              indicates the <filename>VBox.log</filename> file. An index
+              value of <literal>1</literal> indicates the
+              <filename>VBoxHardening.log</filename> file. Index values
+              starting at <literal>2</literal> indicate other log files,
+              such as the <filename>VBox.log.1</filename> file.
+            </para></listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+  </refsect1>
+
+  <refsect1>
+    <title>Examples</title>
+    <remark role="help-scope" condition="GLOBAL"/>
+    <para>
+      The following example shows typical output for this command:
+    </para>
+<screen>$ VBoxManage showvminfo "Windows 10"
+VirtualBox Command Line Management Interface Version <replaceable>version-number</replaceable>
+(C) 2005-2019 Oracle Corporation
+All rights reserved.
+
+Name:            Windows 10
+Groups:          /
+Guest OS:        Windows 10 (64-bit)
+UUID:            1bf3464d-57c6-4d49-92a9-a5cc3816b7e7
+Config file:     /home/username/VirtualBox VMs/Windows 10/Windows 10.vbox
+Snapshot folder: /home/username/VirtualBox VMs/Windows 10/Snapshots
+Log folder:      /home/username/VirtualBox VMs/Windows 10/Logs
+Hardware UUID:   1bf3464d-57c6-4d49-92a9-a5cc3816b7e7
+Memory size:     2048MB
+Page Fusion:     off
+VRAM size:       12MB
+CPU exec cap:    100%
+...</screen>
+    <para>
+      The following example shows the information output in a
+      machine-readable format, which shows the entries as a
+      <replaceable>property</replaceable>=<replaceable>value</replaceable>
+      string:
+    </para>
+<screen>$ VBoxManage showvminfo "Windows 10" --machinereadable
+...
+groups="/"
+ostype="Windows 10 (64-bit)"
+UUID="1bf3464d-57c6-4d49-92a9-a5cc3816b7e7"
+...</screen>
+    <para>
+      The following example shows the contents of the
+      <filename>VBox.log</filename> log file:
+    </para>
+<screen>$ VBoxManage showvminfo "Windows 10" --log 0
+00:00:02.895106 VirtualBox VM 6.0.0_RC1 r127378 linux.amd64 (Dec 10 2018 17:16:06) release log
+00:00:02.895109 Log opened 2018-12-14T14:31:44.088259000Z
+00:00:02.895111 Build Type: release
+00:00:02.895115 OS Product: Linux
+00:00:02.895117 OS Release: 4.1.12-61.1.22.el7uek.x86_64
+00:00:02.895119 OS Version: #2 SMP Fri Dec 2 09:28:44 PST 2016
+...</screen>
+  </refsect1>
+
+  <refsect1>
+    <title>See Also</title>
+    <para>
+      <xref linkend="vboxmanage-list" />
+    </para>
+  </refsect1>
+</refentry>
Index: trunk/doc/manual/en_US/man_VBoxManage-startvm.xml
===================================================================
--- trunk/doc/manual/en_US/man_VBoxManage-startvm.xml	(revision 82044)
+++ trunk/doc/manual/en_US/man_VBoxManage-startvm.xml	(revision 82044)
@@ -0,0 +1,162 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+         manpage, user manual, usage: VBoxManage startvm
+
+    Copyright (C) 2006-2019 Oracle Corporation
+
+    This file is part of VirtualBox Open Source Edition (OSE), as
+    available from http://www.virtualbox.org. This file is free software;
+    you can redistribute it and/or modify it under the terms of the GNU
+    General Public License (GPL) as published by the Free Software
+    Foundation, in version 2 as it comes in the "COPYING" file of the
+    VirtualBox OSE distribution. VirtualBox OSE is distributed in the
+    hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
+ -->
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+  "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"[
+<!ENTITY % all.entities SYSTEM "all-entities.ent">
+%all.entities;
+]>
+<refentry id="vboxmanage-startvm" lang="en">
+  <refentryinfo>
+    <pubdate>August 2019</pubdate>
+    <title>VBoxManage startvm</title>
+  </refentryinfo>
+
+  <refmeta>
+    <refentrytitle>VBoxManage-startvm</refentrytitle>
+    <manvolnum>1</manvolnum>
+  </refmeta>
+
+  <refnamediv>
+    <refname>VBoxManage-startvm</refname>
+    <refpurpose>start a virtual machine</refpurpose>
+    <refclass>Oracle VM VirtualBox</refclass>
+  </refnamediv>
+
+  <refsynopsisdiv>
+    <cmdsynopsis id="synopsis-vboxmanage-startvm">
+<!-- The 'id' is mandatory and must start with 'synopsis-'. -->
+      <command>VBoxManage startvm</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg>--putenv=<replaceable>name</replaceable>[=<replaceable>value</replaceable>]</arg>
+      <arg>--type=<group>
+          <arg choice="plain">gui</arg>
+          <arg choice="plain">headless</arg>
+          <arg choice="plain">sdl</arg>
+          <arg choice="plain">separate</arg>
+        </group></arg>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+
+  <refsect1>
+    <title>Description</title>
+    <para>
+      The <command>VBoxManage startvm</command> command starts an
+      &product-name; virtual machine (VM) that is in the Powered Off or
+      Saved state.
+    </para>
+    <variablelist>
+      <varlistentry>
+        <term><replaceable>uuid</replaceable> | <replaceable>vmname</replaceable></term>
+        <listitem><para>
+            Specifies the name or Universally Unique Identifier (UUID)
+            of the VM.
+          </para></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--putenv=<replaceable>name</replaceable>=<replaceable>value</replaceable></option></term>
+        <listitem><para>
+            Assigns a value to an environment variable as a name-value
+            pair. For example, VBOX_DISABLE_HOST_DISK_CACHE=1.
+          </para><para>
+            The short form of this option is <option>-E</option>.
+          </para></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--type=gui | headless | sdl | separate</option></term>
+        <listitem><para>
+            Specifies the frontend used to start the VM.
+          </para><para>
+            You can use the <command>VBoxManage setproperty</command>
+            command to set a global default value for the frontend.
+            Alternatively, you can use the <command>VBoxManage
+            modifyvm</command> command to specify a default frontend
+            value for a specific VM. If neither a global or per-VM
+            default value is set and you do not specify the
+            <option>--type</option> option, then the VM opens in a
+            window on the host desktop.
+          </para><para>
+            The <option>--type</option> option accepts the following
+            values:
+          </para><variablelist>
+            <varlistentry>
+              <term><literal>gui</literal></term>
+              <listitem><para>
+                  Starts a VM in a graphical user interface (GUI)
+                  window. This is the default.
+                </para></listitem>
+            </varlistentry>
+            <varlistentry>
+              <term><literal>headless</literal></term>
+              <listitem><para>
+                  Starts a VM for remote display only.
+                </para></listitem>
+            </varlistentry>
+            <varlistentry>
+              <term><literal>sdl</literal></term>
+              <listitem><para>
+                  Starts a VM using the VBoxSDL frontend.
+                </para></listitem>
+            </varlistentry>
+            <varlistentry>
+              <term><literal>separate</literal></term>
+              <listitem><para>
+                  Starts a VM with a detachable user interface (UI),
+                  which means that the VM runs headless with the UI in a
+                  separate process.
+                </para><para>
+                  This is an experimental feature that lacks certain
+                  functionality, such as 3D acceleration.
+                </para></listitem>
+            </varlistentry>
+          </variablelist></listitem>
+      </varlistentry>
+    </variablelist>
+    <note>
+      <para>
+        If a VM fails to start with a particular frontend and the error
+        information is inconclusive, consider starting the VM directly
+        by running the frontend. This workaround might provide
+        additional error information.
+      </para>
+    </note>
+  </refsect1>
+
+  <refsect1>
+    <title>Examples</title>
+    <remark role="help-scope" condition="GLOBAL" />
+    <para>
+      The following command starts the <literal>ol7u6</literal> VM:
+    </para>
+<screen>$ VBoxManage startvm ol7u6</screen>
+    <para>
+      The following command starts the
+      <literal>ol7u6-mininstall</literal> VM in headless mode.
+    </para>
+<screen>$ VBoxManage startvm ol7u6-mininstall --type headless</screen>
+  </refsect1>
+
+  <refsect1>
+    <title>See Also</title>
+    <para>
+<!--<xref linkend="vboxmanage-vboxheadless" />-->
+      <xref linkend="vboxheadless" />,
+      <xref linkend="vboxmanage-setproperty" />,
+      <xref linkend="vboxmanage-modifyvm" />.
+    </para>
+  </refsect1>
+</refentry>
Index: trunk/doc/manual/en_US/man_VBoxManage-storageattach.xml
===================================================================
--- trunk/doc/manual/en_US/man_VBoxManage-storageattach.xml	(revision 82044)
+++ trunk/doc/manual/en_US/man_VBoxManage-storageattach.xml	(revision 82044)
@@ -0,0 +1,538 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+         manpage, user manual, usage: VBoxManage storageattach
+
+    Copyright (C) 2006-2019 Oracle Corporation
+
+    This file is part of VirtualBox Open Source Edition (OSE), as
+    available from http://www.virtualbox.org. This file is free software;
+    you can redistribute it and/or modify it under the terms of the GNU
+    General Public License (GPL) as published by the Free Software
+    Foundation, in version 2 as it comes in the "COPYING" file of the
+    VirtualBox OSE distribution. VirtualBox OSE is distributed in the
+    hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
+ -->
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+  "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"[
+<!ENTITY % all.entities SYSTEM "all-entities.ent">
+%all.entities;
+]>
+<refentry id="vboxmanage-storageattach" lang="en">
+  <refentryinfo>
+    <pubdate>August 2019</pubdate>
+    <title>VBoxManage storageattach</title>
+  </refentryinfo>
+
+  <refmeta>
+    <refentrytitle>VBoxManage-storageattach</refentrytitle>
+    <manvolnum>1</manvolnum>
+  </refmeta>
+
+  <refnamediv>
+    <refname>VBoxManage-storageattach</refname>
+    <refpurpose>attach, remove, and modify storage media used by a virtual machine</refpurpose>
+    <refclass>Oracle VM VirtualBox</refclass>
+  </refnamediv>
+
+  <refsynopsisdiv>
+    <cmdsynopsis id="synopsis-vboxmanage-storageattach">
+<!-- The 'id' is mandatory and must start with 'synopsis-'. -->
+      <command>VBoxManage storageattach</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg choice="req">--storagectl=<replaceable>name</replaceable></arg>
+      <arg>--bandwidthgroup=<group choice="plain">
+          <arg choice="plain">name</arg>
+          <arg choice="plain">none</arg>
+        </group></arg>
+      <arg>--comment=<replaceable>text</replaceable></arg>
+      <arg>--device=<replaceable>number</replaceable></arg>
+      <arg>--discard=<group choice="plain">
+          <arg choice="plain">on</arg>
+          <arg choice="plain">off</arg>
+        </group></arg>
+      <arg>--encodedlun=<replaceable>lun</replaceable></arg>
+      <arg>--forceunmount</arg>
+      <arg>--hotpluggable=<group choice="plain">
+          <arg choice="plain">on</arg>
+          <arg choice="plain">off</arg>
+        </group></arg>
+      <arg>--initiator=<replaceable>initiator</replaceable></arg>
+      <arg>--intnet</arg>
+      <arg>--lun=<replaceable>lun</replaceable></arg>
+      <arg>--medium=<group choice="plain">
+          <arg choice="plain">none</arg>
+          <arg choice="plain">emptydrive</arg>
+          <arg choice="plain">additions</arg>
+          <arg choice="plain"><replaceable>uuid</replaceable></arg>
+          <arg choice="plain"><replaceable>filename</replaceable></arg>
+          <arg choice="plain">host:<replaceable>drive</replaceable></arg>
+          <arg choice="plain">iscsi</arg>
+        </group></arg>
+      <arg>--mtype=<group choice="plain">
+          <arg choice="plain">normal</arg>
+          <arg choice="plain">writethrough</arg>
+          <arg choice="plain">immutable</arg>
+          <arg choice="plain">shareable</arg>
+          <arg choice="plain">readonly</arg>
+          <arg choice="plain">multiattach</arg>
+        </group></arg>
+      <arg>--nonrotational=<group choice="plain">
+          <arg choice="plain">on</arg>
+          <arg choice="plain">off</arg>
+        </group></arg>
+      <arg>--passthrough=<group choice="plain">
+          <arg choice="plain">on</arg>
+          <arg choice="plain">off</arg>
+        </group></arg>
+      <arg>--passwordfile=<replaceable>file</replaceable></arg>
+      <arg>--password=<replaceable>password</replaceable></arg>
+      <arg>--port=<replaceable>number</replaceable></arg>
+      <arg>--server=<group choice="plain">
+          <arg choice="plain"><replaceable>name</replaceable></arg>
+          <arg choice="plain"><replaceable>ip</replaceable></arg>
+        </group></arg>
+      <arg>--setparentuuid=<replaceable>uuid</replaceable></arg>
+      <arg>--setuuid=<replaceable>uuid</replaceable></arg>
+      <arg>--target=<replaceable>target</replaceable></arg>
+      <arg>--tempeject=<group choice="plain">
+          <arg choice="plain">on</arg>
+          <arg choice="plain">off</arg>
+        </group></arg>
+      <arg>--tport=<replaceable>port</replaceable></arg>
+      <arg>--type=<group choice="plain">
+          <arg choice="plain">dvddrive</arg>
+          <arg choice="plain">fdd</arg>
+          <arg choice="plain">hdd</arg>
+        </group></arg>
+      <arg>--username=<replaceable>username</replaceable></arg>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+
+  <refsect1>
+    <title>Description</title>
+    <para>
+      The <command>VBoxManage storageattach</command> command enables
+      you to manage a storage medium that you connected to a storage
+      controller by using the <command>VBoxManage storagectl</command>
+      command.
+    </para>
+    <variablelist>
+      <varlistentry>
+        <term><replaceable>uuid</replaceable> | <replaceable>vmname</replaceable></term>
+        <listitem><para>
+            Specifies the Universally Unique Identifier (UUID) or the
+            name of the virtual machine (VM).
+          </para></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--storagectl=<replaceable>name</replaceable></option></term>
+        <listitem><para>
+            Specifies the name of the storage controller. Use the
+            <command>VBoxManage showvminfo</command> command to list the
+            storage controllers that are attached to the VM.
+          </para></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--port=<replaceable>number</replaceable></option></term>
+        <listitem><para>
+            Specifies the port number of the storage controller to
+            modify. You must specify this option unless the storage
+            controller has only a single port.
+          </para></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--device=<replaceable>number</replaceable></option></term>
+        <listitem><para>
+            Specifies the port's device number to modify. You must
+            specify this option unless the storage controller has only
+            one device per port.
+          </para></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--type=dvddrive | fdd | hdd</option></term>
+        <listitem><para>
+            Specifies the drive type to which the medium is associated.
+            Only omit this option if the medium type can be determined
+            by using the <option>--medium</option> option or by
+            information provided by an earlier medium attachment
+            command.
+          </para></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--medium=none | emptydrive | additions | <replaceable>uuid</replaceable> | <replaceable>filename</replaceable> | host:<replaceable>drive</replaceable> | iscsi</option></term>
+        <listitem><para>
+            Specifies one of the following values:
+          </para><variablelist>
+            <varlistentry>
+              <term><literal>none</literal></term>
+              <listitem><para>
+                  Removes any existing device from the specified slot.
+                </para></listitem>
+            </varlistentry>
+            <varlistentry>
+              <term><literal>emptydrive</literal></term>
+              <listitem><para>
+                  For a virtual DVD or floppy drive only.
+                </para><para>
+                  Makes the device slot behave like a removeable drive
+                  into which no media has been inserted.
+                </para></listitem>
+            </varlistentry>
+            <varlistentry>
+              <term><literal>additions</literal></term>
+              <listitem><para>
+                  For a virtual DVD drive only.
+                </para><para>
+                  Attaches the VirtualBox Guest Additions image to the
+                  specified device slot.
+                </para></listitem>
+            </varlistentry>
+            <varlistentry>
+              <term><replaceable>uuid</replaceable></term>
+              <listitem><para>
+                  Specifies the UUID of a storage medium to attach to
+                  the specified device slot. The storage medium must
+                  already be known to &product-name;, such as a storage
+                  medium that is attached to another VM. Use the
+                  <command>VBoxManage list</command> command to list
+                  media.
+                </para></listitem>
+            </varlistentry>
+            <varlistentry>
+              <term><replaceable>filename</replaceable></term>
+              <listitem><para>
+                  Specifies the full path of an existing disk image to
+                  attach to the specified device slot. The disk image
+                  can be in ISO, RAW, VDI, VMDK, or other format.
+                </para></listitem>
+            </varlistentry>
+            <varlistentry>
+              <term><literal>host:<replaceable>drive</replaceable></literal></term>
+              <listitem><para>
+                  For a virtual DVD or floppy drive only.
+                </para><para>
+                  Connects the specified device slot to the specified
+                  DVD or floppy drive on the host computer.
+                </para></listitem>
+            </varlistentry>
+            <varlistentry>
+              <term><literal>iscsi</literal></term>
+              <listitem><para>
+                  For virtual hard disks only.
+                </para><para>
+                  Specifies an iSCSI target for which you must specify
+                  additional information. See
+                  <xref linkend="storage-iscsi" />.
+                </para></listitem>
+            </varlistentry>
+          </variablelist><para>
+            For removeable media such as floppies and DVDs, you can make
+            configuration changes while a VM is running. Changes to
+            devices or hard disk device slots require that the VM be
+            powered off.
+          </para></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--mtype=normal | writethrough | immutable | shareable | readonly | multiattach</option></term>
+        <listitem><para>
+            Specifies how this medium behaves with respect to snapshots
+            and write operations. See <xref linkend="hdimagewrites" />.
+          </para></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--comment=<replaceable>text</replaceable></option></term>
+        <listitem><para>
+            Specifies an optional description to store with the medium.
+          </para></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--setuuid=<replaceable>uuid</replaceable></option></term>
+        <listitem><para>
+            Modifies the UUID of a medium before attaching it to a VM.
+          </para><para>
+            This is an expert option. Inappropriate values might make
+            the medium unusable or lead to broken VM configurations if
+            another VM already refers to the same medium.
+          </para><para>
+            Using the <option>--setuuid=&ldquo;&rdquo;</option> option
+            assigns a new random UUID to an image, which can resolve
+            duplicate UUID errors if you used a file copy utility to
+            duplicate an image.
+          </para></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--setparentuuid=<replaceable>uuid</replaceable></option></term>
+        <listitem><para>
+            Modifies the parent UUID of a medium before attaching it to
+            a VM.
+          </para><para>
+            This is an expert option. Inappropriate values might make
+            the medium unusable or lead to broken VM configurations if
+            another VM already refers to the same medium.
+          </para></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--passthrough=on | off</option></term>
+        <listitem><para>
+            For a virtual DVD drive only.
+          </para><para>
+            Enables writing to a DVD. This feature is experimental, see
+            <xref linkend="storage-cds" />.
+          </para></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--tempeject=on | off</option></term>
+        <listitem><para>
+            For a virtual DVD drive only.
+          </para><para>
+            Specifies whether to permit a temporary guest-triggered
+            medium eject operation. When set to <literal>on</literal>,
+            you can eject a medium. The ability for a guest-triggered
+            eject operation does not persist if the VM is powered off
+            and restarted. So, when you set this option to
+            <literal>on</literal> and the VM is restarted, the
+            originally configured medium is still in the drive.
+          </para></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--nonrotational=on | off</option></term>
+        <listitem><para>
+            Enables you to specify that the virtual hard disk is
+            non-rotational. Some guest OSes, such as Windows 7 or later,
+            treat such disks as solid state drives (SSDs) and do not
+            perform disk fragmentation on them.
+          </para></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--discard=on | off</option></term>
+        <listitem><para>
+            Specifies whether to enable the auto-discard feature for a
+            virtual hard disk. When set to <literal>on</literal>, a VDI
+            image is shrunk in response to a <command>trim</command>
+            command from the guest OS.
+          </para><para>
+            The virtual hard disk must meet the following requirements:
+          </para><itemizedlist>
+            <listitem><para>
+                The disk format must be VDI.
+              </para></listitem>
+            <listitem><para>
+                The size of the cleared area of the disk must be at
+                least 1 MB.
+              </para></listitem>
+            <listitem><para>
+                Ensure that the space being trimmed is at least a 1 MB
+                contiguous block at a 1 MB boundary.
+              </para></listitem>
+          </itemizedlist><para>
+            Consider running defragmentation commands as background cron
+            jobs to save space. On Windows, run the <command>defrag.exe
+            /D</command> command. On Linux, run the <command>btrfs
+            filesystem defrag</command> command.
+          </para><note>
+            <para>
+              When you configure the guest OS to issue the
+              <command>trim</command> command, the guest OS typically
+              sees the disk as an SSD.
+            </para>
+            <para>
+              Ext4 supports the <option>-o discard</option> mount
+              option. Mac OS X might require additional settings.
+              Windows 7, 8, and 10 automatically detect and support
+              SSDs. The Linux <command>exFAT</command> driver from
+              Samsung supports the <command>trim</command> command.
+            </para>
+          </note><para>
+            The Microsoft implementation of exFAT might not support this
+            feature.
+          </para><para>
+            You can use other methods to issue trim commands. The Linux
+            <command>fstrim</command> command is part of the
+            <filename>util-linux</filename> package. Earlier solutions
+            required you to zero out unused areas by using the
+            <command>zerofree</command> or a similar command, and then
+            to compact the disk. You can only perform these steps when
+            the VM is offline.
+          </para></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--bandwidthgroup=<replaceable>name</replaceable></option></term>
+        <listitem><para>
+            Specifies the bandwidth group to use for the device. See
+            <xref linkend="storage-bandwidth-limit" />.
+          </para></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--forceunmount</option></term>
+        <listitem><para>
+            For a virtual DVD or floppy drive only.
+          </para><para>
+            Forcibly unmounts the DVD, CD, or floppy or mounts a new
+            DVD, CD, or floppy even if the previous removable storage is
+            locked by the guest for reading. See
+            <xref linkend="storage-cds" />.
+          </para></listitem>
+      </varlistentry>
+    </variablelist>
+    <para>
+      The following options are applicable when you specify the
+      <option>--medium=iscsi</option> option:
+    </para>
+    <variablelist>
+      <varlistentry>
+        <term><option>--server=<replaceable>hostname</replaceable> | <replaceable>IP-address</replaceable></option></term>
+        <listitem><para>
+            Specifies the host name or IP address of the iSCSI target.
+          </para></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--target=<replaceable>target</replaceable></option></term>
+        <listitem><para>
+            Specifies the target name string, which is determined by the
+            iSCSI target and is used to identify the storage resource.
+          </para></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--tport=<replaceable>port</replaceable></option></term>
+        <listitem><para>
+            Specifies the TCP/IP port number of the iSCSI service on the
+            target.
+          </para></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--lun=<replaceable>LUN</replaceable></option></term>
+        <listitem><para>
+            Specifies the logical unit number (LUN) of the target
+            resource. For a single disk drive, the value is zero.
+          </para></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--encodedlun=<replaceable>LUN</replaceable></option></term>
+        <listitem><para>
+            Specifies the hexadecimal-encoded of the target resource.
+            For a single disk drive, the value is zero.
+          </para></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--username=<replaceable>username</replaceable></option></term>
+        <listitem><para>
+            Specifies the user name to use for target authentication.
+          </para><note>
+            <para>
+              Unless you provide a settings password, the user name is
+              stored as clear text in the XML machine configuration
+              file.
+            </para>
+          </note></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--password=<replaceable>password</replaceable></option></term>
+        <listitem><para>
+            Specifies the password used for target authentication.
+          </para><note>
+            <para>
+              Unless you provide a settings password, this password is
+              stored as clear text in the XML machine configuration
+              file. When you specify a settings password for the first
+              time, the target authentication password is stored in
+              encrypted form.
+            </para>
+          </note><remark>
+            This design does not conform to Oracle's security
+            guidelines. You should not be able to specify a password on
+            the command line because the password can be seen in a
+            process listing.
+          </remark></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--passwordfile=<replaceable>password-filename</replaceable></option></term>
+        <listitem><para>
+            Specifies a file that contains the target authentication
+            password as clear text.
+          </para><note>
+            <para>
+              Use permission and ownership settings to ensure that the
+              contents of this file cannot be read by unauthorized
+              users.
+            </para>
+          </note></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--initiator=<replaceable>initiator</replaceable></option></term>
+        <listitem><para>
+            Specifies the iSCSI initiator.
+          </para><para>
+            The Microsoft iSCSI Initiator is a system, such as a server,
+            that attaches to an IP network and initiates requests and
+            receives responses from an iSCSI target. The SAN components
+            in the iSCSI initiator are largely analogous to Fibre
+            Channel SAN components, and they include the following:
+          </para><itemizedlist>
+            <listitem><para>
+                <emphasis role="bold">iSCSI driver.</emphasis>
+                Transports blocks of iSCSI commands over the IP network.
+                This iSCSI driver is installed on the iSCSI host and is
+                included with the Microsoft iSCSI Initiator.
+              </para></listitem>
+            <listitem><para>
+                <emphasis role="bold">Gigabit Ethernet
+                adapter.</emphasis> Connects to an iSCSI target. Use an
+                Ethernet adapter that can transmit 1000 megabits per
+                second (Mbps). Like standard 10/100 adapters, most
+                gigabit adapters use a preexisting Category 5 or
+                Category 6E cable. Each port on the adapter is
+                identified by a unique IP address.
+              </para></listitem>
+            <listitem><para>
+                <emphasis role="bold">iSCSI target.</emphasis> Is any
+                device that receives iSCSI commands. The device can be
+                an end node such as a storage device, or it can be an
+                intermediate device such as a network bridge between IP
+                and Fibre Channel devices. Each port on the storage
+                array controller or network bridge is identified by one
+                or more IP addresses.
+              </para></listitem>
+          </itemizedlist></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--intnet</option></term>
+        <listitem><para>
+            Specifies whether to connect to the iSCSI target that uses
+            internal networking. This configuration requires further
+            configuration. See <xref linkend="iscsi-intnet" />.
+          </para></listitem>
+      </varlistentry>
+    </variablelist>
+  </refsect1>
+
+  <refsect1>
+    <title>Examples</title>
+    <remark role="help-scope" condition="GLOBAL" />
+    <para>
+      The following command attaches the <filename>o7.vdi</filename>
+      disk image to the specified SATA storage controller on the
+      <filename>ol7</filename> VM.
+    </para>
+<screen>$ storageattach ol7 --storagectl "SATA Controller" --port 0 --device 0 \
+--type hdd --medium /VirtualBox/ol7/ol7.vdi</screen>
+    <para>
+      The following command attaches the
+      <filename>o7-r6-dvd.iso</filename> DVD image to the specified IDE
+      storage controller on the <filename>ol7</filename> VM.
+    </para>
+<screen>$ VBoxManage storageattach ol7 --storagectl "IDE Controller" --port 0 --device 0 \
+--type dvddrive --medium ol7-r6-dvd.iso</screen>
+  </refsect1>
+
+  <refsect1>
+    <title>See Also</title>
+    <para>
+      <xref linkend="vboxmanage-list" />,
+      <xref linkend="vboxmanage-showvminfo" />,
+      <xref linkend="vboxmanage-storagectl" />
+    </para>
+  </refsect1>
+</refentry>
Index: trunk/doc/manual/en_US/man_VBoxManage-storagectl.xml
===================================================================
--- trunk/doc/manual/en_US/man_VBoxManage-storagectl.xml	(revision 82044)
+++ trunk/doc/manual/en_US/man_VBoxManage-storagectl.xml	(revision 82044)
@@ -0,0 +1,193 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+    manpage, user manual, usage: VBoxManage storagectl
+
+    Copyright (C) 2006-2019 Oracle Corporation
+
+    This file is part of VirtualBox Open Source Edition (OSE), as
+    available from http://www.virtualbox.org. This file is free software;
+    you can redistribute it and/or modify it under the terms of the GNU
+    General Public License (GPL) as published by the Free Software
+    Foundation, in version 2 as it comes in the "COPYING" file of the
+    VirtualBox OSE distribution. VirtualBox OSE is distributed in the
+    hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
+ -->
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+  "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"[
+<!ENTITY % all.entities SYSTEM "all-entities.ent">
+%all.entities;
+]>
+<refentry id="vboxmanage-storagectl" lang="en">
+  <refentryinfo>
+    <pubdate>August 2019</pubdate>
+    <title>VBoxManage storagectl</title>
+  </refentryinfo>
+
+  <refmeta>
+    <refentrytitle>VBoxManage-storagectl</refentrytitle>
+    <manvolnum>1</manvolnum>
+  </refmeta>
+
+  <refnamediv>
+    <refname>VBoxManage-storagectl</refname>
+    <refpurpose>manage a storage controller</refpurpose>
+    <refclass>Oracle VM VirtualBox</refclass>
+  </refnamediv>
+
+  <refsynopsisdiv>
+<!-- The 'id' is mandatory and must start with 'synopsis-'. -->
+    <cmdsynopsis id="synopsis-vboxmanage-storagectl">
+      <command>VBoxManage storagectl</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg choice="req">--name=<replaceable>controller-name</replaceable></arg>
+      <arg>--add=<group choice="plain">
+          <arg choice="plain">floppy</arg>
+          <arg choice="plain">ide</arg>
+          <arg choice="plain">pcie</arg>
+          <arg choice="plain">sas</arg>
+          <arg choice="plain">sata</arg>
+          <arg choice="plain">scsi</arg>
+          <arg choice="plain">usb</arg>
+        </group></arg>
+      <arg>--controller=<group choice="plain">
+          <arg choice="plain">BusLogic</arg>
+          <arg choice="plain">I82078</arg>
+          <arg choice="plain">ICH6</arg>
+          <arg choice="plain">IntelAhci</arg>
+          <arg choice="plain">LSILogic</arg>
+          <arg choice="plain">LSILogicSAS</arg>
+          <arg choice="plain">NVMe</arg>
+          <arg choice="plain">PIIX3</arg>
+          <arg choice="plain">PIIX4</arg>
+          <arg choice="plain">USB</arg>
+        </group></arg>
+      <arg>--bootable=<group choice="plain">
+          <arg choice="plain">on</arg>
+          <arg choice="plain">off</arg>
+        </group></arg>
+      <arg>--hostiocache=<group choice="plain">
+          <arg choice="plain">on</arg>
+          <arg choice="plain">off</arg>
+        </group></arg>
+      <arg>--portcount=<replaceable>count</replaceable></arg>
+      <arg>--remove</arg>
+      <arg>--rename=<replaceable>new-controller-name</replaceable></arg>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+
+  <refsect1>
+    <title>Description</title>
+    <para>
+      The <command>VBoxManage storagectl</command> command enables you
+      to attach, modify, and remove a storage controller. After you
+      configure the storage controller, you can use the
+      <command>VBoxManage storageattach</command> command to attach
+      virtual media to the controller.
+    </para>
+    <variablelist>
+      <varlistentry>
+        <term><replaceable>uuid</replaceable> | <replaceable>vmname</replaceable></term>
+        <listitem><para>
+            Specifies the Universally Unique Identifier (UUID) or name
+            of the virtual machine (VM).
+          </para></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--name=<replaceable>controller-name</replaceable></option></term>
+        <listitem><para>
+            Specifies the name of the storage controller.
+          </para></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--add=<replaceable>system-bus-type</replaceable></option></term>
+        <listitem><para>
+            Specifies the type of the system bus to which to connect the
+            storage controller. Valid values are
+            <literal>floppy</literal>, <literal>ide</literal>,
+            <literal>pcie</literal>, <literal>sas</literal>,
+            <literal>sata</literal>, <literal>scsi</literal>, and
+            <literal>usb</literal>.
+          </para></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--controller=<replaceable>chipset-type</replaceable></option></term>
+        <listitem><para>
+            Specifies the chipset type to emulate for the specified
+            storage controller. Valid values are
+            <literal>BusLogic</literal>, <literal>I82078</literal>,
+            <literal>ICH6</literal>, <literal>IntelAHCI</literal>,
+            <literal>LSILogic</literal>, <literal>LSILogicSAS</literal>,
+            <literal>NVMe</literal>, <literal>PIIX3</literal>,
+            <literal>PIIX4</literal>, and <literal>USB</literal>.
+          </para><para>
+            The default value varies, according to the type of storage
+            controller.
+          </para></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--portcount=<replaceable>count</replaceable></option></term>
+        <listitem><para>
+            Specifies the number of ports that the storage controller
+            supports. Valid values depend on the type of storage
+            controller.
+          </para></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--hostiocache=on|off</option></term>
+        <listitem><para>
+            Specifies whether to use the host I/O cache for all disk
+            images attached to this storage controller. Valid values are
+            <literal>on</literal> and <literal>off</literal>. See
+            <xref linkend="iocaching" />.
+          </para></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--bootable=on|off</option></term>
+        <listitem><para>
+            Specifies whether this controller is bootable. Valid values
+            are <literal>on</literal> and <literal>off</literal>.
+          </para></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--rename=<replaceable>new-controller-name</replaceable></option></term>
+        <listitem><para>
+            Specifies a new name for the storage controller.
+          </para></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--remove</option></term>
+        <listitem><para>
+            Removes a storage controller from the VM configuration.
+          </para></listitem>
+      </varlistentry>
+    </variablelist>
+  </refsect1>
+
+  <refsect1>
+    <title>Examples</title>
+    <remark role="help-scope" condition="GLOBAL" />
+    <para>
+      The following command creates a SATA storage controller called
+      <literal>sata01</literal> and adds it to the
+      <literal>ol7</literal> VM. The storage controller emulates the
+      IntelAHCI chipset.
+    </para>
+<screen>$ VBoxManage storagectl ol7 --name "sata01" --add sata --controller IntelAHCI</screen>
+    <para>
+      The following command creates an IDE storage controller called
+      <literal>ide01</literal> and adds it to the <literal>ol7</literal>
+      VM.
+    </para>
+<screen>$ VBoxManage storagectl ol7 --name "ide01" --add ide</screen>
+  </refsect1>
+
+  <refsect1>
+    <title>See Also</title>
+    <para>
+      <xref linkend="vboxmanage-storageattach" />
+    </para>
+  </refsect1>
+</refentry>
Index: trunk/doc/manual/en_US/man_VBoxManage-unregistervm.xml
===================================================================
--- trunk/doc/manual/en_US/man_VBoxManage-unregistervm.xml	(revision 82044)
+++ trunk/doc/manual/en_US/man_VBoxManage-unregistervm.xml	(revision 82044)
@@ -0,0 +1,112 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+    manpage, user manual, usage: VBoxManage unregistervm
+
+    Copyright (C) 2006-2019 Oracle Corporation
+
+    This file is part of VirtualBox Open Source Edition (OSE), as
+    available from http://www.virtualbox.org. This file is free software;
+    you can redistribute it and/or modify it under the terms of the GNU
+    General Public License (GPL) as published by the Free Software
+    Foundation, in version 2 as it comes in the "COPYING" file of the
+    VirtualBox OSE distribution. VirtualBox OSE is distributed in the
+    hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
+ -->
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+  "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"[
+<!ENTITY % all.entities SYSTEM "all-entities.ent">
+%all.entities;
+]>
+<refentry id="vboxmanage-unregistervm" lang="en">
+  <refentryinfo>
+    <pubdate>August 2019</pubdate>
+    <title>VBoxManage unregistervm</title>
+  </refentryinfo>
+
+  <refmeta>
+    <refentrytitle>VBoxManage-unregistervm</refentrytitle>
+    <manvolnum>1</manvolnum>
+  </refmeta>
+
+  <refnamediv>
+    <refname>VBoxManage-unregistervm</refname>
+    <refpurpose>unregister a virtual machine</refpurpose>
+    <refclass>Oracle VM VirtualBox</refclass>
+  </refnamediv>
+
+  <refsynopsisdiv>
+    <cmdsynopsis id="synopsis-vboxmanage-unregistervm">
+<!-- The 'id' is mandatory and must start with 'synopsis-'. -->
+      <command>VBoxManage unregistervm</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg>--delete</arg>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+
+  <refsect1>
+    <title>Description</title>
+    <para>
+      The <command>VBoxManage unregistervm</command> command unregisters
+      a virtual machine (VM).
+    </para>
+    <variablelist>
+      <varlistentry>
+        <term><replaceable>uuid</replaceable>|<replaceable>vmname</replaceable></term>
+        <listitem><para>
+            Specifies the name or Universally Unique Identifier (UUID)
+            of the VM.
+          </para></listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--delete</option></term>
+        <listitem><para>
+            Deletes the following files related to the VM automatically:
+          </para><itemizedlist>
+            <listitem><para>
+                All hard disk image files, including differencing files.
+              </para></listitem>
+            <listitem><para>
+                All saved state files that the machine created,
+                including one for each snapshot.
+              </para></listitem>
+            <listitem><para>
+                XML VM machine definition file and its backups.
+              </para></listitem>
+            <listitem><para>
+                VM log files.
+              </para></listitem>
+            <listitem><para>
+                The empty directory associated with the unregistered VM.
+              </para></listitem>
+          </itemizedlist></listitem>
+      </varlistentry>
+    </variablelist>
+  </refsect1>
+
+  <refsect1>
+    <title>Examples</title>
+    <remark role="help-scope" condition="GLOBAL" />
+    <para>
+      The following command unregisters a VM called
+      <literal>vm2</literal>.
+    </para>
+<screen>$ VBoxManage unregistervm vm2</screen>
+    <para>
+      The following command unregisters a VM called
+      <literal>vm3</literal>. All files associated with the VM are
+      deleted.
+    </para>
+<screen>$ VBoxManage unregistervm vm3 --delete
+%...10%...20%...30%...40%...50%...60%...70%...80%...90%...100%</screen>
+  </refsect1>
+
+  <refsect1>
+    <title>See Also</title>
+    <para>
+      <xref linkend="vboxmanage-registervm" />
+    </para>
+  </refsect1>
+</refentry>
Index: trunk/doc/manual/en_US/man_VBoxManage-usbdevsource.xml
===================================================================
--- trunk/doc/manual/en_US/man_VBoxManage-usbdevsource.xml	(revision 82044)
+++ trunk/doc/manual/en_US/man_VBoxManage-usbdevsource.xml	(revision 82044)
@@ -0,0 +1,118 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+    manpage, user manual, usage: VBoxManage usbdevsource
+
+    Copyright (C) 2006-2019 Oracle Corporation
+
+    This file is part of VirtualBox Open Source Edition (OSE), as
+    available from http://www.virtualbox.org. This file is free software;
+    you can redistribute it and/or modify it under the terms of the GNU
+    General Public License (GPL) as published by the Free Software
+    Foundation, in version 2 as it comes in the "COPYING" file of the
+    VirtualBox OSE distribution. VirtualBox OSE is distributed in the
+    hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
+ -->
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+  "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"[
+<!ENTITY % all.entities SYSTEM "all-entities.ent">
+%all.entities;
+]>
+<refentry id="vboxmanage-usbdevsource" lang="en">
+  <refentryinfo>
+    <pubdate>September 2019</pubdate>
+    <title>VBoxManage usbdevsource</title>
+  </refentryinfo>
+
+  <refmeta>
+    <refentrytitle>VBoxManage-usbdevsource</refentrytitle>
+    <manvolnum>1</manvolnum>
+  </refmeta>
+
+  <refnamediv>
+    <refname>vboxmanage-usbdevsource</refname>
+    <refpurpose>add and remove USB device sources</refpurpose>
+    <refclass>Oracle VM VirtualBox</refclass>
+  </refnamediv>
+
+  <refsynopsisdiv>
+    <cmdsynopsis id="synopsis-vboxmanage-usbdevsource-add">
+      <command>VBoxManage usbdevsource add</command> 
+      <arg choice="req"><replaceable>source-name</replaceable></arg>
+      <arg choice="req">--backend=<replaceable>backend</replaceable></arg>
+      <arg choice="req">--address=<replaceable>address</replaceable></arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-usbdevsource-remove">
+      <command>VBoxManage usbdevsource remove</command> 
+      <arg choice="req"><replaceable>source-name</replaceable></arg>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+
+  <refsect1>
+    <title>Description</title>
+    <para>
+      The <command>VBoxManage usbdevsource</command> command adds a USB
+      device source and makes it available to the guests on the host
+      system. You can also use this command to remove the USB device
+      source.
+    </para>
+    <refsect2 id="vboxmanage-usbdevsource-add">
+      <title>Add a USB Device Source</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage usbdevsource add</command> command adds
+        a USB device source, which is available to all guests on the
+        host system.
+      </para>
+      <variablelist>
+        <varlistentry>
+          <term><replaceable>source-name</replaceable></term>
+          <listitem><para>
+              Specifies a unique name for the USB device source.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>--address=<replaceable>address</replaceable></term>
+          <listitem><para>
+              Specifies the address of the USB backend.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>--backend=<replaceable>backend</replaceable></term>
+          <listitem><para>
+              Specifies the USB proxy service backend to use.
+            </para><remark>
+              What is the USB proxy service? How do you
+              determine the backend to use?
+            </remark></listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+    <refsect2 id="vboxmanage-usbdevsource-remove">
+      <title>Remove a USB Device</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage usbdevsource remove</command> command
+        removes a USB device.
+      </para>
+      <variablelist>
+        <varlistentry>
+          <term><replaceable>source-name</replaceable></term>
+          <listitem><para>
+              Specifies the name of the USB device source to remove.
+            </para></listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+  </refsect1>
+
+  <refsect1>
+    <title>Examples</title>
+    <remark role="help-scope" condition="GLOBAL" />
+    <para>
+      The following command adds a USB device server called
+      <filename>hostusb01</filename>.
+    </para>
+<screen>$ VBoxManage usbdevsource add hostusb01 --backend USBIP --address 10.0.1.16</screen>
+  </refsect1>
+</refentry>
Index: trunk/doc/manual/en_US/man_VBoxManage-usbfilter.xml
===================================================================
--- trunk/doc/manual/en_US/man_VBoxManage-usbfilter.xml	(revision 82044)
+++ trunk/doc/manual/en_US/man_VBoxManage-usbfilter.xml	(revision 82044)
@@ -0,0 +1,304 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+    manpage, user manual, usage: VBoxManage usbfilter
+
+    Copyright (C) 2006-2019 Oracle Corporation
+
+    This file is part of VirtualBox Open Source Edition (OSE), as
+    available from http://www.virtualbox.org. This file is free software;
+    you can redistribute it and/or modify it under the terms of the GNU
+    General Public License (GPL) as published by the Free Software
+    Foundation, in version 2 as it comes in the "COPYING" file of the
+    VirtualBox OSE distribution. VirtualBox OSE is distributed in the
+    hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
+ -->
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+  "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"[
+<!ENTITY % all.entities SYSTEM "all-entities.ent">
+%all.entities;
+]>
+<refentry id="vboxmanage-usbfilter" lang="en">
+  <refentryinfo>
+    <pubdate>September 2019</pubdate>
+    <title>VBoxManage usbfilter</title>
+  </refentryinfo>
+
+  <refmeta>
+    <refentrytitle>VBoxManage-usbfilter</refentrytitle>
+    <manvolnum>1</manvolnum>
+  </refmeta>
+
+  <refnamediv>
+    <refname>VBoxManage-usbfilter</refname>
+    <refpurpose>manage USB filters</refpurpose>
+    <refclass>Oracle VM VirtualBox</refclass>
+  </refnamediv>
+
+  <refsynopsisdiv>
+<!-- The 'id' is mandatory and must start with 'synopsis-'. -->
+    <cmdsynopsis id="synopsis-vboxmanage-usbfilter-add">
+      <command>VBoxManage usbfilter add</command> 
+      <arg choice="req"><replaceable>index</replaceable>,0-<replaceable>N</replaceable></arg>
+      <arg choice="req">--target=<group choice="req">
+          <arg choice="plain"><replaceable>uuid</replaceable></arg>
+          <arg choice="plain"><replaceable>vmname</replaceable></arg>
+          <arg choice="plain">global</arg>
+        </group></arg>
+      <arg choice="req">--name=<replaceable>string</replaceable></arg>
+      <arg choice="req">--action=ignore | hold</arg>
+      <arg>--active=yes | no</arg>
+      <arg>--vendorid=<replaceable>XXXX</replaceable></arg>
+      <arg>--productid=<replaceable>XXXX</replaceable></arg>
+      <arg>--revision=<replaceable>IIFF</replaceable></arg>
+      <arg>--manufacturer=<replaceable>string</replaceable></arg>
+      <arg>--product=<replaceable>string</replaceable></arg>
+      <arg>--remote=yes | no</arg>
+      <arg>--serialnumber=<replaceable>string</replaceable></arg>
+      <arg>--maskedinterfaces=<replaceable>XXXXXXXX</replaceable></arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-usbfilter-modify">
+      <command>VBoxManage usbfilter modify</command> 
+      <arg choice="req"><replaceable>index</replaceable>,0-<replaceable>N</replaceable></arg>
+      <arg choice="req">--target=<group choice="req">
+          <arg choice="plain"><replaceable>uuid</replaceable></arg>
+          <arg choice="plain"><replaceable>vmname</replaceable></arg>
+          <arg choice="plain">global</arg>
+        </group></arg>
+      <arg>--name=<replaceable>string</replaceable></arg>
+      <arg>--action=ignore | hold</arg>
+      <arg>--active=yes | no</arg>
+      <arg>--vendorid=<replaceable>XXXX</replaceable> | &ldquo;&rdquo;</arg>
+      <arg>--productid=<replaceable>XXXX</replaceable> | &ldquo;&rdquo;</arg>
+      <arg>--revision=<replaceable>IIFF</replaceable> | &ldquo;&rdquo;</arg>
+      <arg>--manufacturer=<replaceable>string</replaceable> | &ldquo;&rdquo;</arg>
+      <arg>--product=<replaceable>string</replaceable> | &ldquo;&rdquo;</arg>
+      <arg>--remote=yes | no</arg>
+      <arg>--serialnumber=<replaceable>string</replaceable> | &ldquo;&rdquo;</arg>
+      <arg>--maskedinterfaces=<replaceable>XXXXXXXX</replaceable></arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboxmanage-usbfilter-remove">
+      <command>VBoxManage usbfilter remove</command> 
+      <arg choice="req"><replaceable>index</replaceable>,0-<replaceable>N</replaceable></arg>
+      <arg choice="req">--target=<group choice="req">
+          <arg choice="plain"><replaceable>uuid</replaceable></arg>
+          <arg choice="plain"><replaceable>vmname</replaceable></arg>
+          <arg choice="plain">global</arg>
+        </group></arg>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+
+  <refsect1>
+    <title>Description</title>
+    <para>
+      The <command>VBoxManage usbfilter</command> command enables you to
+      manage USB filters for a specific virtual machine (VM), or global
+      USB filters that affect the entire &product-name; configuration.
+    </para>
+    <para>
+      Global filters are applied before VM-specific filters. This means
+      that you can use a global filter to prevent devices from being
+      captured by any VM.
+    </para>
+    <para>
+      Global filters are applied in a particular order. Only the first
+      filter that fits a device is applied. For example, the first
+      global filter makes a specific Kingston memory stick device
+      available while the second filter ignores all Kingston devices.
+      The result of applying these filters is that the specific Kingston
+      memory stick is made available to any machine that has the
+      appropriate filter, but no other Kingston devices are made
+      available.
+    </para>
+    <refsect2>
+      <title>Common Operand and Options</title>
+      <variablelist>
+        <varlistentry>
+          <term>index,0-<replaceable>N</replaceable></term>
+          <listitem><para>
+              Specifies a single integer that indicates the position of
+              the filter in the list. Zero (<literal>0</literal>)
+              represents the first position in the list. If a filter
+              already exists at the specified position, the existing
+              filter and any existing filters that follow are moved down
+              the list. Otherwise, the new filter is appended to the
+              list.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--action=ignore | hold</option></term>
+          <listitem><para>
+              Specifies whether to permit VMs access to devices that fit
+              the filter description (<literal>hold</literal>) or to
+              deny them access (<literal>ignore</literal>). This option
+              applies only to global filters.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--active=yes | no</option></term>
+          <listitem><para>
+              Specifies whether the USB filter is active or temporarily
+              disabled. Valid values are <literal>yes</literal>, which
+              activates the filter, and <literal>no</literal>, which
+              disables the filter. The default value is
+              <literal>yes</literal>.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--manufacturer=<replaceable>string</replaceable></option></term>
+          <listitem><para>
+              Specifies a manufacturer ID filter as a string. The
+              default value is null (<literal>&ldquo;&rdquo;</literal>).
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--maskedinterfaces=<replaceable>XXXXXXXX</replaceable></option></term>
+          <listitem><para>
+              Specifies a masked interface filter that is used to hide
+              one or more USB interfaces from the guest. The value is a
+              bit mask where the set bits correspond to the USB
+              interfaces to hide, or mask off. This feature is supported
+              on Linux host systems only.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--name=<replaceable>filter-name</replaceable></option></term>
+          <listitem><para>
+              Specifies the name of the filter.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--product=<replaceable>string</replaceable></option></term>
+          <listitem><para>
+              Specifies a product ID filter as a string. The default
+              value is null (<literal>&ldquo;&rdquo;</literal>).
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--productid=<replaceable>XXXX</replaceable></option></term>
+          <listitem><para>
+              Specifies a product ID filter. The string representation
+              for an exact match has the form
+              <replaceable>XXXX</replaceable>, where
+              <replaceable>X</replaceable> is a hexadecimal digit
+              including leading zeroes. The default value is null
+              (<literal>&ldquo;&rdquo;</literal>).
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--remote=yes | no</option></term>
+          <listitem><para>
+              Specifies a remote filter that indicates whether the
+              device is physically connected to a remote VRDE client or
+              to a local host system. This option applies to VM filters
+              only. The default value is null
+              (<literal>&ldquo;&rdquo;</literal>).
+            </para><remark>
+              Why is the default value null when valid values are
+              <literal>yes</literal> or <literal>no</literal>?
+            </remark></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--revision=<replaceable>IIFF</replaceable></option></term>
+          <listitem><para>
+              Specifies a revision ID filter. The string representation
+              for an exact match has the form
+              <replaceable>IIFF</replaceable>.
+              <replaceable>I</replaceable> is a decimal digit of the
+              integer part of the revision. <replaceable>F</replaceable>
+              is a decimal digit of its fractional part that includes
+              leading and trailing zeros. The default value is null
+              (<literal>&ldquo;&rdquo;</literal>).
+            </para><para>
+              To specify a range of revision IDs, ensure that you use
+              the hexadecimal form so that the revision is stored as a
+              16-bit packed BCD value. For example, the
+              <literal>int:0x0100-0x0199</literal> expression matches
+              any revision from 1.0 to 1.99, inclusive.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--serialnumber=<replaceable>string</replaceable></option></term>
+          <listitem><para>
+              Specifies a serial number filter as a string. The default
+              value is null (<literal>&ldquo;&rdquo;</literal>).
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--target=<replaceable>uuid</replaceable> | <replaceable>vmname</replaceable> | global</option></term>
+          <listitem><para>
+              Specifies the VM that the filter is attached to. You can
+              specify the Universally Unique Identifier (UUID) or the
+              name of the VM. To apply the filter description to all
+              VMs, specify <literal>global</literal>.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--vendorid=<replaceable>XXXX</replaceable></option></term>
+          <listitem><para>
+              Specifies a vendor ID filter, which is a string
+              representation of a four-digit hexadecimal number.
+              <replaceable>X</replaceable> is the hexadecimal digit
+              including leading zeroes. The default value is null
+              (<literal>&ldquo;&rdquo;</literal>).
+            </para></listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+    <refsect2 id="vboxmanage-usbfilter-add">
+      <title>Add a USB Filter or a Global Filter</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        Use the <command>VBoxManage usbfilter add</command> command to
+        create a new USB filter.
+      </para>
+      <para>
+        In addition, specify parameters by which to filter. You can use
+        the <command>VBoxManage list usbhost</command> command to view
+        the parameters for devices that are attached to your system.
+      </para>
+    </refsect2>
+    <refsect2 id="vboxmanage-usbfilter-modify">
+      <title>Modify a USB Filter or a Global Filter</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        Use the <command>VBoxManage usbfilter modify</command> command
+        to modify a USB filter. You can use the <command>VBoxManage list
+        usbfilters</command> command to list global filter indexes and
+        the <command>VBoxManage showvminfo</command> command to list
+        indexes for a specific machine.
+      </para>
+    </refsect2>
+    <refsect2 id="vboxmanage-usbfilter-remove">
+      <title>Remove a USB Filter or a Global Filter</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        Use the <command>VBoxManage usbfilter remove</command> command
+        to remove a USB filter entry.
+      </para>
+    </refsect2>
+  </refsect1>
+
+  <refsect1>
+    <title>Examples</title>
+    <remark role="help-scope" condition="GLOBAL" />
+    <para>
+      The following command lists the available USB devices on the host
+      system.
+    </para>
+<screen>$ VBoxManage list usbhost</screen>
+    <para>
+      The following command adds a USB filter called
+      <filename>filter01</filename> to the <filename>ol7</filename> VM.
+      The filter specifies a Kingston DataTraveler memory stick and is
+      placed first in the list of USB filters for the VM.
+    </para>
+<screen>$ VBoxManage usbfilter add 0 --target ol7 --name filter01 --vendorid 0x0930 --productid 0x6545</screen>
+    <para>
+      The following command removes the USB filter that is second in the
+      list for the <filename>ol7</filename> VM.
+    </para>
+<screen>$ VBoxManage usbfilter remove 1 --target ol7</screen>
+  </refsect1>
+</refentry>
Index: trunk/doc/manual/en_US/man_VBoxManage.xml
===================================================================
--- trunk/doc/manual/en_US/man_VBoxManage.xml	(revision 82044)
+++ trunk/doc/manual/en_US/man_VBoxManage.xml	(revision 82044)
@@ -0,0 +1,262 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+    manpage, user manual, usage: VBoxManage
+
+    Copyright (C) 2006-2019 Oracle Corporation
+
+    This file is part of VirtualBox Open Source Edition (OSE), as
+    available from http://www.virtualbox.org. This file is free software;
+    you can redistribute it and/or modify it under the terms of the GNU
+    General Public License (GPL) as published by the Free Software
+    Foundation, in version 2 as it comes in the "COPYING" file of the
+    VirtualBox OSE distribution. VirtualBox OSE is distributed in the
+    hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
+ -->
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+  "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"[
+<!ENTITY % all.entities SYSTEM "all-entities.ent">
+%all.entities;
+]>
+<refentry id="man_vboxmanage" lang="en">
+  <refentryinfo>
+    <pubdate>August 2019</pubdate>
+    <title>VBoxManage</title>
+  </refentryinfo>
+
+  <refmeta>
+    <refentrytitle>VBoxManage</refentrytitle>
+    <manvolnum>1</manvolnum>
+  </refmeta>
+
+  <refnamediv>
+    <refname>VBoxManage</refname>
+    <refpurpose>&product-name; command-line interface</refpurpose>
+    <refclass>Oracle VM VirtualBox</refclass>
+  </refnamediv>
+
+  <refsynopsisdiv>
+    <cmdsynopsis id="synopsis-vboxmanage">
+<!-- The 'id' is mandatory and must start with 'synopsis-'. -->
+      <command>VBoxManage</command> 
+      <arg>--nologo</arg>
+      <arg>--settingspw=[<replaceable>password</replaceable>]</arg>
+      <arg>--settingspwfile=<replaceable>pw-file</replaceable></arg>
+      <arg>--version</arg>
+      <arg>@<replaceable>response-file</replaceable></arg>
+      <arg><replaceable>subcommand</replaceable></arg>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+
+  <refsect1>
+    <title>Description</title>
+    <para>
+      The <command>VBoxManage</command> command is the command-line
+      interface (CLI) for the &product-name; software. The CLI supports
+      all the features that are available with the &product-name;
+      graphical user interface (GUI). In addition, you can use the
+      <command>VBoxManage</command> command to manage the features of
+      the virtualization engine that cannot be managed by the GUI.
+    </para>
+    <para>
+      Each time you invoke the <command>VBoxManage</command> command,
+      only one command is executed. Note that some
+      <command>VBoxManage</command> subcommands invoke several
+      subcommands.
+    </para>
+    <para>
+      Run the <command>VBoxManage</command> command from the command
+      line of the host operating system (OS) to control &product-name;
+      software.
+    </para>
+    <para>
+      The <command>VBoxManage</command> command is stored in the
+      following locations on the host system:
+    </para>
+    <itemizedlist>
+      <listitem><para>
+          <emphasis role="strong">Linux:</emphasis>
+          <filename>/usr/bin/VBoxManage</filename>
+        </para></listitem>
+      <listitem><para>
+          <emphasis role="strong">Mac OS X:</emphasis>
+          <filename>/Applications/VirtualBox.app/Contents/MacOS/VBoxManage</filename>
+        </para></listitem>
+      <listitem><para>
+          <emphasis role="strong">Oracle Solaris:</emphasis>
+          <filename>/opt/VirtualBox/bin/VBoxManage</filename>
+        </para></listitem>
+      <listitem><para>
+          <emphasis role="strong">Windows:</emphasis>
+          <filename>C:\Program
+          Files\Oracle\VirtualBox\VBoxManage.exe</filename>
+        </para></listitem>
+    </itemizedlist>
+    <para>
+      In addition to managing virtual machines (VMs) with this CLI or
+      the GUI, you can use the <command>VBoxHeadless</command> CLI to
+      manage VMs remotely.
+    </para>
+    <para>
+      The <command>VBoxManage</command> command performs particular
+      tasks by using subcommands, such as <command>list</command>,
+      <command>createvm</command>, and <command>startvm</command>. See
+      the associated information for each <command>VBoxManage</command>
+      subcommand.
+    </para>
+    <para>
+      If required, specify the VM by its name or by its Universally
+      Unique Identifier (UUID).
+    </para>
+    <para>
+      Use the <command>VBoxManage list vms</command> command to obtain
+      information about all currently registered VMs, including the VM
+      names and associated UUIDs.
+    </para>
+    <para>
+      Note that you must enclose the entire VM name in double quotes if
+      it contains spaces.
+    </para>
+    <refsect2 id="vboxmanage-common-options">
+      <title>General Options</title>
+      <variablelist>
+        <varlistentry>
+          <term><option>--nologo</option></term>
+          <listitem><para>
+              Suppresses the output of the logo information, which is
+              useful for scripts.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--settingspw=[<replaceable>password</replaceable>]</option></term>
+          <listitem><para>
+              Specifies the settings password. You can optionally
+              specify the password as an argument to this option. If you
+              do not specify the password in this way, the
+              <command>VBoxManage</command> command prompts you for the
+              password.
+            </para><para>
+              The settings password is a security feature that encrypts
+              stored settings, which are stored as plain text by
+              default.
+            </para><para>
+              You cannot unencrypt encrypted settings. So, if the
+              settings are encrypted, you must continue to specify the
+              <option>--settingspw</option> or
+              <option>--settingspwfile</option> option.
+            </para><para>
+              Only the iSCSI secret is encrypted at this time.
+            </para><remark>
+              This design does not conform to Oracle's security
+              guidelines. You should not be able to specify a password
+              on the command line because the password can be seen in a
+              process listing.
+            </remark></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--settingspwfile=<replaceable>pw-filename</replaceable></option></term>
+          <listitem><para>
+              Specifies the file that contains the settings password.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--version</option></term>
+          <listitem><para>
+              Shows version information about the
+              <command>VBoxManage</command> command.
+            </para><para>
+              The short version of this option is <option>-v</option>.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>@<replaceable>response-file</replaceable></term>
+          <listitem><para>
+              Loads arguments from the specified Bourne shell response
+              file.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><replaceable>subcommand</replaceable></term>
+          <listitem><para>
+              Specifies one of the <command>VBoxManage</command>
+              subcommands, such as <command>controlvm</command>,
+              <command>createvm</command>, <command>list</command>,
+              <command>modifyvm</command>,
+              <command>showvminfo</command>, <command>startvm</command>,
+              <command>storageattach</command>, and
+              <command>storagectl</command>.
+            </para><para>
+              Each subcommand is described in its own command topic,
+              some of which are shown in See Also sections.
+            </para></listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+  </refsect1>
+
+  <refsect1>
+    <title>Examples</title>
+    <remark role="help-scope" condition="GLOBAL"/>
+    <para>
+      The following command creates a virtual machine called
+      <literal>Win8</literal> and registers it with &product-name; by
+      using the <option>--register</option> option.
+    </para>
+<screen>$ VBoxManage createvm --name "Win8" --register
+Virtual machine 'Win8' is created.
+UUID: <replaceable>UUID-string</replaceable>
+Settings file: '/home/<replaceable>username</replaceable>/VirtualBox VMs/Win8/Win8.vbox'</screen>
+    <para>
+      The command output shows that the <literal>Win8</literal> VM is
+      assigned a UUID and an XML machine settings file.
+    </para>
+    <para>
+      You can use the <command>VBoxManage showvminfo</command> command
+      to view the configuration information of a VM.
+    </para>
+    <para>
+      The following example uses the <command>VBoxManage
+      modifyvm</command> command to change the amount of memory for the
+      <literal>Windows XP</literal> VM to be 1024 megabytes:
+    </para>
+<screen>$ VBoxManage modifyvm "Windows XP" --memory 1024</screen>
+    <para>
+      Note that you can use the <command>VBoxManage modifyvm</command>
+      command even when the VM is powered off.
+    </para>
+    <para>
+      You can use the <command>VBoxManage storagectl</command> command
+      or the <command>VBoxManage storageattach</command> command to
+      modify the storage configuration for a VM. For example, to create
+      a SATA storage controller called <literal>sata01</literal> and add
+      it to the <literal>ol7</literal> VM:
+    </para>
+<screen>$ VBoxManage storagectl ol7 --name "sata01" --add sata</screen>
+    <para>
+      Use the <command>VBoxManage startvm</command> command to start a
+      VM that is currently powered off. For example, to start the
+      <literal>win7</literal> VM:
+    </para>
+<screen>$ VBoxManage startvm win7</screen>
+    <para>
+      Use the <command>VBoxManage controlvm</command> command to pause
+      or save a VM that is currently running. You can also use this
+      command to modify settings for the VM. For example, to enable
+      audio input for the <literal>ol6u9</literal> VM.
+    </para>
+<screen>$ VBoxManage controlvm ol6u9 audioin on</screen>
+  </refsect1>
+
+  <refsect1>
+    <title>See Also</title>
+    <para>
+      <xref linkend="vboxmanage-controlvm" />,
+      <xref linkend="vboxmanage-createvm" />,
+      <xref linkend="vboxmanage-list" />,
+      <xref linkend="vboxmanage-modifyvm" />,
+      <xref linkend="vboxmanage-showvminfo" />,
+      <xref linkend="vboxmanage-startvm" />,
+      <xref linkend="vboxmanage-storageattach" />,
+      <xref linkend="vboxmanage-storagectl" />
+    </para>
+  </refsect1>
+</refentry>
Index: trunk/doc/manual/en_US/man_vboximg-mount.xml
===================================================================
--- trunk/doc/manual/en_US/man_vboximg-mount.xml	(revision 82044)
+++ trunk/doc/manual/en_US/man_vboximg-mount.xml	(revision 82044)
@@ -0,0 +1,398 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+    manpage, user manual, usage: vboximg-mount
+
+    Copyright (C) 2006-2019 Oracle Corporation
+
+    This file is part of VirtualBox Open Source Edition (OSE), as
+    available from http://www.virtualbox.org. This file is free software;
+    you can redistribute it and/or modify it under the terms of the GNU
+    General Public License (GPL) as published by the Free Software
+    Foundation, in version 2 as it comes in the "COPYING" file of the
+    VirtualBox OSE distribution. VirtualBox OSE is distributed in the
+    hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
+ -->
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+  "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"[
+<!ENTITY % all.entities SYSTEM "all-entities.ent">
+%all.entities;
+]>
+<refentry id="man_vboximg-mount" lang="en">
+  <refentryinfo>
+    <pubdate>November 2019</pubdate>
+    <title>vboximg-mount</title>
+  </refentryinfo>
+
+  <refmeta>
+    <refentrytitle>vboximg-mount</refentrytitle>
+    <manvolnum>1</manvolnum>
+  </refmeta>
+
+  <refnamediv>
+    <refname>vboximg-mount</refname>
+    <refpurpose>FUSE mount a virtual disk image for Mac OS and Linux hosts</refpurpose>
+    <refclass>Oracle VM VirtualBox</refclass>
+  </refnamediv>
+
+  <refsynopsisdiv>
+    <cmdsynopsis id="synopsis-vboximg-mount-help">
+<!-- The 'id' is mandatory and must start with 'synopsis-'. -->
+      <command>vboximg-mount</command>
+      <group choice="req">
+        <arg choice="plain">-?</arg>
+        <arg choice="plain">-h</arg>
+        <arg choice="plain">--help</arg>
+      </group>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboximg-mount-mount">
+      <command>vboximg-mount</command> 
+      <arg choice="req">--image=<replaceable>image-UUID</replaceable></arg>      
+      <arg>--guest-filesystem</arg>      
+      <arg>-o=<replaceable>FUSE-option</replaceable>[,<replaceable>FUSE-option</replaceable>]</arg>      
+      <arg>--root</arg>      
+      <arg>--rw</arg>      
+      <arg choice="req"><replaceable>mountpoint</replaceable></arg>
+    </cmdsynopsis>
+     
+    <cmdsynopsis id="synopsis-vboximg-mount-list">
+      <command>vboximg-mount</command> 
+      <arg choice="req">--list</arg>      
+      <arg>--image=<replaceable>image-UUID</replaceable></arg>     
+      <arg>--guest-filesystem</arg>    
+      <arg>--verbose</arg>    
+      <arg>--vm=<replaceable>vm-UUID</replaceable></arg>   
+      <arg>--wide</arg>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+
+  <refsect1 id="vboximg-mount-intro">
+    <title>Description</title>
+    <para>
+      The <command>vboximg-mount</command> command enables you to make
+      &product-name; disk images available to a Mac OS or Linux host
+      operating system (OS) for privileged or non-priviliged access. You
+      can mount any version of the disk from its available history of
+      snapshots. Use this command to mount, view, and optionally modify
+      the contents of an &product-name; virtual disk image, and you can
+      also use this command to view information about registered virtual
+      machines (VMs).
+    </para>
+    <para>
+      This command uses the Filesystem in Userspace (FUSE) technology to
+      provide raw access to an &product-name; virtual disk image.
+    </para>
+    <para>
+      When you use the <option>--image</option> option to specify a base
+      image identifier, only the base image is mounted. Any related
+      snapshots are disregarded. Alternatively, if you use the
+      <option>--image</option> option to specify a snapshot, the state
+      of the FUSE-mounted virtual disk is synthesized from the implied
+      chain of snapshots, including the base image.
+    </para>
+    <para>
+      The <command>vboximg-mount</command> command includes experimental
+      read-only access to file systems inside a VM disk image. This
+      feature enables you to extract some files from the VM disk image
+      without starting the VM and without requiring third-party file
+      system drivers on the host system. &product-name; supports the
+      FAT, NTFS, <filename>ext2</filename>, <filename>ext3</filename>,
+      and <filename>ext4</filename> file systems.
+    </para>
+    <para>
+      The virtual disk is exposed as a device node within a FUSE-based
+      file system that overlays the specified mount point.
+    </para>
+    <para>
+      The FUSE file system includes a directory that contains a number
+      of files. The file system can also contain a directory that
+      includes a symbolic link that has the same base name (see the
+      <command>basename</command>(1) man page) as the virtual disk base
+      image and points to the location of the virtual disk base image.
+      The directory can be of the following types:
+    </para>
+    <itemizedlist>
+      <listitem><para>
+          <filename>vhdd</filename> provides access to the raw disk
+          image data as a flat image
+        </para></listitem>
+      <listitem><para>
+          <literal>vol<replaceable>ID</replaceable></literal> provides
+          access to an individual volume on the specified disk image
+        </para></listitem>
+      <listitem><para>
+          <literal>fs<replaceable>ID</replaceable></literal> provides
+          access to a supported file system without requiring a host
+          file system driver
+        </para></listitem>
+    </itemizedlist>
+    <refsect2 id="vboximg-mount-help">
+      <title>General Command Options</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        Use the following options to obtain information about the
+        <command>vboximg-mount</command> command and its options.
+      </para>
+      <variablelist>
+        <varlistentry>
+          <term><option>--help</option>, <option>--h</option>, or<option>--?</option></term>
+          <listitem><para>
+              Shows usage information.
+            </para></listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+    <refsect2 id="vboximg-mount-mount">
+      <title>Mounting an &product-name; Disk Image</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        Use the <command>vboximg-mount</command> command to mount an
+        &product-name; virtual disk image on a Mac OS or Linux host
+        system. When mounted, you can view the contents of the disk
+        image or modify the contents of the disk image.
+      </para>
+      <para>
+        You can use the <command>vboximg-mount</command> command to
+        restrict FUSE-based access to a subsection of the virtual disk.
+      </para>
+      <variablelist>
+        <varlistentry>
+          <term><option>--image=<replaceable>disk-image</replaceable></option></term>
+          <listitem><para>
+              Specifies the Universally Unique Identifier (UUID), name,
+              or path of the &product-name; disk image.
+            </para><para>
+              The short form of the <option>--image</option> option is
+              <option>-i</option>.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--guest-filesystem</option></term>
+          <listitem><para>
+              Enables experimental read-only support for guest file
+              systems. When you specify this option, all known file
+              systems are made available to access.
+            </para><para>
+              The short form of the <option>--guest-filesystem</option>
+              option is <option>-g</option>.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>-o=<replaceable>FUSE-option</replaceable>[,<replaceable>FUSE-option</replaceable>...]</option></term>
+          <listitem><para>
+              Specifies FUSE mount options.
+            </para><para>
+              The <command>vboximg-mount</command> command enables you
+              to use the FUSE mount options that are described in the
+              <command>mount.fuse</command>(8) man page.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--root</option></term>
+          <listitem><para>
+              Overrides the security measure that restricts file access
+              to the file system owner by also granting file access to
+              the <literal>root</literal> user.
+            </para><para>
+              Same as the <option>-o allow_root</option> option. See the
+              <option>-o</option> option description.
+            </para><para>
+              This option is incompatible with the <option>-o
+              allow_other</option> option.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--rw</option></term>
+          <listitem><para>
+              Mounts the specified image as read-write, which is
+              required if you want to modify its contents. By default,
+              images are mounted as read-only.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><replaceable>mount-point</replaceable></term>
+          <listitem><para>
+              Specifies the path name of a directory on which to mount
+              the &product-name; disk image.
+            </para></listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+    <refsect2 id="vboximg-mount-list">
+      <title>Viewing &product-name; Disk Image Information</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        Use the <command>vboximg-mount</command> command to view
+        information about registered VMs or an &product-name; virtual
+        disk image.
+      </para>
+      <variablelist>
+        <varlistentry>
+          <term><option>--image=<replaceable>disk-image</replaceable></option></term>
+          <listitem><para>
+              Specifies the UUID, name, or path of the &product-name;
+              disk image.
+            </para><para>
+              The short form of the <option>--image</option> option is
+              <option>-i</option>.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--guest-filesystem</option></term>
+          <listitem><para>
+              Enables experimental read-only support for guest file
+              systems. When you specify this option, all known file
+              systems are made available to access.
+            </para><para>
+              The short form of the <option>--guest-filesystem</option>
+              option is <option>-g</option>.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--list</option></term>
+          <listitem><para>
+              Shows information about the disks that are associated with
+              the registered VMs. If you specify a disk image, this
+              option shows information about the partitions of the
+              specified image.
+            </para><para>
+              When you specify the <option>--verbose</option> option,
+              the output includes detailed information about the VMs and
+              media, including snapshot images and file paths.
+            </para><para>
+              The short form of the <option>--list</option> option is
+              <option>-l</option>.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--verbose</option></term>
+          <listitem><para>
+              Shows or logs detailed information.
+            </para><para>
+              The short form of the <option>--verbose</option> option is
+              <option>-v</option>.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--vm=<replaceable>vm-UUID</replaceable></option></term>
+          <listitem><para>
+              Outputs information about the VM that is associated with
+              the specified UUID.
+            </para></listitem>
+        </varlistentry>
+        <varlistentry>
+          <term><option>--wide</option></term>
+          <listitem><para>
+              Outputs information in a wide format. This output includes
+              the lock state information of running VMs. For VMs that
+              are not running, the state is <literal>created</literal>.
+            </para><para>
+              The wide output uses a tree-like structure in the VM
+              column to show the relationship between a VM base image
+              and its snapshots.
+            </para></listitem>
+        </varlistentry>
+      </variablelist>
+    </refsect2>
+  </refsect1>
+
+  <refsect1>
+    <title>Examples</title>
+    <remark role="help-scope" condition="MOUNT-MOUNT,MOUNT-LIST"/>
+    <para>
+      The following example shows how to mount a virtual disk image on
+      the host operating system (OS).
+    </para>
+<screen>$ mkdir fuse_mount_point
+$ vboximg-mount --image=b490e578-08be-4f7d-98e9-4c0ef0952377 fuse_mount_point
+$ ls fuse_mount_point
+ubu.vdi[32256:2053029880]   vhdd 
+$ sudo mount fuse_mount_point/vhdd /mnt</screen>
+    <para>
+      The <command>mkdir</command> command creates a mount point called
+      <filename>fuse_mount_point</filename> on the host OS. The
+      <command>vboximg-mount</command> command is then used to mount the
+      specified disk image on the <filename>fuse_mount_point</filename>
+      mount point. The mount includes all snapshots for the disk image.
+    </para>
+    <para>
+      The <command>ls</command> command shows the contents of
+      <filename>fuse_mount_point</filename>. The
+      <command>mount</command> command is then used to mount the
+      FUSE-mounted device node, <command>vhdd</command>, on the
+      <filename>/mnt</filename> mount point. The <command>vhdd</command>
+      device node represents the virtual disk image.
+    </para>
+    <para>
+      The following example shows how to make the known file systems of
+      the <literal>b490e578-08be-4f7d-98e9-4c0ef0952377</literal> disk
+      image accessible when the image is mounted on the
+      <filename>fuse_mount_point</filename> mount point:
+    </para>
+<screen>$ vboximg-mount --image=b490e578-08be-4f7d-98e9-4c0ef0952377 \
+--guest-filesystem fuse_mount_point
+</screen>
+    <para>
+      The following command outputs detailed information about all
+      registered VMs and their snapshots:
+    </para>
+<screen>$ vboximg-mount --list --verbose</screen>
+    <para>
+      The following command shows an excerpt of the list output in wide
+      format.
+    </para>
+<screen>$ vboximg-mount --list --wide
+
+VM  Image                 Size Type State   UUID (hierarchy)
+------------------------------------------  ------------------------------------
+Proxy                                       0833f5bc-6304-42e1-b799-cdc81c576c60
+ |
+ +- Proxy.vdi             4.8G VDI  rlock   d5f84afb-0794-4952-ab71-6bbcbee07737
+ |  +- &lt;snapshot>        12.3G VDI  rlock     dffc67aa-3023-477f-8033-b27e3daf4f54
+ |  +- &lt;snapshot>         8.8G VDI  rlock       3b2755bd-5f2a-4171-98fe-647d510b6274
+ |  +- &lt;snapshot>        14.6G VDI  rlock         e2ccdb5f-49e8-4123-8623-c61f363cc5cf
+ |  +- &lt;snapshot>         7.4G VDI  wlock           3c1e6794-9091-4be3-9e80-11aba40c2649
+
+------------------------------------------  ------------------------------------
+Oracle Linux 7                              5365ab5f-470d-44c0-9863-dad532ee5905
+ |
+ +- Oracle Linux 7.vdi     7.0G VDI created 96d2e92e-0d4e-46ab-a0f1-008fdbf997e7
+ | +- &lt;snapshot>          15.9G VDI created   f9cc866a-9166-42e9-a503-bbfe9b7312e8
+ |
+ +- kernel.vdi            11.1G VDI created 79a370bd-0c4f-480a-30bb-10cdea68423f
+</screen>
+    <para>
+      The output shows that the Proxy VM is running the fourth snapshot
+      of the <command>Proxy.vdi</command> virtual disk image. The
+      running state is indicated by the <command>wlock</command> value
+      in the State column.
+    </para>
+    <para>
+      The Oracle Linux 7 VM is not running. It has two images:
+      <command>Oracle Linux 7.vdi</command> and
+      <command>kernel.vdi</command>. The <command>Oracle Linux
+      7.vdi</command> image has a snapshot.
+    </para>
+    <para>
+      The following command shows information about the VM with the
+      specified UUID:
+    </para>
+<screen>
+$ vboximg-mount --list --vm=b1d5563b-2a5b-4013-89f1-26c81d6bbfa0
+-----------------------------------------------------------------
+VM:   ubu
+UUID: b1d5563b-2a5b-4013-89f1-26c81d6bbfa0
+
+  Image:   ubu.vdi
+  UUID:    b490e578-08be-4f7d-98e9-4c0ef0952377
+
+       Snapshot: 35afe1e0-0a51-44f3-a228-caf172f3306f
+       Size:     12.1G
+
+       Snapshot: 874279c1-4425-4282-ada8-a9c07c00bbf9
+       Size:     13.6G
+
+  Image:   kernel.vdi
+  UUID:    79a370bd-6eb7-4dbf-8bc6-d29118f127e0</screen>
+  </refsect1>
+</refentry>
Index: trunk/doc/manual/en_US/user_Frontends.xml
===================================================================
--- trunk/doc/manual/en_US/user_Frontends.xml	(revision 81972)
+++ trunk/doc/manual/en_US/user_Frontends.xml	(revision 82044)
@@ -255,6 +255,6 @@
         &product-name; therefore comes with a front-end called
         <computeroutput>VBoxHeadless</computeroutput>, which produces no
-        visible output on the host at all, but still can deliver VRDP
-        data. This front-end has no dependencies on the X Window system
+        visible output on the host at all, but still can optionally deliver
+        VRDP data. This front-end has no dependencies on the X Window system
         on Linux and Oracle Solaris hosts.
       </para>
@@ -309,5 +309,7 @@
             directly as a background process which has to be done
             explicitly when directly starting with
-            <computeroutput>VBoxHeadless</computeroutput>.
+            <computeroutput>VBoxHeadless</computeroutput>. The full
+            documentation of the command is in
+            <xref linkend="vboxmanage-vboxheadless"/>.
           </para>
         </listitem>
@@ -1240,3 +1242,6 @@
   </sect1>
 
+  <xi:include href="user_man_VBoxHeadless.xml" xpointer="element(/1)" xmlns:xi="http://www.w3.org/2001/XInclude" />
+
+
 </chapter>
Index: trunk/doc/manual/en_US/user_Storage.xml
===================================================================
--- trunk/doc/manual/en_US/user_Storage.xml	(revision 81972)
+++ trunk/doc/manual/en_US/user_Storage.xml	(revision 82044)
@@ -1561,5 +1561,6 @@
     <para>
       Use the <option>--help</option> option to view information about
-      the <command>vboximg-mount</command> command usage.
+      the <command>vboximg-mount</command> command usage. The complete
+      command reference is described in <xref linkend="man_vboximg-mount" />.
     </para>
 
Index: trunk/doc/manual/en_US/user_VBoxManage.xml
===================================================================
--- trunk/doc/manual/en_US/user_VBoxManage.xml	(revision 81972)
+++ trunk/doc/manual/en_US/user_VBoxManage.xml	(revision 82044)
@@ -9032,3 +9032,7 @@
   <xi:include href="user_man_VBoxManage-cloudinstance.xml" xpointer="element(/1)" xmlns:xi="http://www.w3.org/2001/XInclude" />
   <xi:include href="user_man_VBoxManage-cloudimage.xml" xpointer="element(/1)" xmlns:xi="http://www.w3.org/2001/XInclude" />
+
+  <!-- TODO: Figure out how we can handle other manpages. The xml is bolted to
+             sect1, so it's not possible to have them "in place" -->
+  <xi:include href="user_man_vboximg-mount.xml" xpointer="element(/1)" xmlns:xi="http://www.w3.org/2001/XInclude" />
 </chapter>
