VirtualBox

Changeset 35090 in vbox


Ignore:
Timestamp:
Dec 14, 2010 2:50:11 PM (14 years ago)
Author:
vboxsync
svn:sync-xref-src-repo-rev:
68922
Message:

Manual: vboxmanage list and extension packs updates

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

Legend:

Unmodified
Added
Removed

  • trunk/doc/manual/en_US/user_Introduction.xml

    r35008 r35090  
    6969        solution on a real machine can be a tedious task. With VirtualBox,
    7070        such a complex setup (then often called an "appliance") can be packed
    71         into a virtual machine. Installing and running a mail server
    72         becomes as easy as importing such an appliance into VirtualBox.</para>
     71        into a virtual machine. Installing and running a mail server becomes
     72        as easy as importing such an appliance into VirtualBox.</para>
    7373      </listitem>
    7474
    … …  
    503503
    504504  <sect1 id="intro-installing">
    505     <title>Installing VirtualBox</title>
     505    <title>Installing VirtualBox and extension packs</title>
    506506
    507507    <para>VirtualBox comes in many different packages, and installation
    508     depends on your host platform. If you have installed software before,
    509     installation should be straightforward: on each host platform, VirtualBox
    510     uses the installation method that is most common and easy to use. If you
    511     run into trouble or have special requirements, please refer to <xref
    512     linkend="installation" /> for details about the various installation
     508    depends on your host operating system. If you have installed software
     509    before, installation should be straightforward: on each host platform,
     510    VirtualBox uses the installation method that is most common and easy to
     511    use. If you run into trouble or have special requirements, please refer to
     512    <xref linkend="installation" /> for details about the various installation
    513513    methods.</para>
    514514
    … …  
    516516    components.<orderedlist>
    517517        <listitem>
    518           <para>The base package consists of all open source components and is
     518          <para>The base package consists of all open-source components and is
    519519          licensed under the GNU General Public License V2.</para>
    520520        </listitem>
    … …  
    543543
    544544          <para>VirtualBox extension packages have a
    545           <computeroutput>.vbox-extpack</computeroutput> file name extension. To
    546           install an extension, simply double-click on package file, and the
    547           VirtualBox Manager will guide you through the required steps.</para>
     545          <computeroutput>.vbox-extpack</computeroutput> file name extension.
     546          To install an extension, simply double-click on the package file,
     547          and the VirtualBox Manager will guide you through the required
     548          steps. </para>
     549
     550          <para>To view the extension packs that are currently installed,
     551          please start the VirtualBox Manager (see the next section). From the
     552          "File" menu, please select "Preferences". In the window that shows
     553          up, go to the "Extensions" category which shows you the extensions
     554          which are currently installed and allows you to remove a package or
     555          add a new one.</para>
     556
     557          <para>Alternatively you can use VBoxManage on the command line: see
     558          <xref linkend="vboxmanage-extpack" /> for details.</para>
    548559        </listitem>
    549560      </orderedlist></para>
    … …  
    815826
    816827    <sect2>
    817       <title>Starting a VM for the first time</title>
     828      <title>Starting a new VM for the first time</title>
    818829
    819830      <para>When a VM gets started for the first time, another wizard -- the
    … …  
    12571268            snapshots. By restoring a snapshot, you go back (or forward) in
    12581269            time: the current state of the machine is lost, and the machine is
    1259             restored to exactly the same state as it was when the snapshot
    1260             was taken.<footnote>
     1270            restored to exactly the same state as it was when the snapshot was
     1271            taken.<footnote>
    12611272                <para>Both the terminology and the functionality of restoring
    12621273                snapshots has changed with VirtualBox 3.1. Before that
    … …  
    14551466      </orderedlist></para>
    14561467
    1457     <para>To <emphasis role="bold">import</emphasis> an appliance in one of the
    1458     above formats, simply double-click on the OVF/OVA file.<footnote>
     1468    <para>To <emphasis role="bold">import</emphasis> an appliance in one of
     1469    the above formats, simply double-click on the OVF/OVA file.<footnote>
    14591470        <para>Starting with version 4.0, VirtualBox creates file type
    14601471        associations for OVF and OVA files on your host operating

  • trunk/doc/manual/en_US/user_VBoxManage.xml

    r35038 r35090  
    177177
    178178        <listitem>
    179           <para><computeroutput>hdds</computeroutput>,
    180           <computeroutput>dvds</computeroutput> and
    181           <computeroutput>floppies</computeroutput> all give you information
    182           about virtual disk images currently registered in VirtualBox,
    183           including all their settings, the unique identifiers (UUIDs)
    184           associated with them by VirtualBox and all files associated with
    185           them.</para>
    186         </listitem>
    187 
    188         <listitem>
    189179          <para><computeroutput>ostypes</computeroutput> lists all guest
    190180          operating systems presently known to VirtualBox, along with the
    … …  
    195185        <listitem>
    196186          <para><computeroutput>hostdvds</computeroutput>,
    197           <computeroutput>hostfloppies</computeroutput> and
    198           <computeroutput>hostifs</computeroutput>, respectively, list DVD,
    199           floppy and host networking interfaces on the host, along with the
    200           name used to access them from within VirtualBox.</para>
     187          <computeroutput>hostfloppies</computeroutput>, respectively, list
     188          DVD, floppy, bridged networking and host-only networking interfaces
     189          on the host, along with the name used to access them from within
     190          VirtualBox.</para>
     191        </listitem>
     192
     193        <listitem>
     194          <para><computeroutput>bridgedifs</computeroutput>,
     195          <computeroutput>hostonlyifs</computeroutput> and
     196          <computeroutput>dhcpservers</computeroutput>, respectively, list
     197          bridged network interfaces, host-only network interfaces and DHCP
     198          servers currently available on the host. Please see <xref
     199          linkend="networkingdetails" /> for details on these.</para>
    201200        </listitem>
    202201
    … …  
    216215
    217216        <listitem>
     217          <para><computeroutput>hdds</computeroutput>,
     218          <computeroutput>dvds</computeroutput> and
     219          <computeroutput>floppies</computeroutput> all give you information
     220          about virtual disk images currently in use by VirtualBox, including
     221          all their settings, the unique identifiers (UUIDs) associated with
     222          them by VirtualBox and all files associated with them. This is the
     223          command-line equivalent of the Virtual Media Manager; see <xref
     224          linkend="vdis" />.</para>
     225        </listitem>
     226
     227        <listitem>
     228          <para><computeroutput>hddbackends</computeroutput> lists all known
     229          virtual disk back-ends of VirtualBox. For each such format (such as
     230          VDI, VMDK or RAW), this lists the back-end's capabilities and
     231          configuration.</para>
     232        </listitem>
     233
     234        <listitem>
    218235          <para><computeroutput>systemproperties</computeroutput> displays
    219236          some global VirtualBox settings, such as minimum and maximum guest
    … …  
    223240
    224241        <listitem>
    225           <para><computeroutput>hddbackends</computeroutput> lists all known
    226           virtual disk back-ends of VirtualBox. For each such format (such as
    227           VDI, VMDK or RAW), this lists the back-end's capabilities and
    228           configuration.</para>
     242          <para><computeroutput>extpacks</computeroutput> displays all
     243          VirtualBox extension packs currently installed; see <xref
     244          linkend="intro-installing" /> and <xref
     245          linkend="vboxmanage-extpack" /> for more information.</para>
    229246        </listitem>
    230247      </itemizedlist></para>
    … …  
    26752692
    26762693                <glossdef>
    2677                   <para>Enables following symlinks on the host's source.</para>
     2694                  <para>Enables following symlinks on the host's
     2695                  source.</para>
    26782696                </glossdef>
    26792697              </glossentry>
    … …  
    26832701
    26842702                <glossdef>
    2685                   <para>Recursively copies files/directories of the specified source.</para>
     2703                  <para>Recursively copies files/directories of the specified
     2704                  source.</para>
    26862705                </glossdef>
    26872706              </glossentry>
    … …  
    27072726
    27082727        <listitem>
    2709           <para><computeroutput>createdirectory</computeroutput>, which allows copying
    2710           files from the host to the guest (only with installed Guest
     2728          <para><computeroutput>createdirectory</computeroutput>, which allows
     2729          copying files from the host to the guest (only with installed Guest
    27112730          Additions 4.0 and later).</para>
    27122731
    … …  
    27292748
    27302749                <glossdef>
    2731                   <para>Absolute path of directory/directories to create on guest, e.g.
    2732                   <computeroutput>D:\Foo\Bar</computeroutput>. Parent directories
    2733                   need to exist (e.g. in this example <computeroutput>D:\Foo</computeroutput>)
    2734                   when switch <computeroutput>--parents</computeroutput> is omitted. The
    2735                   specified user must have appropriate rights to create the specified
    2736                   directory.</para>
     2750                  <para>Absolute path of directory/directories to create on
     2751                  guest, e.g. <computeroutput>D:\Foo\Bar</computeroutput>.
     2752                  Parent directories need to exist (e.g. in this example
     2753                  <computeroutput>D:\Foo</computeroutput>) when switch
     2754                  <computeroutput>--parents</computeroutput> is omitted. The
     2755                  specified user must have appropriate rights to create the
     2756                  specified directory.</para>
    27372757                </glossdef>
    27382758              </glossentry>
    … …  
    27612781
    27622782                <glossdef>
    2763                   <para>Also creates not yet existing parent directories of the
    2764                   specified directory, e.g. if the directory <computeroutput>D:\Foo</computeroutput>
    2765                   of <computeroutput>D:\Foo\Bar</computeroutput> does not exist yet it will
    2766                   be created. Without specifying <computeroutput>--parent</computeroutput> the
    2767                   action would have failed.</para>
     2783                  <para>Also creates not yet existing parent directories of
     2784                  the specified directory, e.g. if the directory
     2785                  <computeroutput>D:\Foo</computeroutput> of
     2786                  <computeroutput>D:\Foo\Bar</computeroutput> does not exist
     2787                  yet it will be created. Without specifying
     2788                  <computeroutput>--parent</computeroutput> the action would
     2789                  have failed.</para>
    27682790                </glossdef>
    27692791              </glossentry>
    … …  
    27732795
    27742796                <glossdef>
    2775                   <para>Sets the permission mode of the specified directory. Only octal
    2776                   modes (e.g. <computeroutput>0755</computeroutput>) are supported right now.</para>
     2797                  <para>Sets the permission mode of the specified directory.
     2798                  Only octal modes (e.g.
     2799                  <computeroutput>0755</computeroutput>) are supported right
     2800                  now.</para>
    27772801                </glossdef>
    27782802              </glossentry>
    … …  
    27852809                </glossdef>
    27862810              </glossentry>
    2787 
    27882811            </glosslist></para>
    27892812        </listitem>
    … …  
    29052928    network or host-only interface name.</para>
    29062929  </sect1>
     2930
     2931  <sect1 id="vboxmanage-extpack">
     2932    <title>VBoxManage extpack</title>
     2933
     2934    <para>The "extpack" command allows you to add or remove VirtualBox
     2935    extension packs, as described in <xref
     2936    linkend="intro-installing" />.<itemizedlist>
     2937        <listitem>
     2938          <para>To add a new extension pack, use <computeroutput>VBoxManage
     2939          extpack install &lt;tarball&gt;</computeroutput>. </para>
     2940        </listitem>
     2941
     2942        <listitem>
     2943          <para>To remove a previously installed extension pack, use
     2944          <computeroutput>VBoxManage extpack uninstall
     2945          &lt;name&gt;</computeroutput>. You can use
     2946          <computeroutput>VBoxManage list extpacks</computeroutput> to show
     2947          the names of the extension packs which are currently installed;
     2948          please see <xref linkend="vboxmanage-list" /> also. The optional
     2949          <computeroutput>--force</computeroutput> parameter can be used to
     2950          override the refusal of an extension pack to be uninstalled.</para>
     2951        </listitem>
     2952
     2953        <listitem>
     2954          <para>The <computeroutput>VBoxManage extpack
     2955          cleanup</computeroutput> command can be used to remove temporary
     2956          files and directories that may have been left behind if a previous
     2957          install or uninstall command failed.</para>
     2958        </listitem>
     2959      </itemizedlist></para>
     2960  </sect1>
    29072961</chapter>
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