From 5ce9aca8a61c6991b2ed6944f0c07c0015578d25 Mon Sep 17 00:00:00 2001 From: Tuomas Tynkkynen Date: Mon, 14 May 2018 23:50:05 +0300 Subject: [PATCH] PCI: Document pciauto_region_allocate() Add a doc comment for pciauto_region_allocate(). Signed-off-by: Tuomas Tynkkynen Reviewed-by: Simon Glass --- include/pci.h | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/include/pci.h b/include/pci.h index 127d3c6..8e27cbf 100644 --- a/include/pci.h +++ b/include/pci.h @@ -680,6 +680,19 @@ extern int pci_write_config_dword(pci_dev_t dev, int where, u32 val); void pciauto_region_init(struct pci_region *res); void pciauto_region_align(struct pci_region *res, pci_size_t size); void pciauto_config_init(struct pci_controller *hose); + +/** + * pciauto_region_allocate() - Allocate resources from a PCI resource region + * + * Allocates @size bytes from the PCI resource @res. If @supports_64bit is + * false, the result will be guaranteed to fit in 32 bits. + * + * @res: PCI region to allocate from + * @size: Amount of bytes to allocate + * @bar: Returns the PCI bus address of the allocated resource + * @supports_64bit: Whether to allow allocations above the 32-bit boundary + * @return 0 if successful, -1 on failure + */ int pciauto_region_allocate(struct pci_region *res, pci_size_t size, pci_addr_t *bar, bool supports_64bit);