Sun Microsystems VIRTUALBOX 3.0.0, User Manual

Page 1: ...Sun VirtualBox R User Manual Version 3 0 0 c 2004 2009 Sun Microsystems Inc http www virtualbox org ...

Page 2: ... Unattended installation 21 2 3 Installing on Linux hosts 21 2 3 1 Prerequisites 21 2 3 2 The VirtualBox kernel module 21 2 3 3 USB and advanced networking support 23 2 3 4 Performing the installation 23 2 3 5 Starting VirtualBox on Linux 28 2 4 Installing on Solaris hosts 28 2 4 1 Performing the installation 28 2 4 2 Starting VirtualBox on Solaris 29 2 4 3 Uninstallation 29 2 4 4 Unattended insta...

Page 3: ... 4 2 2 Updating the Windows Guest Additions 63 4 2 3 Unattended Installation 63 4 2 4 Manual file extraction 64 4 2 5 Windows Vista networking 64 4 3 Linux Guest Additions 64 4 3 1 Installing the Linux Guest Additions 65 4 3 2 Video acceleration and high resolution graphics modes 66 4 3 3 Updating the Linux Guest Additions 66 4 4 Solaris Guest Additions 67 4 4 1 Installing the Solaris Guest Additi...

Page 4: ... machines VRDP support 93 7 4 1 VBoxHeadless the VRDP only server 94 7 4 2 Step by step creating a virtual machine on a headless server 95 7 4 3 Remote USB 97 7 4 4 RDP authentication 97 7 4 5 RDP encryption 98 7 4 6 VRDP multiple connections 99 8 VBoxManage reference 100 8 1 VBoxManage list 105 8 2 VBoxManage showvminfo 105 8 3 VBoxManage registervm unregistervm 106 8 4 VBoxManage createvm 107 8 ...

Page 5: ...ore than 120 VMs on Solaris hosts 134 9 9 Using serial ports 134 9 10 Using a raw host hard disk from a guest 135 9 10 1 Access to entire physical hard disk 135 9 10 2 Access to individual physical hard disk partitions 136 9 11 Allowing a virtual machine to start even with unavailable CD DVD floppy devices 138 9 12 Fine tuning the VirtualBox NAT engine 138 9 12 1 Configuring the address of a NAT n...

Page 6: ...ognized 149 11 4 3 Sluggish response when using Microsoft RDP client 149 11 4 4 Running an iSCSI initiator and target on a single system 150 11 5 Linux hosts 150 11 5 1 Linux kernel module refuses to load 150 11 5 2 Linux host CD DVD drive not found 150 11 5 3 Linux host CD DVD drive not found older distributions 151 11 5 4 Linux host floppy not found 151 11 5 5 Strange guest IDE error messages wh...

Page 7: ...28Version 1 1 12 2006 11 14 202 12 29Version 1 1 10 2006 07 28 203 12 30Version 1 1 8 2006 07 17 203 12 31Version 1 1 6 2006 04 18 204 12 32Version 1 1 4 2006 03 09 204 12 33Version 1 1 2 2006 02 03 205 12 34Version 1 0 50 2005 12 16 207 12 35Version 1 0 48 2005 11 23 207 12 36Version 1 0 46 2005 11 04 208 12 37Version 1 0 44 2005 10 25 208 12 38Version 1 0 42 2005 08 30 209 12 39Version 1 0 40 20...

Page 8: ...ibpng license 240 14 2 10lwIP license 240 14 2 11libxml license 241 14 2 12libxslt licenses 241 14 2 13gSOAP Public License Version 1 3a 242 14 2 14Chromium licenses 249 14 2 15curl license 251 14 2 16dnsproxy license 252 15 VirtualBox privacy policy 253 Glossary 255 8 ...

Page 9: ...e 155 for a detailed list of version changes 1 1 Virtualization basics With VirtualBox you can run unmodified operating systems including all of the software that is installed on them directly on top of your existing operating system in a special environment called a virtual machine Your physical computer is then usually called the host while the virtual machine is often called a guest The followi...

Page 10: ...o be capable of displaying VRDP data Testing and disaster recovery Once installed a virtual box and its virtual hard disk can be considered a container that can be arbitrarily frozen woken up copied backed up and transported between hosts On top of that with the use of another VirtualBox feature called snapshots one can save a particular state of a virtual machine and revert back to that state if ...

Page 11: ...disks VirtualBox should virtualize through which container files what CD ROMs are mounted etc as well as state information whether the VM is currently running saved its snapshots etc In other words a VM is also what you can see in its settings dialog Guest Additions With Guest Additions we refer to special software packages that are shipped with VirtualBox Even though they are part of VirtualBox t...

Page 12: ...lization Prior to version 2 2 software virtualization was the default starting with version 2 2 VirtualBox will enable hardware virtualization by default for new virtual machines that you create Existing virtual machines are not automatically changed for compatibility reasons and the default can of course be changed for each virtual machine Even though VirtualBox does not always require hardware v...

Page 13: ... even for new machines but it can be enabled for each virtual machine individually in the machine settings If your system supports nested paging AMD V or EPT VT x then you can expect a significant performance increase by enabling hardware virtualization and the nested paging feature Another hardware feature called Virtual Processor Identifiers VPIDs can greatly accelerate context switching by redu...

Page 14: ...ackages which can be installed inside of supported guest systems to improve their performance and to provide addi tional integration and communication with the host system After installing the Guest Additions a virtual machine will support automatic adjustment of video resolutions seamless windows accelerated 3D graphics and more The Guest Additions are described in detail in chapter 4 Guest Addit...

Page 15: ...ecution Environment PXE Multigeneration snapshots VirtualBox can save successive snapshots of the state of the virtual machine You can revert the virtual machine to the state of any of the snapshots For details see chapter 3 4 4 Snapshots page 42 VRDP remote access You can run any virtual machine in a special VirtualBox program that acts as a server for the VirtualBox Remote Desktop Protocol VRDP ...

Page 16: ...dgy Eft 7 04 Feisty Fawn 7 10 Gutsy Gibbon 8 04 Hardy Heron 8 10 Intrepid Ibex 9 04 Jaunty Jackalope Mandriva 2007 1 2008 0 and 2009 1 It should be possible to use VirtualBox on most systems based on Linux kernel 2 6 using either the VirtualBox installer or by doing a manual installation see chapter 2 3 Installing on Linux hosts page 21 Note that starting with VirtualBox 2 1 Linux 2 4 based host o...

Page 17: ... 95 98 ME Limited testing has been performed Use beyond legacy installation mechanisms not recommended No Guest Additions available Linux 2 4 Limited support Linux 2 6 All versions editions are fully supported 32 bits and 64 bits Guest Addi tions are available We strongly recommend using a Linux kernel version 2 6 13 or higher for better performance Note Certain Linux kernel releases have bugs tha...

Page 18: ...ing system for the particular VM Since supporting 64 bits on 32 bit hosts incurs additional overhead VirtualBox only enables this support upon explicit request On 64 bit hosts 64 bit guest support is always enabled so you can simply install a 64 bit operating system in the guest Warning On any host you should enable the I O APIC for virtual machines that you intend to use in 64 bit mode This is es...

Page 19: ... The VirtualBox installation can be started either by double clicking on its executable file contains both 32 and 64 bit architectures or by entering VirtualBox exe extract on the command line This will extract both installers into a temporary directory in which you ll then find the usual MSI files Then you can do a msiexec i VirtualBox version MultiArch_ x86 amd64 msi to perform the installation ...

Page 20: ...n do as follows VirtualBox exe msiparams ALLUSERS 2 or msiexec i VirtualBox version MultiArch_ x86 amd64 msi ALLUSERS 2 on the extracted MSI files This will install VirtualBox only for the current user 2 1 3 Uninstallation As we use the Microsoft Installer VirtualBox can be safely uninstalled at any time by choosing the program entry in the Add Remove Programs applet in the Windows Control Panel 2...

Page 21: ...es on your Linux system before starting the installation some systems will do this for you automatically when you install VirtualBox Qt 4 3 0 or higher SDL 1 2 7 or higher this graphics library is typically called libsdl or similar Note To be precise these packages are only required if you want to run the VirtualBox graphical user interfaces In particular VirtualBox our main graphical user interfa...

Page 22: ...Linux distributions can be set up simply by installing the right packages normally these will be the GNU compiler GCC GNU Make make and pack ages containing header files for your kernel and making sure that all system updates are installed and that the system is running the most up to date kernel included in the distribution The version numbers of the header file packages must be the same as that ...

Page 23: ...an package sudo dpkg i VirtualBox_3 0 0_Ubuntu_edgy deb You will be asked to accept the VirtualBox Personal Use and Evaluation License Unless you answer yes here the installation will be aborted The group vboxusers will be created during installation Note that a user who is going to run VirtualBox must be member of that group A user can be made member of the group vboxusers through the GUI user gr...

Page 24: ... it It creates etc init d vboxdrv an init script to start the VirtualBox kernel module It creates a new system group called vboxusers It creates symbolic links to VirtualBox VBoxSDL VBoxVRDP VBoxHeadless and VBoxManage in usr bin It creates etc udev 60 vboxdrv rules a description file for udev if that is present which makes the module accessible to anyone in the group vboxusers It writes the insta...

Page 25: ...ses for USB access e g usb or usbusers 2 3 4 3 Performing a manual installation If for any reason you cannot use the shell script installer described previously you can also perform a manual installation Invoke the installer like this VirtualBox run keep noexec This will unpack all the files needed for installation in the directory install under the current directory The VirtualBox application fil...

Page 26: ...d any users who will be allowed to use host USB devices in VirtualBox guests to the appropriate USB users group for your distribution This group is often called usb or usbusers Next you will have to install the system initialization script for the kernel module cp opt VirtualBox vboxdrv sh etc init d vboxdrv assuming you installed VirtualBox to the opt VirtualBox directory and activate the initial...

Page 27: ... line allows compilation of the vboxdrv kernel module if no module was found for the current kernel The second line allows the package to delete any old vboxdrv kernel modules compiled by previous installations These default settings can be applied with debconf set selections vboxconf prior to the installation of the VirtualBox Debian package 2 3 4 6 Automatic installation of rpm packages The rpm ...

Page 28: ...VBoxHeadless require the VirtualBox directory to be in the library path LD_LIBRARY_PATH VBoxManage showvminfo Windows XP 2 4 Installing on Solaris hosts For the various versions of Solaris that we support as host operating systems please refer to chapter 1 4 Supported host operating systems page 16 If you have a previously installed instance of VirtualBox on your Solaris host please uninstall it f...

Page 29: ...ll setup script Once the postinstall script has been executed your installation is now complete You may now safely delete the uncompressed package and autoresponse files from your system VirtualBox would be installed in opt VirtualBox 2 4 2 Starting VirtualBox on Solaris The easiest way to start a VirtualBox program is by running the program of your choice VirtualBox VBoxManage VBoxSDL or VBoxHead...

Page 30: ...com bigadmin features articles solaris_zones jsp Assuming that VirtualBox has already been installed into your zone you need to give the zone access to VirtualBox s device node This is done by performing the following steps Start a root terminal and execute zonecfg z vboxzone Inside the zonecfg prompt add the device resource and match properties to the zone Here s how it can be done zonecfg vboxzo...

