qemu_capabilities.h 11.9 KB
Newer Older
1 2 3
/*
 * qemu_capabilities.h: QEMU capabilities generation
 *
4
 * Copyright (C) 2006-2012 Red Hat, Inc.
5 6 7 8 9 10 11 12 13 14 15 16 17
 * Copyright (C) 2006 Daniel P. Berrange
 *
 * 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
18
 * License along with this library.  If not, see
O
Osier Yang 已提交
19
 * <http://www.gnu.org/licenses/>.
20 21 22 23 24 25 26
 *
 * Author: Daniel P. Berrange <berrange@redhat.com>
 */

#ifndef __QEMU_CAPABILITIES_H__
# define __QEMU_CAPABILITIES_H__

27
# include "virobject.h"
28
# include "capabilities.h"
29
# include "command.h"
30
# include "virobject.h"
31 32 33

/* Internal flags to keep track of qemu command line capabilities */
enum qemuCapsFlags {
E
Eric Blake 已提交
34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49
    QEMU_CAPS_KQEMU              =  0, /* Whether KQEMU is compiled in */
    QEMU_CAPS_VNC_COLON          =  1, /* VNC takes or address + display */
    QEMU_CAPS_NO_REBOOT          =  2, /* Is the -no-reboot flag available */
    QEMU_CAPS_DRIVE              =  3, /* Is the new -drive arg available */
    QEMU_CAPS_DRIVE_BOOT         =  4, /* Does -drive support boot=on */
    QEMU_CAPS_NAME               =  5, /* Is the -name flag available */
    QEMU_CAPS_UUID               =  6, /* Is the -uuid flag available */
    QEMU_CAPS_DOMID              =  7, /* Xenner: -domid flag available */
    QEMU_CAPS_VNET_HDR           =  8,
    QEMU_CAPS_MIGRATE_KVM_STDIO  =  9, /* avoid kvm tcp migration bug */
    QEMU_CAPS_MIGRATE_QEMU_TCP   = 10, /* have qemu tcp migration */
    QEMU_CAPS_MIGRATE_QEMU_EXEC  = 11, /* have qemu exec migration */
    QEMU_CAPS_DRIVE_CACHE_V2     = 12, /* cache= flag wanting new v2 values */
    QEMU_CAPS_KVM                = 13, /* Whether KVM is compiled in */
    QEMU_CAPS_DRIVE_FORMAT       = 14, /* Is -drive format= avail */
    QEMU_CAPS_VGA                = 15, /* Is -vga avail */
50 51

    /* features added in qemu-0.10.0 or later */
E
Eric Blake 已提交
52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101
    QEMU_CAPS_0_10               = 16,
    QEMU_CAPS_NET_NAME           = QEMU_CAPS_0_10, /* -net ...,name=str */
    QEMU_CAPS_HOST_NET_ADD       = QEMU_CAPS_0_10, /* host_net_add command */

