X-Git-Url: http://git.droids-corp.org/?a=blobdiff_plain;f=lib%2Fdmadev%2Frte_dmadev.h;h=ad9e7a09758f89387040d631798376c8ba93827f;hb=ec487c189686ee9b3b7551d3aca138cec3f91e74;hp=a0824be20d0a7d2a442aeed831229f9138935482;hpb=ea8cf0f8536d7d37c83cfdfe70fda85ff924c8a0;p=dpdk.git diff --git a/lib/dmadev/rte_dmadev.h b/lib/dmadev/rte_dmadev.h index a0824be20d..ad9e7a0975 100644 --- a/lib/dmadev/rte_dmadev.h +++ b/lib/dmadev/rte_dmadev.h @@ -149,7 +149,6 @@ #include #include #include -#include #ifdef __cplusplus extern "C" { @@ -220,6 +219,24 @@ bool rte_dma_is_valid(int16_t dev_id); __rte_experimental uint16_t rte_dma_count_avail(void); +/** + * Iterates over valid dmadev instances. + * + * @param start_dev_id + * The id of the next possible dmadev. + * @return + * Next valid dmadev, UINT16_MAX if there is none. + */ +__rte_experimental +int16_t rte_dma_next_dev(int16_t start_dev_id); + +/** Utility macro to iterate over all available dmadevs */ +#define RTE_DMA_FOREACH_DEV(p) \ + for (p = rte_dma_next_dev(0); \ + p != -1; \ + p = rte_dma_next_dev(p + 1)) + + /**@{@name DMA capability * @see struct rte_dma_info::dev_capa */ @@ -244,6 +261,14 @@ uint16_t rte_dma_count_avail(void); * @see struct rte_dma_conf::silent_mode */ #define RTE_DMA_CAPA_SILENT RTE_BIT64(5) +/** Supports error handling + * + * With this bit set, invalid input addresses will be reported as operation failures + * to the user but other operations can continue. + * Without this bit set, invalid data is not handled by either HW or driver, so user + * must ensure that all memory addresses are valid and accessible by HW. + */ +#define RTE_DMA_CAPA_HANDLES_ERRORS RTE_BIT64(6) /** Support copy operation. * This capability start with index of 32, so that it could leave gap between * normal capability and ops capability. @@ -507,7 +532,7 @@ struct rte_dma_port_param { * @note If some fields can not be supported by the * hardware/driver, then the driver ignores those fields. * Please check driver-specific documentation for limitations - * and capablites. + * and capabilities. */ __extension__ struct { @@ -705,7 +730,7 @@ enum rte_dma_status_code { /** The operation completed successfully. */ RTE_DMA_STATUS_SUCCESSFUL, /** The operation failed to complete due abort by user. - * This is mainly used when processing dev_stop, user could modidy the + * This is mainly used when processing dev_stop, user could modify the * descriptors (e.g. change one bit to tell hardware abort this job), * it allows outstanding requests to be complete as much as possible, * so reduce the time to stop the device. @@ -1100,7 +1125,7 @@ rte_dma_burst_capacity(int16_t dev_id, uint16_t vchan) #ifdef RTE_DMADEV_DEBUG if (!rte_dma_is_valid(dev_id)) return 0; - RTE_FUNC_PTR_OR_ERR_RET(*obbj->burst_capacity, 0); + RTE_FUNC_PTR_OR_ERR_RET(*obj->burst_capacity, 0); #endif return (*obj->burst_capacity)(obj->dev_private, vchan); }