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.


updated comments for compiler compatibility
[palacios.git] / palacios / include / palacios / vmm_mem.h
index 83bba61..5484007 100644 (file)
@@ -1,5 +1,22 @@
-/* Northwestern University */
-/* (c) 2008, Jack Lange <jarusl@cs.northwestern.edu> */
+/*
+ * This file is part of the Palacios Virtual Machine Monitor developed
+ * by the V3VEE Project with funding from the United States National 
+ * Science Foundation and the Department of Energy.  
+ *
+ * The V3VEE Project is a joint project between Northwestern University
+ * and the University of New Mexico.  You can find out more at 
+ * http://www.v3vee.org
+ *
+ * Copyright (c) 2008, Jack Lange <jarusl@cs.northwestern.edu> 
+ * Copyright (c) 2008, The V3VEE Project <http://www.v3vee.org> 
+ * All rights reserved.
+ *
+ * Author: Jack Lange <jarusl@cs.northwestern.edu>
+ *
+ * This is free software.  You are permitted to use,
+ * redistribute, and modify it as specified in the file "V3VEE_LICENSE".
+ */
+
 
 #ifndef __VMM_MEM_H
 #define __VMM_MEM_H
 #include <palacios/vmm_types.h>
 
 #include <palacios/vmm_paging.h>
+#include <palacios/vmm_rbtree.h>
+
 
 struct guest_info;
 
 
-/*
 
-        Guest                  Shadow                 Host
-  Virtual   Physical    Virtual     Physical   Virtual     Physical
-               OK                      OK
-               OK                      NOK
-               NOK                     OK
-               NOK                     NOK
+/* These are the types of physical memory address regions
+ * from the perspective of the HOST
+ */
+typedef enum shdw_region_type { 
+    SHDW_REGION_WRITE_HOOK,                 /* This region is mapped as read-only (page faults on write) */
+    SHDW_REGION_FULL_HOOK,                  /* This region is mapped as not present (always generate page faults) */
+    SHDW_REGION_ALLOCATED,                  /* Region is a section of host memory */
+} v3_shdw_region_type_t;
 
-*/
 
-// These are the types of physical memory address regions
-// from the perspective of the guest
-typedef enum guest_region_type { 
-  GUEST_REGION_NOTHING, 
-  GUEST_REGION_PHYSICAL_MEMORY, 
-  GUEST_REGION_MEMORY_MAPPED_DEVICE} guest_region_type_t;
 
-// These are the types of physical memory address regions
-// from the perspective of the HOST
-typedef enum host_region_type { 
-  HOST_REGION_INVALID,                    // This region is INVALID (this is a return type, to denote errors)
-  HOST_REGION_HOOK,                       // This region is mapped as not present (always generate page faults)
-  HOST_REGION_PHYSICAL_MEMORY,            // Region is a section of host memory
-  HOST_REGION_MEMORY_MAPPED_DEVICE,       // Region is allocated for DMA
-  HOST_REGION_UNALLOCATED,                // Region is mapped on demand
-  HOST_REGION_REMOTE,                     // Region is located on a remote machine
-  HOST_REGION_SWAPPED,                    // Region is swapped
-} host_region_type_t;
 