    QEMU_CAPS_PCIDEVICE          = 17, /* PCI device assignment supported */
    QEMU_CAPS_MEM_PATH           = 18, /* mmap'ped guest backing supported */
    QEMU_CAPS_DRIVE_SERIAL       = 19, /* -driver serial=  available */
    QEMU_CAPS_XEN_DOMID          = 20, /* -xen-domid */
    QEMU_CAPS_MIGRATE_QEMU_UNIX  = 21, /* qemu migration via unix sockets */
    QEMU_CAPS_CHARDEV            = 22, /* Is the new -chardev arg available */
    QEMU_CAPS_ENABLE_KVM         = 23, /* -enable-kvm flag */
    QEMU_CAPS_MONITOR_JSON       = 24, /* JSON mode for monitor */
    QEMU_CAPS_BALLOON            = 25, /* -balloon available */
    QEMU_CAPS_DEVICE             = 26, /* Is the new -device arg available */
    QEMU_CAPS_SDL                = 27, /* Is the new -sdl arg available */
    QEMU_CAPS_SMP_TOPOLOGY       = 28, /* -smp has sockets/cores/threads */
    QEMU_CAPS_NETDEV             = 29, /* -netdev flag & netdev_add/remove */
    QEMU_CAPS_RTC                = 30, /* The -rtc flag for clock options */
    QEMU_CAPS_VHOST_NET          = 31, /* vhost-net support available */
    QEMU_CAPS_RTC_TD_HACK        = 32, /* -rtc-td-hack available */
    QEMU_CAPS_NO_HPET            = 33, /* -no-hpet flag is supported */
    QEMU_CAPS_NO_KVM_PIT         = 34, /* -no-kvm-pit-reinjection supported */
    QEMU_CAPS_TDF                = 35, /* -tdf flag (user-mode pit catchup) */
    QEMU_CAPS_PCI_CONFIGFD       = 36, /* pci-assign.configfd */
    QEMU_CAPS_NODEFCONFIG        = 37, /* -nodefconfig */
    QEMU_CAPS_BOOT_MENU          = 38, /* -boot menu=on support */
    QEMU_CAPS_ENABLE_KQEMU       = 39, /* -enable-kqemu flag */
    QEMU_CAPS_FSDEV              = 40, /* -fstype filesystem passthrough */
    QEMU_CAPS_NESTING            = 41, /* -enable-nesting (SVM/VMX) */
    QEMU_CAPS_NAME_PROCESS       = 42, /* Is -name process= available */
    QEMU_CAPS_DRIVE_READONLY     = 43, /* -drive readonly=on|off */
    QEMU_CAPS_SMBIOS_TYPE        = 44, /* Is -smbios type= available */
    QEMU_CAPS_VGA_QXL            = 45, /* The 'qxl' arg for '-vga' */
    QEMU_CAPS_SPICE              = 46, /* Is -spice avail */
    QEMU_CAPS_VGA_NONE           = 47, /* The 'none' arg for '-vga' */
    QEMU_CAPS_MIGRATE_QEMU_FD    = 48, /* -incoming fd:n */
    QEMU_CAPS_BOOTINDEX          = 49, /* -device bootindex property */
    QEMU_CAPS_HDA_DUPLEX         = 50, /* -device hda-duplex */
    QEMU_CAPS_DRIVE_AIO          = 51, /* -drive aio= supported */
    QEMU_CAPS_PCI_MULTIBUS       = 52, /* bus=pci.0 vs bus=pci */
    QEMU_CAPS_PCI_BOOTINDEX      = 53, /* pci-assign.bootindex */
    QEMU_CAPS_CCID_EMULATED      = 54, /* -device ccid-card-emulated */
    QEMU_CAPS_CCID_PASSTHRU      = 55, /* -device ccid-card-passthru */
    QEMU_CAPS_CHARDEV_SPICEVMC   = 56, /* newer -chardev spicevmc */
    QEMU_CAPS_DEVICE_SPICEVMC    = 57, /* older -device spicevmc*/
    QEMU_CAPS_VIRTIO_TX_ALG      = 58, /* -device virtio-net-pci,tx=string */
    QEMU_CAPS_DEVICE_QXL_VGA     = 59, /* primary qxl device named qxl-vga? */
    QEMU_CAPS_PCI_MULTIFUNCTION  = 60, /* -device multifunction=on|off */
    QEMU_CAPS_VIRTIO_IOEVENTFD   = 61, /* virtio-{net|blk}-pci.ioeventfd=on */
    QEMU_CAPS_SGA                = 62, /* Serial Graphics Adapter */
102 103
    QEMU_CAPS_VIRTIO_BLK_EVENT_IDX = 63, /* virtio-blk-pci.event_idx */
    QEMU_CAPS_VIRTIO_NET_EVENT_IDX = 64, /* virtio-net-pci.event_idx */
104
    QEMU_CAPS_DRIVE_CACHE_DIRECTSYNC = 65, /* Is cache=directsync supported? */
E
Eric Blake 已提交
105 106 107 108
    QEMU_CAPS_PIIX3_USB_UHCI     = 66, /* -device piix3-usb-uhci */
    QEMU_CAPS_PIIX4_USB_UHCI     = 67, /* -device piix4-usb-uhci */
    QEMU_CAPS_USB_EHCI           = 68, /* -device usb-ehci */
    QEMU_CAPS_ICH9_USB_EHCI1     = 69, /* -device ich9-usb-ehci1 and friends */
M
Marc-André Lureau 已提交
109
    QEMU_CAPS_VT82C686B_USB_UHCI = 70, /* -device vt82c686b-usb-uhci */
E
Eric Blake 已提交
110 111 112 113
    QEMU_CAPS_PCI_OHCI           = 71, /* -device pci-ohci */
    QEMU_CAPS_USB_REDIR          = 72, /* -device usb-redir */
    QEMU_CAPS_USB_HUB            = 73, /* -device usb-hub */
    QEMU_CAPS_NO_SHUTDOWN        = 74, /* usable -no-shutdown */
114
    QEMU_CAPS_DRIVE_CACHE_UNSAFE = 75, /* Is cache=unsafe supported? */
115
    QEMU_CAPS_PCI_ROMBAR         = 76, /* -device rombar=0|1 */
E
Eric Blake 已提交
116 117 118
    QEMU_CAPS_ICH9_AHCI          = 77, /* -device ich9-ahci */
    QEMU_CAPS_NO_ACPI            = 78, /* -no-acpi */
    QEMU_CAPS_FSDEV_READONLY     = 79, /* -fsdev readonly supported */
119
    QEMU_CAPS_VIRTIO_BLK_SCSI    = 80, /* virtio-blk-pci.scsi */
E
Eric Blake 已提交
120
    QEMU_CAPS_VIRTIO_BLK_SG_IO   = 81, /* SG_IO commands, since 0.11 */
O
Osier Yang 已提交
121
    QEMU_CAPS_DRIVE_COPY_ON_READ = 82, /* -drive copy-on-read */
E
Eric Blake 已提交
122
    QEMU_CAPS_CPU_HOST           = 83, /* support for -cpu host */
123
    QEMU_CAPS_FSDEV_WRITEOUT     = 84, /* -fsdev writeout supported */
E
Eric Blake 已提交
124
    QEMU_CAPS_DRIVE_IOTUNE       = 85, /* -drive bps= and friends */
125
    QEMU_CAPS_WAKEUP             = 86, /* system_wakeup monitor command */
126
    QEMU_CAPS_SCSI_DISK_CHANNEL  = 87, /* Is scsi-disk.channel available? */
127
    QEMU_CAPS_SCSI_BLOCK         = 88, /* -device scsi-block */
128
    QEMU_CAPS_TRANSACTION        = 89, /* transaction monitor command */
129 130
    QEMU_CAPS_BLOCKJOB_SYNC      = 90, /* RHEL 6.2 block_job_cancel */
    QEMU_CAPS_BLOCKJOB_ASYNC     = 91, /* qemu 1.1 block-job-cancel */
131
    QEMU_CAPS_SCSI_CD            = 92, /* -device scsi-cd */
132
    QEMU_CAPS_IDE_CD             = 93, /* -device ide-cd */
133
    QEMU_CAPS_NO_USER_CONFIG     = 94, /* -no-user-config */
M
Marc-André Lureau 已提交
134
    QEMU_CAPS_HDA_MICRO          = 95, /* -device hda-micro */
135
    QEMU_CAPS_DUMP_GUEST_MEMORY  = 96, /* dump-guest-memory command */
G
Gerd Hoffmann 已提交
136
    QEMU_CAPS_NEC_USB_XHCI       = 97, /* -device nec-usb-xhci */
137
    QEMU_CAPS_VIRTIO_S390        = 98, /* -device virtio-*-s390 */
138
    QEMU_CAPS_BALLOON_EVENT      = 99, /* Async event for balloon changes */
R
Richa Marwaha 已提交
139
    QEMU_CAPS_NETDEV_BRIDGE      = 100, /* bridge helper support */
140 141
    QEMU_CAPS_SCSI_LSI           = 101, /* -device lsi */
    QEMU_CAPS_VIRTIO_SCSI_PCI    = 102, /* -device virtio-scsi-pci */
V
Viktor Mihajlovski 已提交
142
    QEMU_CAPS_BLOCKIO            = 103, /* -device ...logical_block_size & co */
143 144
    QEMU_CAPS_DISABLE_S3         = 104, /* S3 BIOS Advertisement on/off */
    QEMU_CAPS_DISABLE_S4         = 105, /* S4 BIOS Advertisement on/off */
145
    QEMU_CAPS_USB_REDIR_FILTER   = 106, /* usb-redir.filter */
146 147
    QEMU_CAPS_IDE_DRIVE_WWN      = 107, /* Is ide-drive.wwn available? */
    QEMU_CAPS_SCSI_DISK_WWN      = 108, /* Is scsi-disk.wwn available? */
148
    QEMU_CAPS_SECCOMP_SANDBOX    = 109, /* -sandbox */
149
    QEMU_CAPS_REBOOT_TIMEOUT     = 110, /* -boot reboot-timeout */
150
    QEMU_CAPS_DUMP_GUEST_CORE    = 111, /* dump-guest-core-parameter */
151
    QEMU_CAPS_SEAMLESS_MIGRATION = 112, /* seamless-migration for SPICE */
152

153
    QEMU_CAPS_LAST,                   /* this must always be the last item */
154 155
};

