warpguest.dita@ 99009

Last change on this file since 99009 was 98549, checked in by vboxsync, 2 years ago
Docs: bugref:10302. Uploading .dita user manual files we received from the doc team on 25th Jan.
Property svn:eol-style set to `native`
File size: 1.6 KB

Line
1	<?xml version='1.0' encoding='UTF-8'?>
2	<!DOCTYPE topic PUBLIC "-//OASIS//DTD DITA Topic//EN" "topic.dtd">
3	<topic xml:lang="en-us" id="warpguest">
4	<title>Accelerate or Slow Down the Guest Clock</title>
5
6	<body>
7	<p>
8	For certain purposes it can be useful to accelerate or to slow
9	down the virtual guest clock. This can be achieved as follows:
10	</p>
11	<pre xml:space="preserve">$ VBoxManage setextradata <varname>VM-name</varname> "VBoxInternal/TM/WarpDrivePercentage" 200</pre>
12	<p>
13	The above example will double the speed of the guest clock while
14	</p>
15	<pre xml:space="preserve">$ VBoxManage setextradata <varname>VM-name</varname> "VBoxInternal/TM/WarpDrivePercentage" 50</pre>
16	<p>
17	will halve the speed of the guest clock. Note that changing the
18	rate of the virtual clock can confuse the guest and can even
19	lead to abnormal guest behavior. For instance, a higher clock
20	rate means shorter timeouts for virtual devices with the result
21	that a slightly increased response time of a virtual device due
22	to an increased host load can cause guest failures. Note further
23	that any time synchronization mechanism will frequently try to
24	resynchronize the guest clock with the reference clock, which is
25	the host clock if the Oracle VM VirtualBox Guest Additions are active.
26	Therefore any time synchronization should be disabled if the
27	rate of the guest clock is changed as described above. See
28	<xref href="changetimesync.dita#changetimesync"/>.
29	</p>
30	</body>
31
32	</topic>

Note: See TracBrowser for help on using the repository browser.