1 /* Zebra's client header.
2 * Copyright (C) 1999 Kunihiro Ishiguro
4 * This file is part of GNU Zebra.
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)
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.
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
21 #ifndef _ZEBRA_ZCLIENT_H
22 #define _ZEBRA_ZCLIENT_H
24 /* For struct zapi_route. */
27 /* For struct interface and struct connected. */
30 /* For vrf_bitmap_t. */
33 /* For union g_addr */
36 /* For union pw_protocol_fields */
41 /* For input/output buffer to zebra. */
42 #define ZEBRA_MAX_PACKET_SIZ 16384U
44 /* Zebra header size. */
45 #define ZEBRA_HEADER_SIZE 10
47 /* special socket path name to use TCP
48 * @ is used as first character because that's abstract socket names on Linux
50 #define ZAPI_TCP_PATHNAME "@tcp"
52 /* IPset size name stands for the name of the ipset entry
53 * that can be created by using some zapi interfaces
55 #define ZEBRA_IPSET_NAME_SIZE 32
57 /* IPTable action is defined by two values: either
60 #define ZEBRA_IPTABLES_FORWARD 0
61 #define ZEBRA_IPTABLES_DROP 1
63 /* Zebra FEC register command flags. */
64 #define ZEBRA_FEC_REGISTER_LABEL 0x1
65 #define ZEBRA_FEC_REGISTER_LABEL_INDEX 0x2
67 extern struct sockaddr_storage zclient_addr
;
68 extern socklen_t zclient_addr_len
;
70 /* Zebra message types. */
73 ZEBRA_INTERFACE_DELETE
,
74 ZEBRA_INTERFACE_ADDRESS_ADD
,
75 ZEBRA_INTERFACE_ADDRESS_DELETE
,
78 ZEBRA_INTERFACE_SET_MASTER
,
79 ZEBRA_INTERFACE_SET_PROTODOWN
,
82 ZEBRA_ROUTE_NOTIFY_OWNER
,
83 ZEBRA_REDISTRIBUTE_ADD
,
84 ZEBRA_REDISTRIBUTE_DELETE
,
85 ZEBRA_REDISTRIBUTE_DEFAULT_ADD
,
86 ZEBRA_REDISTRIBUTE_DEFAULT_DELETE
,
88 ZEBRA_ROUTER_ID_DELETE
,
89 ZEBRA_ROUTER_ID_UPDATE
,
92 ZEBRA_NEXTHOP_REGISTER
,
93 ZEBRA_NEXTHOP_UNREGISTER
,
95 ZEBRA_INTERFACE_NBR_ADDRESS_ADD
,
96 ZEBRA_INTERFACE_NBR_ADDRESS_DELETE
,
97 ZEBRA_INTERFACE_BFD_DEST_UPDATE
,
98 ZEBRA_IMPORT_ROUTE_REGISTER
,
99 ZEBRA_IMPORT_ROUTE_UNREGISTER
,
100 ZEBRA_IMPORT_CHECK_UPDATE
,
101 ZEBRA_BFD_DEST_REGISTER
,
102 ZEBRA_BFD_DEST_DEREGISTER
,
103 ZEBRA_BFD_DEST_UPDATE
,
104 ZEBRA_BFD_DEST_REPLAY
,
105 ZEBRA_REDISTRIBUTE_ROUTE_ADD
,
106 ZEBRA_REDISTRIBUTE_ROUTE_DEL
,
107 ZEBRA_VRF_UNREGISTER
,
111 ZEBRA_INTERFACE_VRF_UPDATE
,
112 ZEBRA_BFD_CLIENT_REGISTER
,
113 ZEBRA_BFD_CLIENT_DEREGISTER
,
114 ZEBRA_INTERFACE_ENABLE_RADV
,
115 ZEBRA_INTERFACE_DISABLE_RADV
,
116 ZEBRA_IPV4_NEXTHOP_LOOKUP_MRIB
,
117 ZEBRA_INTERFACE_LINK_PARAMS
,
118 ZEBRA_MPLS_LABELS_ADD
,
119 ZEBRA_MPLS_LABELS_DELETE
,
120 ZEBRA_IPMR_ROUTE_STATS
,
121 ZEBRA_LABEL_MANAGER_CONNECT
,
122 ZEBRA_LABEL_MANAGER_CONNECT_ASYNC
,
123 ZEBRA_GET_LABEL_CHUNK
,
124 ZEBRA_RELEASE_LABEL_CHUNK
,
126 ZEBRA_FEC_UNREGISTER
,
128 ZEBRA_ADVERTISE_DEFAULT_GW
,
129 ZEBRA_ADVERTISE_SVI_MACIP
,
130 ZEBRA_ADVERTISE_SUBNET
,
131 ZEBRA_ADVERTISE_ALL_VNI
,
138 ZEBRA_REMOTE_VTEP_ADD
,
139 ZEBRA_REMOTE_VTEP_DEL
,
142 ZEBRA_IP_PREFIX_ROUTE_ADD
,
143 ZEBRA_IP_PREFIX_ROUTE_DEL
,
144 ZEBRA_REMOTE_MACIP_ADD
,
145 ZEBRA_REMOTE_MACIP_DEL
,
146 ZEBRA_DUPLICATE_ADDR_DETECTION
,
151 ZEBRA_PW_STATUS_UPDATE
,
154 ZEBRA_RULE_NOTIFY_OWNER
,
155 ZEBRA_TABLE_MANAGER_CONNECT
,
156 ZEBRA_GET_TABLE_CHUNK
,
157 ZEBRA_RELEASE_TABLE_CHUNK
,
160 ZEBRA_IPSET_ENTRY_ADD
,
161 ZEBRA_IPSET_ENTRY_DELETE
,
162 ZEBRA_IPSET_NOTIFY_OWNER
,
163 ZEBRA_IPSET_ENTRY_NOTIFY_OWNER
,
165 ZEBRA_IPTABLE_DELETE
,
166 ZEBRA_IPTABLE_NOTIFY_OWNER
,
167 ZEBRA_VXLAN_FLOOD_CONTROL
,
170 } zebra_message_types_t
;
172 struct redist_proto
{
174 struct list
*instances
;
177 struct zclient_capabilities
{
183 /* Structure for the zebra client. */
185 /* The thread master we schedule ourselves on */
186 struct thread_master
*master
;
188 /* Priviledges to change socket values */
189 struct zebra_privs_t
*privs
;
191 /* Do we care about failure events for route install? */
194 /* Socket to zebra daemon. */
197 /* Connection failure count. */
200 /* Input buffer for zebra message. */
203 /* Output buffer for zebra message. */
206 /* Buffer of data waiting to be written to zebra. */
209 /* Read and connect thread. */
210 struct thread
*t_read
;
211 struct thread
*t_connect
;
213 /* Thread to write buffered data to zebra. */
214 struct thread
*t_write
;
216 /* Redistribute information. */
217 uint8_t redist_default
; /* clients protocol */
218 unsigned short instance
;
219 struct redist_proto mi_redist
[AFI_MAX
][ZEBRA_ROUTE_MAX
];
220 vrf_bitmap_t redist
[AFI_MAX
][ZEBRA_ROUTE_MAX
];
222 /* Redistribute defauilt. */
223 vrf_bitmap_t default_information
[AFI_MAX
];
225 #define ZAPI_CALLBACK_ARGS \
226 int cmd, struct zclient *zclient, uint16_t length, vrf_id_t vrf_id
228 /* Pointer to the callback functions. */
229 void (*zebra_connected
)(struct zclient
*);
230 void (*zebra_capabilities
)(struct zclient_capabilities
*cap
);
231 int (*router_id_update
)(ZAPI_CALLBACK_ARGS
);
232 int (*interface_add
)(ZAPI_CALLBACK_ARGS
);
233 int (*interface_delete
)(ZAPI_CALLBACK_ARGS
);
234 int (*interface_up
)(ZAPI_CALLBACK_ARGS
);
235 int (*interface_down
)(ZAPI_CALLBACK_ARGS
);
236 int (*interface_address_add
)(ZAPI_CALLBACK_ARGS
);
237 int (*interface_address_delete
)(ZAPI_CALLBACK_ARGS
);
238 int (*interface_link_params
)(ZAPI_CALLBACK_ARGS
);
239 int (*interface_bfd_dest_update
)(ZAPI_CALLBACK_ARGS
);
240 int (*interface_nbr_address_add
)(ZAPI_CALLBACK_ARGS
);
241 int (*interface_nbr_address_delete
)(ZAPI_CALLBACK_ARGS
);
242 int (*interface_vrf_update
)(ZAPI_CALLBACK_ARGS
);
243 int (*nexthop_update
)(ZAPI_CALLBACK_ARGS
);
244 int (*import_check_update
)(ZAPI_CALLBACK_ARGS
);
245 int (*bfd_dest_replay
)(ZAPI_CALLBACK_ARGS
);
246 int (*redistribute_route_add
)(ZAPI_CALLBACK_ARGS
);
247 int (*redistribute_route_del
)(ZAPI_CALLBACK_ARGS
);
248 int (*fec_update
)(int, struct zclient
*, uint16_t);
249 int (*local_es_add
)(ZAPI_CALLBACK_ARGS
);
250 int (*local_es_del
)(ZAPI_CALLBACK_ARGS
);
251 int (*local_vni_add
)(ZAPI_CALLBACK_ARGS
);
252 int (*local_vni_del
)(ZAPI_CALLBACK_ARGS
);
253 int (*local_l3vni_add
)(ZAPI_CALLBACK_ARGS
);
254 int (*local_l3vni_del
)(ZAPI_CALLBACK_ARGS
);
255 void (*local_ip_prefix_add
)(ZAPI_CALLBACK_ARGS
);
256 void (*local_ip_prefix_del
)(ZAPI_CALLBACK_ARGS
);
257 int (*local_macip_add
)(ZAPI_CALLBACK_ARGS
);
258 int (*local_macip_del
)(ZAPI_CALLBACK_ARGS
);
259 int (*pw_status_update
)(ZAPI_CALLBACK_ARGS
);
260 int (*route_notify_owner
)(ZAPI_CALLBACK_ARGS
);
261 int (*rule_notify_owner
)(ZAPI_CALLBACK_ARGS
);
262 void (*label_chunk
)(ZAPI_CALLBACK_ARGS
);
263 int (*ipset_notify_owner
)(ZAPI_CALLBACK_ARGS
);
264 int (*ipset_entry_notify_owner
)(ZAPI_CALLBACK_ARGS
);
265 int (*iptable_notify_owner
)(ZAPI_CALLBACK_ARGS
);
266 int (*vxlan_sg_add
)(ZAPI_CALLBACK_ARGS
);
267 int (*vxlan_sg_del
)(ZAPI_CALLBACK_ARGS
);
270 /* Zebra API message flag. */
271 #define ZAPI_MESSAGE_NEXTHOP 0x01
272 #define ZAPI_MESSAGE_DISTANCE 0x02
273 #define ZAPI_MESSAGE_METRIC 0x04
274 #define ZAPI_MESSAGE_TAG 0x08
275 #define ZAPI_MESSAGE_MTU 0x10
276 #define ZAPI_MESSAGE_SRCPFX 0x20
277 #define ZAPI_MESSAGE_LABEL 0x40
279 * This should only be used by a DAEMON that needs to communicate
280 * the table being used is not in the VRF. You must pass the
281 * default vrf, else this will be ignored.
283 #define ZAPI_MESSAGE_TABLEID 0x80
285 #define ZSERV_VERSION 6
286 /* Zserv protocol message header */
289 /* Always set to 255 in new zserv */
296 struct zapi_nexthop
{
297 enum nexthop_types_t type
;
303 enum blackhole_type bh_type
;
306 /* MPLS labels for BGP-LU or Segment Routing */
308 mpls_label_t labels
[MPLS_MAX_LABELS
];
314 * Some of these data structures do not map easily to
315 * a actual data structure size giving different compilers
316 * and systems. For those data structures we need
317 * to use the smallest available stream_getX/putX functions
322 unsigned short instance
;
329 * This is an enum but we are going to treat it as a uint8_t
330 * for purpose of encoding/decoding
334 struct prefix prefix
;
335 struct prefix_ipv6 src_prefix
;
337 uint16_t nexthop_num
;
338 struct zapi_nexthop nexthops
[MULTIPATH_NUM
];
354 char ifname
[IF_NAMESIZE
];
358 union g_addr nexthop
;
359 uint32_t local_label
;
360 uint32_t remote_label
;
362 union pw_protocol_fields data
;
366 struct zapi_pw_status
{
367 char ifname
[IF_NAMESIZE
];
372 enum zapi_route_notify_owner
{
373 ZAPI_ROUTE_FAIL_INSTALL
,
374 ZAPI_ROUTE_BETTER_ADMIN_WON
,
375 ZAPI_ROUTE_INSTALLED
,
377 ZAPI_ROUTE_REMOVE_FAIL
,
380 enum zapi_rule_notify_owner
{
381 ZAPI_RULE_FAIL_INSTALL
,
384 ZAPI_RULE_FAIL_REMOVE
,
394 enum zapi_ipset_notify_owner
{
395 ZAPI_IPSET_FAIL_INSTALL
,
396 ZAPI_IPSET_INSTALLED
,
398 ZAPI_IPSET_FAIL_REMOVE
,
401 enum zapi_ipset_entry_notify_owner
{
402 ZAPI_IPSET_ENTRY_FAIL_INSTALL
,
403 ZAPI_IPSET_ENTRY_INSTALLED
,
404 ZAPI_IPSET_ENTRY_REMOVED
,
405 ZAPI_IPSET_ENTRY_FAIL_REMOVE
,
408 enum zapi_iptable_notify_owner
{
409 ZAPI_IPTABLE_FAIL_INSTALL
,
410 ZAPI_IPTABLE_INSTALLED
,
411 ZAPI_IPTABLE_REMOVED
,
412 ZAPI_IPTABLE_FAIL_REMOVE
,
415 /* Zebra MAC types */
416 #define ZEBRA_MACIP_TYPE_STICKY 0x01 /* Sticky MAC*/
417 #define ZEBRA_MACIP_TYPE_GW 0x02 /* gateway (SVI) mac*/
418 #define ZEBRA_MACIP_TYPE_ROUTER_FLAG 0x04 /* Router Flag - proxy NA */
419 #define ZEBRA_MACIP_TYPE_OVERRIDE_FLAG 0x08 /* Override Flag */
421 enum zebra_neigh_state
{ ZEBRA_NEIGH_INACTIVE
= 0, ZEBRA_NEIGH_ACTIVE
= 1 };
423 struct zclient_options
{
427 extern struct zclient_options zclient_options_default
;
429 extern struct zclient
*zclient_new(struct thread_master
*m
,
430 struct zclient_options
*opt
);
432 extern void zclient_init(struct zclient
*, int, unsigned short,
433 struct zebra_privs_t
*privs
);
434 extern int zclient_start(struct zclient
*);
435 extern void zclient_stop(struct zclient
*);
436 extern void zclient_reset(struct zclient
*);
437 extern void zclient_free(struct zclient
*);
439 extern int zclient_socket_connect(struct zclient
*);
441 extern unsigned short *redist_check_instance(struct redist_proto
*,
443 extern void redist_add_instance(struct redist_proto
*, unsigned short);
444 extern void redist_del_instance(struct redist_proto
*, unsigned short);
447 * Send to zebra that the specified vrf is using label to resolve
448 * itself for L3VPN's. Repeated calls of this function with
449 * different labels will cause an effective update of the
450 * label for lookup. If you pass in MPLS_LABEL_NONE
451 * we will cause a delete action and remove this label pop
454 * The underlying AF_MPLS doesn't care about afi's
455 * but we can make the zebra_vrf keep track of what
456 * we have installed and play some special games
457 * to get them both installed.
459 extern void zclient_send_vrf_label(struct zclient
*zclient
, vrf_id_t vrf_id
,
460 afi_t afi
, mpls_label_t label
,
461 enum lsp_types_t ltype
);
463 extern void zclient_send_reg_requests(struct zclient
*, vrf_id_t
);
464 extern void zclient_send_dereg_requests(struct zclient
*, vrf_id_t
);
466 extern void zclient_send_interface_radv_req(struct zclient
*zclient
,
468 struct interface
*ifp
, int enable
,
470 extern int zclient_send_interface_protodown(struct zclient
*zclient
,
472 struct interface
*ifp
, bool down
);
474 /* Send redistribute command to zebra daemon. Do not update zclient state. */
475 extern int zebra_redistribute_send(int command
, struct zclient
*, afi_t
,
476 int type
, unsigned short instance
,
479 extern int zebra_redistribute_default_send(int command
, struct zclient
*zclient
,
480 afi_t afi
, vrf_id_t vrf_id
);
482 /* If state has changed, update state and call zebra_redistribute_send. */
483 extern void zclient_redistribute(int command
, struct zclient
*, afi_t
, int type
,
484 unsigned short instance
, vrf_id_t vrf_id
);
486 /* If state has changed, update state and send the command to zebra. */
487 extern void zclient_redistribute_default(int command
, struct zclient
*,
488 afi_t
, vrf_id_t vrf_id
);
490 /* Send the message in zclient->obuf to the zebra daemon (or enqueue it).
491 Returns 0 for success or -1 on an I/O error. */
492 extern int zclient_send_message(struct zclient
*);
494 /* create header for command, length to be filled in by user later */
495 extern void zclient_create_header(struct stream
*, uint16_t, vrf_id_t
);
497 * Read sizeof(struct zmsghdr) bytes from the provided socket and parse the
498 * received data into the specified fields. If this is successful, read the
499 * rest of the packet into the provided stream.
502 * The stream to read into
505 * The socket to read from
508 * Parsed message size will be placed in the pointed-at integer
511 * Parsed marker will be placed in the pointed-at byte
514 * Parsed version will be placed in the pointed-at byte
517 * Parsed VRF ID will be placed in the pointed-at vrf_id_t
520 * Parsed command number will be placed in the pointed-at integer
524 * - insufficient data for header was read
525 * - a version mismatch was detected
526 * - a marker mismatch was detected
527 * - header size field specified more data than could be read
529 extern int zclient_read_header(struct stream
*s
, int sock
, uint16_t *size
,
530 uint8_t *marker
, uint8_t *version
,
531 vrf_id_t
*vrf_id
, uint16_t *cmd
);
533 * Parse header from ZAPI message stream into struct zmsghdr.
534 * This function assumes the stream getp points at the first byte of the header.
535 * If the function is successful then the stream getp will point to the byte
536 * immediately after the last byte of the header.
539 * The stream containing the header
542 * The header struct to parse into.
545 * true if parsing succeeded, false otherwise
547 extern bool zapi_parse_header(struct stream
*zmsg
, struct zmsghdr
*hdr
);
549 extern void zclient_interface_set_master(struct zclient
*client
,
550 struct interface
*master
,
551 struct interface
*slave
);
552 extern struct interface
*zebra_interface_add_read(struct stream
*, vrf_id_t
);
553 extern struct interface
*zebra_interface_state_read(struct stream
*s
, vrf_id_t
);
554 extern struct connected
*zebra_interface_address_read(int, struct stream
*,
556 extern struct nbr_connected
*
557 zebra_interface_nbr_address_read(int, struct stream
*, vrf_id_t
);
558 extern struct interface
*zebra_interface_vrf_update_read(struct stream
*s
,
560 vrf_id_t
*new_vrf_id
);
561 extern void zebra_interface_if_set_value(struct stream
*, struct interface
*);
562 extern void zebra_router_id_update_read(struct stream
*s
, struct prefix
*rid
);
564 extern struct interface
*zebra_interface_link_params_read(struct stream
*s
,
566 extern size_t zebra_interface_link_params_write(struct stream
*,
568 extern int zclient_send_get_label_chunk(
569 struct zclient
*zclient
,
571 uint32_t chunk_size
);
573 extern int lm_label_manager_connect(struct zclient
*zclient
, int async
);
574 extern int lm_get_label_chunk(struct zclient
*zclient
, uint8_t keep
,
575 uint32_t chunk_size
, uint32_t *start
,
577 extern int lm_release_label_chunk(struct zclient
*zclient
, uint32_t start
,
579 extern int tm_table_manager_connect(struct zclient
*zclient
);
580 extern int tm_get_table_chunk(struct zclient
*zclient
, uint32_t chunk_size
,
581 uint32_t *start
, uint32_t *end
);
582 extern int tm_release_table_chunk(struct zclient
*zclient
, uint32_t start
,
585 extern int zebra_send_pw(struct zclient
*zclient
, int command
,
587 extern void zebra_read_pw_status_update(ZAPI_CALLBACK_ARGS
, struct zapi_pw_status
*pw
);
589 extern int zclient_route_send(uint8_t, struct zclient
*, struct zapi_route
*);
590 extern int zclient_send_rnh(struct zclient
*zclient
, int command
,
591 struct prefix
*p
, bool exact_match
,
593 extern int zapi_route_encode(uint8_t, struct stream
*, struct zapi_route
*);
594 extern int zapi_route_decode(struct stream
*, struct zapi_route
*);
595 bool zapi_route_notify_decode(struct stream
*s
, struct prefix
*p
,
597 enum zapi_route_notify_owner
*note
);
598 bool zapi_rule_notify_decode(struct stream
*s
, uint32_t *seqno
,
599 uint32_t *priority
, uint32_t *unique
,
601 enum zapi_rule_notify_owner
*note
);
602 bool zapi_ipset_notify_decode(struct stream
*s
,
604 enum zapi_ipset_notify_owner
*note
);
606 #define ZEBRA_IPSET_NAME_SIZE 32
608 bool zapi_ipset_entry_notify_decode(struct stream
*s
,
611 enum zapi_ipset_entry_notify_owner
*note
);
612 bool zapi_iptable_notify_decode(struct stream
*s
,
614 enum zapi_iptable_notify_owner
*note
);
616 extern struct nexthop
*nexthop_from_zapi_nexthop(struct zapi_nexthop
*znh
);
617 extern bool zapi_nexthop_update_decode(struct stream
*s
,
618 struct zapi_route
*nhr
);
620 static inline void zapi_route_set_blackhole(struct zapi_route
*api
,
621 enum blackhole_type bh_type
)
623 api
->nexthop_num
= 1;
624 api
->nexthops
[0].type
= NEXTHOP_TYPE_BLACKHOLE
;
625 api
->nexthops
[0].vrf_id
= VRF_DEFAULT
;
626 api
->nexthops
[0].bh_type
= bh_type
;
627 SET_FLAG(api
->message
, ZAPI_MESSAGE_NEXTHOP
);
631 #endif /* _ZEBRA_ZCLIENT_H */