1 /*
2  * qemu_capabilities.h: QEMU capabilities generation
3  *
4  * Copyright (C) 2006-2016 Red Hat, Inc.
5  * Copyright (C) 2006 Daniel P. Berrange
6  *
7  * This library is free software; you can redistribute it and/or
8  * modify it under the terms of the GNU Lesser General Public
9  * License as published by the Free Software Foundation; either
10  * version 2.1 of the License, or (at your option) any later version.
11  *
12  * This library is distributed in the hope that it will be useful,
13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
15  * Lesser General Public License for more details.
16  *
17  * You should have received a copy of the GNU Lesser General Public
18  * License along with this library.  If not, see
19  * <http://www.gnu.org/licenses/>.
20  */
21 
22 #pragma once
23 
24 #include "virobject.h"
25 #include "capabilities.h"
26 #include "vircommand.h"
27 #include "qemu_monitor.h"
28 #include "domain_capabilities.h"
29 #include "virfirmware.h"
30 #include "virfilecache.h"
31 #include "virenum.h"
32 
33 /*
34  * Internal flags to keep track of qemu command line capabilities
35  *
36  * As a general rule these flags must not be deleted / renamed, as
37  * they are serialized in string format into the runtime XML file
38  * for guests, and new libvirt needs to cope with reading flags
39  * defined by old libvirt.
40  *
41  * The exception to this rule is when we drop support for running
42  * with older QEMU versions entirely. When a flag is no longer needed
43  * we temporarily give it an X_ prefix to indicate it should no
44  * longer be used in code. Periodically we can then purge all the
45  * X_ flags and re-group what's left.
46  */
47 typedef enum { /* virQEMUCapsFlags grouping marker for syntax-check */
48     /* 0 */
49     X_QEMU_CAPS_VNC_COLON, /* VNC takes or address + display */
50     X_QEMU_CAPS_NO_REBOOT, /* Is the -no-reboot flag available */
51     X_QEMU_CAPS_DRIVE, /* Is the new -drive arg available */
52     X_QEMU_CAPS_DRIVE_BOOT, /* Does -drive support boot=on */
53     X_QEMU_CAPS_NAME, /* Is the -name flag available */
54 
55     /* 5 */
56     X_QEMU_CAPS_UUID, /* Is the -uuid flag available */
57     X_QEMU_CAPS_DOMID, /* Xenner: -domid flag available */
58     X_QEMU_CAPS_VNET_HDR,
59     X_QEMU_CAPS_MIGRATE_KVM_STDIO, /* avoid kvm tcp migration bug */
60     X_QEMU_CAPS_MIGRATE_QEMU_TCP, /* have qemu tcp migration */
61 
62     /* 10 */
63     X_QEMU_CAPS_MIGRATE_QEMU_EXEC, /* have qemu exec migration */
64     X_QEMU_CAPS_DRIVE_CACHE_V2, /* cache= flag wanting new v2 values */
65     QEMU_CAPS_KVM, /* Whether KVM is usable / was used during probing */
66     X_QEMU_CAPS_DRIVE_FORMAT, /* Is -drive format= avail */
67     X_QEMU_CAPS_VGA, /* Is -vga avail */
68 
69     /* 15 */
70     X_QEMU_CAPS_0_10, /* features added in qemu-0.10.0 or later */
71     X_QEMU_CAPS_PCIDEVICE, /* PCI device assignment supported */
72     X_QEMU_CAPS_MEM_PATH, /* mmap'ped guest backing supported */
73     X_QEMU_CAPS_DRIVE_SERIAL, /* -driver serial=  available */
74     X_QEMU_CAPS_XEN_DOMID, /* -xen-domid */
75 
76     /* 20 */
77     X_QEMU_CAPS_MIGRATE_QEMU_UNIX, /* qemu migration via unix sockets */
78     X_QEMU_CAPS_CHARDEV, /* Is the new -chardev arg available */
79     X_QEMU_CAPS_ENABLE_KVM, /* -enable-kvm flag */
80     X_QEMU_CAPS_MONITOR_JSON, /* JSON mode for monitor */
81     X_QEMU_CAPS_BALLOON, /* -balloon available */
82 
83     /* 25 */
84     X_QEMU_CAPS_DEVICE, /* Is the -device arg available */
85     QEMU_CAPS_SDL, /* support for SDL graphics is compiled into qemu */
86     X_QEMU_CAPS_SMP_TOPOLOGY, /* -smp has sockets/cores/threads */
87     X_QEMU_CAPS_NETDEV, /* -netdev flag & netdev_add/remove */
88     X_QEMU_CAPS_RTC, /* The -rtc flag for clock options */
89 
90     /* 30 */
91     X_QEMU_CAPS_VHOST_NET, /* vhost-net support available */
92     X_QEMU_CAPS_RTC_TD_HACK, /* -rtc-td-hack available */
93     QEMU_CAPS_NO_HPET, /* -no-hpet flag is supported */
94     X_QEMU_CAPS_NO_KVM_PIT, /* -no-kvm-pit-reinjection supported */
95     X_QEMU_CAPS_TDF, /* -tdf flag (user-mode pit catchup) */
96 
97     /* 35 */
98     X_QEMU_CAPS_PCI_CONFIGFD, /* pci-assign.configfd */
99     X_QEMU_CAPS_NODEFCONFIG, /* -nodefconfig */
100     X_QEMU_CAPS_BOOT_MENU, /* -boot menu=on support */
101     X_QEMU_CAPS_FSDEV, /* -fstype filesystem passthrough */
102     X_QEMU_CAPS_NESTING, /* -enable-nesting (SVM/VMX) */
103 
104     /* 40 */
105     X_QEMU_CAPS_NAME_PROCESS, /* Is -name process= available */
106     X_QEMU_CAPS_DRIVE_READONLY, /* -drive readonly=on|off */
107     X_QEMU_CAPS_SMBIOS_TYPE, /* Is -smbios type= available */
108     X_QEMU_CAPS_VGA_QXL, /* The 'qxl' arg for '-vga' */
109     QEMU_CAPS_SPICE, /* Is -spice avail */
110 
111     /* 45 */
112     X_QEMU_CAPS_VGA_NONE, /* The 'none' arg for '-vga' */
113     X_QEMU_CAPS_MIGRATE_QEMU_FD, /* -incoming fd:n */
114     X_QEMU_CAPS_BOOTINDEX, /* -device bootindex property */
115     QEMU_CAPS_HDA_DUPLEX, /* -device hda-duplex */
116     X_QEMU_CAPS_DRIVE_AIO, /* -drive aio= supported */
117 
118     /* 50 */
119     X_QEMU_CAPS_PCI_MULTIBUS, /* bus=pci.0 vs bus=pci */
120     X_QEMU_CAPS_PCI_BOOTINDEX, /* pci-assign.bootindex */
121     QEMU_CAPS_CCID_EMULATED, /* -device ccid-card-emulated */
122     QEMU_CAPS_CCID_PASSTHRU, /* -device ccid-card-passthru */
123     X_QEMU_CAPS_CHARDEV_SPICEVMC, /* newer -chardev spicevmc */
124 
125     /* 55 */
126     X_QEMU_CAPS_DEVICE_SPICEVMC, /* older -device spicevmc */
127     QEMU_CAPS_VIRTIO_TX_ALG, /* -device virtio-net-pci,tx=string */
128     X_QEMU_CAPS_DEVICE_QXL_VGA, /* primary qxl device named qxl-vga? */
129     X_QEMU_CAPS_PCI_MULTIFUNCTION, /* -device multifunction=on|off */
130     X_QEMU_CAPS_VIRTIO_IOEVENTFD, /* virtio-{net|blk}-pci.ioeventfd=on */
131 
132     /* 60 */
133     X_QEMU_CAPS_SGA, /* Serial Graphics Adapter */
134     X_QEMU_CAPS_VIRTIO_BLK_EVENT_IDX, /* virtio-blk-pci.event_idx */
135     X_QEMU_CAPS_VIRTIO_NET_EVENT_IDX, /* virtio-net-pci.event_idx */
136     X_QEMU_CAPS_DRIVE_CACHE_DIRECTSYNC, /* Is cache=directsync supported? */
137     QEMU_CAPS_PIIX3_USB_UHCI, /* -device piix3-usb-uhci */
138 
139     /* 65 */
140     QEMU_CAPS_PIIX4_USB_UHCI, /* -device piix4-usb-uhci */
141     QEMU_CAPS_USB_EHCI, /* -device usb-ehci */
142     QEMU_CAPS_ICH9_USB_EHCI1, /* -device ich9-usb-ehci1 and friends */
143     QEMU_CAPS_VT82C686B_USB_UHCI, /* -device vt82c686b-usb-uhci */
144     QEMU_CAPS_PCI_OHCI, /* -device pci-ohci */
145 
146     /* 70 */
147     QEMU_CAPS_USB_REDIR, /* -device usb-redir */
148     QEMU_CAPS_USB_HUB, /* -device usb-hub */
149     X_QEMU_CAPS_NO_SHUTDOWN, /* usable -no-shutdown */
150     X_QEMU_CAPS_DRIVE_CACHE_UNSAFE, /* Is cache=unsafe supported? */
151     X_QEMU_CAPS_PCI_ROMBAR, /* -device rombar=0|1 */
152 
153     /* 75 */
154     QEMU_CAPS_ICH9_AHCI, /* -device ich9-ahci */
155     QEMU_CAPS_NO_ACPI, /* -no-acpi */
156     X_QEMU_CAPS_FSDEV_READONLY, /* -fsdev readonly supported */
157     QEMU_CAPS_VIRTIO_BLK_SCSI, /* virtio-blk-pci.scsi */
158     X_QEMU_CAPS_VIRTIO_BLK_SG_IO, /* SG_IO commands */
159 
160     /* 80 */
161     X_QEMU_CAPS_DRIVE_COPY_ON_READ, /* -drive copy-on-read */
162     X_QEMU_CAPS_CPU_HOST, /* support for -cpu host */
163     X_QEMU_CAPS_FSDEV_WRITEOUT, /* -fsdev writeout supported */
164     X_QEMU_CAPS_DRIVE_IOTUNE, /* -drive bps= and friends */
165     X_QEMU_CAPS_WAKEUP, /* system_wakeup monitor command */
166 
167     /* 85 */
168     QEMU_CAPS_SCSI_DISK_CHANNEL, /* Is scsi-disk.channel available? */
169     QEMU_CAPS_SCSI_BLOCK, /* -device scsi-block */
170     X_QEMU_CAPS_TRANSACTION, /* transaction monitor command */
171     X_QEMU_CAPS_BLOCKJOB_SYNC, /* old block_job_cancel, block_stream */
172     X_QEMU_CAPS_BLOCKJOB_ASYNC, /* new block-job-cancel, block-stream */
173 
174     /* 90 */
175     X_QEMU_CAPS_SCSI_CD, /* -device scsi-cd */
176     X_QEMU_CAPS_IDE_CD, /* -device ide-cd */
177     X_QEMU_CAPS_NO_USER_CONFIG, /* -no-user-config */
178     QEMU_CAPS_HDA_MICRO, /* -device hda-micro */
179     QEMU_CAPS_DUMP_GUEST_MEMORY, /* dump-guest-memory command */
180 
181     /* 95 */
182     QEMU_CAPS_NEC_USB_XHCI, /* -device nec-usb-xhci */
183     X_QEMU_CAPS_VIRTIO_S390, /* -device virtio-*-s390 */
184     X_QEMU_CAPS_BALLOON_EVENT, /* Async event for balloon changes */
185     X_QEMU_CAPS_NETDEV_BRIDGE, /* bridge helper support */
186     QEMU_CAPS_SCSI_LSI, /* -device lsi */
187 
188     /* 100 */
189     QEMU_CAPS_VIRTIO_SCSI, /* -device virtio-scsi-* */
190     QEMU_CAPS_BLOCKIO, /* -device ...logical_block_size & co */
191     QEMU_CAPS_PIIX_DISABLE_S3, /* -M pc S3 BIOS Advertisement on/off */
192     QEMU_CAPS_PIIX_DISABLE_S4, /* -M pc S4 BIOS Advertisement on/off */
193     QEMU_CAPS_USB_REDIR_FILTER, /* usb-redir.filter */
194 
195     /* 105 */
196     QEMU_CAPS_IDE_DRIVE_WWN, /* Is ide-drive.wwn available? */
197     QEMU_CAPS_SCSI_DISK_WWN, /* Is scsi-disk.wwn available? */
198     QEMU_CAPS_SECCOMP_SANDBOX, /* -sandbox */
199     X_QEMU_CAPS_REBOOT_TIMEOUT, /* -boot reboot-timeout */
200     X_QEMU_CAPS_DUMP_GUEST_CORE, /* dump-guest-core-parameter */
201 
202     /* 110 */
203     X_QEMU_CAPS_SEAMLESS_MIGRATION, /* seamless-migration for SPICE */
204     X_QEMU_CAPS_BLOCK_COMMIT, /* block-commit */
205     QEMU_CAPS_VNC, /* Is -vnc available? */
206     X_QEMU_CAPS_DRIVE_MIRROR, /* drive-mirror monitor command */
207     X_QEMU_CAPS_USB_REDIR_BOOTINDEX, /* usb-redir.bootindex */
208 
209     /* 115 */
210     X_QEMU_CAPS_USB_HOST_BOOTINDEX, /* usb-host.bootindex */
211     X_QEMU_CAPS_DISK_SNAPSHOT, /* blockdev-snapshot-sync command */
212     QEMU_CAPS_DEVICE_QXL, /* -device qxl */
213     QEMU_CAPS_DEVICE_VGA, /* -device VGA */
214     QEMU_CAPS_DEVICE_CIRRUS_VGA, /* -device cirrus-vga */
215 
216     /* 120 */
217     QEMU_CAPS_DEVICE_VMWARE_SVGA, /* -device vmware-svga */
218     X_QEMU_CAPS_DEVICE_VIDEO_PRIMARY, /* -device safe for primary video device */
219     QEMU_CAPS_DEVICE_SCLPCONSOLE, /* -device sclpconsole */
220     QEMU_CAPS_DEVICE_USB_SERIAL, /* -device usb-serial */
221     X_QEMU_CAPS_DEVICE_USB_NET, /* -device usb-net */
222 
223     /* 125 */
224     X_QEMU_CAPS_ADD_FD, /* -add-fd */
225     QEMU_CAPS_NBD_SERVER, /* nbd-server-start QMP command */
226     QEMU_CAPS_DEVICE_VIRTIO_RNG, /* virtio-rng device */
227     QEMU_CAPS_OBJECT_RNG_RANDOM, /* the rng-random backend for virtio rng */
228     QEMU_CAPS_OBJECT_RNG_EGD, /* EGD protocol daemon for rng */
229 
230     /* 130 */
231     QEMU_CAPS_VIRTIO_CCW, /* -device virtio-*-ccw */
232     X_QEMU_CAPS_DTB, /* -dtb file */
233     QEMU_CAPS_SCSI_MEGASAS, /* -device megasas */
234     X_QEMU_CAPS_IPV6_MIGRATION, /* -incoming [::] */
235     X_QEMU_CAPS_MACHINE_OPT, /* -machine xxxx */
236 
237     /* 135 */
238     X_QEMU_CAPS_MACHINE_USB_OPT, /* -machine xxx,usb=on/off */
239     QEMU_CAPS_DEVICE_TPM_PASSTHROUGH, /* -tpmdev passthrough */
240     QEMU_CAPS_DEVICE_TPM_TIS, /* -device tpm_tis */
241     QEMU_CAPS_DEVICE_NVRAM, /* -global spapr-nvram.reg=xxxx */
242     QEMU_CAPS_DEVICE_PCI_BRIDGE, /* -device pci-bridge */
243 
244     /* 140 */
245     QEMU_CAPS_DEVICE_VFIO_PCI, /* -device vfio-pci */
246     X_QEMU_CAPS_VFIO_PCI_BOOTINDEX, /* bootindex param for vfio-pci device */
247     X_QEMU_CAPS_DEVICE_SCSI_GENERIC, /* -device scsi-generic */
248     X_QEMU_CAPS_DEVICE_SCSI_GENERIC_BOOTINDEX, /* -device scsi-generic.bootindex */
249     X_QEMU_CAPS_MEM_MERGE, /* -machine mem-merge */
250 
251     /* 145 */
252     X_QEMU_CAPS_VNC_WEBSOCKET, /* -vnc x:y,websocket */
253     QEMU_CAPS_DRIVE_DISCARD, /* -drive discard=off(ignore)|on(unmap) */
254     X_QEMU_CAPS_REALTIME_MLOCK, /* -realtime mlock=on|off */
255     X_QEMU_CAPS_VNC_SHARE_POLICY, /* set display sharing policy */
256     X_QEMU_CAPS_DEVICE_DEL_EVENT, /* DEVICE_DELETED event */
257 
258     /* 150 */
259     QEMU_CAPS_DEVICE_DMI_TO_PCI_BRIDGE, /* -device i82801b11-bridge */
260     QEMU_CAPS_I440FX_PCI_HOLE64_SIZE, /* i440FX-pcihost.pci-hole64-size */
261     QEMU_CAPS_Q35_PCI_HOLE64_SIZE, /* q35-pcihost.pci-hole64-size */
262     QEMU_CAPS_DEVICE_USB_STORAGE, /* -device usb-storage */
263     QEMU_CAPS_USB_STORAGE_REMOVABLE, /* usb-storage.removable */
264 
265     /* 155 */
266     QEMU_CAPS_DEVICE_VIRTIO_MMIO, /* -device virtio-mmio */
267     QEMU_CAPS_DEVICE_ICH9_INTEL_HDA, /* -device ich9-intel-hda */
268     QEMU_CAPS_KVM_PIT_TICK_POLICY, /* kvm-pit.lost_tick_policy */
269     X_QEMU_CAPS_BOOT_STRICT, /* -boot strict */
270     QEMU_CAPS_DEVICE_PANIC, /* -device pvpanic */
271 
272     /* 160 */
273     QEMU_CAPS_ENABLE_FIPS, /* -enable-fips */
274     X_QEMU_CAPS_SPICE_FILE_XFER_DISABLE, /* -spice disable-agent-file-xfer */
275     X_QEMU_CAPS_CHARDEV_SPICEPORT, /* -chardev spiceport */
276     QEMU_CAPS_DEVICE_USB_KBD, /* -device usb-kbd */
277     X_QEMU_CAPS_HOST_PCI_MULTIDOMAIN, /* support domain > 0 in host pci address */
278 
279     /* 165 */
280     X_QEMU_CAPS_MSG_TIMESTAMP, /* -msg timestamp */
281     QEMU_CAPS_ACTIVE_COMMIT, /* block-commit works without 'top' */
282     QEMU_CAPS_CHANGE_BACKING_FILE, /* change name of backing file in metadata */
283     QEMU_CAPS_OBJECT_MEMORY_RAM, /* -object memory-backend-ram */
284     QEMU_CAPS_NUMA, /* newer -numa handling with disjoint cpu ranges */
285 
286     /* 170 */
287     QEMU_CAPS_OBJECT_MEMORY_FILE, /* -object memory-backend-file */
288     QEMU_CAPS_OBJECT_USB_AUDIO, /* usb-audio device support */
289     QEMU_CAPS_RTC_RESET_REINJECTION, /* rtc-reset-reinjection monitor command */
290     X_QEMU_CAPS_SPLASH_TIMEOUT, /* -boot splash-time */
291     QEMU_CAPS_OBJECT_IOTHREAD, /* -object iothread */
292 
293     /* 175 */
294     QEMU_CAPS_MIGRATE_RDMA, /* have rdma migration */
295     QEMU_CAPS_DEVICE_IVSHMEM, /* -device ivshmem */
296     X_QEMU_CAPS_DRIVE_IOTUNE_MAX, /* -drive bps_max= and friends */
297     QEMU_CAPS_VGA_VGAMEM, /* -device VGA.vgamem_mb */
298     QEMU_CAPS_VMWARE_SVGA_VGAMEM, /* -device vmware-svga.vgamem_mb */
299 
300     /* 180 */
301     QEMU_CAPS_QXL_VGAMEM, /* -device qxl.vgamem_mb */
302     X_QEMU_CAPS_QXL_VGA_VGAMEM, /* -device qxl-vga.vgamem_mb */
303     QEMU_CAPS_DEVICE_PC_DIMM, /* pc-dimm device */
304     QEMU_CAPS_MACHINE_VMPORT_OPT, /* -machine xxx,vmport=on/off/auto */
305     QEMU_CAPS_AES_KEY_WRAP, /* -machine aes_key_wrap */
306 
307     /* 185 */
308     QEMU_CAPS_DEA_KEY_WRAP, /* -machine dea_key_wrap */
309     QEMU_CAPS_DEVICE_PCI_SERIAL, /* -device pci-serial */
310     QEMU_CAPS_CPU_AARCH64_OFF, /* -cpu ...,aarch64=off */
311     X_QEMU_CAPS_VHOSTUSER_MULTIQUEUE, /* vhost-user with -netdev queues= */
312     QEMU_CAPS_MIGRATION_EVENT, /* MIGRATION event */
313 
314     /* 190 */
315     QEMU_CAPS_OBJECT_GPEX, /* have generic PCI host controller */
316     QEMU_CAPS_DEVICE_IOH3420, /* -device ioh3420 */
317     QEMU_CAPS_DEVICE_X3130_UPSTREAM, /* -device x3130-upstream */
318     QEMU_CAPS_DEVICE_XIO3130_DOWNSTREAM, /* -device xio3130-downstream */
319     QEMU_CAPS_DEVICE_RTL8139, /* -device rtl8139 */
320 
321     /* 195 */
322     QEMU_CAPS_DEVICE_E1000, /* -device e1000 */
323     QEMU_CAPS_DEVICE_VIRTIO_NET, /* -device virtio-net-* */
324     QEMU_CAPS_MACH_VIRT_GIC_VERSION, /* -machine virt,gic-version */
325     QEMU_CAPS_INCOMING_DEFER, /* -incoming defer and migrate_incoming */
326     QEMU_CAPS_DEVICE_VIRTIO_GPU, /* -device virtio-gpu-* */
327 
328     /* 200 */
329     QEMU_CAPS_VIRTIO_GPU_VIRGL, /* -device virtio-gpu-*.virgl */
330     QEMU_CAPS_VIRTIO_KEYBOARD, /* -device virtio-keyboard-{device,pci} */
331     QEMU_CAPS_VIRTIO_MOUSE, /* -device virtio-mouse-{device,pci} */
332     QEMU_CAPS_VIRTIO_TABLET, /* -device virtio-tablet-{device,pci} */
333     QEMU_CAPS_VIRTIO_INPUT_HOST, /* -device virtio-input-host-{device,pci} */
334 
335     /* 205 */
336     QEMU_CAPS_CHARDEV_FILE_APPEND, /* -chardev file,append=on|off */
337     QEMU_CAPS_ICH9_DISABLE_S3, /* -M q35 S3 BIOS Advertisement on/off */
338     QEMU_CAPS_ICH9_DISABLE_S4, /* -M q35 S4 BIOS Advertisement on/off */
339     QEMU_CAPS_VSERPORT_CHANGE, /* VSERPORT_CHANGE event */
340     QEMU_CAPS_VIRTIO_BALLOON_AUTODEFLATE, /* virtio-balloon-{device,pci,ccw}.
341                                            * deflate-on-oom */
342 
343     /* 210 */
344     QEMU_CAPS_SCSI_MPTSAS1068, /* -device mptsas1068 */
345     QEMU_CAPS_SPICE_GL, /* -spice gl */
346     QEMU_CAPS_QXL_VRAM64, /* -device qxl.vram64_size_mb */
347     X_QEMU_CAPS_QXL_VGA_VRAM64, /* -device qxl-vga.vram64_size_mb */
348     QEMU_CAPS_CHARDEV_LOGFILE, /* -chardev logfile=xxxx */
349 
350     /* 215 */
351     X_QEMU_CAPS_NAME_DEBUG_THREADS, /* Is -name debug-threads= available */
352     X_QEMU_CAPS_OBJECT_SECRET, /* -object secret */
353     QEMU_CAPS_DEVICE_PXB, /* -device pxb */
354     QEMU_CAPS_DEVICE_PXB_PCIE, /* -device pxb-pcie */
355     X_QEMU_CAPS_DEVICE_TRAY_MOVED, /* DEVICE_TRAY_MOVED event */
356 
357     /* 220 */
358     QEMU_CAPS_NEC_USB_XHCI_PORTS, /* -device nec-usb-xhci.p3 ports setting */
359     QEMU_CAPS_VIRTIO_SCSI_IOTHREAD, /* virtio-scsi-{pci,ccw}.iothread */
360     X_QEMU_CAPS_NAME_GUEST, /* -name guest= */
361     QEMU_CAPS_QXL_MAX_OUTPUTS, /* -device qxl,max-outputs= */
362     X_QEMU_CAPS_QXL_VGA_MAX_OUTPUTS, /* -device qxl-vga,max-outputs= */
363 
364     /* 225 */
365     X_QEMU_CAPS_SPICE_UNIX, /* -spice unix */
366     QEMU_CAPS_DRIVE_DETECT_ZEROES, /* -drive detect-zeroes= */
367     X_QEMU_CAPS_OBJECT_TLS_CREDS_X509, /* -object tls-creds-x509 */
368     X_QEMU_CAPS_DISPLAY, /* -display */
369     QEMU_CAPS_DEVICE_INTEL_IOMMU, /* -device intel-iommu */
370 
371     /* 230 */
372     X_QEMU_CAPS_MACHINE_SMM_OPT, /* -machine xxx,smm=on/off/auto */
373     QEMU_CAPS_VIRTIO_PCI_DISABLE_LEGACY, /* virtio-*pci.disable-legacy */
374     QEMU_CAPS_QUERY_HOTPLUGGABLE_CPUS, /* qmp command query-hotpluggable-cpus */
375     QEMU_CAPS_VIRTIO_NET_RX_QUEUE_SIZE, /* virtio-net-*.rx_queue_size */
376     X_QEMU_CAPS_MACHINE_IOMMU, /* -machine iommu=on */
377 
378     /* 235 */
379     QEMU_CAPS_DEVICE_VIRTIO_VGA, /* -device virtio-vga */
380     X_QEMU_CAPS_DRIVE_IOTUNE_MAX_LENGTH, /* -drive bps_max_length = and friends */
381     QEMU_CAPS_DEVICE_IVSHMEM_PLAIN, /* -device ivshmem-plain */
382     QEMU_CAPS_DEVICE_IVSHMEM_DOORBELL, /* -device ivshmem-doorbell */
383     X_QEMU_CAPS_QUERY_QMP_SCHEMA, /* query-qmp-schema command */
384 
385     /* 240 */
386     QEMU_CAPS_GLUSTER_DEBUG_LEVEL, /* -drive gluster.debug_level={0..9} */
387     QEMU_CAPS_DEVICE_VHOST_SCSI, /* -device vhost-scsi-{ccw,pci} */
388     X_QEMU_CAPS_DRIVE_IOTUNE_GROUP, /* -drive throttling.group=<name> */
389     QEMU_CAPS_QUERY_CPU_MODEL_EXPANSION, /* qmp query-cpu-model-expansion */
390     QEMU_CAPS_VIRTIO_NET_HOST_MTU, /* virtio-net-*.host_mtu */
391 
392     /* 245 */
393     QEMU_CAPS_SPICE_RENDERNODE, /* -spice rendernode */
394     QEMU_CAPS_DEVICE_NVDIMM, /* -device nvdimm */
395     QEMU_CAPS_DEVICE_PCIE_ROOT_PORT, /* -device pcie-root-port */
396     QEMU_CAPS_QUERY_CPU_DEFINITIONS, /* qmp query-cpu-definitions */
397     QEMU_CAPS_BLOCK_WRITE_THRESHOLD, /* BLOCK_WRITE_THRESHOLD event */
398 
399     /* 250 */
400     QEMU_CAPS_QUERY_NAMED_BLOCK_NODES, /* qmp query-named-block-nodes */
401     QEMU_CAPS_CPU_CACHE, /* -cpu supports host-cache-info and l3-cache properties */
402     QEMU_CAPS_DEVICE_QEMU_XHCI, /* -device qemu-xhci */
403     X_QEMU_CAPS_MACHINE_KERNEL_IRQCHIP, /* -machine kernel_irqchip */
404     X_QEMU_CAPS_MACHINE_KERNEL_IRQCHIP_SPLIT, /* -machine kernel_irqchip=split */
405 
406     /* 255 */
407     QEMU_CAPS_INTEL_IOMMU_INTREMAP, /* intel-iommu.intremap */
408     QEMU_CAPS_INTEL_IOMMU_CACHING_MODE, /* intel-iommu.caching-mode */
409     QEMU_CAPS_INTEL_IOMMU_EIM, /* intel-iommu.eim */
410     QEMU_CAPS_INTEL_IOMMU_DEVICE_IOTLB, /* intel-iommu.device-iotlb */
411     X_QEMU_CAPS_VIRTIO_PCI_IOMMU_PLATFORM, /* virtio-*-pci.iommu_platform */
412 
413     /* 260 */
414     X_QEMU_CAPS_VIRTIO_PCI_ATS, /* virtio-*-pci.ats */
415     QEMU_CAPS_LOADPARM, /* -machine loadparm */
416     QEMU_CAPS_DEVICE_SPAPR_PCI_HOST_BRIDGE, /* -device spapr-pci-host-bridge */
417     QEMU_CAPS_SPAPR_PCI_HOST_BRIDGE_NUMA_NODE, /* spapr-pci-host-bridge.numa_node= */
418     X_QEMU_CAPS_VNC_MULTI_SERVERS, /* -vnc vnc=unix:/path */
419 
420     /* 265 */
421     QEMU_CAPS_VIRTIO_NET_TX_QUEUE_SIZE, /* virtio-net-*.tx_queue_size */
422     QEMU_CAPS_CHARDEV_RECONNECT, /* -chardev reconnect */
423     QEMU_CAPS_VIRTIO_GPU_MAX_OUTPUTS, /* -device virtio-(vga|gpu-*),max-outputs= */
424     QEMU_CAPS_VXHS, /* -drive file.driver=vxhs via query-qmp-schema */
425     QEMU_CAPS_VIRTIO_BLK_NUM_QUEUES, /* virtio-blk-*.num-queues */
426 
427     /* 270 */
428     QEMU_CAPS_MACHINE_PSERIES_RESIZE_HPT, /* -machine pseries,resize-hpt */
429     QEMU_CAPS_DEVICE_VMCOREINFO, /* -device vmcoreinfo */
430     QEMU_CAPS_DEVICE_SPAPR_VTY, /* -device spapr-vty */
431     QEMU_CAPS_DEVICE_SCLPLMCONSOLE, /* -device sclplmconsole */
432     X_QEMU_CAPS_NUMA_DIST, /* -numa dist */
433 
434     /* 275 */
435     QEMU_CAPS_DISK_SHARE_RW, /* share-rw=on for concurrent disk access */
436     X_QEMU_CAPS_ISCSI_PASSWORD_SECRET, /* -drive file.driver=iscsi,...,password-secret= */
437     QEMU_CAPS_DEVICE_ISA_SERIAL, /* -device isa-serial */
438     QEMU_CAPS_DEVICE_PL011, /* -device pl011 (not user-instantiable) */
439     QEMU_CAPS_MACHINE_PSERIES_MAX_CPU_COMPAT, /* -machine pseries,max-cpu-compat= */
440 
441     /* 280 */
442     QEMU_CAPS_DUMP_COMPLETED, /* DUMP_COMPLETED event */
443     QEMU_CAPS_DEVICE_VIRTIO_GPU_CCW, /* -device virtio-gpu-ccw */
444     QEMU_CAPS_DEVICE_VIRTIO_KEYBOARD_CCW, /* -device virtio-keyboard-ccw */
445     QEMU_CAPS_DEVICE_VIRTIO_MOUSE_CCW, /* -device virtio-mouse-ccw */
446     QEMU_CAPS_DEVICE_VIRTIO_TABLET_CCW, /* -device virtio-tablet-ccw */
447 
448     /* 285 */
449     QEMU_CAPS_QCOW2_LUKS, /* qcow2 format support LUKS encryption */
450     QEMU_CAPS_DEVICE_PCIE_PCI_BRIDGE, /* -device pcie-pci-bridge */
451     X_QEMU_CAPS_SECCOMP_BLACKLIST, /* -sandbox.elevateprivileges */
452     QEMU_CAPS_QUERY_CPUS_FAST, /* query-cpus-fast command */
453     QEMU_CAPS_DISK_WRITE_CACHE, /* qemu block frontends support write-cache param */
454 
455     /* 290 */
456     QEMU_CAPS_NBD_TLS, /* NBD server supports TLS transport */
457     QEMU_CAPS_DEVICE_TPM_CRB, /* -device tpm-crb */
458     QEMU_CAPS_PR_MANAGER_HELPER, /* -object pr-manager-helper */
459     QEMU_CAPS_QOM_LIST_PROPERTIES, /* qom-list-properties monitor command */
460     QEMU_CAPS_OBJECT_MEMORY_FILE_DISCARD, /* -object memory-backend-file,discard-data */
461 
462     /* 295 */
463     QEMU_CAPS_CCW, /* -device virtual-css-bridge */
464     QEMU_CAPS_CCW_CSSID_UNRESTRICTED, /* virtual-css-bridge.cssid-unrestricted= */
465     QEMU_CAPS_DEVICE_VFIO_CCW, /* -device vfio-ccw */
466     X_QEMU_CAPS_SDL_GL, /* -sdl gl */
467     QEMU_CAPS_SCREENDUMP_DEVICE, /* screendump command accepts device & head */
468 
469     /* 300 */
470     QEMU_CAPS_HDA_OUTPUT, /* -device hda-output */
471     QEMU_CAPS_BLOCKDEV_DEL, /* blockdev-del is supported */
472     QEMU_CAPS_DEVICE_VMGENID, /* -device vmgenid */
473     QEMU_CAPS_DEVICE_VHOST_VSOCK, /* -device vhost-vsock-* */
474     QEMU_CAPS_CHARDEV_FD_PASS_COMMANDLINE, /* Passing pre-opened FDs for chardevs on commandline */
475 
476     /* 305 */
477     QEMU_CAPS_DEVICE_TPM_EMULATOR, /* -tpmdev emulator */
478     QEMU_CAPS_DEVICE_MCH, /* Northbridge in q35 machine types */
479     QEMU_CAPS_MCH_EXTENDED_TSEG_MBYTES, /* -global mch.extended-tseg-mbytes */
480     QEMU_CAPS_SEV_GUEST, /* -object sev-guest,... */
481     QEMU_CAPS_MACHINE_PSERIES_CAP_HPT_MAX_PAGE_SIZE, /* -machine pseries.cap-hpt-max-page-size */
482 
483     /* 310 */
484     QEMU_CAPS_MACHINE_PSERIES_CAP_HTM, /* -machine pseries.cap-htm */
485     QEMU_CAPS_USB_STORAGE_WERROR, /* -device usb-storage,werror=..,rerror=.. */
486     QEMU_CAPS_EGL_HEADLESS, /* -display egl-headless */
487     QEMU_CAPS_VFIO_PCI_DISPLAY, /* -device vfio-pci.display */
488     QEMU_CAPS_BLOCKDEV, /* -blockdev and blockdev-add are supported */
489 
490     /* 315 */
491     QEMU_CAPS_DEVICE_VFIO_AP, /* -device vfio-ap */
492     QEMU_CAPS_DEVICE_ZPCI, /* -device zpci */
493     QEMU_CAPS_OBJECT_MEMORY_MEMFD, /* -object memory-backend-memfd */
494     QEMU_CAPS_OBJECT_MEMORY_MEMFD_HUGETLB, /* -object memory-backend-memfd.hugetlb */
495     QEMU_CAPS_IOTHREAD_POLLING, /* -object iothread.poll-max-ns */
496 
497     /* 320 */
498     QEMU_CAPS_MACHINE_PSERIES_CAP_NESTED_HV, /* -machine pseries.cap-nested-hv */
499     QEMU_CAPS_EGL_HEADLESS_RENDERNODE, /* -display egl-headless,rendernode= */
500     QEMU_CAPS_OBJECT_MEMORY_FILE_ALIGN, /* -object memory-backend-file,align= */
501     QEMU_CAPS_OBJECT_MEMORY_FILE_PMEM, /* -object memory-backend-file,pmem= */
502     QEMU_CAPS_DEVICE_NVDIMM_UNARMED, /* -device nvdimm,unarmed= */
503 
504     /* 325 */
505     QEMU_CAPS_SCSI_DISK_DEVICE_ID, /* 'device_id' property of scsi disk */
506     QEMU_CAPS_VIRTIO_PCI_TRANSITIONAL, /* virtio *-pci-{non-}transitional devices */
507     QEMU_CAPS_OVERCOMMIT, /* -overcommit */
508     QEMU_CAPS_QUERY_CURRENT_MACHINE, /* query-current-machine command */
509     QEMU_CAPS_MACHINE_VIRT_IOMMU, /* -machine virt,iommu */
510 
511     /* 330 */
512     QEMU_CAPS_BITMAP_MERGE, /* block-dirty-bitmap-merge */
513     QEMU_CAPS_NBD_BITMAP, /* nbd-server-add supports bitmap */
514     QEMU_CAPS_X86_MAX_CPU, /* max-x86_64-cpu type exists */
515     QEMU_CAPS_CPU_UNAVAILABLE_FEATURES, /* "unavailable-features" CPU property */
516     QEMU_CAPS_CANONICAL_CPU_FEATURES, /* avoid CPU feature aliases */
517 
518     /* 335 */
519     QEMU_CAPS_DEVICE_BOCHS_DISPLAY, /* -device bochs-display */
520     QEMU_CAPS_MIGRATION_FILE_DROP_CACHE, /* migration with disk cache on is safe for type='file' disks */
521     QEMU_CAPS_DBUS_VMSTATE, /* -object dbus-vmstate */
522     QEMU_CAPS_DEVICE_VHOST_USER_GPU, /* -device vhost-user-gpu */
523     QEMU_CAPS_DEVICE_VHOST_USER_VGA, /* -device vhost-user-vga */
524 
525     /* 340 */
526     QEMU_CAPS_INCREMENTAL_BACKUP, /* incremental backup is supported */
527     QEMU_CAPS_QUERY_CPU_MODEL_BASELINE, /* qmp query-cpu-model-baseline */
528     QEMU_CAPS_QUERY_CPU_MODEL_COMPARISON, /* qmp query-cpu-model-comparison */
529     QEMU_CAPS_DEVICE_RAMFB, /* -device ramfb */
530     QEMU_CAPS_MACHINE_PSERIES_CAP_CCF_ASSIST, /* -machine pseries.cap-ccf-assist */
531 
532     /* 345 */
533     QEMU_CAPS_ARM_MAX_CPU, /* max-arm-cpu type exists */
534     QEMU_CAPS_BLOCK_FILE_AUTO_READONLY_DYNAMIC, /* the auto-read-only property of block backends for files is dynamic */
535     QEMU_CAPS_SAVEVM_MONITOR_NODES, /* 'savevm' handles monitor-owned nodes properly */
536     QEMU_CAPS_DRIVE_NVME, /* -drive file.driver=nvme */
537     QEMU_CAPS_SMP_DIES, /*  -smp dies= */
538 
539     /* 350 */
540     QEMU_CAPS_DEVICE_I8042, /* PS/2 controller */
541     QEMU_CAPS_OBJECT_RNG_BUILTIN, /* -object rng-builtin */
542     QEMU_CAPS_VIRTIO_NET_FAILOVER, /* virtio-net-*.failover */
543     QEMU_CAPS_DEVICE_TPM_SPAPR, /* -device tpm-spapr */
544     QEMU_CAPS_CPU_KVM_NO_ADJVTIME, /* cpu.kvm-no-adjvtime */
545 
546     /* 355 */
547     QEMU_CAPS_DEVICE_VHOST_USER_FS, /* -device vhost-user-fs */
548     QEMU_CAPS_QMP_QUERY_NAMED_BLOCK_NODES_FLAT, /* query-named-block-nodes supports the 'flat' option */
549     QEMU_CAPS_BLOCKDEV_SNAPSHOT_ALLOW_WRITE_ONLY, /* blockdev-snapshot has the 'allow-write-only-overlay' feature */
550     QEMU_CAPS_BLOCKDEV_REOPEN, /* 'blockdev-reopen' qmp command is supported */
551     QEMU_CAPS_STORAGE_WERROR, /* virtio-blk,scsi-hd.werror */
552 
553     /* 360 */
554     QEMU_CAPS_FSDEV_MULTIDEVS, /* fsdev.multidevs */
555     QEMU_CAPS_VIRTIO_PACKED_QUEUES, /* virtio.packed */
556     QEMU_CAPS_PCIE_ROOT_PORT_HOTPLUG, /* pcie-root-port.hotplug */
557     QEMU_CAPS_AIO_IO_URING, /* -blockdev {...,"aio":"io_uring",...} */
558     QEMU_CAPS_MACHINE_PSERIES_CAP_CFPC, /* -machine pseries.cap-cfpc */
559 
560     /* 365 */
561     QEMU_CAPS_MACHINE_PSERIES_CAP_SBBC, /* -machine pseries.cap-sbbc */
562     QEMU_CAPS_MACHINE_PSERIES_CAP_IBS, /* -machine pseries.cap-ibs */
563     QEMU_CAPS_TCG, /* QEMU does support TCG */
564     QEMU_CAPS_VIRTIO_BLK_SCSI_DEFAULT_DISABLED, /* virtio-blk-pci.scsi disabled by default */
565     QEMU_CAPS_SCSI_PVSCSI, /* -device pvscsi */
566 
567     /* 370 */
568     QEMU_CAPS_CPU_MIGRATABLE, /* -cpu ...,migratable=on|off */
569     QEMU_CAPS_QUERY_CPU_MODEL_EXPANSION_MIGRATABLE, /* query-cpu-model-expansion supports migratable:false */
570     X_QEMU_CAPS_FW_CFG, /* -fw_cfg command line option */
571     QEMU_CAPS_MIGRATION_PARAM_BANDWIDTH, /* max-bandwidth field in migrate-set-parameters */
572     QEMU_CAPS_MIGRATION_PARAM_DOWNTIME, /* downtime-limit field in migrate-set-parameters */
573 
574     /* 375 */
575     QEMU_CAPS_MIGRATION_PARAM_XBZRLE_CACHE_SIZE, /* xbzrle-cache-size field in migrate-set-parameters */
576     QEMU_CAPS_INTEL_IOMMU_AW_BITS, /* intel-iommu.aw-bits */
577     QEMU_CAPS_DEVICE_SPAPR_TPM_PROXY, /* -device spapr-tpm-proxy */
578     QEMU_CAPS_NUMA_HMAT, /* -numa hmat */
579     QEMU_CAPS_BLOCKDEV_HOSTDEV_SCSI, /* -blockdev used for (i)SCSI hostdevs */
580 
581     /* 380 */
582     QEMU_CAPS_USB_HOST_HOSTDEVICE, /* -device usb-host.hostdevice */
583     QEMU_CAPS_VIRTIO_BALLOON_FREE_PAGE_REPORTING, /*virtio balloon free-page-reporting */
584     QEMU_CAPS_BLOCK_EXPORT_ADD, /* 'block-export-add' command is supported */
585     QEMU_CAPS_NETDEV_VHOST_VDPA, /* -netdev vhost-vdpa*/
586     X_QEMU_CAPS_FSDEV_CREATEMODE, /* fsdev.createmode */
587 
588     /* 385 */
589     QEMU_CAPS_SCSI_NCR53C90, /* built-in SCSI */
590     QEMU_CAPS_SCSI_DC390, /* -device dc-390 */
591     QEMU_CAPS_SCSI_AM53C974, /* -device am53c974 */
592     QEMU_CAPS_DEVICE_VIRTIO_PMEM_PCI, /* -device virtio-pmem-pci */
593     QEMU_CAPS_VHOST_USER_FS_BOOTINDEX, /* vhost-user-fs.bootindex */
594 
595     /* 390 */
596     QEMU_CAPS_DEVICE_VHOST_USER_BLK, /* -device vhost-user-blk */
597     QEMU_CAPS_CPU_MAX, /* -cpu max */
598     QEMU_CAPS_X_USE_CANONICAL_PATH_FOR_RAMBLOCK_ID, /* -object memory-backend-file,x-use-canonical-path-for-ramblock-id= */
599     X_QEMU_CAPS_VNC_OPTS, /* -vnc uses QemuOpts parser instead of custom code */
600     QEMU_CAPS_MIGRATION_PARAM_BLOCK_BITMAP_MAPPING, /* block-bitmap-mapping in migrate-set-parameters */
601 
602     /* 395 */
603     QEMU_CAPS_VNC_POWER_CONTROL, /* -vnc power-control option */
604     QEMU_CAPS_AUDIODEV, /* -audiodev instead of QEMU_AUDIO_DRV */
605     QEMU_CAPS_BLOCKDEV_BACKUP, /* qemu supports the blockdev-backup job */
606     QEMU_CAPS_OBJECT_JSON, /* parameters for object-add are formally described */
607     QEMU_CAPS_ROTATION_RATE, /* scsi-disk / ide-drive rotation-rate prop */
608 
609     /* 400 */
610     QEMU_CAPS_COMPAT_DEPRECATED, /* -compat deprecated-(input|output) is supported */
611     QEMU_CAPS_ACPI_INDEX, /* PCI device 'acpi-index' property */
612     QEMU_CAPS_INPUT_LINUX, /* -object input-linux */
613     QEMU_CAPS_VIRTIO_GPU_GL_PCI, /* -device virtio-gpu-gl-pci */
614     QEMU_CAPS_VIRTIO_VGA_GL, /* -device virtio-vga-gl */
615 
616     /* 405 */
617     QEMU_CAPS_MACHINE_CONFIDENTAL_GUEST_SUPPORT, /* -machine confidential-guest-support */
618     QEMU_CAPS_QUERY_DISPLAY_OPTIONS, /* 'query-display-options' qmp command present */
619     QEMU_CAPS_S390_PV_GUEST, /* -object s390-pv-guest,... */
620     QEMU_CAPS_SET_ACTION, /* 'set-action' QMP command */
621     QEMU_CAPS_VIRTIO_BLK_QUEUE_SIZE, /* virtio-blk-*.queue-size */
622 
623     /* 410 */
624     QEMU_CAPS_DEVICE_VIRTIO_MEM_PCI, /* -device virtio-mem-pci */
625     QEMU_CAPS_MEMORY_BACKEND_RESERVE, /* -object memory-backend-*.reserve= */
626     QEMU_CAPS_PIIX4_ACPI_ROOT_PCI_HOTPLUG, /* -M pc PIIX4_PM.acpi-root-pci-hotplug */
627     QEMU_CAPS_NETDEV_JSON, /* -netdev accepts JSON */
628     QEMU_CAPS_CHARDEV_JSON, /* -chardev accepts JSON */
629 
630     /* 415 */
631     QEMU_CAPS_DEVICE_JSON, /* -device accepts JSON */
632     QEMU_CAPS_QUERY_DIRTY_RATE, /* accepts query-dirty-rate */
633     QEMU_CAPS_RBD_ENCRYPTION, /* Ceph RBD encryption support */
634 
635     /* 405 */
636     QEMU_CAPS_NVMM, /* whether nvmm is available */
637 
638     QEMU_CAPS_LAST /* this must always be the last item */
639 } virQEMUCapsFlags;
640 
641 typedef struct _virQEMUCaps virQEMUCaps;
642 
643 G_DEFINE_AUTOPTR_CLEANUP_FUNC(virQEMUCaps, virObjectUnref);
644 
645 virQEMUCaps *virQEMUCapsNew(void);
646 virQEMUCaps *virQEMUCapsNewBinary(const char *binary);
647 
648 void virQEMUCapsSet(virQEMUCaps *qemuCaps,
649                     virQEMUCapsFlags flag) ATTRIBUTE_NONNULL(1);
650 
651 void virQEMUCapsClear(virQEMUCaps *qemuCaps,
652                       virQEMUCapsFlags flag) ATTRIBUTE_NONNULL(1);
653 
654 bool virQEMUCapsGet(virQEMUCaps *qemuCaps,
655                     virQEMUCapsFlags flag);
656 
657 void virQEMUCapsInitProcessCapsInterlock(virQEMUCaps *qemuCaps);
658 
659 bool virQEMUCapsHasPCIMultiBus(const virDomainDef *def);
660 
661 bool virQEMUCapsSupportsVmport(virQEMUCaps *qemuCaps,
662                                const virDomainDef *def);
663 
664 const char *virQEMUCapsGetBinary(virQEMUCaps *qemuCaps);
665 virArch virQEMUCapsGetArch(virQEMUCaps *qemuCaps);
666 unsigned int virQEMUCapsGetVersion(virQEMUCaps *qemuCaps);
667 const char *virQEMUCapsGetPackage(virQEMUCaps *qemuCaps);
668 
669 unsigned int virQEMUCapsGetKVMVersion(virQEMUCaps *qemuCaps);
670 int virQEMUCapsAddCPUDefinitions(virQEMUCaps *qemuCaps,
671                                  virDomainVirtType type,
672                                  const char **name,
673                                  size_t count,
674                                  virDomainCapsCPUUsable usable);
675 virDomainCapsCPUModels *virQEMUCapsGetCPUModels(virQEMUCaps *qemuCaps,
676                                                   virDomainVirtType type,
677                                                   const char **modelAllowed,
678                                                   const char **modelForbidden);
679 int virQEMUCapsFetchCPUModels(qemuMonitor *mon,
680                               virArch arch,
681                               virDomainCapsCPUModels **cpuModels);
682 
683 typedef enum {
684     /* Host CPU definition reported in domain capabilities. */
685     VIR_QEMU_CAPS_HOST_CPU_REPORTED,
686     /* Migratable host CPU definition used for updating guest CPU. */
687     VIR_QEMU_CAPS_HOST_CPU_MIGRATABLE,
688     /* CPU definition with features detected by libvirt using virCPUGetHost
689      * combined with features reported by QEMU. This is used for backward
690      * compatible comparison between a guest CPU and a host CPU. */
691     VIR_QEMU_CAPS_HOST_CPU_FULL,
692 } virQEMUCapsHostCPUType;
693 
694 virCPUDef *virQEMUCapsGetHostModel(virQEMUCaps *qemuCaps,
695                                      virDomainVirtType type,
696                                      virQEMUCapsHostCPUType cpuType);
697 int virQEMUCapsGetCPUFeatures(virQEMUCaps *qemuCaps,
698                               virDomainVirtType virtType,
699                               bool migratable,
700                               char ***features);
701 
702 virDomainVirtType virQEMUCapsGetVirtType(virQEMUCaps *qemuCaps);
703 
704 bool virQEMUCapsIsArchSupported(virQEMUCaps *qemuCaps,
705                                 virArch arch);
706 bool virQEMUCapsIsVirtTypeSupported(virQEMUCaps *qemuCaps,
707                                     virDomainVirtType virtType);
708 bool virQEMUCapsIsCPUModeSupported(virQEMUCaps *qemuCaps,
709                                    virArch hostarch,
710                                    virDomainVirtType type,
711                                    virCPUMode mode,
712                                    const char *machineType);
713 const char *virQEMUCapsGetCanonicalMachine(virQEMUCaps *qemuCaps,
714                                            virDomainVirtType virtType,
715                                            const char *name);
716 bool virQEMUCapsIsMachineSupported(virQEMUCaps *qemuCaps,
717                                    virDomainVirtType virtType,
718                                    const char *canonical_machine)
719     ATTRIBUTE_NONNULL(1) ATTRIBUTE_NONNULL(3);
720 int virQEMUCapsGetMachineMaxCpus(virQEMUCaps *qemuCaps,
721                                  virDomainVirtType virtType,
722                                  const char *name);
723 bool virQEMUCapsGetMachineHotplugCpus(virQEMUCaps *qemuCaps,
724                                       virDomainVirtType virtType,
725                                       const char *name);
726 const char *virQEMUCapsGetMachineDefaultCPU(virQEMUCaps *qemuCaps,
727                                             const char *name,
728                                             virDomainVirtType type);
729 bool virQEMUCapsIsCPUDeprecated(virQEMUCaps *qemuCaps,
730                                 virDomainVirtType type,
731                                 const char *model);
732 bool virQEMUCapsIsMachineDeprecated(virQEMUCaps *qemuCaps,
733                                     virDomainVirtType type,
734                                     const char *machine);
735 bool virQEMUCapsGetMachineNumaMemSupported(virQEMUCaps *qemuCaps,
736                                            virDomainVirtType virtType,
737                                            const char *name);
738 const char *virQEMUCapsGetMachineDefaultRAMid(virQEMUCaps *qemuCaps,
739                                               virDomainVirtType virtType,
740                                               const char *name);
741 
742 void virQEMUCapsFilterByMachineType(virQEMUCaps *qemuCaps,
743                                     virDomainVirtType virtType,
744                                     const char *machineType);
745 char * virQEMUCapsGetDefaultEmulator(virArch hostarch,
746                                      virArch guestarch);
747 
748 virFileCache *virQEMUCapsCacheNew(const char *libDir,
749                                     const char *cacheDir,
750                                     uid_t uid,
751                                     gid_t gid);
752 virQEMUCaps *virQEMUCapsCacheLookup(virFileCache *cache,
753                                       const char *binary);
754 virQEMUCaps *virQEMUCapsCacheLookupCopy(virFileCache *cache,
755                                           virDomainVirtType virtType,
756                                           const char *binary,
757                                           const char *machineType);
758 virQEMUCaps *virQEMUCapsCacheLookupDefault(virFileCache *cache,
759                                              const char *binary,
760                                              const char *archStr,
761                                              const char *virttypeStr,
762                                              const char *machine,
763                                              virArch *retArch,
764                                              virDomainVirtType *retVirttype,
765                                              const char **retMachine);
766 
767 virCaps *virQEMUCapsInit(virFileCache *cache);
768 
769 int virQEMUCapsGetDefaultVersion(virCaps *caps,
770                                  virFileCache *capsCache,
771                                  unsigned int *version);
772 
773 VIR_ENUM_DECL(virQEMUCaps);
774 
775 bool virQEMUCapsSupportsGICVersion(virQEMUCaps *qemuCaps,
776                                    virDomainVirtType virtType,
777                                    virGICVersion version);
778 
779 const char *virQEMUCapsGetPreferredMachine(virQEMUCaps *qemuCaps,
780                                            virDomainVirtType virtType);
781 
782 int virQEMUCapsInitGuestFromBinary(virCaps *caps,
783                                    const char *binary,
784                                    virQEMUCaps *qemuCaps,
785                                    virArch guestarch);
786 
787 int virQEMUCapsFillDomainCaps(virQEMUCaps *qemuCaps,
788                               virArch hostarch,
789                               virDomainCaps *domCaps,
790                               bool privileged,
791                               virFirmware **firmwares,
792                               size_t nfirmwares);
793 
794 void virQEMUCapsFillDomainMemoryBackingCaps(virQEMUCaps *qemuCaps,
795                                             virDomainCapsMemoryBacking *memoryBacking);
796 
797 void virQEMUCapsFillDomainDeviceGraphicsCaps(virQEMUCaps *qemuCaps,
798                                              virDomainCapsDeviceGraphics *dev);
799 
800 void virQEMUCapsFillDomainDeviceVideoCaps(virQEMUCaps *qemuCaps,
801                                           virDomainCapsDeviceVideo *dev);
802 
803 void virQEMUCapsFillDomainDeviceRNGCaps(virQEMUCaps *qemuCaps,
804                                         virDomainCapsDeviceRNG *rng);
805 
806 void virQEMUCapsFillDomainDeviceFSCaps(virQEMUCaps *qemuCaps,
807                                        virDomainCapsDeviceFilesystem *filesystem);
808 
809 bool virQEMUCapsGuestIsNative(virArch host,
810                               virArch guest);
811 
812 bool virQEMUCapsCPUFilterFeatures(const char *name,
813                                   virCPUFeaturePolicy policy,
814                                   void *opaque);
815 
816 const char *
817 virQEMUCapsCPUFeatureToQEMU(virQEMUCaps *qemuCaps,
818                             const char *feature);
819 
820 const char *
821 virQEMUCapsCPUFeatureFromQEMU(virQEMUCaps *qemuCaps,
822                               const char *feature);
823 
824 virSEVCapability *
825 virQEMUCapsGetSEVCapabilities(virQEMUCaps *qemuCaps);
826 
827 bool
828 virQEMUCapsGetKVMSupportsSecureGuest(virQEMUCaps *qemuCaps) G_GNUC_NO_INLINE;
829 
830 virArch virQEMUCapsArchFromString(const char *arch);
831 const char *virQEMUCapsArchToString(virArch arch);
832