X-Git-Url: https://gerrit.fd.io/r/gitweb?a=blobdiff_plain;f=src%2Fvnet%2Ffib%2Ffib_table.h;h=a11f056033803d555fd84ccbe7e7cb8250dfb938;hb=cbe25aab3be72154f2c706c39eeba6a77f34450f;hp=8a0c73968fb752f51dd776c4889da4c84a44c68f;hpb=c87aafad759f92ae630fec52079a08ace607410b;p=vpp.git diff --git a/src/vnet/fib/fib_table.h b/src/vnet/fib/fib_table.h index 8a0c73968fb..a11f0560338 100644 --- a/src/vnet/fib/fib_table.h +++ b/src/vnet/fib/fib_table.h @@ -23,10 +23,46 @@ #include /** - * Keep a lock per-source and a total + * Flags for the source data */ -#define FIB_TABLE_N_LOCKS (FIB_SOURCE_MAX+1) -#define FIB_TABLE_TOTAL_LOCKS FIB_SOURCE_MAX +typedef enum fib_table_attribute_t_ { + /** + * Marker. Add new values after this one. + */ + FIB_TABLE_ATTRIBUTE_FIRST, + /** + * the table is for IP6 link local addresses + */ + FIB_TABLE_ATTRIBUTE_IP6_LL = FIB_TABLE_ATTRIBUTE_FIRST, + /** + * the table is currently resync-ing + */ + FIB_TABLE_ATTRIBUTE_RESYNC, + /** + * Marker. add new entries before this one. + */ + FIB_TABLE_ATTRIBUTE_LAST = FIB_TABLE_ATTRIBUTE_RESYNC, +} fib_table_attribute_t; + +#define FIB_TABLE_ATTRIBUTE_MAX (FIB_TABLE_ATTRIBUTE_LAST+1) + +#define FIB_TABLE_ATTRIBUTES { \ + [FIB_TABLE_ATTRIBUTE_IP6_LL] = "ip6-ll", \ + [FIB_TABLE_ATTRIBUTE_RESYNC] = "resync", \ +} + +#define FOR_EACH_FIB_TABLE_ATTRIBUTE(_item) \ + for (_item = FIB_TABLE_ATTRIBUTE_FIRST; \ + _item < FIB_TABLE_ATTRIBUTE_MAX; \ + _item++) + +typedef enum fib_table_flags_t_ { + FIB_TABLE_FLAG_NONE = 0, + FIB_TABLE_FLAG_IP6_LL = (1 << FIB_TABLE_ATTRIBUTE_IP6_LL), + FIB_TABLE_FLAG_RESYNC = (1 << FIB_TABLE_ATTRIBUTE_RESYNC), +} __attribute__ ((packed)) fib_table_flags_t; + +extern u8* format_fib_table_flags(u8 *s, va_list *args); /** * @brief @@ -39,10 +75,16 @@ typedef struct fib_table_t_ */ fib_protocol_t ft_proto; + /** + * Table flags + */ + fib_table_flags_t ft_flags; + /** * per-source number of locks on the table */ - u16 ft_locks[FIB_TABLE_N_LOCKS]; + u16 *ft_locks; + u32 ft_total_locks; /** * Table ID (hash key) for this FIB. @@ -62,13 +104,18 @@ typedef struct fib_table_t_ /** * Per-source route counters */ - u32 ft_src_route_counts[FIB_SOURCE_MAX]; + u32 *ft_src_route_counts; /** * Total route counters */ u32 ft_total_route_counts; + /** + * Epoch - number of resyncs performed + */ + u32 ft_epoch; + /** * Table description */ @@ -299,7 +346,7 @@ extern fib_node_index_t fib_table_entry_path_add(u32 fib_index, u32 next_hop_sw_if_index, u32 next_hop_fib_index, u32 next_hop_weight, - mpls_label_t *next_hop_label_stack, + fib_mpls_label_t *next_hop_label_stack, fib_route_path_flags_t pf); /** * @brief @@ -482,7 +529,7 @@ extern fib_node_index_t fib_table_entry_update_one_path(u32 fib_index, u32 next_hop_sw_if_index, u32 next_hop_fib_index, u32 next_hop_weight, - mpls_label_t *next_hop_label_stack, + fib_mpls_label_t *next_hop_label_stack, fib_route_path_flags_t pf); /** @@ -555,6 +602,17 @@ extern void fib_table_entry_delete(u32 fib_index, extern void fib_table_entry_delete_index(fib_node_index_t entry_index, fib_source_t source); +/** + * @brief + * Return the stats index for a FIB entry + * @param fib_index + * The table's FIB index + * @param prefix + * The entry's prefix's + */ +extern u32 fib_table_entry_get_stats_index(u32 fib_index, + const fib_prefix_t *prefix); + /** * @brief * Flush all entries from a table for the source @@ -572,6 +630,46 @@ extern void fib_table_flush(u32 fib_index, fib_protocol_t proto, fib_source_t source); +/** + * @brief + * Resync all entries from a table for the source + * this is the mark part of the mark and sweep algorithm. + * All entries in this FIB that are sourced by 'source' are marked + * as stale. + * + * @param fib_index + * The index of the FIB + * + * @paran proto + * The protocol of the entries in the table + * + * @param source + * the source to flush + */ +extern void fib_table_mark(u32 fib_index, + fib_protocol_t proto, + fib_source_t source); + +/** + * @brief + * Signal that the table has converged, i.e. all updates are complete. + * this is the sweep part of the mark and sweep algorithm. + * All entries in this FIB that are sourced by 'source' and marked + * as stale are flushed. + * + * @param fib_index + * The index of the FIB + * + * @paran proto + * The protocol of the entries in the table + * + * @param source + * the source to flush + */ +extern void fib_table_sweep(u32 fib_index, + fib_protocol_t proto, + fib_source_t source); + /** * @brief * Get the index of the FIB bound to the interface @@ -604,6 +702,21 @@ extern u32 fib_table_get_index_for_sw_if_index(fib_protocol_t proto, extern u32 fib_table_get_table_id_for_sw_if_index(fib_protocol_t proto, u32 sw_if_index); +/** + * @brief + * Get the Table-ID of the FIB from protocol and index + * + * @param fib_index + * The FIB index + * + * @paran proto + * The protocol of the FIB (and thus the entries therein) + * + * @return fib_index + * The tableID of the FIB + */ +extern u32 fib_table_get_table_id(u32 fib_index, fib_protocol_t proto); + /** * @brief * Get the index of the FIB for a Table-ID. This DOES NOT create the @@ -792,11 +905,30 @@ extern u32 fib_table_get_num_entries(u32 fib_index, extern fib_table_t *fib_table_get(fib_node_index_t index, fib_protocol_t proto); +/** + * @brief return code controlling how a table walk proceeds + */ +typedef enum fib_table_walk_rc_t_ +{ + /** + * Continue on to the next entry + */ + FIB_TABLE_WALK_CONTINUE, + /** + * Do no traverse down this sub-tree + */ + FIB_TABLE_WALK_SUB_TREE_STOP, + /** + * Stop the walk completely + */ + FIB_TABLE_WALK_STOP, +} fib_table_walk_rc_t; + /** * @brief Call back function when walking entries in a FIB table */ -typedef int (*fib_table_walk_fn_t)(fib_node_index_t fei, - void *ctx); +typedef fib_table_walk_rc_t (*fib_table_walk_fn_t)(fib_node_index_t fei, + void *ctx); /** * @brief Walk all entries in a FIB table @@ -808,9 +940,29 @@ extern void fib_table_walk(u32 fib_index, fib_table_walk_fn_t fn, void *ctx); +/** + * @brief Walk all entries in a sub-tree FIB table. The 'root' paraneter + * is the prefix at the root of the sub-tree. + * N.B: This is NOT safe to deletes. If you need to delete walk the whole + * table and store elements in a vector, then delete the elements + */ +extern void fib_table_sub_tree_walk(u32 fib_index, + fib_protocol_t proto, + const fib_prefix_t *root, + fib_table_walk_fn_t fn, + void *ctx); + /** * @brief format (display) the memory used by the FIB tables */ extern u8 *format_fib_table_memory(u8 *s, va_list *args); +/** + * Debug function + */ +#ifdef CLIB_DEBUG +extern void fib_table_assert_empty(const fib_table_t *fib_table); +#endif + + #endif