Return to callback.h CVS log

Up to [GnuMach] / Gnu-Mach / xen / public

Annotation of Gnu-Mach/xen/public/callback.h, revision 1.1.1.1

1.1       root        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: /* ia64, 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-set-style: "BSD"
                    117:  * c-basic-offset: 4
                    118:  * tab-width: 4
                    119:  * indent-tabs-mode: nil
                    120:  * End:
                    121:  */

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.