test/telemetry: fix typo at beginning of line
[dpdk.git] / lib / librte_fib / rte_fib.h
index d06c5ef..fef0749 100644 (file)
@@ -8,12 +8,23 @@
 
 /**
  * @file
+ *
+ * RTE FIB library.
+ *
+ * @warning
+ * @b EXPERIMENTAL:
+ * All functions in this file may be changed or removed without prior notice.
+ *
  * FIB (Forwarding information base) implementation
  * for IPv4 Longest Prefix Match
  */
 
 #include <rte_compat.h>
 
+#ifdef __cplusplus
+extern "C" {
+#endif
+
 struct rte_fib;
 struct rte_rib;
 
@@ -23,8 +34,7 @@ struct rte_rib;
 /** Type of FIB struct */
 enum rte_fib_type {
        RTE_FIB_DUMMY,          /**< RIB tree based FIB */
-       RTE_FIB_DIR24_8,        /**< DIR24_8 based FIB */
-       RTE_FIB_TYPE_MAX
+       RTE_FIB_DIR24_8         /**< DIR24_8 based FIB */
 };
 
 /** Modify FIB function */
@@ -47,6 +57,25 @@ enum rte_fib_dir24_8_nh_sz {
        RTE_FIB_DIR24_8_8B
 };
 
+/** Type of lookup function implementation */
+enum rte_fib_lookup_type {
+       RTE_FIB_LOOKUP_DEFAULT,
+       /**< Selects the best implementation based on the max simd bitwidth */
+       RTE_FIB_LOOKUP_DIR24_8_SCALAR_MACRO,
+       /**< Macro based lookup function */
+       RTE_FIB_LOOKUP_DIR24_8_SCALAR_INLINE,
+       /**<
+        * Lookup implementation using inlined functions
+        * for different next hop sizes
+        */
+       RTE_FIB_LOOKUP_DIR24_8_SCALAR_UNI,
+       /**<
+        * Unified lookup function for all next hop sizes
+        */
+       RTE_FIB_LOOKUP_DIR24_8_VECTOR_AVX512
+       /**< Vector implementation using AVX512 */
+};
+
 /** FIB configuration structure */
 struct rte_fib_conf {
        enum rte_fib_type type; /**< Type of FIB struct */
@@ -185,4 +214,24 @@ __rte_experimental
 struct rte_rib *
 rte_fib_get_rib(struct rte_fib *fib);
 
+/**
+ * Set lookup function based on type
+ *
+ * @param fib
+ *   FIB object handle
+ * @param type
+ *   type of lookup function
+ *
+ * @return
+ *   0 on success
+ *   -EINVAL on failure
+ */
+__rte_experimental
+int
+rte_fib_select_lookup(struct rte_fib *fib, enum rte_fib_lookup_type type);
+
+#ifdef __cplusplus
+}
+#endif
+
 #endif /* _RTE_FIB_H_ */