/* Version of vbg_ioctl_hdr structure. */ #define VBG_IOCTL_HDR_VERSION 0x10001 /* Default request type. Use this for non-VMMDev requests. */ #define VBG_IOCTL_HDR_TYPE_DEFAULT 0
/** * Common ioctl header. * * This is a mirror of vmmdev_request_header to prevent duplicating data and * needing to verify things multiple times.
*/ struct vbg_ioctl_hdr { /** IN: The request input size, and output size if size_out is zero. */
__u32 size_in; /** IN: Structure version (VBG_IOCTL_HDR_VERSION) */
__u32 version; /** IN: The VMMDev request type or VBG_IOCTL_HDR_TYPE_DEFAULT. */
__u32 type; /** * OUT: The VBox status code of the operation, out direction only. * This is a VINF_ or VERR_ value as defined in vbox_err.h.
*/
__s32 rc; /** IN: Output size. Set to zero to use size_in as output size. */
__u32 size_out; /** Reserved, MBZ. */
__u32 reserved;
};
VMMDEV_ASSERT_SIZE(vbg_ioctl_hdr, 24);
/* * The VBoxGuest I/O control version. * * As usual, the high word contains the major version and changes to it * signifies incompatible changes. * * The lower word is the minor version number, it is increased when new * functions are added or existing changed in a backwards compatible manner.
*/ #define VBG_IOC_VERSION 0x00010000u
/** * VBG_IOCTL_DRIVER_VERSION_INFO data structure * * Note VBG_IOCTL_DRIVER_VERSION_INFO may switch the session to a backwards * compatible interface version if uClientVersion indicates older client code.
*/ struct vbg_ioctl_driver_version_info { /** The header. */ struct vbg_ioctl_hdr hdr; union { struct { /** Requested interface version (VBG_IOC_VERSION). */
__u32 req_version; /** * Minimum interface version number (typically the * major version part of VBG_IOC_VERSION).
*/
__u32 min_version; /** Reserved, MBZ. */
__u32 reserved1; /** Reserved, MBZ. */
__u32 reserved2;
} in; struct { /** Version for this session (typ. VBG_IOC_VERSION). */
__u32 session_version; /** Version of the IDC interface (VBG_IOC_VERSION). */
__u32 driver_version; /** The SVN revision of the driver, or 0. */
__u32 driver_revision; /** Reserved \#1 (zero until defined). */
__u32 reserved1; /** Reserved \#2 (zero until defined). */
__u32 reserved2;
} out;
} u;
};
VMMDEV_ASSERT_SIZE(vbg_ioctl_driver_version_info, 24 + 20);
/** VBG_IOCTL_HGCM_CALL data structure. */ struct vbg_ioctl_hgcm_call { /** The header. */ struct vbg_ioctl_hdr hdr; /** Input: The id of the caller. */
__u32 client_id; /** Input: Function number. */
__u32 function; /** * Input: How long to wait (milliseconds) for completion before * cancelling the call. Set to -1 to wait indefinitely.
*/
__u32 timeout_ms; /** Interruptable flag, ignored for userspace calls. */
__u8 interruptible; /** Explicit padding, MBZ. */
__u8 reserved; /** * Input: How many parameters following this structure. * * The parameters are either HGCMFunctionParameter64 or 32, * depending on whether we're receiving a 64-bit or 32-bit request. * * The current maximum is 61 parameters (given a 1KB max request size, * and a 64-bit parameter size of 16 bytes).
*/
__u16 parm_count; /* * Parameters follow in form: * struct hgcm_function_parameter<32|64> parms[parm_count]
*/
};
VMMDEV_ASSERT_SIZE(vbg_ioctl_hgcm_call, 24 + 16);
/** VBG_IOCTL_LOG data structure. */ struct vbg_ioctl_log { /** The header. */ struct vbg_ioctl_hdr hdr; union { struct { /** * The log message, this may be zero terminated. If it * is not zero terminated then the length is determined * from the input size.
*/ char msg[1];
} in;
} u;
};
#define VBG_IOCTL_LOG(s) _IO('V', 9)
/** VBG_IOCTL_WAIT_FOR_EVENTS data structure. */ struct vbg_ioctl_wait_for_events { /** The header. */ struct vbg_ioctl_hdr hdr; union { struct { /** Timeout in milliseconds. */
__u32 timeout_ms; /** Events to wait for. */
__u32 events;
} in; struct { /** Events that occurred. */
__u32 events;
} out;
} u;
};
VMMDEV_ASSERT_SIZE(vbg_ioctl_wait_for_events, 24 + 8);
/* * IOCTL to VBoxGuest to interrupt (cancel) any pending * VBG_IOCTL_WAIT_FOR_EVENTS and return. * * Handled inside the vboxguest driver and not seen by the host at all. * After calling this, VBG_IOCTL_WAIT_FOR_EVENTS should no longer be called in * the same session. Any VBOXGUEST_IOCTL_WAITEVENT calls in the same session * done after calling this will directly exit with -EINTR.
*/ #define VBG_IOCTL_INTERRUPT_ALL_WAIT_FOR_EVENTS \
_IOWR('V', 11, struct vbg_ioctl_hdr)
/** VBG_IOCTL_CHANGE_FILTER_MASK data structure. */ struct vbg_ioctl_change_filter { /** The header. */ struct vbg_ioctl_hdr hdr; union { struct { /** Flags to set. */
__u32 or_mask; /** Flags to remove. */
__u32 not_mask;
} in;
} u;
};
VMMDEV_ASSERT_SIZE(vbg_ioctl_change_filter, 24 + 8);
/* IOCTL to VBoxGuest to control the event filter mask. */ #define VBG_IOCTL_CHANGE_FILTER_MASK \
_IOWR('V', 12, struct vbg_ioctl_change_filter)
/** VBG_IOCTL_ACQUIRE_GUEST_CAPABILITIES data structure. */ struct vbg_ioctl_acquire_guest_caps { /** The header. */ struct vbg_ioctl_hdr hdr; union { struct { /** Flags (VBGL_IOC_AGC_FLAGS_XXX). */
__u32 flags; /** Capabilities to set (VMMDEV_GUEST_SUPPORTS_XXX). */
__u32 or_mask; /** Capabilities to drop (VMMDEV_GUEST_SUPPORTS_XXX). */
__u32 not_mask;
} in;
} u;
};
VMMDEV_ASSERT_SIZE(vbg_ioctl_acquire_guest_caps, 24 + 12);
/** VBG_IOCTL_CHANGE_GUEST_CAPABILITIES data structure. */ struct vbg_ioctl_set_guest_caps { /** The header. */ struct vbg_ioctl_hdr hdr; union { struct { /** Capabilities to set (VMMDEV_GUEST_SUPPORTS_XXX). */
__u32 or_mask; /** Capabilities to drop (VMMDEV_GUEST_SUPPORTS_XXX). */
__u32 not_mask;
} in; struct { /** Capabilities held by the session after the call. */
__u32 session_caps; /** Capabilities for all the sessions after the call. */
__u32 global_caps;
} out;
} u;
};
VMMDEV_ASSERT_SIZE(vbg_ioctl_set_guest_caps, 24 + 8);
/** VBG_IOCTL_CHECK_BALLOON data structure. */ struct vbg_ioctl_check_balloon { /** The header. */ struct vbg_ioctl_hdr hdr; union { struct { /** The size of the balloon in chunks of 1MB. */
__u32 balloon_chunks; /** * false = handled in R0, no further action required. * true = allocate balloon memory in R3.
*/
__u8 handle_in_r3; /** Explicit padding, MBZ. */
__u8 padding[3];
} out;
} u;
};
VMMDEV_ASSERT_SIZE(vbg_ioctl_check_balloon, 24 + 8);
/* * IOCTL to check memory ballooning. * * The guest kernel module will ask the host for the current size of the * balloon and adjust the size. Or it will set handle_in_r3 = true and R3 is * responsible for allocating memory and calling VBG_IOCTL_CHANGE_BALLOON.
*/ #define VBG_IOCTL_CHECK_BALLOON \
_IOWR('V', 17, struct vbg_ioctl_check_balloon)
Die Informationen auf dieser Webseite wurden
nach bestem Wissen sorgfältig zusammengestellt. Es wird jedoch weder Vollständigkeit, noch Richtigkeit,
noch Qualität der bereit gestellten Informationen zugesichert.
Bemerkung:
Die farbliche Syntaxdarstellung ist noch experimentell.
