root / qemu-file.h @ 01e26b0e
History | View | Annotate | Download (6.9 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 | 93148aa5 | Stefan Weil | /* Called to determine if the file has exceeded its bandwidth allocation. The
|
55 | 701a8f76 | Paolo Bonzini | * bandwidth capping is a soft limit, not a hard limit.
|
56 | 701a8f76 | Paolo Bonzini | */
|
57 | 701a8f76 | Paolo Bonzini | typedef int (QEMUFileRateLimit)(void *opaque); |
58 | 701a8f76 | Paolo Bonzini | |
59 | 701a8f76 | Paolo Bonzini | /* Called to change the current bandwidth allocation. This function must return
|
60 | 701a8f76 | Paolo Bonzini | * the new actual bandwidth. It should be new_rate if everything goes ok, and
|
61 | 701a8f76 | Paolo Bonzini | * the old rate otherwise
|
62 | 701a8f76 | Paolo Bonzini | */
|
63 | 701a8f76 | Paolo Bonzini | typedef int64_t (QEMUFileSetRateLimit)(void *opaque, int64_t new_rate); |
64 | 701a8f76 | Paolo Bonzini | typedef int64_t (QEMUFileGetRateLimit)(void *opaque); |
65 | 701a8f76 | Paolo Bonzini | |
66 | 9229bf3c | Paolo Bonzini | typedef struct QEMUFileOps { |
67 | 9229bf3c | Paolo Bonzini | QEMUFilePutBufferFunc *put_buffer; |
68 | 9229bf3c | Paolo Bonzini | QEMUFileGetBufferFunc *get_buffer; |
69 | 9229bf3c | Paolo Bonzini | QEMUFileCloseFunc *close; |
70 | 70eb6330 | Paolo Bonzini | QEMUFileGetFD *get_fd; |
71 | 9229bf3c | Paolo Bonzini | QEMUFileRateLimit *rate_limit; |
72 | 9229bf3c | Paolo Bonzini | QEMUFileSetRateLimit *set_rate_limit; |
73 | 9229bf3c | Paolo Bonzini | QEMUFileGetRateLimit *get_rate_limit; |
74 | 9229bf3c | Paolo Bonzini | } QEMUFileOps; |
75 | 9229bf3c | Paolo Bonzini | |
76 | 9229bf3c | Paolo Bonzini | QEMUFile *qemu_fopen_ops(void *opaque, const QEMUFileOps *ops); |
77 | 701a8f76 | Paolo Bonzini | QEMUFile *qemu_fopen(const char *filename, const char *mode); |
78 | 701a8f76 | Paolo Bonzini | QEMUFile *qemu_fdopen(int fd, const char *mode); |
79 | 701a8f76 | Paolo Bonzini | QEMUFile *qemu_fopen_socket(int fd);
|
80 | 701a8f76 | Paolo Bonzini | QEMUFile *qemu_popen(FILE *popen_file, const char *mode); |
81 | 701a8f76 | Paolo Bonzini | QEMUFile *qemu_popen_cmd(const char *command, const char *mode); |
82 | 70eb6330 | Paolo Bonzini | int qemu_get_fd(QEMUFile *f);
|
83 | 701a8f76 | Paolo Bonzini | int qemu_fclose(QEMUFile *f);
|
84 | 701a8f76 | Paolo Bonzini | void qemu_put_buffer(QEMUFile *f, const uint8_t *buf, int size); |
85 | 701a8f76 | Paolo Bonzini | void qemu_put_byte(QEMUFile *f, int v); |
86 | 701a8f76 | Paolo Bonzini | |
87 | 701a8f76 | Paolo Bonzini | static inline void qemu_put_ubyte(QEMUFile *f, unsigned int v) |
88 | 701a8f76 | Paolo Bonzini | { |
89 | 701a8f76 | Paolo Bonzini | qemu_put_byte(f, (int)v);
|
90 | 701a8f76 | Paolo Bonzini | } |
91 | 701a8f76 | Paolo Bonzini | |
92 | 701a8f76 | Paolo Bonzini | #define qemu_put_sbyte qemu_put_byte
|
93 | 701a8f76 | Paolo Bonzini | |
94 | 701a8f76 | Paolo Bonzini | void qemu_put_be16(QEMUFile *f, unsigned int v); |
95 | 701a8f76 | Paolo Bonzini | void qemu_put_be32(QEMUFile *f, unsigned int v); |
96 | 701a8f76 | Paolo Bonzini | void qemu_put_be64(QEMUFile *f, uint64_t v);
|
97 | 701a8f76 | Paolo Bonzini | int qemu_get_buffer(QEMUFile *f, uint8_t *buf, int size); |
98 | 701a8f76 | Paolo Bonzini | int qemu_get_byte(QEMUFile *f);
|
99 | 701a8f76 | Paolo Bonzini | |
100 | 701a8f76 | Paolo Bonzini | static inline unsigned int qemu_get_ubyte(QEMUFile *f) |
101 | 701a8f76 | Paolo Bonzini | { |
102 | 701a8f76 | Paolo Bonzini | return (unsigned int)qemu_get_byte(f); |
103 | 701a8f76 | Paolo Bonzini | } |
104 | 701a8f76 | Paolo Bonzini | |
105 | 701a8f76 | Paolo Bonzini | #define qemu_get_sbyte qemu_get_byte
|
106 | 701a8f76 | Paolo Bonzini | |
107 | 701a8f76 | Paolo Bonzini | unsigned int qemu_get_be16(QEMUFile *f); |
108 | 701a8f76 | Paolo Bonzini | unsigned int qemu_get_be32(QEMUFile *f); |
109 | 701a8f76 | Paolo Bonzini | uint64_t qemu_get_be64(QEMUFile *f); |
110 | 701a8f76 | Paolo Bonzini | |
111 | 701a8f76 | Paolo Bonzini | int qemu_file_rate_limit(QEMUFile *f);
|
112 | 701a8f76 | Paolo Bonzini | int64_t 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 | 701a8f76 | Paolo Bonzini | |
116 | 701a8f76 | Paolo Bonzini | /* Try to send any outstanding data. This function is useful when output is
|
117 | 701a8f76 | Paolo Bonzini | * halted due to rate limiting or EAGAIN errors occur as it can be used to
|
118 | 701a8f76 | Paolo Bonzini | * resume output. */
|
119 | a2b41351 | Juan Quintela | int qemu_file_put_notify(QEMUFile *f);
|
120 | 701a8f76 | Paolo Bonzini | |
121 | 701a8f76 | Paolo Bonzini | static inline void qemu_put_be64s(QEMUFile *f, const uint64_t *pv) |
122 | 701a8f76 | Paolo Bonzini | { |
123 | 701a8f76 | Paolo Bonzini | qemu_put_be64(f, *pv); |
124 | 701a8f76 | Paolo Bonzini | } |
125 | 701a8f76 | Paolo Bonzini | |
126 | 701a8f76 | Paolo Bonzini | static inline void qemu_put_be32s(QEMUFile *f, const uint32_t *pv) |
127 | 701a8f76 | Paolo Bonzini | { |
128 | 701a8f76 | Paolo Bonzini | qemu_put_be32(f, *pv); |
129 | 701a8f76 | Paolo Bonzini | } |
130 | 701a8f76 | Paolo Bonzini | |
131 | 701a8f76 | Paolo Bonzini | static inline void qemu_put_be16s(QEMUFile *f, const uint16_t *pv) |
132 | 701a8f76 | Paolo Bonzini | { |
133 | 701a8f76 | Paolo Bonzini | qemu_put_be16(f, *pv); |
134 | 701a8f76 | Paolo Bonzini | } |
135 | 701a8f76 | Paolo Bonzini | |
136 | 701a8f76 | Paolo Bonzini | static inline void qemu_put_8s(QEMUFile *f, const uint8_t *pv) |
137 | 701a8f76 | Paolo Bonzini | { |
138 | 701a8f76 | Paolo Bonzini | qemu_put_byte(f, *pv); |
139 | 701a8f76 | Paolo Bonzini | } |
140 | 701a8f76 | Paolo Bonzini | |
141 | 701a8f76 | Paolo Bonzini | static inline void qemu_get_be64s(QEMUFile *f, uint64_t *pv) |
142 | 701a8f76 | Paolo Bonzini | { |
143 | 701a8f76 | Paolo Bonzini | *pv = qemu_get_be64(f); |
144 | 701a8f76 | Paolo Bonzini | } |
145 | 701a8f76 | Paolo Bonzini | |
146 | 701a8f76 | Paolo Bonzini | static inline void qemu_get_be32s(QEMUFile *f, uint32_t *pv) |
147 | 701a8f76 | Paolo Bonzini | { |
148 | 701a8f76 | Paolo Bonzini | *pv = qemu_get_be32(f); |
149 | 701a8f76 | Paolo Bonzini | } |
150 | 701a8f76 | Paolo Bonzini | |
151 | 701a8f76 | Paolo Bonzini | static inline void qemu_get_be16s(QEMUFile *f, uint16_t *pv) |
152 | 701a8f76 | Paolo Bonzini | { |
153 | 701a8f76 | Paolo Bonzini | *pv = qemu_get_be16(f); |
154 | 701a8f76 | Paolo Bonzini | } |
155 | 701a8f76 | Paolo Bonzini | |
156 | 701a8f76 | Paolo Bonzini | static inline void qemu_get_8s(QEMUFile *f, uint8_t *pv) |
157 | 701a8f76 | Paolo Bonzini | { |
158 | 701a8f76 | Paolo Bonzini | *pv = qemu_get_byte(f); |
159 | 701a8f76 | Paolo Bonzini | } |
160 | 701a8f76 | Paolo Bonzini | |
161 | 701a8f76 | Paolo Bonzini | // Signed versions for type safety
|
162 | 701a8f76 | Paolo Bonzini | static inline void qemu_put_sbuffer(QEMUFile *f, const int8_t *buf, int size) |
163 | 701a8f76 | Paolo Bonzini | { |
164 | 701a8f76 | Paolo Bonzini | qemu_put_buffer(f, (const uint8_t *)buf, size);
|
165 | 701a8f76 | Paolo Bonzini | } |
166 | 701a8f76 | Paolo Bonzini | |
167 | 701a8f76 | Paolo Bonzini | static inline void qemu_put_sbe16(QEMUFile *f, int v) |
168 | 701a8f76 | Paolo Bonzini | { |
169 | 701a8f76 | Paolo Bonzini | qemu_put_be16(f, (unsigned int)v); |
170 | 701a8f76 | Paolo Bonzini | } |
171 | 701a8f76 | Paolo Bonzini | |
172 | 701a8f76 | Paolo Bonzini | static inline void qemu_put_sbe32(QEMUFile *f, int v) |
173 | 701a8f76 | Paolo Bonzini | { |
174 | 701a8f76 | Paolo Bonzini | qemu_put_be32(f, (unsigned int)v); |
175 | 701a8f76 | Paolo Bonzini | } |
176 | 701a8f76 | Paolo Bonzini | |
177 | 701a8f76 | Paolo Bonzini | static inline void qemu_put_sbe64(QEMUFile *f, int64_t v) |
178 | 701a8f76 | Paolo Bonzini | { |
179 | 701a8f76 | Paolo Bonzini | qemu_put_be64(f, (uint64_t)v); |
180 | 701a8f76 | Paolo Bonzini | } |
181 | 701a8f76 | Paolo Bonzini | |
182 | 701a8f76 | Paolo Bonzini | static inline size_t qemu_get_sbuffer(QEMUFile *f, int8_t *buf, int size) |
183 | 701a8f76 | Paolo Bonzini | { |
184 | 701a8f76 | Paolo Bonzini | return qemu_get_buffer(f, (uint8_t *)buf, size);
|
185 | 701a8f76 | Paolo Bonzini | } |
186 | 701a8f76 | Paolo Bonzini | |
187 | 701a8f76 | Paolo Bonzini | static inline int qemu_get_sbe16(QEMUFile *f) |
188 | 701a8f76 | Paolo Bonzini | { |
189 | 701a8f76 | Paolo Bonzini | return (int)qemu_get_be16(f); |
190 | 701a8f76 | Paolo Bonzini | } |
191 | 701a8f76 | Paolo Bonzini | |
192 | 701a8f76 | Paolo Bonzini | static inline int qemu_get_sbe32(QEMUFile *f) |
193 | 701a8f76 | Paolo Bonzini | { |
194 | 701a8f76 | Paolo Bonzini | return (int)qemu_get_be32(f); |
195 | 701a8f76 | Paolo Bonzini | } |
196 | 701a8f76 | Paolo Bonzini | |
197 | 701a8f76 | Paolo Bonzini | static inline int64_t qemu_get_sbe64(QEMUFile *f) |
198 | 701a8f76 | Paolo Bonzini | { |
199 | 701a8f76 | Paolo Bonzini | return (int64_t)qemu_get_be64(f);
|
200 | 701a8f76 | Paolo Bonzini | } |
201 | 701a8f76 | Paolo Bonzini | |
202 | 701a8f76 | Paolo Bonzini | static inline void qemu_put_s8s(QEMUFile *f, const int8_t *pv) |
203 | 701a8f76 | Paolo Bonzini | { |
204 | 701a8f76 | Paolo Bonzini | qemu_put_8s(f, (const uint8_t *)pv);
|
205 | 701a8f76 | Paolo Bonzini | } |
206 | 701a8f76 | Paolo Bonzini | |
207 | 701a8f76 | Paolo Bonzini | static inline void qemu_put_sbe16s(QEMUFile *f, const int16_t *pv) |
208 | 701a8f76 | Paolo Bonzini | { |
209 | 701a8f76 | Paolo Bonzini | qemu_put_be16s(f, (const uint16_t *)pv);
|
210 | 701a8f76 | Paolo Bonzini | } |
211 | 701a8f76 | Paolo Bonzini | |
212 | 701a8f76 | Paolo Bonzini | static inline void qemu_put_sbe32s(QEMUFile *f, const int32_t *pv) |
213 | 701a8f76 | Paolo Bonzini | { |
214 | 701a8f76 | Paolo Bonzini | qemu_put_be32s(f, (const uint32_t *)pv);
|
215 | 701a8f76 | Paolo Bonzini | } |
216 | 701a8f76 | Paolo Bonzini | |
217 | 701a8f76 | Paolo Bonzini | static inline void qemu_put_sbe64s(QEMUFile *f, const int64_t *pv) |
218 | 701a8f76 | Paolo Bonzini | { |
219 | 701a8f76 | Paolo Bonzini | qemu_put_be64s(f, (const uint64_t *)pv);
|
220 | 701a8f76 | Paolo Bonzini | } |
221 | 701a8f76 | Paolo Bonzini | |
222 | 701a8f76 | Paolo Bonzini | static inline void qemu_get_s8s(QEMUFile *f, int8_t *pv) |
223 | 701a8f76 | Paolo Bonzini | { |
224 | 701a8f76 | Paolo Bonzini | qemu_get_8s(f, (uint8_t *)pv); |
225 | 701a8f76 | Paolo Bonzini | } |
226 | 701a8f76 | Paolo Bonzini | |
227 | 701a8f76 | Paolo Bonzini | static inline void qemu_get_sbe16s(QEMUFile *f, int16_t *pv) |
228 | 701a8f76 | Paolo Bonzini | { |
229 | 701a8f76 | Paolo Bonzini | qemu_get_be16s(f, (uint16_t *)pv); |
230 | 701a8f76 | Paolo Bonzini | } |
231 | 701a8f76 | Paolo Bonzini | |
232 | 701a8f76 | Paolo Bonzini | static inline void qemu_get_sbe32s(QEMUFile *f, int32_t *pv) |
233 | 701a8f76 | Paolo Bonzini | { |
234 | 701a8f76 | Paolo Bonzini | qemu_get_be32s(f, (uint32_t *)pv); |
235 | 701a8f76 | Paolo Bonzini | } |
236 | 701a8f76 | Paolo Bonzini | |
237 | 701a8f76 | Paolo Bonzini | static inline void qemu_get_sbe64s(QEMUFile *f, int64_t *pv) |
238 | 701a8f76 | Paolo Bonzini | { |
239 | 701a8f76 | Paolo Bonzini | qemu_get_be64s(f, (uint64_t *)pv); |
240 | 701a8f76 | Paolo Bonzini | } |
241 | 701a8f76 | Paolo Bonzini | #endif |