156 157
typedef struct _qemuCaps qemuCaps;
typedef qemuCaps *qemuCapsPtr;
158

159 160 161
typedef struct _qemuCapsCache qemuCapsCache;
typedef qemuCapsCache *qemuCapsCachePtr;

162
qemuCapsPtr qemuCapsNew(void);
163
qemuCapsPtr qemuCapsNewCopy(qemuCapsPtr caps);
164
qemuCapsPtr qemuCapsNewForBinary(const char *binary);
165

166
void qemuCapsSet(qemuCapsPtr caps,
167 168
                 enum qemuCapsFlags flag) ATTRIBUTE_NONNULL(1);

169
void qemuCapsSetList(qemuCapsPtr caps, ...) ATTRIBUTE_NONNULL(1);
170

171
void qemuCapsClear(qemuCapsPtr caps,
172
                   enum qemuCapsFlags flag) ATTRIBUTE_NONNULL(1);
173

174
bool qemuCapsGet(qemuCapsPtr caps,
175 176
                 enum qemuCapsFlags flag);

177 178
char *qemuCapsFlagsString(qemuCapsPtr caps);

179
const char *qemuCapsGetBinary(qemuCapsPtr caps);
180 181 182
const char *qemuCapsGetArch(qemuCapsPtr caps);
unsigned int qemuCapsGetVersion(qemuCapsPtr caps);
unsigned int qemuCapsGetKVMVersion(qemuCapsPtr caps);
183 184
int qemuCapsAddCPUDefinition(qemuCapsPtr caps,
                             const char *name);
