]>
Commit | Line | Data |
---|---|---|
7ee30f28 DS |
1 | /* |
2 | * Nexthop Group structure definition. | |
3 | * Copyright (C) 2018 Cumulus Networks, Inc. | |
4 | * Donald Sharp | |
5 | * | |
6 | * This program is free software; you can redistribute it and/or modify it | |
7 | * under the terms of the GNU General Public License as published by the Free | |
8 | * Software Foundation; either version 2 of the License, or (at your option) | |
9 | * any later version. | |
10 | * | |
11 | * This program is distributed in the hope that it will be useful, but WITHOUT | |
12 | * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or | |
13 | * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for | |
14 | * more details. | |
15 | * | |
16 | * You should have received a copy of the GNU General Public License along | |
17 | * with this program; see the file COPYING; if not, write to the Free Software | |
18 | * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA | |
19 | */ | |
20 | ||
21 | #ifndef __NEXTHOP_GROUP__ | |
22 | #define __NEXTHOP_GROUP__ | |
23 | ||
1b7bce04 DS |
24 | #include <vty.h> |
25 | ||
5e244469 RW |
26 | #ifdef __cplusplus |
27 | extern "C" { | |
28 | #endif | |
29 | ||
7ee30f28 DS |
30 | /* |
31 | * What is a nexthop group? | |
32 | * | |
33 | * A nexthop group is a collection of nexthops that make up | |
34 | * the ECMP path for the route. | |
35 | * | |
36 | * This module provides a proper abstraction to this idea. | |
37 | */ | |
38 | struct nexthop_group { | |
39 | struct nexthop *nexthop; | |
40 | }; | |
41 | ||
31919191 DS |
42 | struct nexthop_group *nexthop_group_new(void); |
43 | void nexthop_group_delete(struct nexthop_group **nhg); | |
dba32923 | 44 | |
6c8b51e1 | 45 | void nexthop_group_copy(struct nexthop_group *to, |
c13bfa74 | 46 | const struct nexthop_group *from); |
e1f3a8eb MS |
47 | |
48 | /* | |
49 | * Copy a list of nexthops in 'nh' to an nhg, enforcing canonical sort order | |
50 | */ | |
51 | void nexthop_group_copy_nh_sorted(struct nexthop_group *nhg, | |
52 | const struct nexthop *nh); | |
53 | ||
deff170e | 54 | void copy_nexthops(struct nexthop **tnh, const struct nexthop *nh, |
7ee30f28 DS |
55 | struct nexthop *rparent); |
56 | ||
2f000944 | 57 | uint32_t nexthop_group_hash_no_recurse(const struct nexthop_group *nhg); |
1b1fe1c4 | 58 | uint32_t nexthop_group_hash(const struct nexthop_group *nhg); |
9ef49038 | 59 | void nexthop_group_mark_duplicates(struct nexthop_group *nhg); |
e4a1ec74 MS |
60 | |
61 | /* Add a nexthop to a list, enforcing the canonical sort order. */ | |
0eb97b86 MS |
62 | void nexthop_group_add_sorted(struct nexthop_group *nhg, |
63 | struct nexthop *nexthop); | |
1b1fe1c4 | 64 | |
7ee30f28 DS |
65 | /* The following for loop allows to iterate over the nexthop |
66 | * structure of routes. | |
67 | * | |
68 | * head: The pointer to the first nexthop in the chain. | |
69 | * | |
70 | * nexthop: The pointer to the current nexthop, either in the | |
71 | * top-level chain or in a resolved chain. | |
72 | */ | |
73 | #define ALL_NEXTHOPS(head, nhop) \ | |
74 | (nhop) = (head.nexthop); \ | |
75 | (nhop); \ | |
76 | (nhop) = nexthop_next(nhop) | |
31919191 | 77 | |
d826a734 MS |
78 | #define ALL_NEXTHOPS_PTR(head, nhop) \ |
79 | (nhop) = ((head)->nexthop); \ | |
80 | (nhop); \ | |
81 | (nhop) = nexthop_next(nhop) | |
82 | ||
c57bd6bb | 83 | |
0a8881b4 MS |
84 | #define NHGC_NAME_SIZE 80 |
85 | ||
31919191 DS |
86 | struct nexthop_group_cmd { |
87 | ||
88 | RB_ENTRY(nexthop_group_cmd) nhgc_entry; | |
89 | ||
0a8881b4 MS |
90 | char name[NHGC_NAME_SIZE]; |
91 | ||
92 | /* Name of group containing backup nexthops (if set) */ | |
93 | char backup_list_name[NHGC_NAME_SIZE]; | |
31919191 DS |
94 | |
95 | struct nexthop_group nhg; | |
96 | ||
c57bd6bb DS |
97 | struct list *nhg_list; |
98 | ||
31919191 DS |
99 | QOBJ_FIELDS |
100 | }; | |
101 | RB_HEAD(nhgc_entry_head, nexthp_group_cmd); | |
102 | RB_PROTOTYPE(nhgc_entry_head, nexthop_group_cmd, nhgc_entry, | |
103 | nexthop_group_cmd_compare) | |
104 | DECLARE_QOBJ_TYPE(nexthop_group_cmd) | |
105 | ||
106 | /* | |
107 | * Initialize nexthop_groups. If you are interested in when | |
108 | * a nexthop_group is added/deleted/modified, then set the | |
109 | * appropriate callback functions to handle it in your | |
110 | * code | |
111 | */ | |
112 | void nexthop_group_init( | |
d01b92fd | 113 | void (*create)(const char *name), |
31919191 DS |
114 | void (*add_nexthop)(const struct nexthop_group_cmd *nhgc, |
115 | const struct nexthop *nhop), | |
116 | void (*del_nexthop)(const struct nexthop_group_cmd *nhgc, | |
117 | const struct nexthop *nhop), | |
d01b92fd | 118 | void (*destroy)(const char *name)); |
31919191 | 119 | |
98cbbaea DS |
120 | void nexthop_group_enable_vrf(struct vrf *vrf); |
121 | void nexthop_group_disable_vrf(struct vrf *vrf); | |
122 | void nexthop_group_interface_state_change(struct interface *ifp, | |
123 | ifindex_t oldifindex); | |
124 | ||
8f8d9845 SW |
125 | extern struct nexthop *nexthop_exists(const struct nexthop_group *nhg, |
126 | const struct nexthop *nh); | |
2171b19c SW |
127 | /* This assumes ordered */ |
128 | extern bool nexthop_group_equal_no_recurse(const struct nexthop_group *nhg1, | |
129 | const struct nexthop_group *nhg2); | |
130 | ||
131 | /* This assumes ordered */ | |
8f8d9845 SW |
132 | extern bool nexthop_group_equal(const struct nexthop_group *nhg1, |
133 | const struct nexthop_group *nhg2); | |
d604266c DS |
134 | |
135 | extern struct nexthop_group_cmd *nhgc_find(const char *name); | |
136 | ||
1b7bce04 | 137 | extern void nexthop_group_write_nexthop(struct vty *vty, struct nexthop *nh); |
5e244469 | 138 | |
454192f4 DS |
139 | /* Return the number of nexthops in this nhg */ |
140 | extern uint8_t nexthop_group_nexthop_num(const struct nexthop_group *nhg); | |
141 | extern uint8_t | |
98cda54a SW |
142 | nexthop_group_nexthop_num_no_recurse(const struct nexthop_group *nhg); |
143 | extern uint8_t | |
454192f4 | 144 | nexthop_group_active_nexthop_num(const struct nexthop_group *nhg); |
98cda54a SW |
145 | extern uint8_t |
146 | nexthop_group_active_nexthop_num_no_recurse(const struct nexthop_group *nhg); | |
454192f4 | 147 | |
5e244469 RW |
148 | #ifdef __cplusplus |
149 | } | |
150 | #endif | |
151 | ||
7ee30f28 | 152 | #endif |