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
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
|
// Copyright 2018 The gVisor Authors.
//
// Licensed under the Apache License, Version 2.0 (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.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
package control
import (
"errors"
"fmt"
"gvisor.dev/gvisor/pkg/abi/linux"
"gvisor.dev/gvisor/pkg/log"
"gvisor.dev/gvisor/pkg/sentry/kernel"
"gvisor.dev/gvisor/pkg/sentry/pgalloc"
"gvisor.dev/gvisor/pkg/sentry/state"
"gvisor.dev/gvisor/pkg/sentry/watchdog"
"gvisor.dev/gvisor/pkg/urpc"
)
// ErrInvalidFiles is returned when the urpc call to Save does not include an
// appropriate file payload (e.g. there is no output file!).
var ErrInvalidFiles = errors.New("exactly one file must be provided")
// State includes state-related functions.
type State struct {
Kernel *kernel.Kernel
Watchdog *watchdog.Watchdog
}
// SaveOpts contains options for the Save RPC call.
type SaveOpts struct {
// Key is used for state integrity check.
Key []byte `json:"key"`
// Metadata is the set of metadata to prepend to the state file.
Metadata map[string]string `json:"metadata"`
// MemoryFileSaveOpts is passed to calls to pgalloc.MemoryFile.SaveTo().
MemoryFileSaveOpts pgalloc.SaveOpts
// HavePagesFile indicates whether the pages file and its corresponding
// metadata file is provided.
HavePagesFile bool `json:"have_pages_file"`
// FilePayload contains the following:
// 1. checkpoint state file.
// 2. optional checkpoint pages metadata file.
// 3. optional checkpoint pages file.
urpc.FilePayload
// Resume indicates if the sandbox process should continue running
// after checkpointing.
Resume bool
}
// Save saves the running system.
func (s *State) Save(o *SaveOpts, _ *struct{}) error {
wantFiles := 1
if o.HavePagesFile {
wantFiles += 2
}
if gotFiles := len(o.FilePayload.Files); gotFiles != wantFiles {
return fmt.Errorf("got %d files, wanted %d", gotFiles, wantFiles)
}
// Save to the first provided stream.
stateFile, err := o.ReleaseFD(0)
if err != nil {
return err
}
defer stateFile.Close()
saveOpts := state.SaveOpts{
Destination: stateFile,
Key: o.Key,
Metadata: o.Metadata,
MemoryFileSaveOpts: o.MemoryFileSaveOpts,
Callback: func(err error) {
if err == nil {
log.Infof("Save succeeded: exiting...")
s.Kernel.SetSaveSuccess(false /* autosave */)
} else {
log.Warningf("Save failed: %v", err)
s.Kernel.SetSaveError(err)
}
if !o.Resume {
s.Kernel.Kill(linux.WaitStatusExit(0))
}
},
}
if o.HavePagesFile {
saveOpts.PagesMetadata, err = o.ReleaseFD(1)
if err != nil {
return err
}
defer saveOpts.PagesMetadata.Close()
saveOpts.PagesFile, err = o.ReleaseFD(2)
if err != nil {
return err
}
defer saveOpts.PagesFile.Close()
}
return saveOpts.Save(s.Kernel.SupervisorContext(), s.Kernel, s.Watchdog)
}
|
