include/system/memory.h

237 /* RAM is an mmap-ed named file */
350  * and provide an implementation of at least the @translate method here
358  * Conceptually an IOMMU provides a mapping from input address
359  * to an output TLB entry. If the IOMMU is aware of memory transaction
366  *   @translate takes an input address and an IOMMU index
389      * may use this as an optimization, to stop doing a page table
393      * IOMMUTLBEntry. (Note that this implies that an IOMMU may not
397      * holding the big QEMU lock or is inside an RCU critical section;
399      * register an IOMMU notifier so it can invalidate its cached
459      * Optional method -- an IOMMU only needs to provide this method
469      * Get IOMMU misc attributes. This is an optional method that
494      * Optional method: if an IOMMU only supports a single IOMMU index then
498      * The indexes supported by an IOMMU must be contiguous, starting at 0.
539      * an error is returned.
591  * #MemoryRegion isn't mapped into an address space yet (either directly
592  * or via an alias); it cannot change while the #MemoryRegion is
593  * mapped into an address space.
603  * An example #RamDiscardManager is virtio-mem, which logically (un)plugs
604  * memory within an assigned RAM #MemoryRegion, coordinated with the VM.
693      * and an error is logged.
745  * @iotlb: pointer to an #IOMMUTLBEntry
748  * @errp: pointer to Error*, to store an error if it happens.
788     int mapped_via_alias; /* Mapped via an alias, container might be NULL */
836      * Called at the beginning of an address space update transaction.
849      * Called at the end of an address space update transaction,
861      * Called during an address space update transaction,
873      * Called during an address space update transaction,
885      * Called during an address space update transaction,
897      * Called during an address space update transaction, after
915      * Called during an address space update transaction, after
979      * @errp: pointer to Error*, to store an error if it happens.
1009      * Called during an address space update transaction,
1025      * Called during an address space update transaction,
1026      * for a section of the address space that has dropped an ioeventfd
1041      * Called during an address space update transaction,
1056      * Called during an address space update transaction,
1238  * All MemoryRegions must have an owner if they can disappear, even if the
1260  * memory_region_init_io: Initialize an I/O memory region.
1290  * @errp: pointer to Error*, to store an error if it happens.
1315  * @errp: pointer to Error*, to store an error if it happens.
1332  *                                     modify memory directly.  Only an initial
1345  * @errp: pointer to Error*, to store an error if it happens.
1379  * @errp: pointer to Error*, to store an error if it happens.
1409  * @errp: pointer to Error*, to store an error if it happens.
1452  * MMIO BAR of an vfio-pci assigned device.  The memory region may be mapped
1510  * @errp: pointer to Error*, to store an error if it happens.
1535  * @errp: pointer to Error*, to store an error if it happens.
1551  * An IOMMU region translates addresses and forwards accesses to a target
1555  * @_iommu_mr should be a pointer to enough memory for an instance of
1557  * @mrtypename is its name. This function will initialize @_iommu_mr as an
1585  * @errp: pointer to Error*, to store an error if it happens.
1631  * @errp: pointer to Error*, to store an error if it happens.
1664  * @errp: pointer to Error*, to store an error if it happens.
1746  * memory_region_get_iommu: check whether a memory region is an iommu
1748  * Returns pointer to IOMMUMemoryRegion if a memory region is an iommu,
1766  *   if an iommu or NULL if not
1768  * Returns pointer to IOMMUMemoryRegionClass if a memory region is an iommu,
1783  * for an iommu
1785  * Returns minimum supported page size for an iommu.
1792  * memory_region_notify_iommu: notify a change in an IOMMU translation entry.
1794  * Note: for any IOMMU implementation, an in-place mapping change
1795  * should be notified with an UNMAP followed by a MAP.
1808  * memory_region_notify_iommu_one: notify a change in an IOMMU translation
1823  * memory_region_unmap_iommu_notifier_range: notify a unmap for an IOMMU
1843  *     pointer to an #IOMMUTLBEntry as the opaque value; the pointer
1845  * @errp: pointer to Error*, to store an error if it happens.
1874  * memory_region_iommu_get_attr: return an IOMMU attr if get_attr() is
1973  * and an offset within it.
1980  * not protected by RCU anymore.  If the caller is not within an RCU critical
1997  * not protected by RCU anymore.  If the caller is not within an RCU critical
2013  * @errp: pointer to Error*, to store an error if it happens.
2256  * memory_region_add_eventfd: Request an eventfd to be triggered when a word
2259  * Marks a word in an IO region (initialized with memory_region_init_io())
2260  * as a trigger for an eventfd event.  The I/O callback will not be called.
2279  * memory_region_del_eventfd: Cancel an eventfd.
2281  * Cancels an eventfd trigger requested by a previous
2396  * Dynamically updates the offset into the target region that an alias points
2399  * @mr: the #MemoryRegion to be updated; should be an alias.
2425  * memory_region_present: checks if an address relative to a @container
2439  * mapped into an address space.
2481  * memory_region_find: translate an address/size relative to a
2490  * - @mr is non-%NULL iff an overlap was found
2547  *                           sections are mapped or unmapped into an address
2550  * @listener: an object containing the callbacks to be called
2558  * @listener: an object containing the callbacks to be removed
2566  * @errp: pointer to Error*, to store an error if it happens.
2617  * address_space_init: initializes an address space
2619  * @as: an uninitialized #AddressSpace
2621  * @name: an address space name.  The name is only used for debugging
2627  * address_space_destroy: destroy an address space
2629  * Releases all resources associated with an address space.  After an address space
2638  * address_space_remove_listeners: unregister all listeners of an address space
2643  * @as: an initialized #AddressSpace
2648  * address_space_rw: read from or write to an address space.
2708 /* address_space_ld*: load from an address space
2709  * address_space_st*: store to an address space
2879 /* address_space_get_iotlb_entry: translate an address into an IOTLB
2880  * entry. Should be called from an RCU critical section.
2885 /* address_space_translate: translate an address range into an address space
2886  * into a MemoryRegion and an address range into that section.  Should be
2887  * called from an RCU critical section, to avoid that the last reference
2912 /* address_space_access_valid: check for validity of accessing an address
3037  * address_space_read: read from an address space.