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.


Enhanced user-space memory interface, allowing dynamic kernel-allocations
[palacios.git] / linux_module / palacios.h
1 #ifndef _PALACIOS_H
2 #define _PALACIOS_H
3
4 #include <linux/cdev.h>
5 #include <linux/list.h>
6 #include <linux/sched.h>
7 #include <linux/slab.h>
8
9
10 /* Global Control IOCTLs */
11 #define V3_CREATE_GUEST 12
12 #define V3_FREE_GUEST 13
13
14 #define V3_ADD_MEMORY 50
15 #define V3_RESET_MEMORY 51
16
17 #define V3_ADD_PCI_HW_DEV 55
18 #define V3_ADD_PCI_USER_DEV 56
19
20 /* VM Specific IOCTLs */
21 #define V3_VM_CONSOLE_CONNECT 20
22 #define V3_VM_STREAM_CONNECT 21
23
24 #define V3_VM_PAUSE 23
25 #define V3_VM_CONTINUE 24
26
27 #define V3_VM_LAUNCH 25
28 #define V3_VM_STOP 26
29 #define V3_VM_LOAD 27
30 #define V3_VM_SAVE 28
31 #define V3_VM_SIMULATE 29
32
33 #define V3_VM_INSPECT 30
34 #define V3_VM_DEBUG 31
35
36 #define V3_VM_MOVE_CORE 33
37
38 #define V3_VM_SEND    34
39 #define V3_VM_RECEIVE 35
40
41 #define V3_VM_FB_INPUT 257
42 #define V3_VM_FB_QUERY 258
43
44 #define V3_VM_HOST_DEV_CONNECT 10245
45
46 #define V3_VM_KSTREAM_USER_CONNECT 11245
47
48
49 struct v3_guest_img {
50     unsigned long long size;
51     void * guest_data;
52     char name[128];
53 } __attribute__((packed));
54
55 typedef enum { PREALLOCATED=0,          // user space-allocated (e.g. hot remove)
56               REQUESTED,               // kernel will attempt allocation (anywhere)
57               REQUESTED32,             // kernel will attempt allocation (<4GB)
58
59 } v3_mem_region_type_t;
60
61 struct v3_mem_region {
62     v3_mem_region_type_t type;         // 
63     int                  node;         // numa node for REQUESTED (-1 = any)
64     unsigned long long   base_addr;    // region start (hpa) for PREALLOCATED
65     unsigned long long   num_pages;    // size for PREALLOCATED or request size for REQUESTED
66                                        // should be power of 2 and > V3_CONFIG_MEM_BLOCK
67 } __attribute__((packed));
68
69 struct v3_debug_cmd {
70     unsigned int core; 
71     unsigned int cmd;
72 } __attribute__((packed));
73
74 struct v3_core_move_cmd {
75     unsigned short vcore_id;
76     unsigned short pcore_id;
77 } __attribute__((packed));
78
79 struct v3_chkpt_info {
80     char store[128];
81     char url[256]; /* This might need to be bigger... */
82     unsigned long long opts;
83 #define V3_CHKPT_OPT_NONE         0
84 #define V3_CHKPT_OPT_SKIP_MEM     1  // don't write memory to store
85 #define V3_CHKPT_OPT_SKIP_DEVS    2  // don't write devices to store
86 #define V3_CHKPT_OPT_SKIP_CORES   4  // don't write core arch ind data to store
87 #define V3_CHKPT_OPT_SKIP_ARCHDEP 8  // don't write core arch dep data to store
88 } __attribute__((packed));
89
90
91 struct v3_hw_pci_dev {
92     char name[128];
93     unsigned int bus;
94     unsigned int dev;
95     unsigned int func;
96 } __attribute__((packed));
97
98 struct v3_user_pci_dev {
99     char name[128];
100     unsigned short vendor_id;
101     unsigned short dev_id;
102 } __attribute__((packed));
103
104
105
106 void * trace_malloc(size_t size, gfp_t flags);
107 void trace_free(const void * objp);
108
109
110 struct v3_guest {
111     void * v3_ctx;
112
113     void * img; 
114     u32 img_size;
115
116     char name[128];
117
118
119     struct rb_root vm_ctrls;
120     struct list_head exts;
121
122     dev_t vm_dev; 
123     struct cdev cdev;
124 };
125
126 // For now MAX_VMS must be a multiple of 8
127 // This is due to the minor number bitmap
128 #define MAX_VMS 32
129
130
131
132 int palacios_vmm_init( char *options );
133 int palacios_vmm_exit( void );
134
135
136 // This is how a component finds the proc dir we are using for global state
137 struct proc_dir_entry *palacios_get_procdir(void);
138
139 // Selected exported stubs, for use in other palacios components, like vnet
140 // The idea is that everything uses the same stubs
141 void  palacios_print_scoped(void *vm, int vcore, const char *fmt, ...);
142 #define palacios_print(...) palacios_print_scoped(0,-1, __VA_ARGS__)
143 void *palacios_allocate_pages(int num_pages, unsigned int alignment, int node_id);
144 void  palacios_free_pages(void *page_addr, int num_pages);
145 void *palacios_alloc(unsigned int size);
146 void *palacios_alloc_extended(unsigned int size, unsigned int flags);
147 // FIX
148 // NEED A palacios_alloc_node wrapper
149 //
150 #define palacios_alloc_node_extended(size, flags, node) kmalloc_node(size,flags,node)
151 void  palacios_free(void *);
152 void *palacios_valloc(unsigned int size); // use instead of vmalloc
153 void  palacios_vfree(void *);             // use instead of vfree
154 void *palacios_vaddr_to_paddr(void *vaddr);
155 void *palacios_paddr_to_vaddr(void *paddr);
156 void *palacios_start_kernel_thread(int (*fn)(void * arg), void *arg, char *thread_name);
157 void *palacios_start_thread_on_cpu(int cpu_id, int (*fn)(void * arg), void *arg, char *thread_name);
158 int   palacios_move_thread_to_cpu(int new_cpu_id, void *thread_ptr);
159 void  palacios_yield_cpu(void);
160 void  palacios_yield_cpu_timed(unsigned int us);
161 unsigned int palacios_get_cpu(void);
162 unsigned int palacios_get_cpu_khz(void);
163 void *palacios_mutex_alloc(void);         // allocates and inits a lock
164 void  palacios_mutex_init(void *mutex);   // only inits a lock
165 void  palacios_mutex_deinit(void *mutex); // only deinits a lock
166 void  palacios_mutex_free(void *mutex);   // deinits and frees a lock
167 void  palacios_mutex_lock(void *mutex, int must_spin);
168 void  palacios_mutex_unlock(void *mutex);
169 void *palacios_mutex_lock_irqsave(void *mutex, int must_spin);
170 void  palacios_mutex_unlock_irqrestore(void *mutex, void *flags);
171 // Macros for spin-locks in the module code
172 // By using these macros, the lock checker will be able
173 // to see the module code as well as the core VMM
174 #define palacios_spinlock_init(l) palacios_mutex_init(l)
175 #define palacios_spinlock_deinit(l) palacios_mutex_deinit(l)
176 #define palacios_spinlock_lock(l) palacios_mutex_lock(l,0)
177 #define palacios_spinlock_unlock(l) palacios_mutex_unlock(l)
178 #define palacios_spinlock_lock_irqsave(l,f) do { f=(unsigned long)palacios_mutex_lock_irqsave(l,0); } while (0)
179 #define palacios_spinlock_unlock_irqrestore(l,f) palacios_mutex_unlock_irqrestore(l,(void*)f)
180
181
182 // Palacios Printing Support
183
184 // These macros affect how palacios_print will generate output
185 // Turn this on for unprefaced output from palacios_print
186 #define V3_PRINTK_OLD_STYLE_OUTPUT 0
187 // Maximum length output from palacios_print
188 #define V3_PRINTK_BUF_SIZE 1024
189 // Turn this on to check if new-style output for palacios_print  contains only 7-bit chars
190 #define V3_PRINTK_CHECK_7BIT 1
191
192 //
193 // The following macros are for printing in the linux module itself, even before
194 // Palacios is initialized and after it it deinitialized
195 // All printk's in linux_module use these macros, for easier control
196 #define ERROR(fmt, args...) printk((KERN_ERR "palacios (pcore %u) %s(%d): " fmt), palacios_get_cpu(), __FILE__, __LINE__, ##args)
197 #define WARNING(fmt, args...) printk((KERN_WARNING "palacios (pcore %u): " fmt), palacios_get_cpu(), ##args)
198 #define NOTICE(fmt, args...) printk((KERN_NOTICE "palacios (pcore %u): " fmt), palacios_get_cpu(), ##args)
199 #define INFO(fmt, args...) printk((KERN_INFO "palacios (pcore %u): " fmt), palacios_get_cpu(), ##args)
200 #define DEBUG(fmt, args...) printk((KERN_DEBUG "palacios (pcore %u): " fmt), palacios_get_cpu(), ##args)
201
202
203 #endif