@@ -138,6 +138,8 @@ typedef void (*compressdev_stats_reset_t)(struct rte_compressdev *dev);
*
* @param dev
* Compress device
+ * @param dev_info
+ * Compress device informations to populate
*/
typedef void (*compressdev_info_get_t)(struct rte_compressdev *dev,
struct rte_compressdev_info *dev_info);
@@ -121,7 +121,7 @@ extern struct rte_cryptodev *rte_cryptodevs;
* Function used to configure device.
*
* @param dev Crypto device pointer
- * config Crypto device configurations
+ * @param config Crypto device configurations
*
* @return Returns 0 on success
*/
@@ -176,7 +176,8 @@ typedef void (*cryptodev_stats_reset_t)(struct rte_cryptodev *dev);
/**
* Function used to get specific information of a device.
*
- * @param dev Crypto device pointer
+ * @param dev Crypto device pointer
+ * @param dev_info Pointer to infos structure to populate
*/
typedef void (*cryptodev_info_get_t)(struct rte_cryptodev *dev,
struct rte_cryptodev_info *dev_info);
@@ -213,7 +214,7 @@ typedef int (*cryptodev_queue_pair_release_t)(struct rte_cryptodev *dev,
*
* @param dev Crypto device pointer
* @param nb_objs number of sessions objects in mempool
- * @param obj_cache l-core object cache size, see *rte_ring_create*
+ * @param obj_cache_size l-core object cache size, see *rte_ring_create*
* @param socket_id Socket Id to allocate mempool on.
*
* @return
@@ -253,7 +254,7 @@ typedef unsigned int (*cryptodev_asym_get_session_private_size_t)(
*
* @param dev Crypto device pointer
* @param xform Single or chain of crypto xforms
- * @param priv_sess Pointer to cryptodev's private session structure
+ * @param session Pointer to cryptodev's private session structure
* @param mp Mempool where the private session is allocated
*
* @return
@@ -271,7 +272,7 @@ typedef int (*cryptodev_sym_configure_session_t)(struct rte_cryptodev *dev,
*
* @param dev Crypto device pointer
* @param xform Single or chain of crypto xforms
- * @param priv_sess Pointer to cryptodev's private session structure
+ * @param session Pointer to cryptodev's private session structure
* @param mp Mempool where the private session is allocated
*
* @return
@@ -333,7 +334,6 @@ typedef int (*cryptodev_sym_get_raw_dp_ctx_size_t)(struct rte_cryptodev *dev);
*
* @param dev Crypto device pointer.
* @param qp_id Crypto device queue pair index.
- * @param service_type Type of the service requested.
* @param ctx The raw data-path context data.
* @param sess_type session type.
* @param session_ctx Session context data. If NULL the driver
@@ -52,7 +52,7 @@ typedef void (*rte_keepalive_failure_callback_t)(
* @param data Data pointer passed to rte_keepalive_register_relay_callback()
* @param id_core ID of the core for which state is being reported
* @param core_state The current state of the core
- * @param Timestamp of when core was last seen alive
+ * @param last_seen Timestamp of when core was last seen alive
*/
typedef void (*rte_keepalive_relay_callback_t)(
void *data,
@@ -297,7 +297,7 @@ typedef void (*eventdev_port_release_t)(void *port);
* Event device pointer
* @param port
* Event port pointer
- * @param link
+ * @param queues
* Points to an array of *nb_links* event queues to be linked
* to the event port.
* @param priorities
@@ -383,6 +383,10 @@ typedef void (*eventdev_dump_t)(struct rte_eventdev *dev, FILE *f);
*
* @param dev
* Event device pointer
+ * @param mode
+ * Level (device, port or queue)
+ * @param queue_port_id
+ * Queue or port number depending on mode
* @param ids
* The stat ids to retrieve
* @param values
@@ -410,8 +414,14 @@ typedef int (*eventdev_xstats_reset_t)(struct rte_eventdev *dev,
*
* @param dev
* Event device pointer
+ * @param mode
+ * Level (device, port or queue)
+ * @param queue_port_id
+ * Queue or port number depending on mode
* @param xstats_names
* Array of name values to be filled in
+ * @param ids
+ * The stat ids to retrieve
* @param size
* Number of values in the xstats_names array
* @return
@@ -186,7 +186,7 @@ typedef int (*rte_port_out_op_tx)(
*/
typedef int (*rte_port_out_op_tx_bulk)(
void *port,
- struct rte_mbuf **pkt,
+ struct rte_mbuf **pkts,
uint64_t pkts_mask);
/**
@@ -50,7 +50,7 @@ typedef void *
/**
* Input port free
*
- * @param[in] args
+ * @param[in] port
* Input port handle.
*/
typedef void
@@ -129,7 +129,7 @@ typedef void *
/**
* Output port free
*
- * @param[in] args
+ * @param[in] port
* Output port handle.
*/
typedef void
@@ -155,6 +155,8 @@ typedef int (*rawdev_info_get_t)(struct rte_rawdev *dev,
* Raw device pointer
* @param config
* Void object containing device specific configuration
+ * @param config_size
+ * Size of the memory allocated for the configuration
*
* @return
* Returns 0 on success
@@ -214,6 +216,8 @@ typedef int (*rawdev_reset_t)(struct rte_rawdev *dev);
* Raw device queue index
* @param[out] queue_conf
* Raw device queue configuration structure
+ * @param queue_conf_size
+ * Size of the memory allocated for the configuration
*
* @return
* Returns 0 on success, negative errno on failure
@@ -232,6 +236,8 @@ typedef int (*rawdev_queue_conf_get_t)(struct rte_rawdev *dev,
* Rawqueue index
* @param queue_conf
* Rawqueue configuration structure
+ * @param queue_conf_size
+ * Size of the memory allocated for the configuration
*
* @return
* Returns 0 on success.
@@ -263,7 +269,7 @@ typedef int (*rawdev_queue_release_t)(struct rte_rawdev *dev,
* This function helps in getting queue count supported, independently. It
* can help in cases where iterator needs to be implemented.
*
- * @param
+ * @param dev
* Raw device pointer
* @return
* Number of queues; 0 is assumed to be a valid response.
@@ -279,7 +285,7 @@ typedef uint16_t (*rawdev_queue_count_t)(struct rte_rawdev *dev);
*
* @param dev
* Raw device pointer
- * @param bufs
+ * @param buffers
* array of buffers
* @param count
* number of buffers passed
@@ -303,7 +309,7 @@ typedef int (*rawdev_enqueue_bufs_t)(struct rte_rawdev *dev,
*
* @param dev
* Raw device pointer
- * @param bufs
+ * @param buffers
* array of buffers
* @param count
* Max buffers expected to be dequeued
@@ -444,7 +450,7 @@ typedef uint64_t (*rawdev_xstats_get_by_name_t)(const struct rte_rawdev *dev,
*
* @param dev
* Raw device pointer
- * @param status
+ * @param status_info
* void block containing device specific status information
* @return
* 0 for success,
@@ -472,8 +478,8 @@ typedef int (*rawdev_firmware_version_get_t)(struct rte_rawdev *dev,
*
* @param dev
* Raw device pointer
- * @param firmware_file
- * file pointer to firmware area
+ * @param firmware_buf
+ * Pointer to firmware image
* @return
* >0, ~0: for successful load
* <0: for failure
@@ -41,7 +41,7 @@ typedef int (*security_session_create_t)(void *device,
/**
* Free driver private session data.
*
- * @param dev Crypto/eth device pointer
+ * @param device Crypto/eth device pointer
* @param sess Security session structure
*/
typedef int (*security_session_destroy_t)(void *device,
@@ -95,16 +95,17 @@ int rte_security_dynfield_register(void);
/**
* Update the mbuf with provided metadata.
*
+ * @param device Crypto/eth device pointer
* @param sess Security session structure
* @param mb Packet buffer
- * @param mt Metadata
+ * @param params Metadata
*
* @return
* - Returns 0 if metadata updated successfully.
* - Returns -ve value for errors.
*/
typedef int (*security_set_pkt_metadata_t)(void *device,
- struct rte_security_session *sess, struct rte_mbuf *m,
+ struct rte_security_session *sess, struct rte_mbuf *mb,
void *params);
/**
@@ -127,12 +127,6 @@ typedef uint64_t
* progress and it is passed as a parameter to the lookup operation. This allows
* for multiple concurrent lookup operations into the same table.
*
- * @param[in] params
- * Table creation parameters.
- * @param[in] entries
- * Entries to be added to the table at creation time.
- * @param[in] args
- * Any additional table create arguments. It may be NULL.
* @return
* Table memory footprint in bytes, on success, or zero, on error.
*/
@@ -129,7 +129,7 @@ typedef int (*rte_table_op_entry_delete)(
*
* @param table
* Handle to lookup table instance
- * @param key
+ * @param keys
* Array containing lookup keys
* @param entries
* Array containing data to be associated with each key. Every item in the
@@ -166,7 +166,7 @@ typedef int (*rte_table_op_entry_add_bulk)(
*
* @param table
* Handle to lookup table instance
- * @param key
+ * @param keys
* Array containing lookup keys
* @param n_keys
* Number of keys to delete