~ubuntu-branches/ubuntu/quantal/virtualbox/quantal

« back to all changes in this revision

Viewing changes to doc/manual/en_US/user_VBoxManage.xml

  • Committer: Package Import Robot
  • Author(s): Felix Geyer
  • Date: 2012-05-29 10:09:31 UTC
  • mfrom: (3.1.15 sid)
  • Revision ID: package-import@ubuntu.com-20120529100931-2xayrbh5hyzm6e9p
Tags: 4.1.16-dfsg-1
* New upstream release.
* Drop 37-fix-build-gcc47.patch, fixed upstream.

Show diffs side-by-side

added added

removed removed

Lines of Context:
615
615
          </listitem>
616
616
 
617
617
          <listitem>
 
618
            <para><computeroutput>--nicbootprio&lt;1-N&gt; 
 
619
            &lt;priority&gt;</computeroutput>: This specifies the order in which 
 
620
            NICs are tried for booting over the network (using PXE). The 
 
621
            priority is an integer in the 0 to 4 range. Priority 1 is the 
 
622
            highest, priority 4 is low. Priority 0, which is the default unless 
 
623
            otherwise specified, is the lowest.
 
624
            </para>
 
625
            <para> Note that this option only has effect when the Intel PXE boot
 
626
            ROM is used.
 
627
            </para>
 
628
          </listitem>
 
629
 
 
630
          <listitem>
618
631
            <para><computeroutput>--boot&lt;1-4&gt;
619
632
            none|floppy|dvd|disk|net</computeroutput>: This specifies the boot
620
633
            order for the virtual machine. There are four "slots", which the
2144
2157
        </listitem>
2145
2158
 
2146
2159
        <listitem>
2147
 
          <para>The <computeroutput>--resize</computeroutput> option allows you
2148
 
          to change the capacity of an existing image; this adjusts the
 
2160
          <para>The <computeroutput>--resize x</computeroutput> option (where x
 
2161
          is the desired new total space in <emphasis role="bold">megabytes</emphasis>)
 
2162
          allows you to change the capacity of an existing image; this adjusts the
2149
2163
          <emphasis>logical</emphasis> size of a virtual disk without affecting
2150
2164
          the physical size much.<footnote>
2151
2165
              <para>Image resizing was added with VirtualBox 4.0.</para>
2152
 
            </footnote> This currently works only for expanding the capacity of
2153
 
          VDI and VHD formats, and only for the dynamically allocated variants.
 
2166
            </footnote> This currently works only for VDI and VHD formats, and only
 
2167
          for the dynamically allocated variants, and can only be used to expand
 
2168
          (not shrink) the capacity.
2154
2169
          For example, if you originally created a 10G disk which is now full,
2155
2170
          you can use the <computeroutput>--resize 15360</computeroutput>
2156
 
          command to add 5 GByte more space to the virtual disk without
2157
 
          having to create a new image and copy all data from within a virtual
2158
 
          machine.</para>
 
2171
          command to change the capacity to 15G (15,360MB) without having to create a new
 
2172
          image and copy all data from within a virtual machine. Note however that
 
2173
          this only changes the drive capacity; you will typically next need to use
 
2174
          a partition management tool inside the guest to adjust the main partition
 
2175
          to fill the drive.</para><para>The <computeroutput>--resizebyte x</computeroutput>
 
2176
          option does almost the same thing, except that x is expressed in bytes
 
2177
          instead of megabytes.</para>
2159
2178
        </listitem>
2160
2179
      </itemizedlist></para>
2161
2180
  </sect1>