include/hw/boards.h

9 #include "qapi/qapi-types-machine.h"
15 #define TYPE_MACHINE_SUFFIX "-machine"
17 /* Machine class name that needs to be used for class-name-based machine
66  * created (eg by the user on the command line with -device).
123  * @arch_id - architecture-dependent CPU ID of present or possible CPU
124  * @cpu - pointer to corresponding CPU object if it's present on NULL otherwise
125  * @type - QOM class name of possible @cpu object
126  * @props - CPU object properties, initialized by board
127  * #vcpus_count - number of threads provided by @cpu object
139  * @len - number of @CPUArchId items in @cpus array
140  * @cpus - array of present or possible CPUs for current machine configuration
149  * @prefer_sockets - whether sockets are preferred over cores in smp parsing
150  * @dies_supported - whether dies are supported by the machine
151  * @clusters_supported - whether clusters are supported by the machine
152  * @has_clusters - whether clusters are explicitly specified in the user
154  * @books_supported - whether books are supported by the machine
155  * @drawers_supported - whether drawers are supported by the machine
156  * @modules_supported - whether modules are supported by the machine
157  * @cache_supported - whether cache (l1d, l1i, l2 and l3) configuration are
159  * @has_caches - whether cache properties are explicitly specified in the
160  *               user provided smp-cache configuration
177  *    string should provide some clear information about what to use instead.
182  *    If true QEMU will use this machine by default if no '-M' option is given.
183  * @get_hotplug_handler: this function is called during bus-less
201  *    Returns an array of @CPUArchId architecture-dependent CPU IDs
206  *    index @idx in @ms->possible_cpus[]
208  *    If true, board supports CPUs creation with -device/device_add.
214  *    If non-zero, the board promises never to create a CPU with a page size
226  *    should instead use "unimplemented-device" for all memory ranges where
230  *    Return the type of KVM corresponding to the kvm-type string option or
232  *    kvm-type may be NULL if it is not needed.
238  *    true if '--numa node.mem' option is supported and false otherwise
248  *    creation if user explicitly hasn't specified backend with "memory-backend"
249  *    property.
250  *    It also will be used as a way to option into "-m" option support.
251  *    If it's not set by board, '-m' will be ignored and generic code will
254  *    Amends user provided ram size (with -m option) using machine
427      * machine init function and forward the property to the device.
463  *          mc->desc = "QEMU " MACHINE_VER_STR(__VA_ARGS__) " Virtual Machine"; \
466  *              mc->alias = "virt"; \
484  *  // Normal 2 digit, marked as latest e.g. 'virt-9.0'
488  *  // Normal 2 digit e.g. 'virt-9.0'
492  *  // Bugfix 3 digit e.g. 'virt-9.0.1'
496  *  // Tagged 2 digit e.g. 'virt-9.0-extra'
500  *  // Tagged bugfix 2 digit e.g. 'virt-9.0.1-extra'
516  *                    MACRO_MATCHING_1_ARG) (FIXED-ARG-1,
518  *                                           FIXED-ARG-N,
524  * Construct a human targeted machine version string.
536  *   "{major}.{minor}-{tag}"
538  *   "{major}.{minor}.{micro}-{tag}"
547     #major "." #minor "-" #tag
550     #major "." #minor "." #micro "-" #tag
573  *   "{prefix}-{major}.{minor}"
574  *   "{prefix}-{major}.{minor}.{micro}"
575  *   "{prefix}-{major}.{minor}-{tag}"
576  *   "{prefix}-{major}.{minor}.{micro}-{tag}"
579     prefix "-" #major "." #minor TYPE_MACHINE_SUFFIX
582     prefix "-" #major "." #minor "." #micro TYPE_MACHINE_SUFFIX
585     prefix "-" #major "." #minor "-" #tag TYPE_MACHINE_SUFFIX
588     prefix "-" #major "." #minor "." #micro "-" #tag TYPE_MACHINE_SUFFIX
648  * Expands to a static string containing a deprecation
657     (((QEMU_VERSION_MAJOR - major) > cutoff) || \
658      (((QEMU_VERSION_MAJOR - major) == cutoff) && \
659       (QEMU_VERSION_MINOR - minor) >= 0))
662     (((QEMU_VERSION_MAJOR - major) > cutoff) || \
663      (((QEMU_VERSION_MAJOR - major) == cutoff) && \
664       ((QEMU_VERSION_MINOR + 1) - minor) >= 0))
667     ((((QEMU_VERSION_MAJOR + 1) - major) > cutoff) ||            \
668      ((((QEMU_VERSION_MAJOR + 1) - major) == cutoff) &&          \
669       (0 - minor) >= 0))
672  * - The first check applies to formal releases
673  * - The second check applies to dev snapshots / release candidates
676  * - The third check applies to dev snapshots / release candidates
733  * Initially it will effectively be a no-op, but after a
741             mc->deprecation_reason = MACHINE_VER_DEPRECATION_MSG; \
752  * Inijtially it will effectively be a no-op, but after a