Page 31: ...r computers on the Internet access to the guest system VirtualBox comes with many advanced interfaces which will be described later in this manual chapter 7 3 VBoxSDL the simplified VM displayer page 92 explains how to run a single VM at a time with a reduced graphical interface chapter 7 4 1 VBoxHeadless the VRDP only server page 94 shows how to run virtual machines remotely chapter 8 VBoxManage ...

Page 32: ...n the example above A row of buttons above it allows you to create new VMs and work on existing VMs The pane on the right displays the properties of the virtual machine currently selected if any When you start VirtualBox for the first time as there is no virtual machine yet everything will be empty 3 2 Creating a virtual machine Clicking on the New button in the user interface will guide you throu...

Page 33: ...ore not as useful as Windows XP SP2 For Operating System Type select the operating system that you want to install later Depending on your selection VirtualBox will enable or disable certain VM settings that your guest operating system may require This is particularly im portant for 64 bit guests see chapter 1 6 64 bit guests page 18 It is therefore recommended to always set it to the correct valu...

Page 34: ...stall with less than 512 MB Of course if you want to run graphics intensive applications in your VM you may require even more RAM So as a rule of thumb if you have 1 GB of RAM or more in your host computer it is usually safe to allocate 512 MB to each VM But in any case make sure you always have at least 256 512 MB of RAM left on your host operating system Otherwise you may cause your host OS to e...

Page 35: ...tions with virtual disks the Existing button will bring up the Virtual Disk Manager which is described in more detail in chapter 3 5 The Virtual Disk Manager page 43 Most probably if you are using VirtualBox for the first time you will want to create a new disk image Hence press the New button This brings up another window the Create New Virtual Disk Wizard VirtualBox supports two types of image f...

Page 36: ...or any serious use After having selected or created your image file again press Next to go to the next page 4 After clicking on Finish your new virtual machine will be created You will then see it in the list on the left side of the main window with the name you have entered 3 3 Basics of virtual machine configuration When you select a virtual machine from the list in the main VirtualBox window yo...

Page 37: ...be changed in the Settings window are described in detail in chapter 3 7 Virtual machine settings page 45 Even more parameters are available with the command line interface see chapter 8 VBoxManage reference page 100 For now if you have just created an empty VM you will probably be most interested in the settings presented by the CD DVD ROM section if you want to make a CD ROM or a DVD ROM availab...

Page 38: ...gs up the Virtual Disk Image Manager where you perform the following steps 1 Press the Add button to add your ISO file to the list of registered images This will present an ordinary file dialog that allows you to find your ISO file on your host machine 2 Back to the manager window select the ISO file that you just added and press the Select button This selects the ISO file for your VM The Virtual ...

Page 39: ...ne of the two your VM or the rest of your computer can own the keyboard and the mouse You will see a second mouse pointer which will always be confined to the limits of the VM window Basically you activate the VM by clicking inside it To return ownership of keyboard and mouse to your host operating system VirtualBox reserves a special key on your keyboard for itself the host key By default this is...

Page 40: ...This will be described later in chapter 4 Guest Additions page 60 3 4 1 2 Typing special characters Operating systems expect certain key combinations to initiate certain procedures Some of these key combinations may be difficult to enter into a virtual machine as there are three candidates as to who receives keyboard input the host operating sys tem VirtualBox or the guest operating system Who of ...

Page 41: ...ons will affect the host or the guest if a virtual machine currently has the focus This is a global setting for all virtual machines and can be found under File Global settings Input Auto capture keyboard 3 4 2 Changing removable media While a virtual machine is running you can change removable media in the Devices menu of the VM s window Here you can select in detail what VirtualBox presents to y...

Page 42: ...wn mechanism in the VM Power off the machine With this option VirtualBox also stops running the virtual machine but without saving its state This is equivalent to pulling the power plug on a real computer without shutting it down properly If you start the machine again after powering it off your operating system will have to reboot completely and may begin a lengthy check of its virtual system dis...

Page 43: ...l be displayed in sequence and each subsequent snapshot is a derivation of the earlier one To revert to an earlier snapshot you right click on the Current state item and select Revert to current snapshot This will bring the VM back to the state of the nearest most recent snapshot Similarly you can merge several earlier snapshots into one by right clicking on a snapshot and selecting Discard snapsh...

Page 44: ...e image is currently attached to if any Also as can be seen in the screen shot if you have created snapshots for a virtual machine additional differencing hard disk images may automatically be created see chapter 3 4 4 Snapshots page 42 for details The Virtual Disk Manager allows you to create new hard disk images using the New button this will bring up the Create Disk Image wizard already describ...

Page 45: ...D to each disk image to make sure it is only used once See chapter 5 4 Cloning disk images page 80 for instructions on this matter Details about the different container formats supported by VirtualBox are described in chapter 5 Virtual storage page 75 3 6 Deleting virtual machines The Delete button in the main VirtualBox window lets you remove a virtual machine which you no longer need All setting...

Page 46: ...1 2 Advanced tab Snapshot folder By default VirtualBox saves snapshot data together with your other VirtualBox configuration data see chapter 9 1 VirtualBox configuration data page 127 With this setting you can specify any other folder for each VM Shared clipboard If the virtual machine has Guest Additions installed you can select here whether the clipboard of the guest operating system should be ...

Page 47: ...d amount of memory will be requested from the host operating system so it must be available or made available as free memory on the host when attempting to start the VM and will not be available to the host while the VM is running This is the same setting that was specified in the New Virtual Machine wizard as described with guidelines under chapter 3 2 Creating a virtual machine page 32 above Gen...

Page 48: ...I O APIC operating systems can use more than 16 interrupt requests IRQs and therefore avoid IRQ sharing for improved reliability Note Enabling the I O APIC is required for 64 bit guest operating systems especially Windows Vista it is also required if you want to use more than one virtual CPU in a virtual machine However software support for I O APICs has been unreliable with some operat ing system...

Page 49: ... is enabled by default for newly created machines Nested paging is not enabled automatically when you enable hardware virtualiza tion you can enable it separately once you have enabled hardware virtualization Note You can mix software and hardware virtualization when running mul tiple VMs In certain cases a small performance penalty will be unavoidable when mixing VT x and software virtualization ...

Page 50: ...w that leaves you with three possible hard disks each represented by one disk image file You can select which IDE controller type VirtualBox should present to the virtual machine PIIX3 PIIX4 or ICH6 This should not make much of a difference but if you import a virtual machine from another virtualization product the operating system in that machine may expect a particular controller and crash if it...

Page 51: ...rating system For both the floppy and CD DVD ROM categories if the Mount checkbox is unchecked VirtualBox will report to the guest that no media is in the drive Oth erwise if the Mount checkbox is set the following options are available Host drive The physical device of the host computer is connected to the VM so that the guest operating system can read from and write to your physical device This ...

Page 52: ...he audio output should be heard on the host system If audio is enabled for a guest you can choose between the emulation of an Intel AC 97 controller or a SoundBlaster 16 card In any case you can select what audio driver VirtualBox will use on the host On a Linux host depending on your host configuration you can also select between the OSS ALSA or the PulseAudio subsystem On newer Linux distributio...

Page 53: ...el debugging software usually interacts with developers over a serial port In other words with virtual serial ports system programmers can do kernel debugging on a virtual machine instead of needing a real computer to connect to If a virtual serial port is enabled the guest operating system sees it a standard 16450 type serial port Both receiving and transmitting data is supported How this virtual...

Page 54: ...r OpenSolaris host a local domain socket is used instead On Linux there are various tools which can connect to a local domain socket or create one in server mode The most flexible tool is socat and is available as part of many distributions In this case you can configure whether VirtualBox should create the named pipe or on non Windows hosts the local domain socket itself or whether VirtualBox sho...

Page 55: ...y only a vendor ID of 046d all devices produced by Logitech will be available to the guest If you fill in all fields on the other hand the filter will only apply to a particular device model from a particular vendor and not even to other devices of the same type with a different revision and serial number In detail the following criteria are available 1 Vendor and product ID With USB each vendor o...

Page 56: ...e driver Also you no longer need to replug devices for VirtualBox to claim them On newer Linux hosts VirtualBox accesses USB devices through special files in the file system When VirtualBox is installed these are made available to all users in the vboxusers system group In order to be able to access USB from guest systems make sure that you are a member of this group On older Linux hosts USB devic...

Page 57: ...ar no guarantee is made that VirtualBox supports all appli ances created by other virtualization software For a list of know limitations please see chapter 13 Known limitations page 213 An appliance in OVF format will typically consist of several files 1 one or several disk images typically in the widely used VMDK format see chap ter 5 2 Disk image files VDI VMDK VHD page 77 and 2 a textual descri...

Page 58: ... format that is unsuitable for being used by virtual machines directly the images will need to be unpacked and copied first which can take a few minutes For how to import an image at the command line please see chapter 8 6 VBoxMan age import page 112 Conversely to export virtual machines that you already have in VirtualBox select the machines and File Export appliance A different dialog window sho...

Page 59: ...hat VirtualBox provides for virtual machines For example snapshot information gets lost on export the disk images will have a flattened state identical to the current state of the virtual machine but any snapshots that were defined for the machine will have been merged 59 ...

Page 60: ... a particular VM you mount this ISO file in your VM as a virtual CD ROM and install from there The Guest Additions offer the following features Mouse pointer integration To overcome the limitations for mouse support that were described in chapter 3 4 1 1 Capturing and releasing keyboard and mouse page 39 this provides you with seamless mouse support You will only have one mouse pointer and pressin...

Page 61: ... host and the guest Much like ordinary Windows network shares you can tell VirtualBox to treat a certain host directory as a shared folder and VirtualBox will make it available to the guest operating system as a network share For details please refer to chapter 4 6 Folder sharing page 68 Seamless windows With this feature the individual windows that are displayed on the desktop of the virtual mach...

Page 62: ...ne in which you have installed Windows 2 Select Mount CD DVD ROM from the Devices menu in the virtual machine s menu bar and then CD DVD ROM image This brings up the Virtual Disk Man ager described in chapter 3 5 The Virtual Disk Manager page 43 3 In the Virtual Disk Manager press the Add button and browse your host file system for the VBoxGuestAdditions iso file On a Windows host you can find thi...

Page 63: ...ns can be updated by running the installation program again as previously described This will then replace the previous Additions drivers with updated versions Alternatively you may also open the Windows Device Manager and select Update driver for two devices 1 the VirtualBox Graphics Adapter and 2 the VirtualBox System Device For each choose to provide your own driver and use Have Disk to point t...

Page 64: ...As a convenience VirtualBox ships with a 32 bit driver for the AMD PCNet card which comes with the Windows Guest Additions If you install these in a 32 bit Vista guest the driver will automatically be installed as well If for some reason you would like to install the driver manually you can extract the required files from the Windows Guest Additions setup Please consult chapter 4 2 4 Manual file e...

Page 65: ...t Additions you will have to prepare your guest system for building external kernel modules This works similarly as described in chap ter 2 3 2 The VirtualBox kernel module page 21 except that this step must now be performed in your Linux guest instead of on a Linux host system as described there Again as with Linux hosts we recommend using DKMS for Linux guests as well If it is not installed use ...

Page 66: ...ver graphics modes were set up before the installation will be used If these modes do not suit your requirements you can change your setup by editing the configuration file of the X server usually found in etc X11 xorg conf VirtualBox can use any default X graphics mode which fits into the virtual video memory allocated to the virtual machine as described in chapter 3 7 1 General set tings page 46...

