Palacios Public Git Repository

To checkout Palacios execute

  git clone http://v3vee.org/palacios/palacios.web/palacios.git
This will give you the master branch. You probably want the devel branch or one of the release branches. To switch to the devel branch, simply execute
  cd palacios
  git checkout --track -b devel origin/devel
The other branches are similar.


added dedicated debugging framework with associated interface
[palacios.git] / palacios / include / palacios / vm_guest.h
1 /*
2  * This file is part of the Palacios Virtual Machine Monitor developed
3  * by the V3VEE Project with funding from the United States National 
4  * Science Foundation and the Department of Energy.  
5  *
6  * The V3VEE Project is a joint project between Northwestern University
7  * and the University of New Mexico.  You can find out more at 
8  * http://www.v3vee.org
9  *
10  * Copyright (c) 2008, Jack Lange <jarusl@cs.northwestern.edu> 
11  * Copyright (c) 2008, The V3VEE Project <http://www.v3vee.org> 
12  * All rights reserved.
13  *
14  * Author: Jack Lange <jarusl@cs.northwestern.edu>
15  *
16  * This is free software.  You are permitted to use,
17  * redistribute, and modify it as specified in the file "V3VEE_LICENSE".
18  */
19
20 #ifndef __VM_GUEST_H__
21 #define __VM_GUEST_H__
22
23 #ifdef __V3VEE__
24
25 #include <palacios/vmm_types.h>
26 #include <palacios/vmm_mem.h>
27 #include <palacios/vmm_mem_hook.h>
28 #include <palacios/vmm_io.h>
29 #include <palacios/vmm_shadow_paging.h>
30 #include <palacios/vmm_intr.h>
31 #include <palacios/vmm_excp.h>
32 #include <palacios/vmm_dev_mgr.h>
33 #include <palacios/vmm_time.h>
34 #include <palacios/vmm_host_events.h>
35 #include <palacios/vmm_msr.h>
36 #include <palacios/vmm_hypercall.h>
37 #include <palacios/vmm_cpuid.h>
38 #include <palacios/vmm_regs.h>
39 #include <palacios/vmm_extensions.h>
40 #include <palacios/vmm_barrier.h>
41 #include <palacios/vmm_timeout.h>
42
43
44 #ifdef V3_CONFIG_TELEMETRY
45 #include <palacios/vmm_telemetry.h>
46 #endif
47
48
49 #ifdef V3_CONFIG_SYMBIOTIC
50 #include <palacios/vmm_symbiotic.h>
51 struct v3_sym_core_state;
52 #endif
53
54
55
56 #include <palacios/vmm_config.h>
57
58 struct v3_intr_state;
59
60
61
62
63 /* per-core state */
64 struct guest_info {
65     char exec_name[256];
66     
67     uint64_t rip;
68
69     uint_t cpl;
70
71     struct vm_core_time time_state;
72     struct v3_core_timeouts timeouts;
73
74     v3_paging_mode_t shdw_pg_mode;
75     struct v3_shdw_pg_state shdw_pg_state;
76     addr_t direct_map_pt;
77     
78
79     union {
80         uint32_t flags;
81         struct {
82             uint8_t use_large_pages        : 1;    /* Enable virtual page tables to use large pages */
83             uint8_t use_giant_pages        : 1;    /* Enable virtual page tables to use giant (1GB) pages */
84             uint32_t rsvd                  : 30;
85         } __attribute__((packed));
86     } __attribute__((packed));
87
88
89     /* This structure is how we get interrupts for the guest */
90     struct v3_intr_core_state intr_core_state;
91
92     /* This structure is how we get exceptions for the guest */
93     struct v3_excp_state excp_state;
94
95
96     v3_cpu_mode_t cpu_mode;
97     v3_mem_mode_t mem_mode;
98
99
100     struct v3_gprs vm_regs;
101     struct v3_ctrl_regs ctrl_regs;
102     struct v3_dbg_regs dbg_regs;
103     struct v3_segments segments;
104     struct v3_msrs     msrs;
105
106
107     void * vmm_data;
108
109     uint64_t yield_start_cycle;
110     
111     uint64_t num_exits;
112
113 #ifdef V3_CONFIG_TELEMETRY
114     struct v3_core_telemetry core_telem;
115 #endif
116
117
118     /* struct v3_core_dev_mgr core_dev_mgr; */
119
120     void * decoder_state;
121
122 #ifdef V3_CONFIG_SYMBIOTIC
123     /* Symbiotic state */
124     struct v3_sym_core_state sym_core_state;
125 #endif
126
127     /* Per-core config tree data. */
128     v3_cfg_tree_t * core_cfg_data;
129
130     struct v3_vm_info * vm_info;
131
132     v3_core_operating_mode_t core_run_state;
133
134     void * core_thread; /* thread struct for virtual core */
135
136     /* the logical cpu on which this core runs */
137     uint32_t pcpu_id;
138     
139     /* The virtual core # of this cpu (what the guest sees this core as) */
140     uint32_t vcpu_id;
141      
142 };
143
144
145
146 /* shared state across cores */
147 struct v3_vm_info {
148     char name[128];
149
150     v3_vm_class_t vm_class;
151
152     addr_t mem_size; /* In bytes for now */
153     uint32_t mem_align;
154     struct v3_mem_map mem_map;
155
156     struct v3_mem_hooks mem_hooks;
157
158     struct v3_shdw_impl_state shdw_impl;
159
160     struct v3_io_map io_map;
161     struct v3_msr_map msr_map;
162     struct v3_cpuid_map cpuid_map;
163
164     v3_hypercall_map_t hcall_map;
165
166
167     struct v3_intr_routers intr_routers;
168
169     /* device_map */
170     struct vmm_dev_mgr  dev_mgr;
171
172     struct v3_time time_state;
173
174     struct v3_host_events host_event_hooks;
175
176     struct v3_config * cfg_data;
177
178     v3_vm_operating_mode_t run_state;
179
180     struct v3_barrier barrier;
181
182
183     struct v3_extensions extensions;
184
185 #ifdef V3_CONFIG_SYMBIOTIC
186     /* Symbiotic state */
187     struct v3_sym_vm_state sym_vm_state;
188 #endif
189
190 #ifdef V3_CONFIG_TELEMETRY
191     uint_t enable_telemetry;
192     struct v3_telemetry_state telemetry;
193 #endif
194
195
196     uint64_t yield_cycle_period;  
197
198
199     void * host_priv_data;
200
201     int num_cores;
202
203     // JRL: This MUST be the last entry...
204     struct guest_info cores[0];
205 };
206
207 int v3_init_vm(struct v3_vm_info * vm);
208 int v3_init_core(struct guest_info * core);
209
210 int v3_free_vm_internal(struct v3_vm_info * vm);
211 int v3_free_core(struct guest_info * core);
212
213
214 uint_t v3_get_addr_width(struct guest_info * info);
215 v3_cpu_mode_t v3_get_vm_cpu_mode(struct guest_info * info);
216 v3_mem_mode_t v3_get_vm_mem_mode(struct guest_info * info);
217
218
219 const uchar_t * v3_cpu_mode_to_str(v3_cpu_mode_t mode);
220 const uchar_t * v3_mem_mode_to_str(v3_mem_mode_t mode);
221
222
223
224 #endif /* ! __V3VEE__ */
225
226
227
228 #endif