qemu/scripts/compare-machine-types.py

11 # property via qmp command (e.g. query-cpu-model-expansion for x86_64-cpu).
42     print("Try export PYTHONPATH=top-qemu-dir/python or run from top-qemu-dir")
46 default_qemu_args = '-enable-kvm -machine none'
47 default_qemu_binary = 'build/qemu-system-x86_64'
58 #   'x86_64-cpu', method of 'x86_64-cpu' will be used for '486-x86_64-cpu')
61     def __init__(self, vm: QEMUMachine, name: str, abstract: bool) -> None:
68     def get_prop(self, driver: str, prop: str) -> str:
74     def is_child_of(self, parent: 'Driver') -> bool:
84     def set_implementations(self, implementations: List['Driver']) -> None:
89     def __init__(self, vm: QEMUMachine, name: str) -> None:
92     def set_implementations(self, implementations: List[Driver]) -> None:
97         # 'device' and 'x86_64-cpu', property getter of 'x86_64-cpu' will be
98         # used for '486-x86_64-cpu')
106     def __init__(self, vm: QEMUMachine) -> None:
110     def get_prop(self, driver: str, prop_name: str) -> str:
112             self.cached[driver] = self.vm.cmd('device-list-properties',
116                 return str(prop.get('default-value', 'No default value'))
122     def __init__(self, vm: QEMUMachine) -> None:
123         super().__init__(vm, 'x86_64-cpu')
126     def get_prop(self, driver: str, prop_name: str) -> str:
127         if not driver.endswith('-x86_64-cpu'):
128             return 'Wrong x86_64-cpu name'
130         # crop last 11 chars '-x86_64-cpu'
131         name = driver[:-11]
134                 'query-cpu-model-expansion', type='full',
142     def __init__(self, vm: QEMUMachine) -> None:
143         super().__init__(vm, 'memory-backend')
146     def get_prop(self, driver: str, prop_name: str) -> str:
148             self.cached[driver] = self.vm.cmd('qom-list-properties',
152                 return str(prop.get('default-value', 'No default value'))
157 def new_driver(vm: QEMUMachine, name: str, is_abstr: bool) -> Driver:
162     elif name == 'x86_64-cpu':
164     elif name == 'memory-backend':
174     def __init__(self, vm: QEMUMachine) -> None:
177         qom_all_types = vm.cmd('qom-list-types', abstract=True)
188             imps = vm.cmd('qom-list-types', implements=drv.name)
193     def get_prop(self, driver: str, prop: str) -> str:
194         # wrong driver name or disabled in config driver
204     def get_implementations(self, driver: str) -> List[str]:
213     # raw_mt_dict - dict produced by `query-machines`
215                  qemu_drivers: VMPropertyGetter) -> None:
221         for prop in raw_mt_dict['compat-props']:
222             driver = prop['qom-type']
242                  req_mt: List[str], all_mt: bool) -> None:
250     def get_implementations(self, driver_name: str) -> List[str]:
253     def get_table(self, req_props: List[Tuple[str, str]]) -> pd.DataFrame:
273 * save info about all machines:  ./scripts/compare-machine-types.py --all \
274 --format csv --raw > table.csv
275 * compare machines: ./scripts/compare-machine-types.py --mt pc-q35-2.12 \
276 pc-q35-3.0
277 * compare binaries and machines: ./scripts/compare-machine-types.py \
278 --mt pc-q35-6.2 pc-q35-7.0 --qemu-binary build/qemu-system-x86_64 \
279 build/qemu-exp
282   │   Driver   │         Property         │  build/qemu-system-x86_64  \
283 │  build/qemu-system-x86_64  │  build/qemu-exp  │  build/qemu-exp  │
284   │            │                          │         pc-q35-6.2         \
285 │         pc-q35-7.0         │    pc-q35-6.2    │    pc-q35-7.0    │
288   │  PIIX4_PM  │ x-not-migrate-acpi-index │            True            \
292   │ virtio-mem │  unplugged-inaccessible  │           False            \
298 x86_64-cpu) this script will compare all implementations of this class.
300 "Unavailable method" - means that this script doesn't know how to get \
303 "Unavailable driver" - means that this script doesn't know this driver. \
306 "No default value" - means that the appropriate method can't get the default \
308 "Unknown property" - means that the appropriate method can't find property \
312 def parse_args() -> Namespace:
315     parser.add_argument('--format', choices=['human-readable', 'json', 'csv'],
316                         default='human-readable',
318     parser.add_argument('--raw', action='store_true',
322                              'values will be transformed(e.g. "on" -> True)')
323     parser.add_argument('--qemu-args', default=default_qemu_args,
326     parser.add_argument('--qemu-binary', nargs="*", type=str,
332     mt_args_group.add_argument('--all', action='store_true',
335     mt_args_group.add_argument('--mt', nargs="*", type=str,
342 def mt_comp(mt: Machine) -> Tuple[str, int, int, int]:
345     # none, microvm, x-remote and etc.
346     if '-' not in mt.name or '.' not in mt.name:
349     socket, ver = mt.name.rsplit('-', 1)
351     ver_list += [0] * (3 - len(ver_list))
356                        vm: QEMUMachine) -> List[Machine]:
359     raw_mt_defs = vm.cmd('query-machines', compat_props=True)
369                req_mt: Optional[List[str]], all_mt: bool) -> List[Machine]:
387 def get_affected_props(configs: List[Configuration]) -> Generator[Tuple[str,
406 def transform_value(value: str) -> Union[str, bool]:
421 def simplify_table(table: pd.DataFrame) -> pd.DataFrame:
434 # ------------------------------------------------------ ...
441                     is_raw: bool) -> pd.DataFrame:
461 def print_table(table: pd.DataFrame, table_format: str) -> None: