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 typedef struct AccelState { 30 /*< private >*/ 31 Object parent_obj; 32 } AccelState; 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 */ 108