/* Copyright (C) 2009 Red Hat, Inc. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: * Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. * Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. * Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDER AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. */ #ifndef _H_VD_INTERFACE #define _H_VD_INTERFACE #include #define VM_INTERFACE_VERSION 1 typedef unsigned long VDObjectRef; #define INVALID_VD_OBJECT_REF 0 typedef struct SpiceBaseInterface SpiceBaseInterface; typedef struct SpiceBaseInstance SpiceBaseInstance; struct SpiceBaseInterface { const char *type; const char *description; uint32_t major_version; uint32_t minor_version; }; struct SpiceBaseInstance { const SpiceBaseInterface *sif; }; #define SPICE_INTERFACE_CORE "core" #define SPICE_INTERFACE_CORE_MAJOR 1 #define SPICE_INTERFACE_CORE_MINOR 2 typedef struct SpiceCoreInterface SpiceCoreInterface; typedef enum { VD_LOG_ERROR = 1, VD_LOG_WARN, VD_LOG_INFO, } LogLevel; #define SPICE_WATCH_EVENT_READ (1 << 0) #define SPICE_WATCH_EVENT_WRITE (1 << 1) typedef struct SpiceWatch SpiceWatch; typedef void (*SpiceWatchFunc)(int fd, int event, void *opaque); typedef struct SpiceTimer SpiceTimer; typedef void (*SpiceTimerFunc)(void *opaque); struct SpiceCoreInterface { SpiceBaseInterface base; SpiceTimer *(*timer_add)(SpiceTimerFunc func, void *opaque); void (*timer_start)(SpiceTimer *timer, uint32_t ms); void (*timer_cancel)(SpiceTimer *timer); void (*timer_remove)(SpiceTimer *timer); SpiceWatch *(*watch_add)(int fd, int event_mask, SpiceWatchFunc func, void *opaque); void (*watch_update_mask)(SpiceWatch *watch, int event_mask); void (*watch_remove)(SpiceWatch *watch); }; #define SPICE_INTERFACE_QXL "qxl" #define SPICE_INTERFACE_QXL_MAJOR 3 #define SPICE_INTERFACE_QXL_MINOR 0 typedef struct QXLInterface QXLInterface; typedef struct QXLInstance QXLInstance; typedef struct QXLState QXLState; typedef struct QXLWorker QXLWorker; typedef struct QXLDevMemSlot QXLDevMemSlot; typedef struct QXLDevSurfaceCreate QXLDevSurfaceCreate; union QXLReleaseInfo; struct QXLReleaseInfoExt; struct QXLCommand; struct QXLCommandExt; struct SpiceRect; struct QXLWorker { uint32_t minor_version; uint32_t major_version; void (*wakeup)(QXLWorker *worker); void (*oom)(QXLWorker *worker); void (*save)(QXLWorker *worker); void (*load)(QXLWorker *worker); void (*start)(QXLWorker *worker); void (*stop)(QXLWorker *worker); void (*update_area)(QXLWorker *qxl_worker, uint32_t surface_id, struct SpiceRect *area, struct SpiceRect *dirty_rects, uint32_t num_dirty_rects, uint32_t clear_dirty_region); void (*add_memslot)(QXLWorker *worker, QXLDevMemSlot *slot); void (*del_memslot)(QXLWorker *worker, uint32_t slot_group_id, uint32_t slot_id); void (*reset_memslots)(QXLWorker *worker); void (*destroy_surfaces)(QXLWorker *worker); void (*destroy_primary_surface)(QXLWorker *worker, uint32_t surface_id); void (*create_primary_surface)(QXLWorker *worker, uint32_t surface_id, QXLDevSurfaceCreate *surface); void (*reset_image_cache)(QXLWorker *worker); void (*reset_cursor)(QXLWorker *worker); void (*destroy_surface_wait)(QXLWorker *worker, uint32_t surface_id); }; typedef struct DrawArea { uint8_t *buf; uint32_t size; uint8_t *line_0; uint32_t width; uint32_t heigth; int stride; } DrawArea; typedef struct QXLDevInfo { uint32_t x_res; uint32_t y_res; uint32_t bits; uint32_t use_hardware_cursor; DrawArea draw_area; uint32_t ram_size; } QXLDevInfo; typedef struct QXLDevInitInfo { uint32_t num_memslots_groups; uint32_t num_memslots; uint8_t memslot_gen_bits; uint8_t memslot_id_bits; uint32_t qxl_ram_size; uint8_t internal_groupslot_id; uint32_t n_surfaces; } QXLDevInitInfo; struct QXLDevMemSlot { uint32_t slot_group_id; uint32_t slot_id; uint32_t generation; unsigned long virt_start; unsigned long virt_end; uint64_t addr_delta; uint32_t qxl_ram_size; }; struct QXLDevSurfaceCreate { uint32_t width; uint32_t height; int32_t stride; uint32_t format; uint32_t position; uint32_t mouse_mode; uint32_t flags; uint32_t type; uint64_t mem; uint32_t group_id; }; struct SpiceRect; struct QXLInterface { SpiceBaseInterface base; uint16_t pci_vendor; uint16_t pci_id; uint8_t pci_revision; void (*attache_worker)(QXLInstance *qin, QXLWorker *qxl_worker); void (*set_compression_level)(QXLInstance *qin, int level); void (*set_mm_time)(QXLInstance *qin, uint32_t mm_time); void (*get_init_info)(QXLInstance *qin, QXLDevInitInfo *info); int (*get_command)(QXLInstance *qin, struct QXLCommandExt *cmd); int (*req_cmd_notification)(QXLInstance *qin); int (*has_command)(QXLInstance *qin); void (*release_resource)(QXLInstance *qin, struct QXLReleaseInfoExt release_info); int (*get_cursor_command)(QXLInstance *qin, struct QXLCommandExt *cmd); int (*req_cursor_notification)(QXLInstance *qin); void (*notify_update)(QXLInstance *qin, uint32_t update_id); void (*set_save_data)(QXLInstance *qin, void *data, int size); void *(*get_save_data)(QXLInstance *qin); int (*flush_resources)(QXLInstance *qin); }; struct QXLInstance { SpiceBaseInstance base; int id; QXLState *st; }; #define SPICE_INTERFACE_KEYBOARD "keyboard" #define SPICE_INTERFACE_KEYBOARD_MAJOR 1 #define SPICE_INTERFACE_KEYBOARD_MINOR 1 typedef struct SpiceKbdInterface SpiceKbdInterface; typedef struct SpiceKbdInstance SpiceKbdInstance; typedef struct SpiceKbdState SpiceKbdState; struct SpiceKbdInterface { SpiceBaseInterface base; void (*push_scan_freg)(SpiceKbdInstance *sin, uint8_t frag); uint8_t (*get_leds)(SpiceKbdInstance *sin); }; struct SpiceKbdInstance { SpiceBaseInstance base; SpiceKbdState *st; }; #define SPICE_INTERFACE_MOUSE "mouse" #define SPICE_INTERFACE_MOUSE_MAJOR 1 #define SPICE_INTERFACE_MOUSE_MINOR 1 typedef struct SpiceMouseInterface SpiceMouseInterface; typedef struct SpiceMouseInstance SpiceMouseInstance; typedef struct SpiceMouseState SpiceMouseState; struct SpiceMouseInterface { SpiceBaseInterface base; void (*motion)(SpiceMouseInstance *sin, int dx, int dy, int dz, uint32_t buttons_state); void (*buttons)(SpiceMouseInstance *sin, uint32_t buttons_state); }; struct SpiceMouseInstance { SpiceBaseInstance base; SpiceMouseState *st; }; #define SPICE_INTERFACE_TABLET "tablet" #define SPICE_INTERFACE_TABLET_MAJOR 1 #define SPICE_INTERFACE_TABLET_MINOR 1 typedef struct SpiceTabletInterface SpiceTabletInterface; typedef struct SpiceTabletInstance SpiceTabletInstance; typedef struct SpiceTabletState SpiceTabletState; struct SpiceTabletInterface { SpiceBaseInterface base; void (*set_logical_size)(SpiceTabletInstance* tablet, int width, int height); void (*position)(SpiceTabletInstance* tablet, int x, int y, uint32_t buttons_state); void (*wheel)(SpiceTabletInstance* tablet, int wheel_moution, uint32_t buttons_state); void (*buttons)(SpiceTabletInstance* tablet, uint32_t buttons_state); }; struct SpiceTabletInstance { SpiceBaseInstance base; SpiceTabletState *st; }; #define VD_INTERFACE_MIGRATION "migration" #define VD_INTERFACE_MIGRATION_MAJOR 1 #define VD_INTERFACE_MIGRATION_MINOR 1 typedef struct MigrationInterface MigrationInterface; typedef void (*migration_notify_started_t)(void *opaque, const char *args); typedef void (*migration_notify_finished_t)(void *opaque, int completed); typedef void (*migration_notify_recv_t)(void *opaque, int fd); struct MigrationInterface { SpiceBaseInterface base; VDObjectRef (*register_notifiers)(MigrationInterface* mig, const char *key, migration_notify_started_t, migration_notify_finished_t, migration_notify_recv_t, void *opaque); void (*unregister_notifiers)(MigrationInterface* mig, VDObjectRef notifier); void (*notifier_done)(MigrationInterface *mig, VDObjectRef notifier); int (*begin_hook)(MigrationInterface *mig, VDObjectRef notifier); }; enum VDIArgType{ ARG_TYPE_INVALID, ARG_TYPE_INT, ARG_TYPE_STRING, }; typedef struct VDIArgDescriptor { char* name; int type; int optional; } VDIArgDescriptor; typedef struct VDICmdArg { VDIArgDescriptor descriptor; union { uint64_t int_val; const char *string_val; }; } VDICmdArg; typedef void (*VDICmdHandler)(const VDICmdArg* args); typedef void (*VDIInfoCmdHandler)(void); #define SPICE_INTERFACE_PLAYBACK "playback" #define SPICE_INTERFACE_PLAYBACK_MAJOR 1 #define SPICE_INTERFACE_PLAYBACK_MINOR 1 typedef struct SpicePlaybackInterface SpicePlaybackInterface; typedef struct SpicePlaybackInstance SpicePlaybackInstance; typedef struct SpicePlaybackState SpicePlaybackState; enum { SPICE_INTERFACE_AUDIO_FMT_S16 = 1, }; #define SPICE_INTERFACE_PLAYBACK_FREQ 44100 #define SPICE_INTERFACE_PLAYBACK_CHAN 2 #define SPICE_INTERFACE_PLAYBACK_FMT SPICE_INTERFACE_AUDIO_FMT_S16 struct SpicePlaybackInterface { SpiceBaseInterface base; }; struct SpicePlaybackInstance { SpiceBaseInstance base; SpicePlaybackState *st; }; void spice_server_playback_start(SpicePlaybackInstance *sin); void spice_server_playback_stop(SpicePlaybackInstance *sin); void spice_server_playback_get_buffer(SpicePlaybackInstance *sin, uint32_t **samples, uint32_t *nsamples); void spice_server_playback_put_samples(SpicePlaybackInstance *sin, uint32_t *samples); #define SPICE_INTERFACE_RECORD "record" #define SPICE_INTERFACE_RECORD_MAJOR 2 #define SPICE_INTERFACE_RECORD_MINOR 1 typedef struct SpiceRecordInterface SpiceRecordInterface; typedef struct SpiceRecordInstance SpiceRecordInstance; typedef struct SpiceRecordState SpiceRecordState; #define SPICE_INTERFACE_RECORD_FREQ 44100 #define SPICE_INTERFACE_RECORD_CHAN 2 #define SPICE_INTERFACE_RECORD_FMT SPICE_INTERFACE_AUDIO_FMT_S16 struct SpiceRecordInterface { SpiceBaseInterface base; }; struct SpiceRecordInstance { SpiceBaseInstance base; SpiceRecordState *st; }; void spice_server_record_start(SpiceRecordInstance *sin); void spice_server_record_stop(SpiceRecordInstance *sin); uint32_t spice_server_record_get_samples(SpiceRecordInstance *sin, uint32_t *samples, uint32_t bufsize); #define VD_INTERFACE_VDI_PORT "vdi_port" #define VD_INTERFACE_VDI_PORT_MAJOR 1 #define VD_INTERFACE_VDI_PORT_MINOR 1 typedef struct VDIPortInterface VDIPortInterface; typedef struct VDIPortPlug VDIPortPlug; struct VDIPortPlug { uint32_t minor_version; uint32_t major_version; void (*wakeup)(VDIPortPlug *plug); }; struct VDIPortInterface { SpiceBaseInterface base; VDObjectRef (*plug)(VDIPortInterface *port, VDIPortPlug* plug); void (*unplug)(VDIPortInterface *port, VDObjectRef plug); int (*write)(VDIPortInterface *port, VDObjectRef plug, const uint8_t *buf, int len); int (*read)(VDIPortInterface *port, VDObjectRef plug, uint8_t *buf, int len); }; #define VD_INTERFACE_NET_WIRE "net_wire" #define VD_INTERFACE_NET_WIRE_MAJOR 1 #define VD_INTERFACE_NET_WIRE_MINOR 1 typedef struct NetWireInterface NetWireInterface; typedef void (*net_wire_packet_route_proc_t)(void *opaque, const uint8_t *pkt, int pkt_len); struct NetWireInterface { SpiceBaseInterface base; struct in_addr (*get_ip)(NetWireInterface *vlan); int (*can_send_packet)(NetWireInterface *vlan); void (*send_packet)(NetWireInterface *vlan, const uint8_t *buf, int size); VDObjectRef (*register_route_packet)(NetWireInterface *vlan, net_wire_packet_route_proc_t proc, void *opaque); void (*unregister_route_packet)(NetWireInterface *vlan, VDObjectRef proc); }; #endif