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

yank.h (2480B)


      1/*
      2 * QEMU yank feature
      3 *
      4 * Copyright (c) Lukas Straub <lukasstraub2@web.de>
      5 *
      6 * This work is licensed under the terms of the GNU GPL, version 2 or later.
      7 * See the COPYING file in the top-level directory.
      8 */
      9
     10#ifndef YANK_H
     11#define YANK_H
     12
     13#include "qapi/qapi-types-yank.h"
     14
     15typedef void (YankFn)(void *opaque);
     16
     17/**
     18 * yank_register_instance: Register a new instance.
     19 *
     20 * This registers a new instance for yanking. Must be called before any yank
     21 * function is registered for this instance.
     22 *
     23 * This function is thread-safe.
     24 *
     25 * @instance: The instance.
     26 * @errp: Error object.
     27 *
     28 * Returns true on success or false if an error occured.
     29 */
     30bool yank_register_instance(const YankInstance *instance, Error **errp);
     31
     32/**
     33 * yank_unregister_instance: Unregister a instance.
     34 *
     35 * This unregisters a instance. Must be called only after every yank function
     36 * of the instance has been unregistered.
     37 *
     38 * This function is thread-safe.
     39 *
     40 * @instance: The instance.
     41 */
     42void yank_unregister_instance(const YankInstance *instance);
     43
     44/**
     45 * yank_register_function: Register a yank function
     46 *
     47 * This registers a yank function. All limitations of qmp oob commands apply
     48 * to the yank function as well. See docs/devel/qapi-code-gen.txt under
     49 * "An OOB-capable command handler must satisfy the following conditions".
     50 *
     51 * This function is thread-safe.
     52 *
     53 * @instance: The instance.
     54 * @func: The yank function.
     55 * @opaque: Will be passed to the yank function.
     56 */
     57void yank_register_function(const YankInstance *instance,
     58                            YankFn *func,
     59                            void *opaque);
     60
     61/**
     62 * yank_unregister_function: Unregister a yank function
     63 *
     64 * This unregisters a yank function.
     65 *
     66 * This function is thread-safe.
     67 *
     68 * @instance: The instance.
     69 * @func: func that was passed to yank_register_function.
     70 * @opaque: opaque that was passed to yank_register_function.
     71 */
     72void yank_unregister_function(const YankInstance *instance,
     73                              YankFn *func,
     74                              void *opaque);
     75
     76#define BLOCKDEV_YANK_INSTANCE(the_node_name) (&(YankInstance) { \
     77        .type = YANK_INSTANCE_TYPE_BLOCK_NODE, \
     78        .u.block_node.node_name = (the_node_name) })
     79
     80#define CHARDEV_YANK_INSTANCE(the_id) (&(YankInstance) { \
     81        .type = YANK_INSTANCE_TYPE_CHARDEV, \
     82        .u.chardev.id = (the_id) })
     83
     84#define MIGRATION_YANK_INSTANCE (&(YankInstance) { \
     85        .type = YANK_INSTANCE_TYPE_MIGRATION })
     86
     87#endif