posts - 1,  comments - 20,  trackbacks - 0

What is a Hypercall?

Hypercall is an explicit call from Virtual Machine (VM) into the underlying VM Moniter (VMM). That is, a hypercall issued from the guest will cause a VM exit from the guest into the VMM. In this sense, it is kinda like syscall, which will result in a trap from userspace into  kernel space.  Thus, hypercall can serve as a communication approach between the guest and the underlying VMM. The guest can issue hypercalls via VMMCALL instruction on AMD SVM machine or VMCALL on Intel VMX machine.


Adding a Hypercall in Palacios

Palacios maintains a global hypercall map, which maintains the mapping between the unique hypercall number and the hypercall handler. (Each hypercall is associated with a unique hypercall number.). Therefore, to add a hypercal in Palacios, you need to:

  • Implement a handler for the hypercall.
  • Assign a unique hypercall number for the hypercall.
  • Register the hypercall handler and the hypercall number with Palacios.

Sample Example:

static int handle_hcall(struct guest_info * info, uint_t hcall_id, void * priv_data){
    unsigned 
long param1 = *(unsigned long *&info->vm_regs.rbx;
    unsigned 
long param2 = *(unsigned long *&info->vm_regs.rcx;
    unsigned 
long param3 = *(unsigned long *&info->vm_regs.rdx;
    V3_Print(
"param1=%lu param2=%lu param3=%lu\n", param1, parma2, param3);
    info
->vm_regs.rax = 0//return value of the hypercall
}

v3_register_hypercall(vm, HCALL_EXAMPLE_ID, handle_hcall, NULL);

Note: The hypercall management APIs in Palacios are contained in palacios/include/palacios/vmm_hypercall.h and palacios/src/palacios/vmm_hypercall.c.


Issuing Hypercalls from Palacios Guest

“Up to four arguments may be passed in rbx, rcx, rdx, and rsi respectively. The hypercall number should be placed in rax and the return value will be placed in rax.  No other registers will be clobbered unless explicitly stated by the particular hypercall.” (quoted from [1])

For exmaple, on a AMD SVM machine, a hypercall with 3 parameters can be issued via the following code:

#define VMMCALL ".byte 0x0F,0x01,0xD9\r\n" //VMMCALL instruction binary code

int hcall3(unsigned long hcall_id, unsigned long param1, unsigned long param2, unsigned long param3){
     
int ret;
     __asm__ 
volatile(
         VMMCALL
             : “
=a”(ret)
             : “a”(hcall_id), “b”(param1), “c”(param2), “d”(param3)
    );
    
return ret;
}


References:

[1] Linux KVM Hypercall

posted on 2014-11-04 07:59 csgeek? 阅读(717) 评论(0)  编辑  收藏

只有注册用户登录后才能发表评论。


网站导航:
 

<2024年12月>
24252627282930
1234567
891011121314
15161718192021
22232425262728
2930311234

留言簿(1)

文章档案(5)

Personal Website

搜索

  •  

最新评论