Skip to contentSkip to conversation

ntb: Fix kernel-doc param for ntb_transport_create_queue

PATCH In review Yang Li 2 participants 2 messages Jun 7, 2024 NTB driver core

lore
Share & tools
lore

Yang Li

author
#0 lore raw

PATCH v2 1/1 ntb: Fix kernel-doc param for ntb_transport_create_queue

The patch updates ntb_transport_create_queue() kdoc header to specify the correct input parameters used by the function.

---
 drivers/ntb/ntb_transport.c | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)
drivers/ntb/ntb_transport.c +4 -3
index f9e7847a378e..5d466a3f117b 100644
@@ -1966,9 +1966,10 @@ static bool ntb_dma_filter_fn(struct dma_chan *chan, void *node)
 
 /**
  * ntb_transport_create_queue - Create a new NTB transport layer queue
- * @rx_handler: receive callback function
- * @tx_handler: transmit callback function
- * @event_handler: event callback function
+ * @data: user-defined data to associate with the queue
+ * @client_dev: the device structure of the NTB client
+ * @handlers: structure containing receive, transmit, and event callback
+ *	      functions
  *
  * Create a new NTB transport layer queue and provide the queue with a callback
  * routine for both transmit and receive.  The receive callback routine will be
Signature · 1 line
2.20.1.7.g153144c
maintainer Reviewed-by on v2 1/1
#1 lore raw
Quoted 4 lines · Yang Li

The patch updates ntb_transport_create_queue() kdoc header to specify the correct input parameters used by the function.

Thank you!

Quoted 1 line

---

I do recommend attaching the revision history below the '---' line next time for common patch posting practice. Thanks

Quoted 21 lines
 drivers/ntb/ntb_transport.c | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)
drivers/ntb/ntb_transport.c +4 -3
index f9e7847a378e..5d466a3f117b 100644
@@ -1966,9 +1966,10 @@ static bool ntb_dma_filter_fn(struct dma_chan *chan, void *node)
 
 /**
  * ntb_transport_create_queue - Create a new NTB transport layer queue
- * @rx_handler: receive callback function
- * @tx_handler: transmit callback function
- * @event_handler: event callback function
+ * @data: user-defined data to associate with the queue
+ * @client_dev: the device structure of the NTB client
+ * @handlers: structure containing receive, transmit, and event callback
+ *	      functions
  *
  * Create a new NTB transport layer queue and provide the queue with a callback
  * routine for both transmit and receive.  The receive callback routine will be