/root/src/xen/xen/include/public/callback.h
Line | Count | Source (jump to first uncovered line) |
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 | 0 | #define CALLBACKTYPE_event 0 |
41 | | |
42 | | /* x86: Failsafe callback when guest state cannot be restored by Xen. */ |
43 | 0 | #define CALLBACKTYPE_failsafe 1 |
44 | | |
45 | | /* x86/64 hypervisor: Syscall by 64-bit guest app ('64-on-64-on-64'). */ |
46 | 0 | #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 | 0 | #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 | 0 | #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 | 0 | #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 | 0 | #define _CALLBACKF_mask_events 0 |
78 | 0 | #define CALLBACKF_mask_events (1U << _CALLBACKF_mask_events) |
79 | | |
80 | | /* |
81 | | * Register a callback. |
82 | | */ |
83 | 0 | #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 | 0 | #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 | | */ |