2 * Copyright (C) 2011 - Julien Desfossez <julien.desfossez@polymtl.ca>
3 * Mathieu Desnoyers <mathieu.desnoyers@efficios.com>
5 * This program is free software; you can redistribute it and/or
6 * modify it under the terms of the GNU General Public License
7 * as published by the Free Software Foundation; only version 2
10 * This program is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 * GNU General Public License for more details.
15 * You should have received a copy of the GNU General Public License
16 * along with this program; if not, write to the Free Software
17 * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
21 #include <lttng/ust-ctl.h>
22 #include <lttng/ust-abi.h>
23 #include <lttng/ust-events.h>
26 #include <usterr-signal-safe.h>
29 #include "../libringbuffer/backend.h"
30 #include "../libringbuffer/frontend.h"
32 volatile enum ust_loglevel ust_loglevel
;
35 void init_object(struct lttng_ust_object_data
*data
)
40 data
->memory_map_size
= 0;
43 int ustctl_release_handle(int sock
, int handle
)
45 struct ustcomm_ust_msg lum
;
46 struct ustcomm_ust_reply lur
;
50 memset(&lum
, 0, sizeof(lum
));
52 lum
.cmd
= LTTNG_UST_RELEASE
;
53 ret
= ustcomm_send_app_cmd(sock
, &lum
, &lur
);
61 * If sock is negative, it means we don't have to notify the other side
62 * (e.g. application has already vanished).
64 int ustctl_release_object(int sock
, struct lttng_ust_object_data
*data
)
68 if (data
->shm_fd
>= 0) {
69 ret
= close(data
->shm_fd
);
74 if (data
->wait_fd
>= 0) {
75 ret
= close(data
->wait_fd
);
80 return ustctl_release_handle(sock
, data
->handle
);
84 * Send registration done packet to the application.
86 int ustctl_register_done(int sock
)
88 struct ustcomm_ust_msg lum
;
89 struct ustcomm_ust_reply lur
;
92 DBG("Sending register done command to %d", sock
);
93 memset(&lum
, 0, sizeof(lum
));
94 lum
.handle
= LTTNG_UST_ROOT_HANDLE
;
95 lum
.cmd
= LTTNG_UST_REGISTER_DONE
;
96 ret
= ustcomm_send_app_cmd(sock
, &lum
, &lur
);
99 if (lur
.ret_code
!= USTCOMM_OK
) {
100 DBG("Return code: %s", ustcomm_get_readable_code(lur
.ret_code
));
110 * returns session handle.
112 int ustctl_create_session(int sock
)
114 struct ustcomm_ust_msg lum
;
115 struct ustcomm_ust_reply lur
;
116 int ret
, session_handle
;
119 memset(&lum
, 0, sizeof(lum
));
120 lum
.handle
= LTTNG_UST_ROOT_HANDLE
;
121 lum
.cmd
= LTTNG_UST_SESSION
;
122 ret
= ustcomm_send_app_cmd(sock
, &lum
, &lur
);
125 session_handle
= lur
.ret_val
;
126 DBG("received session handle %u", session_handle
);
127 return session_handle
;
130 /* open the metadata global channel */
131 int ustctl_open_metadata(int sock
, int session_handle
,
132 struct lttng_ust_channel_attr
*chops
,
133 struct lttng_ust_object_data
**_metadata_data
)
135 struct ustcomm_ust_msg lum
;
136 struct ustcomm_ust_reply lur
;
137 struct lttng_ust_object_data
*metadata_data
;
140 metadata_data
= malloc(sizeof(*metadata_data
));
143 init_object(metadata_data
);
144 /* Create metadata channel */
145 memset(&lum
, 0, sizeof(lum
));
146 lum
.handle
= session_handle
;
147 lum
.cmd
= LTTNG_UST_METADATA
;
148 lum
.u
.channel
.overwrite
= chops
->overwrite
;
149 lum
.u
.channel
.subbuf_size
= chops
->subbuf_size
;
150 lum
.u
.channel
.num_subbuf
= chops
->num_subbuf
;
151 lum
.u
.channel
.switch_timer_interval
= chops
->switch_timer_interval
;
152 lum
.u
.channel
.read_timer_interval
= chops
->read_timer_interval
;
153 lum
.u
.channel
.output
= chops
->output
;
154 ret
= ustcomm_send_app_cmd(sock
, &lum
, &lur
);
159 if (lur
.ret_code
!= USTCOMM_OK
) {
163 metadata_data
->handle
= lur
.ret_val
;
164 DBG("received metadata handle %u", metadata_data
->handle
);
165 metadata_data
->memory_map_size
= lur
.u
.channel
.memory_map_size
;
167 ret
= ustcomm_recv_fd(sock
);
171 metadata_data
->shm_fd
= ret
;
173 * We need to get the second FD even if the first fails, because
174 * libust expects us to read the two FDs.
177 ret
= ustcomm_recv_fd(sock
);
181 metadata_data
->wait_fd
= ret
;
184 *_metadata_data
= metadata_data
;
188 (void) ustctl_release_object(sock
, metadata_data
);
193 int ustctl_create_channel(int sock
, int session_handle
,
194 struct lttng_ust_channel_attr
*chops
,
195 struct lttng_ust_object_data
**_channel_data
)
197 struct ustcomm_ust_msg lum
;
198 struct ustcomm_ust_reply lur
;
199 struct lttng_ust_object_data
*channel_data
;
202 channel_data
= malloc(sizeof(*channel_data
));
205 init_object(channel_data
);
206 /* Create metadata channel */
207 memset(&lum
, 0, sizeof(lum
));
208 lum
.handle
= session_handle
;
209 lum
.cmd
= LTTNG_UST_CHANNEL
;
210 lum
.u
.channel
.overwrite
= chops
->overwrite
;
211 lum
.u
.channel
.subbuf_size
= chops
->subbuf_size
;
212 lum
.u
.channel
.num_subbuf
= chops
->num_subbuf
;
213 lum
.u
.channel
.switch_timer_interval
= chops
->switch_timer_interval
;
214 lum
.u
.channel
.read_timer_interval
= chops
->read_timer_interval
;
215 lum
.u
.channel
.output
= chops
->output
;
216 ret
= ustcomm_send_app_cmd(sock
, &lum
, &lur
);
221 if (lur
.ret_code
!= USTCOMM_OK
) {
225 channel_data
->handle
= lur
.ret_val
;
226 DBG("received channel handle %u", channel_data
->handle
);
227 channel_data
->memory_map_size
= lur
.u
.channel
.memory_map_size
;
229 ret
= ustcomm_recv_fd(sock
);
233 channel_data
->shm_fd
= ret
;
235 * We need to get the second FD even if the first fails, because
236 * libust expects us to read the two FDs.
239 ret
= ustcomm_recv_fd(sock
);
243 channel_data
->wait_fd
= ret
;
246 *_channel_data
= channel_data
;
250 (void) ustctl_release_object(sock
, channel_data
);
256 * Return -ENOENT if no more stream is available for creation.
257 * Return 0 on success.
258 * Return negative error value on error.
260 int ustctl_create_stream(int sock
, struct lttng_ust_object_data
*channel_data
,
261 struct lttng_ust_object_data
**_stream_data
)
263 struct ustcomm_ust_msg lum
;
264 struct ustcomm_ust_reply lur
;
265 struct lttng_ust_object_data
*stream_data
;
266 int ret
, fd
, err
= 0;
268 stream_data
= malloc(sizeof(*stream_data
));
271 init_object(stream_data
);
272 memset(&lum
, 0, sizeof(lum
));
273 lum
.handle
= channel_data
->handle
;
274 lum
.cmd
= LTTNG_UST_STREAM
;
275 ret
= ustcomm_send_app_cmd(sock
, &lum
, &lur
);
280 if (lur
.ret_code
!= USTCOMM_OK
) {
285 stream_data
->handle
= lur
.ret_val
;
286 DBG("received stream handle %u", stream_data
->handle
);
287 stream_data
->memory_map_size
= lur
.u
.stream
.memory_map_size
;
289 fd
= ustcomm_recv_fd(sock
);
293 stream_data
->shm_fd
= fd
;
295 * We need to get the second FD even if the first fails, because
296 * libust expects us to read the two FDs.
299 fd
= ustcomm_recv_fd(sock
);
303 stream_data
->wait_fd
= fd
;
306 *_stream_data
= stream_data
;
310 (void) ustctl_release_object(sock
, stream_data
);
315 int ustctl_create_event(int sock
, struct lttng_ust_event
*ev
,
316 struct lttng_ust_object_data
*channel_data
,
317 struct lttng_ust_object_data
**_event_data
)
319 struct ustcomm_ust_msg lum
;
320 struct ustcomm_ust_reply lur
;
321 struct lttng_ust_object_data
*event_data
;
324 event_data
= malloc(sizeof(*event_data
));
327 init_object(event_data
);
328 memset(&lum
, 0, sizeof(lum
));
329 lum
.handle
= channel_data
->handle
;
330 lum
.cmd
= LTTNG_UST_EVENT
;
331 strncpy(lum
.u
.event
.name
, ev
->name
,
332 LTTNG_UST_SYM_NAME_LEN
);
333 lum
.u
.event
.instrumentation
= ev
->instrumentation
;
334 lum
.u
.event
.loglevel_type
= ev
->loglevel_type
;
335 lum
.u
.event
.loglevel
= ev
->loglevel
;
336 ret
= ustcomm_send_app_cmd(sock
, &lum
, &lur
);
341 event_data
->handle
= lur
.ret_val
;
342 DBG("received event handle %u", event_data
->handle
);
343 *_event_data
= event_data
;
347 int ustctl_add_context(int sock
, struct lttng_ust_context
*ctx
,
348 struct lttng_ust_object_data
*obj_data
,
349 struct lttng_ust_object_data
**_context_data
)
351 struct ustcomm_ust_msg lum
;
352 struct ustcomm_ust_reply lur
;
353 struct lttng_ust_object_data
*context_data
;
356 context_data
= malloc(sizeof(*context_data
));
359 init_object(context_data
);
360 memset(&lum
, 0, sizeof(lum
));
361 lum
.handle
= obj_data
->handle
;
362 lum
.cmd
= LTTNG_UST_CONTEXT
;
363 lum
.u
.context
.ctx
= ctx
->ctx
;
364 ret
= ustcomm_send_app_cmd(sock
, &lum
, &lur
);
369 context_data
->handle
= lur
.ret_val
;
370 DBG("received context handle %u", context_data
->handle
);
371 *_context_data
= context_data
;
375 /* Enable event, channel and session ioctl */
376 int ustctl_enable(int sock
, struct lttng_ust_object_data
*object
)
378 struct ustcomm_ust_msg lum
;
379 struct ustcomm_ust_reply lur
;
382 memset(&lum
, 0, sizeof(lum
));
383 lum
.handle
= object
->handle
;
384 lum
.cmd
= LTTNG_UST_ENABLE
;
385 ret
= ustcomm_send_app_cmd(sock
, &lum
, &lur
);
388 DBG("enabled handle %u", object
->handle
);
392 /* Disable event, channel and session ioctl */
393 int ustctl_disable(int sock
, struct lttng_ust_object_data
*object
)
395 struct ustcomm_ust_msg lum
;
396 struct ustcomm_ust_reply lur
;
399 memset(&lum
, 0, sizeof(lum
));
400 lum
.handle
= object
->handle
;
401 lum
.cmd
= LTTNG_UST_DISABLE
;
402 ret
= ustcomm_send_app_cmd(sock
, &lum
, &lur
);
405 DBG("disable handle %u", object
->handle
);
409 int ustctl_start_session(int sock
, int handle
)
411 struct lttng_ust_object_data obj
;
414 return ustctl_enable(sock
, &obj
);
417 int ustctl_stop_session(int sock
, int handle
)
419 struct lttng_ust_object_data obj
;
422 return ustctl_disable(sock
, &obj
);
425 int ustctl_tracepoint_list(int sock
)
427 struct ustcomm_ust_msg lum
;
428 struct ustcomm_ust_reply lur
;
429 int ret
, tp_list_handle
;
431 memset(&lum
, 0, sizeof(lum
));
432 lum
.handle
= LTTNG_UST_ROOT_HANDLE
;
433 lum
.cmd
= LTTNG_UST_TRACEPOINT_LIST
;
434 ret
= ustcomm_send_app_cmd(sock
, &lum
, &lur
);
437 tp_list_handle
= lur
.ret_val
;
438 DBG("received tracepoint list handle %u", tp_list_handle
);
439 return tp_list_handle
;
442 int ustctl_tracepoint_list_get(int sock
, int tp_list_handle
,
443 struct lttng_ust_tracepoint_iter
*iter
)
445 struct ustcomm_ust_msg lum
;
446 struct ustcomm_ust_reply lur
;
449 memset(&lum
, 0, sizeof(lum
));
450 lum
.handle
= tp_list_handle
;
451 lum
.cmd
= LTTNG_UST_TRACEPOINT_LIST_GET
;
452 ret
= ustcomm_send_app_cmd(sock
, &lum
, &lur
);
455 DBG("received tracepoint list entry name %s loglevel %d",
456 lur
.u
.tracepoint
.name
,
457 lur
.u
.tracepoint
.loglevel
);
458 memcpy(iter
, &lur
.u
.tracepoint
, sizeof(*iter
));
462 int ustctl_tracer_version(int sock
, struct lttng_ust_tracer_version
*v
)
464 struct ustcomm_ust_msg lum
;
465 struct ustcomm_ust_reply lur
;
468 memset(&lum
, 0, sizeof(lum
));
469 lum
.handle
= LTTNG_UST_ROOT_HANDLE
;
470 lum
.cmd
= LTTNG_UST_TRACER_VERSION
;
471 ret
= ustcomm_send_app_cmd(sock
, &lum
, &lur
);
474 memcpy(v
, &lur
.u
.version
, sizeof(*v
));
475 DBG("received tracer version");
479 int ustctl_wait_quiescent(int sock
)
481 struct ustcomm_ust_msg lum
;
482 struct ustcomm_ust_reply lur
;
485 memset(&lum
, 0, sizeof(lum
));
486 lum
.handle
= LTTNG_UST_ROOT_HANDLE
;
487 lum
.cmd
= LTTNG_UST_WAIT_QUIESCENT
;
488 ret
= ustcomm_send_app_cmd(sock
, &lum
, &lur
);
491 DBG("waited for quiescent state");
495 int ustctl_calibrate(int sock
, struct lttng_ust_calibrate
*calibrate
)
500 int ustctl_sock_flush_buffer(int sock
, struct lttng_ust_object_data
*object
)
502 struct ustcomm_ust_msg lum
;
503 struct ustcomm_ust_reply lur
;
506 memset(&lum
, 0, sizeof(lum
));
507 lum
.handle
= object
->handle
;
508 lum
.cmd
= LTTNG_UST_FLUSH_BUFFER
;
509 ret
= ustcomm_send_app_cmd(sock
, &lum
, &lur
);
512 DBG("flushed buffer handle %u", object
->handle
);
516 /* Buffer operations */
518 /* Map channel shm into process memory */
519 struct lttng_ust_shm_handle
*ustctl_map_channel(struct lttng_ust_object_data
*chan_data
)
521 struct lttng_ust_shm_handle
*handle
;
522 struct channel
*chan
;
524 struct lttng_ust_lib_ring_buffer_config
*config
;
527 handle
= channel_handle_create(chan_data
->shm_fd
,
529 chan_data
->memory_map_size
);
531 ERR("create handle error");
535 * Set to -1, and then close the shm fd, and set the handle shm
536 * fd to -1 too. We don't need the shm fds after they have been
538 * The wait_fd is set to -1 in chan_data because it is now owned
541 chan_data
->shm_fd
= -1;
542 chan_data
->wait_fd
= -1;
544 /* chan is object 0. This is hardcoded. */
545 if (handle
->table
->objects
[0].shm_fd
>= 0) {
546 ret
= close(handle
->table
->objects
[0].shm_fd
);
548 perror("Error closing shm_fd");
550 handle
->table
->objects
[0].shm_fd
= -1;
554 * TODO: add consistency checks to be resilient if the
555 * application try to feed us with incoherent channel structure
558 chan
= shmp(handle
, handle
->chan
);
559 /* chan is object 0. This is hardcoded. */
560 chan_size
= handle
->table
->objects
[0].allocated_len
;
561 handle
->shadow_chan
= malloc(chan_size
);
562 if (!handle
->shadow_chan
) {
563 channel_destroy(chan
, handle
, 1);
566 memcpy(handle
->shadow_chan
, chan
, chan_size
);
568 * The callback pointers in the producer are invalid in the
569 * consumer. We need to look them up here.
571 config
= &handle
->shadow_chan
->backend
.config
;
572 switch (config
->client_type
) {
573 case LTTNG_CLIENT_METADATA
:
574 memcpy(&config
->cb
, lttng_client_callbacks_metadata
,
577 case LTTNG_CLIENT_DISCARD
:
578 memcpy(&config
->cb
, lttng_client_callbacks_discard
,
581 case LTTNG_CLIENT_OVERWRITE
:
582 memcpy(&config
->cb
, lttng_client_callbacks_overwrite
,
586 ERR("Unknown client type %d", config
->client_type
);
587 channel_destroy(chan
, handle
, 1);
590 /* Replace the object table pointer. */
591 ret
= munmap(handle
->table
->objects
[0].memory_map
,
592 handle
->table
->objects
[0].memory_map_size
);
597 handle
->table
->objects
[0].memory_map
= (char *) handle
->shadow_chan
;
598 handle
->table
->objects
[0].is_shadow
= 1;
602 /* Add stream to channel shm and map its shm into process memory */
603 int ustctl_add_stream(struct lttng_ust_shm_handle
*handle
,
604 struct lttng_ust_object_data
*stream_data
)
608 if (!stream_data
->handle
)
611 ret
= channel_handle_add_stream(handle
,
613 stream_data
->wait_fd
,
614 stream_data
->memory_map_size
);
616 ERR("add stream error\n");
620 * Set to -1 because the lttng_ust_shm_handle destruction will take care
621 * of closing shm_fd and wait_fd.
623 stream_data
->shm_fd
= -1;
624 stream_data
->wait_fd
= -1;
628 void ustctl_unmap_channel(struct lttng_ust_shm_handle
*handle
)
630 struct channel
*chan
;
632 chan
= shmp(handle
, handle
->chan
);
633 channel_destroy(chan
, handle
, 1);
637 * ustctl closes the shm_fd fds after mapping it.
639 struct lttng_ust_lib_ring_buffer
*ustctl_open_stream_read(struct lttng_ust_shm_handle
*handle
,
642 struct channel
*chan
= handle
->shadow_chan
;
643 int *shm_fd
, *wait_fd
;
644 uint64_t *memory_map_size
;
645 struct lttng_ust_lib_ring_buffer
*buf
;
648 buf
= channel_get_ring_buffer(&chan
->backend
.config
,
649 chan
, cpu
, handle
, &shm_fd
, &wait_fd
, &memory_map_size
);
652 ret
= lib_ring_buffer_open_read(buf
, handle
, 1);
656 * We can close shm_fd early, right after is has been mapped.
659 ret
= close(*shm_fd
);
661 perror("Error closing shm_fd");
668 void ustctl_close_stream_read(struct lttng_ust_shm_handle
*handle
,
669 struct lttng_ust_lib_ring_buffer
*buf
)
671 lib_ring_buffer_release_read(buf
, handle
, 1);
674 /* For mmap mode, readable without "get" operation */
676 void *ustctl_get_mmap_base(struct lttng_ust_shm_handle
*handle
,
677 struct lttng_ust_lib_ring_buffer
*buf
)
679 return shmp(handle
, buf
->backend
.memory_map
);
682 /* returns the length to mmap. */
683 int ustctl_get_mmap_len(struct lttng_ust_shm_handle
*handle
,
684 struct lttng_ust_lib_ring_buffer
*buf
,
687 unsigned long mmap_buf_len
;
688 struct channel
*chan
= handle
->shadow_chan
;
690 if (chan
->backend
.config
.output
!= RING_BUFFER_MMAP
)
692 mmap_buf_len
= chan
->backend
.buf_size
;
693 if (chan
->backend
.extra_reader_sb
)
694 mmap_buf_len
+= chan
->backend
.subbuf_size
;
695 if (mmap_buf_len
> INT_MAX
)
701 /* returns the maximum size for sub-buffers. */
702 int ustctl_get_max_subbuf_size(struct lttng_ust_shm_handle
*handle
,
703 struct lttng_ust_lib_ring_buffer
*buf
,
706 struct channel
*chan
= handle
->shadow_chan
;
708 *len
= chan
->backend
.subbuf_size
;
713 * For mmap mode, operate on the current packet (between get/put or
714 * get_next/put_next).
717 /* returns the offset of the subbuffer belonging to the mmap reader. */
718 int ustctl_get_mmap_read_offset(struct lttng_ust_shm_handle
*handle
,
719 struct lttng_ust_lib_ring_buffer
*buf
, unsigned long *off
)
721 struct channel
*chan
= handle
->shadow_chan
;
722 unsigned long sb_bindex
;
724 if (chan
->backend
.config
.output
!= RING_BUFFER_MMAP
)
726 sb_bindex
= subbuffer_id_get_index(&chan
->backend
.config
,
727 buf
->backend
.buf_rsb
.id
);
728 *off
= shmp(handle
, shmp_index(handle
, buf
->backend
.array
, sb_bindex
)->shmp
)->mmap_offset
;
732 /* returns the size of the current sub-buffer, without padding (for mmap). */
733 int ustctl_get_subbuf_size(struct lttng_ust_shm_handle
*handle
,
734 struct lttng_ust_lib_ring_buffer
*buf
, unsigned long *len
)
736 struct channel
*chan
= handle
->shadow_chan
;
738 *len
= lib_ring_buffer_get_read_data_size(&chan
->backend
.config
, buf
,
743 /* returns the size of the current sub-buffer, without padding (for mmap). */
744 int ustctl_get_padded_subbuf_size(struct lttng_ust_shm_handle
*handle
,
745 struct lttng_ust_lib_ring_buffer
*buf
, unsigned long *len
)
747 struct channel
*chan
= handle
->shadow_chan
;
749 *len
= lib_ring_buffer_get_read_data_size(&chan
->backend
.config
, buf
,
751 *len
= PAGE_ALIGN(*len
);
755 /* Get exclusive read access to the next sub-buffer that can be read. */
756 int ustctl_get_next_subbuf(struct lttng_ust_shm_handle
*handle
,
757 struct lttng_ust_lib_ring_buffer
*buf
)
759 return lib_ring_buffer_get_next_subbuf(buf
, handle
);
763 /* Release exclusive sub-buffer access, move consumer forward. */
764 int ustctl_put_next_subbuf(struct lttng_ust_shm_handle
*handle
,
765 struct lttng_ust_lib_ring_buffer
*buf
)
767 lib_ring_buffer_put_next_subbuf(buf
, handle
);
773 /* Get a snapshot of the current ring buffer producer and consumer positions */
774 int ustctl_snapshot(struct lttng_ust_shm_handle
*handle
,
775 struct lttng_ust_lib_ring_buffer
*buf
)
777 return lib_ring_buffer_snapshot(buf
, &buf
->cons_snapshot
,
778 &buf
->prod_snapshot
, handle
);
781 /* Get the consumer position (iteration start) */
782 int ustctl_snapshot_get_consumed(struct lttng_ust_shm_handle
*handle
,
783 struct lttng_ust_lib_ring_buffer
*buf
, unsigned long *pos
)
785 *pos
= buf
->cons_snapshot
;
789 /* Get the producer position (iteration end) */
790 int ustctl_snapshot_get_produced(struct lttng_ust_shm_handle
*handle
,
791 struct lttng_ust_lib_ring_buffer
*buf
, unsigned long *pos
)
793 *pos
= buf
->prod_snapshot
;
797 /* Get exclusive read access to the specified sub-buffer position */
798 int ustctl_get_subbuf(struct lttng_ust_shm_handle
*handle
,
799 struct lttng_ust_lib_ring_buffer
*buf
, unsigned long *pos
)
801 return lib_ring_buffer_get_subbuf(buf
, *pos
, handle
);
804 /* Release exclusive sub-buffer access */
805 int ustctl_put_subbuf(struct lttng_ust_shm_handle
*handle
,
806 struct lttng_ust_lib_ring_buffer
*buf
)
808 lib_ring_buffer_put_subbuf(buf
, handle
);
812 void ustctl_flush_buffer(struct lttng_ust_shm_handle
*handle
,
813 struct lttng_ust_lib_ring_buffer
*buf
,
816 lib_ring_buffer_switch_slow(buf
,
817 producer_active
? SWITCH_ACTIVE
: SWITCH_FLUSH
,