/* -*- c -*- * qemu_protocol.x: private protocol for communicating between * remote_internal driver and libvirtd. This protocol is * internal and may change at any time. * * Copyright (C) 2010-2014 Red Hat, Inc. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 of the License, or (at your option) any later version. * * This library is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library. If not, see * . */ %#include "internal.h" %#include "remote_protocol.h" /*----- Protocol. -----*/ struct qemu_domain_monitor_command_args { remote_nonnull_domain dom; remote_nonnull_string cmd; unsigned int flags; }; struct qemu_domain_monitor_command_ret { remote_nonnull_string result; }; struct qemu_domain_attach_args { unsigned int pid_value; unsigned int flags; }; struct qemu_domain_attach_ret { remote_nonnull_domain dom; }; struct qemu_domain_agent_command_args { remote_nonnull_domain dom; remote_nonnull_string cmd; int timeout; unsigned int flags; }; struct qemu_domain_agent_command_ret { remote_string result; }; struct qemu_connect_domain_monitor_event_register_args { remote_domain dom; remote_string event; unsigned int flags; }; struct qemu_connect_domain_monitor_event_register_ret { int callbackID; }; struct qemu_connect_domain_monitor_event_deregister_args { int callbackID; }; struct qemu_domain_monitor_event_msg { int callbackID; remote_nonnull_domain dom; remote_nonnull_string event; hyper seconds; unsigned int micros; remote_string details; }; /* Define the program number, protocol version and procedure numbers here. */ const QEMU_PROGRAM = 0x20008087; const QEMU_PROTOCOL_VERSION = 1; enum qemu_procedure { /* Each function must be preceded by a comment providing one or * more annotations: * * - @generate: none|client|server|both * * Whether to generate the dispatch stubs for the server * and/or client code. * * - @readstream: paramnumber * - @writestream: paramnumber * * The @readstream or @writestream annotations let daemon and src/remote * create a stream. The direction is defined from the src/remote point * of view. A readstream transfers data from daemon to src/remote. The * specifies at which offset the stream parameter is inserted * in the function parameter list. * * - @priority: low|high * * Each API that might eventually access hypervisor's monitor (and thus * block) MUST fall into low priority. However, there are some exceptions * to this rule, e.g. domainDestroy. Other APIs MAY be marked as high * priority. If in doubt, it's safe to choose low. Low is taken as default, * and thus can be left out. */ /** * @generate: none * @priority: low * @acl: domain:write */ QEMU_PROC_DOMAIN_MONITOR_COMMAND = 1, /** * @generate: both * @priority: low * @acl: domain:start * @acl: domain:write */ QEMU_PROC_DOMAIN_ATTACH = 2, /** * @generate: both * @priority: low * @acl: domain:write */ QEMU_PROC_DOMAIN_AGENT_COMMAND = 3, /** * @generate: none * @priority: high * @acl: connect:search_domains * @acl: connect:write * @aclfilter: domain:getattr */ QEMU_PROC_CONNECT_DOMAIN_MONITOR_EVENT_REGISTER = 4, /** * @generate: none * @priority: high * @acl: connect:write */ QEMU_PROC_CONNECT_DOMAIN_MONITOR_EVENT_DEREGISTER = 5, /** * @generate: both * @acl: none */ QEMU_PROC_DOMAIN_MONITOR_EVENT = 6 };