0 "lm_J*j"T-)F hauto *l=J!e8Ep Tţ x"_I|+/* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */ /* * Userspace interfaces for /dev/mshv* devices and derived fds * * This file is divided into sections containing data structures and IOCTLs for * a particular set of related devices or derived file descriptors. * * The IOCTL definitions are at the end of each section. They are grouped by * device/fd, so that new IOCTLs can easily be added with a monotonically * increasing number. */ #ifndef _LINUX_MSHV_H #define _LINUX_MSHV_H #include #define MSHV_IOCTL 0xB8 /* ******************************************* * Entry point to main VMM APIs: /dev/mshv * ******************************************* */ enum { MSHV_PT_BIT_LAPIC, MSHV_PT_BIT_X2APIC, MSHV_PT_BIT_GPA_SUPER_PAGES, MSHV_PT_BIT_COUNT, }; #define MSHV_PT_FLAGS_MASK ((1 << MSHV_PT_BIT_COUNT) - 1) enum { MSHV_PT_ISOLATION_NONE, MSHV_PT_ISOLATION_COUNT, }; /** * struct mshv_create_partition - arguments for MSHV_CREATE_PARTITION * @pt_flags: Bitmask of 1 << MSHV_PT_BIT_* * @pt_isolation: MSHV_PT_ISOLATION_* * * Returns a file descriptor to act as a handle to a guest partition. * At this point the partition is not yet initialized in the hypervisor. * Some operations must be done with the partition in this state, e.g. setting * so-called "early" partition properties. The partition can then be * initialized with MSHV_INITIALIZE_PARTITION. */ struct mshv_create_partition { __u64 pt_flags; __u64 pt_isolation; }; /* /dev/mshv */ #define MSHV_CREATE_PARTITION _IOW(MSHV_IOCTL, 0x00, struct mshv_create_partition) /* ************************ * Child partition APIs * ************************ */ struct mshv_create_vp { __u32 vp_index; }; enum { MSHV_SET_MEM_BIT_WRITABLE, MSHV_SET_MEM_BIT_EXECUTABLE, MSHV_SET_MEM_BIT_UNMAP, MSHV_SET_MEM_BIT_COUNT }; #define MSHV_SET_MEM_FLAGS_MASK ((1 << MSHV_SET_MEM_BIT_COUNT) - 1) /* The hypervisor's "native" page size */ #define MSHV_HV_PAGE_SIZE 0x1000 /** * struct mshv_user_mem_region - arguments for MSHV_SET_GUEST_MEMORY * @size: Size of the memory region (bytes). Must be aligned to * MSHV_HV_PAGE_SIZE * @guest_pfn: Base guest page number to map * @userspace_addr: Base address of userspace memory. Must be aligned to * MSHV_HV_PAGE_SIZE * @flags: Bitmask of 1 << MSHV_SET_MEM_BIT_*. If (1 << MSHV_SET_MEM_BIT_UNMAP) * is set, ignore other bits. * @rsvd: MBZ * * Map or unmap a region of userspace memory to Guest Physical Addresses (GPA). * Mappings can't overlap in GPA space or userspace. * To unmap, these fields must match an existing mapping. */ struct mshv_user_mem_region { __u64 size; __u64 guest_pfn; __u64 userspace_addr; __u8 flags; __u8 rsvd[7]; }; enum { MSHV_IRQFD_BIT_DEASSIGN, MSHV_IRQFD_BIT_RESAMPLE, MSHV_IRQFD_BIT_COUNT, }; #define MSHV_IRQFD_FLAGS_MASK ((1 << MSHV_IRQFD_BIT_COUNT) - 1) struct mshv_user_irqfd { __s32 fd; __s32 resamplefd; __u32 gsi; __u32 flags; }; enum { MSHV_IOEVENTFD_BIT_DATAMATCH, MSHV_IOEVENTFD_BIT_PIO, MSHV_IOEVENTFD_BIT_DEASSIGN, MSHV_IOEVENTFD_BIT_COUNT, }; #define MSHV_IOEVENTFD_FLAGS_MASK ((1 << MSHV_IOEVENTFD_BIT_COUNT) - 1) struct mshv_user_ioeventfd { __u64 datamatch; __u64 addr; /* legal pio/mmio address */ __u32 len; /* 1, 2, 4, or 8 bytes */ __s32 fd; __u32 flags; __u8 rsvd[4]; }; struct mshv_user_irq_entry { __u32 gsi; __u32 address_lo; __u32 address_hi; __u32 data; }; struct mshv_user_irq_table { __u32 nr; __u32 rsvd; /* MBZ */ struct mshv_user_irq_entry entries[]; }; enum { MSHV_GPAP_ACCESS_TYPE_ACCESSED, MSHV_GPAP_ACCESS_TYPE_DIRTY, MSHV_GPAP_ACCESS_TYPE_COUNT /* Count of enum members */ }; enum { MSHV_GPAP_ACCESS_OP_NOOP, MSHV_GPAP_ACCESS_OP_CLEAR, MSHV_GPAP_ACCESS_OP_SET, MSHV_GPAP_ACCESS_OP_COUNT /* Count of enum members */ }; /** * struct mshv_gpap_access_bitmap - arguments for MSHV_GET_GPAP_ACCESS_BITMAP * @access_type: MSHV_GPAP_ACCESS_TYPE_* -