2 * Copyright (C) 2012 - David Goulet <dgoulet@efficios.com>
4 * This program is free software; you can redistribute it and/or modify it
5 * under the terms of the GNU General Public License, version 2 only, as
6 * published by the Free Software Foundation.
8 * This program is distributed in the hope that it will be useful, but WITHOUT
9 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
10 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
13 * You should have received a copy of the GNU General Public License along with
14 * this program; if not, write to the Free Software Foundation, Inc., 51
15 * Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
21 #include <urcu/list.h>
22 #include <urcu/uatomic.h>
24 #include <common/defaults.h>
25 #include <common/common.h>
26 #include <common/sessiond-comm/sessiond-comm.h>
27 #include <common/relayd/relayd.h>
28 #include <common/utils.h>
35 #include "kernel-consumer.h"
36 #include "lttng-sessiond.h"
42 * Used to keep a unique index for each relayd socket created where this value
43 * is associated with streams on the consumer so it can match the right relayd
44 * to send to. It must be accessed with the relayd_net_seq_idx_lock
47 static pthread_mutex_t relayd_net_seq_idx_lock
= PTHREAD_MUTEX_INITIALIZER
;
48 static uint64_t relayd_net_seq_idx
;
51 * Create a session path used by list_lttng_sessions for the case that the
52 * session consumer is on the network.
54 static int build_network_session_path(char *dst
, size_t size
,
55 struct ltt_session
*session
)
57 int ret
, kdata_port
, udata_port
;
58 struct lttng_uri
*kuri
= NULL
, *uuri
= NULL
, *uri
= NULL
;
59 char tmp_uurl
[PATH_MAX
], tmp_urls
[PATH_MAX
];
64 memset(tmp_urls
, 0, sizeof(tmp_urls
));
65 memset(tmp_uurl
, 0, sizeof(tmp_uurl
));
67 kdata_port
= udata_port
= DEFAULT_NETWORK_DATA_PORT
;
69 if (session
->kernel_session
&& session
->kernel_session
->consumer
) {
70 kuri
= &session
->kernel_session
->consumer
->dst
.net
.control
;
71 kdata_port
= session
->kernel_session
->consumer
->dst
.net
.data
.port
;
74 if (session
->ust_session
&& session
->ust_session
->consumer
) {
75 uuri
= &session
->ust_session
->consumer
->dst
.net
.control
;
76 udata_port
= session
->ust_session
->consumer
->dst
.net
.data
.port
;
79 if (uuri
== NULL
&& kuri
== NULL
) {
80 uri
= &session
->consumer
->dst
.net
.control
;
81 kdata_port
= session
->consumer
->dst
.net
.data
.port
;
82 } else if (kuri
&& uuri
) {
83 ret
= uri_compare(kuri
, uuri
);
87 /* Build uuri URL string */
88 ret
= uri_to_str_url(uuri
, tmp_uurl
, sizeof(tmp_uurl
));
95 } else if (kuri
&& uuri
== NULL
) {
97 } else if (uuri
&& kuri
== NULL
) {
101 ret
= uri_to_str_url(uri
, tmp_urls
, sizeof(tmp_urls
));
107 * Do we have a UST url set. If yes, this means we have both kernel and UST
110 if (*tmp_uurl
!= '\0') {
111 ret
= snprintf(dst
, size
, "[K]: %s [data: %d] -- [U]: %s [data: %d]",
112 tmp_urls
, kdata_port
, tmp_uurl
, udata_port
);
115 if (kuri
|| (!kuri
&& !uuri
)) {
118 /* No kernel URI, use the UST port. */
121 ret
= snprintf(dst
, size
, "%s [data: %d]", tmp_urls
, dport
);
129 * Fill lttng_channel array of all channels.
131 static void list_lttng_channels(int domain
, struct ltt_session
*session
,
132 struct lttng_channel
*channels
)
135 struct ltt_kernel_channel
*kchan
;
137 DBG("Listing channels for session %s", session
->name
);
140 case LTTNG_DOMAIN_KERNEL
:
141 /* Kernel channels */
142 if (session
->kernel_session
!= NULL
) {
143 cds_list_for_each_entry(kchan
,
144 &session
->kernel_session
->channel_list
.head
, list
) {
145 /* Copy lttng_channel struct to array */
146 memcpy(&channels
[i
], kchan
->channel
, sizeof(struct lttng_channel
));
147 channels
[i
].enabled
= kchan
->enabled
;
152 case LTTNG_DOMAIN_UST
:
154 struct lttng_ht_iter iter
;
155 struct ltt_ust_channel
*uchan
;
158 cds_lfht_for_each_entry(session
->ust_session
->domain_global
.channels
->ht
,
159 &iter
.iter
, uchan
, node
.node
) {
160 strncpy(channels
[i
].name
, uchan
->name
, LTTNG_SYMBOL_NAME_LEN
);
161 channels
[i
].attr
.overwrite
= uchan
->attr
.overwrite
;
162 channels
[i
].attr
.subbuf_size
= uchan
->attr
.subbuf_size
;
163 channels
[i
].attr
.num_subbuf
= uchan
->attr
.num_subbuf
;
164 channels
[i
].attr
.switch_timer_interval
=
165 uchan
->attr
.switch_timer_interval
;
166 channels
[i
].attr
.read_timer_interval
=
167 uchan
->attr
.read_timer_interval
;
168 channels
[i
].enabled
= uchan
->enabled
;
169 switch (uchan
->attr
.output
) {
172 channels
[i
].attr
.output
= LTTNG_EVENT_MMAP
;
186 * Create a list of ust global domain events.
188 static int list_lttng_ust_global_events(char *channel_name
,
189 struct ltt_ust_domain_global
*ust_global
, struct lttng_event
**events
)
192 unsigned int nb_event
= 0;
193 struct lttng_ht_iter iter
;
194 struct lttng_ht_node_str
*node
;
195 struct ltt_ust_channel
*uchan
;
196 struct ltt_ust_event
*uevent
;
197 struct lttng_event
*tmp
;
199 DBG("Listing UST global events for channel %s", channel_name
);
203 lttng_ht_lookup(ust_global
->channels
, (void *)channel_name
, &iter
);
204 node
= lttng_ht_iter_get_node_str(&iter
);
206 ret
= LTTNG_ERR_UST_CHAN_NOT_FOUND
;
210 uchan
= caa_container_of(&node
->node
, struct ltt_ust_channel
, node
.node
);
212 nb_event
+= lttng_ht_get_count(uchan
->events
);
219 DBG3("Listing UST global %d events", nb_event
);
221 tmp
= zmalloc(nb_event
* sizeof(struct lttng_event
));
223 ret
= LTTNG_ERR_FATAL
;
227 cds_lfht_for_each_entry(uchan
->events
->ht
, &iter
.iter
, uevent
, node
.node
) {
228 strncpy(tmp
[i
].name
, uevent
->attr
.name
, LTTNG_SYMBOL_NAME_LEN
);
229 tmp
[i
].name
[LTTNG_SYMBOL_NAME_LEN
- 1] = '\0';
230 tmp
[i
].enabled
= uevent
->enabled
;
232 switch (uevent
->attr
.instrumentation
) {
233 case LTTNG_UST_TRACEPOINT
:
234 tmp
[i
].type
= LTTNG_EVENT_TRACEPOINT
;
236 case LTTNG_UST_PROBE
:
237 tmp
[i
].type
= LTTNG_EVENT_PROBE
;
239 case LTTNG_UST_FUNCTION
:
240 tmp
[i
].type
= LTTNG_EVENT_FUNCTION
;
244 tmp
[i
].loglevel
= uevent
->attr
.loglevel
;
245 switch (uevent
->attr
.loglevel_type
) {
246 case LTTNG_UST_LOGLEVEL_ALL
:
247 tmp
[i
].loglevel_type
= LTTNG_EVENT_LOGLEVEL_ALL
;
249 case LTTNG_UST_LOGLEVEL_RANGE
:
250 tmp
[i
].loglevel_type
= LTTNG_EVENT_LOGLEVEL_RANGE
;
252 case LTTNG_UST_LOGLEVEL_SINGLE
:
253 tmp
[i
].loglevel_type
= LTTNG_EVENT_LOGLEVEL_SINGLE
;
256 if (uevent
->filter
) {
271 * Fill lttng_event array of all kernel events in the channel.
273 static int list_lttng_kernel_events(char *channel_name
,
274 struct ltt_kernel_session
*kernel_session
, struct lttng_event
**events
)
277 unsigned int nb_event
;
278 struct ltt_kernel_event
*event
;
279 struct ltt_kernel_channel
*kchan
;
281 kchan
= trace_kernel_get_channel_by_name(channel_name
, kernel_session
);
283 ret
= LTTNG_ERR_KERN_CHAN_NOT_FOUND
;
287 nb_event
= kchan
->event_count
;
289 DBG("Listing events for channel %s", kchan
->channel
->name
);
295 *events
= zmalloc(nb_event
* sizeof(struct lttng_event
));
296 if (*events
== NULL
) {
297 ret
= LTTNG_ERR_FATAL
;
301 /* Kernel channels */
302 cds_list_for_each_entry(event
, &kchan
->events_list
.head
, list
) {
303 strncpy((*events
)[i
].name
, event
->event
->name
, LTTNG_SYMBOL_NAME_LEN
);
304 (*events
)[i
].name
[LTTNG_SYMBOL_NAME_LEN
- 1] = '\0';
305 (*events
)[i
].enabled
= event
->enabled
;
307 switch (event
->event
->instrumentation
) {
308 case LTTNG_KERNEL_TRACEPOINT
:
309 (*events
)[i
].type
= LTTNG_EVENT_TRACEPOINT
;
311 case LTTNG_KERNEL_KRETPROBE
:
312 (*events
)[i
].type
= LTTNG_EVENT_FUNCTION
;
313 memcpy(&(*events
)[i
].attr
.probe
, &event
->event
->u
.kprobe
,
314 sizeof(struct lttng_kernel_kprobe
));
316 case LTTNG_KERNEL_KPROBE
:
317 (*events
)[i
].type
= LTTNG_EVENT_PROBE
;
318 memcpy(&(*events
)[i
].attr
.probe
, &event
->event
->u
.kprobe
,
319 sizeof(struct lttng_kernel_kprobe
));
321 case LTTNG_KERNEL_FUNCTION
:
322 (*events
)[i
].type
= LTTNG_EVENT_FUNCTION
;
323 memcpy(&((*events
)[i
].attr
.ftrace
), &event
->event
->u
.ftrace
,
324 sizeof(struct lttng_kernel_function
));
326 case LTTNG_KERNEL_NOOP
:
327 (*events
)[i
].type
= LTTNG_EVENT_NOOP
;
329 case LTTNG_KERNEL_SYSCALL
:
330 (*events
)[i
].type
= LTTNG_EVENT_SYSCALL
;
332 case LTTNG_KERNEL_ALL
:
343 /* Negate the error code to differentiate the size from an error */
348 * Add URI so the consumer output object. Set the correct path depending on the
349 * domain adding the default trace directory.
351 static int add_uri_to_consumer(struct consumer_output
*consumer
,
352 struct lttng_uri
*uri
, int domain
, const char *session_name
)
355 const char *default_trace_dir
;
359 if (consumer
== NULL
) {
360 DBG("No consumer detected. Don't add URI. Stopping.");
361 ret
= LTTNG_ERR_NO_CONSUMER
;
366 case LTTNG_DOMAIN_KERNEL
:
367 default_trace_dir
= DEFAULT_KERNEL_TRACE_DIR
;
369 case LTTNG_DOMAIN_UST
:
370 default_trace_dir
= DEFAULT_UST_TRACE_DIR
;
374 * This case is possible is we try to add the URI to the global tracing
375 * session consumer object which in this case there is no subdir.
377 default_trace_dir
= "";
380 switch (uri
->dtype
) {
383 DBG2("Setting network URI to consumer");
385 if (consumer
->type
== CONSUMER_DST_NET
) {
386 if ((uri
->stype
== LTTNG_STREAM_CONTROL
&&
387 consumer
->dst
.net
.control_isset
) ||
388 (uri
->stype
== LTTNG_STREAM_DATA
&&
389 consumer
->dst
.net
.data_isset
)) {
390 ret
= LTTNG_ERR_URL_EXIST
;
394 memset(&consumer
->dst
.net
, 0, sizeof(consumer
->dst
.net
));
397 consumer
->type
= CONSUMER_DST_NET
;
399 /* Set URI into consumer output object */
400 ret
= consumer_set_network_uri(consumer
, uri
);
404 } else if (ret
== 1) {
406 * URI was the same in the consumer so we do not append the subdir
407 * again so to not duplicate output dir.
412 if (uri
->stype
== LTTNG_STREAM_CONTROL
&& strlen(uri
->subdir
) == 0) {
413 ret
= consumer_set_subdir(consumer
, session_name
);
415 ret
= LTTNG_ERR_FATAL
;
420 if (uri
->stype
== LTTNG_STREAM_CONTROL
) {
421 /* On a new subdir, reappend the default trace dir. */
422 strncat(consumer
->subdir
, default_trace_dir
,
423 sizeof(consumer
->subdir
) - strlen(consumer
->subdir
) - 1);
424 DBG3("Append domain trace name to subdir %s", consumer
->subdir
);
429 DBG2("Setting trace directory path from URI to %s", uri
->dst
.path
);
430 memset(consumer
->dst
.trace_path
, 0,
431 sizeof(consumer
->dst
.trace_path
));
432 strncpy(consumer
->dst
.trace_path
, uri
->dst
.path
,
433 sizeof(consumer
->dst
.trace_path
));
434 /* Append default trace dir */
435 strncat(consumer
->dst
.trace_path
, default_trace_dir
,
436 sizeof(consumer
->dst
.trace_path
) -
437 strlen(consumer
->dst
.trace_path
) - 1);
438 /* Flag consumer as local. */
439 consumer
->type
= CONSUMER_DST_LOCAL
;
450 * Init tracing by creating trace directory and sending fds kernel consumer.
452 static int init_kernel_tracing(struct ltt_kernel_session
*session
)
455 struct lttng_ht_iter iter
;
456 struct consumer_socket
*socket
;
462 if (session
->consumer_fds_sent
== 0 && session
->consumer
!= NULL
) {
463 cds_lfht_for_each_entry(session
->consumer
->socks
->ht
, &iter
.iter
,
465 /* Code flow error */
466 assert(socket
->fd
>= 0);
468 pthread_mutex_lock(socket
->lock
);
469 ret
= kernel_consumer_send_session(socket
, session
);
470 pthread_mutex_unlock(socket
->lock
);
472 ret
= LTTNG_ERR_KERN_CONSUMER_FAIL
;
484 * Create a socket to the relayd using the URI.
486 * On success, the relayd_sock pointer is set to the created socket.
487 * Else, it's stays untouched and a lttcomm error code is returned.
489 static int create_connect_relayd(struct lttng_uri
*uri
,
490 struct lttcomm_relayd_sock
**relayd_sock
)
493 struct lttcomm_relayd_sock
*rsock
;
495 rsock
= lttcomm_alloc_relayd_sock(uri
, RELAYD_VERSION_COMM_MAJOR
,
496 RELAYD_VERSION_COMM_MINOR
);
498 ret
= LTTNG_ERR_FATAL
;
503 * Connect to relayd so we can proceed with a session creation. This call
504 * can possibly block for an arbitrary amount of time to set the health
505 * state to be in poll execution.
508 ret
= relayd_connect(rsock
);
511 ERR("Unable to reach lttng-relayd");
512 ret
= LTTNG_ERR_RELAYD_CONNECT_FAIL
;
516 /* Create socket for control stream. */
517 if (uri
->stype
== LTTNG_STREAM_CONTROL
) {
518 DBG3("Creating relayd stream socket from URI");
520 /* Check relayd version */
521 ret
= relayd_version_check(rsock
);
523 ret
= LTTNG_ERR_RELAYD_VERSION_FAIL
;
526 } else if (uri
->stype
== LTTNG_STREAM_DATA
) {
527 DBG3("Creating relayd data socket from URI");
529 /* Command is not valid */
530 ERR("Relayd invalid stream type: %d", uri
->stype
);
531 ret
= LTTNG_ERR_INVALID
;
535 *relayd_sock
= rsock
;
540 /* The returned value is not useful since we are on an error path. */
541 (void) relayd_close(rsock
);
549 * Connect to the relayd using URI and send the socket to the right consumer.
551 static int send_consumer_relayd_socket(int domain
, unsigned int session_id
,
552 struct lttng_uri
*relayd_uri
, struct consumer_output
*consumer
,
553 struct consumer_socket
*consumer_sock
)
556 struct lttcomm_relayd_sock
*rsock
= NULL
;
558 /* Connect to relayd and make version check if uri is the control. */
559 ret
= create_connect_relayd(relayd_uri
, &rsock
);
560 if (ret
!= LTTNG_OK
) {
565 /* Set the network sequence index if not set. */
566 if (consumer
->net_seq_index
== (uint64_t) -1ULL) {
567 pthread_mutex_lock(&relayd_net_seq_idx_lock
);
569 * Increment net_seq_idx because we are about to transfer the
570 * new relayd socket to the consumer.
571 * Assign unique key so the consumer can match streams.
573 consumer
->net_seq_index
= ++relayd_net_seq_idx
;
574 pthread_mutex_unlock(&relayd_net_seq_idx_lock
);
577 /* Send relayd socket to consumer. */
578 ret
= consumer_send_relayd_socket(consumer_sock
, rsock
, consumer
,
579 relayd_uri
->stype
, session_id
);
581 ret
= LTTNG_ERR_ENABLE_CONSUMER_FAIL
;
585 /* Flag that the corresponding socket was sent. */
586 if (relayd_uri
->stype
== LTTNG_STREAM_CONTROL
) {
587 consumer_sock
->control_sock_sent
= 1;
588 } else if (relayd_uri
->stype
== LTTNG_STREAM_DATA
) {
589 consumer_sock
->data_sock_sent
= 1;
595 * Close socket which was dup on the consumer side. The session daemon does
596 * NOT keep track of the relayd socket(s) once transfer to the consumer.
600 (void) relayd_close(rsock
);
604 if (ret
!= LTTNG_OK
) {
606 * The consumer output for this session should not be used anymore
607 * since the relayd connection failed thus making any tracing or/and
608 * streaming not usable.
610 consumer
->enabled
= 0;
616 * Send both relayd sockets to a specific consumer and domain. This is a
617 * helper function to facilitate sending the information to the consumer for a
620 static int send_consumer_relayd_sockets(int domain
, unsigned int session_id
,
621 struct consumer_output
*consumer
, struct consumer_socket
*sock
)
628 /* Sending control relayd socket. */
629 if (!sock
->control_sock_sent
) {
630 ret
= send_consumer_relayd_socket(domain
, session_id
,
631 &consumer
->dst
.net
.control
, consumer
, sock
);
632 if (ret
!= LTTNG_OK
) {
637 /* Sending data relayd socket. */
638 if (!sock
->data_sock_sent
) {
639 ret
= send_consumer_relayd_socket(domain
, session_id
,
640 &consumer
->dst
.net
.data
, consumer
, sock
);
641 if (ret
!= LTTNG_OK
) {
651 * Setup relayd connections for a tracing session. First creates the socket to
652 * the relayd and send them to the right domain consumer. Consumer type MUST be
655 int cmd_setup_relayd(struct ltt_session
*session
)
658 struct ltt_ust_session
*usess
;
659 struct ltt_kernel_session
*ksess
;
660 struct consumer_socket
*socket
;
661 struct lttng_ht_iter iter
;
665 usess
= session
->ust_session
;
666 ksess
= session
->kernel_session
;
668 DBG("Setting relayd for session %s", session
->name
);
672 if (usess
&& usess
->consumer
&& usess
->consumer
->type
== CONSUMER_DST_NET
673 && usess
->consumer
->enabled
) {
674 /* For each consumer socket, send relayd sockets */
675 cds_lfht_for_each_entry(usess
->consumer
->socks
->ht
, &iter
.iter
,
677 /* Code flow error */
678 assert(socket
->fd
>= 0);
680 pthread_mutex_lock(socket
->lock
);
681 ret
= send_consumer_relayd_sockets(LTTNG_DOMAIN_UST
, session
->id
,
682 usess
->consumer
, socket
);
683 pthread_mutex_unlock(socket
->lock
);
684 if (ret
!= LTTNG_OK
) {
687 /* Session is now ready for network streaming. */
688 session
->net_handle
= 1;
692 if (ksess
&& ksess
->consumer
&& ksess
->consumer
->type
== CONSUMER_DST_NET
693 && ksess
->consumer
->enabled
) {
694 cds_lfht_for_each_entry(ksess
->consumer
->socks
->ht
, &iter
.iter
,
696 /* Code flow error */
697 assert(socket
->fd
>= 0);
699 pthread_mutex_lock(socket
->lock
);
700 ret
= send_consumer_relayd_sockets(LTTNG_DOMAIN_KERNEL
, session
->id
,
701 ksess
->consumer
, socket
);
702 pthread_mutex_unlock(socket
->lock
);
703 if (ret
!= LTTNG_OK
) {
706 /* Session is now ready for network streaming. */
707 session
->net_handle
= 1;
717 * Start a kernel session by opening all necessary streams.
719 static int start_kernel_session(struct ltt_kernel_session
*ksess
, int wpipe
)
722 struct ltt_kernel_channel
*kchan
;
724 /* Open kernel metadata */
725 if (ksess
->metadata
== NULL
&& ksess
->output_traces
) {
726 ret
= kernel_open_metadata(ksess
);
728 ret
= LTTNG_ERR_KERN_META_FAIL
;
733 /* Open kernel metadata stream */
734 if (ksess
->metadata
&& ksess
->metadata_stream_fd
< 0) {
735 ret
= kernel_open_metadata_stream(ksess
);
737 ERR("Kernel create metadata stream failed");
738 ret
= LTTNG_ERR_KERN_STREAM_FAIL
;
743 /* For each channel */
744 cds_list_for_each_entry(kchan
, &ksess
->channel_list
.head
, list
) {
745 if (kchan
->stream_count
== 0) {
746 ret
= kernel_open_channel_stream(kchan
);
748 ret
= LTTNG_ERR_KERN_STREAM_FAIL
;
751 /* Update the stream global counter */
752 ksess
->stream_count_global
+= ret
;
756 /* Setup kernel consumer socket and send fds to it */
757 ret
= init_kernel_tracing(ksess
);
759 ret
= LTTNG_ERR_KERN_START_FAIL
;
763 /* This start the kernel tracing */
764 ret
= kernel_start_session(ksess
);
766 ret
= LTTNG_ERR_KERN_START_FAIL
;
770 /* Quiescent wait after starting trace */
771 kernel_wait_quiescent(kernel_tracer_fd
);
782 * Command LTTNG_DISABLE_CHANNEL processed by the client thread.
784 int cmd_disable_channel(struct ltt_session
*session
, int domain
,
788 struct ltt_ust_session
*usess
;
790 usess
= session
->ust_session
;
795 case LTTNG_DOMAIN_KERNEL
:
797 ret
= channel_kernel_disable(session
->kernel_session
,
799 if (ret
!= LTTNG_OK
) {
803 kernel_wait_quiescent(kernel_tracer_fd
);
806 case LTTNG_DOMAIN_UST
:
808 struct ltt_ust_channel
*uchan
;
809 struct lttng_ht
*chan_ht
;
811 chan_ht
= usess
->domain_global
.channels
;
813 uchan
= trace_ust_find_channel_by_name(chan_ht
, channel_name
);
815 ret
= LTTNG_ERR_UST_CHAN_NOT_FOUND
;
819 ret
= channel_ust_disable(usess
, uchan
);
820 if (ret
!= LTTNG_OK
) {
826 case LTTNG_DOMAIN_UST_PID_FOLLOW_CHILDREN
:
827 case LTTNG_DOMAIN_UST_EXEC_NAME
:
828 case LTTNG_DOMAIN_UST_PID
:
831 ret
= LTTNG_ERR_UNKNOWN_DOMAIN
;
843 * Command LTTNG_ENABLE_CHANNEL processed by the client thread.
845 * The wpipe arguments is used as a notifier for the kernel thread.
847 int cmd_enable_channel(struct ltt_session
*session
,
848 struct lttng_domain
*domain
, struct lttng_channel
*attr
, int wpipe
)
851 struct ltt_ust_session
*usess
= session
->ust_session
;
852 struct lttng_ht
*chan_ht
;
858 DBG("Enabling channel %s for session %s", attr
->name
, session
->name
);
862 switch (domain
->type
) {
863 case LTTNG_DOMAIN_KERNEL
:
865 struct ltt_kernel_channel
*kchan
;
867 kchan
= trace_kernel_get_channel_by_name(attr
->name
,
868 session
->kernel_session
);
871 * Don't try to create a channel if the session
872 * has been started at some point in time
873 * before. The tracer does not allow it.
875 if (session
->started
) {
876 ret
= LTTNG_ERR_TRACE_ALREADY_STARTED
;
879 ret
= channel_kernel_create(session
->kernel_session
, attr
, wpipe
);
880 if (attr
->name
[0] != '\0') {
881 session
->kernel_session
->has_non_default_channel
= 1;
884 ret
= channel_kernel_enable(session
->kernel_session
, kchan
);
887 if (ret
!= LTTNG_OK
) {
891 kernel_wait_quiescent(kernel_tracer_fd
);
894 case LTTNG_DOMAIN_UST
:
896 struct ltt_ust_channel
*uchan
;
898 chan_ht
= usess
->domain_global
.channels
;
900 uchan
= trace_ust_find_channel_by_name(chan_ht
, attr
->name
);
903 * Don't try to create a channel if the session
904 * has been started at some point in time
905 * before. The tracer does not allow it.
907 if (session
->started
) {
908 ret
= LTTNG_ERR_TRACE_ALREADY_STARTED
;
911 ret
= channel_ust_create(usess
, attr
, domain
->buf_type
);
912 if (attr
->name
[0] != '\0') {
913 usess
->has_non_default_channel
= 1;
916 ret
= channel_ust_enable(usess
, uchan
);
921 ret
= LTTNG_ERR_UNKNOWN_DOMAIN
;
932 * Command LTTNG_DISABLE_EVENT processed by the client thread.
934 int cmd_disable_event(struct ltt_session
*session
, int domain
,
935 char *channel_name
, char *event_name
)
942 case LTTNG_DOMAIN_KERNEL
:
944 struct ltt_kernel_channel
*kchan
;
945 struct ltt_kernel_session
*ksess
;
947 ksess
= session
->kernel_session
;
950 * If a non-default channel has been created in the
951 * session, explicitely require that -c chan_name needs
954 if (ksess
->has_non_default_channel
&& channel_name
[0] == '\0') {
955 ret
= LTTNG_ERR_NEED_CHANNEL_NAME
;
959 kchan
= trace_kernel_get_channel_by_name(channel_name
, ksess
);
961 ret
= LTTNG_ERR_KERN_CHAN_NOT_FOUND
;
965 ret
= event_kernel_disable_tracepoint(kchan
, event_name
);
966 if (ret
!= LTTNG_OK
) {
970 kernel_wait_quiescent(kernel_tracer_fd
);
973 case LTTNG_DOMAIN_UST
:
975 struct ltt_ust_channel
*uchan
;
976 struct ltt_ust_session
*usess
;
978 usess
= session
->ust_session
;
981 * If a non-default channel has been created in the
982 * session, explicitely require that -c chan_name needs
985 if (usess
->has_non_default_channel
&& channel_name
[0] == '\0') {
986 ret
= LTTNG_ERR_NEED_CHANNEL_NAME
;
990 uchan
= trace_ust_find_channel_by_name(usess
->domain_global
.channels
,
993 ret
= LTTNG_ERR_UST_CHAN_NOT_FOUND
;
997 ret
= event_ust_disable_tracepoint(usess
, uchan
, event_name
);
998 if (ret
!= LTTNG_OK
) {
1002 DBG3("Disable UST event %s in channel %s completed", event_name
,
1007 case LTTNG_DOMAIN_UST_EXEC_NAME
:
1008 case LTTNG_DOMAIN_UST_PID
:
1009 case LTTNG_DOMAIN_UST_PID_FOLLOW_CHILDREN
:
1012 ret
= LTTNG_ERR_UND
;
1024 * Command LTTNG_DISABLE_ALL_EVENT processed by the client thread.
1026 int cmd_disable_event_all(struct ltt_session
*session
, int domain
,
1034 case LTTNG_DOMAIN_KERNEL
:
1036 struct ltt_kernel_session
*ksess
;
1037 struct ltt_kernel_channel
*kchan
;
1039 ksess
= session
->kernel_session
;
1042 * If a non-default channel has been created in the
1043 * session, explicitely require that -c chan_name needs
1046 if (ksess
->has_non_default_channel
&& channel_name
[0] == '\0') {
1047 ret
= LTTNG_ERR_NEED_CHANNEL_NAME
;
1051 kchan
= trace_kernel_get_channel_by_name(channel_name
, ksess
);
1052 if (kchan
== NULL
) {
1053 ret
= LTTNG_ERR_KERN_CHAN_NOT_FOUND
;
1057 ret
= event_kernel_disable_all(kchan
);
1058 if (ret
!= LTTNG_OK
) {
1062 kernel_wait_quiescent(kernel_tracer_fd
);
1065 case LTTNG_DOMAIN_UST
:
1067 struct ltt_ust_session
*usess
;
1068 struct ltt_ust_channel
*uchan
;
1070 usess
= session
->ust_session
;
1073 * If a non-default channel has been created in the
1074 * session, explicitely require that -c chan_name needs
1077 if (usess
->has_non_default_channel
&& channel_name
[0] == '\0') {
1078 ret
= LTTNG_ERR_NEED_CHANNEL_NAME
;
1082 uchan
= trace_ust_find_channel_by_name(usess
->domain_global
.channels
,
1084 if (uchan
== NULL
) {
1085 ret
= LTTNG_ERR_UST_CHAN_NOT_FOUND
;
1089 ret
= event_ust_disable_all_tracepoints(usess
, uchan
);
1094 DBG3("Disable all UST events in channel %s completed", channel_name
);
1099 case LTTNG_DOMAIN_UST_EXEC_NAME
:
1100 case LTTNG_DOMAIN_UST_PID
:
1101 case LTTNG_DOMAIN_UST_PID_FOLLOW_CHILDREN
:
1104 ret
= LTTNG_ERR_UND
;
1116 * Command LTTNG_ADD_CONTEXT processed by the client thread.
1118 int cmd_add_context(struct ltt_session
*session
, int domain
,
1119 char *channel_name
, struct lttng_event_context
*ctx
, int kwpipe
)
1121 int ret
, chan_kern_created
= 0, chan_ust_created
= 0;
1124 case LTTNG_DOMAIN_KERNEL
:
1125 assert(session
->kernel_session
);
1127 if (session
->kernel_session
->channel_count
== 0) {
1128 /* Create default channel */
1129 ret
= channel_kernel_create(session
->kernel_session
, NULL
, kwpipe
);
1130 if (ret
!= LTTNG_OK
) {
1133 chan_kern_created
= 1;
1135 /* Add kernel context to kernel tracer */
1136 ret
= context_kernel_add(session
->kernel_session
, ctx
, channel_name
);
1137 if (ret
!= LTTNG_OK
) {
1141 case LTTNG_DOMAIN_UST
:
1143 struct ltt_ust_session
*usess
= session
->ust_session
;
1144 unsigned int chan_count
;
1148 chan_count
= lttng_ht_get_count(usess
->domain_global
.channels
);
1149 if (chan_count
== 0) {
1150 struct lttng_channel
*attr
;
1151 /* Create default channel */
1152 attr
= channel_new_default_attr(domain
, usess
->buffer_type
);
1154 ret
= LTTNG_ERR_FATAL
;
1158 ret
= channel_ust_create(usess
, attr
, usess
->buffer_type
);
1159 if (ret
!= LTTNG_OK
) {
1164 chan_ust_created
= 1;
1167 ret
= context_ust_add(usess
, domain
, ctx
, channel_name
);
1168 if (ret
!= LTTNG_OK
) {
1174 case LTTNG_DOMAIN_UST_EXEC_NAME
:
1175 case LTTNG_DOMAIN_UST_PID
:
1176 case LTTNG_DOMAIN_UST_PID_FOLLOW_CHILDREN
:
1179 ret
= LTTNG_ERR_UND
;
1186 if (chan_kern_created
) {
1187 struct ltt_kernel_channel
*kchan
=
1188 trace_kernel_get_channel_by_name(DEFAULT_CHANNEL_NAME
,
1189 session
->kernel_session
);
1190 /* Created previously, this should NOT fail. */
1192 kernel_destroy_channel(kchan
);
1195 if (chan_ust_created
) {
1196 struct ltt_ust_channel
*uchan
=
1197 trace_ust_find_channel_by_name(
1198 session
->ust_session
->domain_global
.channels
,
1199 DEFAULT_CHANNEL_NAME
);
1200 /* Created previously, this should NOT fail. */
1202 /* Remove from the channel list of the session. */
1203 trace_ust_delete_channel(session
->ust_session
->domain_global
.channels
,
1205 trace_ust_destroy_channel(uchan
);
1211 * Command LTTNG_ENABLE_EVENT processed by the client thread.
1213 int cmd_enable_event(struct ltt_session
*session
, struct lttng_domain
*domain
,
1214 char *channel_name
, struct lttng_event
*event
,
1215 struct lttng_filter_bytecode
*filter
, int wpipe
)
1217 int ret
, channel_created
= 0;
1218 struct lttng_channel
*attr
;
1222 assert(channel_name
);
1226 switch (domain
->type
) {
1227 case LTTNG_DOMAIN_KERNEL
:
1229 struct ltt_kernel_channel
*kchan
;
1232 * If a non-default channel has been created in the
1233 * session, explicitely require that -c chan_name needs
1236 if (session
->kernel_session
->has_non_default_channel
1237 && channel_name
[0] == '\0') {
1238 ret
= LTTNG_ERR_NEED_CHANNEL_NAME
;
1242 kchan
= trace_kernel_get_channel_by_name(channel_name
,
1243 session
->kernel_session
);
1244 if (kchan
== NULL
) {
1245 attr
= channel_new_default_attr(LTTNG_DOMAIN_KERNEL
,
1246 LTTNG_BUFFER_GLOBAL
);
1248 ret
= LTTNG_ERR_FATAL
;
1251 strncpy(attr
->name
, channel_name
, sizeof(attr
->name
));
1253 ret
= cmd_enable_channel(session
, domain
, attr
, wpipe
);
1254 if (ret
!= LTTNG_OK
) {
1260 channel_created
= 1;
1263 /* Get the newly created kernel channel pointer */
1264 kchan
= trace_kernel_get_channel_by_name(channel_name
,
1265 session
->kernel_session
);
1266 if (kchan
== NULL
) {
1267 /* This sould not happen... */
1268 ret
= LTTNG_ERR_FATAL
;
1272 ret
= event_kernel_enable_tracepoint(kchan
, event
);
1273 if (ret
!= LTTNG_OK
) {
1274 if (channel_created
) {
1275 /* Let's not leak a useless channel. */
1276 kernel_destroy_channel(kchan
);
1281 kernel_wait_quiescent(kernel_tracer_fd
);
1284 case LTTNG_DOMAIN_UST
:
1286 struct ltt_ust_channel
*uchan
;
1287 struct ltt_ust_session
*usess
= session
->ust_session
;
1292 * If a non-default channel has been created in the
1293 * session, explicitely require that -c chan_name needs
1296 if (usess
->has_non_default_channel
&& channel_name
[0] == '\0') {
1297 ret
= LTTNG_ERR_NEED_CHANNEL_NAME
;
1301 /* Get channel from global UST domain */
1302 uchan
= trace_ust_find_channel_by_name(usess
->domain_global
.channels
,
1304 if (uchan
== NULL
) {
1305 /* Create default channel */
1306 attr
= channel_new_default_attr(LTTNG_DOMAIN_UST
,
1307 usess
->buffer_type
);
1309 ret
= LTTNG_ERR_FATAL
;
1312 strncpy(attr
->name
, channel_name
, sizeof(attr
->name
));
1314 ret
= cmd_enable_channel(session
, domain
, attr
, wpipe
);
1315 if (ret
!= LTTNG_OK
) {
1321 /* Get the newly created channel reference back */
1322 uchan
= trace_ust_find_channel_by_name(
1323 usess
->domain_global
.channels
, channel_name
);
1327 /* At this point, the session and channel exist on the tracer */
1328 ret
= event_ust_enable_tracepoint(usess
, uchan
, event
, filter
);
1329 if (ret
!= LTTNG_OK
) {
1335 case LTTNG_DOMAIN_UST_EXEC_NAME
:
1336 case LTTNG_DOMAIN_UST_PID
:
1337 case LTTNG_DOMAIN_UST_PID_FOLLOW_CHILDREN
:
1340 ret
= LTTNG_ERR_UND
;
1352 * Command LTTNG_ENABLE_ALL_EVENT processed by the client thread.
1354 int cmd_enable_event_all(struct ltt_session
*session
,
1355 struct lttng_domain
*domain
, char *channel_name
, int event_type
,
1356 struct lttng_filter_bytecode
*filter
, int wpipe
)
1359 struct lttng_channel
*attr
;
1362 assert(channel_name
);
1366 switch (domain
->type
) {
1367 case LTTNG_DOMAIN_KERNEL
:
1369 struct ltt_kernel_channel
*kchan
;
1371 assert(session
->kernel_session
);
1374 * If a non-default channel has been created in the
1375 * session, explicitely require that -c chan_name needs
1378 if (session
->kernel_session
->has_non_default_channel
1379 && channel_name
[0] == '\0') {
1380 ret
= LTTNG_ERR_NEED_CHANNEL_NAME
;
1384 kchan
= trace_kernel_get_channel_by_name(channel_name
,
1385 session
->kernel_session
);
1386 if (kchan
== NULL
) {
1387 /* Create default channel */
1388 attr
= channel_new_default_attr(LTTNG_DOMAIN_KERNEL
,
1389 LTTNG_BUFFER_GLOBAL
);
1391 ret
= LTTNG_ERR_FATAL
;
1394 strncpy(attr
->name
, channel_name
, sizeof(attr
->name
));
1396 ret
= cmd_enable_channel(session
, domain
, attr
, wpipe
);
1397 if (ret
!= LTTNG_OK
) {
1403 /* Get the newly created kernel channel pointer */
1404 kchan
= trace_kernel_get_channel_by_name(channel_name
,
1405 session
->kernel_session
);
1409 switch (event_type
) {
1410 case LTTNG_EVENT_SYSCALL
:
1411 ret
= event_kernel_enable_all_syscalls(kchan
, kernel_tracer_fd
);
1413 case LTTNG_EVENT_TRACEPOINT
:
1415 * This call enables all LTTNG_KERNEL_TRACEPOINTS and
1416 * events already registered to the channel.
1418 ret
= event_kernel_enable_all_tracepoints(kchan
, kernel_tracer_fd
);
1420 case LTTNG_EVENT_ALL
:
1421 /* Enable syscalls and tracepoints */
1422 ret
= event_kernel_enable_all(kchan
, kernel_tracer_fd
);
1425 ret
= LTTNG_ERR_KERN_ENABLE_FAIL
;
1429 /* Manage return value */
1430 if (ret
!= LTTNG_OK
) {
1432 * On error, cmd_enable_channel call will take care of destroying
1433 * the created channel if it was needed.
1438 kernel_wait_quiescent(kernel_tracer_fd
);
1441 case LTTNG_DOMAIN_UST
:
1443 struct ltt_ust_channel
*uchan
;
1444 struct ltt_ust_session
*usess
= session
->ust_session
;
1449 * If a non-default channel has been created in the
1450 * session, explicitely require that -c chan_name needs
1453 if (usess
->has_non_default_channel
&& channel_name
[0] == '\0') {
1454 ret
= LTTNG_ERR_NEED_CHANNEL_NAME
;
1458 /* Get channel from global UST domain */
1459 uchan
= trace_ust_find_channel_by_name(usess
->domain_global
.channels
,
1461 if (uchan
== NULL
) {
1462 /* Create default channel */
1463 attr
= channel_new_default_attr(LTTNG_DOMAIN_UST
,
1464 usess
->buffer_type
);
1466 ret
= LTTNG_ERR_FATAL
;
1469 strncpy(attr
->name
, channel_name
, sizeof(attr
->name
));
1471 ret
= cmd_enable_channel(session
, domain
, attr
, wpipe
);
1472 if (ret
!= LTTNG_OK
) {
1478 /* Get the newly created channel reference back */
1479 uchan
= trace_ust_find_channel_by_name(
1480 usess
->domain_global
.channels
, channel_name
);
1484 /* At this point, the session and channel exist on the tracer */
1486 switch (event_type
) {
1487 case LTTNG_EVENT_ALL
:
1488 case LTTNG_EVENT_TRACEPOINT
:
1489 ret
= event_ust_enable_all_tracepoints(usess
, uchan
, filter
);
1490 if (ret
!= LTTNG_OK
) {
1495 ret
= LTTNG_ERR_UST_ENABLE_FAIL
;
1499 /* Manage return value */
1500 if (ret
!= LTTNG_OK
) {
1507 case LTTNG_DOMAIN_UST_EXEC_NAME
:
1508 case LTTNG_DOMAIN_UST_PID
:
1509 case LTTNG_DOMAIN_UST_PID_FOLLOW_CHILDREN
:
1512 ret
= LTTNG_ERR_UND
;
1525 * Command LTTNG_LIST_TRACEPOINTS processed by the client thread.
1527 ssize_t
cmd_list_tracepoints(int domain
, struct lttng_event
**events
)
1530 ssize_t nb_events
= 0;
1533 case LTTNG_DOMAIN_KERNEL
:
1534 nb_events
= kernel_list_events(kernel_tracer_fd
, events
);
1535 if (nb_events
< 0) {
1536 ret
= LTTNG_ERR_KERN_LIST_FAIL
;
1540 case LTTNG_DOMAIN_UST
:
1541 nb_events
= ust_app_list_events(events
);
1542 if (nb_events
< 0) {
1543 ret
= LTTNG_ERR_UST_LIST_FAIL
;
1548 ret
= LTTNG_ERR_UND
;
1555 /* Return negative value to differentiate return code */
1560 * Command LTTNG_LIST_TRACEPOINT_FIELDS processed by the client thread.
1562 ssize_t
cmd_list_tracepoint_fields(int domain
,
1563 struct lttng_event_field
**fields
)
1566 ssize_t nb_fields
= 0;
1569 case LTTNG_DOMAIN_UST
:
1570 nb_fields
= ust_app_list_event_fields(fields
);
1571 if (nb_fields
< 0) {
1572 ret
= LTTNG_ERR_UST_LIST_FAIL
;
1576 case LTTNG_DOMAIN_KERNEL
:
1577 default: /* fall-through */
1578 ret
= LTTNG_ERR_UND
;
1585 /* Return negative value to differentiate return code */
1590 * Command LTTNG_START_TRACE processed by the client thread.
1592 int cmd_start_trace(struct ltt_session
*session
)
1595 struct ltt_kernel_session
*ksession
;
1596 struct ltt_ust_session
*usess
;
1600 /* Ease our life a bit ;) */
1601 ksession
= session
->kernel_session
;
1602 usess
= session
->ust_session
;
1604 if (session
->enabled
) {
1605 /* Already started. */
1606 ret
= LTTNG_ERR_TRACE_ALREADY_STARTED
;
1610 session
->enabled
= 1;
1612 /* Kernel tracing */
1613 if (ksession
!= NULL
) {
1614 ret
= start_kernel_session(ksession
, kernel_tracer_fd
);
1615 if (ret
!= LTTNG_OK
) {
1620 /* Flag session that trace should start automatically */
1622 usess
->start_trace
= 1;
1624 ret
= ust_app_start_trace_all(usess
);
1626 ret
= LTTNG_ERR_UST_START_FAIL
;
1631 session
->started
= 1;
1640 * Command LTTNG_STOP_TRACE processed by the client thread.
1642 int cmd_stop_trace(struct ltt_session
*session
)
1645 struct ltt_kernel_channel
*kchan
;
1646 struct ltt_kernel_session
*ksession
;
1647 struct ltt_ust_session
*usess
;
1652 ksession
= session
->kernel_session
;
1653 usess
= session
->ust_session
;
1655 if (!session
->enabled
) {
1656 ret
= LTTNG_ERR_TRACE_ALREADY_STOPPED
;
1660 session
->enabled
= 0;
1663 if (ksession
&& ksession
->started
) {
1664 DBG("Stop kernel tracing");
1666 /* Flush metadata if exist */
1667 if (ksession
->metadata_stream_fd
>= 0) {
1668 ret
= kernel_metadata_flush_buffer(ksession
->metadata_stream_fd
);
1670 ERR("Kernel metadata flush failed");
1674 /* Flush all buffers before stopping */
1675 cds_list_for_each_entry(kchan
, &ksession
->channel_list
.head
, list
) {
1676 ret
= kernel_flush_buffer(kchan
);
1678 ERR("Kernel flush buffer error");
1682 ret
= kernel_stop_session(ksession
);
1684 ret
= LTTNG_ERR_KERN_STOP_FAIL
;
1688 kernel_wait_quiescent(kernel_tracer_fd
);
1690 ksession
->started
= 0;
1693 if (usess
&& usess
->start_trace
) {
1694 usess
->start_trace
= 0;
1696 ret
= ust_app_stop_trace_all(usess
);
1698 ret
= LTTNG_ERR_UST_STOP_FAIL
;
1710 * Command LTTNG_SET_CONSUMER_URI processed by the client thread.
1712 int cmd_set_consumer_uri(int domain
, struct ltt_session
*session
,
1713 size_t nb_uri
, struct lttng_uri
*uris
)
1716 struct ltt_kernel_session
*ksess
= session
->kernel_session
;
1717 struct ltt_ust_session
*usess
= session
->ust_session
;
1718 struct consumer_output
*consumer
= NULL
;
1724 /* Can't enable consumer after session started. */
1725 if (session
->enabled
) {
1726 ret
= LTTNG_ERR_TRACE_ALREADY_STARTED
;
1731 * This case switch makes sure the domain session has a temporary consumer
1732 * so the URL can be set.
1736 /* Code flow error. A session MUST always have a consumer object */
1737 assert(session
->consumer
);
1739 * The URL will be added to the tracing session consumer instead of a
1740 * specific domain consumer.
1742 consumer
= session
->consumer
;
1744 case LTTNG_DOMAIN_KERNEL
:
1745 /* Code flow error if we don't have a kernel session here. */
1747 assert(ksess
->consumer
);
1748 consumer
= ksess
->consumer
;
1750 case LTTNG_DOMAIN_UST
:
1751 /* Code flow error if we don't have a kernel session here. */
1753 assert(usess
->consumer
);
1754 consumer
= usess
->consumer
;
1758 for (i
= 0; i
< nb_uri
; i
++) {
1759 ret
= add_uri_to_consumer(consumer
, &uris
[i
], domain
, session
->name
);
1760 if (ret
!= LTTNG_OK
) {
1773 * Command LTTNG_CREATE_SESSION processed by the client thread.
1775 int cmd_create_session_uri(char *name
, struct lttng_uri
*uris
,
1776 size_t nb_uri
, lttng_sock_cred
*creds
)
1779 struct ltt_session
*session
;
1785 * Verify if the session already exist
1787 * XXX: There is no need for the session lock list here since the caller
1788 * (process_client_msg) is holding it. We might want to change that so a
1789 * single command does not lock the entire session list.
1791 session
= session_find_by_name(name
);
1792 if (session
!= NULL
) {
1793 ret
= LTTNG_ERR_EXIST_SESS
;
1797 /* Create tracing session in the registry */
1798 ret
= session_create(name
, LTTNG_SOCK_GET_UID_CRED(creds
),
1799 LTTNG_SOCK_GET_GID_CRED(creds
));
1800 if (ret
!= LTTNG_OK
) {
1805 * Get the newly created session pointer back
1807 * XXX: There is no need for the session lock list here since the caller
1808 * (process_client_msg) is holding it. We might want to change that so a
1809 * single command does not lock the entire session list.
1811 session
= session_find_by_name(name
);
1814 /* Create default consumer output for the session not yet created. */
1815 session
->consumer
= consumer_create_output(CONSUMER_DST_LOCAL
);
1816 if (session
->consumer
== NULL
) {
1817 ret
= LTTNG_ERR_FATAL
;
1818 goto consumer_error
;
1822 ret
= cmd_set_consumer_uri(0, session
, nb_uri
, uris
);
1823 if (ret
!= LTTNG_OK
) {
1824 goto consumer_error
;
1826 session
->output_traces
= 1;
1828 session
->output_traces
= 0;
1829 DBG2("Session %s created with no output", session
->name
);
1832 session
->consumer
->enabled
= 1;
1837 session_destroy(session
);
1844 * Command LTTNG_CREATE_SESSION_SNAPSHOT processed by the client thread.
1846 int cmd_create_session_snapshot(char *name
, struct lttng_uri
*uris
,
1847 size_t nb_uri
, lttng_sock_cred
*creds
)
1850 struct ltt_session
*session
;
1851 struct snapshot_output
*new_output
= NULL
;
1857 * Create session in no output mode with URIs set to NULL. The uris we've
1858 * received are for a default snapshot output if one.
1860 ret
= cmd_create_session_uri(name
, NULL
, 0, creds
);
1861 if (ret
!= LTTNG_OK
) {
1865 /* Get the newly created session pointer back. This should NEVER fail. */
1866 session
= session_find_by_name(name
);
1869 /* Flag session for snapshot mode. */
1870 session
->snapshot_mode
= 1;
1872 /* Skip snapshot output creation if no URI is given. */
1877 new_output
= snapshot_output_alloc();
1879 ret
= LTTNG_ERR_NOMEM
;
1880 goto error_snapshot_alloc
;
1883 ret
= snapshot_output_init_with_uri(DEFAULT_SNAPSHOT_MAX_SIZE
, NULL
,
1884 uris
, nb_uri
, session
->consumer
, new_output
, &session
->snapshot
);
1886 if (ret
== -ENOMEM
) {
1887 ret
= LTTNG_ERR_NOMEM
;
1889 ret
= LTTNG_ERR_INVALID
;
1891 goto error_snapshot
;
1895 snapshot_add_output(&session
->snapshot
, new_output
);
1902 snapshot_output_destroy(new_output
);
1903 error_snapshot_alloc
:
1904 session_destroy(session
);
1910 * Command LTTNG_DESTROY_SESSION processed by the client thread.
1912 int cmd_destroy_session(struct ltt_session
*session
, int wpipe
)
1915 struct ltt_ust_session
*usess
;
1916 struct ltt_kernel_session
*ksess
;
1921 usess
= session
->ust_session
;
1922 ksess
= session
->kernel_session
;
1924 /* Clean kernel session teardown */
1925 kernel_destroy_session(ksess
);
1927 /* UST session teardown */
1929 /* Close any relayd session */
1930 consumer_output_send_destroy_relayd(usess
->consumer
);
1932 /* Destroy every UST application related to this session. */
1933 ret
= ust_app_destroy_trace_all(usess
);
1935 ERR("Error in ust_app_destroy_trace_all");
1938 /* Clean up the rest. */
1939 trace_ust_destroy_session(usess
);
1943 * Must notify the kernel thread here to update it's poll set in order to
1944 * remove the channel(s)' fd just destroyed.
1946 ret
= notify_thread_pipe(wpipe
);
1948 PERROR("write kernel poll pipe");
1951 ret
= session_destroy(session
);
1957 * Command LTTNG_CALIBRATE processed by the client thread.
1959 int cmd_calibrate(int domain
, struct lttng_calibrate
*calibrate
)
1964 case LTTNG_DOMAIN_KERNEL
:
1966 struct lttng_kernel_calibrate kcalibrate
;
1968 kcalibrate
.type
= calibrate
->type
;
1969 ret
= kernel_calibrate(kernel_tracer_fd
, &kcalibrate
);
1971 ret
= LTTNG_ERR_KERN_ENABLE_FAIL
;
1976 case LTTNG_DOMAIN_UST
:
1978 struct lttng_ust_calibrate ucalibrate
;
1980 ucalibrate
.type
= calibrate
->type
;
1981 ret
= ust_app_calibrate_glb(&ucalibrate
);
1983 ret
= LTTNG_ERR_UST_CALIBRATE_FAIL
;
1989 ret
= LTTNG_ERR_UND
;
2000 * Command LTTNG_REGISTER_CONSUMER processed by the client thread.
2002 int cmd_register_consumer(struct ltt_session
*session
, int domain
,
2003 const char *sock_path
, struct consumer_data
*cdata
)
2006 struct consumer_socket
*socket
= NULL
;
2013 case LTTNG_DOMAIN_KERNEL
:
2015 struct ltt_kernel_session
*ksess
= session
->kernel_session
;
2019 /* Can't register a consumer if there is already one */
2020 if (ksess
->consumer_fds_sent
!= 0) {
2021 ret
= LTTNG_ERR_KERN_CONSUMER_FAIL
;
2025 sock
= lttcomm_connect_unix_sock(sock_path
);
2027 ret
= LTTNG_ERR_CONNECT_FAIL
;
2031 socket
= consumer_allocate_socket(sock
);
2032 if (socket
== NULL
) {
2035 PERROR("close register consumer");
2037 ret
= LTTNG_ERR_FATAL
;
2041 socket
->lock
= zmalloc(sizeof(pthread_mutex_t
));
2042 if (socket
->lock
== NULL
) {
2043 PERROR("zmalloc pthread mutex");
2044 ret
= LTTNG_ERR_FATAL
;
2047 pthread_mutex_init(socket
->lock
, NULL
);
2048 socket
->registered
= 1;
2051 consumer_add_socket(socket
, ksess
->consumer
);
2054 pthread_mutex_lock(&cdata
->pid_mutex
);
2056 pthread_mutex_unlock(&cdata
->pid_mutex
);
2061 /* TODO: Userspace tracing */
2062 ret
= LTTNG_ERR_UND
;
2070 consumer_destroy_socket(socket
);
2076 * Command LTTNG_LIST_DOMAINS processed by the client thread.
2078 ssize_t
cmd_list_domains(struct ltt_session
*session
,
2079 struct lttng_domain
**domains
)
2084 if (session
->kernel_session
!= NULL
) {
2085 DBG3("Listing domains found kernel domain");
2089 if (session
->ust_session
!= NULL
) {
2090 DBG3("Listing domains found UST global domain");
2094 *domains
= zmalloc(nb_dom
* sizeof(struct lttng_domain
));
2095 if (*domains
== NULL
) {
2096 ret
= LTTNG_ERR_FATAL
;
2100 if (session
->kernel_session
!= NULL
) {
2101 (*domains
)[index
].type
= LTTNG_DOMAIN_KERNEL
;
2105 if (session
->ust_session
!= NULL
) {
2106 (*domains
)[index
].type
= LTTNG_DOMAIN_UST
;
2107 (*domains
)[index
].buf_type
= session
->ust_session
->buffer_type
;
2114 /* Return negative value to differentiate return code */
2120 * Command LTTNG_LIST_CHANNELS processed by the client thread.
2122 ssize_t
cmd_list_channels(int domain
, struct ltt_session
*session
,
2123 struct lttng_channel
**channels
)
2126 ssize_t nb_chan
= 0;
2129 case LTTNG_DOMAIN_KERNEL
:
2130 if (session
->kernel_session
!= NULL
) {
2131 nb_chan
= session
->kernel_session
->channel_count
;
2133 DBG3("Number of kernel channels %zd", nb_chan
);
2135 ret
= LTTNG_ERR_KERN_CHAN_NOT_FOUND
;
2138 case LTTNG_DOMAIN_UST
:
2139 if (session
->ust_session
!= NULL
) {
2140 nb_chan
= lttng_ht_get_count(
2141 session
->ust_session
->domain_global
.channels
);
2143 DBG3("Number of UST global channels %zd", nb_chan
);
2145 ret
= LTTNG_ERR_UST_CHAN_NOT_FOUND
;
2150 ret
= LTTNG_ERR_UND
;
2155 *channels
= zmalloc(nb_chan
* sizeof(struct lttng_channel
));
2156 if (*channels
== NULL
) {
2157 ret
= LTTNG_ERR_FATAL
;
2161 list_lttng_channels(domain
, session
, *channels
);
2164 /* Ret value was set in the domain switch case */
2171 /* Return negative value to differentiate return code */
2176 * Command LTTNG_LIST_EVENTS processed by the client thread.
2178 ssize_t
cmd_list_events(int domain
, struct ltt_session
*session
,
2179 char *channel_name
, struct lttng_event
**events
)
2182 ssize_t nb_event
= 0;
2185 case LTTNG_DOMAIN_KERNEL
:
2186 if (session
->kernel_session
!= NULL
) {
2187 nb_event
= list_lttng_kernel_events(channel_name
,
2188 session
->kernel_session
, events
);
2191 case LTTNG_DOMAIN_UST
:
2193 if (session
->ust_session
!= NULL
) {
2194 nb_event
= list_lttng_ust_global_events(channel_name
,
2195 &session
->ust_session
->domain_global
, events
);
2200 ret
= LTTNG_ERR_UND
;
2207 /* Return negative value to differentiate return code */
2212 * Using the session list, filled a lttng_session array to send back to the
2213 * client for session listing.
2215 * The session list lock MUST be acquired before calling this function. Use
2216 * session_lock_list() and session_unlock_list().
2218 void cmd_list_lttng_sessions(struct lttng_session
*sessions
, uid_t uid
,
2223 struct ltt_session
*session
;
2224 struct ltt_session_list
*list
= session_get_list();
2226 DBG("Getting all available session for UID %d GID %d",
2229 * Iterate over session list and append data after the control struct in
2232 cds_list_for_each_entry(session
, &list
->head
, list
) {
2234 * Only list the sessions the user can control.
2236 if (!session_access_ok(session
, uid
, gid
)) {
2240 struct ltt_kernel_session
*ksess
= session
->kernel_session
;
2241 struct ltt_ust_session
*usess
= session
->ust_session
;
2243 if (session
->consumer
->type
== CONSUMER_DST_NET
||
2244 (ksess
&& ksess
->consumer
->type
== CONSUMER_DST_NET
) ||
2245 (usess
&& usess
->consumer
->type
== CONSUMER_DST_NET
)) {
2246 ret
= build_network_session_path(sessions
[i
].path
,
2247 sizeof(sessions
[i
].path
), session
);
2249 ret
= snprintf(sessions
[i
].path
, sizeof(sessions
[i
].path
), "%s",
2250 session
->consumer
->dst
.trace_path
);
2253 PERROR("snprintf session path");
2257 strncpy(sessions
[i
].name
, session
->name
, NAME_MAX
);
2258 sessions
[i
].name
[NAME_MAX
- 1] = '\0';
2259 sessions
[i
].enabled
= session
->enabled
;
2260 sessions
[i
].snapshot_mode
= session
->snapshot_mode
;
2266 * Command LTTNG_DATA_PENDING returning 0 if the data is NOT pending meaning
2267 * ready for trace analysis (or any kind of reader) or else 1 for pending data.
2269 int cmd_data_pending(struct ltt_session
*session
)
2272 struct ltt_kernel_session
*ksess
= session
->kernel_session
;
2273 struct ltt_ust_session
*usess
= session
->ust_session
;
2277 /* Session MUST be stopped to ask for data availability. */
2278 if (session
->enabled
) {
2279 ret
= LTTNG_ERR_SESSION_STARTED
;
2283 if (ksess
&& ksess
->consumer
) {
2284 ret
= consumer_is_data_pending(ksess
->id
, ksess
->consumer
);
2286 /* Data is still being extracted for the kernel. */
2291 if (usess
&& usess
->consumer
) {
2292 ret
= consumer_is_data_pending(usess
->id
, usess
->consumer
);
2294 /* Data is still being extracted for the kernel. */
2299 /* Data is ready to be read by a viewer */
2307 * Command LTTNG_SNAPSHOT_ADD_OUTPUT from the lttng ctl library.
2309 * Return LTTNG_OK on success or else a LTTNG_ERR code.
2311 int cmd_snapshot_add_output(struct ltt_session
*session
,
2312 struct lttng_snapshot_output
*output
, uint32_t *id
)
2315 struct snapshot_output
*new_output
;
2320 DBG("Cmd snapshot add output for session %s", session
->name
);
2323 * Permission denied to create an output if the session is not
2324 * set in no output mode.
2326 if (session
->output_traces
) {
2327 ret
= LTTNG_ERR_EPERM
;
2331 /* Only one output is allowed until we have the "tee" feature. */
2332 if (session
->snapshot
.nb_output
== 1) {
2333 ret
= LTTNG_ERR_SNAPSHOT_OUTPUT_EXIST
;
2337 new_output
= snapshot_output_alloc();
2339 ret
= LTTNG_ERR_NOMEM
;
2343 ret
= snapshot_output_init(output
->max_size
, output
->name
,
2344 output
->ctrl_url
, output
->data_url
, session
->consumer
, new_output
,
2345 &session
->snapshot
);
2347 if (ret
== -ENOMEM
) {
2348 ret
= LTTNG_ERR_NOMEM
;
2350 ret
= LTTNG_ERR_INVALID
;
2356 snapshot_add_output(&session
->snapshot
, new_output
);
2358 *id
= new_output
->id
;
2365 snapshot_output_destroy(new_output
);
2371 * Command LTTNG_SNAPSHOT_DEL_OUTPUT from lib lttng ctl.
2373 * Return LTTNG_OK on success or else a LTTNG_ERR code.
2375 int cmd_snapshot_del_output(struct ltt_session
*session
,
2376 struct lttng_snapshot_output
*output
)
2379 struct snapshot_output
*sout
= NULL
;
2387 * Permission denied to create an output if the session is not
2388 * set in no output mode.
2390 if (session
->output_traces
) {
2391 ret
= LTTNG_ERR_EPERM
;
2396 DBG("Cmd snapshot del output id %" PRIu32
" for session %s", output
->id
,
2398 sout
= snapshot_find_output_by_id(output
->id
, &session
->snapshot
);
2399 } else if (*output
->name
!= '\0') {
2400 DBG("Cmd snapshot del output name %s for session %s", output
->name
,
2402 sout
= snapshot_find_output_by_name(output
->name
, &session
->snapshot
);
2405 ret
= LTTNG_ERR_INVALID
;
2409 snapshot_delete_output(&session
->snapshot
, sout
);
2410 snapshot_output_destroy(sout
);
2419 * Command LTTNG_SNAPSHOT_LIST_OUTPUT from lib lttng ctl.
2421 * If no output is available, outputs is untouched and 0 is returned.
2423 * Return the size of the newly allocated outputs or a negative LTTNG_ERR code.
2425 ssize_t
cmd_snapshot_list_outputs(struct ltt_session
*session
,
2426 struct lttng_snapshot_output
**outputs
)
2429 struct lttng_snapshot_output
*list
;
2430 struct lttng_ht_iter iter
;
2431 struct snapshot_output
*output
;
2436 DBG("Cmd snapshot list outputs for session %s", session
->name
);
2439 * Permission denied to create an output if the session is not
2440 * set in no output mode.
2442 if (session
->output_traces
) {
2443 ret
= LTTNG_ERR_EPERM
;
2447 if (session
->snapshot
.nb_output
== 0) {
2452 list
= zmalloc(session
->snapshot
.nb_output
* sizeof(*list
));
2454 ret
= LTTNG_ERR_NOMEM
;
2458 /* Copy list from session to the new list object. */
2459 cds_lfht_for_each_entry(session
->snapshot
.output_ht
->ht
, &iter
.iter
,
2460 output
, node
.node
) {
2461 assert(output
->consumer
);
2462 list
[idx
].id
= output
->id
;
2463 list
[idx
].max_size
= output
->max_size
;
2464 strncpy(list
[idx
].name
, output
->name
, sizeof(list
[idx
].name
));
2465 if (output
->consumer
->type
== CONSUMER_DST_LOCAL
) {
2466 strncpy(list
[idx
].ctrl_url
, output
->consumer
->dst
.trace_path
,
2467 sizeof(list
[idx
].ctrl_url
));
2470 ret
= uri_to_str_url(&output
->consumer
->dst
.net
.control
,
2471 list
[idx
].ctrl_url
, sizeof(list
[idx
].ctrl_url
));
2473 ret
= LTTNG_ERR_NOMEM
;
2478 ret
= uri_to_str_url(&output
->consumer
->dst
.net
.data
,
2479 list
[idx
].data_url
, sizeof(list
[idx
].data_url
));
2481 ret
= LTTNG_ERR_NOMEM
;
2489 return session
->snapshot
.nb_output
;
2498 * Send relayd sockets from snapshot output to consumer. Ignore request if the
2499 * snapshot output is *not* set with a remote destination.
2501 * Return 0 on success or a LTTNG_ERR code.
2503 static int set_relayd_for_snapshot(struct consumer_output
*consumer
,
2504 struct snapshot_output
*snap_output
, struct ltt_session
*session
)
2507 struct lttng_ht_iter iter
;
2508 struct consumer_socket
*socket
;
2511 assert(snap_output
);
2514 DBG2("Set relayd object from snapshot output");
2516 /* Ignore if snapshot consumer output is not network. */
2517 if (snap_output
->consumer
->type
!= CONSUMER_DST_NET
) {
2522 * For each consumer socket, create and send the relayd object of the
2526 cds_lfht_for_each_entry(snap_output
->consumer
->socks
->ht
, &iter
.iter
,
2527 socket
, node
.node
) {
2528 ret
= send_consumer_relayd_sockets(0, session
->id
,
2529 snap_output
->consumer
, socket
);
2530 if (ret
!= LTTNG_OK
) {
2542 * Record a kernel snapshot.
2544 * Return 0 on success or a LTTNG_ERR code.
2546 static int record_kernel_snapshot(struct ltt_kernel_session
*ksess
,
2547 struct snapshot_output
*output
, struct ltt_session
*session
,
2548 int wait
, int nb_streams
)
2556 /* Get the datetime for the snapshot output directory. */
2557 ret
= utils_get_current_time_str("%Y%m%d-%H%M%S", output
->datetime
,
2558 sizeof(output
->datetime
));
2560 ret
= LTTNG_ERR_INVALID
;
2565 * Copy kernel session sockets so we can communicate with the right
2566 * consumer for the snapshot record command.
2568 ret
= consumer_copy_sockets(output
->consumer
, ksess
->consumer
);
2570 ret
= LTTNG_ERR_NOMEM
;
2574 ret
= set_relayd_for_snapshot(ksess
->consumer
, output
, session
);
2575 if (ret
!= LTTNG_OK
) {
2576 goto error_snapshot
;
2579 ret
= kernel_snapshot_record(ksess
, output
, wait
, nb_streams
);
2581 if (ret
== -EINVAL
) {
2582 ret
= LTTNG_ERR_INVALID
;
2583 goto error_snapshot
;
2586 ret
= LTTNG_ERR_SNAPSHOT_FAIL
;
2587 goto error_snapshot
;
2593 /* Clean up copied sockets so this output can use some other later on. */
2594 consumer_destroy_output_sockets(output
->consumer
);
2600 * Record a UST snapshot.
2602 * Return 0 on success or a LTTNG_ERR error code.
2604 static int record_ust_snapshot(struct ltt_ust_session
*usess
,
2605 struct snapshot_output
*output
, struct ltt_session
*session
,
2606 int wait
, int nb_streams
)
2614 /* Get the datetime for the snapshot output directory. */
2615 ret
= utils_get_current_time_str("%Y%m%d-%H%M%S", output
->datetime
,
2616 sizeof(output
->datetime
));
2618 ret
= LTTNG_ERR_INVALID
;
2623 * Copy UST session sockets so we can communicate with the right
2624 * consumer for the snapshot record command.
2626 ret
= consumer_copy_sockets(output
->consumer
, usess
->consumer
);
2628 ret
= LTTNG_ERR_NOMEM
;
2632 ret
= set_relayd_for_snapshot(usess
->consumer
, output
, session
);
2633 if (ret
!= LTTNG_OK
) {
2634 goto error_snapshot
;
2637 ret
= ust_app_snapshot_record(usess
, output
, wait
, nb_streams
);
2639 if (ret
== -EINVAL
) {
2640 ret
= LTTNG_ERR_INVALID
;
2641 goto error_snapshot
;
2644 ret
= LTTNG_ERR_SNAPSHOT_FAIL
;
2645 goto error_snapshot
;
2651 /* Clean up copied sockets so this output can use some other later on. */
2652 consumer_destroy_output_sockets(output
->consumer
);
2658 * Returns the total number of streams for a session or a negative value
2661 static unsigned int get_total_nb_stream(struct ltt_session
*session
)
2663 unsigned int total_streams
= 0;
2665 if (session
->kernel_session
) {
2666 struct ltt_kernel_session
*ksess
= session
->kernel_session
;
2668 total_streams
+= ksess
->stream_count_global
;
2671 if (session
->ust_session
) {
2672 struct ltt_ust_session
*usess
= session
->ust_session
;
2674 total_streams
+= ust_app_get_nb_stream(usess
);
2677 return total_streams
;
2681 * Command LTTNG_SNAPSHOT_RECORD from lib lttng ctl.
2683 * The wait parameter is ignored so this call always wait for the snapshot to
2684 * complete before returning.
2686 * Return LTTNG_OK on success or else a LTTNG_ERR code.
2688 int cmd_snapshot_record(struct ltt_session
*session
,
2689 struct lttng_snapshot_output
*output
, int wait
)
2692 unsigned int use_tmp_output
= 0;
2693 struct snapshot_output tmp_output
;
2694 unsigned int nb_streams
, snapshot_success
= 0;
2698 DBG("Cmd snapshot record for session %s", session
->name
);
2701 * Permission denied to create an output if the session is not
2702 * set in no output mode.
2704 if (session
->output_traces
) {
2705 ret
= LTTNG_ERR_EPERM
;
2709 /* The session needs to be started at least once. */
2710 if (!session
->started
) {
2711 ret
= LTTNG_ERR_START_SESSION_ONCE
;
2715 /* Use temporary output for the session. */
2716 if (output
&& *output
->ctrl_url
!= '\0') {
2717 ret
= snapshot_output_init(output
->max_size
, output
->name
,
2718 output
->ctrl_url
, output
->data_url
, session
->consumer
,
2721 if (ret
== -ENOMEM
) {
2722 ret
= LTTNG_ERR_NOMEM
;
2724 ret
= LTTNG_ERR_INVALID
;
2728 /* Use the global session count for the temporary snapshot. */
2729 tmp_output
.nb_snapshot
= session
->snapshot
.nb_snapshot
;
2734 * Get the total number of stream of that session which is used by the
2735 * maximum size of the snapshot feature.
2737 nb_streams
= get_total_nb_stream(session
);
2739 if (session
->kernel_session
) {
2740 struct ltt_kernel_session
*ksess
= session
->kernel_session
;
2742 if (use_tmp_output
) {
2743 ret
= record_kernel_snapshot(ksess
, &tmp_output
, session
,
2745 if (ret
!= LTTNG_OK
) {
2748 snapshot_success
= 1;
2750 struct snapshot_output
*sout
;
2751 struct lttng_ht_iter iter
;
2754 cds_lfht_for_each_entry(session
->snapshot
.output_ht
->ht
,
2755 &iter
.iter
, sout
, node
.node
) {
2757 * Make a local copy of the output and assign the possible
2758 * temporary value given by the caller.
2760 memset(&tmp_output
, 0, sizeof(tmp_output
));
2761 memcpy(&tmp_output
, sout
, sizeof(tmp_output
));
2763 /* Use temporary max size. */
2764 if (output
->max_size
!= (uint64_t) -1ULL) {
2765 tmp_output
.max_size
= output
->max_size
;
2768 /* Use temporary name. */
2769 if (*output
->name
!= '\0') {
2770 strncpy(tmp_output
.name
, output
->name
,
2771 sizeof(tmp_output
.name
));
2774 tmp_output
.nb_snapshot
= session
->snapshot
.nb_snapshot
;
2776 ret
= record_kernel_snapshot(ksess
, &tmp_output
,
2777 session
, wait
, nb_streams
);
2778 if (ret
!= LTTNG_OK
) {
2782 snapshot_success
= 1;
2788 if (session
->ust_session
) {
2789 struct ltt_ust_session
*usess
= session
->ust_session
;
2791 if (use_tmp_output
) {
2792 ret
= record_ust_snapshot(usess
, &tmp_output
, session
,
2794 if (ret
!= LTTNG_OK
) {
2797 snapshot_success
= 1;
2799 struct snapshot_output
*sout
;
2800 struct lttng_ht_iter iter
;
2803 cds_lfht_for_each_entry(session
->snapshot
.output_ht
->ht
,
2804 &iter
.iter
, sout
, node
.node
) {
2806 * Make a local copy of the output and assign the possible
2807 * temporary value given by the caller.
2809 memset(&tmp_output
, 0, sizeof(tmp_output
));
2810 memcpy(&tmp_output
, sout
, sizeof(tmp_output
));
2812 /* Use temporary max size. */
2813 if (output
->max_size
!= (uint64_t) -1ULL) {
2814 tmp_output
.max_size
= output
->max_size
;
2817 /* Use temporary name. */
2818 if (*output
->name
!= '\0') {
2819 strncpy(tmp_output
.name
, output
->name
,
2820 sizeof(tmp_output
.name
));
2823 tmp_output
.nb_snapshot
= session
->snapshot
.nb_snapshot
;
2825 ret
= record_ust_snapshot(usess
, &tmp_output
, session
,
2827 if (ret
!= LTTNG_OK
) {
2831 snapshot_success
= 1;
2837 if (snapshot_success
) {
2838 session
->snapshot
.nb_snapshot
++;
2840 ret
= LTTNG_ERR_SNAPSHOT_FAIL
;
2848 * Init command subsystem.
2853 * Set network sequence index to 1 for streams to match a relayd
2854 * socket on the consumer side.
2856 pthread_mutex_lock(&relayd_net_seq_idx_lock
);
2857 relayd_net_seq_idx
= 1;
2858 pthread_mutex_unlock(&relayd_net_seq_idx_lock
);
2860 DBG("Command subsystem initialized");