include/hw/boards.h

1 /* Declarations for use by board files for creating devices.  */
17 /* Machine class name that needs to be used for class-name-based machine
69  * for the special cases which are permitted for this machine model, the
77  * type for the machine class.
115  * Checks that backend isn't used, preps it for exclusive usage and
140  * @cpus - array of present or possible CPUs for current machine configuration
186  *    for a given @dev. It may return NULL if @dev doesn't require
202  *    which includes CPU IDs for present and possible to hotplug CPUs.
203  *    Caller is responsible for freeing returned list.
205  *    returns default board specific node_id value for CPU slot specified by
210  *    specifies default CPU_TYPE, which will be used for parsing target
211  *    specific features and for creating CPUs if CPU name wasn't provided
218  *    compatibility break for the machine.
223  *    return zero (for a read) or be ignored (for a write). This should be
225  *    for handling devices that QEMU does not yet model. New board models
226  *    should instead use "unimplemented-device" for all memory ranges where
227  *    the guest will attempt to probe for a device that QEMU doesn't
234  *    Returns the physical address range in bits to use for the HVF virtual
240  *    If the hook is provided, then it'll be called for each device
247  *    Specifies initial RAM MemoryRegion name to be used for default backend
255  *    specific algorithm. To be used by old machine types for compat
337  * address space for memory devices starts
338  * @mr: memory region container for memory devices
339  * @as: address space for memory devices
424      * Included in MachineState for simplicity, but not supported
453  * For example, a macro that can be used to define versioned
481  * Following this, one (or more) helpers can be added for
482  * whichever scenarios need to be catered for with a machine:
506  * Helper for dispatching different macros based on how
561  * Construct a QAPI type name for a versioned machine
598  * Construct a name for a versioned machine type that is
599  * suitable for use as a C symbol (function/variable/etc).
636  * How many years/major releases for each phase
649  * message for a versioned machine type
720  * for deletion based on the current versioned machine type
727  * Sets the deprecation reason for a versioned machine based
731  * function for all machine types which support versioning.
750  * method for all machine types which support versioning.