[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[PATCH 3/8] hw/pci: Document pci_dma_map()
From: |
Philippe Mathieu-Daudé |
Subject: |
[PATCH 3/8] hw/pci: Document pci_dma_map() |
Date: |
Fri, 31 Dec 2021 12:48:56 +0100 |
Signed-off-by: Philippe Mathieu-Daudé <philmd@redhat.com>
---
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 5b36334a28a..f0d707efb8c 100644
--- a/include/hw/pci/pci.h
+++ b/include/hw/pci/pci.h
@@ -876,6 +876,18 @@ PCI_DMA_DEFINE_LDST(q_be, q_be, 64);
#undef PCI_DMA_DEFINE_LDST
+/**
+ * pci_dma_map: Map a physical memory region into a device PCI address space.
+ *
+ * May map a subset of the requested range, given by and returned in @plen.
+ * May return %NULL and set *@plen to zero(0), if resources needed to perform
+ * the mapping are exhausted.
+ *
+ * @dev: #PCIDevice to be accessed
+ * @addr: address within that device's address space
+ * @plen: pointer to length of buffer; updated on return
+ * @dir: indicates the transfer direction
+ */
static inline void *pci_dma_map(PCIDevice *dev, dma_addr_t addr,
dma_addr_t *plen, DMADirection dir)
{
--
2.33.1
- [PATCH 0/8] hw/dma: Introduce dma_size_t type definition, Philippe Mathieu-Daudé, 2021/12/31
- [PATCH 1/8] hw/nvram: Restrict stub to sysemu and tools, Philippe Mathieu-Daudé, 2021/12/31
- [PATCH 2/8] hw/pci: Restrict pci-bus stub to sysemu, Philippe Mathieu-Daudé, 2021/12/31
- [PATCH 3/8] hw/pci: Document pci_dma_map(),
Philippe Mathieu-Daudé <=
- [PATCH 4/8] hw/dma: Remove CONFIG_USER_ONLY check, Philippe Mathieu-Daudé, 2021/12/31
- [PATCH 5/8] hw/rdma/rdma_utils: Rename rdma_pci_dma_map 'len' argument, Philippe Mathieu-Daudé, 2021/12/31
- [PATCH 7/8] hw/dma: Introduce dma_size_t type definition, Philippe Mathieu-Daudé, 2021/12/31
- [PATCH 8/8] hw/dma: Let dma_buf_read() / dma_buf_write() propagate MemTxResult, Philippe Mathieu-Daudé, 2021/12/31
- [PATCH 6/8] hw/scsi: Rename SCSIRequest::resid as 'residual', Philippe Mathieu-Daudé, 2021/12/31