]> www.infradead.org Git - users/jedix/linux-maple.git/commit
hyperv: Add new Hyper-V headers in include/hyperv
authorNuno Das Neves <nunodasneves@linux.microsoft.com>
Mon, 25 Nov 2024 23:24:42 +0000 (15:24 -0800)
committerWei Liu <wei.liu@kernel.org>
Fri, 10 Jan 2025 00:54:20 +0000 (00:54 +0000)
commite68bda71a2384e4463c96bac958912b4c5e58502
tree9db375f727beb3f83867b41dd55c13df73b69d91
parenta3e72548282405056e9f8f8e9f5daba132c38bc4
hyperv: Add new Hyper-V headers in include/hyperv

These headers contain definitions for regular Hyper-V guests (as in
hyperv-tlfs.h), as well as interfaces for more privileged guests like
the root partition (aka Dom0).

These files are derived from headers exported from Hyper-V, rather than
being derived from the TLFS document. (Although, to preserve
compatibility with existing Linux code, some definitions are copied
directly from hyperv-tlfs.h too).

The new files follow a naming convention according to their original
use:
- hdk "host development kit"
- gdk "guest development kit"
With postfix "_mini" implying userspace-only headers, and "_ext" for
extended hypercalls.

The use of multiple files and their original names is primarily to
keep the provenance of exactly where they came from in Hyper-V
code, which is helpful for manual maintenance and extension
of these definitions. Microsoft maintainers importing new definitions
should take care to put them in the right file. However, Linux kernel
code that uses any of the definitions need not be aware of the multiple
files or assign any meaning to the new names. Linux kernel code should
always just include hvhdk.h

Note the new headers contain both arm64 and x86_64 definitions. Some are
guarded by #ifdefs, and some are instead prefixed with the architecture,
e.g. hv_x64_*. These conventions are kept from Hyper-V code as another
tactic to simplify the process of importing and maintaining the
definitions, rather than splitting them up into their own files in
arch/x86/ and arch/arm64/.

These headers are a step toward importing headers directly from Hyper-V
in the future, similar to Xen public files in include/xen/interface/.

Signed-off-by: Nuno Das Neves <nunodasneves@linux.microsoft.com>
Reviewed-by: Easwar Hariharan <eahariha@linux.microsoft.com>
Reviewed-by: Michael Kelley <mhklinux@outlook.com>
Signed-off-by: Roman Kisel <romank@linux.microsoft.com>
Link: https://lore.kernel.org/r/1732577084-2122-4-git-send-email-nunodasneves@linux.microsoft.com
Link: https://lore.kernel.org/r/20250108222138.1623703-2-romank@linux.microsoft.com
Signed-off-by: Wei Liu <wei.liu@kernel.org>
MAINTAINERS
include/hyperv/hvgdk.h [new file with mode: 0644]
include/hyperv/hvgdk_ext.h [new file with mode: 0644]
include/hyperv/hvgdk_mini.h [new file with mode: 0644]
include/hyperv/hvhdk.h [new file with mode: 0644]
include/hyperv/hvhdk_mini.h [new file with mode: 0644]