+struct v3_shadow_region {
+    addr_t                  guest_start; 
+    addr_t                  guest_end; 
 
+    v3_shdw_region_type_t   host_type;
+  
+    addr_t                  host_addr; /* This either points to a host address mapping */
 
-#define shadow_mem_type_t host_region_type_t
 
-struct shadow_region {
-  guest_region_type_t     guest_type;
-  addr_t                  guest_start; 
-  addr_t                  guest_end; 
+    /* Called when data is read from a memory page */
+    int (*read_hook)(addr_t guest_addr, void * dst, uint_t length, void * priv_data);
+    /* Called when data is written to a memory page */
+    int (*write_hook)(addr_t guest_addr, void * src, uint_t length, void * priv_data);
 
-  host_region_type_t      host_type;
-  addr_t                  host_addr; // This either points to a host address mapping, 
-                                     // or a structure holding the map info 
+    void * priv_data;
 
-  struct shadow_region *next, *prev;
+    struct rb_node tree_node;
 };
 
 
+typedef struct v3_shdw_map {
+    struct v3_shadow_region base_region;
 
-struct shadow_map {
-  uint_t num_regions;
 
-  struct shadow_region * head;
-};
+    addr_t hook_hva;
 
+    struct rb_root shdw_regions;
+} v3_shdw_map_t;
 
-void init_shadow_region(struct shadow_region * entry,
-                          addr_t               guest_addr_start,
-                          addr_t               guest_addr_end,
-                          guest_region_type_t  guest_region_type,
-                          host_region_type_t   host_region_type);
 
-/*
-void init_shadow_region_physical(struct shadow_region * entry,
-                                   addr_t               guest_addr_start,
-                                   addr_t               guest_addr_end,
-                                   guest_region_type_t  guest_region_type,
-                                   addr_t               host_addr_start,
-                                   host_region_type_t   host_region_type);
-*/
 
-int add_shadow_region_passthrough(struct guest_info * guest_info, 
-                                 addr_t guest_addr_start,
-                                 addr_t guest_addr_end,
-                                 addr_t host_addr);
 
-void init_shadow_map(struct guest_info * info);
-void free_shadow_map(struct shadow_map * map);
+int v3_init_shadow_map(struct guest_info * info);
+void v3_delete_shadow_map(struct guest_info * info);
 
-struct shadow_region * get_shadow_region_by_addr(struct shadow_map * map, addr_t guest_addr);
 
-struct shadow_region * get_shadow_region_by_index(struct shadow_map * map, uint_t index);
+int v3_add_shadow_mem(struct guest_info * guest_info, 
+                     addr_t guest_addr_start,
+                     addr_t guest_addr_end,
+                     addr_t host_addr);
 
-host_region_type_t lookup_shadow_map_addr(struct shadow_map * map, addr_t guest_addr, addr_t * host_addr);
+int v3_hook_full_mem(struct guest_info * info, addr_t guest_addr_start, addr_t guest_addr_end,
+                    int (*read)(addr_t guest_addr, void * dst, uint_t length, void * priv_data),
+                    int (*write)(addr_t guest_addr, void * src, uint_t length, void * priv_data),
+                    void * priv_data);
 
-host_region_type_t get_shadow_addr_type(struct guest_info * info, addr_t guest_addr);
-addr_t get_shadow_addr(struct guest_info * info, addr_t guest_addr);
+int v3_hook_write_mem(struct guest_info * info, addr_t guest_addr_start, addr_t guest_addr_end,
+                     addr_t host_addr,
+                     int (*write)(addr_t guest_addr, void * src, uint_t length, void * priv_data),
+                     void * priv_data);
 
-// Semantics:
-// Adding a region that overlaps with an existing region results is undefined
-// and will probably fail
-int add_shadow_region(struct shadow_map * map, struct shadow_region * entry);
 
-// Semantics:
-// Deletions result in splitting
-int delete_shadow_region(struct shadow_map * map,
-                            addr_t guest_start, 
-                            addr_t guest_end);
 
+int v3_unhook_mem(struct guest_info * info, addr_t guest_addr_start);
 
-void print_shadow_map(struct shadow_map * map);
 
+void v3_delete_shadow_region(struct guest_info * info, struct v3_shadow_region * reg);
 
 
-struct vmm_mem_hook {
-  // Called when data is read from a memory page
-  int (*read)(addr_t guest_addr, void * dst, uint_t length, void * priv_data);
-  
-  // Called when data is written to a memory page
-  int (*write)(addr_t guest_addr, void * src, uint_t length, void * priv_data);
 
-  void * priv_data;
-  struct shadow_region * region;
-};
+
+struct v3_shadow_region * v3_get_shadow_region(struct guest_info * info, addr_t guest_addr);
+addr_t v3_get_shadow_addr(struct v3_shadow_region * reg, addr_t guest_addr);
+
+
+
+
+
+void v3_print_mem_map(struct guest_info * info);
 
 
 
-struct vmm_mem_hook * get_mem_hook(struct guest_info * info, addr_t guest_addr);
 
-int hook_guest_mem(struct guest_info * info, addr_t guest_addr_start, addr_t guest_addr_end,
-                  int (*read)(addr_t guest_addr, void * dst, uint_t length, void * priv_data),
-                  int (*write)(addr_t guest_addr, void * src, uint_t length, void * priv_data),
-                  void * priv_data);
-int unhook_guest_mem(struct guest_info * info, addr_t guest_addr);
 
+const uchar_t * v3_shdw_region_type_to_str(v3_shdw_region_type_t type);
 
 
 
 int handle_special_page_fault(struct guest_info * info, addr_t fault_addr, addr_t gp_addr, pf_error_t access_info);
 
+int v3_handle_mem_wr_hook(struct guest_info * info, addr_t guest_va, addr_t guest_pa, 
+                         struct v3_shadow_region * reg, pf_error_t access_info);
+int v3_handle_mem_full_hook(struct guest_info * info, addr_t guest_va, addr_t guest_pa, 
+                           struct v3_shadow_region * reg, pf_error_t access_info);
 
-#endif // ! __V3VEE__
+#endif /* ! __V3VEE__ */
 
 
 #endif