drivers/pci: fix style issues in function headers

fix style issues in function headers, add missing new lines

drivers/pci/pci_epc.c

@@ -64,6 +64,7 @@ static struct list_node g_pci_epc_device_list =
  *
  * Returned Value:
  *   Return epc created if success, NULL if failed
+ *
  ****************************************************************************/
 
 FAR struct pci_epc_ctrl_s *pci_get_epc(FAR const char *epc_name)
@@ -112,6 +113,7 @@ FAR struct pci_epc_ctrl_s *pci_get_epc(FAR const char *epc_name)
  *
  * Returned Value:
  *    Return the member if success, negative if failed
+ *
  ****************************************************************************/
 
 int pci_epc_get_next_free_bar(
@@ -166,6 +168,7 @@ int pci_epc_get_next_free_bar(
  *
  * Returned Value:
  *    Epc features if success, NULL if failed
+ *
  ****************************************************************************/
 
 FAR const struct pci_epc_features_s *
@@ -199,6 +202,7 @@ pci_epc_get_features(FAR struct pci_epc_ctrl_s *epc, uint8_t funcno)
  *
  * Returned Value:
  *    None
+ *
  ****************************************************************************/
 
 void pci_epc_stop(FAR struct pci_epc_ctrl_s *epc)
@@ -226,6 +230,7 @@ void pci_epc_stop(FAR struct pci_epc_ctrl_s *epc)
  *
  * Returned Value:
  *    Return 0 if success, negative if failed
+ *
  ****************************************************************************/
 
 int pci_epc_start(FAR struct pci_epc_ctrl_s *epc)
@@ -260,6 +265,7 @@ int pci_epc_start(FAR struct pci_epc_ctrl_s *epc)
  *
  * Returned Value:
  *    Return 0 if success, negative if failed
+ *
  ****************************************************************************/
 
 int pci_epc_raise_irq(FAR struct pci_epc_ctrl_s *epc, uint8_t funcno,
@@ -307,6 +313,7 @@ int pci_epc_raise_irq(FAR struct pci_epc_ctrl_s *epc, uint8_t funcno,
  *
  * Returned Value:
  *    Return 0 if success, negative if failed
+ *
  ****************************************************************************/
 
 int pci_epc_map_msi_irq(FAR struct pci_epc_ctrl_s *epc, uint8_t funcno,
@@ -352,6 +359,7 @@ int pci_epc_map_msi_irq(FAR struct pci_epc_ctrl_s *epc, uint8_t funcno,
  *
  * Returned Value:
  *    Return interrupt number if success, negative if failed
+ *
  ****************************************************************************/
 
 int pci_epc_get_msi(FAR struct pci_epc_ctrl_s *epc, uint8_t funcno)
@@ -397,6 +405,7 @@ int pci_epc_get_msi(FAR struct pci_epc_ctrl_s *epc, uint8_t funcno)
  *
  * Returned Value:
  *    Return 0 if success, negative if failed
+ *
  ****************************************************************************/
 
 int pci_epc_set_msi(FAR struct pci_epc_ctrl_s *epc, uint8_t funcno,
@@ -438,6 +447,7 @@ int pci_epc_set_msi(FAR struct pci_epc_ctrl_s *epc, uint8_t funcno,
  *
  * Returned Value:
  *    Return interrupt + 1 number if success, negative if failed
+ *
  ****************************************************************************/
 
 int pci_epc_get_msix(FAR struct pci_epc_ctrl_s *epc, uint8_t funcno)
@@ -484,6 +494,7 @@ int pci_epc_get_msix(FAR struct pci_epc_ctrl_s *epc, uint8_t funcno)
  *
  * Returned Value:
  *    Return 0 if success, negative if failed
+ *
  ****************************************************************************/
 
 int pci_epc_set_msix(FAR struct pci_epc_ctrl_s *epc, uint8_t funcno,
@@ -519,6 +530,7 @@ int pci_epc_set_msix(FAR struct pci_epc_ctrl_s *epc, uint8_t funcno,
  *
  * Returned Value:
  *    None
+ *
  ****************************************************************************/
 
 void pci_epc_unmap_addr(FAR struct pci_epc_ctrl_s *epc, uint8_t funcno,
@@ -552,6 +564,7 @@ void pci_epc_unmap_addr(FAR struct pci_epc_ctrl_s *epc, uint8_t funcno,
  *
  * Returned Value:
  *    Return 0 if success, negative if failed
+ *
  ****************************************************************************/
 
 int pci_epc_map_addr(FAR struct pci_epc_ctrl_s *epc, uint8_t funcno,
@@ -587,6 +600,7 @@ int pci_epc_map_addr(FAR struct pci_epc_ctrl_s *epc, uint8_t funcno,
  *
  * Returned Value:
  *    None
+ *
  ****************************************************************************/
 
 void pci_epc_clear_bar(FAR struct pci_epc_ctrl_s *epc, uint8_t funcno,
@@ -620,6 +634,7 @@ void pci_epc_clear_bar(FAR struct pci_epc_ctrl_s *epc, uint8_t funcno,
  *
  * Returned Value:
  *    Return 0 if success, negative if failed
+ *
  ****************************************************************************/
 
 int pci_epc_set_bar(FAR struct pci_epc_ctrl_s *epc, uint8_t funcno,
@@ -664,6 +679,7 @@ int pci_epc_set_bar(FAR struct pci_epc_ctrl_s *epc, uint8_t funcno,
  *
  * Returned Value:
  *    Return 0 if success, negative if failed
+ *
  ****************************************************************************/
 
 int pci_epc_write_header(FAR struct pci_epc_ctrl_s *epc, uint8_t funcno,
@@ -702,6 +718,7 @@ int pci_epc_write_header(FAR struct pci_epc_ctrl_s *epc, uint8_t funcno,
  *
  * Returned Value:
  *   Return 0 if success, negative if failed
+ *
  ****************************************************************************/
 
 int pci_epc_add_epf(FAR struct pci_epc_ctrl_s *epc,
@@ -753,6 +770,7 @@ out:
  *
  * Returned Value:
  *   None
+ *
  ****************************************************************************/
 
 void pci_epc_remove_epf(FAR struct pci_epc_ctrl_s *epc,
@@ -785,6 +803,7 @@ void pci_epc_remove_epf(FAR struct pci_epc_ctrl_s *epc,
  *
  * Returned Value:
  *   None
+ *
  ****************************************************************************/
 
 void pci_epc_linkup(FAR struct pci_epc_ctrl_s *epc)
@@ -826,6 +845,7 @@ void pci_epc_linkup(FAR struct pci_epc_ctrl_s *epc)
  *
  * Returned Value:
  *   None
+ *
  ****************************************************************************/
 
 void pci_epc_linkdown(FAR struct pci_epc_ctrl_s *epc)
@@ -867,6 +887,7 @@ void pci_epc_linkdown(FAR struct pci_epc_ctrl_s *epc)
  *
  * Returned Value:
  *   None
+ *
  ****************************************************************************/
 
 void pci_epc_init_notify(FAR struct pci_epc_ctrl_s *epc)
@@ -908,6 +929,7 @@ void pci_epc_init_notify(FAR struct pci_epc_ctrl_s *epc)
  *
  * Returned Value:
  *   None
+ *
  ****************************************************************************/
 
 void pci_epc_bme_notify(FAR struct pci_epc_ctrl_s *epc)
@@ -949,6 +971,7 @@ void pci_epc_bme_notify(FAR struct pci_epc_ctrl_s *epc)
  *
  * Returned Value:
  *   Return struct pci_epc_ctrl_s * if success, NULL if failed.
+ *
  ****************************************************************************/
 
 FAR struct pci_epc_ctrl_s *
@@ -996,6 +1019,7 @@ pci_epc_create(FAR const char *name, FAR void *priv,
  *
  * Returned Value:
  *   None
+ *
  ****************************************************************************/
 
 void pci_epc_destroy(FAR struct pci_epc_ctrl_s *epc)

drivers/pci/pci_epc_mem.c

@@ -51,6 +51,7 @@
  *
  * Returned Value:
  *   Memory window alloced if success, NULL if failed
+ *
  ****************************************************************************/
 
 static FAR struct pci_epc_mem_s *
@@ -91,6 +92,7 @@ pci_epc_mem_find(FAR struct pci_epc_ctrl_s *epc,
  *
  * Returned Value:
  *   0 if success, negative if failed
+ *
  ****************************************************************************/
 
 int pci_epc_mem_multi_init(FAR struct pci_epc_ctrl_s *epc,
@@ -162,6 +164,7 @@ err:
  *
  * Returned Value:
  *   0 if success, negative if failed
+ *
  ****************************************************************************/
 
 int pci_epc_mem_init(FAR struct pci_epc_ctrl_s *epc, FAR void *virt,
@@ -191,6 +194,7 @@ int pci_epc_mem_init(FAR struct pci_epc_ctrl_s *epc, FAR void *virt,
  *
  * Returned Value:
  *   None
+ *
  ****************************************************************************/
 
 void pci_epc_mem_exit(FAR struct pci_epc_ctrl_s *epc)
@@ -229,6 +233,7 @@ void pci_epc_mem_exit(FAR struct pci_epc_ctrl_s *epc)
  *
  * Returned Value:
  *   The memory address alloced if success, NULL if failed
+ *
  ****************************************************************************/
 
 FAR void *pci_epc_mem_alloc_addr(FAR struct pci_epc_ctrl_s *epc,
@@ -271,6 +276,7 @@ FAR void *pci_epc_mem_alloc_addr(FAR struct pci_epc_ctrl_s *epc,
  *
  * Returned Value:
  *   None
+ *
  ****************************************************************************/
 
 void pci_epc_mem_free_addr(FAR struct pci_epc_ctrl_s *epc,

drivers/pci/pci_epf.c

@@ -103,6 +103,7 @@ pci_epf_match_device(FAR struct pci_epf_device_s *dev,
  *
  * Returned Value:
  *   None
+ *
  ****************************************************************************/
 
 static void pci_epf_unbind(FAR struct pci_epf_device_s *epf)
@@ -138,6 +139,7 @@ static void pci_epf_unbind(FAR struct pci_epf_device_s *epf)
  *
  * Returned Value:
  *   Return 0 if success, negative if failed
+ *
  ****************************************************************************/
 
 static int pci_epf_bind(FAR struct pci_epf_device_s *epf)
@@ -180,6 +182,7 @@ static int pci_epf_bind(FAR struct pci_epf_device_s *epf)
  *
  * Returned Value:
  *   None
+ *
  ****************************************************************************/
 
 void pci_epf_free_space(FAR struct pci_epf_device_s *epf,
@@ -220,6 +223,7 @@ void pci_epf_free_space(FAR struct pci_epf_device_s *epf,
  *
  * Returned Value:
  *  Return space address malloced if success, otherwise NULL
+ *
  ****************************************************************************/
 
 FAR void *pci_epf_alloc_space(FAR struct pci_epf_device_s *epf, int barno,
@@ -285,6 +289,7 @@ FAR void *pci_epf_alloc_space(FAR struct pci_epf_device_s *epf, int barno,
  *
  * Returned Value:
  *    Return >= 0 if success, < 0 if failed
+ *
  ****************************************************************************/
 
 int pci_epf_device_register(FAR struct pci_epf_device_s *epf)
@@ -356,6 +361,7 @@ int pci_epf_device_register(FAR struct pci_epf_device_s *epf)
  *
  * Returned Value:
  *    Return >= 0 if success, < 0 if failed
+ *
  ****************************************************************************/
 
 int pci_epf_device_unregister(FAR struct pci_epf_device_s *epf)
@@ -399,6 +405,7 @@ int pci_epf_device_unregister(FAR struct pci_epf_device_s *epf)
  *
  * Returned Value:
  *   Return >= 0 if success, < 0 if failed
+ *
  ****************************************************************************/
 
 int pci_epf_register_driver(FAR struct pci_epf_driver_s *drv)
@@ -484,6 +491,7 @@ int pci_epf_register_driver(FAR struct pci_epf_driver_s *drv)
  *
  * Returned Value:
  *    Return >= 0 if success, < 0 if failed
+ *
  ****************************************************************************/
 
 int pci_epf_unregister_driver(FAR struct pci_epf_driver_s *drv)

drivers/pci/pci_qemu_epc.c

@@ -291,6 +291,7 @@ static uint32_t pci_qep_func_base(FAR struct qemu_epc_s *qep,
  *
  * Returned Value:
  *   Return 0
+ *
  ****************************************************************************/
 
 static int
@@ -330,6 +331,7 @@ qemu_epc_write_header(FAR struct pci_epc_ctrl_s *epc, uint8_t funcno,
  *
  * Returned Value:
  *   Return 0
+ *
  ****************************************************************************/
 
 static int qemu_epc_set_bar(FAR struct pci_epc_ctrl_s *epc, uint8_t funcno,
@@ -364,6 +366,7 @@ static int qemu_epc_set_bar(FAR struct pci_epc_ctrl_s *epc, uint8_t funcno,
  *   epc    - Device name of the endpoint controller
  *   funcno - The epc's function number
  *   bar    - The bar is used mapping
+ *
  ****************************************************************************/
 
 static void
@@ -395,6 +398,7 @@ qemu_epc_clear_bar(FAR struct pci_epc_ctrl_s *epc, uint8_t funcno,
  *
  * Returned Value:
  *   0 if success, negative if failed
+ *
  ****************************************************************************/
 
 static int qemu_epc_map_addr(FAR struct pci_epc_ctrl_s *epc, uint8_t funcno,
@@ -441,6 +445,7 @@ static int qemu_epc_map_addr(FAR struct pci_epc_ctrl_s *epc, uint8_t funcno,
  *   epc    - Device name of the endpoint controller
  *   funcno - The epc's function number
  *   addr   - The outbound phy addr
+ *
  ****************************************************************************/
 
 static void
@@ -497,6 +502,7 @@ qemu_epc_get_bar_addr_from_funcno(FAR struct pci_epc_ctrl_s *epc,
  *
  * Returned Value:
  *   Return 0 if success, negative number if failed
+ *
  ****************************************************************************/
 
 static int
@@ -607,6 +613,7 @@ qemu_epc_raise_irq(FAR struct pci_epc_ctrl_s *epc, uint8_t funcno,
  *
  * Returned Value:
  *   Return 0
+ *
  ****************************************************************************/
 
 static int qemu_epc_start(FAR struct pci_epc_ctrl_s *epc)
@@ -651,6 +658,7 @@ qemu_epc_get_features(FAR struct pci_epc_ctrl_s *epc, uint8_t funcno)
  *
  * Returned Value:
  *   Return the number of interrupts
+ *
  ****************************************************************************/
 
 static int qemu_epc_get_msi(FAR struct pci_epc_ctrl_s *epc, uint8_t funcno)
@@ -684,6 +692,7 @@ static int qemu_epc_get_msi(FAR struct pci_epc_ctrl_s *epc, uint8_t funcno)
  *
  * Returned Value:
  *   Return 0
+ *
  ****************************************************************************/
 
 static int qemu_epc_set_msi(FAR struct pci_epc_ctrl_s *epc, uint8_t funcno,
@@ -714,6 +723,7 @@ static int qemu_epc_set_msi(FAR struct pci_epc_ctrl_s *epc, uint8_t funcno,
  *
  * Returned Value:
  *   Return the number of interrupts
+ *
  ****************************************************************************/
 
 static int qemu_epc_get_msix(FAR struct pci_epc_ctrl_s *epc, uint8_t funcno)
@@ -748,6 +758,7 @@ static int qemu_epc_get_msix(FAR struct pci_epc_ctrl_s *epc, uint8_t funcno)
  *
  * Returned Value:
  *   Return 0
+ *
  ****************************************************************************/
 
 static int qemu_epc_set_msix(FAR struct pci_epc_ctrl_s *epc, uint8_t funcno,

include/nuttx/pci/pci_epc.h

@@ -222,6 +222,7 @@ struct pci_epc_ctrl_s
  *
  * Returned Value:
  *   Return epc created if success, NULL if failed
+ *
  ****************************************************************************/
 
 FAR struct pci_epc_ctrl_s *pci_get_epc(FAR const char *epc_name);
@@ -244,6 +245,7 @@ FAR struct pci_epc_ctrl_s *pci_get_epc(FAR const char *epc_name);
  *
  * Returned Value:
  *    Return the member of if success, negative if failed
+ *
  ****************************************************************************/
 
 int pci_epc_get_next_free_bar(
@@ -264,6 +266,7 @@ int pci_epc_get_next_free_bar(
  *
  * Returned Value:
  *    Return the member if success, negative if failed
+ *
  ****************************************************************************/
 
 #define pci_epc_get_first_free_bar(f) pci_epc_get_next_free_bar(f, 0)
@@ -285,6 +288,7 @@ int pci_epc_get_next_free_bar(
  *
  * Returned Value:
  *    Epc features if success, NULL if failed
+ *
  ****************************************************************************/
 
 FAR const struct pci_epc_features_s *
@@ -303,6 +307,7 @@ pci_epc_get_features(FAR struct pci_epc_ctrl_s *epc, uint8_t funcno);
  *
  * Returned Value:
  *    None
+ *
  ****************************************************************************/
 
 void pci_epc_stop(FAR struct pci_epc_ctrl_s *epc);
@@ -320,6 +325,7 @@ void pci_epc_stop(FAR struct pci_epc_ctrl_s *epc);
  *
  * Returned Value:
  *    Return 0 if success, negative if failed
+ *
  ****************************************************************************/
 
 int pci_epc_start(FAR struct pci_epc_ctrl_s *epc);
@@ -340,6 +346,7 @@ int pci_epc_start(FAR struct pci_epc_ctrl_s *epc);
  *
  * Returned Value:
  *    Return 0 if success, negative if failed
+ *
  ****************************************************************************/
 
 int pci_epc_raise_irq(FAR struct pci_epc_ctrl_s *epc, uint8_t funcno,
@@ -372,6 +379,7 @@ int pci_epc_raise_irq(FAR struct pci_epc_ctrl_s *epc, uint8_t funcno,
  *
  * Returned Value:
  *    Return 0 if success, negative if failed
+ *
  ****************************************************************************/
 
 int pci_epc_map_msi_irq(FAR struct pci_epc_ctrl_s *epc, uint8_t funcno,
@@ -393,6 +401,7 @@ int pci_epc_map_msi_irq(FAR struct pci_epc_ctrl_s *epc, uint8_t funcno,
  *
  * Returned Value:
  *    Return interrupt number if success, negative if failed
+ *
  ****************************************************************************/
 
 int pci_epc_get_msi(FAR struct pci_epc_ctrl_s *epc, uint8_t funcno);
@@ -412,6 +421,7 @@ int pci_epc_get_msi(FAR struct pci_epc_ctrl_s *epc, uint8_t funcno);
  *
  * Returned Value:
  *    Return 0 if success, negative if failed
+ *
  ****************************************************************************/
 
 int pci_epc_set_msi(FAR struct pci_epc_ctrl_s *epc, uint8_t funcno,
@@ -431,6 +441,7 @@ int pci_epc_set_msi(FAR struct pci_epc_ctrl_s *epc, uint8_t funcno,
  *
  * Returned Value:
  *    Return 0 if success, negative if failed
+ *
  ****************************************************************************/
 
 int pci_epc_get_msix(FAR struct pci_epc_ctrl_s *epc, uint8_t funcno);
@@ -452,6 +463,7 @@ int pci_epc_get_msix(FAR struct pci_epc_ctrl_s *epc, uint8_t funcno);
  *
  * Returned Value:
  *    Return interrupt + 1 number if success, negative if failed
+ *
  ****************************************************************************/
 
 int pci_epc_set_msix(FAR struct pci_epc_ctrl_s *epc, uint8_t funcno,
@@ -472,6 +484,7 @@ int pci_epc_set_msix(FAR struct pci_epc_ctrl_s *epc, uint8_t funcno,
  *
  * Returned Value:
  *    None
+ *
  ****************************************************************************/
 
 void pci_epc_unmap_addr(FAR struct pci_epc_ctrl_s *epc, uint8_t funcno,
@@ -494,6 +507,7 @@ void pci_epc_unmap_addr(FAR struct pci_epc_ctrl_s *epc, uint8_t funcno,
  *
  * Returned Value:
  *    Return 0 if success, negative if failed
+ *
  ****************************************************************************/
 
 int pci_epc_map_addr(FAR struct pci_epc_ctrl_s *epc, uint8_t funcno,
@@ -514,6 +528,7 @@ int pci_epc_map_addr(FAR struct pci_epc_ctrl_s *epc, uint8_t funcno,
  *
  * Returned Value:
  *    None
+ *
  ****************************************************************************/
 
 void pci_epc_clear_bar(FAR struct pci_epc_ctrl_s *epc, uint8_t funcno,
@@ -534,6 +549,7 @@ void pci_epc_clear_bar(FAR struct pci_epc_ctrl_s *epc, uint8_t funcno,
  *
  * Returned Value:
  *    Return 0 if success, negative if failed
+ *
  ****************************************************************************/
 
 int pci_epc_set_bar(FAR struct pci_epc_ctrl_s *epc, uint8_t funcno,
@@ -558,6 +574,7 @@ int pci_epc_set_bar(FAR struct pci_epc_ctrl_s *epc, uint8_t funcno,
  *
  * Returned Value:
  *    Return 0 if success, negative if failed
+ *
  ****************************************************************************/
 
 int pci_epc_write_header(FAR struct pci_epc_ctrl_s *epc, uint8_t funcno,
@@ -581,6 +598,7 @@ int pci_epc_write_header(FAR struct pci_epc_ctrl_s *epc, uint8_t funcno,
  *
  * Returned Value:
  *   Return 0 if success, negative if failed
+ *
  ****************************************************************************/
 
 int pci_epc_add_epf(FAR struct pci_epc_ctrl_s *epc,
@@ -601,6 +619,7 @@ int pci_epc_add_epf(FAR struct pci_epc_ctrl_s *epc,
  *
  * Returned Value:
  *   None
+ *
  ****************************************************************************/
 
 void pci_epc_remove_epf(FAR struct pci_epc_ctrl_s *epc,
@@ -621,6 +640,7 @@ void pci_epc_remove_epf(FAR struct pci_epc_ctrl_s *epc,
  *
  * Returned Value:
  *   None
+ *
  ****************************************************************************/
 
 void pci_epc_linkup(FAR struct pci_epc_ctrl_s *epc);
@@ -640,6 +660,7 @@ void pci_epc_linkup(FAR struct pci_epc_ctrl_s *epc);
  *
  * Returned Value:
  *   None
+ *
  ****************************************************************************/
 
 void pci_epc_linkdown(FAR struct pci_epc_ctrl_s *epc);
@@ -659,6 +680,7 @@ void pci_epc_linkdown(FAR struct pci_epc_ctrl_s *epc);
  *
  * Returned Value:
  *   None
+ *
  ****************************************************************************/
 
 void pci_epc_init_notify(FAR struct pci_epc_ctrl_s *epc);
@@ -678,6 +700,7 @@ void pci_epc_init_notify(FAR struct pci_epc_ctrl_s *epc);
  *
  * Returned Value:
  *   None
+ *
  ****************************************************************************/
 
 void pci_epc_bme_notify(FAR struct pci_epc_ctrl_s *epc);
@@ -697,6 +720,7 @@ void pci_epc_bme_notify(FAR struct pci_epc_ctrl_s *epc);
  *
  * Returned Value:
  *   Return struct pci_epc_ctrl_s * if success, NULL if failed.
+ *
  ****************************************************************************/
 
 FAR struct pci_epc_ctrl_s *
@@ -716,6 +740,7 @@ pci_epc_create(FAR const char *name, FAR void *priv,
  *
  * Returned Value:
  *   None
+ *
  ****************************************************************************/
 
 void pci_epc_destroy(FAR struct pci_epc_ctrl_s *epc);
@@ -736,6 +761,7 @@ void pci_epc_destroy(FAR struct pci_epc_ctrl_s *epc);
  *
  * Returned Value:
  *   0 if success, negative if failed
+ *
  ****************************************************************************/
 
 int pci_epc_mem_multi_init(FAR struct pci_epc_ctrl_s *epc,
@@ -758,6 +784,7 @@ int pci_epc_mem_multi_init(FAR struct pci_epc_ctrl_s *epc,
  *
  * Returned Value:
  *   0 if success, negative if failed
+ *
  ****************************************************************************/
 
 int pci_epc_mem_init(FAR struct pci_epc_ctrl_s *epc, FAR void *virt,
@@ -777,6 +804,7 @@ int pci_epc_mem_init(FAR struct pci_epc_ctrl_s *epc, FAR void *virt,
  *
  * Returned Value:
  *   None
+ *
  ****************************************************************************/
 
 void pci_epc_mem_exit(FAR struct pci_epc_ctrl_s *epc);
@@ -797,6 +825,7 @@ void pci_epc_mem_exit(FAR struct pci_epc_ctrl_s *epc);
  *
  * Returned Value:
  *   The memory address alloced if success, NULL if failed
+ *
  ****************************************************************************/
 
 FAR void *pci_epc_mem_alloc_addr(FAR struct pci_epc_ctrl_s *epc,
@@ -817,6 +846,7 @@ FAR void *pci_epc_mem_alloc_addr(FAR struct pci_epc_ctrl_s *epc,
  *
  * Returned Value:
  *   None
+ *
  ****************************************************************************/
 
 void pci_epc_mem_free_addr(FAR struct pci_epc_ctrl_s *epc,

include/nuttx/pci/pci_epf.h

@@ -223,6 +223,7 @@ struct pci_epf_msix_tbl_s
  *
  * Returned Value:
  *    Return >= 0 if success, < 0 if failed
+ *
  ****************************************************************************/
 
 int pci_epf_device_register(FAR struct pci_epf_device_s *epf);
@@ -240,6 +241,7 @@ int pci_epf_device_register(FAR struct pci_epf_device_s *epf);
  *
  * Returned Value:
  *    Return >= 0 if success, < 0 if failed
+ *
  ****************************************************************************/
 
 int pci_epf_device_unregister(FAR struct pci_epf_device_s *epf);
@@ -255,6 +257,7 @@ int pci_epf_device_unregister(FAR struct pci_epf_device_s *epf);
  *
  * Returned Value:
  *    Return >= 0 if success, < 0 if failed
+ *
  ****************************************************************************/
 
 int pci_epf_register_driver(FAR struct pci_epf_driver_s *drv);
@@ -272,6 +275,7 @@ int pci_epf_register_driver(FAR struct pci_epf_driver_s *drv);
  *
  * Returned Value:
  *    Return >= 0 if success, < 0 if failed
+ *
  ****************************************************************************/
 
 int pci_epf_unregister_driver(FAR struct pci_epf_driver_s *drv);
@@ -293,6 +297,7 @@ int pci_epf_unregister_driver(FAR struct pci_epf_driver_s *drv);
  *
  * Returned Value:
  *   Return space address malloced if success, otherwise NULL
+ *
  ****************************************************************************/
 
 FAR void *pci_epf_alloc_space(FAR struct pci_epf_device_s *epf, int barno,
@@ -313,6 +318,7 @@ FAR void *pci_epf_alloc_space(FAR struct pci_epf_device_s *epf, int barno,
  *
  * Returned Value:
  *   None
+ *
  ****************************************************************************/
 
 void pci_epf_free_space(FAR struct pci_epf_device_s *epf,