Skip to content

RFC Microsoft Hypervisor root partition ioctl interface

Nuno Das Neves linux-hyperv lkml virtualization 1 version In review

Get series with b4
b4 am 1605918637-12192-1-git-send-email-nunodasneves@linux.microsoft.com

Versions newest first

  1. v1 RFC Latest18 patches 34 repliesIn review

Patches in v1 No applies recorded yet

#Subject and filesSizeRepliesApplied
1/18x86/hyperv: convert hyperv statuses to linux error codesarch/x86/hyperv/hv_proc.c arch/x86/include/asm/mshyperv.h include/asm-generic/hyperv-tlfs.h+50 -132 replies
2/18asm-generic/hyperv: convert hyperv statuses to stringsarch/x86/hyperv/hv_init.c arch/x86/hyperv/hv_proc.c include/asm-generic/hyperv-tlfs.h+44 -280 replies
3/18virt/mshv: minimal mshv module (/dev/mshv/)arch/x86/Kconfig arch/x86/hyperv/Kconfig arch/x86/hyperv/Makefile +1 more+98 -00 replies
4/18virt/mshv: request version ioctlDocumentation/userspace-api/ioctl/ioctl-number.rst Documentation/virt/mshv/api.rst include/linux/mshv.h +2 more+143 -010 replies
5/18virt/mshv: create partition ioctlDocumentation/virt/mshv/api.rst arch/x86/include/asm/hyperv-tlfs.h arch/x86/include/uapi/asm/hyperv-tlfs.h +5 more+338 -162 replies
6/18virt/mshv: create, initialize, finalize, delete partition hypercallsinclude/asm-generic/hyperv-tlfs.h include/uapi/asm-generic/hyperv-tlfs.h include/uapi/linux/mshv.h +1 more+220 -33 replies
7/18virt/mshv: withdraw memory hypercallinclude/asm-generic/hyperv-tlfs.h virt/mshv/mshv_main.c+63 -12 replies
8/18virt/mshv: map and unmap guest memoryDocumentation/virt/mshv/api.rst include/asm-generic/hyperv-tlfs.h include/linux/mshv.h +3 more+388 -23 replies
9/18virt/mshv: create vcpu ioctlDocumentation/virt/mshv/api.rst include/linux/mshv.h include/uapi/linux/mshv.h +1 more+144 -10 replies
10/18virt/mshv: get and set vcpu registers ioctlsDocumentation/virt/mshv/api.rst arch/x86/include/uapi/asm/hyperv-tlfs.h include/asm-generic/hyperv-tlfs.h +3 more+903 -452 replies
11/18virt/mshv: set up synic pages for intercept messagesarch/x86/include/asm/hyperv-tlfs.h arch/x86/include/uapi/asm/hyperv-tlfs.h include/asm-generic/hyperv-tlfs.h +3 more+404 -773 replies
12/18virt/mshv: run vp ioctl and isrDocumentation/virt/mshv/api.rst arch/x86/kernel/cpu/mshyperv.c include/asm-generic/mshyperv.h +3 more+310 -11 reply
13/18virt/mshv: install intercept ioctlDocumentation/virt/mshv/api.rst arch/x86/include/uapi/asm/hyperv-tlfs.h include/asm-generic/hyperv-tlfs.h +2 more+115 -10 replies
14/18virt/mshv: assert interrupt ioctlDocumentation/virt/mshv/api.rst arch/x86/include/asm/hyperv-tlfs.h arch/x86/include/uapi/asm/hyperv-tlfs.h +3 more+87 -140 replies
15/18virt/mshv: get and set vp state ioctlsDocumentation/virt/mshv/api.rst arch/x86/include/uapi/asm/hyperv-tlfs.h include/asm-generic/hyperv-tlfs.h +3 more+411 -02 replies
16/18virt/mshv: mmap vp register pageDocumentation/virt/mshv/api.rst arch/x86/include/uapi/asm/hyperv-tlfs.h include/asm-generic/hyperv-tlfs.h +4 more+195 -02 replies
17/18virt/mshv: get and set partition property ioctlsDocumentation/virt/mshv/api.rst include/asm-generic/hyperv-tlfs.h include/uapi/asm-generic/hyperv-tlfs.h +2 more+169 -00 replies
18/18virt/mshv: Add enlightenment bits to create partition ioctlDocumentation/virt/mshv/api.rst arch/x86/include/uapi/asm/hyperv-tlfs.h include/uapi/asm-generic/hyperv-tlfs.h +2 more+167 -200 replies

Reviews trailers per patch