Page 67: ...tions for Windows and Linux described above They also come with an installation program guiding you through the setup process Installation involves the following steps 1 Mount the VBoxGuestAdditions iso file as your Solaris guest s virtual CD ROM drive exactly the same way as described for a Windows guest in chapter 4 2 1 1 Mounting the Additions ISO file page 62 If in case the CD ROM drive on the...

Page 68: ... shared folders do not need require networking Shared folders must physically reside on the host and are then shared with the guest sharing is accomplished using a special service on the host and a file system driver for the guest both of which are provided by VirtualBox In order to use this feature the VirtualBox Guest Additions have to be installed Note however that Shared Folders are only suppo...

Page 69: ... s shared folder to your Windows guest open Windows Explorer and look for it under My Networking Places Entire Network VirtualBox Shared Folders By right clicking on a shared folder and selecting Map network drive from the menu that pops up you can assign a drive letter to that shared folder Alternatively on the Windows command line use the following net use x vboxsvr sharename While vboxsvr is a ...

Page 70: ...s With the seamless windows feature of VirtualBox you can have the windows that are displayed within a virtual machine appear side by side next to the windows of your host This feature is supported for the following guest operating systems provided that the Guest Additions are installed Windows guests support added with VirtualBox 1 5 Linux or Solaris OpenSolaris guests with an X org server versio...

Page 71: ... OpenGL or DirectX 8 9 programming interfaces instead of emulating them in software which would be slow VirtualBox will attempt to use your host s 3D hardware This works for all supported host platforms Windows Mac Linux Solaris provided that your host operating system can make use of your accelerated 3D hardware in the first place The 3D acceleration currently has the following preconditions 1 It...

Page 72: ... that the virtual hardware is capable of 3D hardware acceleration When an application in the guest then requests hardware acceleration through the OpenGL or Direct3D programming interfaces these are sent to the host through a special communication tunnel imple mented by VirtualBox and then the host performs the requested 3D operation via the host s programming interfaces 4 9 Guest properties Start...

Page 73: ...uestInfo OS Product value Windows Vista Business Edition timestamp 1229098278843087000 flags Name VirtualBox GuestInfo OS Release value 6 0 6001 timestamp 1229098278950553000 flags Name VirtualBox GuestInfo OS ServicePack value 1 timestamp 1229098279122627000 flags Name VirtualBox GuestAdd InstallDir value C Program Files Sun xVM VirtualBox Guest Additions timestamp 1229098279269739000 flags Name ...

Page 74: ...099826300088000 flags Name VirtualBox GuestInfo Net 0 V4 Broadcast value 255 255 255 255 timestamp 1229099826300220000 flags Name VirtualBox GuestInfo Net 0 V4 Netmask value 255 255 255 0 timestamp 1229099826300350000 flags Name VirtualBox GuestInfo Net 0 Status value Up timestamp 1229099826300524000 flags Name VirtualBox GuestInfo OS LoggedInUsersList value username timestamp 1229099826317386000 ...

Page 75: ...explained in the next section 5 1 Hard disk controllers IDE SATA AHCI SCSI In a real PC hard disks and CD ROM DVD drives are connected to a device called hard disk controller which drives hard disk operation and data transfers VirtualBox can emulate the three most common types of hard disk controllers typically found in today s PCs IDE SCSI and SATA AHCI 1 IDE ATA controllers have been in use sinc...

Page 76: ...r this the additional controller will appear as a separate PCI device in the virtual machine Warning There are limitations with the default SCSI drivers shipped with some operating systems the standard Windows XP driver for the LsiLogic controller does not detect a hard disk attached to the controller s first port and the BusLogic controller does not work with Windows NT4 guests Finally Serial ATA...

Page 77: ... the virtual CD ROM device 2 16 slots attached to the SCSI controller or 30 slots attached to the SATA con troller provided that your guest operating system can see it In the case of SATA these can either be a in IDE compatibility mode by default slots 0 3 or b in SATA mode 5 2 Disk image files VDI VMDK VHD Disk image files reside on the host system and are seen by the guest systems as hard disks ...

Page 78: ...ther of the above image formats VDI VMDK or VHD and irrespective of whether an image is fixed size or dynamically expanding you can also specify how write op erations from the VM should affect the image 1 With normal images the default setting there are no restrictions on how guests can read from and write to the disk When you take a snapshot of your virtual machine as described in chapter 3 4 4 S...

Page 79: ...shot is taken and not restored when a VM s state is reverted To create a disk image in VDI format as write through use the VBoxManage createhd command see chapter 8 14 VBoxManage createhd page 117 To mark an existing image as write through use VBoxManage modifyhd see chapter 8 15 VBoxManage modifyhd page 118 To illustrate the differences between the various types with respect to snapshots Assume y...

Page 80: ...and is a standard that allows for using the SCSI proto col over Internet TCP IP connections Especially with the advent of Gigabit Ethernet it has become affordable to attach iSCSI storage servers simply as remote hard disks to a computer network In iSCSI terminology the server providing storage resources is called an iSCSI target while the client connecting to the server and accessing its resource...

Page 81: ...Devices IntNetIP 0 Config IP 10 0 9 1 VBoxManage setextradata VMNAME VBoxInternal Devices IntNetIP 0 Config Netmask 255 255 255 0 VBoxManage setextradata VMNAME VBoxInternal Devices IntNetIP 0 LUN 0 Driver IntNet VBoxManage setextradata VMNAME VBoxInternal Devices IntNetIP 0 LUN 0 Config Network MyIntNet VBoxManage setextradata VMNAME VBoxInternal Devices IntNetIP 0 LUN 0 Config IsService 1 Finall...

Page 82: ...y select what kind of hardware will be presented to the virtual machine VirtualBox can virtualize the following five types of networking hardware AMD PCNet PCI II AMD PCNet FAST III the default Intel PRO 1000 MT Desktop Intel PRO 1000 T Server Intel PRO 1000 MT Server The PCNet FAST III is the default because it is supported by nearly all operating systems out of the box as well as the GNU GRUB bo...

Page 83: ...rnet from programs running in the guest and providing network services for machines in a local intranet In particular if all you want is to browse the Web download files and view e mail inside the guest then the default configuration of the NAT network should be sufficient for you and you can safely skip the rest of this section Please note that the ping utility does not work over NAT and that the...

Page 84: ... from a DHCP server integrated into VirtualBox The IP address thus assigned to the virtual machine is usually on a completely different network than the host As more than one card of a virtual machine can be set up to use NAT the first card is connected to the private network 10 0 2 0 the second card to the network 10 0 3 0 and so on If you need to change the guest assigned IP range for some reaso...

Page 85: ...0 Config guestssh GuestPort 22 VBoxManage setextradata Linux Guest VBoxInternal Devices pcnet 0 LUN 0 Config guestssh HostPort 2222 The above example assumes a PCNet virtual network card if you have configured the guest to use the Intel PRO 1000 replace pcnet with e1000 in the above com mands Similarly if you want to configure a different interface instance replace the 0 with the appropriate index...

Page 86: ...e is NFS where the server is often configured to refuse connections from non privileged ports i e ports not below 1024 6 5 Bridged networking With bridged networking VirtualBox uses a device driver on your host system that filters data from your physical network adapter This driver is therefore called a net filter driver This allows VirtualBox to intercept data from the physical network and inject...

Page 87: ...inux hosts functionality is limited when using wireless interfaces for bridged networking Currently VirtualBox supports only IPv4 over wireless For other protocols such as IPv6 and IPX you must choose a wired interface Also setting the MTU to less than 1500 bytes on wired interfaces provided by the sky2 driver on the Marvell Yukon II EC Ultra Ethernet NIC is known to cause packet losses under cert...

Page 88: ...h the same internal network ID the VirtualBox support driver will automatically wire the cards and act as a network switch The VirtualBox support driver implements a complete Ethernet switch and supports both broadcast multicast frames and promiscuous mode In order to attach a VM s network card to an internal network set its networking mode to internal networking There are two ways to accomplish t...

Page 89: ...r and designed to cooperate For example one virtual machine may contain a web server and a second one a database and since they are intended to talk to each other the appliance can instruct VirtualBox to set up a host only network for the two A second bridged network would then connect the web server to the outside world to serve data to but the outside world cannot connect to the database To chan...

Page 90: ...scribed in the next section 3 VBoxSDL is an alternative simple graphical front end with an intentionally lim ited feature set designed to only display virtual machines that are controlled in detail with VBoxManage This is interesting for business environments where displaying all the bells and whistles of the full GUI is not feasible VBoxSDL is described in chapter 7 3 VBoxSDL the simplified VM di...

Page 91: ...eference page 100 Second most of these subcommands require that you specify a particular virtual machine after the subcommand There are two ways you can do this You can specify the VM name as it is shown in the VirtualBox GUI Note that if that name contains spaces then you must enclose the entire name in dou ble quotes as it is always required with command line arguments that contain spaces For ex...

Page 92: ...7 To control VM operation use one of the following To start a VM that is currently powered off use VBoxManage startvm see chapter 8 8 VBoxManage startvm page 114 for details To pause or save a VM that is currently running use VBoxManage controlvm see chapter 8 9 VBoxManage controlvm page 115 for details 7 3 VBoxSDL the simplified VM displayer VBoxSDL is a simple graphical user interface GUI that l...

Page 93: ...te machine VRDP is a backwards compatible extension to Microsoft s Remote Desktop Protocol RDP Typically graphics updates and audio are sent from the remote machine to the client while keyboard and mouse events are sent back You can use any standard RDP viewer such as the one that comes with Microsoft Windows typically found under Accessories Communication Remote Desk top Connection or on Linux sy...

Page 94: ...un remotely over VRDP then it is pointless to have a graphical user interface on the server at all especially since on a Linux or Solaris host VirtualBox comes with dependencies on the Qt and SDL libraries which is inconvenient if you would rather not have the X Window system on your server at all VirtualBox therefore comes with yet another front end that produces no visible out put on the host at...

Page 95: ...hine with a supported host operating system for the following example we will assume a Linux server 2 an ISO file on the server containing the installation data for the guest operating system to install we will assume Windows XP in the following example 3 a terminal connection to that host over which you can access a command line e g via telnet or ssh 4 an RDP viewer on the remote client on a Linu...

Page 96: ...ctly without having to register the image first see chapter 8 9 VBoxManage con trolvm page 115 for details 7 Start the virtual machine using VBoxHeadless VBoxHeadless startvm Windows XP If everything worked you should see a copyright notice If instead you are returned to the command line then something went wrong 8 On the client machine fire up the RDP viewer and try to connect to the server Assum...

Page 97: ...ersions To make a remote USB device available to a VM rdesktop vrdp should be started as follows rdesktop vrdp r usb a 16 N my host address Note that rdesktop vrdp can access USB devices only through proc bus usb Please refer to chapter 11 5 7 USB not working page 152 for further details on how to properly set up the permissions Furthermore it is advisable to disable automatic loading of any host ...

Page 98: ...intervals every 4096 packets RDP provides three different authentication methods 1 Historically RDP4 authentication was used with which the RDP client does not perform any checks in order to verify the identity of the server it connects to Since user credentials can be obtained using a man in the middle MITM attack RDP4 authentication is insecure and should generally not be used 2 RDP5 1 authentic...

