xref: /qemu/qapi/pragma.json (revision 6087783e)
1# -*- Mode: Python -*-
2# vim: filetype=python
3
4{ 'pragma': { 'doc-required': true } }
5
6# Entries in these lists are allowed to violate the QAPI rules (for
7# historical reasons); think twice before you add to them!
8{ 'pragma': {
9    # Command names containing '_'
10    'command-name-exceptions': [
11        'add_client',
12        'block_resize',
13        'block_set_io_throttle',
14        'client_migrate_info',
15        'device_add',
16        'device_del',
17        'expire_password',
18        'migrate_cancel',
19        'netdev_add',
20        'netdev_del',
21        'qmp_capabilities',
22        'set_link',
23        'set_password',
24        'system_powerdown',
25        'system_reset',
26        'system_wakeup' ],
27    # Commands allowed to return a non-dictionary
28    'command-returns-exceptions': [
29        'human-monitor-command',
30        'qom-get',
31        'query-tpm-models',
32        'query-tpm-types',
33        'ringbuf-read' ],
34    # Types, commands, and events with undocumented members / arguments:
35    'documentation-exceptions': [
36        'AbortWrapper',
37        'AudiodevDriver',
38        'BlkdebugEvent',
39        'BlockDirtyBitmapAddWrapper',
40        'BlockDirtyBitmapMergeWrapper',
41        'BlockDirtyBitmapWrapper',
42        'BlockdevBackupWrapper',
43        'BlockdevDriver',
44        'BlockdevQcow2EncryptionFormat',
45        'BlockdevSnapshotInternalWrapper',
46        'BlockdevSnapshotSyncWrapper',
47        'BlockdevSnapshotWrapper',
48        'BlockdevVmdkAdapterType',
49        'ChardevBackendKind',
50        'CpuS390Entitlement',
51        'CpuS390Polarization',
52        'CpuS390State',
53        'CxlCorErrorType',
54        'DisplayProtocol',
55        'DriveBackupWrapper',
56        'DummyBlockCoreForceArrays',
57        'DummyForceArrays',
58        'DummyVirtioForceArrays',
59        'GrabToggleKeys',
60        'GuestPanicInformationHyperV',
61        'HotKeyMod',
62        'ImageInfoSpecificKind',
63        'InputAxis',
64        'InputButton',
65        'IscsiHeaderDigest',
66        'IscsiTransport',
67        'JSONType',
68        'KeyValueKind',
69        'MemoryDeviceInfoKind',
70        'NetClientDriver',
71        'ObjectType',
72        'PciMemoryRegion',
73        'QCryptoAkCipherKeyType',
74        'QCryptodevBackendServiceType',
75        'QKeyCode',
76        'Qcow2OverlapCheckFlags',
77        'RbdAuthMode',
78        'RbdImageEncryptionFormat',
79        'StatsFilter',
80        'StatsValue',
81        'String',
82        'StringWrapper',
83        'SysEmuTarget',
84        'ThrottleGroupProperties',
85        'VncPrimaryAuth',
86        'VncVencryptSubAuth',
87        'X86CPURegister32',
88        'XDbgBlockGraph',
89        'YankInstanceType',
90        'blockdev-reopen',
91        'query-cpu-model-baseline',
92        'query-cpu-model-comparison',
93        'query-cpu-model-expansion',
94        'query-rocker',
95        'query-rocker-ports',
96        'query-stats-schemas',
97        'watchdog-set-action' ],
98    # Externally visible types whose member names may use uppercase
99    'member-name-exceptions': [     # visible in:
100        'ACPISlotType',             # query-acpi-ospm-status
101        'AcpiTableOptions',         # -acpitable
102        'BlkdebugEvent',            # blockdev-add, -blockdev
103        'BlkdebugSetStateOptions',  # blockdev-add, -blockdev
104        'BlockDeviceInfo',          # query-block
105        'BlockDeviceStats',         # query-blockstats
106        'BlockDeviceTimedStats',    # query-blockstats
107        'BlockIOThrottle',          # block_set_io_throttle
108        'BlockInfo',                # query-block
109        'BlockdevAioOptions',       # blockdev-add, -blockdev
110        'BlockdevDriver',           # blockdev-add, query-blockstats, ...
111        'BlockdevVmdkAdapterType',  # blockdev-create (to match VMDK spec)
112        'BlockdevVmdkSubformat',    # blockdev-create (to match VMDK spec)
113        'ColoCompareProperties',    # object_add, -object
114        'FilterMirrorProperties',   # object_add, -object
115        'FilterRedirectorProperties', # object_add, -object
116        'FilterRewriterProperties', # object_add, -object
117        'InputLinuxProperties',     # object_add, -object
118        'NetdevTapOptions',         # netdev_add, query-netdev, -netdev
119        'ObjectType',               # object-add, -object
120        'PCIELinkSpeed',            # internal only
121        'PciBusInfo',               # query-pci
122        'PciDeviceInfo',            # query-pci
123        'PciMemoryRegion',          # query-pci
124        'QKeyCode',                 # send-key, input-sent-event
125        'QapiErrorClass',           # QMP error replies
126        'SshHostKeyCheckMode',      # blockdev-add, -blockdev
127        'SysEmuTarget',             # query-cpu-fast, query-target
128        'UuidInfo',                 # query-uuid
129        'VncClientInfo',            # query-vnc, query-vnc-servers, ...
130        'X86CPURegister32'          # qom-get of x86 CPU properties
131                                    # feature-words, filtered-features
132    ] } }
133