include/migration/qemu-file.h

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