PCI: Document pciauto_region_allocate()
authorTuomas Tynkkynen <tuomas.tynkkynen@iki.fi>
Mon, 14 May 2018 20:50:05 +0000 (23:50 +0300)
committerTom Rini <trini@konsulko.com>
Sat, 26 May 2018 16:46:50 +0000 (12:46 -0400)
Add a doc comment for pciauto_region_allocate().

Signed-off-by: Tuomas Tynkkynen <tuomas.tynkkynen@iki.fi>
Reviewed-by: Simon Glass <sjg@chromium.org>
include/pci.h

index 127d3c6a6fe57415bbb9e3f1f11f281b692b0314..8e27cbfaf146cfb3ad0587aeb460cd454eba926f 100644 (file)
@@ -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);