185 186 187 188 189 190 191
size_t qemuCapsGetCPUDefinitions(qemuCapsPtr caps,
                                 char ***names);
size_t qemuCapsGetMachineTypes(qemuCapsPtr caps,
                               char ***names);
const char *qemuCapsGetCanonicalMachine(qemuCapsPtr caps,
                                        const char *name);

192 193 194 195
int qemuCapsGetMachineTypesCaps(qemuCapsPtr caps,
                                size_t *nmachines,
                                virCapsGuestMachinePtr **machines);

196 197
bool qemuCapsIsValid(qemuCapsPtr caps);

198 199 200 201 202 203

qemuCapsCachePtr qemuCapsCacheNew(void);
qemuCapsPtr qemuCapsCacheLookup(qemuCapsCachePtr cache, const char *binary);
qemuCapsPtr qemuCapsCacheLookupCopy(qemuCapsCachePtr cache, const char *binary);
void qemuCapsCacheFree(qemuCapsCachePtr cache);

204
virCapsPtr qemuCapsInit(qemuCapsCachePtr cache);
205 206

int qemuCapsProbeMachineTypes(const char *binary,
207
                              qemuCapsPtr caps,
208
                              virCapsGuestMachinePtr **machines,
209
                              size_t *nmachines);
210 211

int qemuCapsProbeCPUModels(const char *qemu,
212
                           qemuCapsPtr caps,
213
                           const char *arch,
214
                           size_t *count,
215 216
                           const char ***cpus);

217 218 219
int qemuCapsGetDefaultVersion(virCapsPtr caps,
                              qemuCapsCachePtr capsCache,
                              unsigned int *version);
220 221 222

int qemuCapsParseHelpStr(const char *qemu,
                         const char *str,
223
                         qemuCapsPtr caps,
224 225
                         unsigned int *version,
                         unsigned int *is_kvm,
226 227
                         unsigned int *kvm_version,
                         bool check_yajl);
E
Eric Blake 已提交
228
int qemuCapsParseDeviceStr(const char *str,
229
                           qemuCapsPtr caps);
230

231
VIR_ENUM_DECL(qemuCaps);
232 233

#endif /* __QEMU_CAPABILITIES_H__*/