drivers/pci: fix style issues in function headers

fix style issues in function headers, add missing new lines
This commit is contained in:
raiden00pl
2024-11-15 01:04:10 +08:00
committed by Xiang Xiao
parent 45c4350cf1
commit 6fcfe7cf03
6 changed files with 85 additions and 0 deletions
+30
View File
@@ -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,
+6
View File
@@ -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,