Page 99: ...een output and share a mouse pointer and keyboard focus This is similar to several people using the same computer at the same time taking turns at the keyboard The following command enables multiple connection mode VBoxManage modifyvm VMNAME vrdpmulticon on If the guest uses multiple monitors then multiple connection mode must be active in order to use them at the same time see chapter 9 6 Multipl...

Page 100: ...es bridgedifs hostinfo dhcpservers hddbackends hdds dvds floppies usbhost usbfilters systemproperties VBoxManage showvminfo uuid name details statistics machinereadable VBoxManage registervm filename VBoxManage unregistervm uuid name delete VBoxManage createvm name name ostype ostype register basefolder path settingsfile path uuid uuid VBoxManage modifyvm uuid name name name ostype ostype memory m...

Page 101: ... off I O base IRQ uartmode 1 N disconnected server pipe client pipe file file devicename gueststatisticsinterval seconds audio none null dsound solaudio oss coreaudio audiocontroller ac97 sb16 clipboard disabled hosttoguest guesttohost bidirectional vrdp on off vrdpport default port vrdpaddress host vrdpauthtype null external guest vrdpmulticon on off vrdpreusecon on off usb on off usbehci on off ...

Page 102: ...e description desc discard uuid name discardcurrent state all edit uuid name current name name description desc showvminfo uuid name VBoxManage openmedium disk dvd floppy filename type normal immutable writethrough disk only VBoxManage closemedium disk dvd floppy uuid filename VBoxManage showhdinfo uuid filename VBoxManage createhd filename filename size megabytes format VDI VMDK VHD default VDI v...

Page 103: ...alue deletes key VBoxManage setproperty hdfolder default folder machinefolder default folder vrdpauthlibrary default library websrvauthlibrary default null library hwvirtexenabled yes no loghistorycount value VBoxManage usbfilter add index 0 N target uuid name global name string action ignore hold global filters only active yes no yes vendorid XXXX null productid XXXX null revision IIFF null manuf...

Page 104: ...age metrics setup period seconds samples count list host vmname metric_list VBoxManage metrics query host vmname metric_list VBoxManage metrics collect period seconds samples count list detach host vmname metric_list VBoxManage dhcpserver add modify netname network_name ip ip_address netmask network_mask lowerip lower_ip upperip upper_ip enable disable VBoxManage dhcpserver remove netname network_...

Page 105: ...yvm command 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 hostusb supplies information about USB devices attached to the host notably information useful for constructing USB filters and whether they are currently in use by the host usbfilters lists all global USB filters regis...

Page 106: ...DP disabled USB disabled USB Device Filters none Shared folders none 8 3 VBoxManage registervm unregistervm The registervm command allows you to import a virtual machine definition in an XML file into VirtualBox There are some restrictions here the machine must not conflict with one already registered in VirtualBox and it may not have any hard or removable disks attached It is advisable to place t...

Page 107: ...ies of a registered virtual machine Most of the properties that this command makes available correspond to the VM settings that VirtualBox graphical user interface displays in each VM s Settings dialog these were described in chapter 3 7 Virtual machine settings page 45 Some of the more advanced settings however are only available through the VBoxManage interface 8 5 1 General settings The followi...

Page 108: ... 4 8 Hard ware 3D acceleration OpenGL and DirectX 8 9 page 71 You can influence the BIOS logo that is displayed when a virtual machine starts up with a number of settings Per default a VirtualBox logo is displayed With bioslogofadein on off and bioslogofadeout on off you can determine whether the logo should fade in and out respectively With bioslogodisplaytime msec you can set how long the logo s...

Page 109: ...1 Hard disk controllers IDE SATA AHCI SCSI page 75 for additional information sataportcount 1 30 if the SATA controller is enabled this determines how many ports the SATA controller should support sataport 1 30 none uuid filename if the SATA controller is enabled this specifies how an SATA slot should be occupied This works just like the hd options explained above sataideemulation 1 4 1 30 if the ...

Page 110: ...ee chapter 6 1 Virtual networking hardware page 82 cableconnected 1 N on off This allows you to temporarily discon nect a virtual network interface as if a network cable had been pulled from a real network card This might be useful for resetting certain software compo nents in the VM With the nictrace options you can optionally trace network traffic by dumping it to a file for debugging purposes W...

Page 111: ...h such port you can specify arg as one of the following options disconnected Even though the serial port is shown to the guest it has no other end like a real COM port without a cable server pipename On a Windows host this tells VirtualBox to create a named pipe on the host named pipename and connect the virtual serial device to it Note that Windows requires that the name of a named pipe begin wit...

Page 112: ...on enables or disables the VM s virtual USB controller see chapter 3 7 9 1 USB settings page 54 for details usbehci on off This option enables or disables the VM s virtual USB 2 0 controller see chapter 3 7 9 1 USB settings page 54 for details 8 6 VBoxManage import This command imports a virtual appliance in OVF format by copying the virtual disk images and creating virtual machines in VirtualBox ...

Page 113: ...re numbered and depending on their type support different command line options The import subcommand can be directed to ignore many such items with a vsys X unit Y ignore option where X is the number of the virtual system zero unless there are several virtual system descriptions in the appliance and Y the item number as printed on the screen In the above example Item 1 specifies the name of the ta...

Page 114: ... 0 9 legacy mode with the legacy09 option 8 8 VBoxManage startvm This command starts a virtual machine that is currently in the Powered off or Saved states Note This is provided for backwards compatibility only We recommend to start virtual machines directly by running the respective front end as you might otherwise miss important error and state information that VirtualBox may display on the cons...

Page 115: ... a real computer Again the state of the VM is not saved beforehand and data may be lost This is equivalent to selecting the Close item in the Machine menu of the GUI or pressing the window s close button and then selecting Power off the machine in the dialog After this the VM s state will be Powered off From there it can be started again see chapter 8 8 VBoxManage startvm page 114 VBoxManage contr...

Page 116: ...h is not currently running which will cause its operating system to restart next time you start it This is the equivalent of pulling out the power cable on a physical machine and should be avoided if possible 8 11 VBoxManage snapshot This command is used for taking snapshots of a virtual machine and for manipulating and discarding snapshots The take operation takes a snapshot of a virtual machine ...

Page 117: ...atehd This command creates a new virtual hard disk image The syntax is as follows VBoxManage createhd filename filename size megabytes format VDI VMDK VHD default VDI variant Standard Fixed Split2G Stream ESX type normal writethrough default normal comment comment remember where the parameters mean filename Allows to choose a file name Mandatory size Allows to define the image capacity in 1 MiB un...

Page 118: ... addition the modifyhd compact command can be used to compact disk im ages i e remove blocks that only contains zeroes For this operation to be effective it is required to zero out free space in the guest system using a suitable software tool Microsoft provides the sdelete tool for Windows guests Execute sdelete c in the guest to zero the free disk space before compressing the virtual disk image C...

Page 119: ...his command converts a raw disk image to a VirtualBox Disk Image VDI file The syntax is as follows VBoxManage convertfromraw filename outputfile format VDI VMDK VHD variant Standard Fixed Split2G Stream ESX VBoxManage convertfromraw stdin outputfile bytes format VDI VMDK VHD variant Standard Fixed Split2G Stream ESX where the parameters mean format Select the disk image format to create Default is...

Page 120: ...et and used to identify the storage resource port TCP IP port number of the iSCSI service on the target optional lun Logical Unit Number of the target resource optional Often this value is zero username password Username and password for target authentication if required optional Note Currently username and password are stored without encryption i e in cleartext in the machine configuration file t...

Page 121: ...tproperty This command is used to change global settings which affect the entire VirtualBox installation Some of these correspond to the settings in the Global settings dialog in the graphical user interface The following properties are available hdfolder This specifies the default folder that is used to keep disk image files vdi vmdk vhd machinefolder This specifies the default folder in which vi...

Page 122: ...access to devices that fit the filter description hold or not to give them access ignore In addition you should specify parameters to filter by You can find the parameters for devices attached to your system using VBoxManage list usbhost Finally you can specify whether the filter should be active and for local filters whether they are for local devices remote over an RDP connection or either When ...

Page 123: ... SubMetric aggregate For example RAM Usage Free min stands for the minimum amount of available memory over all retained data if applied to the host object Subcommands may apply to all objects and metrics or can be limited to one object or and a list of metrics If no objects or metrics are given in the parameters the sub commands will apply to all available metrics of all objects You may use an ast...

Page 124: ...n with VirtualBox are automatically set and maintained by the Guest Additions The following subcommands are available where vm in each case can either be a VM name or a VM UUID as with the other VBoxManage commands enumerate vm patterns pattern This lists all the guest prop erties that are available for the given VM including the value This list will be very limited if the guest s service process ...

Page 125: ...enable it for a bridged network as well but that will likely cause conflicts with other DHCP servers in your physical network Use the following command line options If you use internal networking for a virtual network adapter of a virtual ma chine use VBoxManage dhcpserver add netname network_name where network_name is the same network name you used with VBoxManage modifyvm vmname intnet X network...

Page 126: ...cally start the DHCP server for given internal or host only network as soon as the first virtual machine which uses that network is started Reversely use VBoxManage dhcpserver remove with the given netname network_name or ifname hostonly_if_name to remove the DHCP server again for the given internal or host only network To modify the settings of a DHCP server created earlier with VBoxManage dhcpse...

Page 127: ... 8 VBoxManage reference page 100 and its API see chapter 10 VirtualBox programming interfaces page 143 In the configuration directory VirtualBox xml is the main configuration file This includes global configuration options and the media and virtual machine reg istry The media registry links to all CD DVD floppy and disk images that have been added to the Virtual Disk Manager For each registered VM...

Page 128: ...ably most useful if the disk containing your home directory does not have enough room to hold your VDI files which can grow very large 9 2 Automated Windows guest logons VBoxGINA When Windows is running in a virtual machine it might be desirable to perform co ordinated and automated logons of guest operating systems using credentials from a master logon system With credentials we are referring to ...

Page 129: ...nt of the Windows guest the following restrictions apply 1 For Windows XP guests the logon subsystem has to be configured to use the classical logon dialog as the VirtualBox GINA does not support the XP style wel come dialog 2 Since Windows Vista GINA has been replaced with a newer concept VBoxGINA will not work with Windows Vista or Windows 7 support for these versions will be added in a later ve...

Page 130: ... Client access has been denied VRDPAuthAccessGranted Client has the right to use the virtual machine VRDPAuthDelegateToGuest Guest operating system must authenticate the client and the library must be called again with the result of the guest authentication VRDPAuthResult VRDPAUTHCALL VRDPAuth PVRDPAUTHUUID pUuid VRDPAuthGuestJudgement guestJudgement const char szUser const char szPassword const c...

Page 131: ...ure labeling feature has been developed Secure labeling is currently available only for VBoxSDL When enabled a portion of the display area is reserved for a label in which a user defined message is displayed The label height in set to 20 pixels in VBoxSDL The label font color and background color can be optionally set as hexadecimal RGB color values The following syntax is used to enable secure la...

Page 132: ...calc html 9 5 Custom VESA resolutions Apart from the standard VESA resolutions the VirtualBox VESA BIOS allows you to add up to 16 custom video modes which will be reported to the guest operating system When using Windows guests with the VirtualBox Guest Additions a custom graphics driver will be used instead of the fallback VESA solution so this information does not apply Additional video modes c...

