include/qemu/accel.h

   1 /* QEMU accelerator interfaces
   2  *
   3  * Copyright (c) 2014 Red Hat Inc
   4  *
   5  * Permission is hereby granted, free of charge, to any person obtaining a copy
   6  * of this software and associated documentation files (the "Software"), to deal
   7  * in the Software without restriction, including without limitation the rights
   8  * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
   9  * copies of the Software, and to permit persons to whom the Software is
  10  * furnished to do so, subject to the following conditions:
  11  *
  12  * The above copyright notice and this permission notice shall be included in
  13  * all copies or substantial portions of the Software.
  14  *
  15  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  16  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  17  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
  18  * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  19  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
  20  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
  21  * THE SOFTWARE.
  22  */
  23 #ifndef QEMU_ACCEL_H
  24 #define QEMU_ACCEL_H
  25
  26 #include "qom/object.h"
  27 #include "exec/hwaddr.h"
  28
  29 struct AccelState {
  30     /*< private >*/
  31     Object parent_obj;
  32 };
  33
  34 typedef struct AccelClass {
  35     /*< private >*/
  36     ObjectClass parent_class;
  37     /*< public >*/
  38
  39     const char *name;
  40     int (*init_machine)(MachineState *ms);
  41 #ifndef CONFIG_USER_ONLY
  42     void (*setup_post)(MachineState *ms, AccelState *accel);
  43     bool (*has_memory)(MachineState *ms, AddressSpace *as,
  44                        hwaddr start_addr, hwaddr size);
  45 #endif
  46
  47     /* gdbstub related hooks */
  48     int (*gdbstub_supported_sstep_flags)(void);
  49
  50     bool *allowed;
  51     /*
  52      * Array of global properties that would be applied when specific
  53      * accelerator is chosen. It works like MachineClass.compat_props
  54      * but it's for accelerators not machines. Accelerator-provided
  55      * global properties may be overridden by machine-type
  56      * compat_props or user-provided global properties.
  57      */
  58     GPtrArray *compat_props;
  59 } AccelClass;
  60
  61 #define TYPE_ACCEL "accel"
  62
  63 #define ACCEL_CLASS_SUFFIX  "-" TYPE_ACCEL
  64 #define ACCEL_CLASS_NAME(a) (a ACCEL_CLASS_SUFFIX)
  65
  66 #define ACCEL_CLASS(klass) \
  67     OBJECT_CLASS_CHECK(AccelClass, (klass), TYPE_ACCEL)
  68 #define ACCEL(obj) \
  69     OBJECT_CHECK(AccelState, (obj), TYPE_ACCEL)
  70 #define ACCEL_GET_CLASS(obj) \
  71     OBJECT_GET_CLASS(AccelClass, (obj), TYPE_ACCEL)
  72
  73 AccelClass *accel_find(const char *opt_name);
  74 AccelState *current_accel(void);
  75 const char *current_accel_name(void);
  76
  77 void accel_init_interfaces(AccelClass *ac);
  78
  79 #ifndef CONFIG_USER_ONLY
  80 int accel_init_machine(AccelState *accel, MachineState *ms);
  81
  82 /* Called just before os_setup_post (ie just before drop OS privs) */
  83 void accel_setup_post(MachineState *ms);
  84 #endif /* !CONFIG_USER_ONLY */
  85
  86 /**
  87  * accel_cpu_instance_init:
  88  * @cpu: The CPU that needs to do accel-specific object initializations.
  89  */
  90 void accel_cpu_instance_init(CPUState *cpu);
  91
  92 /**
  93  * accel_cpu_realizefn:
  94  * @cpu: The CPU that needs to call accel-specific cpu realization.
  95  * @errp: currently unused.
  96  */
  97 bool accel_cpu_realizefn(CPUState *cpu, Error **errp);
  98
  99 /**
 100  * accel_supported_gdbstub_sstep_flags:
 101  *
 102  * Returns the supported single step modes for the configured
 103  * accelerator.
 104  */
 105 int accel_supported_gdbstub_sstep_flags(void);
 106
 107 #endif /* QEMU_ACCEL_H */