| 1 | <?xml version='1.0' encoding='UTF-8'?>
|
|---|
| 2 | <!DOCTYPE topic PUBLIC "-//OASIS//DTD DITA Topic//EN" "topic.dtd">
|
|---|
| 3 | <topic xml:lang="en-us" id="guestadd-intro">
|
|---|
| 4 | <title>Introduction to Guest Additions</title>
|
|---|
| 5 |
|
|---|
| 6 | <body>
|
|---|
| 7 | <p>
|
|---|
| 8 | As mentioned in <xref href="virtintro.dita#virtintro"/>, the Guest Additions
|
|---|
| 9 | are designed to be installed <i>inside</i> a virtual
|
|---|
| 10 | machine after the guest operating system has been installed. They
|
|---|
| 11 | consist of device drivers and system applications that optimize
|
|---|
| 12 | the guest operating system for better performance and usability.
|
|---|
| 13 | See <xref href="guestossupport.dita#guestossupport"/> for details on what guest
|
|---|
| 14 | operating systems are fully supported with Guest Additions by
|
|---|
| 15 | <ph conkeyref="vbox-conkeyref-phrases/product-name"/>.
|
|---|
| 16 | </p>
|
|---|
| 17 | <p>
|
|---|
| 18 | The <ph conkeyref="vbox-conkeyref-phrases/product-name"/> Guest Additions for all supported guest
|
|---|
| 19 | operating systems are provided as a single CD-ROM image file which
|
|---|
| 20 | is called <filepath>VBoxGuestAdditions.iso</filepath>. This image
|
|---|
| 21 | file is located in the installation directory of <ph conkeyref="vbox-conkeyref-phrases/product-name"/>.
|
|---|
| 22 | To install the Guest Additions for a particular VM, you mount this
|
|---|
| 23 | ISO file in your VM as a virtual CD-ROM and install from there.
|
|---|
| 24 | </p>
|
|---|
| 25 | <p>
|
|---|
| 26 | The Guest Additions offer the following features:
|
|---|
| 27 | </p>
|
|---|
| 28 | <ul>
|
|---|
| 29 | <li>
|
|---|
| 30 | <p><b outputclass="bold">Mouse pointer integration</b>. To
|
|---|
| 31 | overcome the limitations for mouse support described in
|
|---|
| 32 | <xref href="keyb_mouse_normal.dita#keyb_mouse_normal"/>, this feature provides
|
|---|
| 33 | you with seamless mouse support. You will only have one mouse
|
|---|
| 34 | pointer and pressing the Host key is no longer required to
|
|---|
| 35 | <i>free</i> the mouse from being captured by the
|
|---|
| 36 | guest OS. To make this work, a special mouse driver is
|
|---|
| 37 | installed in the guest that communicates with the physical
|
|---|
| 38 | mouse driver on your host and moves the guest mouse pointer
|
|---|
| 39 | accordingly.
|
|---|
| 40 | </p>
|
|---|
| 41 | </li>
|
|---|
| 42 | <li>
|
|---|
| 43 | <p><b outputclass="bold">Shared folders.</b> These provide
|
|---|
| 44 | an easy way to exchange files between the host and the guest.
|
|---|
| 45 | Much like ordinary Windows network shares, you can tell
|
|---|
| 46 | <ph conkeyref="vbox-conkeyref-phrases/product-name"/> to treat a certain host directory as a shared
|
|---|
| 47 | folder, and <ph conkeyref="vbox-conkeyref-phrases/product-name"/> will make it available to the guest
|
|---|
| 48 | operating system as a network share, irrespective of whether
|
|---|
| 49 | the guest actually has a network. See
|
|---|
| 50 | <xref href="sharedfolders.dita#sharedfolders"/>.
|
|---|
| 51 | </p>
|
|---|
| 52 | </li>
|
|---|
| 53 | <li>
|
|---|
| 54 | <p><b outputclass="bold">Better video support.</b> While
|
|---|
| 55 | the virtual graphics card which <ph conkeyref="vbox-conkeyref-phrases/product-name"/> emulates for
|
|---|
| 56 | any guest operating system provides all the basic features,
|
|---|
| 57 | the custom video drivers that are installed with the Guest
|
|---|
| 58 | Additions provide you with extra high and non-standard video
|
|---|
| 59 | modes, as well as accelerated video performance.
|
|---|
| 60 | </p>
|
|---|
| 61 | <p>
|
|---|
| 62 | In addition, with Windows, Linux, and Oracle Solaris guests,
|
|---|
| 63 | you can resize the virtual machine's window if the Guest
|
|---|
| 64 | Additions are installed. The video resolution in the guest
|
|---|
| 65 | will be automatically adjusted, as if you had manually entered
|
|---|
| 66 | an arbitrary resolution in the guest's
|
|---|
| 67 | <b outputclass="bold">Display</b> settings. See
|
|---|
| 68 | <xref href="intro-resize-window.dita#intro-resize-window"/>.
|
|---|
| 69 | </p>
|
|---|
| 70 | <p>
|
|---|
| 71 | If the Guest Additions are installed, 3D graphics and 2D video
|
|---|
| 72 | for guest applications can be accelerated. See
|
|---|
| 73 | <xref href="guestadd-video.dita#guestadd-video"/>.
|
|---|
| 74 | </p>
|
|---|
| 75 | </li>
|
|---|
| 76 | <li>
|
|---|
| 77 | <p><b outputclass="bold">Seamless windows.</b> With this
|
|---|
| 78 | feature, the individual windows that are displayed on the
|
|---|
| 79 | desktop of the virtual machine can be mapped on the host's
|
|---|
| 80 | desktop, as if the underlying application was actually running
|
|---|
| 81 | on the host. See <xref href="seamlesswindows.dita#seamlesswindows"/>.
|
|---|
| 82 | </p>
|
|---|
| 83 | </li>
|
|---|
| 84 | <li>
|
|---|
| 85 | <p><b outputclass="bold">Generic host/guest communication
|
|---|
| 86 | channels.</b> The Guest Additions enable you to control
|
|---|
| 87 | and monitor guest execution. The <i>guest
|
|---|
| 88 | properties</i> provide a generic string-based mechanism
|
|---|
| 89 | to exchange data bits between a guest and a host, some of
|
|---|
| 90 | which have special meanings for controlling and monitoring the
|
|---|
| 91 | guest. See <xref href="guestadd-guestprops.dita#guestadd-guestprops"/>.
|
|---|
| 92 | </p>
|
|---|
| 93 | <p>
|
|---|
| 94 | Additionally, applications can be started in a guest from the
|
|---|
| 95 | host. See <xref href="guestadd-guestcontrol.dita#guestadd-guestcontrol"/>.
|
|---|
| 96 | </p>
|
|---|
| 97 | </li>
|
|---|
| 98 | <li>
|
|---|
| 99 | <p><b outputclass="bold">Time synchronization.</b> With
|
|---|
| 100 | the Guest Additions installed, <ph conkeyref="vbox-conkeyref-phrases/product-name"/> can ensure that
|
|---|
| 101 | the guest's system time is better synchronized with that of
|
|---|
| 102 | the host.
|
|---|
| 103 | </p>
|
|---|
| 104 | <p>
|
|---|
| 105 | For various reasons, the time in the guest might run at a
|
|---|
| 106 | slightly different rate than the time on the host. The host
|
|---|
| 107 | could be receiving updates through NTP and its own time might
|
|---|
| 108 | not run linearly. A VM could also be paused, which stops the
|
|---|
| 109 | flow of time in the guest for a shorter or longer period of
|
|---|
| 110 | time. When the wall clock time between the guest and host only
|
|---|
| 111 | differs slightly, the time synchronization service attempts to
|
|---|
| 112 | gradually and smoothly adjust the guest time in small
|
|---|
| 113 | increments to either catch up or lose time. When the
|
|---|
| 114 | difference is too great, for example if a VM paused for hours
|
|---|
| 115 | or restored from saved state, the guest time is changed
|
|---|
| 116 | immediately, without a gradual adjustment.
|
|---|
| 117 | </p>
|
|---|
| 118 | <p>
|
|---|
| 119 | The Guest Additions will resynchronize the time regularly. See
|
|---|
| 120 | <xref href="changetimesync.dita">Tuning the Guest Additions Time Synchronization Parameters</xref> for how to configure the
|
|---|
| 121 | parameters of the time synchronization mechanism.
|
|---|
| 122 | </p>
|
|---|
| 123 | </li>
|
|---|
| 124 | <li>
|
|---|
| 125 | <p><b outputclass="bold">Shared clipboard.</b> With the
|
|---|
| 126 | Guest Additions installed, the clipboard of the guest
|
|---|
| 127 | operating system can optionally be shared with your host
|
|---|
| 128 | operating system. See <xref href="generalsettings.dita"/>.
|
|---|
| 129 | </p>
|
|---|
| 130 | </li>
|
|---|
| 131 | <li>
|
|---|
| 132 | <p><b outputclass="bold">Automated logins.</b> Also called
|
|---|
| 133 | credentials passing. See <xref href="autologon.dita">Automated Guest Logins</xref>.
|
|---|
| 134 | </p>
|
|---|
| 135 | </li>
|
|---|
| 136 | </ul>
|
|---|
| 137 | <p>
|
|---|
| 138 | Each version of <ph conkeyref="vbox-conkeyref-phrases/product-name"/>, even minor releases, ship with
|
|---|
| 139 | their own version of the Guest Additions. While the interfaces
|
|---|
| 140 | through which the <ph conkeyref="vbox-conkeyref-phrases/product-name"/> core communicates with the Guest
|
|---|
| 141 | Additions are kept stable so that Guest Additions already
|
|---|
| 142 | installed in a VM should continue to work when <ph conkeyref="vbox-conkeyref-phrases/product-name"/> is
|
|---|
| 143 | upgraded on the host, for best results, it is recommended to keep
|
|---|
| 144 | the Guest Additions at the same version.
|
|---|
| 145 | </p>
|
|---|
| 146 | <p>
|
|---|
| 147 | The Windows and Linux Guest Additions therefore check
|
|---|
| 148 | automatically whether they have to be updated. If the host is
|
|---|
| 149 | running a newer <ph conkeyref="vbox-conkeyref-phrases/product-name"/> version than the Guest Additions, a
|
|---|
| 150 | notification with further instructions is displayed in the guest.
|
|---|
| 151 | </p>
|
|---|
| 152 | <p>
|
|---|
| 153 | To disable this update check for the Guest Additions of a given
|
|---|
| 154 | virtual machine, set the value of its
|
|---|
| 155 | <codeph>/VirtualBox/GuestAdd/CheckHostVersion</codeph> guest
|
|---|
| 156 | property to <codeph>0</codeph>. See
|
|---|
| 157 | <xref href="guestadd-guestprops.dita#guestadd-guestprops"/>.
|
|---|
| 158 | </p>
|
|---|
| 159 | </body>
|
|---|
| 160 |
|
|---|
| 161 | </topic>
|
|---|