Page 133: ...rs for the VM VBoxManage modifyvm VMNAME monitorcount 3 The following command enables VRDP multiconnection mode for the VM VBoxManage modifyvm VMNAME vrdpmulticon on The RDP client can select the virtual monitor number to connect to using the domain logon parameter If the parameter ends with followed by a number VBox Headless interprets this number as the screen index The primary guest screen is s...

Page 134: ...BoxManage setextradata statements Since version 1 5 that way of setting up serial ports is no longer necessary and deprecated To set up virtual serial ports use the methods now described in chapter 3 7 8 Serial ports page 53 Note For backwards compatibility the old setextradata statements whose description is retained below from the old version of the manual take precedence over the new way of con...

Page 135: ...verhead of the host file system whether dynamically growing im ages are used and on host OS caching strategies The caching indirectly also affects other aspects such as failure behavior i e whether the virtual disk contains all data written before a host OS crash Consult your host OS documentation for details on this Warning Raw hard disk access is for expert users only Incorrect use or use of an ...

Page 136: ...ith VBoxManage modifyvm WindowsXP hda path to file vmdk When this is done the selected virtual machine will boot from the specified physical disk 9 10 2 Access to individual physical hard disk partitions This raw partition support is quite similar to the full hard disk access described above However in this case any partitioning information will be stored inside the VMDK image so you can e g insta...

Page 137: ...used from a virtual machine the image will then refer not to the entire disk but only to the individual partitions in the example dev sda1 and dev sda5 As a consequence read write access is only required for the affected partitions not for the entire disk During creation however read only access to the entire disk is required to obtain the partitioning information In some configurations it may be ...

Page 138: ...nfiguring the address of a NAT network interface In NAT mode the guest network interface is assigned to the IPv4 range 10 0 x 0 24 by default where x corresponds to the instance of the NAT interface 2 of that VM So x is 2 if there is only once NAT instance active In that case the guest is assigned to the address 10 0 2 15 the gateway is set to 10 0 2 2 and the name server can be found at 10 0 2 3 ...

Page 139: ...uffers has a default size of 64KB 9 12 4 Binding NAT sockets to a specific interface By default VirtualBox s NAT engine will route TCP IP packets through the default port assigned by the host s TCP IP stack The technical reason for this is that the NAT engine uses sockets for communication If for some reason you want to change this behavior you can tell the NAT engine to bind to a particular IP ad...

Page 140: ... the user manually resizes them by dragging the window switching to fullscreen or seamless mode or sending a video mode hint using VBoxManage This behavior is what most users will want but if you have different needs it is possible to change it by issuing one of the following commands from the command line VBoxManage setextradata global GUI MaxGuestResolution any will remove all limits on guest re...

Page 141: ...counter TSC to reflect guest execution By default VirtualBox keeps all sources of time visible to the guest synchronized to a single time source the monotonic host time This reflects the assumptions of many guest operating systems which expect all time sources to reflect wall clock time In special circumstances it may be useful however to make the TSC time stamp counter in the guest reflect the ti...

Page 142: ... VM VBoxInternal Devices ahci 0 Config Port0 SerialNumber serial VBoxManage setextradata My VM VBoxInternal Devices ahci 0 Config Port0 FirmwareRevision firmware VBoxManage setextradata My VM VBoxInternal Devices ahci 0 Config Port0 ModelNumber model The serial number is a 20 byte alphanumeric string the firmware revision an 8 byte alphanumeric string and the model number a 40 byte alphanumeric st...

Page 143: ...ol VirtualBox programmatically With VirtualBox all programming information documentation reference informa tion header and other interface files as well as samples have been split out to a separate Software Development Kit SDK which is available for download from http www virtualbox org In particular the SDK comes with a Program ming Guide and Reference in PDF format which contains among other thi...

Page 144: ...alBox supplying the corresponding log file is mandatory For convenience for each virtual machine the VirtualBox main window can show these logs in a window To access it select a virtual machine from the list on the left and select Show logs from the Machine window 11 1 2 Guest shows IDE errors for VDI on slow host file system Occasionally some host file systems provide very poor writing performanc...

Page 145: ...unnecessarily low will cost performance without providing any benefits An interval of 1 will cause a flush for each write operation and should solve the problem in any case but has a severe write performance penalty Providing a value of 0 for b is treated as an infinite flush interval effectively disabling this workaround Removing the extra data key by specifying no value for b has the same effect...

Page 146: ...t this is due to a race condition in Windows A hotfix is available 1 If this does not help please reduce the number of virtual processors to 1 11 2 3 Windows 2000 installation failures When installing Windows 2000 guests you might run into one of the following issues Installation reboots usually during component registration Installation fills the whole hard disk with empty log files Installation ...

Page 147: ...ltOnReset 1 11 2 5 No networking in Windows Vista guests Unfortunately with Vista Microsoft dropped support for the virtual AMD PCNet card that we are providing to virtual machines As a result after installation Vista guests initially have no networking VirtualBox therefore ships a driver for that card with the Windows Guest Additions see chapter 4 2 5 Windows Vista networking page 64 Starting wit...

Page 148: ...VBoxSVC out of process COM server issues VirtualBox makes use of the Microsoft Component Object Model COM for inter and intra process communication This allows VirtualBox to share a common configuration among different virtual machine processes and provide several user interface options based on a common architecture All global status information and configuration is maintained by the process VBox...

Page 149: ...RDP client called Remote Desktop Connection there can be large delays between input moving the mouse over a menu is the most obvious situation and output This is because this RDP client collects input for a certain time before sending it to the VRDP server built into VirtualBox The interval can be decreased by setting a Windows registry key to smaller values than the default of 100 The key does no...

Page 150: ...does not affect the performance of other applications running on the host 11 5 Linux hosts 11 5 1 Linux kernel module refuses to load If the VirtualBox kernel module vboxdrv refuses to load i e you get an Error in serting vboxdrv Invalid argument check as root the output of the dmesg command to find out why the load failed The most common reasons are With Linux 2 6 19 and higher the NMI watchdog m...

Page 151: ...ox tests for dev fd devices by default and this can be overridden with the VBOX_FLOPPY environment variable 11 5 5 Strange guest IDE error messages when writing to CD DVD If the experimental CD DVD writer support is enabled with an incorrect VirtualBox host or guest configuration it is possible that any attempt to access the CD DVD writer fails and simply results in guest kernel error messages for...

Page 152: ...cessible from the user account they are running under VBoxSVC owns the VirtualBox configuration database which normally resides in VirtualBox While it is running the configuration files are locked Com munication between the various VirtualBox components and VBoxSVC is performed through a local domain socket residing in tmp vbox username ipc In case there are communication problems i e a VirtualBox...

Page 153: ...command in etc init d mountkernfs sh Since that distribution has no group usb it is also the easiest solution to allow all members of the group vboxusers to access the USB subsystem Modify the line domount usbfs usbdevfs proc bus usb onoexec nosuid nodev so that it contains domount usbfs usbdevfs proc bus usb onoexec nosuid nodev devgid 85 devmode 664 As usual replace the 85 with the actual group ...

Page 154: ...rts with out of memory errors on Solaris 10 hosts Solaris 10 hosts bug 1225025 requires swap space equal to or greater than the host s physical memory size For example 8 GB physical memory would require at least 8 GB swap This can be configured during a Solaris 10 install by choosing a custom install and changing the default partitions For existing Solaris 10 installs an additional swap image need...

Page 155: ...s guests ability to use Direct3D 8 9 applications games experimental see chapter 4 8 Hardware 3D acceleration OpenGL and DirectX 8 9 page 71 Support for OpenGL 2 0 for Windows Linux and Solaris guests In addition the following items were fixed and or added Solaris hosts allow suspend resume on the host when a VM is running bug 3826 Solaris hosts loosen the restriction for contiguous physical memor...

Page 156: ...ort wizards bug 4157 3D support fixed VM crashes for client applications using incorrect OpenGL states 3D support fixed memory corruption when querying for supported texture com pression formats 3D support fixed incorrect rendering of glDrawRangeElements 3D support fixed memory leak when using VBOs 3D support fixed glew library detection 3D support fixed random textures corruption VRDP support Win...

Page 157: ...reating files Shared Folders some content was incorrectly written under certain conditions bug 11187 Shared Folders fixed incorrect file timestamps when using Windows guest on a Linux host bug 3404 X11 clipboard fix duplicate end of lines bug 4270 X11 guests a number of shared clipboard fixes Linux guests Guest Additions support for SUSE Linux Enterprise Desktop 11 Linux guests new daemon vboxadd ...

Page 158: ...uild 114 or later bug 3981 Solaris hosts fixed a bug serial port character handling found during loopback bug 3120 Linux hosts adapted vboxdrv sh to the latest changes in VBoxManage list runningvms bug 4034 Windows hosts fixed a crash caused by host only bridged networking Mac OS X hosts fixed access to host DVD with passthrough disabled bug 4077 Guest Additions fixed problems with KDE 4 not recog...

Page 159: ... bug 3964 Shared Folders deny access to parent directories on Windows hosts bug 4090 Shared Folders make rm rmdir work with Solaris guests on Windows hosts Networking fixed the problem with blocked receiving thread when a broadcast packet arrives too early to be handled by uninitialized e1000 adapter Networking fixed the problem that caused host freezes crashes when using bridged mode with host s ...

Page 160: ...ounting a busy shared folder Windows Additions fixed mouse pointer integration of some Windows guests 2 2 0 regression bug 3734 Windows Additions fixed installation on Windows Server 2008 Core bug 2628 Main do not try to use older versions of D Bus Linux hosts only bug 3732 VMM fixed out of memory conditions on Windows hosts bug 3657 VMM fixed occasional hangs when attaching USB devices during VM ...

Page 161: ... fixed host only network interface incompatibility with nwam dhcpagent bug 3754 Windows installer fixed several install and uninstall issues bugs 3659 3686 1730 3711 3373 3382 3701 3685 3710 Mac OS X hosts preliminary support for Snow Leopard 12 4 Version 2 2 0 2009 04 08 This version is a major update The following major new features were added OVF Open Virtualization Format appliance import and ...

Page 162: ...MD V only VMM significant speedup of certain GRUB boot loaders e g Solaris VT x AMD V only VMM real mode IOPL fix for DOS guests VT x only VMM fixed VT x detection with certain BIOSes that enable VT x but don t set the lock bit in MSR_IA32_FEATURE_CONTROL VMM fixed hibernation issues on Windows XP hosts VT x only bug 1794 VMM properly emulate RDMSR from the TSC MSR should fix some NetBSD guests VM...

Page 163: ...ts added xpg4 xcu4 dependency to the guest additions installer bug 3524 Windows guests bind the VBoxMouse sys filter driver to the correct guest point ing device bug 1324 Windows hosts fixed BSOD when starting a VM with enabled host interface bug 3414 Linux hosts do proper reference counting to prevent unloading the vboxnetflt module as long as this code is in use bug 3104 Linux hosts do not leave...

Page 164: ...r GUI show build revision in about dialog GUI fixed sticky status bar text GUI improved error dialogs GUI fail with an appropriate error message when trying to boot a read only disk image bug 1745 GUI Mac OS X fixed disabled close button GUI Windows re enabled support for copy and paste Windows hosts 2 0 re gression bug 2065 3D support added OpenGL select feedback support bug 2920 3D support close...

