[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[PULL 11/19] hw/pci: Document pci_dma_map()
From: |
Philippe Mathieu-Daudé |
Subject: |
[PULL 11/19] hw/pci: Document pci_dma_map() |
Date: |
Tue, 18 Jan 2022 13:02:21 +0100 |
From: Philippe Mathieu-Daudé <philmd@redhat.com>
Signed-off-by: Philippe Mathieu-Daudé <philmd@redhat.com>
Reviewed-by: Michael S. Tsirkin <mst@redhat.com>
Reviewed-by: Richard Henderson <richard.henderson@linaro.org>
Message-Id: <20220111184309.28637-5-f4bug@amsat.org>
Signed-off-by: Philippe Mathieu-Daudé <f4bug@amsat.org>
---
include/hw/pci/pci.h | 12 ++++++++++++
1 file changed, 12 insertions(+)
diff --git a/include/hw/pci/pci.h b/include/hw/pci/pci.h
index 483d5c7c727..023abc0f791 100644
--- a/include/hw/pci/pci.h
+++ b/include/hw/pci/pci.h
@@ -881,6 +881,18 @@ PCI_DMA_DEFINE_LDST(q_be, q_be, 64);
#undef PCI_DMA_DEFINE_LDST
+/**
+ * pci_dma_map: Map device PCI address space range into host virtual address
+ * @dev: #PCIDevice to be accessed
+ * @addr: address within that device's address space
+ * @plen: pointer to length of buffer; updated on return to indicate
+ * if only a subset of the requested range has been mapped
+ * @dir: indicates the transfer direction
+ *
+ * Return: A host pointer, or %NULL if the resources needed to
+ * perform the mapping are exhausted (in that case *@plen
+ * is set to zero).
+ */
static inline void *pci_dma_map(PCIDevice *dev, dma_addr_t addr,
dma_addr_t *plen, DMADirection dir)
{
--
2.34.1
- [PULL 04/19] machine: Use host_memory_backend_is_mapped() in machine_consume_memdev(), (continued)
- [PULL 04/19] machine: Use host_memory_backend_is_mapped() in machine_consume_memdev(), Philippe Mathieu-Daudé, 2022/01/18
- [PULL 03/19] memory: Have 'info mtree' remove duplicated Address Space information, Philippe Mathieu-Daudé, 2022/01/18
- [PULL 13/19] hw/rdma/rdma_utils: Rename rdma_pci_dma_map 'len' argument, Philippe Mathieu-Daudé, 2022/01/18
- [PULL 06/19] memory: Update description of memory_region_is_mapped(), Philippe Mathieu-Daudé, 2022/01/18
- [PULL 02/19] memory: Split mtree_info() as mtree_info_flatview() + mtree_info_as(), Philippe Mathieu-Daudé, 2022/01/18
- [PULL 08/19] stubs: Restrict fw_cfg to system emulation, Philippe Mathieu-Daudé, 2022/01/18
- [PULL 09/19] hw/nvram: Restrict fw_cfg QOM interface to sysemu and tools, Philippe Mathieu-Daudé, 2022/01/18
- [PULL 07/19] memory: Fix incorrect calls of log_global_start/stop, Philippe Mathieu-Daudé, 2022/01/18
- [PULL 05/19] memory: Make memory_region_is_mapped() succeed when mapped via an alias, Philippe Mathieu-Daudé, 2022/01/18
- [PULL 14/19] hw/scsi: Rename SCSIRequest::resid as 'residual', Philippe Mathieu-Daudé, 2022/01/18
- [PULL 11/19] hw/pci: Document pci_dma_map(),
Philippe Mathieu-Daudé <=
- [PULL 19/19] docs/devel: add some clarifying text for aliases, Philippe Mathieu-Daudé, 2022/01/18
- [PULL 16/19] hw/dma: Move ScatterGatherEntry / QEMUSGList declarations around, Philippe Mathieu-Daudé, 2022/01/18
- [PULL 10/19] hw/pci: Restrict pci-bus stub to sysemu, Philippe Mathieu-Daudé, 2022/01/18
- [PULL 17/19] hw/dma: Use dma_addr_t type definition when relevant, Philippe Mathieu-Daudé, 2022/01/18
- [PULL 18/19] hw/dma: Let dma_buf_read() / dma_buf_write() propagate MemTxResult, Philippe Mathieu-Daudé, 2022/01/18
- [PULL 12/19] hw/dma: Remove CONFIG_USER_ONLY check, Philippe Mathieu-Daudé, 2022/01/18
- [PULL 15/19] hw/dma: Fix format string issues using dma_addr_t, Philippe Mathieu-Daudé, 2022/01/18
- Re: [PULL 00/19] Memory API patches for 2022-01-18, Peter Maydell, 2022/01/18