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