1 /****************************************************************************** 2 * callback.h 3 * 4 * Register guest OS callbacks with Xen. 5 * 6 * Permission is hereby granted, free of charge, to any person obtaining a copy 7 * of this software and associated documentation files (the "Software"), to 8 * deal in the Software without restriction, including without limitation the 9 * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or 10 * sell copies of the Software, and to permit persons to whom the Software is 11 * furnished to do so, subject to the following conditions: 12 * 13 * The above copyright notice and this permission notice shall be included in 14 * all copies or substantial portions of the Software. 15 * 16 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 17 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 18 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE 19 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 20 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING 21 * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER 22 * DEALINGS IN THE SOFTWARE. 23 * 24 * Copyright (c) 2006, Ian Campbell 25 */ 26 27 #ifndef __XEN_PUBLIC_CALLBACK_H__ 28 #define __XEN_PUBLIC_CALLBACK_H__ 29 30 #include "xen.h" 31 32 /* 33 * Prototype for this hypercall is: 34 * long callback_op(int cmd, void *extra_args) 35 * @cmd == CALLBACKOP_??? (callback operation). 36 * @extra_args == Operation-specific extra arguments (NULL if none). 37 */ 38 39 /* x86: Callback for event delivery. */ 40 #define CALLBACKTYPE_event 0 41 42 /* x86: Failsafe callback when guest state cannot be restored by Xen. */ 43 #define CALLBACKTYPE_failsafe 1 44 45 /* x86/64 hypervisor: Syscall by 64-bit guest app ('64-on-64-on-64'). */ 46 #define CALLBACKTYPE_syscall 2 47 48 /* 49 * x86/32 hypervisor: Only available on x86/32 when supervisor_mode_kernel 50 * feature is enabled. Do not use this callback type in new code. 51 */ 52 #define CALLBACKTYPE_sysenter_deprecated 3 53 54 /* x86: Callback for NMI delivery. */ 55 #define CALLBACKTYPE_nmi 4 56 57 /* 58 * x86: sysenter is only available as follows: 59 * - 32-bit hypervisor: with the supervisor_mode_kernel feature enabled 60 * - 64-bit hypervisor: 32-bit guest applications on Intel CPUs 61 * ('32-on-32-on-64', '32-on-64-on-64') 62 * [nb. also 64-bit guest applications on Intel CPUs 63 * ('64-on-64-on-64'), but syscall is preferred] 64 */ 65 #define CALLBACKTYPE_sysenter 5 66 67 /* 68 * x86/64 hypervisor: Syscall by 32-bit guest app on AMD CPUs 69 * ('32-on-32-on-64', '32-on-64-on-64') 70 */ 71 #define CALLBACKTYPE_syscall32 7 72 73 /* 74 * Disable event deliver during callback? This flag is ignored for event and 75 * NMI callbacks: event delivery is unconditionally disabled. 76 */ 77 #define _CALLBACKF_mask_events 0 78 #define CALLBACKF_mask_events (1U << _CALLBACKF_mask_events) 79 80 /* 81 * Register a callback. 82 */ 83 #define CALLBACKOP_register 0 84 struct callback_register { 85 uint16_t type; 86 uint16_t flags; 87 xen_callback_t address; 88 }; 89 typedef struct callback_register callback_register_t; 90 DEFINE_XEN_GUEST_HANDLE(callback_register_t); 91 92 /* 93 * Unregister a callback. 94 * 95 * Not all callbacks can be unregistered. -EINVAL will be returned if 96 * you attempt to unregister such a callback. 97 */ 98 #define CALLBACKOP_unregister 1 99 struct callback_unregister { 100 uint16_t type; 101 uint16_t _unused; 102 }; 103 typedef struct callback_unregister callback_unregister_t; 104 DEFINE_XEN_GUEST_HANDLE(callback_unregister_t); 105 106 #if __XEN_INTERFACE_VERSION__ < 0x00030207 107 #undef CALLBACKTYPE_sysenter 108 #define CALLBACKTYPE_sysenter CALLBACKTYPE_sysenter_deprecated 109 #endif 110 111 #endif /* __XEN_PUBLIC_CALLBACK_H__ */ 112 113 /* 114 * Local variables: 115 * mode: C 116 * c-file-style: "BSD" 117 * c-basic-offset: 4 118 * tab-width: 4 119 * indent-tabs-mode: nil 120 * End: 121 */ 122