| 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 <ph conkeyref="vbox-conkeyref-phrases/product-name"/> 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>
|
|---|