No Reviewed-by, Acked-by or Tested-by trailers for v1 yet.

Read the v1 thread

Cover letter [RFC PATCH 00/18] Microsoft Hypervisor root partition ioctl interface

This patch series provides a userspace interface for creating and running guest virtual machines while running on the Microsoft Hypervisor [0].

Since managing guest machines can only be done when Linux is the root partition, this series depends on the RFC already posted by Wei Liu:
https://lore.kernel.org/linux-hyperv/[email protected]/T/#t

The first two patches provide some helpers for converting hypervisor status codes to linux error codes, and easily printing hypervisor status codes to dmesg for debugging.

Hyper-V related headers asm-generic/hyperv-tlfs.h and x86/asm/hyperv-tlfs.h are split into uapi and non-uapi. The uapi versions contain structures used in both the ioctl interface and the kernel.

The mshv API is introduced in virt/mshv/mshv_main.c. As each interface is introduced, documentation is added in Documentation/virt/mshv/api.rst. The API is file-desciptor based, like KVM. The entry point is /dev/mshv.

/dev/mshv ioctls:
MSHV_REQUEST_VERSION
MSHV_CREATE_PARTITION

Partition (vm) ioctls:
MSHV_MAP_GUEST_MEMORY, MSHV_UNMAP_GUEST_MEMORY MSHV_INSTALL_INTERCEPT
MSHV_ASSERT_INTERRUPT MSHV_GET_PARTITION_PROPERTY, MSHV_SET_PARTITION_PROPERTY MSHV_CREATE_VP

Vp (vcpu) ioctls:
MSHV_GET_VP_REGISTERS, MSHV_SET_VP_REGISTERS
MSHV_RUN_VP
MSHV_GET_VP_STATE, MSHV_SET_VP_STATE
mmap() (register page)

[0] Hyper-V is more well-known, but it really refers to the whole stack including the hypervisor and other components that run in Windows kernel and userspace.

Nuno Das Neves (18):
x86/hyperv: convert hyperv statuses to linux error codes asm-generic/hyperv: convert hyperv statuses to strings virt/mshv: minimal mshv module (/dev/mshv/)
virt/mshv: request version ioctl
virt/mshv: create partition ioctl
virt/mshv: create, initialize, finalize, delete partition hypercalls virt/mshv: withdraw memory hypercall
virt/mshv: map and unmap guest memory
virt/mshv: create vcpu ioctl
virt/mshv: get and set vcpu registers ioctls
virt/mshv: set up synic pages for intercept messages virt/mshv: run vp ioctl and isr
virt/mshv: install intercept ioctl
virt/mshv: assert interrupt ioctl
virt/mshv: get and set vp state ioctls
virt/mshv: mmap vp register page
virt/mshv: get and set partition property ioctls virt/mshv: Add enlightenment bits to create partition ioctl

 .../userspace-api/ioctl/ioctl-number.rst      |    2 +
 Documentation/virt/mshv/api.rst               |  173 ++
 arch/x86/Kconfig                              |    2 +
 arch/x86/hyperv/Kconfig                       |   22 +
 arch/x86/hyperv/Makefile                      |    4 +
 arch/x86/hyperv/hv_init.c                     |    2 +-
 arch/x86/hyperv/hv_proc.c                     |   40 +-
 arch/x86/include/asm/hyperv-tlfs.h            |   44 +-
 arch/x86/include/asm/mshyperv.h               |    1 +
 arch/x86/include/uapi/asm/hyperv-tlfs.h       | 1312 +++++++++++
 arch/x86/kernel/cpu/mshyperv.c                |   16 +
 include/asm-generic/hyperv-tlfs.h             |  324 ++-
 include/asm-generic/mshyperv.h                |    3 +
 include/linux/mshv.h                          |   61 +
 include/uapi/asm-generic/hyperv-tlfs.h        |  160 ++
 include/uapi/linux/mshv.h                     |  109 +
 virt/mshv/mshv_main.c                         | 2054 +++++++++++++++++
 17 files changed, 4178 insertions(+), 151 deletions(-)
 create mode 100644 Documentation/virt/mshv/api.rst
 create mode 100644 arch/x86/hyperv/Kconfig
 create mode 100644 arch/x86/include/uapi/asm/hyperv-tlfs.h
 create mode 100644 include/linux/mshv.h
 create mode 100644 include/uapi/asm-generic/hyperv-tlfs.h
 create mode 100644 include/uapi/linux/mshv.h
 create mode 100644 virt/mshv/mshv_main.c
Signature · 1 line
2.25.1