Commit c32a4272 authored by Tiejun Chen's avatar Tiejun Chen Committed by Paolo Bonzini

kvm: Documentation: remove ia64

kvm/ia64 is gone, clean up Documentation too.
Signed-off-by: default avatarPaolo Bonzini <pbonzini@redhat.com>
parent 003f7de6
Currently, kvm module is in EXPERIMENTAL stage on IA64. This means that
interfaces are not stable enough to use. So, please don't run critical
applications in virtual machine.
We will try our best to improve it in future versions!
Guide: How to boot up guests on kvm/ia64
This guide is to describe how to enable kvm support for IA-64 systems.
1. Get the kvm source from git.kernel.org.
Userspace source:
git clone git://git.kernel.org/pub/scm/virt/kvm/kvm-userspace.git
Kernel Source:
git clone git://git.kernel.org/pub/scm/linux/kernel/git/xiantao/kvm-ia64.git
2. Compile the source code.
2.1 Compile userspace code:
(1)cd ./kvm-userspace
(2)./configure
(3)cd kernel
(4)make sync LINUX= $kernel_dir (kernel_dir is the directory of kernel source.)
(5)cd ..
(6)make qemu
(7)cd qemu; make install
2.2 Compile kernel source code:
(1) cd ./$kernel_dir
(2) Make menuconfig
(3) Enter into virtualization option, and choose kvm.
(4) make
(5) Once (4) done, make modules_install
(6) Make initrd, and use new kernel to reboot up host machine.
(7) Once (6) done, cd $kernel_dir/arch/ia64/kvm
(8) insmod kvm.ko; insmod kvm-intel.ko
Note: For step 2, please make sure that host page size == TARGET_PAGE_SIZE of qemu, otherwise, may fail.
3. Get Guest Firmware named as Flash.fd, and put it under right place:
(1) If you have the guest firmware (binary) released by Intel Corp for Xen, use it directly.
(2) If you have no firmware at hand, Please download its source from
hg clone http://xenbits.xensource.com/ext/efi-vfirmware.hg
you can get the firmware's binary in the directory of efi-vfirmware.hg/binaries.
(3) Rename the firmware you owned to Flash.fd, and copy it to /usr/local/share/qemu
4. Boot up Linux or Windows guests:
4.1 Create or install a image for guest boot. If you have xen experience, it should be easy.
4.2 Boot up guests use the following command.
/usr/local/bin/qemu-system-ia64 -smp xx -m 512 -hda $your_image
(xx is the number of virtual processors for the guest, now the maximum value is 4)
5. Known possible issue on some platforms with old Firmware.
In the event of strange host crash issues, try to solve it through either of the following ways:
(1): Upgrade your Firmware to the latest one.
(2): Applying the below patch to kernel source.
diff --git a/arch/ia64/kernel/pal.S b/arch/ia64/kernel/pal.S
index 0b53344..f02b0f7 100644
--- a/arch/ia64/kernel/pal.S
+++ b/arch/ia64/kernel/pal.S
@@ -84,7 +84,8 @@ GLOBAL_ENTRY(ia64_pal_call_static)
mov ar.pfs = loc1
mov rp = loc0
;;
- srlz.d // serialize restoration of psr.l
+ srlz.i // serialize restoration of psr.l
+ ;;
br.ret.sptk.many b0
END(ia64_pal_call_static)
6. Bug report:
If you found any issues when use kvm/ia64, Please post the bug info to kvm-ia64-devel mailing list.
https://lists.sourceforge.net/lists/listinfo/kvm-ia64-devel/
Thanks for your interest! Let's work together, and make kvm/ia64 stronger and stronger!
Xiantao Zhang <xiantao.zhang@intel.com>
2008.3.10
...@@ -607,7 +607,7 @@ struct kvm_fpu { ...@@ -607,7 +607,7 @@ struct kvm_fpu {
4.24 KVM_CREATE_IRQCHIP 4.24 KVM_CREATE_IRQCHIP
Capability: KVM_CAP_IRQCHIP, KVM_CAP_S390_IRQCHIP (s390) Capability: KVM_CAP_IRQCHIP, KVM_CAP_S390_IRQCHIP (s390)
Architectures: x86, ia64, ARM, arm64, s390 Architectures: x86, ARM, arm64, s390
Type: vm ioctl Type: vm ioctl
Parameters: none Parameters: none
Returns: 0 on success, -1 on error Returns: 0 on success, -1 on error
...@@ -615,7 +615,7 @@ Returns: 0 on success, -1 on error ...@@ -615,7 +615,7 @@ Returns: 0 on success, -1 on error
Creates an interrupt controller model in the kernel. On x86, creates a virtual Creates an interrupt controller model in the kernel. On x86, creates a virtual
ioapic, a virtual PIC (two PICs, nested), and sets up future vcpus to have a ioapic, a virtual PIC (two PICs, nested), and sets up future vcpus to have a
local APIC. IRQ routing for GSIs 0-15 is set to both PIC and IOAPIC; GSI 16-23 local APIC. IRQ routing for GSIs 0-15 is set to both PIC and IOAPIC; GSI 16-23
only go to the IOAPIC. On ia64, a IOSAPIC is created. On ARM/arm64, a GIC is only go to the IOAPIC. On ARM/arm64, a GIC is
created. On s390, a dummy irq routing table is created. created. On s390, a dummy irq routing table is created.
Note that on s390 the KVM_CAP_S390_IRQCHIP vm capability needs to be enabled Note that on s390 the KVM_CAP_S390_IRQCHIP vm capability needs to be enabled
...@@ -625,7 +625,7 @@ before KVM_CREATE_IRQCHIP can be used. ...@@ -625,7 +625,7 @@ before KVM_CREATE_IRQCHIP can be used.
4.25 KVM_IRQ_LINE 4.25 KVM_IRQ_LINE
Capability: KVM_CAP_IRQCHIP Capability: KVM_CAP_IRQCHIP
Architectures: x86, ia64, arm, arm64 Architectures: x86, arm, arm64
Type: vm ioctl Type: vm ioctl
Parameters: struct kvm_irq_level Parameters: struct kvm_irq_level
Returns: 0 on success, -1 on error Returns: 0 on success, -1 on error
...@@ -679,7 +679,7 @@ struct kvm_irq_level { ...@@ -679,7 +679,7 @@ struct kvm_irq_level {
4.26 KVM_GET_IRQCHIP 4.26 KVM_GET_IRQCHIP
Capability: KVM_CAP_IRQCHIP Capability: KVM_CAP_IRQCHIP
Architectures: x86, ia64 Architectures: x86
Type: vm ioctl Type: vm ioctl
Parameters: struct kvm_irqchip (in/out) Parameters: struct kvm_irqchip (in/out)
Returns: 0 on success, -1 on error Returns: 0 on success, -1 on error
...@@ -701,7 +701,7 @@ struct kvm_irqchip { ...@@ -701,7 +701,7 @@ struct kvm_irqchip {
4.27 KVM_SET_IRQCHIP 4.27 KVM_SET_IRQCHIP
Capability: KVM_CAP_IRQCHIP Capability: KVM_CAP_IRQCHIP
Architectures: x86, ia64 Architectures: x86
Type: vm ioctl Type: vm ioctl
Parameters: struct kvm_irqchip (in) Parameters: struct kvm_irqchip (in)
Returns: 0 on success, -1 on error Returns: 0 on success, -1 on error
...@@ -994,7 +994,7 @@ for vm-wide capabilities. ...@@ -994,7 +994,7 @@ for vm-wide capabilities.
4.38 KVM_GET_MP_STATE 4.38 KVM_GET_MP_STATE
Capability: KVM_CAP_MP_STATE Capability: KVM_CAP_MP_STATE
Architectures: x86, ia64, s390 Architectures: x86, s390
Type: vcpu ioctl Type: vcpu ioctl
Parameters: struct kvm_mp_state (out) Parameters: struct kvm_mp_state (out)
Returns: 0 on success; -1 on error Returns: 0 on success; -1 on error
...@@ -1008,16 +1008,15 @@ uniprocessor guests). ...@@ -1008,16 +1008,15 @@ uniprocessor guests).
Possible values are: Possible values are:
- KVM_MP_STATE_RUNNABLE: the vcpu is currently running [x86, ia64] - KVM_MP_STATE_RUNNABLE: the vcpu is currently running [x86]
- KVM_MP_STATE_UNINITIALIZED: the vcpu is an application processor (AP) - KVM_MP_STATE_UNINITIALIZED: the vcpu is an application processor (AP)
which has not yet received an INIT signal [x86, which has not yet received an INIT signal [x86]
ia64]
- KVM_MP_STATE_INIT_RECEIVED: the vcpu has received an INIT signal, and is - KVM_MP_STATE_INIT_RECEIVED: the vcpu has received an INIT signal, and is
now ready for a SIPI [x86, ia64] now ready for a SIPI [x86]
- KVM_MP_STATE_HALTED: the vcpu has executed a HLT instruction and - KVM_MP_STATE_HALTED: the vcpu has executed a HLT instruction and
is waiting for an interrupt [x86, ia64] is waiting for an interrupt [x86]
- KVM_MP_STATE_SIPI_RECEIVED: the vcpu has just received a SIPI (vector - KVM_MP_STATE_SIPI_RECEIVED: the vcpu has just received a SIPI (vector
accessible via KVM_GET_VCPU_EVENTS) [x86, ia64] accessible via KVM_GET_VCPU_EVENTS) [x86]
- KVM_MP_STATE_STOPPED: the vcpu is stopped [s390] - KVM_MP_STATE_STOPPED: the vcpu is stopped [s390]
- KVM_MP_STATE_CHECK_STOP: the vcpu is in a special error state [s390] - KVM_MP_STATE_CHECK_STOP: the vcpu is in a special error state [s390]
- KVM_MP_STATE_OPERATING: the vcpu is operating (running or halted) - KVM_MP_STATE_OPERATING: the vcpu is operating (running or halted)
...@@ -1025,7 +1024,7 @@ Possible values are: ...@@ -1025,7 +1024,7 @@ Possible values are:
- KVM_MP_STATE_LOAD: the vcpu is in a special load/startup state - KVM_MP_STATE_LOAD: the vcpu is in a special load/startup state
[s390] [s390]
On x86 and ia64, this ioctl is only useful after KVM_CREATE_IRQCHIP. Without an On x86, this ioctl is only useful after KVM_CREATE_IRQCHIP. Without an
in-kernel irqchip, the multiprocessing state must be maintained by userspace on in-kernel irqchip, the multiprocessing state must be maintained by userspace on
these architectures. these architectures.
...@@ -1033,7 +1032,7 @@ these architectures. ...@@ -1033,7 +1032,7 @@ these architectures.
4.39 KVM_SET_MP_STATE 4.39 KVM_SET_MP_STATE
Capability: KVM_CAP_MP_STATE Capability: KVM_CAP_MP_STATE
Architectures: x86, ia64, s390 Architectures: x86, s390
Type: vcpu ioctl Type: vcpu ioctl
Parameters: struct kvm_mp_state (in) Parameters: struct kvm_mp_state (in)
Returns: 0 on success; -1 on error Returns: 0 on success; -1 on error
...@@ -1041,7 +1040,7 @@ Returns: 0 on success; -1 on error ...@@ -1041,7 +1040,7 @@ Returns: 0 on success; -1 on error
Sets the vcpu's current "multiprocessing state"; see KVM_GET_MP_STATE for Sets the vcpu's current "multiprocessing state"; see KVM_GET_MP_STATE for
arguments. arguments.
On x86 and ia64, this ioctl is only useful after KVM_CREATE_IRQCHIP. Without an On x86, this ioctl is only useful after KVM_CREATE_IRQCHIP. Without an
in-kernel irqchip, the multiprocessing state must be maintained by userspace on in-kernel irqchip, the multiprocessing state must be maintained by userspace on
these architectures. these architectures.
...@@ -1068,7 +1067,7 @@ documentation when it pops into existence). ...@@ -1068,7 +1067,7 @@ documentation when it pops into existence).
4.41 KVM_SET_BOOT_CPU_ID 4.41 KVM_SET_BOOT_CPU_ID
Capability: KVM_CAP_SET_BOOT_CPU_ID Capability: KVM_CAP_SET_BOOT_CPU_ID
Architectures: x86, ia64 Architectures: x86
Type: vm ioctl Type: vm ioctl
Parameters: unsigned long vcpu_id Parameters: unsigned long vcpu_id
Returns: 0 on success, -1 on error Returns: 0 on success, -1 on error
...@@ -1261,7 +1260,7 @@ The flags bitmap is defined as: ...@@ -1261,7 +1260,7 @@ The flags bitmap is defined as:
4.48 KVM_ASSIGN_PCI_DEVICE 4.48 KVM_ASSIGN_PCI_DEVICE
Capability: none Capability: none
Architectures: x86 ia64 Architectures: x86
Type: vm ioctl Type: vm ioctl
Parameters: struct kvm_assigned_pci_dev (in) Parameters: struct kvm_assigned_pci_dev (in)
Returns: 0 on success, -1 on error Returns: 0 on success, -1 on error
...@@ -1311,7 +1310,7 @@ Errors: ...@@ -1311,7 +1310,7 @@ Errors:
4.49 KVM_DEASSIGN_PCI_DEVICE 4.49 KVM_DEASSIGN_PCI_DEVICE
Capability: none Capability: none
Architectures: x86 ia64 Architectures: x86
Type: vm ioctl Type: vm ioctl
Parameters: struct kvm_assigned_pci_dev (in) Parameters: struct kvm_assigned_pci_dev (in)
Returns: 0 on success, -1 on error Returns: 0 on success, -1 on error
...@@ -1330,7 +1329,7 @@ Errors: ...@@ -1330,7 +1329,7 @@ Errors:
4.50 KVM_ASSIGN_DEV_IRQ 4.50 KVM_ASSIGN_DEV_IRQ
Capability: KVM_CAP_ASSIGN_DEV_IRQ Capability: KVM_CAP_ASSIGN_DEV_IRQ
Architectures: x86 ia64 Architectures: x86
Type: vm ioctl Type: vm ioctl
Parameters: struct kvm_assigned_irq (in) Parameters: struct kvm_assigned_irq (in)
Returns: 0 on success, -1 on error Returns: 0 on success, -1 on error
...@@ -1370,7 +1369,7 @@ Errors: ...@@ -1370,7 +1369,7 @@ Errors:
4.51 KVM_DEASSIGN_DEV_IRQ 4.51 KVM_DEASSIGN_DEV_IRQ
Capability: KVM_CAP_ASSIGN_DEV_IRQ Capability: KVM_CAP_ASSIGN_DEV_IRQ
Architectures: x86 ia64 Architectures: x86
Type: vm ioctl Type: vm ioctl
Parameters: struct kvm_assigned_irq (in) Parameters: struct kvm_assigned_irq (in)
Returns: 0 on success, -1 on error Returns: 0 on success, -1 on error
...@@ -1385,7 +1384,7 @@ KVM_ASSIGN_DEV_IRQ. Partial deassignment of host or guest IRQ is allowed. ...@@ -1385,7 +1384,7 @@ KVM_ASSIGN_DEV_IRQ. Partial deassignment of host or guest IRQ is allowed.
4.52 KVM_SET_GSI_ROUTING 4.52 KVM_SET_GSI_ROUTING
Capability: KVM_CAP_IRQ_ROUTING Capability: KVM_CAP_IRQ_ROUTING
Architectures: x86 ia64 s390 Architectures: x86 s390
Type: vm ioctl Type: vm ioctl
Parameters: struct kvm_irq_routing (in) Parameters: struct kvm_irq_routing (in)
Returns: 0 on success, -1 on error Returns: 0 on success, -1 on error
...@@ -1444,7 +1443,7 @@ struct kvm_irq_routing_s390_adapter { ...@@ -1444,7 +1443,7 @@ struct kvm_irq_routing_s390_adapter {
4.53 KVM_ASSIGN_SET_MSIX_NR 4.53 KVM_ASSIGN_SET_MSIX_NR
Capability: none Capability: none
Architectures: x86 ia64 Architectures: x86
Type: vm ioctl Type: vm ioctl
Parameters: struct kvm_assigned_msix_nr (in) Parameters: struct kvm_assigned_msix_nr (in)
Returns: 0 on success, -1 on error Returns: 0 on success, -1 on error
...@@ -1466,7 +1465,7 @@ struct kvm_assigned_msix_nr { ...@@ -1466,7 +1465,7 @@ struct kvm_assigned_msix_nr {
4.54 KVM_ASSIGN_SET_MSIX_ENTRY 4.54 KVM_ASSIGN_SET_MSIX_ENTRY
Capability: none Capability: none
Architectures: x86 ia64 Architectures: x86
Type: vm ioctl Type: vm ioctl
Parameters: struct kvm_assigned_msix_entry (in) Parameters: struct kvm_assigned_msix_entry (in)
Returns: 0 on success, -1 on error Returns: 0 on success, -1 on error
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment