VirtualBox

Changeset 68977 in vbox


Ignore:
Timestamp:
Oct 4, 2017 12:11:16 PM (7 years ago)
Author:
vboxsync
Message:

Manual: Trimmed whitespaces.

Location:
trunk/doc/manual/en_US
Files:
9 edited

Legend:

Unmodified
Added
Removed
  • trunk/doc/manual/en_US/user_AdvancedTopics.xml

    r68860 r68977  
    43174317      <computeroutput>usbip-host.ko</computeroutput> kernel drivers
    43184318      are available, and that the USB/IP tools package is installed.
    4319       The particular installation method for the necessary tools depends on which 
     4319      The particular installation method for the necessary tools depends on which
    43204320      distribution is used.
    4321       For example, for Debian based systems - the following command should be used to 
     4321      For example, for Debian based systems - the following command should be used to
    43224322      install the required tools:
    43234323      <screen>apt-get install usbip-utils</screen></para>
     
    43444344
    43454345      <para>By default, no device on the server is exported - and this must be done manually
    4346       for each device. To export a device use: 
     4346      for each device. To export a device use:
    43474347      <screen>usbip bind -b "bus identifier"</screen>
    43484348      To export the multicard reader from above, for example  - use:
  • trunk/doc/manual/en_US/user_BasicConcepts.xml

    r68280 r68977  
    10181018    distributions, the PulseAudio subsystem should be preferred.</para>
    10191019
    1020     <para>Since VirtualBox 5.0 only OSS is supported on Solaris hosts - the "Solaris Audio" 
     1020    <para>Since VirtualBox 5.0 only OSS is supported on Solaris hosts - the "Solaris Audio"
    10211021    audio backend is no longer supported on Solaris hosts.</para>
    10221022  </sect1>
     
    14001400    <para>The "User Interface" section allows you to change certain aspects of
    14011401      the user interface of this VM.</para>
    1402      
     1402
    14031403    <para><glosslist>
    14041404      <glossentry>
  • trunk/doc/manual/en_US/user_Introduction.xml

    r66642 r68977  
    402402          1.5. Support for Windows XP was removed with VirtualBox 5.0.</para>
    403403          </footnote>
    404          
     404
    405405          <itemizedlist>
    406406            <listitem>
  • trunk/doc/manual/en_US/user_Networking.xml

    r68122 r68977  
    712712    <para>As a security measure, by default, the Linux implementation of internal
    713713    networking only allows VMs running under the same user ID to establish an
    714     internal network. However, it is possible to create a shared 
     714    internal network. However, it is possible to create a shared
    715715    internal networking interface, accessible by users with different UUIds.</para>
    716716  </sect1>
     
    10101010        </listitem>
    10111011        <listitem>
    1012           <para>Perform a full, detailed analysis of network traffic on 
    1013             the VM's network adaptor using a 3rd party tool such as Wireshark. 
    1014             To do this, a promiscuous mode policy needs to be used on the 
    1015             VM's network adaptor. Use of this mode is only possible on 
     1012          <para>Perform a full, detailed analysis of network traffic on
     1013            the VM's network adaptor using a 3rd party tool such as Wireshark.
     1014            To do this, a promiscuous mode policy needs to be used on the
     1015            VM's network adaptor. Use of this mode is only possible on
    10161016            networks: NAT Network, Bridged Adapter, Internal Network and Host-only Adapter.</para>
    1017           <para>To setup a promiscuous mode policy, either select from the drop down list 
     1017          <para>To setup a promiscuous mode policy, either select from the drop down list
    10181018            located in the Network Settings dialog for the network adaptor
    10191019            or use the command line tool <computeroutput>VBoxManage</computeroutput>;
  • trunk/doc/manual/en_US/user_Storage.xml

    r64233 r68977  
    418418
    419419     <listitem>
    420         <para><emphasis role="bold">copy</emphasis> a virtual hard disk, to 
     420        <para><emphasis role="bold">copy</emphasis> a virtual hard disk, to
    421421        another one - target type can be different, options are - VDI, VHD or VMDK.</para>
    422422     </listitem>
    423423
    424424     <listitem>
    425         <para><emphasis role="bold">modify</emphasis> the attributes of the 
     425        <para><emphasis role="bold">modify</emphasis> the attributes of the
    426426        disk image file - available options are : Normal, Immutable,
    427427        Writethrough, Shareable, Multi-attach.</para>
     
    429429
    430430     <listitem>
    431         <para><emphasis role="bold">refresh</emphasis> the values for the displayed     
     431        <para><emphasis role="bold">refresh</emphasis> the values for the displayed
    432432        attributes of the disk image currently selected in the window.</para>
    433433     </listitem>
    434    
     434
    435435    </itemizedlist>
    436436
    437     <para>These commands are accessible once a medium has been selected either by selecting 
     437    <para>These commands are accessible once a medium has been selected either by selecting
    438438    from the options shown at the top of the window, or by right-clicking the medium
    439439    and selecting from the options shown on the drop-down menu.</para>
  • trunk/doc/manual/en_US/user_Technical.xml

    r64726 r68977  
    4040          on very old Windows versions which don't have this function
    4141          or where it unexpectedly returns an error, there is a fallback based
    42           on environment variables: first 
     42          on environment variables: first
    4343          <computeroutput>%USERPROFILE%</computeroutput> is checked, if it
    4444          doesn't exist then an attempt with
     
    5757          <computeroutput>sudo</computeroutput> which by default doesn't reset
    5858          the environment variable <computeroutput>$HOME</computeroutput>).
    59           Typical value on Linux and Solaris is 
     59          Typical value on Linux and Solaris is
    6060          <computeroutput>/home/username</computeroutput> and on Mac OS X
    6161          <computeroutput>/Users/username</computeroutput>.</para>
     
    611611    the benefits of communicating with the VirtualBox hypervisor.</para>
    612612
    613     <para>Most modern mainstream guest operating systems, including 
    614     Windows and Linux, ship with support for one or more paravirtualization 
    615     interfaces. Hence, there is typically no need to install additional software 
     613    <para>Most modern mainstream guest operating systems, including
     614    Windows and Linux, ship with support for one or more paravirtualization
     615    interfaces. Hence, there is typically no need to install additional software
    616616    in the guest to take advantage of this feature.
    617617    </para>
  • trunk/doc/manual/en_US/user_ThirdParty.xml

    r68716 r68977  
    268268        </para>
    269269      </listitem>
    270      
     270
    271271      <listitem>
    272272        <para>VirtualBox contains portions of liblightdm-gobject which is governed by the
  • trunk/doc/manual/en_US/user_Troubleshooting.xml

    r62560 r68977  
    793793
    794794      <para>Certain editions of Windows 2000 and 2003 servers support more
    795       than 4 GB RAM on 32-bit systems. The AMD PCnet network driver shipped with 
     795      than 4 GB RAM on 32-bit systems. The AMD PCnet network driver shipped with
    796796      Windows Server 2003 fails to load if the 32-bit guest OS uses paging
    797797      extensions (which will occur with more than approximately 3.5 GB RAM
     
    11211121      <title>Certain Solaris 10 releases may take long to boot with SMP</title>
    11221122
    1123       <para>When using more than one CPU, Solaris 10 releases 5/08 ("S10U5"), 
    1124           10/08 ("S10U6"), and 5/09 ("S10U7") may take a long time to boot and 
    1125           may print warnings on the system console regarding failures to read 
    1126           from disk. This is a bug in Solaris 10 which affects specific physical 
    1127           and virtual configurations. It is caused by trying to read microcode 
    1128           updates from the boot disk when the disk interrupt is reassigned to a 
    1129           not yet fully initialized secondary CPU. Disk reads will time out and 
     1123      <para>When using more than one CPU, Solaris 10 releases 5/08 ("S10U5"),
     1124          10/08 ("S10U6"), and 5/09 ("S10U7") may take a long time to boot and
     1125          may print warnings on the system console regarding failures to read
     1126          from disk. This is a bug in Solaris 10 which affects specific physical
     1127          and virtual configurations. It is caused by trying to read microcode
     1128          updates from the boot disk when the disk interrupt is reassigned to a
     1129          not yet fully initialized secondary CPU. Disk reads will time out and
    11301130          fail, triggering delays (approx. 45 seconds) and warnings.
    11311131      </para>
    11321132      <para>
    1133           The recommended solution is upgrading to at least Solaris 10 10/09 
    1134           ("S10U8") which includes a fix for this problem. Alternative solutions 
    1135           include restricting the number of virtual CPUs to one or possibly 
     1133          The recommended solution is upgrading to at least Solaris 10 10/09
     1134          ("S10U8") which includes a fix for this problem. Alternative solutions
     1135          include restricting the number of virtual CPUs to one or possibly
    11361136          using a different storage controller.
    11371137      </para>
     
    14801480      <computeroutput>vboxusers</computeroutput> group.
    14811481      Please keep in mind that group membership does not take effect immediately
    1482       but rather at the next login. If available, the 
    1483       <computeroutput>newgrp</computeroutput> command may avoid the need for 
     1482      but rather at the next login. If available, the
     1483      <computeroutput>newgrp</computeroutput> command may avoid the need for
    14841484      logout/login.</para>
    14851485    </sect2>
  • trunk/doc/manual/en_US/user_VBoxManage.xml

    r68515 r68977  
    251251          <computeroutput>natnets</computeroutput> and
    252252          <computeroutput>dhcpservers</computeroutput>, respectively, list
    253           bridged network interfaces, host-only network interfaces, 
    254           NAT network interfaces and DHCP servers currently available on the 
     253          bridged network interfaces, host-only network interfaces,
     254          NAT network interfaces and DHCP servers currently available on the
    255255          host. Please see <xref
    256256          linkend="networkingdetails" /> for details on these.</para>
     
    317317        <listitem>
    318318          <para><computeroutput>groups</computeroutput> displays
    319           details of the VM Groups; see <xref linkend="gui-vmgroups" /> 
     319          details of the VM Groups; see <xref linkend="gui-vmgroups" />
    320320          for more information.</para>
    321321        </listitem>
    322322
    323323        <listitem>
    324           <para><computeroutput>webcams</computeroutput> displays a list of 
    325           webcams attached to the running VM. The output format is a list of 
    326           absolute paths or aliases that were used for attaching the webcams 
     324          <para><computeroutput>webcams</computeroutput> displays a list of
     325          webcams attached to the running VM. The output format is a list of
     326          absolute paths or aliases that were used for attaching the webcams
    327327          to the VM using the 'webcam attach' command.</para>
    328328        </listitem>
    329329
    330330        <listitem>
    331           <para><computeroutput>screenshotformats</computeroutput> displays a 
     331          <para><computeroutput>screenshotformats</computeroutput> displays a
    332332          list of available screenshot formats.</para>
    333333        </listitem>
     
    367367...
    368368    </screen></para>
    369     <para>Use the <computeroutput>--machinereadable</computeroutput> option 
    370       to produce the same output, but in machine readable format: property="value" on a 
     369    <para>Use the <computeroutput>--machinereadable</computeroutput> option
     370      to produce the same output, but in machine readable format: property="value" on a
    371371      line by line basis, e.g.:</para>
    372372    <para><screen>
     
    435435    <computeroutput>.xml</computeroutput>) and the machine folder (a subfolder
    436436    of the <computeroutput>.config/VirtualBox/Machines</computeroutput> folder
    437     - this folder name may vary depending on the operating system and the 
    438     version of VirtualBox which you are using), it must conform to your host 
    439     operating system's requirements for file name specifications. If the VM 
     437    - this folder name may vary depending on the operating system and the
     438    version of VirtualBox which you are using), it must conform to your host
     439    operating system's requirements for file name specifications. If the VM
    440440    is later renamed, the file and folder names will change automatically.</para>
    441441
     
    446446    renamed.</para>
    447447
    448     <para>If the <computeroutput>--group &lt;group&gt;, ...</computeroutput>   
    449     option is used, the machine will be assigned membership of the specified 
    450     VM groups in the list. Note that group ids always start with a 
     448    <para>If the <computeroutput>--group &lt;group&gt;, ...</computeroutput>
     449    option is used, the machine will be assigned membership of the specified
     450    VM groups in the list. Note that group ids always start with a
    451451    <computeroutput>/</computeroutput> and can be nested. By default,
    452     VMs are always assigned membership of the group 
     452    VMs are always assigned membership of the group
    453453    <computeroutput>/</computeroutput>.</para>
    454454
    455455    <para>If the <computeroutput>--ostype &lt;ostype&gt;</computeroutput>:
    456     option is used, &lt;ostype&gt; specifies the guest operating system 
     456    option is used, &lt;ostype&gt; specifies the guest operating system
    457457    to run in the VM. To learn about the available OS options,
    458458    run <computeroutput>VBoxManage list ostypes</computeroutput> .</para>
    459459
    460460    <para>If the <computeroutput>--uuid &lt;uuid&gt;</computeroutput>:
    461     option is used, &lt;uuid&gt; specifies the VM uuid. This must be 
    462     unique within the namespace of the host, or that of the VM Group if 
    463     it is assigned to a VM group membership. By default, a unique uuid 
     461    option is used, &lt;uuid&gt; specifies the VM uuid. This must be
     462    unique within the namespace of the host, or that of the VM Group if
     463    it is assigned to a VM group membership. By default, a unique uuid
    464464    within the appropriate namespace is automatically generated.
    465465    </para>
     
    528528          <listitem>
    529529            <para><computeroutput>--iconfile &lt;filename&gt;</computeroutput>:
    530             This specifies the absolute path on the host file system for the VirtualBox 
     530            This specifies the absolute path on the host file system for the VirtualBox
    531531            icon to be displayed in the VM.</para>
    532532          </listitem>
     
    541541          <listitem>
    542542            <para><computeroutput>--pagefusion on|off</computeroutput>:
    543             Enables/disables (default) the Page Fusion feature. 
    544             The Page Fusion feature minimises memory duplication between VMs with similar 
     543            Enables/disables (default) the Page Fusion feature.
     544            The Page Fusion feature minimises memory duplication between VMs with similar
    545545            configurations running on the same host.
    546546            See <xref linkend="guestadd-pagefusion" /> for details.</para>
     
    667667            <para><computeroutput>--x2apic on|off</computeroutput>:
    668668            This setting enables(default)/disables CPU x2APIC support.
    669             CPU x2APIC support helps operating systems run more efficiently on high 
     669            CPU x2APIC support helps operating systems run more efficiently on high
    670670            core count configurations, and optimizes interrupt
    671671            distribution in virtualized environments. Disable when using host/guest
     
    736736
    737737          <listitem>
    738             <para><computeroutput>--accelerate3d on|off</computeroutput>: 
    739             If the Guest Additions are installed, this setting enables or 
     738            <para><computeroutput>--accelerate3d on|off</computeroutput>:
     739            If the Guest Additions are installed, this setting enables or
    740740            disables hardware 3D acceleration; see <xref
    741741            linkend="guestadd-3d" />.</para>
     
    744744          <listitem>
    745745            <para><computeroutput>--accelerate2dvideo on|off</computeroutput>:
    746             If the Guest Additions are installed, this setting enables or 
     746            If the Guest Additions are installed, this setting enables or
    747747            disables 2D video acceleration; see <xref
    748748            linkend="guestadd-2d" />.</para>
     
    794794            disabled (no apic or x2apic) respectively.</para>
    795795
    796             <para>Note that if x2apic is specified and x2apic is unsupported by the 
    797             VCPU, biosapic downgrades to apic, if supported - otherwise down to 'disabled'. 
    798             Similarly, if apic is specified, and apic is unsupported a 
     796            <para>Note that if x2apic is specified and x2apic is unsupported by the
     797            VCPU, biosapic downgrades to apic, if supported - otherwise down to 'disabled'.
     798            Similarly, if apic is specified, and apic is unsupported a
    799799            downgrade to 'disabled' results.</para>
    800800          </listitem>
     
    803803            <para><computeroutput>--biossystemtimeoffset &lt;ms&gt;</computeroutput>:
    804804            This specifies a fixed time offset (milliseconds) of the guest relative to
    805             the host time. If the offset is positive, the guest time runs ahead of the 
     805            the host time. If the offset is positive, the guest time runs ahead of the
    806806            host time.</para>
    807807          </listitem>
     
    830830          <listitem>
    831831            <para><computeroutput>--graphicscontroller none|vboxvga|vmsvga</computeroutput>: This
    832             option specifies use of a graphics controller, and type chosen from vboxvga or vmsvga. 
     832            option specifies use of a graphics controller, and type chosen from vboxvga or vmsvga.
    833833            <xref linkend="settings-motherboard" />).</para>
    834834          </listitem>
     
    836836          <listitem>
    837837            <para><computeroutput>--snapshotfolder
    838             default|&lt;path&gt;</computeroutput>: This option specifies the folder in which 
     838            default|&lt;path&gt;</computeroutput>: This option specifies the folder in which
    839839            snapshots will be kept for a virtual machine.</para>
    840840          </listitem>
     
    842842          <listitem>
    843843            <para><computeroutput>--firmware bios|efi|efi32|efi64</computeroutput>:
    844             This option specifies which firmware to be used to boot the VM: 
     844            This option specifies which firmware to be used to boot the VM:
    845845            Available options are: BIOS, or one of the EFI options: efi, efi32 or efi64.
    846846            Use EFI options with care.</para>
     
    898898            <para><computeroutput>--nictype&lt;1-N&gt;
    899899            Am79C970A|Am79C973|82540EM|82543GC|82545EM|virtio</computeroutput>:
    900             This enables you to specify which networking hardware VirtualBox presents 
     900            This enables you to specify which networking hardware VirtualBox presents
    901901            to the guest for a specified VM virtual network card;
    902902            see <xref linkend="nichardware" />.</para>
     
    940940          <listitem>
    941941            <para><computeroutput>--nicspeed&lt;1-N&gt; &lt;kbps&gt;</computeroutput>:
    942             If generic networking has been enabled for a particular virtual network 
     942            If generic networking has been enabled for a particular virtual network
    943943            card (see the <computeroutput>--nic</computeroutput> option above - otherwise
    944             this setting has no effect), this mode enables access to rarely used networking 
    945             sub-modes, such as VDE network or UDP Tunnel. This option specifies the 
     944            this setting has no effect), this mode enables access to rarely used networking
     945            sub-modes, such as VDE network or UDP Tunnel. This option specifies the
    946946            throughput rate in KBytes/sec.
    947947            </para>
     
    963963            <para><computeroutput>--nicpromisc&lt;1-N&gt;
    964964            deny|allow-vms|allow-all</computeroutput>:
    965             This ernables you to specify how the promiscuous mode is handled for 
     965            This ernables you to specify how the promiscuous mode is handled for
    966966            the specified VM virtual network card.
    967             This setting is only relevant for bridged networking. 
     967            This setting is only relevant for bridged networking.
    968968            <computeroutput>deny</computeroutput> (default setting) hides
    969969            any traffic not intended for this VM.
     
    977977          <listitem>
    978978            <para><computeroutput>--nicbandwidthgroup&lt;1-N&gt;
    979             none|&lt;name&gt;</computeroutput>: This removes/adds an assignment 
    980             of a bandwidth group from/to the specified virtual network interface. 
    981             Specifying <computeroutput>none</computeroutput> removes any current 
     979            none|&lt;name&gt;</computeroutput>: This removes/adds an assignment
     980            of a bandwidth group from/to the specified virtual network interface.
     981            Specifying <computeroutput>none</computeroutput> removes any current
    982982            bandwidth group assignment from the specified virtual network interface.
    983             Specifying <computeroutput>&lt;name&gt;</computeroutput> adds an 
    984             assignment of a bandwidth group to the specified virtual network 
     983            Specifying <computeroutput>&lt;name&gt;</computeroutput> adds an
     984            assignment of a bandwidth group to the specified virtual network
    985985            interface.</para>
    986986            <para>For details, please see <xref linkend="network_bandwidth_limit" />.</para>
     
    10331033            <computeroutput>--nic</computeroutput> option above; otherwise
    10341034            this setting has no effect), this mode allows you to access
    1035             rarely used networking sub-modes, such as VDE network or UDP Tunnel. 
     1035            rarely used networking sub-modes, such as VDE network or UDP Tunnel.
    10361036            </para>
    10371037          </listitem>
     
    11041104            <listitem>
    11051105              <para><computeroutput>--nattbindip&lt;1-N&gt;
    1106               &lt;ip;&gt;</computeroutput>: VirtualBox's NAT engine normally routes 
    1107               TCP/IP packets through the default interface assigned by the host's 
    1108               TCP/IP stack. Use this setting to instruct the NAT engine to bind 
     1106              &lt;ip;&gt;</computeroutput>: VirtualBox's NAT engine normally routes
     1107              TCP/IP packets through the default interface assigned by the host's
     1108              TCP/IP stack. Use this setting to instruct the NAT engine to bind
    11091109              to a specified IP address instead. Please see <xref
    11101110              linkend="nat-adv-settings" /> for details.</para>
     
    11841184          connects a given virtual serial port (previously configured with
    11851185          the <computeroutput>--uartX</computeroutput> setting, see above)
    1186           to the host on which the virtual machine is running. As 
    1187           described in detail in <xref linkend="serialports" />, for each 
    1188           such port, you can specify <computeroutput>&lt;arg&gt;</computeroutput> 
     1186          to the host on which the virtual machine is running. As
     1187          described in detail in <xref linkend="serialports" />, for each
     1188          such port, you can specify <computeroutput>&lt;arg&gt;</computeroutput>
    11891189          as one of the following options:<itemizedlist>
    11901190            <listitem>
     
    12341234            <listitem>
    12351235              <para><computeroutput>file &lt;file&gt;</computeroutput>:
    1236               This redirects the serial port output to a raw file &lt;file&gt; 
     1236              This redirects the serial port output to a raw file &lt;file&gt;
    12371237              specified by its absolute path on the host file system.</para>
    12381238            </listitem>
     
    12671267          &lt;I/O base&gt; &lt;IRQ&gt;</computeroutput>:
    12681268          Specifies the I/O address of the parallel port and the IRQ
    1269           number that the Parallel Port feature will be using.  Optional. Use this 
    1270           <emphasis>after</emphasis> <computeroutput>--lptmod</computeroutput>. 
    1271           I/O base address and IRQ are the values that guest sees i.e. the values 
     1269          number that the Parallel Port feature will be using.  Optional. Use this
     1270          <emphasis>after</emphasis> <computeroutput>--lptmod</computeroutput>.
     1271          I/O base address and IRQ are the values that guest sees i.e. the values
    12721272          avalable under guest Device Manager.</para>
    12731273        </listitem>
     
    12831283        <listitem>
    12841284          <para><computeroutput>--audiocontroller ac97|hda|sb16</computeroutput>: With
    1285           this setting, you can specify the audio controller to be used with this 
     1285          this setting, you can specify the audio controller to be used with this
    12861286          VM.
    12871287          </para>
     
    12961296        <listitem>
    12971297          <para><computeroutput>--audioin on</computeroutput>: With
    1298           this setting, you can specify whether capturing audio from the 
     1298          this setting, you can specify whether capturing audio from the
    12991299          host is enabled or disabled.</para>
    13001300        </listitem>
     
    13491349
    13501350        <listitem>
    1351           <para><computeroutput>--usbrename 
     1351          <para><computeroutput>--usbrename
    13521352          &lt;oldname&gt; &lt;newname&gt;</computeroutput>: This
    1353           setting enables renaming of the VM's virtual USB controller from &lt;oldname&gt; 
     1353          setting enables renaming of the VM's virtual USB controller from &lt;oldname&gt;
    13541354          to &lt;newname&gt;.</para>
    13551355        </listitem>
     
    14391439            <itemizedlist>
    14401440              <listitem>
    1441                 <para>For TCP/Ports, &lt;value&gt; should be a port or a range of ports that the VRDE 
    1442                 server can bind to; "default" or "0" means port 3389, the standard port for RDP. 
     1441                <para>For TCP/Ports, &lt;value&gt; should be a port or a range of ports that the VRDE
     1442                server can bind to; "default" or "0" means port 3389, the standard port for RDP.
    14431443                For details, see the description for the
    14441444                <computeroutput>--vrdeport</computeroutput> option in <xref
     
    14671467
    14681468              <listitem>
    1469                 <para>For VideoChannel/Quality, &lt;value&gt; should be set between 10 and 100% inclusive, 
    1470                 representing a JPEG compression level on the VRDE server video channel. Lower values mean lower 
     1469                <para>For VideoChannel/Quality, &lt;value&gt; should be set between 10 and 100% inclusive,
     1470                representing a JPEG compression level on the VRDE server video channel. Lower values mean lower
    14711471                quality but higher compression. For details, see <xref linkend="vrde-videochannel" />.</para>
    14721472              </listitem>
    14731473
    14741474              <listitem>
    1475                 <para>For VideoChannel/DownscaleProtection, &lt;value&gt; can be set to "1" to 
    1476                 enable the videochannel downscale protection feature. When enabled, if a video's size equals the shadow buffer 
     1475                <para>For VideoChannel/DownscaleProtection, &lt;value&gt; can be set to "1" to
     1476                enable the videochannel downscale protection feature. When enabled, if a video's size equals the shadow buffer
    14771477                size, then it is regarded as a full screen video, and is displayed; but if its size is between fullscreen and the downscale
    14781478                threshold - it is NOT displayed, as it could be an application window, which would be unreadable when downscaled.
     
    14951495            For details, see <xref linkend="vrde-customization" />.</para>
    14961496          </listitem>
    1497  
     1497
    14981498          <listitem>
    14991499            <para><computeroutput>--vrdeproperty "Client/DisableRDPDR=1"</computeroutput></para>
     
    15261526                  </listitem>
    15271527                  <listitem>
    1528                     <para> <computeroutput>TLS</computeroutput> - only Enhanced RDP Security is accepted. 
     1528                    <para> <computeroutput>TLS</computeroutput> - only Enhanced RDP Security is accepted.
    15291529                    The client must support TLS.</para>
    15301530                  </listitem>
     
    16301630          <listitem>
    16311631            <para><computeroutput>--vrdeauthtype
    1632             null|external|guest</computeroutput>: This enables you to indicate 
    1633             use of authorization, and specify how authorization will be performed; 
     1632            null|external|guest</computeroutput>: This enables you to indicate
     1633            use of authorization, and specify how authorization will be performed;
    16341634            see <xref linkend="vbox-auth" /> for details.</para>
    16351635          </listitem>
     
    16821682      introduction.<itemizedlist>
    16831683          <listitem>
    1684             <para><computeroutput>--teleporter on|off</computeroutput>: 
    1685             This setting enables/disables the teleporter feature whereby when the 
    1686             machine is started, it waits to receieve a teleporting request from the 
    1687             network instead of booting normally; teleporting requests are received on the 
     1684            <para><computeroutput>--teleporter on|off</computeroutput>:
     1685            This setting enables/disables the teleporter feature whereby when the
     1686            machine is started, it waits to receieve a teleporting request from the
     1687            network instead of booting normally; teleporting requests are received on the
    16881688            port and address specified using the following two parameters.</para>
    16891689          </listitem>
     
    16931693            &lt;port&gt;</computeroutput>, <computeroutput>--teleporteraddress
    16941694            &lt;address&gt;</computeroutput>: these settings must be used with
    1695             --teleporter and they specify the port and address the virtual machine should 
    1696             listen to to receive a teleporting request sent from another virtual machine. 
     1695            --teleporter and they specify the port and address the virtual machine should
     1696            listen to to receive a teleporting request sent from another virtual machine.
    16971697            <computeroutput>&lt;port&gt;</computeroutput> can
    16981698            be any free TCP/IP port number (e.g. 6000);
     
    17631763
    17641764      <para>The following setting defines access to a USB Card Reader by the guest environment.
    1765       USB card readers are typically used for accessing data on memory cards such as 
     1765      USB card readers are typically used for accessing data on memory cards such as
    17661766      CompactFlash (CF), Secure Digital (SD) or MultiMediaCard (MMC).</para>
    17671767      <itemizedlist>
     
    17771777
    17781778      <para>These settings configure the VM autostart feature,
    1779       which automatically starts the VM at host system boot-up. 
    1780       Note that there are pre-requisites that need to be addressed before using this feature. 
     1779      which automatically starts the VM at host system boot-up.
     1780      Note that there are pre-requisites that need to be addressed before using this feature.
    17811781      See <xref lang="" linkend="autostart" /> for more details.</para>
    17821782      <itemizedlist>
     
    18261826           option defines that a linked clone should be created, which is
    18271827           only possible for a machine cloned from a snapshot. The next two
    1828            options enable specification of the handling of MAC addresses of 
     1828           options enable specification of the handling of MAC addresses of
    18291829           every virtual network card. They can either be reinitialized
    18301830           (the default), left unchanged
     
    19911991    <para>For virtualization products which aren't fully compatible with the
    19921992    OVF standard 1.0 you can enable a OVF 0.9 legacy mode with the
    1993     <computeroutput>--legacy09</computeroutput> option. Other options are 
     1993    <computeroutput>--legacy09</computeroutput> option. Other options are
    19941994    --ovf09, --ovf10, --ovf20.</para>
    19951995
     
    21302130        <listitem>
    21312131          <para><computeroutput>VBoxManage controlvm &lt;vm&gt;
    2132           acpipowerbutton</computeroutput> will send an ACPI shutdown signal to 
     2132          acpipowerbutton</computeroutput> will send an ACPI shutdown signal to
    21332133          the VM, as if the power button on a real computer had been pressed.
    2134           So long as the VM is running a fairly modern guest operating system 
    2135           providing ACPI support, this should trigger a proper shutdown mechanism 
     2134          So long as the VM is running a fairly modern guest operating system
     2135          providing ACPI support, this should trigger a proper shutdown mechanism
    21362136          from within the VM.</para>
    21372137        </listitem>
     
    21392139        <listitem>
    21402140          <para><computeroutput>VBoxManage controlvm &lt;vm&gt;
    2141           keyboardputscancode &lt;hex&gt; [&lt;hex&gt;...]</computeroutput> 
    2142           Sends commands using keycodes to the VM. Keycodes are documented in the 
     2141          keyboardputscancode &lt;hex&gt; [&lt;hex&gt;...]</computeroutput>
     2142          Sends commands using keycodes to the VM. Keycodes are documented in the
    21432143          public domain, e.g. http://www.win.tue.nl/~aeb/linux/kbd/scancodes-1.html.</para>
    21442144        </listitem>
     
    21712171      <listitem>
    21722172        <para><computeroutput>nic&lt;1-N&gt;
    2173         null|nat|bridged|intnet|hostonly|generic|natnetwork[&lt;devicename&gt;]</computeroutput>: 
    2174         specifies the type of networking that should be made available on the specified VM 
    2175         virtual network card. 
     2173        null|nat|bridged|intnet|hostonly|generic|natnetwork[&lt;devicename&gt;]</computeroutput>:
     2174        specifies the type of networking that should be made available on the specified VM
     2175        virtual network card.
    21762176        They can be: not connected to the host
    21772177        (<computeroutput>null</computeroutput>), use network address
     
    21832183        (<computeroutput>natnetwork</computeroutput>) or access to rarely used
    21842184        sub-modes
    2185         (<computeroutput>generic</computeroutput>). 
     2185        (<computeroutput>generic</computeroutput>).
    21862186        These options correspond to the modes which are described in detail in <xref
    21872187        linkend="networkingmodes" />.</para>
     
    21892189
    21902190      <listitem>
    2191         <para>With the "nictrace" options, you can optionally trace network traffic by dumping 
     2191        <para>With the "nictrace" options, you can optionally trace network traffic by dumping
    21922192        it to a file, for debugging purposes.</para>
    21932193
    21942194        <para>With <computeroutput>nictrace&lt;1-N&gt;
    2195         on|off</computeroutput>, you can enable network tracing for a particular virtual 
     2195        on|off</computeroutput>, you can enable network tracing for a particular virtual
    21962196        network card.</para>
    21972197
     
    22052205        <para><computeroutput>nicpromisc&lt;1-N&gt;
    22062206        deny|allow-vms|allow-all</computeroutput>:
    2207         This specifies how the promiscious mode is handled for the specified VM 
     2207        This specifies how the promiscious mode is handled for the specified VM
    22082208        virtual network card. This setting is only relevant for bridged networking.
    22092209        <computeroutput>deny</computeroutput> (default setting) hides
     
    22532253
    22542254      <listitem>
    2255         <para><computeroutput>usbattach&lt;uuid|address&gt; [--capturefile &lt;filename&gt;]</computeroutput></para> 
    2256         <para>and <computeroutput>usbdetach &lt;uuid|address&gt; [--capturefile &lt;filename&gt;]</computeroutput> 
     2255        <para><computeroutput>usbattach&lt;uuid|address&gt; [--capturefile &lt;filename&gt;]</computeroutput></para>
     2256        <para>and <computeroutput>usbdetach &lt;uuid|address&gt; [--capturefile &lt;filename&gt;]</computeroutput>
    22572257        make host USB devices visible/invisible to the virtual machine on the fly, without the need for
    22582258        creating filters first. The USB devices can be specified by UUID
    2259         (unique identifier) or by address on the host system. Use the --capturefile 
     2259        (unique identifier) or by address on the host system. Use the --capturefile
    22602260        option to specify the absolute path of a file for writing activity logging data.</para>
    22612261
     
    22662266      <listitem>
    22672267        <para><computeroutput>audioin on</computeroutput>: With
    2268         this setting, you can select whether capturing audio from the 
     2268        this setting, you can select whether capturing audio from the
    22692269        host is enabled or disabled.</para>
    22702270      </listitem>
     
    23142314        <itemizedlist>
    23152315          <listitem>
    2316             <para>For TCP/Ports, &lt;value&gt; should be a port or a range of ports to which 
    2317             the VRDE server can bind; "default" or "0" means port 3389, the standard port for RDP. 
     2316            <para>For TCP/Ports, &lt;value&gt; should be a port or a range of ports to which
     2317            the VRDE server can bind; "default" or "0" means port 3389, the standard port for RDP.
    23182318            For details, see the description for the
    23192319            <computeroutput>--vrdeport</computeroutput> option in <xref
     
    23422342
    23432343          <listitem>
    2344             <para>For VideoChannel/Quality, &lt;value&gt; should be set between 10 and 100% inclusive, 
    2345             representing a JPEG compression level on the VRDE server video channel. Lower values mean lower 
     2344            <para>For VideoChannel/Quality, &lt;value&gt; should be set between 10 and 100% inclusive,
     2345            representing a JPEG compression level on the VRDE server video channel. Lower values mean lower
    23462346            quality but higher compression. For details, see <xref linkend="vrde-videochannel" />.</para>
    23472347          </listitem>
    23482348
    23492349          <listitem>
    2350             <para>For VideoChannel/DownscaleProtection, &lt;value&gt; can be set to "1" to enable the 
    2351             videochannel downscale protection feature. When enabled, if a video's size equals the shadow 
    2352             buffer size, then it is regarded as a full screen video, and is displayed; but if its size 
    2353             is between fullscreen and the downscale threshold - it is NOT displayed, as it could be an 
     2350            <para>For VideoChannel/DownscaleProtection, &lt;value&gt; can be set to "1" to enable the
     2351            videochannel downscale protection feature. When enabled, if a video's size equals the shadow
     2352            buffer size, then it is regarded as a full screen video, and is displayed; but if its size
     2353            is between fullscreen and the downscale threshold - it is NOT displayed, as it could be an
    23542354            application window, which would be unreadable when downscaled.
    23552355            When the downscale protection feature is disabled, an attempt is always made to display videos.</para>
     
    23712371        For details, see <xref linkend="vrde-customization" />.</para>
    23722372      </listitem>
    2373  
     2373
    23742374      <listitem>
    23752375        <para><computeroutput>vrdeproperty "Client/DisableRDPDR=1"</computeroutput></para>
     
    24022402              </listitem>
    24032403              <listitem>
    2404                 <para> <computeroutput>TLS</computeroutput> - only Enhanced RDP Security is accepted. 
     2404                <para> <computeroutput>TLS</computeroutput> - only Enhanced RDP Security is accepted.
    24052405                The client must support TLS.</para>
    24062406              </listitem>
     
    24392439            <itemizedlist>
    24402440              <listitem>
    2441                 <para> <computeroutput>VRDP_AUDIO_MODE_VOID</computeroutput> - no mode specified, use to 
     2441                <para> <computeroutput>VRDP_AUDIO_MODE_VOID</computeroutput> - no mode specified, use to
    24422442                unset any Audio mode already set.</para>
    24432443              </listitem>
     
    24492449              </listitem>
    24502450              <listitem>
    2451                 <para> <computeroutput>VRDP_AUDIO_MODE_CS</computeroutput> - client sync mode to prevent 
     2451                <para> <computeroutput>VRDP_AUDIO_MODE_CS</computeroutput> - client sync mode to prevent
    24522452                under/overflow of the client queue.</para>
    24532453              </listitem>
     
    24602460        </itemizedlist></para>
    24612461      </listitem>
    2462            
     2462
    24632463      <listitem>
    24642464        <para><computeroutput>vrdevideochannelquality
     
    25522552
    25532553      <listitem>
    2554         <para><computeroutput>teleport --host &lt;name&gt; --port &lt;port&gt;</computeroutput> 
    2555         can be used to configure a VM as a target for teleporting. 
    2556         &lt;name&gt; specifies the virtual machine name. &lt;port&gt; specifies the port on the 
     2554        <para><computeroutput>teleport --host &lt;name&gt; --port &lt;port&gt;</computeroutput>
     2555        can be used to configure a VM as a target for teleporting.
     2556        &lt;name&gt; specifies the virtual machine name. &lt;port&gt; specifies the port on the
    25572557        virtual machine which should listen for teleporting requests from other
    25582558        virtual machines. It can be any free TCP/IP port number (e.g. 6000);
     
    25612561          <listitem>
    25622562            <para><computeroutput>--maxdowntime &lt;msec&gt;</computeroutput>:
    2563             specifies the maximum downtime (milliseconds) for the 
     2563            specifies the maximum downtime (milliseconds) for the
    25642564            teleporting target VM. Optional.</para>
    25652565          </listitem>
     
    25672567          <listitem>
    25682568            <para><computeroutput>--password
    2569             &lt;password&gt;</computeroutput>: 
     2569            &lt;password&gt;</computeroutput>:
    25702570            indicates that the teleporting request will only succeed if the
    25712571            source machine specifies the same password as the one given with
     
    25752575          <listitem>
    25762576            <para><computeroutput>--passwordfile
    2577             &lt;password file&gt;</computeroutput>: 
     2577            &lt;password file&gt;</computeroutput>:
    25782578            indicates that the teleporting request will only succeed if the
    25792579            source machine specifies the same password as the one specified
    2580             in the password file with the path specified with this command. 
    2581             Use <computeroutput>stdin</computeroutput> to read the password 
     2580            in the password file with the path specified with this command.
     2581            Use <computeroutput>stdin</computeroutput> to read the password
    25822582            from stdin. Optional.</para>
    25832583          </listitem>
     
    26022602
    26032603      <listitem>
    2604         <para><computeroutput>webcam 
    2605         attach &lt;path|alias&gt; [&lt;key=value&gt;[;&lt;key=value&gt;...]]</computeroutput>: This operation 
    2606         attaches a webcam to a running VM. Specify the absolute path of the 
    2607         webcam on the host operating system, or use its alias (obtained by using the command: VBoxManage 
     2604        <para><computeroutput>webcam
     2605        attach &lt;path|alias&gt; [&lt;key=value&gt;[;&lt;key=value&gt;...]]</computeroutput>: This operation
     2606        attaches a webcam to a running VM. Specify the absolute path of the
     2607        webcam on the host operating system, or use its alias (obtained by using the command: VBoxManage
    26082608        list webcams).</para>
    26092609
    2610         <para>Note that alias '.0' means default video input device on the host operating system, '.1', '.2', 
     2610        <para>Note that alias '.0' means default video input device on the host operating system, '.1', '.2',
    26112611        etc. mean first, second, etc. video input device. The device order is host-specific.</para>
    26122612
    2613         <para>The optional settings parameter is a ';' delimited list of name/value pairs, enabling configuration 
     2613        <para>The optional settings parameter is a ';' delimited list of name/value pairs, enabling configuration
    26142614        of the emulated webcam device.</para>
    26152615
    26162616        <para>The following settings are supported:</para>
    26172617
    2618         <para>MaxFramerate (default no maximum limit) - this specifies the highest rate (frames/sec) at which 
    2619         video frames are sent to the guest. Higher frame rates increase CPU load, so this setting can be useful 
    2620         when there is a need to reduce CPU load. Its default 'value' is 'no maximum limit', thus enabling the 
     2618        <para>MaxFramerate (default no maximum limit) - this specifies the highest rate (frames/sec) at which
     2619        video frames are sent to the guest. Higher frame rates increase CPU load, so this setting can be useful
     2620        when there is a need to reduce CPU load. Its default 'value' is 'no maximum limit', thus enabling the
    26212621        guest to use all frame rates supported by the host webcam.</para>
    26222622
    2623         <para>MaxPayloadTransferSize (default 3060 bytes) - this specifies the maximum number of bytes the emulated 
    2624         webcam can send to the guest in one buffer. The default is used by some webcams. Higher values can 
    2625         slightly reduce CPU load, if the guest is able to use larger buffers. 
     2623        <para>MaxPayloadTransferSize (default 3060 bytes) - this specifies the maximum number of bytes the emulated
     2624        webcam can send to the guest in one buffer. The default is used by some webcams. Higher values can
     2625        slightly reduce CPU load, if the guest is able to use larger buffers.
    26262626        Note that higher MaxPayloadTransferSize values may be not supported by some guest operating systems.</para>
    26272627      </listitem>
    26282628
    26292629      <listitem>
    2630         <para><computeroutput>webcam 
    2631         detach &lt;path|alias&gt;</computeroutput>: This operation 
    2632         detaches a webcam from a running VM. Specify the absolute path of the 
     2630        <para><computeroutput>webcam
     2631        detach &lt;path|alias&gt;</computeroutput>: This operation
     2632        detaches a webcam from a running VM. Specify the absolute path of the
    26332633        webcam on the host, or use its alias (obtained from webcam list below).</para>
    26342634        <para>Note the points below relating to specific Host Operating Systems:</para>
     
    26362636        <para>Windows hosts</para>
    26372637
    2638         <para>When the webcam device is detached from the host, the emulated webcam device 
     2638        <para>When the webcam device is detached from the host, the emulated webcam device
    26392639        is automatically detached from the guest.</para>
    26402640
     
    26442644
    26452645        <para>When the webcam device is detached from the host, the emulated webcam device remains
    2646         attached to the guest and must be manually detached using the 
     2646        attached to the guest and must be manually detached using the
    26472647        VBoxManage controlvm "VM name" webcam detach command.</para>
    26482648
    26492649        <para>Linux hosts</para>
    26502650
    2651         <para>When the webcam is detached from the host, the emulated webcam device is automatically detached 
    2652         from the guest only if the webcam is streaming video. If the emulated webcam is inactive, it     
     2651        <para>When the webcam is detached from the host, the emulated webcam device is automatically detached
     2652        from the guest only if the webcam is streaming video. If the emulated webcam is inactive, it
    26532653        should be manually detached using the VBoxManage controlvm "VM name" webcam detach command.</para>
    26542654      </listitem>
    26552655
    26562656      <listitem>
    2657         <para><computeroutput>webcam list</computeroutput>: This operation 
     2657        <para><computeroutput>webcam list</computeroutput>: This operation
    26582658        lists webcams attached to the running VM.
    2659         The output is a list of absolute paths or aliases that were used for attaching the webcams 
     2659        The output is a list of absolute paths or aliases that were used for attaching the webcams
    26602660        to the VM using the 'webcam attach' command above.
    26612661        </para>
     
    26632663
    26642664      <listitem>
    2665         <para><computeroutput>addencpassword 
    2666         &lt;id&gt; &lt;password file&gt;|- [--removeonsuspend &lt;yes|no&gt;]</computeroutput>: This operation 
    2667         supplies an encrypted VM specified by &lt;id&gt; with the encryption password to enable a headless start. 
    2668         Either specify the absolute path of a password file on the host file system: &lt;password file&gt;, or 
     2665        <para><computeroutput>addencpassword
     2666        &lt;id&gt; &lt;password file&gt;|- [--removeonsuspend &lt;yes|no&gt;]</computeroutput>: This operation
     2667        supplies an encrypted VM specified by &lt;id&gt; with the encryption password to enable a headless start.
     2668        Either specify the absolute path of a password file on the host file system: &lt;password file&gt;, or
    26692669        use a '-' to instruct VBoxManage to prompt the user for the encryption password. </para>
    26702670
    2671         <para><computeroutput>--removeonsuspend &lt;yes|no&gt;</computeroutput> specifies whether to remove/keep 
    2672         the password from/in VM memory when the VM is suspended. If the VM has been suspended and the password has 
    2673         been removed, the user needs to resupply the password before the VM can be resumed. This feature is useful 
    2674         in cases where the user doesn't want the password to be stored in VM memory, and the VM is suspended by a   
     2671        <para><computeroutput>--removeonsuspend &lt;yes|no&gt;</computeroutput> specifies whether to remove/keep
     2672        the password from/in VM memory when the VM is suspended. If the VM has been suspended and the password has
     2673        been removed, the user needs to resupply the password before the VM can be resumed. This feature is useful
     2674        in cases where the user doesn't want the password to be stored in VM memory, and the VM is suspended by a
    26752675        host suspend event.</para>
    26762676
    2677         <para>Note: On VirtualBox versions 5.0 and later, data stored on hard disk images can be transparently 
    2678         encrypted for the guest. VirtualBox uses the AES algorithm in XTS mode and supports 128 or 256 
    2679         bit data encryption keys (DEK). The DEK is stored encrypted in the medium properties, and is 
     2677        <para>Note: On VirtualBox versions 5.0 and later, data stored on hard disk images can be transparently
     2678        encrypted for the guest. VirtualBox uses the AES algorithm in XTS mode and supports 128 or 256
     2679        bit data encryption keys (DEK). The DEK is stored encrypted in the medium properties, and is
    26802680        decrypted during VM startup by supplying the encryption password.</para>
    26812681
    2682         <para>The "VBoxManage encryptmedium" operation is used to create a DEK encrypted medium. 
     2682        <para>The "VBoxManage encryptmedium" operation is used to create a DEK encrypted medium.
    26832683        See <xref linkend="diskencryption-encryption" />" for details.
    2684         When starting an encrypted VM from a VirtualBox GUI app, the user will be prompted for the 
     2684        When starting an encrypted VM from a VirtualBox GUI app, the user will be prompted for the
    26852685        encryption password.</para>
    26862686
    26872687        <para>For a headless encrypted VM start, use:</para>
    2688    
     2688
    26892689        <para>VBoxManage startvm "vmname" --type headless</para>
    26902690
     
    26982698      <listitem>
    26992699        <para><computeroutput>removeencpassword &lt;id&gt;</computeroutput>: This operation
    2700         removes encryption password authorization for password &lt;id&gt; for all encrypted media 
     2700        removes encryption password authorization for password &lt;id&gt; for all encrypted media
    27012701        attached to the VM.</para>
    27022702      </listitem>
     
    27042704      <listitem>
    27052705        <para><computeroutput>removeallencpasswords</computeroutput>: This operation
    2706         removes encryption password authorization for all passwords for all 
     2706        removes encryption password authorization for all passwords for all
    27072707        encrypted media attached to the VM.</para>
    27082708      </listitem>
     
    27422742    hard disks can be quickly reset by simply dropping the pre-existing
    27432743    differencing files.</para>
    2744  
     2744
    27452745   <screen>VBoxManage snapshot         &lt;uuid|vmname&gt;
    27462746                            take &lt;name&gt; [--description &lt;desc&gt;] [--live]
     
    30363036          <glossterm><computeroutput>--discard</computeroutput></glossterm>
    30373037          <glossdef>
    3038             <para>This switch enables the auto-discard feature for the virtual 
    3039             hard disks. This specifies that a VDI image will be shrunk in response 
     3038            <para>This switch enables the auto-discard feature for the virtual
     3039            hard disks. This specifies that a VDI image will be shrunk in response
    30403040            to the trim command from the guest OS. The following requirements
    30413041            must be met:
     
    30443044              <listitem>
    30453045                <para>The disk format must be VDI.</para>
    3046               </listitem> 
    3047               <listitem> 
     3046              </listitem>
     3047              <listitem>
    30483048                <para>The size of the cleared area must be at least 1MB.</para>
    30493049              </listitem>
    30503050              <listitem>
    3051                 <para>VirtualBox will only trim whole 1MB blocks. The VDIs themselves are organized 
    3052                 into 1MB blocks, so this will only work if the space being TRIM-ed is at least 
     3051                <para>VirtualBox will only trim whole 1MB blocks. The VDIs themselves are organized
     3052                into 1MB blocks, so this will only work if the space being TRIM-ed is at least
    30533053                a 1MB contiguous block at a 1MB boundary. On Windows, occasional defrag (with "defrag.exe /D"),
    30543054                or under Linux running "btrfs filesystem defrag" as a background cron job may be
     
    30573057            </itemizedlist></para>
    30583058
    3059             <para>Notes: the Guest OS must be configured to issue trim command, and typically this 
    3060             means that the guest OS is made to 'see' the disk as an SSD. Ext4 supports -o discard mount flag; 
    3061             OSX probably requires additional settings. Windows ought to automatically detect and 
    3062             support SSDs - at least in versions 7, 8 and 10. Linux exFAT driver (courtesy of Samsung) 
     3059            <para>Notes: the Guest OS must be configured to issue trim command, and typically this
     3060            means that the guest OS is made to 'see' the disk as an SSD. Ext4 supports -o discard mount flag;
     3061            OSX probably requires additional settings. Windows ought to automatically detect and
     3062            support SSDs - at least in versions 7, 8 and 10. Linux exFAT driver (courtesy of Samsung)
    30633063            supports the trim command.</para>
    30643064            <para>It is unclear whether Microsoft's implementation of exFAT supports this feature, even
    30653065            though that file system was originally designed for flash.</para>
    30663066            <para>Alternatively, there are ad hoc methods to issue trim, e.g. Linux fstrim command,
    3067             part of util-linux package. Earlier solutions required a user to zero out unused areas, 
    3068             e.g. using zerofree, and explicitly compact the disk - only possible when the VM is 
     3067            part of util-linux package. Earlier solutions required a user to zero out unused areas,
     3068            e.g. using zerofree, and explicitly compact the disk - only possible when the VM is
    30693069            offline.</para>
    30703070          </glossdef>
     
    31623162            <para>iSCSI Initiator (optional). Note:</para>
    31633163
    3164             <para>Microsoft iSCSI Initiator is a system, such as a server that attaches to an IP network and initiates requests and receives responses 
    3165             from an iSCSI target. The SAN components in Microsoft iSCSI Initiator are largely analogous to Fibre Channel SAN components, and 
     3164            <para>Microsoft iSCSI Initiator is a system, such as a server that attaches to an IP network and initiates requests and receives responses
     3165            from an iSCSI target. The SAN components in Microsoft iSCSI Initiator are largely analogous to Fibre Channel SAN components, and
    31663166            they include the following:/</para>
    31673167
    3168             <para>To transport blocks of iSCSI commands over the IP network, an iSCSI driver must be installed on the iSCSI host. 
     3168            <para>To transport blocks of iSCSI commands over the IP network, an iSCSI driver must be installed on the iSCSI host.
    31693169            An iSCSI driver is included with Microsoft iSCSI Initiator.</para>
    31703170
    3171             <para>A gigabit Ethernet adapter that transmits 1000 megabits per second (Mbps) is recommended for the connection to an iSCSI target. Like 
    3172             standard 10/100 adapters, most gigabit adapters use a pre-existing Category 5 or Category 6E cable. Each port on the adapter is 
     3171            <para>A gigabit Ethernet adapter that transmits 1000 megabits per second (Mbps) is recommended for the connection to an iSCSI target. Like
     3172            standard 10/100 adapters, most gigabit adapters use a pre-existing Category 5 or Category 6E cable. Each port on the adapter is
    31733173            identified by a unique IP address.</para>
    31743174
    3175            <para>An iSCSI target is any device that receives iSCSI commands. The device can be an end node, such as a storage device, or it can be an 
    3176            intermediate device, such as a network bridge between IP and Fibre Channel devices. Each port on the storage array controller or network 
     3175           <para>An iSCSI target is any device that receives iSCSI commands. The device can be an end node, such as a storage device, or it can be an
     3176           intermediate device, such as a network bridge between IP and Fibre Channel devices. Each port on the storage array controller or network
    31773177           bridge is identified by one or more IP addresses</para>
    31783178          </glossdef>
     
    33193319      <listitem>
    33203320        <para><computeroutput>list</computeroutput>, shows all bandwidth groups
    3321         defined for the given VM. Use the <computeroutput>--machinereadable</computeroutput> 
    3322         option to produce the same output, but in machine readable format. This is of the 
     3321        defined for the given VM. Use the <computeroutput>--machinereadable</computeroutput>
     3322        option to produce the same output, but in machine readable format. This is of the
    33233323        form: name="value" on a line by line basis.</para>
    33243324      </listitem>
     
    33623362            while the VM is running. The default unit is megabytes per
    33633363            second. The unit can be changed by specifying one of the
    3364             following suffixes: <computeroutput>k</computeroutput> for kilobits/s, 
     3364            following suffixes: <computeroutput>k</computeroutput> for kilobits/s,
    33653365            <computeroutput>m</computeroutput> for megabits/s,
    33663366            <computeroutput>g</computeroutput> for gigabits/s,
     
    33973397    <para>The medium must be specified either by its UUID (if the medium
    33983398      is registered) or by its filename. Registered images can be listed by
    3399       <computeroutput>VBoxManage list hdds</computeroutput>, 
    3400       <computeroutput>VBoxManage list dvds</computeroutput>, 
     3399      <computeroutput>VBoxManage list hdds</computeroutput>,
     3400      <computeroutput>VBoxManage list dvds</computeroutput>,
    34013401      or <computeroutput>VBoxManage list floppies</computeroutput>, as appropriate.
    34023402      (see <xref linkend="vboxmanage-list" />
     
    34383438
    34393439          <glossdef>
    3440             <para>Specifies the differencing image parent, either as a UUID or 
    3441             by the absolute pathname of the file on the host file system. 
     3440            <para>Specifies the differencing image parent, either as a UUID or
     3441            by the absolute pathname of the file on the host file system.
    34423442            Useful for sharing a base box disk image among several VMs.</para>
    34433443          </glossdef>
     
    34483448
    34493449          <glossdef>
    3450             <para>Specifies the file format for the output file. Available 
     3450            <para>Specifies the file format for the output file. Available
    34513451            options are VDI, VMDK, VHD. Default is VDI. Optional. </para>
    34523452          </glossdef>
     
    34573457
    34583458          <glossdef>
    3459             <para>Specifies any required file format variant(s) for the output file.  It is a 
    3460             comma-separated list of variant flags. Not all combinations are supported, and specifying 
     3459            <para>Specifies any required file format variant(s) for the output file.  It is a
     3460            comma-separated list of variant flags. Not all combinations are supported, and specifying
    34613461            mutually incompatible flags results in an error message. Optional.</para>
    34623462          </glossdef>
    34633463        </glossentry>
    34643464      </glosslist> <note>
    3465         <para>For compatibility with earlier versions of VirtualBox, the "createvdi"  and "createhd" commands 
     3465        <para>For compatibility with earlier versions of VirtualBox, the "createvdi"  and "createhd" commands
    34663466        are also supported and mapped internally to the "createmedium" command.</para>
    34673467      </note></para>
     
    34813481                         [--resize &lt;megabytes&gt;|--resizebyte &lt;bytes&gt;]
    34823482                         [--move &lt;path&gt;</screen><note>
    3483         <para>For compatibility with earlier versions of VirtualBox, the "modifyvdi" and "modifyhd" 
     3483        <para>For compatibility with earlier versions of VirtualBox, the "modifyvdi" and "modifyhd"
    34843484        commands are also supported and mapped internally to the "modifymedium" command.</para>
    34853485      </note></para>
     
    36323632    The syntax is as follows:</para>
    36333633
    3634     <screen>VBoxManage mediumproperty [disk|dvd|floppy] set &lt;uuid|filename&gt; 
     3634    <screen>VBoxManage mediumproperty [disk|dvd|floppy] set &lt;uuid|filename&gt;
    36353635                                                &lt;property&gt; &lt;value&gt;</screen>
    36363636
     
    36433643
    36443644        <listitem>
    3645           <para>Use <computeroutput>&lt;uuid|filename&gt;</computeroutput> to supply either the uuid 
     3645          <para>Use <computeroutput>&lt;uuid|filename&gt;</computeroutput> to supply either the uuid
    36463646          or absolute path of the medium/image to be encrypted.</para>
    36473647        </listitem>
    3648  
    3649         <listitem>
    3650           <para>Use <computeroutput>&lt;property&gt;</computeroutput> to supply the name of the 
     3648
     3649        <listitem>
     3650          <para>Use <computeroutput>&lt;property&gt;</computeroutput> to supply the name of the
    36513651          property.</para>
    36523652        </listitem>
     
    36573657    </itemizedlist></para>
    36583658
    3659     <screen>VBoxManage mediumproperty [disk|dvd|floppy] get &lt;uuid|filename&gt; 
     3659    <screen>VBoxManage mediumproperty [disk|dvd|floppy] get &lt;uuid|filename&gt;
    36603660                                                &lt;property&gt;</screen>
    36613661    <para><itemizedlist>
     
    36763676    </itemizedlist></para>
    36773677
    3678     <screen>VBoxManage mediumproperty [disk|dvd|floppy] delete &lt;uuid|filename&gt; 
     3678    <screen>VBoxManage mediumproperty [disk|dvd|floppy] delete &lt;uuid|filename&gt;
    36793679                                                   &lt;property&gt;</screen>
    36803680
    3681  
     3681
    36823682    <para><itemizedlist>
    36833683        <listitem>
     
    37063706    <para>The syntax is as follows:</para>
    37073707
    3708     <screen>VBoxManage encryptmedium &lt;uuid|filename&gt; 
     3708    <screen>VBoxManage encryptmedium &lt;uuid|filename&gt;
    37093709                         [--newpassword &lt;file|-&gt;]
    37103710                         [--oldpassword &lt;file|-&gt;]
     
    37143714    <para><itemizedlist>
    37153715        <listitem>
    3716           <para>use <computeroutput>&lt;uuid|filename&gt;</computeroutput> to supply the 
     3716          <para>use <computeroutput>&lt;uuid|filename&gt;</computeroutput> to supply the
    37173717           uuid or absolute path of the medium/image to be encrypted.</para>
    37183718        </listitem>
    37193719
    37203720        <listitem>
    3721           <para>Use <computeroutput>--newpassword &lt;file|-&gt;</computeroutput> to supply a new 
     3721          <para>Use <computeroutput>--newpassword &lt;file|-&gt;</computeroutput> to supply a new
    37223722          encryption password; either specify the absolute pathname of a password file on the host operating system,
    3723           or <computeroutput>-</computeroutput> to prompt you for the password on the command line. 
     3723          or <computeroutput>-</computeroutput> to prompt you for the password on the command line.
    37243724          Always use the <computeroutput>--newpasswordid</computeroutput> option with this option.</para>
    37253725        </listitem>
     
    37303730          or <computeroutput>-</computeroutput> to prompt you for the old password on the command line.</para>
    37313731
    3732           <para>Use this option to gain access to an encrypted medium/image to change its password using 
     3732          <para>Use this option to gain access to an encrypted medium/image to change its password using
    37333733          <computeroutput>--newpassword</computeroutput> and/or change its encryption using
    37343734          <computeroutput>--cipher</computeroutput>.</para>
     
    37363736
    37373737        <listitem>
    3738           <para>Use <computeroutput>--cipher &lt;cipher&gt;</computeroutput> to specify the cipher to use for 
    3739           encryption; this can be either <computeroutput>AES-XTS128-PLAIN64</computeroutput> or 
     3738          <para>Use <computeroutput>--cipher &lt;cipher&gt;</computeroutput> to specify the cipher to use for
     3739          encryption; this can be either <computeroutput>AES-XTS128-PLAIN64</computeroutput> or
    37403740          <computeroutput>AES-AXTS256-PLAIN64</computeroutput>.</para>
    37413741
    3742           <para>Use this option to change any existing encryption on the medium/image, or setup new encryption on 
     3742          <para>Use this option to change any existing encryption on the medium/image, or setup new encryption on
    37433743          it for the 1st time.</para>
    37443744        </listitem>
     
    37463746        <listitem>
    37473747          <para>Use <computeroutput>--newpasswordid &lt;password id&gt;</computeroutput> to supply the new password identifier.
    3748           This can be freely chosen by the user, and is used for correct identification when supplying multiple 
     3748          This can be freely chosen by the user, and is used for correct identification when supplying multiple
    37493749          passwords during VM startup.</para>
    37503750
    3751           <para>If the user uses the same password when encrypting multiple images and also the same password identifier, the 
     3751          <para>If the user uses the same password when encrypting multiple images and also the same password identifier, the
    37523752          user needs to supply the password only once during VM startup.</para>
    37533753        </listitem>
     
    37653765    <para>The syntax is as follows:</para>
    37663766
    3767     <screen>VBoxManage checkmediumpwd &lt;uuid|filename&gt; 
     3767    <screen>VBoxManage checkmediumpwd &lt;uuid|filename&gt;
    37683768                                      &lt;pwd file|-&gt;</screen>
    37693769    <para><itemizedlist>
    37703770        <listitem>
    3771           <para>Use <computeroutput>&lt;uuid|filename&gt;</computeroutput> to supply the uuid or absolute path of the 
     3771          <para>Use <computeroutput>&lt;uuid|filename&gt;</computeroutput> to supply the uuid or absolute path of the
    37723772           medium/image to be checked.</para>
    37733773        </listitem>
    37743774
    37753775        <listitem>
    3776           <para>Use <computeroutput>&lt;pwd file|-&gt;</computeroutput> to supply the password identifier to be checked. Either 
    3777           specify the absolute pathname of a password file on the host operating system, or <computeroutput>-</computeroutput> to 
     3776          <para>Use <computeroutput>&lt;pwd file|-&gt;</computeroutput> to supply the password identifier to be checked. Either
     3777          specify the absolute pathname of a password file on the host operating system, or <computeroutput>-</computeroutput> to
    37783778          prompt you for the password on the command line.</para>
    37793779        </listitem>
     
    37813781
    37823782  </sect1>
    3783  
     3783
    37843784  <sect1>
    37853785    <title>VBoxManage convertfromraw</title>
     
    40564056    remove</computeroutput> and specify the index and the target.</para>
    40574057
    4058     <para>The following is a list of the additional 
    4059     <computeroutput>usbfilter add</computeroutput> and 
    4060     <computeroutput>usbfilter modify</computeroutput> options, with detailed 
     4058    <para>The following is a list of the additional
     4059    <computeroutput>usbfilter add</computeroutput> and
     4060    <computeroutput>usbfilter modify</computeroutput> options, with detailed
    40614061    explanations on how to use them.</para>
    40624062
    40634063    <para><itemizedlist>
    40644064        <listitem>
    4065           <para><computeroutput>--action ignore|hold</computeroutput>Specifies 
    4066           whether devices that fit the filter description are allowed access by 
    4067           machines ("hold"), or have access denied ("ignore"). Applies to 
     4065          <para><computeroutput>--action ignore|hold</computeroutput>Specifies
     4066          whether devices that fit the filter description are allowed access by
     4067          machines ("hold"), or have access denied ("ignore"). Applies to
    40684068          global filters only.</para>
    40694069        </listitem>
     
    40714071        <listitem>
    40724072          <para><computeroutput>--active yes|no</computeroutput>Specifies whether
    4073           the USB Filter is active or temporarily disabled. For 
     4073          the USB Filter is active or temporarily disabled. For
    40744074          <computeroutput>usbfilter create</computeroutput> the default is
    40754075          active.</para>
     
    40774077
    40784078        <listitem>
    4079           <para><computeroutput>--vendorid &lt;XXXX&gt;|""</computeroutput>Specifies 
    4080            a vendor ID filter - the string representation for the exact matching 
     4079          <para><computeroutput>--vendorid &lt;XXXX&gt;|""</computeroutput>Specifies
     4080           a vendor ID filter - the string representation for the exact matching
    40814081           has the form XXXX, where X is the hex digit (including leading zeroes).</para>
    40824082        </listitem>
    40834083
    40844084        <listitem>
    4085           <para><computeroutput>--productid &lt;XXXX&gt;|""</computeroutput>Specifies 
    4086            a product ID filter - The string representation for the exact matching has 
     4085          <para><computeroutput>--productid &lt;XXXX&gt;|""</computeroutput>Specifies
     4086           a product ID filter - The string representation for the exact matching has
    40874087           the form XXXX, where X is the hex digit (including leading zeroes).</para>
    40884088        </listitem>
    40894089
    40904090        <listitem>
    4091           <para><computeroutput>--revision &lt;IIFF&gt;|""</computeroutput>Specifies 
     4091          <para><computeroutput>--revision &lt;IIFF&gt;|""</computeroutput>Specifies
    40924092           a revision ID filter - the string representation for the exact matching has
    40934093           the form IIFF, where I is the decimal digit of the integer part of the revision,
     
    40994099
    41004100        <listitem>
    4101           <para><computeroutput>--manufacturer &lt;string&gt;|""</computeroutput>Specifies 
     4101          <para><computeroutput>--manufacturer &lt;string&gt;|""</computeroutput>Specifies
    41024102           a manufacturer ID filter, as a string.</para>
    41034103        </listitem>
    41044104
    41054105        <listitem>
    4106           <para><computeroutput>--product &lt;string&gt;|""</computeroutput>Specifies 
     4106          <para><computeroutput>--product &lt;string&gt;|""</computeroutput>Specifies
    41074107           a product ID filter, as a string.</para>
    41084108        </listitem>
    41094109
    41104110        <listitem>
    4111           <para><computeroutput>--remote yes|no""</computeroutput>Specifies 
    4112            a remote filter - indicating whether the device is physically connected to a 
     4111          <para><computeroutput>--remote yes|no""</computeroutput>Specifies
     4112           a remote filter - indicating whether the device is physically connected to a
    41134113           remote VRDE client or to a local host machine. Applies to VM filters only.</para>
    41144114        </listitem>
    41154115
    41164116        <listitem>
    4117           <para><computeroutput>--serialnumber &lt;string&gt;|""</computeroutput>Specifies 
     4117          <para><computeroutput>--serialnumber &lt;string&gt;|""</computeroutput>Specifies
    41184118           a serial number filter, as a string.</para>
    41194119        </listitem>
    41204120
    41214121        <listitem>
    4122           <para><computeroutput>--maskedinterfaces &lt;XXXXXXXX&gt;</computeroutput>Specifies 
    4123            a masked interface filter, for hiding one or more USB interfaces from the guest. 
    4124            The value is a bit mask where the set bits correspond to the USB interfaces that 
     4122          <para><computeroutput>--maskedinterfaces &lt;XXXXXXXX&gt;</computeroutput>Specifies
     4123           a masked interface filter, for hiding one or more USB interfaces from the guest.
     4124           The value is a bit mask where the set bits correspond to the USB interfaces that
    41254125           should be hidden, or masked off. This feature only works on Linux hosts.</para>
    41264126        </listitem>
     
    41474147       <listitem>
    41484148         <para><computeroutput>&lt;uuid|vmname&gt;</computeroutput>
    4149          Specifies the UUID or name of the VM whose guest operating system will be 
     4149         Specifies the UUID or name of the VM whose guest operating system will be
    41504150         sharing folders with the host computer. Mandatory.</para>
    41514151       </listitem>
     
    41534153       <listitem>
    41544154         <para><computeroutput>--name &lt;name&gt;</computeroutput>
    4155          Specifies the name of the share. Each share has a unique name within the 
     4155         Specifies the name of the share. Each share has a unique name within the
    41564156         namespace of the host operating system. Mandatory.</para>
    41574157       </listitem>
     
    41594159       <listitem>
    41604160         <para><computeroutput>-hostpath &lt;hostpath&gt;</computeroutput>
    4161          Specifies the absolute path on the host operating system of the 
     4161         Specifies the absolute path on the host operating system of the
    41624162         folder/directory to be shared with the guest operating system.
    41634163         Mandatory.</para>
     
    41664166       <listitem>
    41674167         <para><computeroutput>-transient</computeroutput>
    4168          Specifies that the share is 'transient', meaning that it can be added 
    4169          and removed at runtime and does not persist after the VM has stopped. 
     4168         Specifies that the share is 'transient', meaning that it can be added
     4169         and removed at runtime and does not persist after the VM has stopped.
    41704170         Optional.</para>
    41714171       </listitem>
     
    41754175         Specifies that the share has only read-only access to files at the host path.</para>
    41764176
    4177          <para>By default, shared folders have read/write access to the files at the host 
    4178          path. More specifically, on Linux distros - shared folders are mounted with 
    4179          770 io permissions with root user and vboxsf as the group, and using this option 
     4177         <para>By default, shared folders have read/write access to the files at the host
     4178         path. More specifically, on Linux distros - shared folders are mounted with
     4179         770 io permissions with root user and vboxsf as the group, and using this option
    41804180         the io permissions change to 700. Optional.</para>
    41814181       </listitem>
     
    41834183       <listitem>
    41844184         <para><computeroutput>-automount</computeroutput>
    4185          Specifies that the share will be automatically mounted. On Linux distros, this will 
     4185         Specifies that the share will be automatically mounted. On Linux distros, this will
    41864186         be to either /media/USER/sf_&lt;name&gt; or /media/sf_&lt;name&gt; - depending on
    41874187         your guest OS. Where &lt;name&gt; is the share name. Optional.</para>
     
    42054205       <listitem>
    42064206         <para><computeroutput>&lt;uuid|vmname&gt;</computeroutput>
    4207          Specifies the UUID or name of the VM whose guest operating system is 
     4207         Specifies the UUID or name of the VM whose guest operating system is
    42084208         sharing folders with the host computer. Mandatory.</para>
    42094209       </listitem>
     
    42114211       <listitem>
    42124212         <para><computeroutput>--name &lt;name&gt;</computeroutput>
    4213          Specifies the name of the share to be removed. Each share has a unique name within the 
     4213         Specifies the name of the share to be removed. Each share has a unique name within the
    42144214         namespace of the host operating system. Mandatory.</para>
    42154215       </listitem>
     
    42174217       <listitem>
    42184218         <para><computeroutput>-transient</computeroutput>
    4219          Specifies that the share is 'transient', meaning that it can be added 
    4220          and removed at runtime and does not persist after the VM has stopped. 
     4219         Specifies that the share is 'transient', meaning that it can be added
     4220         and removed at runtime and does not persist after the VM has stopped.
    42214221         Optional.</para>
    42224222       </listitem>
     
    43614361           [--passwordfile &lt;file&gt; | --password &lt;password&gt;]
    43624362           [--domain &lt;domain&gt; ]
    4363            [-v|--verbose] [-q|quiet] 
     4363           [-v|--verbose] [-q|quiet]
    43644364    </screen>
    43654365
     
    43734373            </glossdef>
    43744374        </glossentry>
    4375    
     4375
    43764376        <glossentry>
    43774377          <glossterm><computeroutput>--username &lt;name&gt;</computeroutput></glossterm>
     
    43834383        <glossentry>
    43844384          <glossterm><computeroutput>--passwordfile &lt;file&gt;|--password</computeroutput></glossterm>
    4385           <glossdef><para>Specifies the absolute path on guest file system of password file containing the 
    4386             password for the specified user account or password for the specified user account. Optional. 
     4385          <glossdef><para>Specifies the absolute path on guest file system of password file containing the
     4386            password for the specified user account or password for the specified user account. Optional.
    43874387            If both are omitted, empty password is assumed.</para></glossdef>
    43884388        </glossentry>
     
    44084408        <listitem>
    44094409          <para><emphasis role="bold"><computeroutput>run</computeroutput></emphasis>
    4410           Executes a guest program - forwarding stdout, stderr and stdin to/from the host 
     4410          Executes a guest program - forwarding stdout, stderr and stdin to/from the host
    44114411          until it completes.</para>
    44124412          <screen>VBoxManage guestcontrol &lt;uuid|vmname&gt; run [common-options]
     
    44374437                <glossterm><computeroutput>--timeout &lt;msec&gt;</computeroutput></glossterm>
    44384438                <glossdef>
    4439                   <para>Specifies the maximum time (microseconds) that the executable can run,
    4440                   during which VBoxManage receives its output. Optional.
    4441                   If unspecified, VBoxManage waits indefinitely for the process to end, or an error occurs.</para>
    4442                 </glossdef>
    4443               </glossentry>
    4444 
    4445               <glossentry>
    4446                 <glossterm><computeroutput>-E|--putenv &lt;NAME&gt;=&lt;VALUE&gt;
    4447                 </computeroutput></glossterm>
    4448                 <glossdef>
    4449                   <para>Sets/modifies/unsets environment variable(s) in the environment in which the program will run. Optional.</para>
    4450                   <para>The guest process is created with the standard default guest OS environment.
    4451                   Use this option to modify that default environment. To set/modify a variable use:
    4452                   <computeroutput>&lt;NAME&gt;=&lt;VALUE&gt;</computeroutput>.
    4453                   To unset a variable use:
    4454                   <computeroutput>&lt;NAME&gt;=</computeroutput></para>
    4455                   <para>Any spaces in names/values should be enclosed by quotes. </para>
    4456                   <para>To set/modify/unset multiple variables, use multiple instances of the
    4457                   <computeroutput>--E|--putenv</computeroutput> option. </para>
    4458                 </glossdef>
    4459               </glossentry>
    4460 
    4461               <glossentry>
    4462                 <glossterm><computeroutput>--unquoted-args</computeroutput></glossterm>
    4463                 <glossdef>
    4464                   <para>Disables escaped double quoting (e.g. \"fred\") on arguments passed to the executed program. Optional.</para>
    4465                 </glossdef>
    4466               </glossentry>
    4467 
    4468               <glossentry>
    4469                 <glossterm><computeroutput>--ignore-operhaned-processes</computeroutput></glossterm>
    4470                 <glossdef>
    4471                   <para>Ignore orphaned processes. Not yet implemented. Optional.</para>
    4472                 </glossdef>
    4473               </glossentry>
    4474 
    4475               <glossentry>
    4476                 <glossterm><computeroutput>--profile</computeroutput></glossterm>
    4477                 <glossdef>
    4478                   <para>Use Profile. Not yet implemented. Optional.</para>
    4479                 </glossdef>
    4480               </glossentry>
    4481 
    4482               <glossentry>
    4483                 <glossterm><computeroutput>--no-wait-stdout|--wait-stdout</computeroutput></glossterm>
    4484                 <glossdef>
    4485                   <para>Does not wait/waits until the guest process ends and receives its exit code and reason/flags.
    4486                   In the case of --wait-stdout -  while the process runs, VBoxManage receives its stdout. Optional.</para>
    4487                 </glossdef>
    4488               </glossentry>
    4489 
    4490               <glossentry>
    4491                 <glossterm><computeroutput>--no-wait-stderr|--wait-stderr</computeroutput></glossterm>
    4492                 <glossdef>
    4493                   <para>Does not wait/waits until the guest process ends and receives its exit code and reason/flags.
    4494                   In case of --wait-stderr - while the process runs, VBoxManage receives its stderr. Optional.</para>
    4495                 </glossdef>
    4496               </glossentry>
    4497 
    4498               <glossentry>
    4499                 <glossterm><computeroutput>--dos2unix</computeroutput></glossterm>
    4500                 <glossdef><para>
    4501                   Converts output from DOS/Windows guests to UNIX/Linux-compatible line endings
    4502                   (CR + LF &rarr; LF). Not yet implemented. Optional.</para>
    4503                 </glossdef>
    4504               </glossentry>
    4505 
    4506               <glossentry>
    4507                 <glossterm><computeroutput>--unix2dos</computeroutput></glossterm>
    4508                 <glossdef><para>
    4509                   Converts output from a UNIX/Linux guests to DOS/Windows-compatible
    4510                   line endings (LF &rarr; CR + LF). Not yet implemented. Optional.</para>
    4511                 </glossdef>
    4512               </glossentry>
    4513 
    4514               <glossentry>
    4515                 <glossterm><computeroutput>[-- &lt;program/arg0&gt; [&lt;argument1&gt;] ... [&lt;argumentN&gt;]]</computeroutput></glossterm>
    4516                 <glossdef>
    4517                   <para>Specifies program name, followed by one or more arguments to pass to the program. Optional.</para>
    4518                   <para>Note: Any spaces in arguments should be enclosed by quotes.</para>
    4519                 </glossdef>
    4520               </glossentry>
    4521             </glosslist>
    4522 
    4523           <para><note>
    4524               <para>On Windows there are certain limitations for graphical
    4525               applications; please see <xref linkend="KnownIssues" /> for more
    4526               information.</para>
    4527             </note> Examples: <screen>VBoxManage --nologo guestcontrol "My VM" run --exe "/bin/ls"
    4528           --username foo --passwordfile bar.txt --wait-exit --wait-stdout -- -l /usr</screen> <screen>VBoxManage --nologo guestcontrol "My VM" run --exe "c:\\windows\\system32\\ipconfig.exe"
    4529           --username foo --passwordfile bar.txt --wait-exit --wait-stdout</screen> Note that
    4530           the double backslashes in the second example are only required on
    4531           Unix hosts.</para>
    4532 
    4533           <para><note>
    4534             <para>For certain commands a user name of an existing user account on the guest
    4535             must be specified; anonymous executions are not supported for security reasons. A
    4536             user account password, however, is optional and depends on the guest's OS security
    4537             policy or rules. If no password is specified for a given user name, an empty password
    4538             will be used. On certain OSes like Windows the security policy may needs to be adjusted
    4539             in order to allow user accounts with an empty password set. Also, global domain rules might
    4540             apply and therefore cannot be changed.</para>
    4541           </note></para>
    4542 
    4543           <para>Starting at VirtualBox 4.1.2 guest process execution by default is limited
    4544           to serve up to 5 guest processes at a time. If a new guest process gets started
    4545           which would exceed this limit, the oldest not running guest process will be discarded
    4546           in order to be able to run that new process. Also, retrieving output from this
    4547           old guest process will not be possible anymore then. If all 5 guest processes
    4548           are still active and running, starting a new guest process will result in an
    4549           appropriate error message.</para>
    4550 
    4551           <para>To raise or lower the guest process execution limit, either the guest
    4552           property <computeroutput>/VirtualBox/GuestAdd/VBoxService/--control-procs-max-kept</computeroutput>
    4553           or VBoxService' command line by specifying <computeroutput>--control-procs-max-kept</computeroutput>
    4554           needs to be modified. A restart of the guest OS is required afterwards. To serve unlimited
    4555           guest processes, a value of <computeroutput>0</computeroutput> needs to be set (not recommended).</para>
    4556         </listitem>
    4557 
    4558         <listitem>
    4559           <para><emphasis role="bold"><computeroutput>start</computeroutput></emphasis>
    4560           Executes a guest program until it completes.</para>
    4561           <screen>VBoxManage guestcontrol &lt;uuid|vmname&gt; start [common-options]
    4562            [--exe &lt;path to executable&gt;] [--timeout &lt;msec&gt;]
    4563            [-E|--putenv &lt;NAME&gt;[=&lt;VALUE&gt;]] [--unquoted-args]
    4564            [--ignore-operhaned-processes] [--profile]
    4565             -- &lt;program/arg0&gt; [argument1] ... [argumentN]]
    4566           </screen>
    4567 
    4568           <para>Where the options are: <glosslist>
    4569               <glossentry>
    4570                 <glossterm><computeroutput>&lt;uuid|vmname&gt;</computeroutput></glossterm>
    4571                 <glossdef>
    4572                   <para>Specifies the VM UUID or VM name. Mandatory.</para>
    4573                 </glossdef>
    4574               </glossentry>
    4575 
    4576               <glossentry>
    4577                 <glossterm><computeroutput>--exe &lt;path to executable&gt;</computeroutput></glossterm>
    4578                 <glossdef><para>Specifies the absolute path of the executable on the guest OS file system. Mandatory. e.g.:
    4579                   <computeroutput>C:\Windows\System32\calc.exe</computeroutput></para>
    4580                 </glossdef>
    4581               </glossentry>
    4582 
    4583               <glossentry>
    4584                 <glossterm><computeroutput>--timeout &lt;msec&gt;</computeroutput></glossterm>
    4585                 <glossdef>
    4586                   <para>Specifies the maximum time (microseconds) that the executable can run. Optional.
     4439                  <para>Specifies the maximum time (microseconds) that the executable can run,
     4440                  during which VBoxManage receives its output. Optional.
    45874441                  If unspecified, VBoxManage waits indefinitely for the process to end, or an error occurs.</para>
    45884442                </glossdef>
     
    46154469                <glossterm><computeroutput>--ignore-operhaned-processes</computeroutput></glossterm>
    46164470                <glossdef>
     4471                  <para>Ignore orphaned processes. Not yet implemented. Optional.</para>
     4472                </glossdef>
     4473              </glossentry>
     4474
     4475              <glossentry>
     4476                <glossterm><computeroutput>--profile</computeroutput></glossterm>
     4477                <glossdef>
     4478                  <para>Use Profile. Not yet implemented. Optional.</para>
     4479                </glossdef>
     4480              </glossentry>
     4481
     4482              <glossentry>
     4483                <glossterm><computeroutput>--no-wait-stdout|--wait-stdout</computeroutput></glossterm>
     4484                <glossdef>
     4485                  <para>Does not wait/waits until the guest process ends and receives its exit code and reason/flags.
     4486                  In the case of --wait-stdout -  while the process runs, VBoxManage receives its stdout. Optional.</para>
     4487                </glossdef>
     4488              </glossentry>
     4489
     4490              <glossentry>
     4491                <glossterm><computeroutput>--no-wait-stderr|--wait-stderr</computeroutput></glossterm>
     4492                <glossdef>
     4493                  <para>Does not wait/waits until the guest process ends and receives its exit code and reason/flags.
     4494                  In case of --wait-stderr - while the process runs, VBoxManage receives its stderr. Optional.</para>
     4495                </glossdef>
     4496              </glossentry>
     4497
     4498              <glossentry>
     4499                <glossterm><computeroutput>--dos2unix</computeroutput></glossterm>
     4500                <glossdef><para>
     4501                  Converts output from DOS/Windows guests to UNIX/Linux-compatible line endings
     4502                  (CR + LF &rarr; LF). Not yet implemented. Optional.</para>
     4503                </glossdef>
     4504              </glossentry>
     4505
     4506              <glossentry>
     4507                <glossterm><computeroutput>--unix2dos</computeroutput></glossterm>
     4508                <glossdef><para>
     4509                  Converts output from a UNIX/Linux guests to DOS/Windows-compatible
     4510                  line endings (LF &rarr; CR + LF). Not yet implemented. Optional.</para>
     4511                </glossdef>
     4512              </glossentry>
     4513
     4514              <glossentry>
     4515                <glossterm><computeroutput>[-- &lt;program/arg0&gt; [&lt;argument1&gt;] ... [&lt;argumentN&gt;]]</computeroutput></glossterm>
     4516                <glossdef>
     4517                  <para>Specifies program name, followed by one or more arguments to pass to the program. Optional.</para>
     4518                  <para>Note: Any spaces in arguments should be enclosed by quotes.</para>
     4519                </glossdef>
     4520              </glossentry>
     4521            </glosslist>
     4522
     4523          <para><note>
     4524              <para>On Windows there are certain limitations for graphical
     4525              applications; please see <xref linkend="KnownIssues" /> for more
     4526              information.</para>
     4527            </note> Examples: <screen>VBoxManage --nologo guestcontrol "My VM" run --exe "/bin/ls"
     4528          --username foo --passwordfile bar.txt --wait-exit --wait-stdout -- -l /usr</screen> <screen>VBoxManage --nologo guestcontrol "My VM" run --exe "c:\\windows\\system32\\ipconfig.exe"
     4529          --username foo --passwordfile bar.txt --wait-exit --wait-stdout</screen> Note that
     4530          the double backslashes in the second example are only required on
     4531          Unix hosts.</para>
     4532
     4533          <para><note>
     4534            <para>For certain commands a user name of an existing user account on the guest
     4535            must be specified; anonymous executions are not supported for security reasons. A
     4536            user account password, however, is optional and depends on the guest's OS security
     4537            policy or rules. If no password is specified for a given user name, an empty password
     4538            will be used. On certain OSes like Windows the security policy may needs to be adjusted
     4539            in order to allow user accounts with an empty password set. Also, global domain rules might
     4540            apply and therefore cannot be changed.</para>
     4541          </note></para>
     4542
     4543          <para>Starting at VirtualBox 4.1.2 guest process execution by default is limited
     4544          to serve up to 5 guest processes at a time. If a new guest process gets started
     4545          which would exceed this limit, the oldest not running guest process will be discarded
     4546          in order to be able to run that new process. Also, retrieving output from this
     4547          old guest process will not be possible anymore then. If all 5 guest processes
     4548          are still active and running, starting a new guest process will result in an
     4549          appropriate error message.</para>
     4550
     4551          <para>To raise or lower the guest process execution limit, either the guest
     4552          property <computeroutput>/VirtualBox/GuestAdd/VBoxService/--control-procs-max-kept</computeroutput>
     4553          or VBoxService' command line by specifying <computeroutput>--control-procs-max-kept</computeroutput>
     4554          needs to be modified. A restart of the guest OS is required afterwards. To serve unlimited
     4555          guest processes, a value of <computeroutput>0</computeroutput> needs to be set (not recommended).</para>
     4556        </listitem>
     4557
     4558        <listitem>
     4559          <para><emphasis role="bold"><computeroutput>start</computeroutput></emphasis>
     4560          Executes a guest program until it completes.</para>
     4561          <screen>VBoxManage guestcontrol &lt;uuid|vmname&gt; start [common-options]
     4562           [--exe &lt;path to executable&gt;] [--timeout &lt;msec&gt;]
     4563           [-E|--putenv &lt;NAME&gt;[=&lt;VALUE&gt;]] [--unquoted-args]
     4564           [--ignore-operhaned-processes] [--profile]
     4565            -- &lt;program/arg0&gt; [argument1] ... [argumentN]]
     4566          </screen>
     4567
     4568          <para>Where the options are: <glosslist>
     4569              <glossentry>
     4570                <glossterm><computeroutput>&lt;uuid|vmname&gt;</computeroutput></glossterm>
     4571                <glossdef>
     4572                  <para>Specifies the VM UUID or VM name. Mandatory.</para>
     4573                </glossdef>
     4574              </glossentry>
     4575
     4576              <glossentry>
     4577                <glossterm><computeroutput>--exe &lt;path to executable&gt;</computeroutput></glossterm>
     4578                <glossdef><para>Specifies the absolute path of the executable on the guest OS file system. Mandatory. e.g.:
     4579                  <computeroutput>C:\Windows\System32\calc.exe</computeroutput></para>
     4580                </glossdef>
     4581              </glossentry>
     4582
     4583              <glossentry>
     4584                <glossterm><computeroutput>--timeout &lt;msec&gt;</computeroutput></glossterm>
     4585                <glossdef>
     4586                  <para>Specifies the maximum time (microseconds) that the executable can run. Optional.
     4587                  If unspecified, VBoxManage waits indefinitely for the process to end, or an error occurs.</para>
     4588                </glossdef>
     4589              </glossentry>
     4590
     4591              <glossentry>
     4592                <glossterm><computeroutput>-E|--putenv &lt;NAME&gt;=&lt;VALUE&gt;
     4593                </computeroutput></glossterm>
     4594                <glossdef>
     4595                  <para>Sets/modifies/unsets environment variable(s) in the environment in which the program will run. Optional.</para>
     4596                  <para>The guest process is created with the standard default guest OS environment.
     4597                  Use this option to modify that default environment. To set/modify a variable use:
     4598                  <computeroutput>&lt;NAME&gt;=&lt;VALUE&gt;</computeroutput>.
     4599                  To unset a variable use:
     4600                  <computeroutput>&lt;NAME&gt;=</computeroutput></para>
     4601                  <para>Any spaces in names/values should be enclosed by quotes. </para>
     4602                  <para>To set/modify/unset multiple variables, use multiple instances of the
     4603                  <computeroutput>--E|--putenv</computeroutput> option. </para>
     4604                </glossdef>
     4605              </glossentry>
     4606
     4607              <glossentry>
     4608                <glossterm><computeroutput>--unquoted-args</computeroutput></glossterm>
     4609                <glossdef>
     4610                  <para>Disables escaped double quoting (e.g. \"fred\") on arguments passed to the executed program. Optional.</para>
     4611                </glossdef>
     4612              </glossentry>
     4613
     4614              <glossentry>
     4615                <glossterm><computeroutput>--ignore-operhaned-processes</computeroutput></glossterm>
     4616                <glossdef>
    46174617                  <para>Ignores orphaned processes. Not yet implemented. Optional.</para>
    46184618                </glossdef>
     
    46724672        <listitem>
    46734673          <para><emphasis role="bold"><computeroutput>copyfrom</computeroutput></emphasis>
    4674           Copies files from the guest to the host file system. 
     4674          Copies files from the guest to the host file system.
    46754675          (Note - only with Guest Additions 4.0 or later installed).</para>
    46764676
     
    46914691                <glossterm><computeroutput>--dryrun</computeroutput></glossterm>
    46924692                <glossdef>
    4693                   <para>Instructs VBoxManage to perform a dry run instead of an actual file copying 
     4693                  <para>Instructs VBoxManage to perform a dry run instead of an actual file copying
    46944694                  operation. Optional. </para>
    46954695                </glossdef>
     
    47344734        <listitem>
    47354735          <para><emphasis role="bold"><computeroutput>copyto</computeroutput></emphasis>
    4736           Copies files from the host to the guest file system. 
     4736          Copies files from the host to the guest file system.
    47374737          (Note - only with Guest Additions 4.0 or later installed).</para>
    47384738
     
    47534753                <glossterm><computeroutput>--dryrun</computeroutput></glossterm>
    47544754                <glossdef>
    4755                   <para>Instructs VBoxManage to perform a dry run instead of an actual file copying 
     4755                  <para>Instructs VBoxManage to perform a dry run instead of an actual file copying
    47564756                  operation. Optional. </para>
    47574757                </glossdef>
     
    47964796        <listitem>
    47974797          <para><emphasis role="bold"><computeroutput>md|mkdir|createdir|createdirectory</computeroutput></emphasis>
    4798           Creates one or more directory(ies) on the guest file system. 
     4798          Creates one or more directory(ies) on the guest file system.
    47994799          (Note - only with Guest Additions 4.0 or later installed).</para>
    48004800
     
    48134813                <glossterm><computeroutput>--parents</computeroutput></glossterm>
    48144814                <glossdef>
    4815                   <para>Creates any absent parent directory(ies) of the specified directory. Optional.</para> 
     4815                  <para>Creates any absent parent directory(ies) of the specified directory. Optional.</para>
    48164816                  <para>e.g. If specified directory is <computeroutput>D:\Foo\Bar</computeroutput>
    4817                   and <computeroutput>D:\Foo</computeroutput> is absent, it will   
    4818                   be created. In such a case, had the <computeroutput>--parents</computeroutput> 
     4817                  and <computeroutput>D:\Foo</computeroutput> is absent, it will
     4818                  be created. In such a case, had the <computeroutput>--parents</computeroutput>
    48194819                  option not been used, this command would have failed.</para>
    48204820                </glossdef>
     
    48244824                <glossterm><computeroutput>--mode &lt;mode&gt;</computeroutput></glossterm>
    48254825                <glossdef>
    4826                   <para>Specifies the permission mode on the specified directory(ies) (and any parents, 
     4826                  <para>Specifies the permission mode on the specified directory(ies) (and any parents,
    48274827                  where <computeroutput>--parents</computeroutput> option used).
    4828                   Currently octal modes (e.g. <computeroutput>0755</computeroutput>) only are 
     4828                  Currently octal modes (e.g. <computeroutput>0755</computeroutput>) only are
    48294829                  supported.</para>
    48304830                </glossdef>
     
    48354835                <glossdef>
    48364836                  <para>Specifies list of absolute path(s) of directory(ies) to be created on
    4837                   guest file system. Mandatory. 
     4837                  guest file system. Mandatory.
    48384838                  e.g. <computeroutput>D:\Foo\Bar</computeroutput>.</para>
    48394839                  <para>All parent directories must already exist
    4840                   unless switch <computeroutput>--parents</computeroutput> used. 
    4841                   (e.g. in the above example <computeroutput>D:\Foo</computeroutput>). 
     4840                  unless switch <computeroutput>--parents</computeroutput> used.
     4841                  (e.g. in the above example <computeroutput>D:\Foo</computeroutput>).
    48424842                  The specified user must have sufficient rights to create the
    4843                   specified directory(ies), and any parents that need 
     4843                  specified directory(ies), and any parents that need
    48444844                  to be created.</para>
    48454845                </glossdef>
     
    48564856           [--recursive|-R]
    48574857            &lt;guest-dir0&gt; [&lt;guest-dir1&gt; [...]]
    4858           </screen>   
     4858          </screen>
    48594859
    48604860          <para>Where the parameters are: <glosslist>
     
    48774877                <glossdef>
    48784878                  <para>Specifies list of the absolute path(s) of directory(ies) to be deleted on
    4879                   guest file system. Mandatory. Wildcards are allowed. e.g. <computeroutput>D:\Foo\*Bar</computeroutput>. 
     4879                  guest file system. Mandatory. Wildcards are allowed. e.g. <computeroutput>D:\Foo\*Bar</computeroutput>.
    48804880                  The specified user must have sufficient rights to delete the
    48814881                  specified directory(ies).</para>
     
    49134913                <glossdef>
    49144914                  <para>Specifies list of absolute path(s) of file(s) to be deleted on guest file system. Mandatory.
    4915                    Wildcards are allowed. e.g. <computeroutput>D:\Foo\Bar\text*.txt</computeroutput>. 
     4915                   Wildcards are allowed. e.g. <computeroutput>D:\Foo\Bar\text*.txt</computeroutput>.
    49164916                   The specified user should have sufficient rights to delete the specified file(s).</para>
    49174917                </glossdef>
     
    49404940                <glossterm><computeroutput>&lt;guest-source0&gt; [&lt;guest-source1&gt; [...]]</computeroutput></glossterm>
    49414941                <glossdef>
    4942                   <para>Specifies absolute path(s) of file(s) and/or single directory to be moved/renamed on guest 
     4942                  <para>Specifies absolute path(s) of file(s) and/or single directory to be moved/renamed on guest
    49434943                  file system. Mandatory.
    4944                   Wildcards are allowed in file names(s). The specified user should have sufficient rights to 
     4944                  Wildcards are allowed in file names(s). The specified user should have sufficient rights to
    49454945                  access the specified file(s).</para>
    49464946                </glossdef>
     
    49514951                <glossdef>
    49524952                  <para>Specifies the absolute path of the destination file/directory to which the file(s)
    4953                   are to be moved. Mandatory. If only one file to be moved, &lt;dest&gt; can be file or directory, 
     4953                  are to be moved. Mandatory. If only one file to be moved, &lt;dest&gt; can be file or directory,
    49544954                  else it must be a directory.
    49554955                  The specified user must have sufficient rights to access the destination file/directory.</para>
     
    49624962          <para><emphasis role="bold"><computeroutput>mktemp|createtemp|createtemporary</computeroutput></emphasis>
    49634963          Creates a temporary file/directory on the guest file system, to assist subsequent
    4964           copying of files from the host to the guest file systems. By default, the file/directory 
     4964          copying of files from the host to the guest file systems. By default, the file/directory
    49654965          is created in the guest's platform specific temp directory. Not currently supported.
    49664966          (Only with installed Guest Additions 4.2 and later).</para>
     
    49684968            <screen>VBoxManage guestcontrol &lt;uuid|vmname&gt; mktemp|createtemp|createtemporary [common-options]
    49694969           [--directory] [--secure] [--mode &lt;mode&gt;] [--tmpdir &lt;directory&gt;]
    4970             &lt;template&gt; 
     4970            &lt;template&gt;
    49714971            </screen>
    49724972
     
    49914991                  <para>
    49924992                  Enforces secure file/directory creation. Optional. The permission mode is set to
    4993                   <computeroutput>0755</computeroutput>. Operation fails if it cannot be performed securely. 
     4993                  <computeroutput>0755</computeroutput>. Operation fails if it cannot be performed securely.
    49944994                  </para>
    49954995                </glossdef>
     
    49994999                <glossterm><computeroutput>--mode &lt;mode&gt;</computeroutput></glossterm>
    50005000                <glossdef>
    5001                   <para>Specifies the permission mode of the specified directory. Optional. 
    5002                   Currently only octal modes (e.g. <computeroutput>0755</computeroutput>) 
     5001                  <para>Specifies the permission mode of the specified directory. Optional.
     5002                  Currently only octal modes (e.g. <computeroutput>0755</computeroutput>)
    50035003                  are supported.</para>
    50045004                </glossdef>
     
    50095009                <glossdef>
    50105010                  <para>
    5011                   Specifies the absolute path of the directory on the guest file system into which the 
     5011                  Specifies the absolute path of the directory on the guest file system into which the
    50125012                  file/directory specified in will be created. Optional.
    5013                   If unspecified, the platform-specific temp directory is used. 
     5013                  If unspecified, the platform-specific temp directory is used.
    50145014                  </para>
    50155015                </glossdef>
     
    50195019                <glossterm><computeroutput>&lt;template&gt;</computeroutput></glossterm>
    50205020                <glossdef>
    5021                   <para>Specifies a file name without a directory path, containing at least one sequence comprising 
    5022                    three consecutive 'X' characters, or ending in 'X'. Mandatory. 
     5021                  <para>Specifies a file name without a directory path, containing at least one sequence comprising
     5022                   three consecutive 'X' characters, or ending in 'X'. Mandatory.
    50235023                  </para>
    50245024                </glossdef>
     
    50635063    <para>The "common-options" are:</para>
    50645064    <screen>
    5065             [-v|--verbose] [-q|--quiet] 
     5065            [-v|--verbose] [-q|--quiet]
    50665066    </screen>
    50675067
     
    51365136              <glossterm><computeroutput>--session-name &lt;name or pattern&gt;</computeroutput></glossterm>
    51375137              <glossdef>
    5138                 <para>Specifies the guest session by its name, or multiple sessions 
     5138                <para>Specifies the guest session by its name, or multiple sessions
    51395139                using a pattern containing wildcards. Optional.</para>
    51405140              </glossdef>
     
    51925192        <listitem>
    51935193          <para><emphasis role="bold"><computeroutput>updatega|updateadditions|updateguestadditions</computeroutput></emphasis>
    5194           Ugrades Guest Additions already installed on the guest. 
     5194          Ugrades Guest Additions already installed on the guest.
    51955195          (Only already installed Guest Additions 4.0 and later).</para>
    51965196
    51975197          <screen>VBoxManage guestcontrol &lt;uuid|vmname&gt; updatega|updateadditions|updateguestadditions [common-options]
    51985198           [--source &lt;New .ISO path&gt;]
    5199            [--wait-start] 
     5199           [--wait-start]
    52005200           [-- &lt;argument0&gt; [&lt;argument1&gt; [...]]]</screen>
    52015201
     
    52185218                <glossterm><computeroutput>--wait-start</computeroutput></glossterm>
    52195219                <glossdef>
    5220                   <para>Indicates that VBoxManage starts the usual updating process on the guest and then waits 
     5220                  <para>Indicates that VBoxManage starts the usual updating process on the guest and then waits
    52215221                   until the actual Guest Additions updating begins, at which point VBoxManage self-terminates. Optional.</para>
    5222                   <para>Default behavior is that VBoxManage waits for completion of the Guest Additions update before 
    5223                    terminating. Use of this option is sometimes necessary, as a running VBoxManage 
     5222                  <para>Default behavior is that VBoxManage waits for completion of the Guest Additions update before
     5223                   terminating. Use of this option is sometimes necessary, as a running VBoxManage
    52245224                   can affect the interaction between the installer and the guest OS.</para>
    52255225                </glossdef>
     
    54135413    <title>VBoxManage natnetwork</title>
    54145414
    5415     <para>NAT networks use the Network Address Translation (NAT) service - which works in a 
     5415    <para>NAT networks use the Network Address Translation (NAT) service - which works in a
    54165416    similar way to a home router. It groups systems using it into a network and prevents
    5417     outside systems from directly accessing those inside, while letting systems inside communicate 
     5417    outside systems from directly accessing those inside, while letting systems inside communicate
    54185418    with each other and outside systems using TCP and UDP over IPv4 and IPv6.</para>
    54195419
    5420     <para>A NAT service is attached to an internal network. Virtual machines to make use of one 
    5421     should be attached to it. The name of an internal network is chosen when the NAT service is 
    5422     created, and the internal network will be created if it does not already exist. 
     5420    <para>A NAT service is attached to an internal network. Virtual machines to make use of one
     5421    should be attached to it. The name of an internal network is chosen when the NAT service is
     5422    created, and the internal network will be created if it does not already exist.
    54235423    An example command to create a NAT network:</para>
    54245424
     
    54265426
    54275427    <para>Here, "natnet1" is the name of the internal network to be used and "192.168.15.0/24" is the
    5428     network address and mask of the NAT service interface. By default, in this static configuration 
     5428    network address and mask of the NAT service interface. By default, in this static configuration
    54295429    - the gateway will be assigned the address 192.168.15.1 (the address after the interface address),
    54305430    though this is subject to change.</para>
     
    54455445                         [--port-forward-6 &lt;rule&gt;]
    54465446                         [--loopback-6 &lt;rule&gt;]
    5447     </screen> 
    5448 
    5449 
    5450     <para><emphasis role="bold"><computeroutput>VBoxManage natnetwork add</computeroutput></emphasis> 
    5451     Creates a new internal network interface, and adds a NAT network service. This command is a 
     5447    </screen>
     5448
     5449
     5450    <para><emphasis role="bold"><computeroutput>VBoxManage natnetwork add</computeroutput></emphasis>
     5451    Creates a new internal network interface, and adds a NAT network service. This command is a
    54525452    prerequisite for enabling attachment of VMs to the NAT network. Parameters:</para>
    54535453
     
    54635463          <glossterm><computeroutput>--network &lt;network&gt;</computeroutput></glossterm>
    54645464          <glossdef>
    5465             <para>Where &lt;network&gt; specifies the static(default)/DHCP network address and mask of 
     5465            <para>Where &lt;network&gt; specifies the static(default)/DHCP network address and mask of
    54665466            the NAT service interface.</para>
    54675467          </glossdef>
     
    54765476          <glossterm><computeroutput>--dhcp on|off</computeroutput></glossterm>
    54775477          <glossdef>
    5478             <para>Enables/disables DHCP server specified by --netname; its use also indicates that it 
     5478            <para>Enables/disables DHCP server specified by --netname; its use also indicates that it
    54795479            is a DHCP server.</para>
    54805480          </glossdef>
     
    55115511        </glossentry>
    55125512      </glosslist>
    5513     </para> 
     5513    </para>
    55145514
    55155515    <screen>VBoxManage natnetwork remove --netname &lt;name&gt; </screen>
     
    55285528        </glossentry>
    55295529      </glosslist>
    5530     </para> 
     5530    </para>
    55315531
    55325532    <screen>VBoxManage natnetwork modify --netname &lt;name&gt;
     
    55415541    </screen>
    55425542
    5543     <para><emphasis role="bold"><computeroutput>VBoxManage natnetwork modify</computeroutput></emphasis> 
     5543    <para><emphasis role="bold"><computeroutput>VBoxManage natnetwork modify</computeroutput></emphasis>
    55445544    Modifies an existing NAT network service, parameters:</para>
    55455545
     
    55555555          <glossterm><computeroutput>--network &lt;network&gt;</computeroutput></glossterm>
    55565556          <glossdef>
    5557             <para>Where &lt;network&gt; specifies the new static(default)/DHCP network address and mask 
     5557            <para>Where &lt;network&gt; specifies the new static(default)/DHCP network address and mask
    55585558            of the NAT service interface.</para>
    55595559          </glossdef>
     
    56025602        </glossentry>
    56035603      </glosslist>
    5604     </para> 
     5604    </para>
    56055605
    56065606    <screen>VBoxManage natnetwork start --netname &lt;name&gt;
    56075607    </screen>
    56085608
    5609     <para><emphasis  role="bold"><computeroutput>VBoxManage natnetwork start</computeroutput></emphasis> 
     5609    <para><emphasis  role="bold"><computeroutput>VBoxManage natnetwork start</computeroutput></emphasis>
    56105610    Starts specified NAT network service and any associated DHCP server, parameters:</para>
    56115611
     
    56245624    </screen>
    56255625
    5626     <para><emphasis  role="bold"><computeroutput>VBoxManage natnetwork stop</computeroutput></emphasis> 
     5626    <para><emphasis  role="bold"><computeroutput>VBoxManage natnetwork stop</computeroutput></emphasis>
    56275627    Stops specified NAT network service and any DHCP server, parameters:</para>
    56285628
     
    56405640    <screen>VBoxManage natnetwork list [&lt;pattern&gt;] </screen>
    56415641
    5642     <para><emphasis  role="bold"><computeroutput>VBoxManage natnetwork list</computeroutput></emphasis> 
     5642    <para><emphasis  role="bold"><computeroutput>VBoxManage natnetwork list</computeroutput></emphasis>
    56435643    Lists all NAT network services with optional filtering, parameters:</para>
    56445644
     
    57665766    <computeroutput>VBoxManage dhcpserver add</computeroutput>, you can use
    57675767    <computeroutput>VBoxManage dhcpserver modify</computeroutput> for a given
    5768     network or host-only interface name. This has the same parameters as 
     5768    network or host-only interface name. This has the same parameters as
    57695769    <computeroutput>VBoxManage dhcpserver add</computeroutput>.</para>
    57705770  </sect1>
     
    57735773    <title>VBoxManage usbdevsource</title>
    57745774
    5775     <para>The "usbdevsource" commands enables you to add and remove USB devices 
     5775    <para>The "usbdevsource" commands enables you to add and remove USB devices
    57765776    globally.</para>
    57775777
     
    57855785    <para>Where the command line options are:<itemizedlist>
    57865786        <listitem>
    5787           <para>&lt;source name&gt; specifies the ID of the 'source' USB 
     5787          <para>&lt;source name&gt; specifies the ID of the 'source' USB
    57885788          device to be added. Mandatory.</para>
    57895789        </listitem>
    57905790        <listitem>
    5791           <para>--backend &lt;backend&gt; specifies the USB proxy service 
     5791          <para>--backend &lt;backend&gt; specifies the USB proxy service
    57925792          backend to use. Mandatory.</para>
    57935793        </listitem>
    57945794        <listitem>
    5795           <para>--address &lt;address&gt; specifies the backend specific 
     5795          <para>--address &lt;address&gt; specifies the backend specific
    57965796          address. Mandatory.</para>
    57975797        </listitem>
     
    58055805    <para>Where the command line options are:<itemizedlist>
    58065806        <listitem>
    5807           <para>&lt;source name&gt; specifies the ID of the 'source' USB 
     5807          <para>&lt;source name&gt; specifies the ID of the 'source' USB
    58085808          device to be removed. Mandatory.</para>
    58095809        </listitem>
Note: See TracChangeset for help on using the changeset viewer.

© 2024 Oracle Support Privacy / Do Not Sell My Info Terms of Use Trademark Policy Automated Access Etiquette