cachepc-qemu

Fork of AMDESE/qemu with changes for cachepc side-channel attack
git clone https://git.sinitax.com/sinitax/cachepc-qemu
Log | Files | Refs | Submodules | LICENSE | sfeed.txt

block-copy.h (3492B)

      1/*
      2 * block_copy API
      3 *
      4 * Copyright (C) 2013 Proxmox Server Solutions
      5 * Copyright (c) 2019 Virtuozzo International GmbH.
      6 *
      7 * Authors:
      8 *  Dietmar Maurer (dietmar@proxmox.com)
      9 *  Vladimir Sementsov-Ogievskiy <vsementsov@virtuozzo.com>
     10 *
     11 * This work is licensed under the terms of the GNU GPL, version 2 or later.
     12 * See the COPYING file in the top-level directory.
     13 */
     14
     15#ifndef BLOCK_COPY_H
     16#define BLOCK_COPY_H
     17
     18#include "block/block.h"
     19#include "qemu/co-shared-resource.h"
     20
     21/* All APIs are thread-safe */
     22
     23typedef void (*BlockCopyAsyncCallbackFunc)(void *opaque);
     24typedef struct BlockCopyState BlockCopyState;
     25typedef struct BlockCopyCallState BlockCopyCallState;
     26
     27BlockCopyState *block_copy_state_new(BdrvChild *source, BdrvChild *target,
     28                                     Error **errp);
     29
     30/* Function should be called prior any actual copy request */
     31void block_copy_set_copy_opts(BlockCopyState *s, bool use_copy_range,
     32                              bool compress);
     33void block_copy_set_progress_meter(BlockCopyState *s, ProgressMeter *pm);
     34
     35void block_copy_state_free(BlockCopyState *s);
     36
     37int64_t block_copy_reset_unallocated(BlockCopyState *s,
     38                                     int64_t offset, int64_t *count);
     39
     40int coroutine_fn block_copy(BlockCopyState *s, int64_t offset, int64_t bytes,
     41                            bool ignore_ratelimit);
     42
     43/*
     44 * Run block-copy in a coroutine, create corresponding BlockCopyCallState
     45 * object and return pointer to it. Never returns NULL.
     46 *
     47 * Caller is responsible to call block_copy_call_free() to free
     48 * BlockCopyCallState object.
     49 *
     50 * @max_workers means maximum of parallel coroutines to execute sub-requests,
     51 * must be > 0.
     52 *
     53 * @max_chunk means maximum length for one IO operation. Zero means unlimited.
     54 */
     55BlockCopyCallState *block_copy_async(BlockCopyState *s,
     56                                     int64_t offset, int64_t bytes,
     57                                     int max_workers, int64_t max_chunk,
     58                                     BlockCopyAsyncCallbackFunc cb,
     59                                     void *cb_opaque);
     60
     61/*
     62 * Free finished BlockCopyCallState. Trying to free running
     63 * block-copy will crash.
     64 */
     65void block_copy_call_free(BlockCopyCallState *call_state);
     66
     67/*
     68 * Note, that block-copy call is marked finished prior to calling
     69 * the callback.
     70 */
     71bool block_copy_call_finished(BlockCopyCallState *call_state);
     72bool block_copy_call_succeeded(BlockCopyCallState *call_state);
     73bool block_copy_call_failed(BlockCopyCallState *call_state);
     74bool block_copy_call_cancelled(BlockCopyCallState *call_state);
     75int block_copy_call_status(BlockCopyCallState *call_state, bool *error_is_read);
     76
     77void block_copy_set_speed(BlockCopyState *s, uint64_t speed);
     78void block_copy_kick(BlockCopyCallState *call_state);
     79
     80/*
     81 * Cancel running block-copy call.
     82 *
     83 * Cancel leaves block-copy state valid: dirty bits are correct and you may use
     84 * cancel + <run block_copy with same parameters> to emulate pause/resume.
     85 *
     86 * Note also, that the cancel is async: it only marks block-copy call to be
     87 * cancelled. So, the call may be cancelled (block_copy_call_cancelled() reports
     88 * true) but not yet finished (block_copy_call_finished() reports false).
     89 */
     90void block_copy_call_cancel(BlockCopyCallState *call_state);
     91
     92BdrvDirtyBitmap *block_copy_dirty_bitmap(BlockCopyState *s);
     93int64_t block_copy_cluster_size(BlockCopyState *s);
     94void block_copy_set_skip_unallocated(BlockCopyState *s, bool skip);
     95
     96#endif /* BLOCK_COPY_H */