Page 165: ...ilable bug 3136 Linux hosts fixed warnings in installer when SELinux was disabled bug 3098 Linux hosts VirtualBox sometimes failed to start if it had been started using sudo previously bug 3270 Solaris hosts fixed high CPU load while running many guests in parallel Solaris hosts fixed inability to start more than 128 VMs VMM fixed performance regression for Windows guests bug 3172 VMM ignore CPU s...

Page 166: ...crash when pausing the VM 3D support added missing GL_MAX_TEXTURE_COORDS_ARB bug 3246 Windows Additions fixed ERROR e0000101 error during installation bug 1923 Windows Additions fixed Windows Explorer hang when browsing shared folders with 64 bit guests bug 2225 Windows Additions fixed guest screen distortions during a video mode change Windows Additions fixed the Network drive not connected messa...

Page 167: ...EFER_SVME after probing for AMD V bug 3058 VMM fixed guru meditation during Windows 7 boot with more than 2 GB guest RAM VT x nested paging only VMM fixed hang during OS 2 MCP2 boot AMD V and VT x only VMM fixed loop during OpenBSD 4 0 boot VT x only VMM fixed random crashes related to FPU XMM with 64 bits guests on 32 bits hosts VMM fixed occasional XMM state corruption with 64 bits guests GUI ra...

Page 168: ... without assigned IP ad dresses Linux hosts only bug 2780 Networking fixed the issue with sent packets coming back to internal network when using hostif Linux hosts only bug 3056 NAT fixed port forwarding Windows hosts only bug 2808 NAT fixed booting from the builtin TFTP server bug 1959 NAT fixed occasional crashes bug 2709 SATA vendor product data VPD is now configurable SATA raw disk partitions...

Page 169: ...ning or paused VMs when the host ma chine s battery reaches critical level Mac OS X hosts improved window resizing of the VM window Mac OS X hosts added GUI option to disable the dock icon realtime preview in the GUI to decrease the host CPU load when the guest is doing 3D Mac OS X hosts polished realtime preview dock icon Windows Additions fixed guest property and logging OS type detection for Wi...

Page 170: ...l Nehalem virtualization enhancements EPT and VPID see chapter 1 2 Software vs hardware virtualization VT x and AMD V page 11 Experimental 3D acceleration via OpenGL see chapter 4 8 Hardware 3D accel eration OpenGL and DirectX 8 9 page 71 Experimental LsiLogic and BusLogic SCSI controllers see chapter 5 1 Hard disk controllers IDE SATA AHCI SCSI page 75 Full VMDK VHD support including snapshots se...

Page 171: ... V only GUI pause running VMs when the host machine goes into suspend mode Win dows Mac OS X hosts GUI resume previously paused VMs when the host machine resumes after sus pend Windows Mac OS X hosts GUI save the state of running or paused VMs when the host machine s battery reaches critical level Windows hosts GUI properly restore the position of the selector window when running on the compiz win...

Page 172: ...e and stability fixes for Windows guests Microsoft Office Applications 12 8 Version 2 0 8 2009 03 10 This is a maintenance release The following items were fixed and or added VMM fixed guest hangs when restoring VT x or AMD V saved states snapshots VMM fixed memory allocation issues which can cause VM start failures with VERR_PGM_MAPPING_CONFLICT error VMM fixed host crashes hangs on certain 32 bi...

Page 173: ... V bug 2565 VMM fixed Solaris 10U6 reboot hangs AMD V only bug 2565 GUI the host key was sometimes not properly displayed Windows hosts only bug 1996 GUI the keyboard focus was lost after minimizing and restoring the VM window via the Windows taskbar bugs 784 VBoxManage properly show SATA disks when showing the VM information bug 2624 SATA fixed access if the buffer size is not sector aligned bug ...

Page 174: ...es bug 2461 Windows Additions fixed shared folders access with MS Office bug 2591 Linux Additions fixed compilation of vboxvfs ko for 64 bit guests bug 2550 SDK added JAX WS port caching to speedup connections 12 10 Version 2 0 4 2008 10 24 This is a maintenance release The following items were fixed and or added VMM better error reporting for VT x failures VMM don t overflow the release log with ...

Page 175: ... networking going stale while using host interface networking bug 2474 Solaris hosts added support for using unplumbed network interfaces and Cross bow Virtual Network Interfaces VNICs with host interface networking Solaris hosts reworked threading model improves performance for host inter face networking Windows Additions fixed crash when accessing deep directory structures in a shared folder Win...

Page 176: ... fixed invalid error message for a changed snapshot path even if that path wasn t changed bug 2064 GUI fixed crash when creating a new hard disk image bug 2060 GUI fixed crash when adding a hard disk in the VM settings bug 2081 GUI fixed a bug where VirtualBox isn t working with the new QGtkStyle plugin bug 2066 GUI fixed VM close dialog in seamless mode Mac OS X hosts only bug 2067 GUI fixed stan...

Page 177: ...for the latter Linux Additions added installer check for the system architecture Linux Additions fixed Xorg modules path for some Linux distributions bug 2128 VMDK be more liberal with ambiguous parts of the format specification and accept more format variants bug 2062 VHD fixed a bug in the VHD backend which resulted in reading the wrong data bug 2085 Solaris hosts fixed kernel panic on certain m...

Page 178: ...O NCQ Native Command Queuing when accessing raw disks partitions major performance gain Clipboard integration for OS 2 Guests Created separate SDK component featuring a new Python programming interface on Linux and Solaris hosts Support for VHD disk images In addition the following items were fixed and or added VMM VT x fixes AHCI improved performance GUI keyboard fixes Linux installer properly un...

Page 179: ...mmunication with MS Remote Desktop Connection on Mac OS X bug 1337 VRDP clipboard fixes bug 1410 VRDP fixed crash during PAM authentication bug 1953 Shared Folders fixed a regression introduced in version 1 6 2 the shared folders service was sometimes not properly installed Windows guests only bug 1915 Shared Folders don t deny to load a VM if a shared folder is not accessible bug 822 BIOS allow t...

Page 180: ...ile mode bug 1776 Documentation added a note that jumbo frames don t work bug 1877 Documentation document special host interface names on openSUSE11 bug 1892 12 14 Version 1 6 4 2008 07 30 This is a maintenance release The following items were fixed and or added AMD V VT x stability fixes Shared Folders fixed host crash Solaris host only bugs 1336 1646 Shared Folders fixed BSOD when debugging with...

Page 181: ...web service examples mentioned in the manual Linux hosts properly deregister the Linux kernel module before uninstalling a Linux deb rpm package Linux hosts kernel module works now with Linux 2 6 27 Linux hosts fixed a typo in the vboxnet setup script for host network interfaces bug 1714 Linux hosts fixed usage of tar in installer bug 1767 Linux hosts fixed long guest shutdown time when serial por...

Page 182: ...ers on certain AMD Phenom mother boards Windows host only VMM fixed KVM check Linux hosts only VMM fixed a regression introduced in 1 6 0 Windows stuck during installation XPCOM fixed several races SATA improved performance with Vista guests SATA fixed statistics counter Shared Folders several fixes iTunes download speed up browsing ATA IDE fixed boot from CDROM if a medium was added while the boo...

Page 183: ...n use Shared Folders on Windows guests Linux hosts fixed default runlevel for the kernel module helper script Solaris hosts enabled support for VT x and AMD V Solaris hosts dynamic loading of libdlpi fixes a problem where Solaris 10 was not able to start a VM Linux Additions fixed runlevels for kernel module helper scripts Linux Additions compatibility fixes with Linux 2 6 26 Linux Additions fixed...

Page 184: ...images from growing unnecessarily Network support PXE booting with NAT Network fixed the Am79C973 PCNet emulation for Nexenta guests NAT improved builtin DHCP server implemented DHCPNAK response NAT port forwarding stopped when restoring the VM from a saved state NAT make subnet configurable XPCOM moved to libxml2 XPCOM fixed VBoxSVC autostart race Audio SoundBlaster 16 emulation USB fixed problem...

Page 185: ...nce release It adds an experimental Intel Gigabit Ethernet device emulation and read only shared folders GUI fixed several error messages GUI fixed registration dialog crashes once and for all GUI really ask before resetting the VM GUI release mouse and keyboard before the host activates the screensaver GUI fixed issue with license display on big screens GUI added setting for network name for inte...

Page 186: ...d list runningvms command VBoxManage improved the compatibility when reading the partition table of a raw disk Shared Folders added support for read only shared folders Shared Clipboard several fixes Network don t crash if the device is activated but not attached Network experimental support for Intel Gigabit Ethernet E1000 device emu lation iSCSI better check for misconfigured targets iSCSI allow...

Page 187: ...w to enter unicode characters to the name of the registration dialog GUI pre select attached media in the disk manager when opened from the VM settings dialog GUI remember the last active VM GUI ask before reset the VM GUI don t accept empty paths for serial parallel ports in XML GUI fixed NumLock CapsLock synchronization on Windows hosts GUI don t start the kernel timer if no VM is active Linux h...

Page 188: ...face fixes for Solaris guests Network guest networking stopped completely after taking a snapshot Network don t crash if a network card is enabled but not attached PXE fix for PXE EC8 error on soft reboot NAT update the DNS server IP address on every DNS packet sent by the guest VGA reset VRAM access handers after a fullscreen update VGA don t overwrite guest s VRAM when displaying a blank screen ...

Page 189: ... files on shared folders Linux Additions make Additions work with Fedora 8 SELinux policy added Linux Additions sometimes ARGB pointers were displayed incorrectly Linux Additions several small script fixes 12 19 Version 1 5 2 2007 10 18 This version is a maintenance release and mainly addresses issues discovered in VirtualBox 1 5 0 and improves compatibility with new guest and host OS revisions Wi...

Page 190: ...dows 64 bit hosts VMM improved compatibility with Linux KVM VMM fixed issues with Fedora 8 guests VMM fixed fatal errors while installing Windows guests when using AMD V VMM fixed sporadic hangs when minimizing VM window and using VT x AMD V VMM fixed high load of ksoftirq on tickless Linux hosts VMM fixed Windows 2000 guests hangs related to IRQ sharing VMM fixed sporadic errors during openSUSE 1...

Page 191: ...dary screens Windows Additions several fixes and improvements for DirectDraw Windows Additions improved the mouse filter driver compatibility with other mouse drivers Linux Additions several fixes and enhancements to Shared Folders Linux Additions added support for X org Server 1 4 Shared Folders fixed MS Powerpoint access issues Linux host API fixed RPC_E_CHANGED_MODE startup error on Windows hos...

Page 192: ...ent variable GUI download Guest Additions from virtualbox org in case they are not present locally VRDP support for multimonitor configurations in Windows guests VRDP support for MS RDP6 and MS RDP Mac clients VRDP added support for WinConnect RDP client VRDP performance improvements VRDP fixed sporadic client disconnects VBoxManage never delete existing target during clonevdi VBoxManage properly ...

Page 193: ...f the IRQ line between master and slave drive IDE guest could freeze when unmounting the CD DVD drive VGA several text mode fixes in particular with Windows DOS boxes USB fixed some issues with Windows hosts USB fixed race condition between udev and USB filters Linux host Shared Folders reversed network provider order to increase mapping perfor mance Windows guest Shared Folders browsable from Win...

