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