]> git.proxmox.com Git - mirror_frr.git/blame - zebra/zserv.c
tools: retain sanity when reloading under systemd
[mirror_frr.git] / zebra / zserv.c
CommitLineData
bf094f69
QY
1/*
2 * Zebra API server.
3 * Portions:
4 * Copyright (C) 1997-1999 Kunihiro Ishiguro
5 * Copyright (C) 2015-2018 Cumulus Networks, Inc.
6 * et al.
718e3744 7 *
bf094f69
QY
8 * This program is free software; you can redistribute it and/or modify it
9 * under the terms of the GNU General Public License as published by the Free
10 * Software Foundation; either version 2 of the License, or (at your option)
11 * any later version.
718e3744 12 *
bf094f69
QY
13 * This program is distributed in the hope that it will be useful, but WITHOUT
14 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
15 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
16 * more details.
718e3744 17 *
896014f4
DL
18 * You should have received a copy of the GNU General Public License along
19 * with this program; see the file COPYING; if not, write to the Free Software
20 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
718e3744 21 */
22
23#include <zebra.h>
d8647095
QY
24
25/* clang-format off */
bf094f69
QY
26#include <errno.h> /* for errno */
27#include <netinet/in.h> /* for sockaddr_in */
28#include <stdint.h> /* for uint8_t */
29#include <stdio.h> /* for snprintf */
30#include <sys/socket.h> /* for sockaddr_storage, AF_UNIX, accept... */
31#include <sys/stat.h> /* for umask, mode_t */
32#include <sys/un.h> /* for sockaddr_un */
33#include <time.h> /* for NULL, tm, gmtime, time_t */
34#include <unistd.h> /* for close, unlink, ssize_t */
35
36#include "lib/buffer.h" /* for BUFFER_EMPTY, BUFFER_ERROR, BUFFE... */
37#include "lib/command.h" /* for vty, install_element, CMD_SUCCESS... */
453844ab 38#include "lib/hook.h" /* for DEFINE_HOOK, DEFINE_KOOH, hook_call */
bf094f69
QY
39#include "lib/linklist.h" /* for ALL_LIST_ELEMENTS_RO, ALL_LIST_EL... */
40#include "lib/libfrr.h" /* for frr_zclient_addr */
41#include "lib/log.h" /* for zlog_warn, zlog_debug, safe_strerror */
42#include "lib/memory.h" /* for MTYPE_TMP, XCALLOC, XFREE */
43#include "lib/monotime.h" /* for monotime, ONE_DAY_SECOND, ONE_WEE... */
44#include "lib/network.h" /* for set_nonblocking */
45#include "lib/privs.h" /* for zebra_privs_t, ZPRIVS_LOWER, ZPRI... */
46#include "lib/route_types.h" /* for ZEBRA_ROUTE_MAX */
47#include "lib/sockopt.h" /* for setsockopt_so_recvbuf, setsockopt... */
48#include "lib/sockunion.h" /* for sockopt_reuseaddr, sockopt_reuseport */
49#include "lib/stream.h" /* for STREAM_SIZE, stream (ptr only), ... */
50#include "lib/thread.h" /* for thread (ptr only), THREAD_ARG, ... */
51#include "lib/vrf.h" /* for vrf_info_lookup, VRF_DEFAULT */
52#include "lib/vty.h" /* for vty_out, vty (ptr only) */
53#include "lib/zassert.h" /* for assert */
54#include "lib/zclient.h" /* for zmsghdr, ZEBRA_HEADER_SIZE, ZEBRA... */
52f6868d 55#include "lib/frr_pthread.h" /* for frr_pthread_new, frr_pthread_stop... */
ae6670d0 56#include "lib/frratomic.h" /* for atomic_load_explicit, atomic_stor... */
174482ef 57#include "lib/lib_errors.h" /* for generic ferr ids */
bf094f69
QY
58
59#include "zebra/debug.h" /* for various debugging macros */
bf094f69 60#include "zebra/rib.h" /* for rib_score_proto */
bf094f69 61#include "zebra/zapi_msg.h" /* for zserv_handle_commands */
bf094f69 62#include "zebra/zebra_vrf.h" /* for zebra_vrf_lookup_by_id, zvrf */
d8647095 63#include "zebra/zserv.h" /* for zserv */
3801e764 64#include "zebra/zebra_router.h"
364fed6b 65#include "zebra/zebra_errors.h" /* for error messages */
d8647095 66/* clang-format on */
6b0655a2 67
1002497a 68/* privileges */
edd7c245 69extern struct zebra_privs_t zserv_privs;
453844ab 70
cc3d8834
DS
71/* The listener socket for clients connecting to us */
72static int zsock;
73
329e35da 74/*
f2efe6a3 75 * Client thread events.
329e35da 76 *
f2efe6a3 77 * These are used almost exclusively by client threads to drive their own event
24f8f979 78 * loops. The only exception is in zserv_client_create(), which pushes an
21ccc0cf 79 * initial ZSERV_CLIENT_READ event to start the API handler loop.
329e35da 80 */
21ccc0cf
QY
81enum zserv_client_event {
82 /* Schedule a socket read */
83 ZSERV_CLIENT_READ,
84 /* Schedule a buffer write */
85 ZSERV_CLIENT_WRITE,
21ccc0cf 86};
453844ab 87
21ccc0cf
QY
88/*
89 * Main thread events.
90 *
91 * These are used by client threads to notify the main thread about various
92 * events and to make processing requests.
93 */
94enum zserv_event {
95 /* Schedule listen job on Zebra API socket */
96 ZSERV_ACCEPT,
97 /* The calling client has packets on its input buffer */
98 ZSERV_PROCESS_MESSAGES,
99 /* The calling client wishes to be killed */
f3e33b69 100 ZSERV_HANDLE_CLIENT_FAIL,
21ccc0cf
QY
101};
102
103/*
104 * Zebra server event driver for all client threads.
105 *
106 * This is essentially a wrapper around thread_add_event() that centralizes
107 * those scheduling calls into one place.
108 *
109 * All calls to this function schedule an event on the pthread running the
110 * provided client.
111 *
112 * client
113 * the client in question, and thread target
114 *
115 * event
116 * the event to notify them about
117 */
118static void zserv_client_event(struct zserv *client,
119 enum zserv_client_event event);
120
121/*
122 * Zebra server event driver for the main thread.
123 *
124 * This is essentially a wrapper around thread_add_event() that centralizes
125 * those scheduling calls into one place.
126 *
127 * All calls to this function schedule an event on Zebra's main pthread.
128 *
129 * client
130 * the client in question
131 *
132 * event
133 * the event to notify the main thread about
134 */
135static void zserv_event(struct zserv *client, enum zserv_event event);
e16abbb3 136
e16abbb3 137
f2efe6a3 138/* Client thread lifecycle -------------------------------------------------- */
e16abbb3 139
9bcbcae2 140/*
1002497a
QY
141 * Log zapi message to zlog.
142 *
143 * errmsg (optional)
144 * Debugging message
9bcbcae2 145 *
1002497a
QY
146 * msg
147 * The message
148 *
149 * hdr (optional)
150 * The message header
9bcbcae2 151 */
49b3b01f
QY
152void zserv_log_message(const char *errmsg, struct stream *msg,
153 struct zmsghdr *hdr)
1002497a
QY
154{
155 zlog_debug("Rx'd ZAPI message");
156 if (errmsg)
157 zlog_debug("%s", errmsg);
158 if (hdr) {
159 zlog_debug(" Length: %d", hdr->length);
160 zlog_debug("Command: %s", zserv_command_string(hdr->command));
161 zlog_debug(" VRF: %u", hdr->vrf_id);
162 }
163 zlog_hexdump(msg->data, STREAM_READABLE(msg));
9bcbcae2
QY
164}
165
f2efe6a3
QY
166/*
167 * Gracefully shut down a client connection.
168 *
f3e33b69
QY
169 * Cancel any pending tasks for the client's thread. Then schedule a task on
170 * the main thread to shut down the calling thread.
f2efe6a3 171 *
c0226378
QY
172 * It is not safe to close the client socket in this function. The socket is
173 * owned by the main thread.
174 *
f2efe6a3
QY
175 * Must be called from the client pthread, never the main thread.
176 */
f3e33b69 177static void zserv_client_fail(struct zserv *client)
f2efe6a3 178{
e914ccbe 179 flog_warn(EC_ZEBRA_CLIENT_IO_ERROR,
9df414fe 180 "Client '%s' encountered an error and is shutting down.",
f3e33b69
QY
181 zebra_route_string(client->proto));
182
c2ca5ee6 183 atomic_store_explicit(&client->pthread->running, false,
f3e33b69 184 memory_order_relaxed);
c0226378 185
f2efe6a3
QY
186 THREAD_OFF(client->t_read);
187 THREAD_OFF(client->t_write);
f3e33b69 188 zserv_event(client, ZSERV_HANDLE_CLIENT_FAIL);
f2efe6a3
QY
189}
190
1002497a 191/*
370d8dad
QY
192 * Write all pending messages to client socket.
193 *
29bed51b
QY
194 * This function first attempts to flush any buffered data. If unsuccessful,
195 * the function reschedules itself and returns. If successful, it pops all
196 * available messages from the output queue and continues to write data
197 * directly to the socket until the socket would block. If the socket never
198 * blocks and all data is written, the function returns without rescheduling
199 * itself. If the socket ends up throwing EWOULDBLOCK, the remaining data is
200 * buffered and the function reschedules itself.
370d8dad 201 *
29bed51b
QY
202 * The utility of the buffer is that it allows us to vastly reduce lock
203 * contention by allowing us to pop *all* messages off the output queue at once
204 * instead of locking and unlocking each time we want to pop a single message
205 * off the queue. The same thing could arguably be accomplished faster by
206 * allowing the main thread to write directly into the buffer instead of
207 * enqueuing packets onto an intermediary queue, but the intermediary queue
208 * allows us to expose information about input and output queues to the user in
209 * terms of number of packets rather than size of data.
1002497a
QY
210 */
211static int zserv_write(struct thread *thread)
d62a17ae 212{
1002497a
QY
213 struct zserv *client = THREAD_ARG(thread);
214 struct stream *msg;
ce4f1050 215 uint32_t wcmd = 0;
29bed51b
QY
216 struct stream_fifo *cache;
217
218 /* If we have any data pending, try to flush it first */
ccd51bd2 219 switch (buffer_flush_all(client->wb, client->sock)) {
29bed51b
QY
220 case BUFFER_ERROR:
221 goto zwrite_fail;
222 case BUFFER_PENDING:
ccd51bd2
QY
223 atomic_store_explicit(&client->last_write_time,
224 (uint32_t)monotime(NULL),
225 memory_order_relaxed);
29bed51b
QY
226 zserv_client_event(client, ZSERV_CLIENT_WRITE);
227 return 0;
228 case BUFFER_EMPTY:
229 break;
230 }
231
232 cache = stream_fifo_new();
89f4e507 233
329e35da
QY
234 pthread_mutex_lock(&client->obuf_mtx);
235 {
c2ca5ee6 236 while (stream_fifo_head(client->obuf_fifo))
370d8dad
QY
237 stream_fifo_push(cache,
238 stream_fifo_pop(client->obuf_fifo));
329e35da
QY
239 }
240 pthread_mutex_unlock(&client->obuf_mtx);
241
ccd51bd2
QY
242 if (cache->tail) {
243 msg = cache->tail;
370d8dad 244 stream_set_getp(msg, 0);
370d8dad 245 wcmd = stream_getw_from(msg, 6);
ccd51bd2 246 }
822167e7 247
ccd51bd2
QY
248 while (stream_fifo_head(cache)) {
249 msg = stream_fifo_pop(cache);
250 buffer_put(client->wb, STREAM_DATA(msg), stream_get_endp(msg));
370d8dad
QY
251 stream_free(msg);
252 }
1002497a 253
822167e7 254 stream_fifo_free(cache);
1002497a 255
ccd51bd2
QY
256 /* If we have any data pending, try to flush it first */
257 switch (buffer_flush_all(client->wb, client->sock)) {
258 case BUFFER_ERROR:
259 goto zwrite_fail;
260 case BUFFER_PENDING:
261 atomic_store_explicit(&client->last_write_time,
262 (uint32_t)monotime(NULL),
263 memory_order_relaxed);
264 zserv_client_event(client, ZSERV_CLIENT_WRITE);
265 return 0;
ccd51bd2
QY
266 case BUFFER_EMPTY:
267 break;
268 }
269
370d8dad
QY
270 atomic_store_explicit(&client->last_write_cmd, wcmd,
271 memory_order_relaxed);
1002497a 272
52f6868d 273 atomic_store_explicit(&client->last_write_time,
370d8dad 274 (uint32_t)monotime(NULL), memory_order_relaxed);
52f6868d 275
1002497a 276 return 0;
29bed51b
QY
277
278zwrite_fail:
e914ccbe 279 flog_warn(EC_ZEBRA_CLIENT_WRITE_FAILED,
9df414fe 280 "%s: could not write to %s [fd = %d], closing.", __func__,
29bed51b 281 zebra_route_string(client->proto), client->sock);
f3e33b69 282 zserv_client_fail(client);
29bed51b 283 return 0;
0c5e7be5
DS
284}
285
329e35da
QY
286/*
287 * Read and process data from a client socket.
288 *
289 * The responsibilities here are to read raw data from the client socket,
290 * validate the header, encapsulate it into a single stream object, push it
291 * onto the input queue and then notify the main thread that there is new data
292 * available.
293 *
294 * This function first looks for any data in the client structure's working
295 * input buffer. If data is present, it is assumed that reading stopped in a
296 * previous invocation of this task and needs to be resumed to finish a message.
297 * Otherwise, the socket data stream is assumed to be at the beginning of a new
298 * ZAPI message (specifically at the header). The header is read and validated.
299 * If the header passed validation then the length field found in the header is
300 * used to compute the total length of the message. That much data is read (but
301 * not inspected), appended to the header, placed into a stream and pushed onto
302 * the client's input queue. A task is then scheduled on the main thread to
303 * process the client's input queue. Finally, if all of this was successful,
304 * this task reschedules itself.
305 *
306 * Any failure in any of these actions is handled by terminating the client.
307 */
1002497a 308static int zserv_read(struct thread *thread)
0c5e7be5 309{
ae6670d0 310 struct zserv *client = THREAD_ARG(thread);
0c5e7be5 311 int sock;
0c5e7be5 312 size_t already;
ae6670d0
QY
313 struct stream_fifo *cache;
314 uint32_t p2p_orig;
315
1572d9af
QY
316 uint32_t p2p;
317 struct zmsghdr hdr;
318
5ec5a716 319 p2p_orig = atomic_load_explicit(&zrouter.packets_to_process,
ae6670d0
QY
320 memory_order_relaxed);
321 cache = stream_fifo_new();
370d8dad 322 p2p = p2p_orig;
0c5e7be5 323 sock = THREAD_FD(thread);
0c5e7be5 324
43ea2c76 325 while (p2p) {
107afcd1
QY
326 ssize_t nb;
327 bool hdrvalid;
328 char errmsg[256];
329
1002497a
QY
330 already = stream_get_endp(client->ibuf_work);
331
5a762c8a 332 /* Read length and command (if we don't have it already). */
1002497a
QY
333 if (already < ZEBRA_HEADER_SIZE) {
334 nb = stream_read_try(client->ibuf_work, sock,
335 ZEBRA_HEADER_SIZE - already);
03f29018
DS
336 if ((nb == 0 || nb == -1)) {
337 if (IS_ZEBRA_DEBUG_EVENT)
338 zlog_debug("connection closed socket [%d]",
339 sock);
1002497a 340 goto zread_fail;
03f29018 341 }
1002497a 342 if (nb != (ssize_t)(ZEBRA_HEADER_SIZE - already)) {
5a762c8a 343 /* Try again later. */
1002497a 344 break;
5a762c8a
DS
345 }
346 already = ZEBRA_HEADER_SIZE;
0c5e7be5 347 }
0c5e7be5 348
5a762c8a 349 /* Reset to read from the beginning of the incoming packet. */
1002497a 350 stream_set_getp(client->ibuf_work, 0);
0c5e7be5 351
5a762c8a 352 /* Fetch header values */
1002497a 353 hdrvalid = zapi_parse_header(client->ibuf_work, &hdr);
0c5e7be5 354
1002497a
QY
355 if (!hdrvalid) {
356 snprintf(errmsg, sizeof(errmsg),
357 "%s: Message has corrupt header", __func__);
358 zserv_log_message(errmsg, client->ibuf_work, NULL);
359 goto zread_fail;
0c5e7be5 360 }
1002497a
QY
361
362 /* Validate header */
363 if (hdr.marker != ZEBRA_HEADER_MARKER
364 || hdr.version != ZSERV_VERSION) {
365 snprintf(
366 errmsg, sizeof(errmsg),
367 "Message has corrupt header\n%s: socket %d version mismatch, marker %d, version %d",
368 __func__, sock, hdr.marker, hdr.version);
369 zserv_log_message(errmsg, client->ibuf_work, &hdr);
370 goto zread_fail;
5a762c8a 371 }
1002497a
QY
372 if (hdr.length < ZEBRA_HEADER_SIZE) {
373 snprintf(
374 errmsg, sizeof(errmsg),
375 "Message has corrupt header\n%s: socket %d message length %u is less than header size %d",
376 __func__, sock, hdr.length, ZEBRA_HEADER_SIZE);
377 zserv_log_message(errmsg, client->ibuf_work, &hdr);
378 goto zread_fail;
379 }
380 if (hdr.length > STREAM_SIZE(client->ibuf_work)) {
381 snprintf(
382 errmsg, sizeof(errmsg),
383 "Message has corrupt header\n%s: socket %d message length %u exceeds buffer size %lu",
384 __func__, sock, hdr.length,
385 (unsigned long)STREAM_SIZE(client->ibuf_work));
1572d9af 386 zserv_log_message(errmsg, client->ibuf_work, &hdr);
1002497a 387 goto zread_fail;
0c5e7be5 388 }
0c5e7be5 389
5a762c8a 390 /* Read rest of data. */
1002497a
QY
391 if (already < hdr.length) {
392 nb = stream_read_try(client->ibuf_work, sock,
393 hdr.length - already);
03f29018
DS
394 if ((nb == 0 || nb == -1)) {
395 if (IS_ZEBRA_DEBUG_EVENT)
396 zlog_debug(
397 "connection closed [%d] when reading zebra data",
398 sock);
1002497a 399 goto zread_fail;
03f29018 400 }
1002497a 401 if (nb != (ssize_t)(hdr.length - already)) {
5a762c8a 402 /* Try again later. */
1002497a 403 break;
5a762c8a
DS
404 }
405 }
0c5e7be5 406
5a762c8a 407 /* Debug packet information. */
494247b5
DS
408 if (IS_ZEBRA_DEBUG_PACKET)
409 zlog_debug("zebra message[%s:%u:%u] comes from socket [%d]",
410 zserv_command_string(hdr.command),
411 hdr.vrf_id, hdr.length,
996c9314 412 sock);
0c5e7be5 413
1572d9af
QY
414 stream_set_getp(client->ibuf_work, 0);
415 struct stream *msg = stream_dup(client->ibuf_work);
416
417 stream_fifo_push(cache, msg);
418 stream_reset(client->ibuf_work);
43ea2c76 419 p2p--;
1572d9af
QY
420 }
421
422 if (p2p < p2p_orig) {
423 /* update session statistics */
52f6868d
QY
424 atomic_store_explicit(&client->last_read_time, monotime(NULL),
425 memory_order_relaxed);
426 atomic_store_explicit(&client->last_read_cmd, hdr.command,
427 memory_order_relaxed);
5a762c8a 428
1572d9af 429 /* publish read packets on client's input queue */
329e35da
QY
430 pthread_mutex_lock(&client->ibuf_mtx);
431 {
1572d9af
QY
432 while (cache->head)
433 stream_fifo_push(client->ibuf_fifo,
434 stream_fifo_pop(cache));
329e35da
QY
435 }
436 pthread_mutex_unlock(&client->ibuf_mtx);
822167e7
QY
437
438 /* Schedule job to process those packets */
439 zserv_event(client, ZSERV_PROCESS_MESSAGES);
440
d62a17ae 441 }
442
1002497a 443 if (IS_ZEBRA_DEBUG_PACKET)
494247b5
DS
444 zlog_debug("Read %d packets from client: %s", p2p_orig - p2p,
445 zebra_route_string(client->proto));
1002497a 446
1002497a 447 /* Reschedule ourselves */
21ccc0cf 448 zserv_client_event(client, ZSERV_CLIENT_READ);
1002497a 449
1572d9af
QY
450 stream_fifo_free(cache);
451
d62a17ae 452 return 0;
1002497a
QY
453
454zread_fail:
1572d9af 455 stream_fifo_free(cache);
f3e33b69 456 zserv_client_fail(client);
1002497a 457 return -1;
718e3744 458}
459
21ccc0cf
QY
460static void zserv_client_event(struct zserv *client,
461 enum zserv_client_event event)
1002497a
QY
462{
463 switch (event) {
21ccc0cf 464 case ZSERV_CLIENT_READ:
329e35da
QY
465 thread_add_read(client->pthread->master, zserv_read, client,
466 client->sock, &client->t_read);
1002497a 467 break;
21ccc0cf 468 case ZSERV_CLIENT_WRITE:
329e35da 469 thread_add_write(client->pthread->master, zserv_write, client,
1002497a
QY
470 client->sock, &client->t_write);
471 break;
472 }
473}
718e3744 474
f2efe6a3
QY
475/* Main thread lifecycle ---------------------------------------------------- */
476
f2efe6a3
QY
477/*
478 * Read and process messages from a client.
479 *
480 * This task runs on the main pthread. It is scheduled by client pthreads when
481 * they have new messages available on their input queues. The client is passed
482 * as the task argument.
483 *
484 * Each message is popped off the client's input queue and the action associated
485 * with the message is executed. This proceeds until there are no more messages,
904e0d88
QY
486 * an error occurs, or the processing limit is reached.
487 *
2561d12e 488 * The client's I/O thread can push at most zrouter.packets_to_process messages
822167e7 489 * onto the input buffer before notifying us there are packets to read. As long
2561d12e 490 * as we always process zrouter.packets_to_process messages here, then we can
822167e7
QY
491 * rely on the read thread to handle queuing this task enough times to process
492 * everything on the input queue.
f2efe6a3
QY
493 */
494static int zserv_process_messages(struct thread *thread)
495{
496 struct zserv *client = THREAD_ARG(thread);
f2efe6a3 497 struct stream *msg;
904e0d88 498 struct stream_fifo *cache = stream_fifo_new();
5ec5a716 499 uint32_t p2p = zrouter.packets_to_process;
dded2aba 500 bool need_resched = false;
f2efe6a3 501
f2efe6a3
QY
502 pthread_mutex_lock(&client->ibuf_mtx);
503 {
822167e7
QY
504 uint32_t i;
505 for (i = 0; i < p2p && stream_fifo_head(client->ibuf_fifo);
506 ++i) {
507 msg = stream_fifo_pop(client->ibuf_fifo);
508 stream_fifo_push(cache, msg);
509 }
904e0d88 510
822167e7 511 msg = NULL;
dded2aba
MS
512
513 /* Need to reschedule processing work if there are still
514 * packets in the fifo.
515 */
516 if (stream_fifo_head(client->ibuf_fifo))
517 need_resched = true;
f2efe6a3
QY
518 }
519 pthread_mutex_unlock(&client->ibuf_mtx);
520
822167e7 521 while (stream_fifo_head(cache)) {
904e0d88 522 msg = stream_fifo_pop(cache);
904e0d88
QY
523 zserv_handle_commands(client, msg);
524 stream_free(msg);
525 }
526
527 stream_fifo_free(cache);
528
dded2aba
MS
529 /* Reschedule ourselves if necessary */
530 if (need_resched)
531 zserv_event(client, ZSERV_PROCESS_MESSAGES);
532
f2efe6a3
QY
533 return 0;
534}
535
21ccc0cf 536int zserv_send_message(struct zserv *client, struct stream *msg)
f2efe6a3 537{
727c9b99
QY
538 /*
539 * This is a somewhat poorly named variable added with Zebra's portion
540 * of the label manager. That component does not use the regular
541 * zserv/zapi_msg interface for handling its messages, as the client
542 * itself runs in-process. Instead it uses synchronous writes on the
543 * zserv client's socket directly in the zread* handlers for its
544 * message types. Furthermore, it cannot handle the usual messages
545 * Zebra sends (such as those for interface changes) and so has added
546 * this flag and check here as a hack to suppress all messages that it
547 * does not explicitly know about.
548 *
549 * In any case this needs to be cleaned up at some point.
550 *
551 * See also:
552 * zread_label_manager_request
553 * zsend_label_manager_connect_response
554 * zsend_assign_label_chunk_response
555 * ...
556 */
557 if (client->is_synchronous)
558 return 0;
559
f2efe6a3
QY
560 pthread_mutex_lock(&client->obuf_mtx);
561 {
562 stream_fifo_push(client->obuf_fifo, msg);
f2efe6a3
QY
563 }
564 pthread_mutex_unlock(&client->obuf_mtx);
ccd51bd2
QY
565
566 zserv_client_event(client, ZSERV_CLIENT_WRITE);
567
f2efe6a3
QY
568 return 0;
569}
570
571
572/* Hooks for client connect / disconnect */
21ccc0cf
QY
573DEFINE_HOOK(zserv_client_connect, (struct zserv *client), (client));
574DEFINE_KOOH(zserv_client_close, (struct zserv *client), (client));
f2efe6a3
QY
575
576/*
577 * Deinitialize zebra client.
578 *
579 * - Deregister and deinitialize related internal resources
580 * - Gracefully close socket
581 * - Free associated resources
582 * - Free client structure
583 *
584 * This does *not* take any action on the struct thread * fields. These are
585 * managed by the owning pthread and any tasks associated with them must have
586 * been stopped prior to invoking this function.
587 */
21ccc0cf 588static void zserv_client_free(struct zserv *client)
f2efe6a3 589{
21ccc0cf 590 hook_call(zserv_client_close, client);
f2efe6a3
QY
591
592 /* Close file descriptor. */
593 if (client->sock) {
594 unsigned long nroutes;
595
596 close(client->sock);
a580357a 597
f2efe6a3
QY
598 nroutes = rib_score_proto(client->proto, client->instance);
599 zlog_notice(
600 "client %d disconnected. %lu %s routes removed from the rib",
601 client->sock, nroutes,
602 zebra_route_string(client->proto));
603 client->sock = -1;
604 }
605
606 /* Free stream buffers. */
607 if (client->ibuf_work)
608 stream_free(client->ibuf_work);
609 if (client->obuf_work)
610 stream_free(client->obuf_work);
611 if (client->ibuf_fifo)
612 stream_fifo_free(client->ibuf_fifo);
613 if (client->obuf_fifo)
614 stream_fifo_free(client->obuf_fifo);
615 if (client->wb)
616 buffer_free(client->wb);
617
618 /* Free buffer mutexes */
619 pthread_mutex_destroy(&client->obuf_mtx);
620 pthread_mutex_destroy(&client->ibuf_mtx);
621
622 /* Free bitmaps. */
49db7a7b 623 for (afi_t afi = AFI_IP; afi < AFI_MAX; afi++) {
f2efe6a3
QY
624 for (int i = 0; i < ZEBRA_ROUTE_MAX; i++)
625 vrf_bitmap_free(client->redist[afi][i]);
626
49db7a7b
RW
627 vrf_bitmap_free(client->redist_default[afi]);
628 }
f2efe6a3
QY
629 vrf_bitmap_free(client->ridinfo);
630
631 XFREE(MTYPE_TMP, client);
632}
633
f3e33b69 634void zserv_close_client(struct zserv *client)
f2efe6a3 635{
f3e33b69 636 /* synchronously stop and join pthread */
f2efe6a3
QY
637 frr_pthread_stop(client->pthread, NULL);
638
f3e33b69
QY
639 if (IS_ZEBRA_DEBUG_EVENT)
640 zlog_debug("Closing client '%s'",
641 zebra_route_string(client->proto));
642
3801e764 643 thread_cancel_event(zrouter.master, client);
f3e33b69 644 THREAD_OFF(client->t_cleanup);
dded2aba 645 THREAD_OFF(client->t_process);
f3e33b69
QY
646
647 /* destroy pthread */
f2efe6a3
QY
648 frr_pthread_destroy(client->pthread);
649 client->pthread = NULL;
650
f3e33b69 651 /* remove from client list */
161e9ab7 652 listnode_delete(zrouter.client_list, client);
f3e33b69
QY
653
654 /* delete client */
21ccc0cf 655 zserv_client_free(client);
f3e33b69
QY
656}
657
658/*
659 * This task is scheduled by a ZAPI client pthread on the main pthread when it
660 * wants to stop itself. When this executes, the client connection should
661 * already have been closed and the thread will most likely have died, but its
662 * resources still need to be cleaned up.
663 */
664static int zserv_handle_client_fail(struct thread *thread)
665{
666 struct zserv *client = THREAD_ARG(thread);
667
668 zserv_close_client(client);
f2efe6a3
QY
669 return 0;
670}
671
672/*
673 * Create a new client.
674 *
675 * This is called when a new connection is accept()'d on the ZAPI socket. It
676 * initializes new client structure, notifies any subscribers of the connection
677 * event and spawns the client's thread.
678 *
679 * sock
680 * client's socket file descriptor
681 */
2875801f 682static struct zserv *zserv_client_create(int sock)
f2efe6a3
QY
683{
684 struct zserv *client;
685 int i;
686 afi_t afi;
687
688 client = XCALLOC(MTYPE_TMP, sizeof(struct zserv));
689
690 /* Make client input/output buffer. */
691 client->sock = sock;
692 client->ibuf_fifo = stream_fifo_new();
693 client->obuf_fifo = stream_fifo_new();
694 client->ibuf_work = stream_new(ZEBRA_MAX_PACKET_SIZ);
695 client->obuf_work = stream_new(ZEBRA_MAX_PACKET_SIZ);
696 pthread_mutex_init(&client->ibuf_mtx, NULL);
697 pthread_mutex_init(&client->obuf_mtx, NULL);
698 client->wb = buffer_new(0);
699
f2efe6a3
QY
700 atomic_store_explicit(&client->connect_time, (uint32_t) monotime(NULL),
701 memory_order_relaxed);
702
703 /* Initialize flags */
49db7a7b 704 for (afi = AFI_IP; afi < AFI_MAX; afi++) {
f2efe6a3
QY
705 for (i = 0; i < ZEBRA_ROUTE_MAX; i++)
706 client->redist[afi][i] = vrf_bitmap_init();
49db7a7b
RW
707 client->redist_default[afi] = vrf_bitmap_init();
708 }
f2efe6a3
QY
709 client->ridinfo = vrf_bitmap_init();
710
711 /* by default, it's not a synchronous client */
712 client->is_synchronous = 0;
713
714 /* Add this client to linked list. */
161e9ab7 715 listnode_add(zrouter.client_list, client);
f2efe6a3
QY
716
717 struct frr_pthread_attr zclient_pthr_attrs = {
f2efe6a3
QY
718 .start = frr_pthread_attr_default.start,
719 .stop = frr_pthread_attr_default.stop
720 };
721 client->pthread =
57019528
CS
722 frr_pthread_new(&zclient_pthr_attrs, "Zebra API client thread",
723 "zebra_apic");
f2efe6a3 724
f2efe6a3 725 /* start read loop */
21ccc0cf 726 zserv_client_event(client, ZSERV_CLIENT_READ);
f2efe6a3
QY
727
728 /* call callbacks */
21ccc0cf 729 hook_call(zserv_client_connect, client);
f2efe6a3
QY
730
731 /* start pthread */
732 frr_pthread_run(client->pthread, NULL);
2875801f
QY
733
734 return client;
f2efe6a3 735}
329e35da 736
21ccc0cf
QY
737/*
738 * Accept socket connection.
739 */
740static int zserv_accept(struct thread *thread)
718e3744 741{
d62a17ae 742 int accept_sock;
743 int client_sock;
744 struct sockaddr_in client;
745 socklen_t len;
746
747 accept_sock = THREAD_FD(thread);
718e3744 748
d62a17ae 749 /* Reregister myself. */
21ccc0cf 750 zserv_event(NULL, ZSERV_ACCEPT);
718e3744 751
d62a17ae 752 len = sizeof(struct sockaddr_in);
753 client_sock = accept(accept_sock, (struct sockaddr *)&client, &len);
719e9741 754
d62a17ae 755 if (client_sock < 0) {
450971aa 756 flog_err_sys(EC_LIB_SOCKET, "Can't accept zebra socket: %s",
9df414fe 757 safe_strerror(errno));
d62a17ae 758 return -1;
759 }
718e3744 760
d62a17ae 761 /* Make client socket non-blocking. */
762 set_nonblocking(client_sock);
718e3744 763
d62a17ae 764 /* Create new zebra client. */
21ccc0cf 765 zserv_client_create(client_sock);
718e3744 766
d62a17ae 767 return 0;
718e3744 768}
769
41674562
DS
770void zserv_close(void)
771{
772 /*
773 * On shutdown, let's close the socket down
774 * so that long running processes of killing the
775 * routing table doesn't leave us in a bad
776 * state where a client tries to reconnect
777 */
778 close(zsock);
779 zsock = -1;
780}
781
21ccc0cf 782void zserv_start(char *path)
d62a17ae 783{
784 int ret;
d62a17ae 785 mode_t old_mask;
689f5a8c
DL
786 struct sockaddr_storage sa;
787 socklen_t sa_len;
d62a17ae 788
689f5a8c
DL
789 if (!frr_zclient_addr(&sa, &sa_len, path))
790 /* should be caught in zebra main() */
791 return;
d62a17ae 792
793 /* Set umask */
794 old_mask = umask(0077);
795
796 /* Make UNIX domain socket. */
cc3d8834
DS
797 zsock = socket(sa.ss_family, SOCK_STREAM, 0);
798 if (zsock < 0) {
450971aa 799 flog_err_sys(EC_LIB_SOCKET, "Can't create zserv socket: %s",
9df414fe 800 safe_strerror(errno));
d62a17ae 801 return;
802 }
803
689f5a8c 804 if (sa.ss_family != AF_UNIX) {
cc3d8834
DS
805 sockopt_reuseaddr(zsock);
806 sockopt_reuseport(zsock);
689f5a8c
DL
807 } else {
808 struct sockaddr_un *suna = (struct sockaddr_un *)&sa;
809 if (suna->sun_path[0])
810 unlink(suna->sun_path);
811 }
812
338b8e91
RW
813 setsockopt_so_recvbuf(zsock, 1048576);
814 setsockopt_so_sendbuf(zsock, 1048576);
689f5a8c 815
6bb30c2c 816 frr_elevate_privs((sa.ss_family != AF_UNIX) ? &zserv_privs : NULL) {
cc3d8834 817 ret = bind(zsock, (struct sockaddr *)&sa, sa_len);
6bb30c2c 818 }
d62a17ae 819 if (ret < 0) {
1c50c1c0
QY
820 flog_err_sys(EC_LIB_SOCKET, "Can't bind zserv socket on %s: %s",
821 path, safe_strerror(errno));
cc3d8834
DS
822 close(zsock);
823 zsock = -1;
d62a17ae 824 return;
825 }
826
cc3d8834 827 ret = listen(zsock, 5);
d62a17ae 828 if (ret < 0) {
450971aa 829 flog_err_sys(EC_LIB_SOCKET,
9df414fe
QY
830 "Can't listen to zserv socket %s: %s", path,
831 safe_strerror(errno));
cc3d8834
DS
832 close(zsock);
833 zsock = -1;
d62a17ae 834 return;
835 }
836
837 umask(old_mask);
838
21ccc0cf 839 zserv_event(NULL, ZSERV_ACCEPT);
718e3744 840}
6b0655a2 841
21ccc0cf
QY
842void zserv_event(struct zserv *client, enum zserv_event event)
843{
844 switch (event) {
845 case ZSERV_ACCEPT:
cc3d8834 846 thread_add_read(zrouter.master, zserv_accept, NULL, zsock,
21ccc0cf
QY
847 NULL);
848 break;
849 case ZSERV_PROCESS_MESSAGES:
3801e764 850 thread_add_event(zrouter.master, zserv_process_messages, client,
dded2aba 851 0, &client->t_process);
21ccc0cf 852 break;
f3e33b69 853 case ZSERV_HANDLE_CLIENT_FAIL:
3801e764 854 thread_add_event(zrouter.master, zserv_handle_client_fail,
f3e33b69 855 client, 0, &client->t_cleanup);
21ccc0cf
QY
856 }
857}
858
859
f2efe6a3
QY
860/* General purpose ---------------------------------------------------------- */
861
04b02fda 862#define ZEBRA_TIME_BUF 32
d62a17ae 863static char *zserv_time_buf(time_t *time1, char *buf, int buflen)
04b02fda 864{
d62a17ae 865 struct tm *tm;
866 time_t now;
04b02fda 867
d62a17ae 868 assert(buf != NULL);
869 assert(buflen >= ZEBRA_TIME_BUF);
870 assert(time1 != NULL);
04b02fda 871
d62a17ae 872 if (!*time1) {
873 snprintf(buf, buflen, "never ");
874 return (buf);
875 }
04b02fda 876
d62a17ae 877 now = monotime(NULL);
878 now -= *time1;
879 tm = gmtime(&now);
04b02fda 880
d62a17ae 881 if (now < ONE_DAY_SECOND)
882 snprintf(buf, buflen, "%02d:%02d:%02d", tm->tm_hour, tm->tm_min,
883 tm->tm_sec);
884 else if (now < ONE_WEEK_SECOND)
885 snprintf(buf, buflen, "%dd%02dh%02dm", tm->tm_yday, tm->tm_hour,
886 tm->tm_min);
96ade3ed 887 else
d62a17ae 888 snprintf(buf, buflen, "%02dw%dd%02dh", tm->tm_yday / 7,
889 tm->tm_yday - ((tm->tm_yday / 7) * 7), tm->tm_hour);
890 return buf;
891}
892
893static void zebra_show_client_detail(struct vty *vty, struct zserv *client)
894{
895 char cbuf[ZEBRA_TIME_BUF], rbuf[ZEBRA_TIME_BUF];
896 char wbuf[ZEBRA_TIME_BUF], nhbuf[ZEBRA_TIME_BUF], mbuf[ZEBRA_TIME_BUF];
52f6868d 897 time_t connect_time, last_read_time, last_write_time;
0545c373 898 uint32_t last_read_cmd, last_write_cmd;
d62a17ae 899
900 vty_out(vty, "Client: %s", zebra_route_string(client->proto));
901 if (client->instance)
902 vty_out(vty, " Instance: %d", client->instance);
903 vty_out(vty, "\n");
904
905 vty_out(vty, "------------------------ \n");
906 vty_out(vty, "FD: %d \n", client->sock);
d62a17ae 907
52f6868d
QY
908 connect_time = (time_t) atomic_load_explicit(&client->connect_time,
909 memory_order_relaxed);
910
d62a17ae 911 vty_out(vty, "Connect Time: %s \n",
52f6868d 912 zserv_time_buf(&connect_time, cbuf, ZEBRA_TIME_BUF));
d62a17ae 913 if (client->nh_reg_time) {
914 vty_out(vty, "Nexthop Registry Time: %s \n",
915 zserv_time_buf(&client->nh_reg_time, nhbuf,
916 ZEBRA_TIME_BUF));
917 if (client->nh_last_upd_time)
918 vty_out(vty, "Nexthop Last Update Time: %s \n",
919 zserv_time_buf(&client->nh_last_upd_time, mbuf,
920 ZEBRA_TIME_BUF));
921 else
922 vty_out(vty, "No Nexthop Update sent\n");
923 } else
924 vty_out(vty, "Not registered for Nexthop Updates\n");
925
1f312c84
QY
926 last_read_time = (time_t)atomic_load_explicit(&client->last_read_time,
927 memory_order_relaxed);
928 last_write_time = (time_t)atomic_load_explicit(&client->last_write_time,
52f6868d
QY
929 memory_order_relaxed);
930
931 last_read_cmd = atomic_load_explicit(&client->last_read_cmd,
932 memory_order_relaxed);
933 last_write_cmd = atomic_load_explicit(&client->last_write_cmd,
934 memory_order_relaxed);
935
d62a17ae 936 vty_out(vty, "Last Msg Rx Time: %s \n",
52f6868d 937 zserv_time_buf(&last_read_time, rbuf, ZEBRA_TIME_BUF));
d62a17ae 938 vty_out(vty, "Last Msg Tx Time: %s \n",
52f6868d
QY
939 zserv_time_buf(&last_write_time, wbuf, ZEBRA_TIME_BUF));
940 if (last_read_cmd)
d62a17ae 941 vty_out(vty, "Last Rcvd Cmd: %s \n",
52f6868d
QY
942 zserv_command_string(last_read_cmd));
943 if (last_write_cmd)
d62a17ae 944 vty_out(vty, "Last Sent Cmd: %s \n",
52f6868d 945 zserv_command_string(last_write_cmd));
d62a17ae 946 vty_out(vty, "\n");
947
948 vty_out(vty, "Type Add Update Del \n");
949 vty_out(vty, "================================================== \n");
950 vty_out(vty, "IPv4 %-12d%-12d%-12d\n", client->v4_route_add_cnt,
951 client->v4_route_upd8_cnt, client->v4_route_del_cnt);
952 vty_out(vty, "IPv6 %-12d%-12d%-12d\n", client->v6_route_add_cnt,
953 client->v6_route_upd8_cnt, client->v6_route_del_cnt);
954 vty_out(vty, "Redist:v4 %-12d%-12d%-12d\n", client->redist_v4_add_cnt,
955 0, client->redist_v4_del_cnt);
956 vty_out(vty, "Redist:v6 %-12d%-12d%-12d\n", client->redist_v6_add_cnt,
957 0, client->redist_v6_del_cnt);
958 vty_out(vty, "Connected %-12d%-12d%-12d\n", client->ifadd_cnt, 0,
959 client->ifdel_cnt);
960 vty_out(vty, "BFD peer %-12d%-12d%-12d\n", client->bfd_peer_add_cnt,
961 client->bfd_peer_upd8_cnt, client->bfd_peer_del_cnt);
ab5990d8
DS
962 vty_out(vty, "NHT v4 %-12d%-12d%-12d\n",
963 client->v4_nh_watch_add_cnt, 0, client->v4_nh_watch_rem_cnt);
964 vty_out(vty, "NHT v6 %-12d%-12d%-12d\n",
965 client->v6_nh_watch_add_cnt, 0, client->v6_nh_watch_rem_cnt);
4ab3321f
AK
966 vty_out(vty, "VxLAN SG %-12d%-12d%-12d\n", client->vxlan_sg_add_cnt,
967 0, client->vxlan_sg_del_cnt);
d62a17ae 968 vty_out(vty, "Interface Up Notifications: %d\n", client->ifup_cnt);
969 vty_out(vty, "Interface Down Notifications: %d\n", client->ifdown_cnt);
970 vty_out(vty, "VNI add notifications: %d\n", client->vniadd_cnt);
971 vty_out(vty, "VNI delete notifications: %d\n", client->vnidel_cnt);
b7cfce93
MK
972 vty_out(vty, "L3-VNI add notifications: %d\n", client->l3vniadd_cnt);
973 vty_out(vty, "L3-VNI delete notifications: %d\n", client->l3vnidel_cnt);
d62a17ae 974 vty_out(vty, "MAC-IP add notifications: %d\n", client->macipadd_cnt);
975 vty_out(vty, "MAC-IP delete notifications: %d\n", client->macipdel_cnt);
976
03ed85a6
DS
977#if defined DEV_BUILD
978 vty_out(vty, "Input Fifo: %zu:%zu Output Fifo: %zu:%zu\n",
979 client->ibuf_fifo->count, client->ibuf_fifo->max_count,
980 client->obuf_fifo->count, client->obuf_fifo->max_count);
981#endif
d62a17ae 982 vty_out(vty, "\n");
983 return;
984}
985
986static void zebra_show_client_brief(struct vty *vty, struct zserv *client)
987{
988 char cbuf[ZEBRA_TIME_BUF], rbuf[ZEBRA_TIME_BUF];
989 char wbuf[ZEBRA_TIME_BUF];
52f6868d
QY
990 time_t connect_time, last_read_time, last_write_time;
991
e1de21d7
QY
992 connect_time = (time_t)atomic_load_explicit(&client->connect_time,
993 memory_order_relaxed);
994 last_read_time = (time_t)atomic_load_explicit(&client->last_read_time,
995 memory_order_relaxed);
996 last_write_time = (time_t)atomic_load_explicit(&client->last_write_time,
52f6868d 997 memory_order_relaxed);
d62a17ae 998
999 vty_out(vty, "%-8s%12s %12s%12s%8d/%-8d%8d/%-8d\n",
1000 zebra_route_string(client->proto),
52f6868d
QY
1001 zserv_time_buf(&connect_time, cbuf, ZEBRA_TIME_BUF),
1002 zserv_time_buf(&last_read_time, rbuf, ZEBRA_TIME_BUF),
1003 zserv_time_buf(&last_write_time, wbuf, ZEBRA_TIME_BUF),
d62a17ae 1004 client->v4_route_add_cnt + client->v4_route_upd8_cnt,
1005 client->v4_route_del_cnt,
1006 client->v6_route_add_cnt + client->v6_route_upd8_cnt,
1007 client->v6_route_del_cnt);
1008}
1009
21ccc0cf 1010struct zserv *zserv_find_client(uint8_t proto, unsigned short instance)
d62a17ae 1011{
1012 struct listnode *node, *nnode;
1013 struct zserv *client;
1014
161e9ab7 1015 for (ALL_LIST_ELEMENTS(zrouter.client_list, node, nnode, client)) {
996c9314 1016 if (client->proto == proto && client->instance == instance)
d62a17ae 1017 return client;
1018 }
1019
1020 return NULL;
8ed6821e 1021}
1022
718e3744 1023/* This command is for debugging purpose. */
1024DEFUN (show_zebra_client,
1025 show_zebra_client_cmd,
1026 "show zebra client",
1027 SHOW_STR
41e7fb80 1028 ZEBRA_STR
b9ee4999 1029 "Client information\n")
718e3744 1030{
d62a17ae 1031 struct listnode *node;
1032 struct zserv *client;
718e3744 1033
161e9ab7 1034 for (ALL_LIST_ELEMENTS_RO(zrouter.client_list, node, client))
d62a17ae 1035 zebra_show_client_detail(vty, client);
04b02fda 1036
d62a17ae 1037 return CMD_SUCCESS;
04b02fda
DS
1038}
1039
1040/* This command is for debugging purpose. */
1041DEFUN (show_zebra_client_summary,
1042 show_zebra_client_summary_cmd,
1043 "show zebra client summary",
1044 SHOW_STR
41e7fb80 1045 ZEBRA_STR
b9ee4999
DS
1046 "Client information brief\n"
1047 "Brief Summary\n")
04b02fda 1048{
d62a17ae 1049 struct listnode *node;
1050 struct zserv *client;
04b02fda 1051
d62a17ae 1052 vty_out(vty,
1053 "Name Connect Time Last Read Last Write IPv4 Routes IPv6 Routes \n");
1054 vty_out(vty,
1055 "--------------------------------------------------------------------------------\n");
04b02fda 1056
161e9ab7 1057 for (ALL_LIST_ELEMENTS_RO(zrouter.client_list, node, client))
d62a17ae 1058 zebra_show_client_brief(vty, client);
fb018d25 1059
d62a17ae 1060 vty_out(vty, "Routes column shows (added+updated)/deleted\n");
1061 return CMD_SUCCESS;
718e3744 1062}
1063
411314ed
DS
1064#if defined(HANDLE_ZAPI_FUZZING)
1065void zserv_read_file(char *input)
1066{
1067 int fd;
411314ed
DS
1068 struct thread t;
1069
996c9314 1070 fd = open(input, O_RDONLY | O_NONBLOCK);
411314ed
DS
1071 t.u.fd = fd;
1072
2875801f 1073 zserv_client_create(fd);
411314ed
DS
1074}
1075#endif
1076
5f145fb8 1077void zserv_init(void)
718e3744 1078{
d62a17ae 1079 /* Client list init. */
161e9ab7 1080 zrouter.client_list = list_new();
21ccc0cf
QY
1081
1082 /* Misc init. */
cc3d8834 1083 zsock = -1;
718e3744 1084
d62a17ae 1085 install_element(ENABLE_NODE, &show_zebra_client_cmd);
1086 install_element(ENABLE_NODE, &show_zebra_client_summary_cmd);
718e3744 1087}