Index: /trunk/doc/manual/en_US/user_Introduction.xml
===================================================================
--- /trunk/doc/manual/en_US/user_Introduction.xml (revision 35089)
+++ /trunk/doc/manual/en_US/user_Introduction.xml (revision 35090)
@@ -69,6 +69,6 @@
solution on a real machine can be a tedious task. With VirtualBox,
such a complex setup (then often called an "appliance") can be packed
- into a virtual machine. Installing and running a mail server
- becomes as easy as importing such an appliance into VirtualBox.
+ into a virtual machine. Installing and running a mail server becomes
+ as easy as importing such an appliance into VirtualBox.
@@ -503,12 +503,12 @@
- Installing VirtualBox
+ Installing VirtualBox and extension packs
VirtualBox comes in many different packages, and installation
- depends on your host platform. If you have installed software before,
- installation should be straightforward: on each host platform, VirtualBox
- uses the installation method that is most common and easy to use. If you
- run into trouble or have special requirements, please refer to for details about the various installation
+ depends on your host operating system. If you have installed software
+ before, installation should be straightforward: on each host platform,
+ VirtualBox uses the installation method that is most common and easy to
+ use. If you run into trouble or have special requirements, please refer to
+ for details about the various installation
methods.
@@ -516,5 +516,5 @@
components.
- The base package consists of all open source components and is
+ The base package consists of all open-source components and is
licensed under the GNU General Public License V2.
@@ -543,7 +543,18 @@
VirtualBox extension packages have a
- .vbox-extpack file name extension. To
- install an extension, simply double-click on package file, and the
- VirtualBox Manager will guide you through the required steps.
+ .vbox-extpack file name extension.
+ To install an extension, simply double-click on the package file,
+ and the VirtualBox Manager will guide you through the required
+ steps.
+
+ To view the extension packs that are currently installed,
+ please start the VirtualBox Manager (see the next section). From the
+ "File" menu, please select "Preferences". In the window that shows
+ up, go to the "Extensions" category which shows you the extensions
+ which are currently installed and allows you to remove a package or
+ add a new one.
+
+ Alternatively you can use VBoxManage on the command line: see
+ for details.
@@ -815,5 +826,5 @@
- Starting a VM for the first time
+ Starting a new VM for the first time
When a VM gets started for the first time, another wizard -- the
@@ -1257,6 +1268,6 @@
snapshots. By restoring a snapshot, you go back (or forward) in
time: the current state of the machine is lost, and the machine is
- restored to exactly the same state as it was when the snapshot
- was taken.
+ restored to exactly the same state as it was when the snapshot was
+ taken.
Both the terminology and the functionality of restoring
snapshots has changed with VirtualBox 3.1. Before that
@@ -1455,6 +1466,6 @@
- To import an appliance in one of the
- above formats, simply double-click on the OVF/OVA file.
+ To import an appliance in one of
+ the above formats, simply double-click on the OVF/OVA file.
Starting with version 4.0, VirtualBox creates file type
associations for OVF and OVA files on your host operating
Index: /trunk/doc/manual/en_US/user_VBoxManage.xml
===================================================================
--- /trunk/doc/manual/en_US/user_VBoxManage.xml (revision 35089)
+++ /trunk/doc/manual/en_US/user_VBoxManage.xml (revision 35090)
@@ -177,14 +177,4 @@
- hdds,
- dvds and
- floppies all give you information
- about virtual disk images currently registered in VirtualBox,
- including all their settings, the unique identifiers (UUIDs)
- associated with them by VirtualBox and all files associated with
- them.
-
-
-
ostypes lists all guest
operating systems presently known to VirtualBox, along with the
@@ -195,8 +185,17 @@
hostdvds,
- hostfloppies and
- hostifs, respectively, list DVD,
- floppy and host networking interfaces on the host, along with the
- name used to access them from within VirtualBox.
+ hostfloppies, respectively, list
+ DVD, floppy, bridged networking and host-only networking interfaces
+ on the host, along with the name used to access them from within
+ VirtualBox.
+
+
+
+ bridgedifs,
+ hostonlyifs and
+ dhcpservers, respectively, list
+ bridged network interfaces, host-only network interfaces and DHCP
+ servers currently available on the host. Please see for details on these.
@@ -216,4 +215,22 @@
+ hdds,
+ dvds and
+ floppies all give you information
+ about virtual disk images currently in use by VirtualBox, including
+ all their settings, the unique identifiers (UUIDs) associated with
+ them by VirtualBox and all files associated with them. This is the
+ command-line equivalent of the Virtual Media Manager; see .
+
+
+
+ hddbackends lists all known
+ virtual disk back-ends of VirtualBox. For each such format (such as
+ VDI, VMDK or RAW), this lists the back-end's capabilities and
+ configuration.
+
+
+
systemproperties displays
some global VirtualBox settings, such as minimum and maximum guest
@@ -223,8 +240,8 @@
- hddbackends lists all known
- virtual disk back-ends of VirtualBox. For each such format (such as
- VDI, VMDK or RAW), this lists the back-end's capabilities and
- configuration.
+ extpacks displays all
+ VirtualBox extension packs currently installed; see and for more information.
@@ -2675,5 +2692,6 @@
- Enables following symlinks on the host's source.
+ Enables following symlinks on the host's
+ source.
@@ -2683,5 +2701,6 @@
- Recursively copies files/directories of the specified source.
+ Recursively copies files/directories of the specified
+ source.
@@ -2707,6 +2726,6 @@
- createdirectory, which allows copying
- files from the host to the guest (only with installed Guest
+ createdirectory, which allows
+ copying files from the host to the guest (only with installed Guest
Additions 4.0 and later).
@@ -2729,10 +2748,11 @@
- Absolute path of directory/directories to create on guest, e.g.
- D:\Foo\Bar. Parent directories
- need to exist (e.g. in this example D:\Foo)
- when switch --parents is omitted. The
- specified user must have appropriate rights to create the specified
- directory.
+ Absolute path of directory/directories to create on
+ guest, e.g. D:\Foo\Bar.
+ Parent directories need to exist (e.g. in this example
+ D:\Foo) when switch
+ --parents is omitted. The
+ specified user must have appropriate rights to create the
+ specified directory.
@@ -2761,9 +2781,11 @@
- Also creates not yet existing parent directories of the
- specified directory, e.g. if the directory D:\Foo
- of D:\Foo\Bar does not exist yet it will
- be created. Without specifying --parent the
- action would have failed.
+ Also creates not yet existing parent directories of
+ the specified directory, e.g. if the directory
+ D:\Foo of
+ D:\Foo\Bar does not exist
+ yet it will be created. Without specifying
+ --parent the action would
+ have failed.
@@ -2773,6 +2795,8 @@
- Sets the permission mode of the specified directory. Only octal
- modes (e.g. 0755) are supported right now.
+ Sets the permission mode of the specified directory.
+ Only octal modes (e.g.
+ 0755) are supported right
+ now.
@@ -2785,5 +2809,4 @@
-
@@ -2905,3 +2928,34 @@
network or host-only interface name.
+
+
+ VBoxManage extpack
+
+ The "extpack" command allows you to add or remove VirtualBox
+ extension packs, as described in .
+
+ To add a new extension pack, use VBoxManage
+ extpack install <tarball>.
+
+
+
+ To remove a previously installed extension pack, use
+ VBoxManage extpack uninstall
+ <name>. You can use
+ VBoxManage list extpacks to show
+ the names of the extension packs which are currently installed;
+ please see also. The optional
+ --force parameter can be used to
+ override the refusal of an extension pack to be uninstalled.
+
+
+
+ The VBoxManage extpack
+ cleanup command can be used to remove temporary
+ files and directories that may have been left behind if a previous
+ install or uninstall command failed.
+
+
+