root / include / migration / qemu-file.h @ be903b2a
History | View | Annotate | Download (6.7 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 | 701a8f76 | Paolo Bonzini | |
27 | 701a8f76 | Paolo Bonzini | /* This function writes a chunk of data to a file at the given position.
|
28 | 701a8f76 | Paolo Bonzini | * The pos argument can be ignored if the file is only being used for
|
29 | 701a8f76 | Paolo Bonzini | * streaming. The handler should try to write all of the data it can.
|
30 | 701a8f76 | Paolo Bonzini | */
|
31 | 701a8f76 | Paolo Bonzini | typedef int (QEMUFilePutBufferFunc)(void *opaque, const uint8_t *buf, |
32 | 701a8f76 | Paolo Bonzini | int64_t pos, int size);
|
33 | 701a8f76 | Paolo Bonzini | |
34 | 701a8f76 | Paolo Bonzini | /* Read a chunk of data from a file at the given position. The pos argument
|
35 | 701a8f76 | Paolo Bonzini | * can be ignored if the file is only be used for streaming. The number of
|
36 | 701a8f76 | Paolo Bonzini | * bytes actually read should be returned.
|
37 | 701a8f76 | Paolo Bonzini | */
|
38 | 701a8f76 | Paolo Bonzini | typedef int (QEMUFileGetBufferFunc)(void *opaque, uint8_t *buf, |
39 | 701a8f76 | Paolo Bonzini | int64_t pos, int size);
|
40 | 701a8f76 | Paolo Bonzini | |
41 | 701a8f76 | Paolo Bonzini | /* Close a file
|
42 | 701a8f76 | Paolo Bonzini | *
|
43 | 701a8f76 | Paolo Bonzini | * Return negative error number on error, 0 or positive value on success.
|
44 | 701a8f76 | Paolo Bonzini | *
|
45 | 701a8f76 | Paolo Bonzini | * The meaning of return value on success depends on the specific back-end being
|
46 | 701a8f76 | Paolo Bonzini | * used.
|
47 | 701a8f76 | Paolo Bonzini | */
|
48 | 701a8f76 | Paolo Bonzini | typedef int (QEMUFileCloseFunc)(void *opaque); |
49 | 701a8f76 | Paolo Bonzini | |
50 | 70eb6330 | Paolo Bonzini | /* Called to return the OS file descriptor associated to the QEMUFile.
|
51 | 70eb6330 | Paolo Bonzini | */
|
52 | 70eb6330 | Paolo Bonzini | typedef int (QEMUFileGetFD)(void *opaque); |
53 | 70eb6330 | Paolo Bonzini | |
54 | d913829f | Orit Wasserman | /*
|
55 | d913829f | Orit Wasserman | * This function writes an iovec to file.
|
56 | d913829f | Orit Wasserman | */
|
57 | d913829f | Orit Wasserman | typedef ssize_t (QEMUFileWritevBufferFunc)(void *opaque, struct iovec *iov, |
58 | 05fcc848 | Kevin Wolf | int iovcnt, int64_t pos);
|
59 | d913829f | Orit Wasserman | |
60 | 9229bf3c | Paolo Bonzini | typedef struct QEMUFileOps { |
61 | 9229bf3c | Paolo Bonzini | QEMUFilePutBufferFunc *put_buffer; |
62 | 9229bf3c | Paolo Bonzini | QEMUFileGetBufferFunc *get_buffer; |
63 | 9229bf3c | Paolo Bonzini | QEMUFileCloseFunc *close; |
64 | 70eb6330 | Paolo Bonzini | QEMUFileGetFD *get_fd; |
65 | d913829f | Orit Wasserman | QEMUFileWritevBufferFunc *writev_buffer; |
66 | 9229bf3c | Paolo Bonzini | } QEMUFileOps; |
67 | 9229bf3c | Paolo Bonzini | |
68 | 9229bf3c | Paolo Bonzini | QEMUFile *qemu_fopen_ops(void *opaque, const QEMUFileOps *ops); |
69 | 701a8f76 | Paolo Bonzini | QEMUFile *qemu_fopen(const char *filename, const char *mode); |
70 | 701a8f76 | Paolo Bonzini | QEMUFile *qemu_fdopen(int fd, const char *mode); |
71 | 0cc3f3cc | Paolo Bonzini | QEMUFile *qemu_fopen_socket(int fd, const char *mode); |
72 | 701a8f76 | Paolo Bonzini | QEMUFile *qemu_popen_cmd(const char *command, const char *mode); |
73 | 70eb6330 | Paolo Bonzini | int qemu_get_fd(QEMUFile *f);
|
74 | 701a8f76 | Paolo Bonzini | int qemu_fclose(QEMUFile *f);
|
75 | ad55ab42 | Stefan Hajnoczi | int64_t qemu_ftell(QEMUFile *f); |
76 | 701a8f76 | Paolo Bonzini | void qemu_put_buffer(QEMUFile *f, const uint8_t *buf, int size); |
77 | 701a8f76 | Paolo Bonzini | void qemu_put_byte(QEMUFile *f, int v); |
78 | 6181ec24 | Orit Wasserman | /*
|
79 | 6181ec24 | Orit Wasserman | * put_buffer without copying the buffer.
|
80 | 6181ec24 | Orit Wasserman | * The buffer should be available till it is sent asynchronously.
|
81 | 6181ec24 | Orit Wasserman | */
|
82 | 6181ec24 | Orit Wasserman | void qemu_put_buffer_async(QEMUFile *f, const uint8_t *buf, int size); |
83 | bc1256f7 | Michael R. Hines | bool qemu_file_mode_is_not_valid(const char *mode); |
84 | 701a8f76 | Paolo Bonzini | |
85 | 701a8f76 | Paolo Bonzini | static inline void qemu_put_ubyte(QEMUFile *f, unsigned int v) |
86 | 701a8f76 | Paolo Bonzini | { |
87 | 701a8f76 | Paolo Bonzini | qemu_put_byte(f, (int)v);
|
88 | 701a8f76 | Paolo Bonzini | } |
89 | 701a8f76 | Paolo Bonzini | |
90 | 701a8f76 | Paolo Bonzini | #define qemu_put_sbyte qemu_put_byte
|
91 | 701a8f76 | Paolo Bonzini | |
92 | 701a8f76 | Paolo Bonzini | void qemu_put_be16(QEMUFile *f, unsigned int v); |
93 | 701a8f76 | Paolo Bonzini | void qemu_put_be32(QEMUFile *f, unsigned int v); |
94 | 701a8f76 | Paolo Bonzini | void qemu_put_be64(QEMUFile *f, uint64_t v);
|
95 | 701a8f76 | Paolo Bonzini | int qemu_get_buffer(QEMUFile *f, uint8_t *buf, int size); |
96 | 701a8f76 | Paolo Bonzini | int qemu_get_byte(QEMUFile *f);
|
97 | 2b0ce079 | Michael R. Hines | void qemu_update_position(QEMUFile *f, size_t size);
|
98 | 701a8f76 | Paolo Bonzini | |
99 | 701a8f76 | Paolo Bonzini | static inline unsigned int qemu_get_ubyte(QEMUFile *f) |
100 | 701a8f76 | Paolo Bonzini | { |
101 | 701a8f76 | Paolo Bonzini | return (unsigned int)qemu_get_byte(f); |
102 | 701a8f76 | Paolo Bonzini | } |
103 | 701a8f76 | Paolo Bonzini | |
104 | 701a8f76 | Paolo Bonzini | #define qemu_get_sbyte qemu_get_byte
|
105 | 701a8f76 | Paolo Bonzini | |
106 | 701a8f76 | Paolo Bonzini | unsigned int qemu_get_be16(QEMUFile *f); |
107 | 701a8f76 | Paolo Bonzini | unsigned int qemu_get_be32(QEMUFile *f); |
108 | 701a8f76 | Paolo Bonzini | uint64_t qemu_get_be64(QEMUFile *f); |
109 | 701a8f76 | Paolo Bonzini | |
110 | 701a8f76 | Paolo Bonzini | int qemu_file_rate_limit(QEMUFile *f);
|
111 | 1964a397 | Paolo Bonzini | void qemu_file_reset_rate_limit(QEMUFile *f);
|
112 | 1964a397 | Paolo Bonzini | void qemu_file_set_rate_limit(QEMUFile *f, int64_t new_rate);
|
113 | 701a8f76 | Paolo Bonzini | int64_t qemu_file_get_rate_limit(QEMUFile *f); |
114 | 701a8f76 | Paolo Bonzini | int qemu_file_get_error(QEMUFile *f);
|
115 | be903b2a | Michael R. Hines | void qemu_fflush(QEMUFile *f);
|
116 | 701a8f76 | Paolo Bonzini | |
117 | 701a8f76 | Paolo Bonzini | static inline void qemu_put_be64s(QEMUFile *f, const uint64_t *pv) |
118 | 701a8f76 | Paolo Bonzini | { |
119 | 701a8f76 | Paolo Bonzini | qemu_put_be64(f, *pv); |
120 | 701a8f76 | Paolo Bonzini | } |
121 | 701a8f76 | Paolo Bonzini | |
122 | 701a8f76 | Paolo Bonzini | static inline void qemu_put_be32s(QEMUFile *f, const uint32_t *pv) |
123 | 701a8f76 | Paolo Bonzini | { |
124 | 701a8f76 | Paolo Bonzini | qemu_put_be32(f, *pv); |
125 | 701a8f76 | Paolo Bonzini | } |
126 | 701a8f76 | Paolo Bonzini | |
127 | 701a8f76 | Paolo Bonzini | static inline void qemu_put_be16s(QEMUFile *f, const uint16_t *pv) |
128 | 701a8f76 | Paolo Bonzini | { |
129 | 701a8f76 | Paolo Bonzini | qemu_put_be16(f, *pv); |
130 | 701a8f76 | Paolo Bonzini | } |
131 | 701a8f76 | Paolo Bonzini | |
132 | 701a8f76 | Paolo Bonzini | static inline void qemu_put_8s(QEMUFile *f, const uint8_t *pv) |
133 | 701a8f76 | Paolo Bonzini | { |
134 | 701a8f76 | Paolo Bonzini | qemu_put_byte(f, *pv); |
135 | 701a8f76 | Paolo Bonzini | } |
136 | 701a8f76 | Paolo Bonzini | |
137 | 701a8f76 | Paolo Bonzini | static inline void qemu_get_be64s(QEMUFile *f, uint64_t *pv) |
138 | 701a8f76 | Paolo Bonzini | { |
139 | 701a8f76 | Paolo Bonzini | *pv = qemu_get_be64(f); |
140 | 701a8f76 | Paolo Bonzini | } |
141 | 701a8f76 | Paolo Bonzini | |
142 | 701a8f76 | Paolo Bonzini | static inline void qemu_get_be32s(QEMUFile *f, uint32_t *pv) |
143 | 701a8f76 | Paolo Bonzini | { |
144 | 701a8f76 | Paolo Bonzini | *pv = qemu_get_be32(f); |
145 | 701a8f76 | Paolo Bonzini | } |
146 | 701a8f76 | Paolo Bonzini | |
147 | 701a8f76 | Paolo Bonzini | static inline void qemu_get_be16s(QEMUFile *f, uint16_t *pv) |
148 | 701a8f76 | Paolo Bonzini | { |
149 | 701a8f76 | Paolo Bonzini | *pv = qemu_get_be16(f); |
150 | 701a8f76 | Paolo Bonzini | } |
151 | 701a8f76 | Paolo Bonzini | |
152 | 701a8f76 | Paolo Bonzini | static inline void qemu_get_8s(QEMUFile *f, uint8_t *pv) |
153 | 701a8f76 | Paolo Bonzini | { |
154 | 701a8f76 | Paolo Bonzini | *pv = qemu_get_byte(f); |
155 | 701a8f76 | Paolo Bonzini | } |
156 | 701a8f76 | Paolo Bonzini | |
157 | 701a8f76 | Paolo Bonzini | // Signed versions for type safety
|
158 | 701a8f76 | Paolo Bonzini | static inline void qemu_put_sbuffer(QEMUFile *f, const int8_t *buf, int size) |
159 | 701a8f76 | Paolo Bonzini | { |
160 | 701a8f76 | Paolo Bonzini | qemu_put_buffer(f, (const uint8_t *)buf, size);
|
161 | 701a8f76 | Paolo Bonzini | } |
162 | 701a8f76 | Paolo Bonzini | |
163 | 701a8f76 | Paolo Bonzini | static inline void qemu_put_sbe16(QEMUFile *f, int v) |
164 | 701a8f76 | Paolo Bonzini | { |
165 | 701a8f76 | Paolo Bonzini | qemu_put_be16(f, (unsigned int)v); |
166 | 701a8f76 | Paolo Bonzini | } |
167 | 701a8f76 | Paolo Bonzini | |
168 | 701a8f76 | Paolo Bonzini | static inline void qemu_put_sbe32(QEMUFile *f, int v) |
169 | 701a8f76 | Paolo Bonzini | { |
170 | 701a8f76 | Paolo Bonzini | qemu_put_be32(f, (unsigned int)v); |
171 | 701a8f76 | Paolo Bonzini | } |
172 | 701a8f76 | Paolo Bonzini | |
173 | 701a8f76 | Paolo Bonzini | static inline void qemu_put_sbe64(QEMUFile *f, int64_t v) |
174 | 701a8f76 | Paolo Bonzini | { |
175 | 701a8f76 | Paolo Bonzini | qemu_put_be64(f, (uint64_t)v); |
176 | 701a8f76 | Paolo Bonzini | } |
177 | 701a8f76 | Paolo Bonzini | |
178 | 701a8f76 | Paolo Bonzini | static inline size_t qemu_get_sbuffer(QEMUFile *f, int8_t *buf, int size) |
179 | 701a8f76 | Paolo Bonzini | { |
180 | 701a8f76 | Paolo Bonzini | return qemu_get_buffer(f, (uint8_t *)buf, size);
|
181 | 701a8f76 | Paolo Bonzini | } |
182 | 701a8f76 | Paolo Bonzini | |
183 | 701a8f76 | Paolo Bonzini | static inline int qemu_get_sbe16(QEMUFile *f) |
184 | 701a8f76 | Paolo Bonzini | { |
185 | 701a8f76 | Paolo Bonzini | return (int)qemu_get_be16(f); |
186 | 701a8f76 | Paolo Bonzini | } |
187 | 701a8f76 | Paolo Bonzini | |
188 | 701a8f76 | Paolo Bonzini | static inline int qemu_get_sbe32(QEMUFile *f) |
189 | 701a8f76 | Paolo Bonzini | { |
190 | 701a8f76 | Paolo Bonzini | return (int)qemu_get_be32(f); |
191 | 701a8f76 | Paolo Bonzini | } |
192 | 701a8f76 | Paolo Bonzini | |
193 | 701a8f76 | Paolo Bonzini | static inline int64_t qemu_get_sbe64(QEMUFile *f) |
194 | 701a8f76 | Paolo Bonzini | { |
195 | 701a8f76 | Paolo Bonzini | return (int64_t)qemu_get_be64(f);
|
196 | 701a8f76 | Paolo Bonzini | } |
197 | 701a8f76 | Paolo Bonzini | |
198 | 701a8f76 | Paolo Bonzini | static inline void qemu_put_s8s(QEMUFile *f, const int8_t *pv) |
199 | 701a8f76 | Paolo Bonzini | { |
200 | 701a8f76 | Paolo Bonzini | qemu_put_8s(f, (const uint8_t *)pv);
|
201 | 701a8f76 | Paolo Bonzini | } |
202 | 701a8f76 | Paolo Bonzini | |
203 | 701a8f76 | Paolo Bonzini | static inline void qemu_put_sbe16s(QEMUFile *f, const int16_t *pv) |
204 | 701a8f76 | Paolo Bonzini | { |
205 | 701a8f76 | Paolo Bonzini | qemu_put_be16s(f, (const uint16_t *)pv);
|
206 | 701a8f76 | Paolo Bonzini | } |
207 | 701a8f76 | Paolo Bonzini | |
208 | 701a8f76 | Paolo Bonzini | static inline void qemu_put_sbe32s(QEMUFile *f, const int32_t *pv) |
209 | 701a8f76 | Paolo Bonzini | { |
210 | 701a8f76 | Paolo Bonzini | qemu_put_be32s(f, (const uint32_t *)pv);
|
211 | 701a8f76 | Paolo Bonzini | } |
212 | 701a8f76 | Paolo Bonzini | |
213 | 701a8f76 | Paolo Bonzini | static inline void qemu_put_sbe64s(QEMUFile *f, const int64_t *pv) |
214 | 701a8f76 | Paolo Bonzini | { |
215 | 701a8f76 | Paolo Bonzini | qemu_put_be64s(f, (const uint64_t *)pv);
|
216 | 701a8f76 | Paolo Bonzini | } |
217 | 701a8f76 | Paolo Bonzini | |
218 | 701a8f76 | Paolo Bonzini | static inline void qemu_get_s8s(QEMUFile *f, int8_t *pv) |
219 | 701a8f76 | Paolo Bonzini | { |
220 | 701a8f76 | Paolo Bonzini | qemu_get_8s(f, (uint8_t *)pv); |
221 | 701a8f76 | Paolo Bonzini | } |
222 | 701a8f76 | Paolo Bonzini | |
223 | 701a8f76 | Paolo Bonzini | static inline void qemu_get_sbe16s(QEMUFile *f, int16_t *pv) |
224 | 701a8f76 | Paolo Bonzini | { |
225 | 701a8f76 | Paolo Bonzini | qemu_get_be16s(f, (uint16_t *)pv); |
226 | 701a8f76 | Paolo Bonzini | } |
227 | 701a8f76 | Paolo Bonzini | |
228 | 701a8f76 | Paolo Bonzini | static inline void qemu_get_sbe32s(QEMUFile *f, int32_t *pv) |
229 | 701a8f76 | Paolo Bonzini | { |
230 | 701a8f76 | Paolo Bonzini | qemu_get_be32s(f, (uint32_t *)pv); |
231 | 701a8f76 | Paolo Bonzini | } |
232 | 701a8f76 | Paolo Bonzini | |
233 | 701a8f76 | Paolo Bonzini | static inline void qemu_get_sbe64s(QEMUFile *f, int64_t *pv) |
234 | 701a8f76 | Paolo Bonzini | { |
235 | 701a8f76 | Paolo Bonzini | qemu_get_be64s(f, (uint64_t *)pv); |
236 | 701a8f76 | Paolo Bonzini | } |
237 | 701a8f76 | Paolo Bonzini | #endif |