summaryrefslogtreecommitdiff
path: root/README
blob: 479696f317853d0ca7936815511e9b51eba0c01a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
 _                     
| | ____   ___ __ ___  
| |/ /\ \ / / '_ ` _ \ 
|   <  \ V /| | | | | |
|_|\_\  \_/ |_| |_| |_|


BUILDING

Building the kvm driver is pretty easy and compared to building O/N it will
finish in a snap.

Preparation:

Edit the Makefile and appropriately set the path for the KERNEL_SOURCE directory
that points to the root of a checked out and built illumos directory.  As we
have not had the chance to upstream a change to uts/intel/sys/tss.h ensure that
line 19 of the Makfile, which adds the -D_NEED_KVM_TSS option, is uncommented.

Verify that gcc is installed and the version you'd like to use is in your path.
Note that this has only been tested against the SFW version of gcc -- version
3.4.

Verify that you either have SUNWmake or GNU make installed.

Building and Development:

To build, simply use the default make target:

$ make

To check style, header files, and other various nits:

$ make check


INSTALLING

There are two mandatory artifacts to install and one optional component:

kvm		The driver
kvm.so		The mdb module
kvm.conf	The driver configuration file

On the target machine:
Place kvm in /kernel/drv/amd64
Place kvm.conf in /kernel/drv
add_drv kvm
ln -s /devices/pseudo/kvm@0:kvm /dev/kvm

That's all there is too it. Good luck, make sure you have a dump device, and
don't panic!