]> git.proxmox.com Git - mirror_frr.git/blame - lib/zclient.h
Merge pull request #1647 from chiragshah6/ospf_vrf_dev
[mirror_frr.git] / lib / zclient.h
CommitLineData
718e3744 1/* Zebra's client header.
2 * Copyright (C) 1999 Kunihiro Ishiguro
3 *
4 * This file is part of GNU Zebra.
5 *
6 * GNU Zebra is free software; you can redistribute it and/or modify it
7 * under the terms of the GNU General Public License as published by
8 * the Free Software Foundation; either version 2, or (at your option)
9 * any later version.
896014f4 10 *
718e3744 11 * GNU Zebra is distributed in the hope that it will be useful, but
12 * WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 * General Public License for more details.
896014f4
DL
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
718e3744 19 */
20
21#ifndef _ZEBRA_ZCLIENT_H
22#define _ZEBRA_ZCLIENT_H
23
74489921 24/* For struct zapi_route. */
5734509c
PJ
25#include "prefix.h"
26
718e3744 27/* For struct interface and struct connected. */
28#include "if.h"
29
7076bb2f
FL
30/* For vrf_bitmap_t. */
31#include "vrf.h"
32
6833ae01 33/* For union g_addr */
34#include "nexthop.h"
35
36/* For union pw_protocol_fields */
37#include "pw.h"
38
718e3744 39/* For input/output buffer to zebra. */
40#define ZEBRA_MAX_PACKET_SIZ 4096
41
42/* Zebra header size. */
7076bb2f 43#define ZEBRA_HEADER_SIZE 8
718e3744 44
689f5a8c
DL
45/* special socket path name to use TCP
46 * @ is used as first character because that's abstract socket names on Linux
47 */
48#define ZAPI_TCP_PATHNAME "@tcp"
49
50extern struct sockaddr_storage zclient_addr;
51extern socklen_t zclient_addr_len;
52
8613585e
DS
53/* Zebra message types. */
54typedef enum {
d62a17ae 55 ZEBRA_INTERFACE_ADD,
56 ZEBRA_INTERFACE_DELETE,
57 ZEBRA_INTERFACE_ADDRESS_ADD,
58 ZEBRA_INTERFACE_ADDRESS_DELETE,
59 ZEBRA_INTERFACE_UP,
60 ZEBRA_INTERFACE_DOWN,
e0ae31b8 61 ZEBRA_INTERFACE_SET_MASTER,
0e51b4a3
RW
62 ZEBRA_ROUTE_ADD,
63 ZEBRA_ROUTE_DELETE,
7ea7b86e 64 ZEBRA_ROUTE_NOTIFY_OWNER,
d62a17ae 65 ZEBRA_IPV4_ROUTE_ADD,
66 ZEBRA_IPV4_ROUTE_DELETE,
67 ZEBRA_IPV6_ROUTE_ADD,
68 ZEBRA_IPV6_ROUTE_DELETE,
69 ZEBRA_REDISTRIBUTE_ADD,
70 ZEBRA_REDISTRIBUTE_DELETE,
71 ZEBRA_REDISTRIBUTE_DEFAULT_ADD,
72 ZEBRA_REDISTRIBUTE_DEFAULT_DELETE,
73 ZEBRA_ROUTER_ID_ADD,
74 ZEBRA_ROUTER_ID_DELETE,
75 ZEBRA_ROUTER_ID_UPDATE,
76 ZEBRA_HELLO,
77 ZEBRA_NEXTHOP_REGISTER,
78 ZEBRA_NEXTHOP_UNREGISTER,
79 ZEBRA_NEXTHOP_UPDATE,
80 ZEBRA_INTERFACE_NBR_ADDRESS_ADD,
81 ZEBRA_INTERFACE_NBR_ADDRESS_DELETE,
82 ZEBRA_INTERFACE_BFD_DEST_UPDATE,
83 ZEBRA_IMPORT_ROUTE_REGISTER,
84 ZEBRA_IMPORT_ROUTE_UNREGISTER,
85 ZEBRA_IMPORT_CHECK_UPDATE,
86 ZEBRA_IPV4_ROUTE_IPV6_NEXTHOP_ADD,
87 ZEBRA_BFD_DEST_REGISTER,
88 ZEBRA_BFD_DEST_DEREGISTER,
89 ZEBRA_BFD_DEST_UPDATE,
90 ZEBRA_BFD_DEST_REPLAY,
74489921
RW
91 ZEBRA_REDISTRIBUTE_ROUTE_ADD,
92 ZEBRA_REDISTRIBUTE_ROUTE_DEL,
d62a17ae 93 ZEBRA_VRF_UNREGISTER,
94 ZEBRA_VRF_ADD,
95 ZEBRA_VRF_DELETE,
96 ZEBRA_INTERFACE_VRF_UPDATE,
97 ZEBRA_BFD_CLIENT_REGISTER,
98 ZEBRA_INTERFACE_ENABLE_RADV,
99 ZEBRA_INTERFACE_DISABLE_RADV,
100 ZEBRA_IPV4_NEXTHOP_LOOKUP_MRIB,
101 ZEBRA_INTERFACE_LINK_PARAMS,
102 ZEBRA_MPLS_LABELS_ADD,
103 ZEBRA_MPLS_LABELS_DELETE,
d62a17ae 104 ZEBRA_IPMR_ROUTE_STATS,
105 ZEBRA_LABEL_MANAGER_CONNECT,
106 ZEBRA_GET_LABEL_CHUNK,
107 ZEBRA_RELEASE_LABEL_CHUNK,
108 ZEBRA_FEC_REGISTER,
109 ZEBRA_FEC_UNREGISTER,
110 ZEBRA_FEC_UPDATE,
1a98c087 111 ZEBRA_ADVERTISE_DEFAULT_GW,
d62a17ae 112 ZEBRA_ADVERTISE_ALL_VNI,
113 ZEBRA_VNI_ADD,
114 ZEBRA_VNI_DEL,
b7cfce93
MK
115 ZEBRA_L3VNI_ADD,
116 ZEBRA_L3VNI_DEL,
d62a17ae 117 ZEBRA_REMOTE_VTEP_ADD,
118 ZEBRA_REMOTE_VTEP_DEL,
119 ZEBRA_MACIP_ADD,
120 ZEBRA_MACIP_DEL,
121 ZEBRA_REMOTE_MACIP_ADD,
122 ZEBRA_REMOTE_MACIP_DEL,
6833ae01 123 ZEBRA_PW_ADD,
124 ZEBRA_PW_DELETE,
125 ZEBRA_PW_SET,
126 ZEBRA_PW_UNSET,
127 ZEBRA_PW_STATUS_UPDATE,
8613585e
DS
128} zebra_message_types_t;
129
d62a17ae 130struct redist_proto {
131 u_char enabled;
132 struct list *instances;
7c8ff89e
DS
133};
134
718e3744 135/* Structure for the zebra client. */
d62a17ae 136struct zclient {
137 /* The thread master we schedule ourselves on */
138 struct thread_master *master;
139
342213ea
DS
140 /* Priviledges to change socket values */
141 struct zebra_privs_t *privs;
142
e1a1880d
DS
143 /* Do we care about failure events for route install? */
144 bool receive_notify;
145
d62a17ae 146 /* Socket to zebra daemon. */
147 int sock;
148
d62a17ae 149 /* Connection failure count. */
150 int fail;
151
152 /* Input buffer for zebra message. */
153 struct stream *ibuf;
154
155 /* Output buffer for zebra message. */
156 struct stream *obuf;
157
158 /* Buffer of data waiting to be written to zebra. */
159 struct buffer *wb;
160
161 /* Read and connect thread. */
162 struct thread *t_read;
163 struct thread *t_connect;
164
165 /* Thread to write buffered data to zebra. */
166 struct thread *t_write;
167
168 /* Redistribute information. */
169 u_char redist_default; /* clients protocol */
170 u_short instance;
171 struct redist_proto mi_redist[AFI_MAX][ZEBRA_ROUTE_MAX];
172 vrf_bitmap_t redist[AFI_MAX][ZEBRA_ROUTE_MAX];
173
174 /* Redistribute defauilt. */
175 vrf_bitmap_t default_information;
176
177 /* Pointer to the callback functions. */
178 void (*zebra_connected)(struct zclient *);
179 int (*router_id_update)(int, struct zclient *, uint16_t, vrf_id_t);
180 int (*interface_add)(int, struct zclient *, uint16_t, vrf_id_t);
181 int (*interface_delete)(int, struct zclient *, uint16_t, vrf_id_t);
182 int (*interface_up)(int, struct zclient *, uint16_t, vrf_id_t);
183 int (*interface_down)(int, struct zclient *, uint16_t, vrf_id_t);
184 int (*interface_address_add)(int, struct zclient *, uint16_t, vrf_id_t);
185 int (*interface_address_delete)(int, struct zclient *, uint16_t,
186 vrf_id_t);
187 int (*interface_link_params)(int, struct zclient *, uint16_t);
188 int (*interface_bfd_dest_update)(int, struct zclient *, uint16_t,
189 vrf_id_t);
190 int (*interface_nbr_address_add)(int, struct zclient *, uint16_t,
191 vrf_id_t);
192 int (*interface_nbr_address_delete)(int, struct zclient *, uint16_t,
193 vrf_id_t);
194 int (*interface_vrf_update)(int, struct zclient *, uint16_t, vrf_id_t);
195 int (*nexthop_update)(int, struct zclient *, uint16_t, vrf_id_t);
196 int (*import_check_update)(int, struct zclient *, uint16_t, vrf_id_t);
197 int (*bfd_dest_replay)(int, struct zclient *, uint16_t, vrf_id_t);
74489921
RW
198 int (*redistribute_route_add)(int, struct zclient *, uint16_t,
199 vrf_id_t);
200 int (*redistribute_route_del)(int, struct zclient *, uint16_t,
201 vrf_id_t);
d62a17ae 202 int (*fec_update)(int, struct zclient *, uint16_t);
203 int (*local_vni_add)(int, struct zclient *, uint16_t, vrf_id_t);
204 int (*local_vni_del)(int, struct zclient *, uint16_t, vrf_id_t);
b7cfce93
MK
205 int (*local_l3vni_add)(int, struct zclient *, uint16_t, vrf_id_t);
206 int (*local_l3vni_del)(int, struct zclient *, uint16_t, vrf_id_t);
d62a17ae 207 int (*local_macip_add)(int, struct zclient *, uint16_t, vrf_id_t);
208 int (*local_macip_del)(int, struct zclient *, uint16_t, vrf_id_t);
6833ae01 209 int (*pw_status_update)(int, struct zclient *, uint16_t, vrf_id_t);
7ea7b86e
DS
210 int (*notify_owner)(int command, struct zclient *zclient,
211 uint16_t length, vrf_id_t vrf_id);
718e3744 212};
213
214/* Zebra API message flag. */
215#define ZAPI_MESSAGE_NEXTHOP 0x01
74489921
RW
216#define ZAPI_MESSAGE_DISTANCE 0x02
217#define ZAPI_MESSAGE_METRIC 0x04
218#define ZAPI_MESSAGE_TAG 0x08
219#define ZAPI_MESSAGE_MTU 0x10
220#define ZAPI_MESSAGE_SRCPFX 0x20
221#define ZAPI_MESSAGE_LABEL 0x40
718e3744 222
c1b9800a 223/* Zserv protocol message header */
d62a17ae 224struct zserv_header {
225 uint16_t length;
226 uint8_t marker; /* corresponds to command field in old zserv
227 * always set to 255 in new zserv.
228 */
229 uint8_t version;
80e71dcd 230#define ZSERV_VERSION 4
d62a17ae 231 vrf_id_t vrf_id;
232 uint16_t command;
c1b9800a 233};
234
bb1b9c47
RW
235struct zapi_nexthop {
236 enum nexthop_types_t type;
237 ifindex_t ifindex;
09a484dd
DL
238 union {
239 union g_addr gate;
240 enum blackhole_type bh_type;
241 };
52dd3aa4
RW
242
243 /* MPLS labels for BGP-LU or Segment Routing */
244 uint8_t label_num;
245 mpls_label_t labels[MPLS_MAX_LABELS];
bb1b9c47
RW
246};
247
832d0f56
DS
248/*
249 * Some of these data structures do not map easily to
250 * a actual data structure size giving different compilers
251 * and systems. For those data structures we need
252 * to use the smallest available stream_getX/putX functions
253 * to encode/decode.
254 */
d62a17ae 255struct zapi_route {
256 u_char type;
257 u_short instance;
657cde12 258
d62a17ae 259 u_int32_t flags;
657cde12 260
d62a17ae 261 u_char message;
657cde12 262
832d0f56
DS
263 /*
264 * This is an enum but we are going to treat it as a uint8_t
265 * for purpose of encoding/decoding
266 */
d62a17ae 267 safi_t safi;
657cde12 268
bb1b9c47
RW
269 struct prefix prefix;
270 struct prefix_ipv6 src_prefix;
271
b5f79651 272 u_int16_t nexthop_num;
bb1b9c47 273 struct zapi_nexthop nexthops[MULTIPATH_NUM];
657cde12 274
d62a17ae 275 u_char distance;
657cde12 276
d62a17ae 277 u_int32_t metric;
657cde12 278
d62a17ae 279 route_tag_t tag;
657cde12 280
d62a17ae 281 u_int32_t mtu;
657cde12 282
d62a17ae 283 vrf_id_t vrf_id;
2dbad57f 284
285 struct ethaddr rmac;
657cde12
DS
286};
287
718e3744 288/* Zebra IPv4 route message API. */
d62a17ae 289struct zapi_ipv4 {
290 u_char type;
291 u_short instance;
718e3744 292
d62a17ae 293 u_int32_t flags;
718e3744 294
d62a17ae 295 u_char message;
718e3744 296
d62a17ae 297 safi_t safi;
5a616c08 298
d62a17ae 299 u_char nexthop_num;
300 struct in_addr **nexthop;
718e3744 301
d62a17ae 302 u_char ifindex_num;
303 ifindex_t *ifindex;
718e3744 304
d62a17ae 305 u_char label_num;
306 unsigned int *label;
a64448ba 307
d62a17ae 308 u_char distance;
718e3744 309
d62a17ae 310 u_int32_t metric;
0d9551dc 311
d62a17ae 312 route_tag_t tag;
7076bb2f 313
d62a17ae 314 u_int32_t mtu;
c50ca33a 315
d62a17ae 316 vrf_id_t vrf_id;
718e3744 317};
318
6833ae01 319struct zapi_pw {
320 char ifname[IF_NAMESIZE];
321 ifindex_t ifindex;
322 int type;
323 int af;
324 union g_addr nexthop;
325 uint32_t local_label;
326 uint32_t remote_label;
327 uint8_t flags;
328 union pw_protocol_fields data;
329 uint8_t protocol;
330};
331
332struct zapi_pw_status {
333 char ifname[IF_NAMESIZE];
334 ifindex_t ifindex;
335 uint32_t status;
336};
337
7ea7b86e
DS
338enum zapi_route_notify_owner {
339 ZAPI_ROUTE_FAIL_INSTALL,
340 ZAPI_ROUTE_BETTER_ADMIN_WON,
341 ZAPI_ROUTE_INSTALLED,
342};
343
1a98c087
MK
344/* Zebra MAC types */
345#define ZEBRA_MAC_TYPE_STICKY 0x01 /* Sticky MAC*/
346#define ZEBRA_MAC_TYPE_GW 0x02 /* gateway (SVI) mac*/
347
e1a1880d
DS
348struct zclient_options {
349 bool receive_notify;
350};
351
718e3744 352/* Prototypes of zebra client service functions. */
d62a17ae 353extern struct zclient *zclient_new(struct thread_master *);
e1a1880d
DS
354
355#if CONFDATE > 20181101
356CPP_NOTICE("zclient_new_notify can take over or zclient_new now");
357#endif
358
359extern struct zclient_options zclient_options_default;
360
361extern struct zclient *zclient_new_notify(struct thread_master *m,
362 struct zclient_options *opt);
363
364#define zclient_new(A) zclient_new_notify((A), &zclient_options_default); \
365 CPP_WARN("Please transition to using zclient_new_notify");
366
342213ea 367extern void zclient_init(struct zclient *, int, u_short, struct zebra_privs_t *privs);
d62a17ae 368extern int zclient_start(struct zclient *);
369extern void zclient_stop(struct zclient *);
370extern void zclient_reset(struct zclient *);
371extern void zclient_free(struct zclient *);
634f9ea2 372
d62a17ae 373extern int zclient_socket_connect(struct zclient *);
718e3744 374
d62a17ae 375extern u_short *redist_check_instance(struct redist_proto *, u_short);
376extern void redist_add_instance(struct redist_proto *, u_short);
377extern void redist_del_instance(struct redist_proto *, u_short);
7c8ff89e 378
d62a17ae 379extern void zclient_send_reg_requests(struct zclient *, vrf_id_t);
380extern void zclient_send_dereg_requests(struct zclient *, vrf_id_t);
7076bb2f 381
d62a17ae 382extern void zclient_send_interface_radv_req(struct zclient *zclient,
383 vrf_id_t vrf_id,
384 struct interface *ifp, int enable,
385 int ra_interval);
4a04e5f7 386
634f9ea2 387/* Send redistribute command to zebra daemon. Do not update zclient state. */
d62a17ae 388extern int zebra_redistribute_send(int command, struct zclient *, afi_t,
389 int type, u_short instance, vrf_id_t vrf_id);
634f9ea2 390
391/* If state has changed, update state and call zebra_redistribute_send. */
d62a17ae 392extern void zclient_redistribute(int command, struct zclient *, afi_t, int type,
393 u_short instance, vrf_id_t vrf_id);
634f9ea2 394
395/* If state has changed, update state and send the command to zebra. */
d62a17ae 396extern void zclient_redistribute_default(int command, struct zclient *,
397 vrf_id_t vrf_id);
718e3744 398
634f9ea2 399/* Send the message in zclient->obuf to the zebra daemon (or enqueue it).
400 Returns 0 for success or -1 on an I/O error. */
401extern int zclient_send_message(struct zclient *);
718e3744 402
d211086a 403/* create header for command, length to be filled in by user later */
d62a17ae 404extern void zclient_create_header(struct stream *, uint16_t, vrf_id_t);
405extern int zclient_read_header(struct stream *s, int sock, u_int16_t *size,
406 u_char *marker, u_char *version,
407 vrf_id_t *vrf_id, u_int16_t *cmd);
408
e0ae31b8
DS
409extern void zclient_interface_set_master(struct zclient *client,
410 struct interface *master,
411 struct interface *slave);
d62a17ae 412extern struct interface *zebra_interface_add_read(struct stream *, vrf_id_t);
413extern struct interface *zebra_interface_state_read(struct stream *s, vrf_id_t);
414extern struct connected *zebra_interface_address_read(int, struct stream *,
415 vrf_id_t);
416extern struct nbr_connected *
417zebra_interface_nbr_address_read(int, struct stream *, vrf_id_t);
418extern struct interface *zebra_interface_vrf_update_read(struct stream *s,
419 vrf_id_t vrf_id,
420 vrf_id_t *new_vrf_id);
421extern void zebra_interface_if_set_value(struct stream *, struct interface *);
422extern void zebra_router_id_update_read(struct stream *s, struct prefix *rid);
423extern int zapi_ipv4_route(u_char, struct zclient *, struct prefix_ipv4 *,
f474e08b 424 struct zapi_ipv4 *) __attribute__((deprecated));
d62a17ae 425
426extern struct interface *zebra_interface_link_params_read(struct stream *);
427extern size_t zebra_interface_link_params_write(struct stream *,
428 struct interface *);
429extern int lm_label_manager_connect(struct zclient *zclient);
430extern int lm_get_label_chunk(struct zclient *zclient, u_char keep,
431 uint32_t chunk_size, uint32_t *start,
432 uint32_t *end);
433extern int lm_release_label_chunk(struct zclient *zclient, uint32_t start,
434 uint32_t end);
6833ae01 435extern int zebra_send_pw(struct zclient *zclient, int command,
436 struct zapi_pw *pw);
437extern void zebra_read_pw_status_update(int command, struct zclient *zclient,
438 zebra_size_t length, vrf_id_t vrf_id,
439 struct zapi_pw_status *pw);
440
718e3744 441/* IPv6 prefix add and delete function prototype. */
442
d62a17ae 443struct zapi_ipv6 {
444 u_char type;
445 u_short instance;
718e3744 446
d62a17ae 447 u_int32_t flags;
718e3744 448
d62a17ae 449 u_char message;
718e3744 450
d62a17ae 451 safi_t safi;
c7ec179a 452
d62a17ae 453 u_char nexthop_num;
454 struct in6_addr **nexthop;
718e3744 455
d62a17ae 456 u_char ifindex_num;
457 ifindex_t *ifindex;
718e3744 458
d62a17ae 459 u_char label_num;
460 unsigned int *label;
a64448ba 461
d62a17ae 462 u_char distance;
718e3744 463
d62a17ae 464 u_int32_t metric;
0d9551dc 465
d62a17ae 466 route_tag_t tag;
7076bb2f 467
d62a17ae 468 u_int32_t mtu;
c50ca33a 469
d62a17ae 470 vrf_id_t vrf_id;
718e3744 471};
472
d62a17ae 473extern int zapi_ipv6_route(u_char cmd, struct zclient *zclient,
474 struct prefix_ipv6 *p, struct prefix_ipv6 *src_p,
f474e08b 475 struct zapi_ipv6 *api) __attribute__((deprecated));
d62a17ae 476extern int zapi_ipv4_route_ipv6_nexthop(u_char, struct zclient *,
477 struct prefix_ipv4 *,
f474e08b
RW
478 struct zapi_ipv6 *)
479 __attribute__((deprecated));
0e51b4a3
RW
480extern int zclient_route_send(u_char, struct zclient *, struct zapi_route *);
481extern int zapi_route_encode(u_char, struct stream *, struct zapi_route *);
482extern int zapi_route_decode(struct stream *, struct zapi_route *);
7ea7b86e
DS
483bool zapi_route_notify_decode(struct stream *s, struct prefix *p,
484 enum zapi_route_notify_owner *note);
718e3744 485
09a484dd 486static inline void zapi_route_set_blackhole(struct zapi_route *api,
60466a63 487 enum blackhole_type bh_type)
09a484dd
DL
488{
489 api->nexthop_num = 1;
490 api->nexthops[0].type = NEXTHOP_TYPE_BLACKHOLE;
491 api->nexthops[0].bh_type = bh_type;
492 SET_FLAG(api->message, ZAPI_MESSAGE_NEXTHOP);
493};
494
495
718e3744 496#endif /* _ZEBRA_ZCLIENT_H */