root / include / migration / qemu-file.h @ ce31825d
History | View | Annotate | Download (7.5 kB)
1 | 701a8f76 | Paolo Bonzini | /*
|
---|---|---|---|
2 | 701a8f76 | Paolo Bonzini | * QEMU System Emulator
|
3 | 701a8f76 | Paolo Bonzini | *
|
4 | 701a8f76 | Paolo Bonzini | * Copyright (c) 2003-2008 Fabrice Bellard
|
5 | 701a8f76 | Paolo Bonzini | *
|
6 | 701a8f76 | Paolo Bonzini | * Permission is hereby granted, free of charge, to any person obtaining a copy
|
7 | 701a8f76 | Paolo Bonzini | * of this software and associated documentation files (the "Software"), to deal
|
8 | 701a8f76 | Paolo Bonzini | * in the Software without restriction, including without limitation the rights
|
9 | 701a8f76 | Paolo Bonzini | * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
10 | 701a8f76 | Paolo Bonzini | * copies of the Software, and to permit persons to whom the Software is
|
11 | 701a8f76 | Paolo Bonzini | * furnished to do so, subject to the following conditions:
|
12 | 701a8f76 | Paolo Bonzini | *
|
13 | 701a8f76 | Paolo Bonzini | * The above copyright notice and this permission notice shall be included in
|
14 | 701a8f76 | Paolo Bonzini | * all copies or substantial portions of the Software.
|
15 | 701a8f76 | Paolo Bonzini | *
|
16 | 701a8f76 | Paolo Bonzini | * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
17 | 701a8f76 | Paolo Bonzini | * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
18 | 701a8f76 | Paolo Bonzini | * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
|
19 | 701a8f76 | Paolo Bonzini | * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
20 | 701a8f76 | Paolo Bonzini | * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
21 | 701a8f76 | Paolo Bonzini | * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
|
22 | 701a8f76 | Paolo Bonzini | * THE SOFTWARE.
|
23 | 701a8f76 | Paolo Bonzini | */
|
24 | 701a8f76 | Paolo Bonzini | #ifndef QEMU_FILE_H
|
25 | 701a8f76 | Paolo Bonzini | #define QEMU_FILE_H 1 |
26 | 43487c67 | Michael R. Hines | #include "exec/cpu-common.h" |
27 | 701a8f76 | Paolo Bonzini | |
28 | 701a8f76 | Paolo Bonzini | /* This function writes a chunk of data to a file at the given position.
|
29 | 701a8f76 | Paolo Bonzini | * The pos argument can be ignored if the file is only being used for
|
30 | 701a8f76 | Paolo Bonzini | * streaming. The handler should try to write all of the data it can.
|
31 | 701a8f76 | Paolo Bonzini | */
|
32 | 701a8f76 | Paolo Bonzini | typedef int (QEMUFilePutBufferFunc)(void *opaque, const uint8_t *buf, |
33 | 701a8f76 | Paolo Bonzini | int64_t pos, int size);
|
34 | 701a8f76 | Paolo Bonzini | |
35 | 701a8f76 | Paolo Bonzini | /* Read a chunk of data from a file at the given position. The pos argument
|
36 | 701a8f76 | Paolo Bonzini | * can be ignored if the file is only be used for streaming. The number of
|
37 | 701a8f76 | Paolo Bonzini | * bytes actually read should be returned.
|
38 | 701a8f76 | Paolo Bonzini | */
|
39 | 701a8f76 | Paolo Bonzini | typedef int (QEMUFileGetBufferFunc)(void *opaque, uint8_t *buf, |
40 | 701a8f76 | Paolo Bonzini | int64_t pos, int size);
|
41 | 701a8f76 | Paolo Bonzini | |
42 | 701a8f76 | Paolo Bonzini | /* Close a file
|
43 | 701a8f76 | Paolo Bonzini | *
|
44 | 701a8f76 | Paolo Bonzini | * Return negative error number on error, 0 or positive value on success.
|
45 | 701a8f76 | Paolo Bonzini | *
|
46 | 701a8f76 | Paolo Bonzini | * The meaning of return value on success depends on the specific back-end being
|
47 | 701a8f76 | Paolo Bonzini | * used.
|
48 | 701a8f76 | Paolo Bonzini | */
|
49 | 701a8f76 | Paolo Bonzini | typedef int (QEMUFileCloseFunc)(void *opaque); |
50 | 701a8f76 | Paolo Bonzini | |
51 | 70eb6330 | Paolo Bonzini | /* Called to return the OS file descriptor associated to the QEMUFile.
|
52 | 70eb6330 | Paolo Bonzini | */
|
53 | 70eb6330 | Paolo Bonzini | typedef int (QEMUFileGetFD)(void *opaque); |
54 | 70eb6330 | Paolo Bonzini | |
55 | d913829f | Orit Wasserman | /*
|
56 | d913829f | Orit Wasserman | * This function writes an iovec to file.
|
57 | d913829f | Orit Wasserman | */
|
58 | d913829f | Orit Wasserman | typedef ssize_t (QEMUFileWritevBufferFunc)(void *opaque, struct iovec *iov, |
59 | 05fcc848 | Kevin Wolf | int iovcnt, int64_t pos);
|
60 | d913829f | Orit Wasserman | |
61 | 43487c67 | Michael R. Hines | /*
|
62 | 43487c67 | Michael R. Hines | * This function provides hooks around different
|
63 | 43487c67 | Michael R. Hines | * stages of RAM migration.
|
64 | 43487c67 | Michael R. Hines | */
|
65 | 43487c67 | Michael R. Hines | typedef int (QEMURamHookFunc)(QEMUFile *f, void *opaque, uint64_t flags); |
66 | 43487c67 | Michael R. Hines | |
67 | 43487c67 | Michael R. Hines | /*
|
68 | 43487c67 | Michael R. Hines | * Constants used by ram_control_* hooks
|
69 | 43487c67 | Michael R. Hines | */
|
70 | 43487c67 | Michael R. Hines | #define RAM_CONTROL_SETUP 0 |
71 | 43487c67 | Michael R. Hines | #define RAM_CONTROL_ROUND 1 |
72 | 43487c67 | Michael R. Hines | #define RAM_CONTROL_HOOK 2 |
73 | 43487c67 | Michael R. Hines | #define RAM_CONTROL_FINISH 3 |
74 | 43487c67 | Michael R. Hines | |
75 | 43487c67 | Michael R. Hines | /*
|
76 | 43487c67 | Michael R. Hines | * This function allows override of where the RAM page
|
77 | 43487c67 | Michael R. Hines | * is saved (such as RDMA, for example.)
|
78 | 43487c67 | Michael R. Hines | */
|
79 | 43487c67 | Michael R. Hines | typedef size_t (QEMURamSaveFunc)(QEMUFile *f, void *opaque, |
80 | 43487c67 | Michael R. Hines | ram_addr_t block_offset, |
81 | 43487c67 | Michael R. Hines | ram_addr_t offset, |
82 | 43487c67 | Michael R. Hines | size_t size, |
83 | 43487c67 | Michael R. Hines | int *bytes_sent);
|
84 | 43487c67 | Michael R. Hines | |
85 | 9229bf3c | Paolo Bonzini | typedef struct QEMUFileOps { |
86 | 9229bf3c | Paolo Bonzini | QEMUFilePutBufferFunc *put_buffer; |
87 | 9229bf3c | Paolo Bonzini | QEMUFileGetBufferFunc *get_buffer; |
88 | 9229bf3c | Paolo Bonzini | QEMUFileCloseFunc *close; |
89 | 70eb6330 | Paolo Bonzini | QEMUFileGetFD *get_fd; |
90 | d913829f | Orit Wasserman | QEMUFileWritevBufferFunc *writev_buffer; |
91 | 43487c67 | Michael R. Hines | QEMURamHookFunc *before_ram_iterate; |
92 | 43487c67 | Michael R. Hines | QEMURamHookFunc *after_ram_iterate; |
93 | 43487c67 | Michael R. Hines | QEMURamHookFunc *hook_ram_load; |
94 | 43487c67 | Michael R. Hines | QEMURamSaveFunc *save_page; |
95 | 9229bf3c | Paolo Bonzini | } QEMUFileOps; |
96 | 9229bf3c | Paolo Bonzini | |
97 | 9229bf3c | Paolo Bonzini | QEMUFile *qemu_fopen_ops(void *opaque, const QEMUFileOps *ops); |
98 | 701a8f76 | Paolo Bonzini | QEMUFile *qemu_fopen(const char *filename, const char *mode); |
99 | 701a8f76 | Paolo Bonzini | QEMUFile *qemu_fdopen(int fd, const char *mode); |
100 | 0cc3f3cc | Paolo Bonzini | QEMUFile *qemu_fopen_socket(int fd, const char *mode); |
101 | 701a8f76 | Paolo Bonzini | QEMUFile *qemu_popen_cmd(const char *command, const char *mode); |
102 | 70eb6330 | Paolo Bonzini | int qemu_get_fd(QEMUFile *f);
|
103 | 701a8f76 | Paolo Bonzini | int qemu_fclose(QEMUFile *f);
|
104 | ad55ab42 | Stefan Hajnoczi | int64_t qemu_ftell(QEMUFile *f); |
105 | 701a8f76 | Paolo Bonzini | void qemu_put_buffer(QEMUFile *f, const uint8_t *buf, int size); |
106 | 701a8f76 | Paolo Bonzini | void qemu_put_byte(QEMUFile *f, int v); |
107 | 6181ec24 | Orit Wasserman | /*
|
108 | 6181ec24 | Orit Wasserman | * put_buffer without copying the buffer.
|
109 | 6181ec24 | Orit Wasserman | * The buffer should be available till it is sent asynchronously.
|
110 | 6181ec24 | Orit Wasserman | */
|
111 | 6181ec24 | Orit Wasserman | void qemu_put_buffer_async(QEMUFile *f, const uint8_t *buf, int size); |
112 | bc1256f7 | Michael R. Hines | bool qemu_file_mode_is_not_valid(const char *mode); |
113 | 701a8f76 | Paolo Bonzini | |
114 | 701a8f76 | Paolo Bonzini | static inline void qemu_put_ubyte(QEMUFile *f, unsigned int v) |
115 | 701a8f76 | Paolo Bonzini | { |
116 | 701a8f76 | Paolo Bonzini | qemu_put_byte(f, (int)v);
|
117 | 701a8f76 | Paolo Bonzini | } |
118 | 701a8f76 | Paolo Bonzini | |
119 | 701a8f76 | Paolo Bonzini | #define qemu_put_sbyte qemu_put_byte
|
120 | 701a8f76 | Paolo Bonzini | |
121 | 701a8f76 | Paolo Bonzini | void qemu_put_be16(QEMUFile *f, unsigned int v); |
122 | 701a8f76 | Paolo Bonzini | void qemu_put_be32(QEMUFile *f, unsigned int v); |
123 | 701a8f76 | Paolo Bonzini | void qemu_put_be64(QEMUFile *f, uint64_t v);
|
124 | 701a8f76 | Paolo Bonzini | int qemu_get_buffer(QEMUFile *f, uint8_t *buf, int size); |
125 | 701a8f76 | Paolo Bonzini | int qemu_get_byte(QEMUFile *f);
|
126 | 2b0ce079 | Michael R. Hines | void qemu_update_position(QEMUFile *f, size_t size);
|
127 | 701a8f76 | Paolo Bonzini | |
128 | 701a8f76 | Paolo Bonzini | static inline unsigned int qemu_get_ubyte(QEMUFile *f) |
129 | 701a8f76 | Paolo Bonzini | { |
130 | 701a8f76 | Paolo Bonzini | return (unsigned int)qemu_get_byte(f); |
131 | 701a8f76 | Paolo Bonzini | } |
132 | 701a8f76 | Paolo Bonzini | |
133 | 701a8f76 | Paolo Bonzini | #define qemu_get_sbyte qemu_get_byte
|
134 | 701a8f76 | Paolo Bonzini | |
135 | 701a8f76 | Paolo Bonzini | unsigned int qemu_get_be16(QEMUFile *f); |
136 | 701a8f76 | Paolo Bonzini | unsigned int qemu_get_be32(QEMUFile *f); |
137 | 701a8f76 | Paolo Bonzini | uint64_t qemu_get_be64(QEMUFile *f); |
138 | 701a8f76 | Paolo Bonzini | |
139 | 701a8f76 | Paolo Bonzini | int qemu_file_rate_limit(QEMUFile *f);
|
140 | 1964a397 | Paolo Bonzini | void qemu_file_reset_rate_limit(QEMUFile *f);
|
141 | 1964a397 | Paolo Bonzini | void qemu_file_set_rate_limit(QEMUFile *f, int64_t new_rate);
|
142 | 701a8f76 | Paolo Bonzini | int64_t qemu_file_get_rate_limit(QEMUFile *f); |
143 | 701a8f76 | Paolo Bonzini | int qemu_file_get_error(QEMUFile *f);
|
144 | be903b2a | Michael R. Hines | void qemu_fflush(QEMUFile *f);
|
145 | 701a8f76 | Paolo Bonzini | |
146 | 701a8f76 | Paolo Bonzini | static inline void qemu_put_be64s(QEMUFile *f, const uint64_t *pv) |
147 | 701a8f76 | Paolo Bonzini | { |
148 | 701a8f76 | Paolo Bonzini | qemu_put_be64(f, *pv); |
149 | 701a8f76 | Paolo Bonzini | } |
150 | 701a8f76 | Paolo Bonzini | |
151 | 701a8f76 | Paolo Bonzini | static inline void qemu_put_be32s(QEMUFile *f, const uint32_t *pv) |
152 | 701a8f76 | Paolo Bonzini | { |
153 | 701a8f76 | Paolo Bonzini | qemu_put_be32(f, *pv); |
154 | 701a8f76 | Paolo Bonzini | } |
155 | 701a8f76 | Paolo Bonzini | |
156 | 701a8f76 | Paolo Bonzini | static inline void qemu_put_be16s(QEMUFile *f, const uint16_t *pv) |
157 | 701a8f76 | Paolo Bonzini | { |
158 | 701a8f76 | Paolo Bonzini | qemu_put_be16(f, *pv); |
159 | 701a8f76 | Paolo Bonzini | } |
160 | 701a8f76 | Paolo Bonzini | |
161 | 701a8f76 | Paolo Bonzini | static inline void qemu_put_8s(QEMUFile *f, const uint8_t *pv) |
162 | 701a8f76 | Paolo Bonzini | { |
163 | 701a8f76 | Paolo Bonzini | qemu_put_byte(f, *pv); |
164 | 701a8f76 | Paolo Bonzini | } |
165 | 701a8f76 | Paolo Bonzini | |
166 | 701a8f76 | Paolo Bonzini | static inline void qemu_get_be64s(QEMUFile *f, uint64_t *pv) |
167 | 701a8f76 | Paolo Bonzini | { |
168 | 701a8f76 | Paolo Bonzini | *pv = qemu_get_be64(f); |
169 | 701a8f76 | Paolo Bonzini | } |
170 | 701a8f76 | Paolo Bonzini | |
171 | 701a8f76 | Paolo Bonzini | static inline void qemu_get_be32s(QEMUFile *f, uint32_t *pv) |
172 | 701a8f76 | Paolo Bonzini | { |
173 | 701a8f76 | Paolo Bonzini | *pv = qemu_get_be32(f); |
174 | 701a8f76 | Paolo Bonzini | } |
175 | 701a8f76 | Paolo Bonzini | |
176 | 701a8f76 | Paolo Bonzini | static inline void qemu_get_be16s(QEMUFile *f, uint16_t *pv) |
177 | 701a8f76 | Paolo Bonzini | { |
178 | 701a8f76 | Paolo Bonzini | *pv = qemu_get_be16(f); |
179 | 701a8f76 | Paolo Bonzini | } |
180 | 701a8f76 | Paolo Bonzini | |
181 | 701a8f76 | Paolo Bonzini | static inline void qemu_get_8s(QEMUFile *f, uint8_t *pv) |
182 | 701a8f76 | Paolo Bonzini | { |
183 | 701a8f76 | Paolo Bonzini | *pv = qemu_get_byte(f); |
184 | 701a8f76 | Paolo Bonzini | } |
185 | 701a8f76 | Paolo Bonzini | |
186 | 701a8f76 | Paolo Bonzini | // Signed versions for type safety
|
187 | 701a8f76 | Paolo Bonzini | static inline void qemu_put_sbuffer(QEMUFile *f, const int8_t *buf, int size) |
188 | 701a8f76 | Paolo Bonzini | { |
189 | 701a8f76 | Paolo Bonzini | qemu_put_buffer(f, (const uint8_t *)buf, size);
|
190 | 701a8f76 | Paolo Bonzini | } |
191 | 701a8f76 | Paolo Bonzini | |
192 | 701a8f76 | Paolo Bonzini | static inline void qemu_put_sbe16(QEMUFile *f, int v) |
193 | 701a8f76 | Paolo Bonzini | { |
194 | 701a8f76 | Paolo Bonzini | qemu_put_be16(f, (unsigned int)v); |
195 | 701a8f76 | Paolo Bonzini | } |
196 | 701a8f76 | Paolo Bonzini | |
197 | 701a8f76 | Paolo Bonzini | static inline void qemu_put_sbe32(QEMUFile *f, int v) |
198 | 701a8f76 | Paolo Bonzini | { |
199 | 701a8f76 | Paolo Bonzini | qemu_put_be32(f, (unsigned int)v); |
200 | 701a8f76 | Paolo Bonzini | } |
201 | 701a8f76 | Paolo Bonzini | |
202 | 701a8f76 | Paolo Bonzini | static inline void qemu_put_sbe64(QEMUFile *f, int64_t v) |
203 | 701a8f76 | Paolo Bonzini | { |
204 | 701a8f76 | Paolo Bonzini | qemu_put_be64(f, (uint64_t)v); |
205 | 701a8f76 | Paolo Bonzini | } |
206 | 701a8f76 | Paolo Bonzini | |
207 | 701a8f76 | Paolo Bonzini | static inline size_t qemu_get_sbuffer(QEMUFile *f, int8_t *buf, int size) |
208 | 701a8f76 | Paolo Bonzini | { |
209 | 701a8f76 | Paolo Bonzini | return qemu_get_buffer(f, (uint8_t *)buf, size);
|
210 | 701a8f76 | Paolo Bonzini | } |
211 | 701a8f76 | Paolo Bonzini | |
212 | 701a8f76 | Paolo Bonzini | static inline int qemu_get_sbe16(QEMUFile *f) |
213 | 701a8f76 | Paolo Bonzini | { |
214 | 701a8f76 | Paolo Bonzini | return (int)qemu_get_be16(f); |
215 | 701a8f76 | Paolo Bonzini | } |
216 | 701a8f76 | Paolo Bonzini | |
217 | 701a8f76 | Paolo Bonzini | static inline int qemu_get_sbe32(QEMUFile *f) |
218 | 701a8f76 | Paolo Bonzini | { |
219 | 701a8f76 | Paolo Bonzini | return (int)qemu_get_be32(f); |
220 | 701a8f76 | Paolo Bonzini | } |
221 | 701a8f76 | Paolo Bonzini | |
222 | 701a8f76 | Paolo Bonzini | static inline int64_t qemu_get_sbe64(QEMUFile *f) |
223 | 701a8f76 | Paolo Bonzini | { |
224 | 701a8f76 | Paolo Bonzini | return (int64_t)qemu_get_be64(f);
|
225 | 701a8f76 | Paolo Bonzini | } |
226 | 701a8f76 | Paolo Bonzini | |
227 | 701a8f76 | Paolo Bonzini | static inline void qemu_put_s8s(QEMUFile *f, const int8_t *pv) |
228 | 701a8f76 | Paolo Bonzini | { |
229 | 701a8f76 | Paolo Bonzini | qemu_put_8s(f, (const uint8_t *)pv);
|
230 | 701a8f76 | Paolo Bonzini | } |
231 | 701a8f76 | Paolo Bonzini | |
232 | 701a8f76 | Paolo Bonzini | static inline void qemu_put_sbe16s(QEMUFile *f, const int16_t *pv) |
233 | 701a8f76 | Paolo Bonzini | { |
234 | 701a8f76 | Paolo Bonzini | qemu_put_be16s(f, (const uint16_t *)pv);
|
235 | 701a8f76 | Paolo Bonzini | } |
236 | 701a8f76 | Paolo Bonzini | |
237 | 701a8f76 | Paolo Bonzini | static inline void qemu_put_sbe32s(QEMUFile *f, const int32_t *pv) |
238 | 701a8f76 | Paolo Bonzini | { |
239 | 701a8f76 | Paolo Bonzini | qemu_put_be32s(f, (const uint32_t *)pv);
|
240 | 701a8f76 | Paolo Bonzini | } |
241 | 701a8f76 | Paolo Bonzini | |
242 | 701a8f76 | Paolo Bonzini | static inline void qemu_put_sbe64s(QEMUFile *f, const int64_t *pv) |
243 | 701a8f76 | Paolo Bonzini | { |
244 | 701a8f76 | Paolo Bonzini | qemu_put_be64s(f, (const uint64_t *)pv);
|
245 | 701a8f76 | Paolo Bonzini | } |
246 | 701a8f76 | Paolo Bonzini | |
247 | 701a8f76 | Paolo Bonzini | static inline void qemu_get_s8s(QEMUFile *f, int8_t *pv) |
248 | 701a8f76 | Paolo Bonzini | { |
249 | 701a8f76 | Paolo Bonzini | qemu_get_8s(f, (uint8_t *)pv); |
250 | 701a8f76 | Paolo Bonzini | } |
251 | 701a8f76 | Paolo Bonzini | |
252 | 701a8f76 | Paolo Bonzini | static inline void qemu_get_sbe16s(QEMUFile *f, int16_t *pv) |
253 | 701a8f76 | Paolo Bonzini | { |
254 | 701a8f76 | Paolo Bonzini | qemu_get_be16s(f, (uint16_t *)pv); |
255 | 701a8f76 | Paolo Bonzini | } |
256 | 701a8f76 | Paolo Bonzini | |
257 | 701a8f76 | Paolo Bonzini | static inline void qemu_get_sbe32s(QEMUFile *f, int32_t *pv) |
258 | 701a8f76 | Paolo Bonzini | { |
259 | 701a8f76 | Paolo Bonzini | qemu_get_be32s(f, (uint32_t *)pv); |
260 | 701a8f76 | Paolo Bonzini | } |
261 | 701a8f76 | Paolo Bonzini | |
262 | 701a8f76 | Paolo Bonzini | static inline void qemu_get_sbe64s(QEMUFile *f, int64_t *pv) |
263 | 701a8f76 | Paolo Bonzini | { |
264 | 701a8f76 | Paolo Bonzini | qemu_get_be64s(f, (uint64_t *)pv); |
265 | 701a8f76 | Paolo Bonzini | } |
266 | 701a8f76 | Paolo Bonzini | #endif |