File: intro-save-machine-state.dita

package info (click to toggle)
virtualbox 7.1.12-dfsg-2
  • links: PTS, VCS
  • area: contrib
  • in suites: sid
  • size: 565,672 kB
  • sloc: ansic: 2,330,854; cpp: 2,193,228; asm: 230,777; python: 223,895; xml: 86,771; sh: 25,541; makefile: 8,158; perl: 5,697; java: 5,337; cs: 4,872; pascal: 1,782; javascript: 1,692; objc: 1,131; lex: 931; php: 906; sed: 899; yacc: 707
file content (55 lines) | stat: -rw-r--r-- 3,180 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE topic PUBLIC "-//OASIS//DTD DITA Topic//EN" "topic.dtd">
<topic xml:lang="en-us" id="intro-save-machine-state">
  <title>Saving the State of the Machine</title>
  <body>
    <p>When you click the <b outputclass="bold">Close</b> button of your virtual machine window, at the top right of the
      window, just like you would close any other window on your system, <ph
        conkeyref="vbox-conkeyref-phrases/product-name"/> asks you whether you want to save or power off the VM. As a
      shortcut, you can also press <b outputclass="bold">Host key + Q</b>. </p>
    <p>
        The difference between the three options is crucial. They mean
        the following:
      </p>
    <ul>
      <li>
        <p><b outputclass="bold">Save the machine state:</b>
            With this option, <ph conkeyref="vbox-conkeyref-phrases/product-name"/>
            <i>freezes</i> the virtual machine by
            completely saving its state to your local disk.
          </p>
        <p>When you start the VM again later, you will find that the VM continues exactly where it was left off. All
          your programs will still be open, and your computer resumes operation. Saving the state of a virtual machine
          is thus in some ways similar to suspending a laptop computer by closing its lid. </p>
      </li>
      <li>
        <p><b outputclass="bold">Send the shutdown signal.</b>
            This will send an ACPI shutdown signal to the virtual
            machine, which has the same effect as if you had pressed the
            power button on a real computer. This should trigger a
            proper shutdown mechanism from within the VM.
          </p>
      </li>
      <li>
        <p><b outputclass="bold">Power off the machine:</b> With
            this option, <ph conkeyref="vbox-conkeyref-phrases/product-name"/> also stops running the virtual
            machine, but <i>without</i> saving its state.
          </p>
        <note type="caution">
          <p>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 OS will have to reboot completely and may begin a
            lengthy check of its virtual system disks. As a result, this should not normally be done, since it can
            potentially cause data loss or an inconsistent state of the guest system on disk. </p>
        </note>
        <p>As an exception, if your virtual machine has any snapshots, see <xref href="snapshots.dita#snapshots"/>, you
          can use this option to quickly <b outputclass="bold">restore the current snapshot</b> of the virtual machine.
          In that case, powering off the machine will discard the current state and any changes made since the previous
          snapshot was taken will be lost. </p>
      </li>
    </ul>
    <p>The <b outputclass="bold">Discard</b> button in the <ph conkeyref="vbox-conkeyref-phrases/vbox-mgr"/> window
      discards a virtual machine's saved state. This has the same effect as powering it off, and the same warnings
      apply. </p>
  </body>
  
</topic>