/**
* Function for checking a CPU flag availability
*
- * @param flag
+ * @param feature
* CPU flag to query CPU for
* @return
* 1 if flag is available
/**
* Aligns 64b input parameter to the next power of 2
*
- * @param x
- * The 64b value to algin
+ * @param v
+ * The 64b value to align
*
* @return
* Input parameter aligned to the next power of 2
/** Take a macro value and get a string version of it */
#define RTE_STR(x) _RTE_STR(x)
-/** Mask value of type <tp> for the first <ln> bit set. */
+/** Mask value of type "tp" for the first "ln" bit set. */
#define RTE_LEN2MASK(ln, tp) \
((tp)((uint64_t)-1 >> (sizeof(uint64_t) * CHAR_BIT - (ln))))
*
* The function never returns.
*
- * @param format
- * The format string
- * @param args
- * The variable list of arguments.
+ * @param ...
+ * The format string, followed by the variable list of arguments.
*/
#define rte_panic(...) rte_panic_(__func__, __VA_ARGS__, "dummy")
#define rte_panic_(func, format, ...) __rte_panic(func, format "%.0s", __VA_ARGS__)
*
* @param devtype
* The type of the device.
- * @param devargs_list
+ * @param devargs_str
* The arguments as given by the user.
*
* @return
* This routine is optional for the application and will behave as if the set
* routine was never called as the default behavior.
*
- * @param func
+ * @param usage_func
* The func argument is a function pointer to the application usage routine.
* Called function is defined using rte_usage_hook_t typedef, which is of
* the form void rte_usage_func(const char * prgname).
* the caller to daisy chain the usage routines if needing more then one.
*/
rte_usage_hook_t
-rte_set_application_usage_hook( rte_usage_hook_t usage_func );
+rte_set_application_usage_hook(rte_usage_hook_t usage_func);
/**
* macro to get the lock of tailq in mem_config
* @param t
* The log type, for example, EAL. The short name is expanded by the
* macro, so it cannot be an integer value.
- * @param fmt
+ * @param ...
* The fmt string, as in printf(3), followed by the variable arguments
* required by the format.
- * @param args
- * The variable list of arguments according to the format string.
* @return
* - 0: Success.
* - Negative on error.
* @param f
* A pointer to a file for output
*/
-void rte_memzone_dump(FILE *);
+void rte_memzone_dump(FILE *f);
/**
* Walk list of all memzones
RTE_ETH_FILTER_OP_MAX
};
-/*
+/**
* MAC filter type
*/
enum rte_mac_filter_type {
typedef uint32_t (*eth_rx_queue_count_t)(struct rte_eth_dev *dev,
uint16_t rx_queue_id);
-/**< @Get number of available descriptors on a receive queue of an Ethernet device. */
+/**< @internal Get number of available descriptors on a receive queue of an Ethernet device. */
typedef int (*eth_rx_descriptor_done_t)(void *rxq, uint16_t offset);
-/**< @Check DD bit of specific RX descriptor */
+/**< @internal Check DD bit of specific RX descriptor */
typedef int (*mtu_set_t)(struct rte_eth_dev *dev, uint16_t mtu);
/**< @internal Set MTU. */
void *param;
};
-/*
- * The eth device type
+/**
+ * The eth device type.
*/
enum rte_eth_dev_type {
RTE_ETH_DEV_UNKNOWN, /**< unknown device type */
*
* @param port_id
* The port identifier of the device to detach.
- * @param addr
+ * @param devname
* A pointer to a device name actually detached.
* @return
* 0 on success and devname is filled, negative on error
* The port identifier of the Ethernet device.
* @param queue_id
* The queue id on the specific port.
- * @offset
+ * @param offset
* The offset of the descriptor ID from tail.
* @return
* - (1) if the specific DD bit is set.
*
* @param port
* The port identifier of the Ethernet device.
- * @param state
+ * @param new_state
* The current bypass state.
* - (1) Normal mode
* - (2) Bypass mode
*
* @param port
* The port identifier of the Ethernet device.
- * @param state
+ * @param timeout
* The timeout to be set.
* - (0) 0 seconds (timer is off)
* - (1) 1.5 seconds
* since the it may still be in use. The memory for the callback can be
* subsequently freed back by the application by calling rte_free():
*
- * - Immediately - if the port is stopped, or the user knows that no
- * callbacks are in flight e.g. if called from the thread doing RX/TX
- * on that queue.
+ * - Immediately - if the port is stopped, or the user knows that no
+ * callbacks are in flight e.g. if called from the thread doing RX/TX
+ * on that queue.
*
* - After a short delay - where the delay is sufficient to allow any
* in-flight callbacks to complete.
* since the it may still be in use. The memory for the callback can be
* subsequently freed back by the application by calling rte_free():
*
- * - Immediately - if the port is stopped, or the user knows that no
- * callbacks are in flight e.g. if called from the thread doing RX/TX
- * on that queue.
+ * - Immediately - if the port is stopped, or the user knows that no
+ * callbacks are in flight e.g. if called from the thread doing RX/TX
+ * on that queue.
*
* - After a short delay - where the delay is sufficient to allow any
* in-flight callbacks to complete.
* A pointer to buffer contains the formatted MAC address.
* @param size
* The format buffer size.
- * @param ea_to
+ * @param eth_addr
* A pointer to a ether_addr structure.
*/
static inline void
extern int rte_kni_unregister_handlers(struct rte_kni *kni);
/**
- * close KNI device.
- *
- * @param void
- *
- * @return
- * void
+ * Close KNI device.
*/
extern void rte_kni_close(void);
* The flags used for the mempool creation.
* Consult rte_mempool_create() for more information about possible values.
* The size of each element.
+ * @param sz
+ * The calculated detailed size the mempool object. May be NULL.
* @return
* Total size of the mempool object.
*/
/**
* Unset the global environment configuration.
* This can only be called after all threads have completed.
- *
- * @param None.
- *
- * @return
- * None.
*/
void rte_power_unset_env(void);
/**
* Get the default power management implementation.
*
- * @param None.
- *
* @return
* power_management_env The configured environment.
*/
* Exit power management on a specific lcore. This will call the environment
* dependent exit function.
*
- *
* @param lcore_id
* lcore id.
*
git.droids-corp.org / dpdk.git / commitdiff