Page 194: ...host GUI added configuration options for clipboard synchronization GUI improved keyboard handling on Linux hosts GUI added first run wizard GUI improved boot device order dialog GUI auto resize did not work after save restore GUI restore original window size when returning from fullscreen mode GUI fixed screen update when switching to fullscreen mode GUI the size of the VM window was sometimes res...

Page 195: ...em loads VM starvation VMM experimental AMD SVM hardware virtualization support now also handles real and protected mode without paging VMM added system time offset parameter to allow for VMs to run in the past or future VMM provide an MPS 1 4 table if the IOAPIC is enabled VRDP allow binding the VRDP server to a specific interface VRDP added support for clipboard synchronization VRDP fixed proble...

Page 196: ...ter save restore USB rewrote Windows USB handling without the need for a filter driver USB possible to steal arbitrary devices in Windows Serial added serial ports with support for named pipes local domain sockets on the host Audio fixed problem with ALSA on Linux before 2 6 18 blocking other ALSA clients on the system Audio fixed problem with ALSA on AMD64 hosts Input fixed PS 2 mouse detection i...

Page 197: ...y old vboxdrv modules in lib modules misc Linux installer many small improvements for deb and rpm packages Linux installer improved setup of kernel module GUI Host Fn sends Ctrl Alt Fn to the guest Linux guest VT switch GUI fixed setting for Internal Networking GUI show correct audio backend on Windows dsound GUI improved error messages if the kernel module is not accessible GUI never fail to star...

Page 198: ...lation Linux installer added RPM for openSUSE 10 2 GUI fixed problems with several keyboard layouts on Linux hosts GUI added online help on Linux hosts using kchmviewer GUI fixed handle leak on Windows hosts Graphics increased VRAM limit to 128MB BIOS fixed CD DVD ROM detection in Windows Vista guests VMM fixed incompatibility with OpenBSD 4 0 VDI fixed issues with snapshot merging Network fixed i...

Page 199: ...about how to get back GUI several fixes and improvements VMM fixed occasional crashes when shutting down a Windows guest VMM fixed crash while loading Xorg on openSUSE 10 2 VMM fixed problems with OpenBSD 3 9 and 4 0 VMM fixed crash while loading XFree86 in SUSE 9 1 VMM fixed Debian 3 1 Sarge installation problem network failure VMM fixed crash during SUSE 10 2 installation VMM fixed crash during ...

Page 200: ...m sources instead of using precompiled objects Linux Additions better compatibility with older glibc versions Linux Additions when uninstalling only delete the files we put there during installation don t remove the directory recursively to prevent unwanted data loss Linux Installer added support for Slackware Linux Additions added support for Linux 2 4 28 to 2 4 34 VRDP fixed sporadic disconnects...

Page 201: ... added packages for Ubuntu 6 10 Edgy Eft Ubuntu 6 06 LTS Dapper Drake and Debian 4 0 Etch 12 26 Version 1 2 4 2006 11 16 Several bug fixes that accidentally didn t make it into 1 2 2 12 27 Version 1 2 2 2006 11 14 Note Guest Additions have to be updated for the enhanced VRDP features to work Linux Additions improved compatibility with Red Hat distributions Linux Additions enhanced display performa...

Page 202: ...port for capturing network traffic GUI added fullscreen mode GUI fixed several problems 12 28 Version 1 1 12 2006 11 14 Additions enabled more display modes for X org 7 x VMM stability improvements VMM resolved excessive performance degradation caused by Symantec An tivirus iSCSI fixed memory corruption issue VBoxSDL made hostkey configurable VRDP report error in case binding to the port fails VRD...

Page 203: ...oved performance reliability and better standards compliance IDE added experimental support for ATAPI passthrough to use CD DVD burners inside VMs VMM fixed user mode IOPL handling hwclock failure VMM fixed crashes upon termination in Linux X servers VMM fixed problems with Knoppix 5 0 and other Linux kernels 2 6 15 VMM improved handling of self modifying code aka Linux 2 6 15 errors VMM introduce...

Page 204: ...indows 2000 installation problems due to a bug in the Windows disk driver see troubleshooting section VRDP provide extensive connection information also exposed through VBox Manage Linux module added support for Linux 2 6 16 VBoxManage improved support for immutable disk images iSCSI several fixes USB several fixes VBoxSDL added switch for fixed video mode and guest image centering VMM improved pe...

Page 205: ... compliant iSCSI initiator for transparent access of iSCSI targets VBoxSDL ship on Windows as well VBoxManage added command to clone a VDI file to another one having a dif ferent UUID Additions added Linux Additions timesync mouse pointer integration and graphics driver Additions added Shared Folders for Windows guests except NT Linux module fixed compilation problem on SUSE 10 system Linux instal...

Page 206: ...multiple batteries are present on the host Linux hosts ACPI enabled by default for newly created VMs APIC added optional I O APIC Graphics fixed distortion when changing guest color depth without changing the resolution VRDP added support for remote USB requires special rdesktop client VRDP added support for the Microsoft RDP client VRDP improved audio support Floppy controller can be disabled Flo...

Page 207: ...on 1 0 48 2005 11 23 Note The configuration has to be deleted as the format has changed On Linux issue rm rf VirtualBox On Windows remove the directory C Documents and Set tings username VirtualBox If you fail to do so VirtualBox will not startup Note Guest Additions have to be updated VMM fixed a Linux 2 6 guest panic on certain P4 CPUs VMM performance improvements Graphics fixed y offset handlin...

Page 208: ...ention mode Graphics fixes for dynamic resolution handling Linux module yet another kernel panic fix due to weird patches in RedHat Enterprise Linux 4 Update 2 VBoxSVC if VBOX_USER_HOME is set look for configuration in this directory default HOME VirtualBox 12 37 Version 1 0 44 2005 10 25 Note Guest Additions have to be updated Installer greatly improved Windows installer fixed uninstall and perfo...

Page 209: ... Note Guest Additions have to be updated USB added USB support for Windows hosts Network renamed TUN to Host Interface Networking and TAP on Linux Network added support for Host Interface Networking on Windows hosts Network added cable connected property to the virtual network cards Floppy added a virtual floppy drive to the VM and support for attaching floppy images and capturing host floppy driv...

Page 210: ...up logo animation configurable for OEM customers BIOS fixed network card detection under DOS Graphics fixed VESA modes in XP and XFree86 X org Network fixed Linux guest issues Network fixed NAT DHCP server to work with MS DOS TCP IP Network fixed performance issue under heavy guest CPU load Network fixed errors with more than one network card USB added experimental USB support for Linux hosts VMM ...

Page 211: ...ace scrambling ACPI added experimental ACPI support VRDP added shadow buffer for reduced bandwidth usage VRDP added support for pointer shapes and remote pointer cache GUI added support for pointer shapes Windows Additions added support for high resolution video modes including multi screen modes 2 3 and 4 screens VBoxManage added new command line tool to automate simple administration tasks witho...

Page 212: ...ave more than 512MB of RAM VMM resolved compatibility issues with SMP systems Windows Host VRDP process cleanup on Linux fixed Linux module fixed build error on Red Hat 2 4 21 15 EL NT Additions fixed installation and a trap Win2k XP Additions fixed installation 12 42 Version 1 0 37 2005 04 12 Initial build with change log 212 ...

Page 213: ... protection mechanism will interfere with the replacement DLLs installed by VirtualBox and keep restoring the original Windows system DLLs Shrinking virtual disk images is limited to VDI files The VBoxManage modifyhd compact command is currently only implemented for VDI files At the moment the only way to optimize the size of a virtual disk images in other formats VMDK VHD is to clone the image an...

Page 214: ...e following issues OpenGL windows aren t updated in the Dock Icon real time preview There are several redraw problems with compiz enabled window man agers on Linux guests E g after save restore state or a resize of the guest window OpenGL host support is not yet available on 64 bit kernels Mac OS X 10 6 Linux hosts There are a few problems when compiz is used as the host s win dow manager notably ...

Page 215: ...sing wireless with bridged networking On Solaris 10 U4 zones are not supported Guest Additions for OS 2 Shared folders are not yet supported with OS 2 guests In addition seamless windows and automatic guest resizing will prob ably never be implemented due to inherent limitations of the OS 2 graphics system 215 ...

Page 216: ...rtualBox contains code which is governed by the license in chapter 14 2 4 X Consortium License X11 page 237 and Copyright 2004 by the Massachusetts Institute of Technology VirtualBox contains code of the BOCHS VGA BIOS which is governed by the license in chapter 14 2 2 GNU Lesser General Public License LGPL page 223 and Copyright C 2001 2002 the LGPL VGABios developers Team VirtualBox contains cod...

Page 217: ...e license in chapter 14 2 1 GNU General Public License GPL page 218 with the exception that ag gregating Etherboot with another work does not require the other work to be re leased under the same license see http etherboot sourceforge net clinks html Etherboot is Copyright C Etherboot team VirtualBox may contain code from Wine which is governed by the license in chapter 14 2 2 GNU Lesser General P...

Page 218: ...2 and Copyright c 2003 2004 2005 Armin Wolfermann 14 2 Licenses 14 2 1 GNU General Public License GPL GNU GENERAL PUBLIC LICENSE Version 2 June 1991 Copyright C 1989 1991 Free Software Foundation Inc 51 Franklin St Fifth Floor Boston MA 02110 1301 USA Everyone is permitted to copy and distribute verbatim copies of this license docu ment but changing it is not allowed Preamble The licenses for most...

Page 219: ...ryone s free use or not licensed at all The precise terms and conditions for copying distribution and modification follow GNU GENERAL PUBLIC LICENSE TERMS AND CONDITIONS FOR COPYING DIS TRIBUTION AND MODIFICATION 0 This License applies to any program or other work which contains a notice placed by the copyright holder saying it may be distributed under the terms of this General Public License The ...

Page 220: ...u distribute them as separate works But when you distribute the same sections as part of a whole which is a work based on the Program the distribution of the whole must be on the terms of this License whose permissions for other licensees extend to the entire whole and thus to each and every part regardless of who wrote it Thus it is not the intent of this section to claim rights or contest your r...

Page 221: ...se grants you permission to modify or distribute the Program or its derivative works These actions are prohibited by law if you do not accept this License Therefore by modifying or distributing the Program or any work based on the Program you indicate your acceptance of this License to do so and all its terms and conditions for copying distributing or modifying the Program or works based on it 6 E...

Page 222: ... the Program specifies a version number of this License which applies to it and any later version you have the option of following the terms and conditions either of that version or of any later version published by the Free Software Foundation If the Program does not specify a version number of this License you may choose any version ever published by the Free Software Foundation 10 If you wish t...

Page 223: ...ou can use it too but we suggest you first think carefully about whether this license or the ordinary General Public License is the better strategy to use in any particular case based on the explanations below When we speak of free software we are referring to freedom of use not price Our General Public Licenses are designed to make sure that you have the freedom to distribute copies of free softw...

Page 224: ...oes Less to protect the user s freedom than the ordinary General Public License It also provides other free software developers Less of an advantage over competing non free programs These disadvantages are the reason we use the ordinary General Public License for many libraries However the Lesser license provides advantages in certain special circumstances For example on rare occasions there may b...

Page 225: ...onstitute a work based on the Library independent of the use of the Library in a tool for writing it Whether that is true depends on what the Library does and what the program that uses the Library does 1 You may copy and distribute verbatim copies of the Library s complete source code as you receive it in any medium provided that you conspicuously and appropri ately publish on each copy an approp...

Page 226: ...er all the notices that refer to this License so that they refer to the ordinary GNU General Public License version 2 instead of to this License If a newer version than version 2 of the ordinary GNU General Public License has appeared then you can specify that version instead if you wish Do not make any other change in these notices Once this change is made in a given copy it is irreversible for t...

Page 227: ...y is used in it and that the Library and its use are covered by this License You must supply a copy of this License If the work during execution displays copyright notices you must include the copyright notice for the Library among them as well as a reference directing the user to the copy of this License Also you must do one of these things a Accompany the work with the complete corresponding mac...

Page 228: ... uncom bined form of the same work 8 You may not copy modify sublicense link with or distribute the Library except as expressly provided under this License Any attempt otherwise to copy modify sub license link with or distribute the Library is void and will automatically terminate your rights under this License However parties who have received copies or rights from you under this License will not...

Page 229: ...er this License may add an explicit geographical distribution limitation excluding those countries so that distribution is permitted only in or among countries not thus excluded In such case this License incorporates the limitation as if written in the body of this License 13 The Free Software Foundation may publish revised and or new versions of the Lesser General Public License from time to time...

Page 230: ...a third party 1 1 Contributor means each entity that creates or contributes to the creation of Modifications 1 2 Contributor Version means the combination of the Original Code prior Mod ifications used by a Contributor and the Modifications made by that particular Con tributor 1 3 Covered Code means the Original Code or Modifications or the combination of the Original Code and Modifications in eac...

Page 231: ...rposes of this definition control means a the power direct or indirect to cause the direction or management of such entity whether by contract or otherwise or b ownership of more than fifty percent 50 of the outstanding shares or beneficial ownership of such entity 2 Source Code License 2 1 The Initial Developer Grant The Initial Developer hereby grants You a world wide royalty free non exclusive ...

Page 232: ...the terms of this License or a future version of this License released under Section 6 1 and You must include a copy of this License with every copy of the Source Code You distribute You may not offer or impose any terms on any Source Code version that alters or restricts the applicable version of this License or the recipients rights hereunder However You may include an additional document offeri...

Page 233: ...ship rights relating to Covered Code You may choose to offer and to charge a fee for warranty support indemnity or liability obligations to one or more recipients of Covered Code However You may do so only on Your own behalf and not on behalf of the Initial Developer or any Contributor You must make it absolutely clear than any such warranty support indemnity or liability obligation is offered by ...

Page 234: ...has been published under a partic ular version of the License You may always continue to use it under the terms of that version You may also choose to use such Covered Code under the terms of any subse quent version of the License published by Netscape No one other than Netscape has the right to modify the terms applicable to Covered Code created under this License 6 3 Derivative Works If You crea...

Page 235: ...withdrawn the rights granted by Participant to You under Sections 2 1 and or 2 2 automatically terminate at the expiration of the 60 day notice period specified above b any software hardware or device other than such Participant s Contributor Version directly or indirectly infringes any patent then any rights granted to You by such Participant under Sections 2 1 b and 2 2 b are revoked effective a...

Page 236: ... trict of California with venue lying in Santa Clara County California with the losing party responsible for costs including without limitation court costs and reasonable attorneys fees and expenses The application of the United Nations Convention on Contracts for the International Sale of Goods is expressly excluded Any law or reg ulation which provides that the language of a contract shall be co...

Page 237: ...n including without limitation the rights to use copy modify merge publish distribute sublicense and or sell copies of the Software and to permit per sons to whom the Software is furnished to do so subject to the following conditions The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software THE SOFTWARE IS PROVIDED AS IS WITHOUT W...

Page 238: ...s list of condi tions and the following disclaimer 2 Redistributions in binary form must reproduce the above copyright notice this list of conditions and the following disclaimer in the documentation and or other materials provided with the distribution 3 All advertising materials mentioning features or use of this software must display the following acknowledgement This product includes cryptogra...

Page 239: ...IRECT INDIRECT INCIDENTAL SPECIAL EXEMPLARY OR CONSEQUENTIAL DAMAGES INCLUDING BUT NOT LIMITED TO PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES LOSS OF USE DATA OR PROFITS OR BUSINESS INTERRUP TION HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY WHETHER IN CON TRACT STRICT LIABILITY OR TORT INCLUDING NEGLIGENCE OR OTHERWISE ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE EVEN IF ADVISED OF THE POSS...

Page 240: ...is Copyright notice may not be removed or altered from any source or altered source distribution The Contributing Authors and Group 42 Inc specifically permit without fee and encourage the use of this source code as a component to supporting the PNG file format in commercial products If you use this source code in a product acknowledgment is not required but would be appreciated 14 2 10 lwIP licen...

Page 241: ...NOT LIMITED TO THE WARRANTIES OF MER CHANTABILITY FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT IN NO EVENT SHALL THE DANIEL VEILLARD BE LIABLE FOR ANY CLAIM DAMAGES OR OTHER LIABILITY WHETHER IN AN ACTION OF CONTRACT TORT OR OTHER WISE ARISING FROM OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE Except as contained in this notice the name of Daniel Ve...

Page 242: ...ANTIES OF MER CHANTABILITY FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM DAMAGES OR OTHER LIABILITY WHETHER IN AN ACTION OF CONTRACT TORT OR OTHER WISE ARISING FROM OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE Except as contained in this notice the name of the authors shall not be used in adverti...

Page 243: ...censable by grantor 1 11 Source Code means the preferred form of the Covered Code for making modifications to it including all modules it contains plus any associated interface definition files scripts used to control compilation and installation of an Executable or source code differential comparisons against either the Original Code or another well known available Covered Code of the Contributor...

Page 244: ...STRIBUTION OBLIGATIONS 3 1 Application of License The Modifications which You create or to which You contribute are governed by the terms of this License including without limitation Section 2 2 The Source Code version of Covered Code may be distributed only under the terms of this License or a future version of this License released under Section 6 1 and You must include a copy of this License wi...

Page 245: ...user would be likely to look for such a notice If You created one or more Modification s You may add your name as a Contributor to the notice described in Exhibit A You must also duplicate this License in any documentation for the Source Code where You describe recipients rights or ownership rights relating to Covered Code You may choose to offer and to charge a fee for warranty support indemnity ...

Page 246: ...overed Code under the terms of any subsequent version of the License 6 3 Derivative Works If You create or use a modified version of this License which you may only do in order to apply it to code which is not already Covered Code governed by this License You must a rename Your license so that the phrase gSOAP or any confusingly similar phrase do not appear in your license except to note that your...

Page 247: ...F THE SOFTWARE MAY RESULT DIRECTLY OR INDIRECTLY IN PHYSICAL IN JURY OR LOSS OF HUMAN LIFE THIS DISCLAIMER OF WARRANTY CONSTITUTES AN ESSENTIAL PART OF THIS LICENSE NO USE OF ANY COVERED CODE IS AU THORIZED HEREUNDER EXCEPT UNDER THIS DISCLAIMER 8 TERMINATION 8 1 This License and the rights granted hereunder will terminate automatically if You fail to comply with terms herein and fail to cure such...

Page 248: ...e Version 1 3 the License you may not use this file except in compliance with the License You may obtain a copy of the License at http www cs fsu edu engelen soaplicense html Software distributed under the License is distributed on an AS IS basis WITHOUT WARRANTY OF ANY KIND either express or implied See the License for the specific language governing rights and limitations under the Li cense The ...

Page 249: ...edistributions in binary form must reproduce the above copyright notice this list of conditions and the following disclaimer in the documentation and or other materials provided with the distribution Neither the name of Stanford University nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission THIS SOFTWARE ...

Page 250: ...CIDENTAL SPECIAL EX EMPLARY OR CONSEQUENTIAL DAMAGES INCLUDING BUT NOT LIMITED TO PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES LOSS OF USE DATA OR PROFITS OR BUSINESS INTERRUPTION HOWEVER CAUSED AND ON ANY THE ORY OF LIABILITY WHETHER IN CONTRACT STRICT LIABILITY OR TORT IN CLUDING NEGLIGENCE OR OTHERWISE ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE EVEN IF ADVISED OF THE POSSIBILITY OF SUCH ...

Page 251: ...UPPLIERS BE LIABLE FOR ANY CLAIM DAMAGES OR OTHER LIABILITY WHETHER IN AN ACTION OF CONTRACT TORT OR OTHERWISE ARISING FROM OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE 14 2 15 curl license COPYRIGHT AND PERMISSION NOTICE Copyright c 1996 2009 Daniel Stenberg daniel haxx se All rights reserved Permission to use copy modify and distribute this software for ...

Page 252: ...o do so subject to the following conditions The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software THE SOFTWARE IS PROVIDED AS IS WITHOUT WARRANTY OF ANY KIND EX PRESS OR IMPLIED INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MER CHANTABILITY FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT IN NO EVENT SHALL THE AUTHORS OR ...

Page 253: ...s registration is optional If you choose to register your name e mail address country and company will be submitted to Sun and stored together with the IP address of the submitter as well as product version and platform being used The standard Sun Privacy Policy as posted on http www sun com privacy applies to this data 4 Update notifications The VirtualBox application may contact Sun Microsys tem...

Page 254: ...15 VirtualBox privacy policy 6 Updates Sun may update this privacy policy by posting a new version on the website You should check this page occasionally to ensure you are happy with any changes 254 ...

Page 255: ...ogrammable Interrupt Controller a newer version of the original PC PIC programmable interrupt controller Most modern CPUs contain an on chip APIC local APIC Many systems also contain an I O APIC input output APIC as a separate chip which provides more than 16 IRQs Windows 2000 and higher use a different kernel if they detect an I O APIC during installation Therefore an I O APIC must not be removed...

Page 256: ...DHCP server that delivers an IP addresses to a virtual machine when networking is configured to NAT see chapter 6 Virtual networking page 82 DKMS Dynamic Kernel Module Support A framework that simplifies installing and updating external kernel modules on Linux machines see chapter 2 3 2 The VirtualBox kernel module page 21 E EHCI Enhanced Host Controller Interface the interface that implements the...

Page 257: ...Network Address Translation NAT page 84 O OVF Open Virtualization Format a cross platform industry standard to exchange vir tual appliances between virtualization products see chapter 3 8 Importing and exporting virtual machines page 56 P PAE Physical Address Extension This allows accessing more than 4 GB of RAM even in 32 bit environments see chapter 3 7 1 2 Advanced tab page 46 PIC See APIC PXE ...

Page 258: ...CSI page 75 SMP Symmetrical Multiprocessing meaning that the resources of a computer are shared between several processors These can either be several processor chips or as is more common with modern hardware multiple CPU cores in one pro cessor U UUID A Universally Unique Identifier often also called GUID Globally Unique Iden tifier is a string of numbers and letters which can be computed dynamic...

Page 259: ...ow to semantically organize content XPCOM Mozilla Cross Platform Component Object Model a programming infrastruc ture developed by the Mozilla browser project which is similar to Microsoft COM and allows applications to provide a modular programming interface VirtualBox makes use of XPCOM on Linux both internally and externally to provide a com prehensive API to third party developers 259 ...