Backport: relayd: track the live client connections socket
[lttng-tools.git] / src / bin / lttng-relayd / live.c
1 /*
2 * Copyright (C) 2013 - Julien Desfossez <jdesfossez@efficios.com>
3 * David Goulet <dgoulet@efficios.com>
4 * 2015 - Mathieu Desnoyers <mathieu.desnoyers@efficios.com>
5 *
6 * This program is free software; you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License, version 2 only,
8 * as published by the Free Software Foundation.
9 *
10 * This program is distributed in the hope that it will be useful, but WITHOUT
11 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
12 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
13 * more details.
14 *
15 * You should have received a copy of the GNU General Public License along
16 * with this program; if not, write to the Free Software Foundation, Inc.,
17 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
18 */
19
20 #define _LGPL_SOURCE
21 #include <getopt.h>
22 #include <grp.h>
23 #include <limits.h>
24 #include <pthread.h>
25 #include <signal.h>
26 #include <stdio.h>
27 #include <stdlib.h>
28 #include <string.h>
29 #include <sys/mman.h>
30 #include <sys/mount.h>
31 #include <sys/resource.h>
32 #include <sys/socket.h>
33 #include <sys/stat.h>
34 #include <sys/types.h>
35 #include <sys/wait.h>
36 #include <inttypes.h>
37 #include <urcu/futex.h>
38 #include <urcu/uatomic.h>
39 #include <urcu/rculist.h>
40 #include <unistd.h>
41 #include <fcntl.h>
42
43 #include <lttng/lttng.h>
44 #include <common/common.h>
45 #include <common/compat/poll.h>
46 #include <common/compat/socket.h>
47 #include <common/compat/endian.h>
48 #include <common/defaults.h>
49 #include <common/futex.h>
50 #include <common/index/index.h>
51 #include <common/sessiond-comm/sessiond-comm.h>
52 #include <common/sessiond-comm/inet.h>
53 #include <common/sessiond-comm/relayd.h>
54 #include <common/uri.h>
55 #include <common/utils.h>
56 #include <common/fd-tracker/utils.h>
57
58 #include "cmd.h"
59 #include "live.h"
60 #include "lttng-relayd.h"
61 #include "utils.h"
62 #include "health-relayd.h"
63 #include "testpoint.h"
64 #include "viewer-stream.h"
65 #include "stream.h"
66 #include "session.h"
67 #include "ctf-trace.h"
68 #include "connection.h"
69 #include "viewer-session.h"
70
71 #define SESSION_BUF_DEFAULT_COUNT 16
72
73 static struct lttng_uri *live_uri;
74
75 /*
76 * This pipe is used to inform the worker thread that a command is queued and
77 * ready to be processed.
78 */
79 static int live_conn_pipe[2] = { -1, -1 };
80
81 /* Shared between threads */
82 static int live_dispatch_thread_exit;
83
84 static pthread_t live_listener_thread;
85 static pthread_t live_dispatcher_thread;
86 static pthread_t live_worker_thread;
87
88 /*
89 * Relay command queue.
90 *
91 * The live_thread_listener and live_thread_dispatcher communicate with this
92 * queue.
93 */
94 static struct relay_conn_queue viewer_conn_queue;
95
96 static uint64_t last_relay_viewer_session_id;
97 static pthread_mutex_t last_relay_viewer_session_id_lock =
98 PTHREAD_MUTEX_INITIALIZER;
99
100 /*
101 * Cleanup the daemon
102 */
103 static
104 void cleanup_relayd_live(void)
105 {
106 DBG("Cleaning up");
107
108 free(live_uri);
109 }
110
111 /*
112 * Receive a request buffer using a given socket, destination allocated buffer
113 * of length size.
114 *
115 * Return the size of the received message or else a negative value on error
116 * with errno being set by recvmsg() syscall.
117 */
118 static
119 ssize_t recv_request(struct lttcomm_sock *sock, void *buf, size_t size)
120 {
121 ssize_t ret;
122
123 ret = sock->ops->recvmsg(sock, buf, size, 0);
124 if (ret < 0 || ret != size) {
125 if (ret == 0) {
126 /* Orderly shutdown. Not necessary to print an error. */
127 DBG("Socket %d did an orderly shutdown", sock->fd);
128 } else {
129 ERR("Relay failed to receive request.");
130 }
131 ret = -1;
132 }
133
134 return ret;
135 }
136
137 /*
138 * Send a response buffer using a given socket, source allocated buffer of
139 * length size.
140 *
141 * Return the size of the sent message or else a negative value on error with
142 * errno being set by sendmsg() syscall.
143 */
144 static
145 ssize_t send_response(struct lttcomm_sock *sock, void *buf, size_t size)
146 {
147 ssize_t ret;
148
149 ret = sock->ops->sendmsg(sock, buf, size, 0);
150 if (ret < 0) {
151 ERR("Relayd failed to send response.");
152 }
153
154 return ret;
155 }
156
157 /*
158 * Atomically check if new streams got added in one of the sessions attached
159 * and reset the flag to 0.
160 *
161 * Returns 1 if new streams got added, 0 if nothing changed, a negative value
162 * on error.
163 */
164 static
165 int check_new_streams(struct relay_connection *conn)
166 {
167 struct relay_session *session;
168 unsigned long current_val;
169 int ret = 0;
170
171 if (!conn->viewer_session) {
172 goto end;
173 }
174 rcu_read_lock();
175 cds_list_for_each_entry_rcu(session,
176 &conn->viewer_session->session_list,
177 viewer_session_node) {
178 if (!session_get(session)) {
179 continue;
180 }
181 current_val = uatomic_cmpxchg(&session->new_streams, 1, 0);
182 ret = current_val;
183 session_put(session);
184 if (ret == 1) {
185 goto end;
186 }
187 }
188 end:
189 rcu_read_unlock();
190 return ret;
191 }
192
193 /*
194 * Send viewer streams to the given socket. The ignore_sent_flag indicates if
195 * this function should ignore the sent flag or not.
196 *
197 * Return 0 on success or else a negative value.
198 */
199 static
200 ssize_t send_viewer_streams(struct lttcomm_sock *sock,
201 struct relay_session *session, unsigned int ignore_sent_flag)
202 {
203 ssize_t ret;
204 struct lttng_viewer_stream send_stream;
205 struct lttng_ht_iter iter;
206 struct relay_viewer_stream *vstream;
207
208 rcu_read_lock();
209
210 cds_lfht_for_each_entry(viewer_streams_ht->ht, &iter.iter, vstream,
211 stream_n.node) {
212 struct ctf_trace *ctf_trace;
213
214 health_code_update();
215
216 if (!viewer_stream_get(vstream)) {
217 continue;
218 }
219
220 pthread_mutex_lock(&vstream->stream->lock);
221 /* Ignore if not the same session. */
222 if (vstream->stream->trace->session->id != session->id ||
223 (!ignore_sent_flag && vstream->sent_flag)) {
224 pthread_mutex_unlock(&vstream->stream->lock);
225 viewer_stream_put(vstream);
226 continue;
227 }
228
229 ctf_trace = vstream->stream->trace;
230 send_stream.id = htobe64(vstream->stream->stream_handle);
231 send_stream.ctf_trace_id = htobe64(ctf_trace->id);
232 send_stream.metadata_flag = htobe32(
233 vstream->stream->is_metadata);
234 if (lttng_strncpy(send_stream.path_name, vstream->path_name,
235 sizeof(send_stream.path_name))) {
236 pthread_mutex_unlock(&vstream->stream->lock);
237 viewer_stream_put(vstream);
238 ret = -1; /* Error. */
239 goto end_unlock;
240 }
241 if (lttng_strncpy(send_stream.channel_name,
242 vstream->channel_name,
243 sizeof(send_stream.channel_name))) {
244 pthread_mutex_unlock(&vstream->stream->lock);
245 viewer_stream_put(vstream);
246 ret = -1; /* Error. */
247 goto end_unlock;
248 }
249
250 DBG("Sending stream %" PRIu64 " to viewer",
251 vstream->stream->stream_handle);
252 vstream->sent_flag = 1;
253 pthread_mutex_unlock(&vstream->stream->lock);
254
255 ret = send_response(sock, &send_stream, sizeof(send_stream));
256 viewer_stream_put(vstream);
257 if (ret < 0) {
258 goto end_unlock;
259 }
260 }
261
262 ret = 0;
263
264 end_unlock:
265 rcu_read_unlock();
266 return ret;
267 }
268
269 /*
270 * Create every viewer stream possible for the given session with the seek
271 * type. Three counters *can* be return which are in order the total amount of
272 * viewer stream of the session, the number of unsent stream and the number of
273 * stream created. Those counters can be NULL and thus will be ignored.
274 *
275 * Return 0 on success or else a negative value.
276 */
277 static
278 int make_viewer_streams(struct relay_session *session,
279 enum lttng_viewer_seek seek_t, uint32_t *nb_total, uint32_t *nb_unsent,
280 uint32_t *nb_created, bool *closed)
281 {
282 int ret;
283 struct lttng_ht_iter iter;
284 struct ctf_trace *ctf_trace;
285
286 assert(session);
287
288 /*
289 * Hold the session lock to ensure that we see either none or
290 * all initial streams for a session, but no intermediate state.
291 */
292 pthread_mutex_lock(&session->lock);
293
294 if (session->connection_closed) {
295 *closed = true;
296 }
297
298 /*
299 * Create viewer streams for relay streams that are ready to be
300 * used for a the given session id only.
301 */
302 rcu_read_lock();
303 cds_lfht_for_each_entry(session->ctf_traces_ht->ht, &iter.iter, ctf_trace,
304 node.node) {
305 struct relay_stream *stream;
306
307 health_code_update();
308
309 if (!ctf_trace_get(ctf_trace)) {
310 continue;
311 }
312
313 cds_list_for_each_entry_rcu(stream, &ctf_trace->stream_list, stream_node) {
314 struct relay_viewer_stream *vstream;
315
316 if (!stream_get(stream)) {
317 continue;
318 }
319 /*
320 * stream published is protected by the session lock.
321 */
322 if (!stream->published) {
323 goto next;
324 }
325 vstream = viewer_stream_get_by_id(stream->stream_handle);
326 if (!vstream) {
327 vstream = viewer_stream_create(stream, seek_t);
328 if (!vstream) {
329 ret = -1;
330 ctf_trace_put(ctf_trace);
331 stream_put(stream);
332 goto error_unlock;
333 }
334
335 if (nb_created) {
336 /* Update number of created stream counter. */
337 (*nb_created)++;
338 }
339 /*
340 * Ensure a self-reference is preserved even
341 * after we have put our local reference.
342 */
343 if (!viewer_stream_get(vstream)) {
344 ERR("Unable to get self-reference on viewer stream, logic error.");
345 abort();
346 }
347 } else {
348 if (!vstream->sent_flag && nb_unsent) {
349 /* Update number of unsent stream counter. */
350 (*nb_unsent)++;
351 }
352 }
353 /* Update number of total stream counter. */
354 if (nb_total) {
355 if (stream->is_metadata) {
356 if (!stream->closed ||
357 stream->metadata_received > vstream->metadata_sent) {
358 (*nb_total)++;
359 }
360 } else {
361 if (!stream->closed ||
362 !(((int64_t) (stream->prev_seq - stream->last_net_seq_num)) >= 0)) {
363
364 (*nb_total)++;
365 }
366 }
367 }
368 /* Put local reference. */
369 viewer_stream_put(vstream);
370 next:
371 stream_put(stream);
372 }
373 ctf_trace_put(ctf_trace);
374 }
375
376 ret = 0;
377
378 error_unlock:
379 rcu_read_unlock();
380 pthread_mutex_unlock(&session->lock);
381 return ret;
382 }
383
384 int relayd_live_stop(void)
385 {
386 /* Stop dispatch thread */
387 CMM_STORE_SHARED(live_dispatch_thread_exit, 1);
388 futex_nto1_wake(&viewer_conn_queue.futex);
389 return 0;
390 }
391
392 /*
393 * Create a poll set with O_CLOEXEC and add the thread quit pipe to the set.
394 */
395 static
396 int create_named_thread_poll_set(struct lttng_poll_event *events,
397 int size, const char *name)
398 {
399 int ret;
400
401 if (events == NULL || size == 0) {
402 ret = -1;
403 goto error;
404 }
405
406 ret = fd_tracker_util_poll_create(the_fd_tracker,
407 name, events, 1, LTTNG_CLOEXEC);
408
409 /* Add quit pipe */
410 ret = lttng_poll_add(events, thread_quit_pipe[0], LPOLLIN | LPOLLERR);
411 if (ret < 0) {
412 goto error;
413 }
414
415 return 0;
416
417 error:
418 return ret;
419 }
420
421 /*
422 * Check if the thread quit pipe was triggered.
423 *
424 * Return 1 if it was triggered else 0;
425 */
426 static
427 int check_thread_quit_pipe(int fd, uint32_t events)
428 {
429 if (fd == thread_quit_pipe[0] && (events & LPOLLIN)) {
430 return 1;
431 }
432
433 return 0;
434 }
435
436 static
437 int create_sock(void *data, int *out_fd)
438 {
439 int ret;
440 struct lttcomm_sock *sock = data;
441
442 ret = lttcomm_create_sock(sock);
443 if (ret < 0) {
444 goto end;
445 }
446
447 *out_fd = sock->fd;
448 end:
449 return ret;
450 }
451
452 static
453 int close_sock(void *data, int *in_fd)
454 {
455 struct lttcomm_sock *sock = data;
456
457 return sock->ops->close(sock);
458 }
459
460 static int accept_sock(void *data, int *out_fd)
461 {
462 int ret = 0;
463 /* Socks is an array of in_sock, out_sock. */
464 struct lttcomm_sock **socks = data;
465 struct lttcomm_sock *in_sock = socks[0];
466
467 socks[1] = in_sock->ops->accept(in_sock);
468 if (!socks[1]) {
469 ret = -1;
470 goto end;
471 }
472 *out_fd = socks[1]->fd;
473 end:
474 return ret;
475 }
476
477 static
478 struct lttcomm_sock *accept_live_sock(struct lttcomm_sock *listening_sock,
479 const char *name)
480 {
481 int out_fd, ret;
482 struct lttcomm_sock *socks[2] = { listening_sock, NULL };
483 struct lttcomm_sock *new_sock = NULL;
484
485 ret = fd_tracker_open_unsuspendable_fd(
486 the_fd_tracker, &out_fd,
487 (const char **) &name,
488 1, accept_sock, &socks);
489 if (ret) {
490 goto end;
491 }
492 new_sock = socks[1];
493 DBG("%s accepted, socket %d", name, new_sock->fd);
494 end:
495 return new_sock;
496 }
497
498 /*
499 * Create and init socket from uri.
500 */
501 static
502 struct lttcomm_sock *init_socket(struct lttng_uri *uri, const char *name)
503 {
504 int ret, sock_fd;
505 struct lttcomm_sock *sock = NULL;
506 char uri_str[PATH_MAX];
507 char *formated_name = NULL;
508
509 sock = lttcomm_alloc_sock_from_uri(uri);
510 if (sock == NULL) {
511 ERR("Allocating socket");
512 goto error;
513 }
514
515 /*
516 * Don't fail to create the socket if the name can't be built as it is
517 * only used for debugging purposes.
518 */
519 ret = uri_to_str_url(uri, uri_str, sizeof(uri_str));
520 uri_str[sizeof(uri_str) - 1] = '\0';
521 if (ret >= 0) {
522 ret = asprintf(&formated_name, "%s socket @ %s", name,
523 uri_str);
524 if (ret < 0) {
525 formated_name = NULL;
526 }
527 }
528
529 ret = fd_tracker_open_unsuspendable_fd(the_fd_tracker, &sock_fd,
530 (const char **) (formated_name ? &formated_name : NULL),
531 1, create_sock, sock);
532 free(formated_name);
533 DBG("Listening on %s socket %d", name, sock->fd);
534
535 ret = sock->ops->bind(sock);
536 if (ret < 0) {
537 goto error;
538 }
539
540 ret = sock->ops->listen(sock, -1);
541 if (ret < 0) {
542 goto error;
543
544 }
545
546 return sock;
547
548 error:
549 if (sock) {
550 lttcomm_destroy_sock(sock);
551 }
552 return NULL;
553 }
554
555 /*
556 * This thread manages the listening for new connections on the network
557 */
558 static
559 void *thread_listener(void *data)
560 {
561 int i, ret, pollfd, err = -1;
562 uint32_t revents, nb_fd;
563 struct lttng_poll_event events;
564 struct lttcomm_sock *live_control_sock;
565
566 DBG("[thread] Relay live listener started");
567
568 health_register(health_relayd, HEALTH_RELAYD_TYPE_LIVE_LISTENER);
569
570 health_code_update();
571
572 live_control_sock = init_socket(live_uri, "Live listener");
573 if (!live_control_sock) {
574 goto error_sock_control;
575 }
576
577 /* Pass 2 as size here for the thread quit pipe and control sockets. */
578 ret = create_named_thread_poll_set(&events, 2,
579 "Live listener thread epoll");
580 if (ret < 0) {
581 goto error_create_poll;
582 }
583
584 /* Add the control socket */
585 ret = lttng_poll_add(&events, live_control_sock->fd, LPOLLIN | LPOLLRDHUP);
586 if (ret < 0) {
587 goto error_poll_add;
588 }
589
590 lttng_relay_notify_ready();
591
592 if (testpoint(relayd_thread_live_listener)) {
593 goto error_testpoint;
594 }
595
596 while (1) {
597 health_code_update();
598
599 DBG("Listener accepting live viewers connections");
600
601 restart:
602 health_poll_entry();
603 ret = lttng_poll_wait(&events, -1);
604 health_poll_exit();
605 if (ret < 0) {
606 /*
607 * Restart interrupted system call.
608 */
609 if (errno == EINTR) {
610 goto restart;
611 }
612 goto error;
613 }
614 nb_fd = ret;
615
616 DBG("Relay new viewer connection received");
617 for (i = 0; i < nb_fd; i++) {
618 health_code_update();
619
620 /* Fetch once the poll data */
621 revents = LTTNG_POLL_GETEV(&events, i);
622 pollfd = LTTNG_POLL_GETFD(&events, i);
623
624 if (!revents) {
625 /* No activity for this FD (poll implementation). */
626 continue;
627 }
628
629 /* Thread quit pipe has been closed. Killing thread. */
630 ret = check_thread_quit_pipe(pollfd, revents);
631 if (ret) {
632 err = 0;
633 goto exit;
634 }
635
636 if (revents & LPOLLIN) {
637 /*
638 * A new connection is requested, therefore a
639 * viewer connection is allocated in this
640 * thread, enqueued to a global queue and
641 * dequeued (and freed) in the worker thread.
642 */
643 int val = 1;
644 struct relay_connection *new_conn;
645 struct lttcomm_sock *newsock;
646
647 newsock = accept_live_sock(live_control_sock,
648 "Live socket to client");
649 if (!newsock) {
650 PERROR("accepting control sock");
651 goto error;
652 }
653 DBG("Relay viewer connection accepted socket %d", newsock->fd);
654
655 ret = setsockopt(newsock->fd, SOL_SOCKET, SO_REUSEADDR, &val,
656 sizeof(val));
657 if (ret < 0) {
658 PERROR("setsockopt inet");
659 lttcomm_destroy_sock(newsock);
660 goto error;
661 }
662 new_conn = connection_create(newsock, RELAY_CONNECTION_UNKNOWN);
663 if (!new_conn) {
664 lttcomm_destroy_sock(newsock);
665 goto error;
666 }
667 /* Ownership assumed by the connection. */
668 newsock = NULL;
669
670 /* Enqueue request for the dispatcher thread. */
671 cds_wfcq_enqueue(&viewer_conn_queue.head, &viewer_conn_queue.tail,
672 &new_conn->qnode);
673
674 /*
675 * Wake the dispatch queue futex.
676 * Implicit memory barrier with the
677 * exchange in cds_wfcq_enqueue.
678 */
679 futex_nto1_wake(&viewer_conn_queue.futex);
680 } else if (revents & (LPOLLERR | LPOLLHUP | LPOLLRDHUP)) {
681 ERR("socket poll error");
682 goto error;
683 } else {
684 ERR("Unexpected poll events %u for sock %d", revents, pollfd);
685 goto error;
686 }
687 }
688 }
689
690 exit:
691 error:
692 error_poll_add:
693 error_testpoint:
694 (void) fd_tracker_util_poll_clean(the_fd_tracker, &events);
695 error_create_poll:
696 if (live_control_sock->fd >= 0) {
697 ret = fd_tracker_close_unsuspendable_fd(the_fd_tracker,
698 &live_control_sock->fd, 1, close_sock,
699 live_control_sock);
700 if (ret) {
701 PERROR("close");
702 }
703 }
704 lttcomm_destroy_sock(live_control_sock);
705 error_sock_control:
706 if (err) {
707 health_error();
708 DBG("Live viewer listener thread exited with error");
709 }
710 health_unregister(health_relayd);
711 DBG("Live viewer listener thread cleanup complete");
712 if (lttng_relay_stop_threads()) {
713 ERR("Error stopping threads");
714 }
715 return NULL;
716 }
717
718 /*
719 * This thread manages the dispatching of the requests to worker threads
720 */
721 static
722 void *thread_dispatcher(void *data)
723 {
724 int err = -1;
725 ssize_t ret;
726 struct cds_wfcq_node *node;
727 struct relay_connection *conn = NULL;
728
729 DBG("[thread] Live viewer relay dispatcher started");
730
731 health_register(health_relayd, HEALTH_RELAYD_TYPE_LIVE_DISPATCHER);
732
733 if (testpoint(relayd_thread_live_dispatcher)) {
734 goto error_testpoint;
735 }
736
737 health_code_update();
738
739 for (;;) {
740 health_code_update();
741
742 /* Atomically prepare the queue futex */
743 futex_nto1_prepare(&viewer_conn_queue.futex);
744
745 if (CMM_LOAD_SHARED(live_dispatch_thread_exit)) {
746 break;
747 }
748
749 do {
750 health_code_update();
751
752 /* Dequeue commands */
753 node = cds_wfcq_dequeue_blocking(&viewer_conn_queue.head,
754 &viewer_conn_queue.tail);
755 if (node == NULL) {
756 DBG("Woken up but nothing in the live-viewer "
757 "relay command queue");
758 /* Continue thread execution */
759 break;
760 }
761 conn = caa_container_of(node, struct relay_connection, qnode);
762 DBG("Dispatching viewer request waiting on sock %d",
763 conn->sock->fd);
764
765 /*
766 * Inform worker thread of the new request. This
767 * call is blocking so we can be assured that
768 * the data will be read at some point in time
769 * or wait to the end of the world :)
770 */
771 ret = lttng_write(live_conn_pipe[1], &conn, sizeof(conn));
772 if (ret < 0) {
773 PERROR("write conn pipe");
774 connection_put(conn);
775 goto error;
776 }
777 } while (node != NULL);
778
779 /* Futex wait on queue. Blocking call on futex() */
780 health_poll_entry();
781 futex_nto1_wait(&viewer_conn_queue.futex);
782 health_poll_exit();
783 }
784
785 /* Normal exit, no error */
786 err = 0;
787
788 error:
789 error_testpoint:
790 if (err) {
791 health_error();
792 ERR("Health error occurred in %s", __func__);
793 }
794 health_unregister(health_relayd);
795 DBG("Live viewer dispatch thread dying");
796 if (lttng_relay_stop_threads()) {
797 ERR("Error stopping threads");
798 }
799 return NULL;
800 }
801
802 /*
803 * Establish connection with the viewer and check the versions.
804 *
805 * Return 0 on success or else negative value.
806 */
807 static
808 int viewer_connect(struct relay_connection *conn)
809 {
810 int ret;
811 struct lttng_viewer_connect reply, msg;
812
813 conn->version_check_done = 1;
814
815 health_code_update();
816
817 DBG("Viewer is establishing a connection to the relayd.");
818
819 ret = recv_request(conn->sock, &msg, sizeof(msg));
820 if (ret < 0) {
821 goto end;
822 }
823
824 health_code_update();
825
826 memset(&reply, 0, sizeof(reply));
827 reply.major = RELAYD_VERSION_COMM_MAJOR;
828 reply.minor = RELAYD_VERSION_COMM_MINOR;
829
830 /* Major versions must be the same */
831 if (reply.major != be32toh(msg.major)) {
832 DBG("Incompatible major versions ([relayd] %u vs [client] %u)",
833 reply.major, be32toh(msg.major));
834 ret = -1;
835 goto end;
836 }
837
838 conn->major = reply.major;
839 /* We adapt to the lowest compatible version */
840 if (reply.minor <= be32toh(msg.minor)) {
841 conn->minor = reply.minor;
842 } else {
843 conn->minor = be32toh(msg.minor);
844 }
845
846 if (be32toh(msg.type) == LTTNG_VIEWER_CLIENT_COMMAND) {
847 conn->type = RELAY_VIEWER_COMMAND;
848 } else if (be32toh(msg.type) == LTTNG_VIEWER_CLIENT_NOTIFICATION) {
849 conn->type = RELAY_VIEWER_NOTIFICATION;
850 } else {
851 ERR("Unknown connection type : %u", be32toh(msg.type));
852 ret = -1;
853 goto end;
854 }
855
856 reply.major = htobe32(reply.major);
857 reply.minor = htobe32(reply.minor);
858 if (conn->type == RELAY_VIEWER_COMMAND) {
859 /*
860 * Increment outside of htobe64 macro, because the argument can
861 * be used more than once within the macro, and thus the
862 * operation may be undefined.
863 */
864 pthread_mutex_lock(&last_relay_viewer_session_id_lock);
865 last_relay_viewer_session_id++;
866 pthread_mutex_unlock(&last_relay_viewer_session_id_lock);
867 reply.viewer_session_id = htobe64(last_relay_viewer_session_id);
868 }
869
870 health_code_update();
871
872 ret = send_response(conn->sock, &reply, sizeof(reply));
873 if (ret < 0) {
874 goto end;
875 }
876
877 health_code_update();
878
879 DBG("Version check done using protocol %u.%u", conn->major, conn->minor);
880 ret = 0;
881
882 end:
883 return ret;
884 }
885
886 /*
887 * Send the viewer the list of current sessions.
888 * We need to create a copy of the hash table content because otherwise
889 * we cannot assume the number of entries stays the same between getting
890 * the number of HT elements and iteration over the HT.
891 *
892 * Return 0 on success or else a negative value.
893 */
894 static
895 int viewer_list_sessions(struct relay_connection *conn)
896 {
897 int ret = 0;
898 struct lttng_viewer_list_sessions session_list;
899 struct lttng_ht_iter iter;
900 struct relay_session *session;
901 struct lttng_viewer_session *send_session_buf = NULL;
902 uint32_t buf_count = SESSION_BUF_DEFAULT_COUNT;
903 uint32_t count = 0;
904
905 DBG("List sessions received");
906
907 send_session_buf = zmalloc(SESSION_BUF_DEFAULT_COUNT * sizeof(*send_session_buf));
908 if (!send_session_buf) {
909 return -1;
910 }
911
912 rcu_read_lock();
913 cds_lfht_for_each_entry(sessions_ht->ht, &iter.iter, session,
914 session_n.node) {
915 struct lttng_viewer_session *send_session;
916
917 health_code_update();
918
919 if (count >= buf_count) {
920 struct lttng_viewer_session *newbuf;
921 uint32_t new_buf_count = buf_count << 1;
922
923 newbuf = realloc(send_session_buf,
924 new_buf_count * sizeof(*send_session_buf));
925 if (!newbuf) {
926 ret = -1;
927 break;
928 }
929 send_session_buf = newbuf;
930 buf_count = new_buf_count;
931 }
932 send_session = &send_session_buf[count];
933 if (lttng_strncpy(send_session->session_name,
934 session->session_name,
935 sizeof(send_session->session_name))) {
936 ret = -1;
937 break;
938 }
939 if (lttng_strncpy(send_session->hostname, session->hostname,
940 sizeof(send_session->hostname))) {
941 ret = -1;
942 break;
943 }
944 send_session->id = htobe64(session->id);
945 send_session->live_timer = htobe32(session->live_timer);
946 if (session->viewer_attached) {
947 send_session->clients = htobe32(1);
948 } else {
949 send_session->clients = htobe32(0);
950 }
951 send_session->streams = htobe32(session->stream_count);
952 count++;
953 }
954 rcu_read_unlock();
955 if (ret < 0) {
956 goto end_free;
957 }
958
959 session_list.sessions_count = htobe32(count);
960
961 health_code_update();
962
963 ret = send_response(conn->sock, &session_list, sizeof(session_list));
964 if (ret < 0) {
965 goto end_free;
966 }
967
968 health_code_update();
969
970 ret = send_response(conn->sock, send_session_buf,
971 count * sizeof(*send_session_buf));
972 if (ret < 0) {
973 goto end_free;
974 }
975 health_code_update();
976
977 ret = 0;
978 end_free:
979 free(send_session_buf);
980 return ret;
981 }
982
983 /*
984 * Send the viewer the list of current streams.
985 */
986 static
987 int viewer_get_new_streams(struct relay_connection *conn)
988 {
989 int ret, send_streams = 0;
990 uint32_t nb_created = 0, nb_unsent = 0, nb_streams = 0, nb_total = 0;
991 struct lttng_viewer_new_streams_request request;
992 struct lttng_viewer_new_streams_response response;
993 struct relay_session *session;
994 uint64_t session_id;
995 bool closed = false;
996
997 assert(conn);
998
999 DBG("Get new streams received");
1000
1001 health_code_update();
1002
1003 /* Receive the request from the connected client. */
1004 ret = recv_request(conn->sock, &request, sizeof(request));
1005 if (ret < 0) {
1006 goto error;
1007 }
1008 session_id = be64toh(request.session_id);
1009
1010 health_code_update();
1011
1012 memset(&response, 0, sizeof(response));
1013
1014 session = session_get_by_id(session_id);
1015 if (!session) {
1016 DBG("Relay session %" PRIu64 " not found", session_id);
1017 response.status = htobe32(LTTNG_VIEWER_NEW_STREAMS_ERR);
1018 goto send_reply;
1019 }
1020
1021 if (!viewer_session_is_attached(conn->viewer_session, session)) {
1022 send_streams = 0;
1023 response.status = htobe32(LTTNG_VIEWER_NEW_STREAMS_ERR);
1024 goto send_reply;
1025 }
1026
1027 send_streams = 1;
1028 response.status = htobe32(LTTNG_VIEWER_NEW_STREAMS_OK);
1029
1030 ret = make_viewer_streams(session, LTTNG_VIEWER_SEEK_LAST, &nb_total, &nb_unsent,
1031 &nb_created, &closed);
1032 if (ret < 0) {
1033 goto end_put_session;
1034 }
1035 /* Only send back the newly created streams with the unsent ones. */
1036 nb_streams = nb_created + nb_unsent;
1037 response.streams_count = htobe32(nb_streams);
1038
1039 /*
1040 * If the session is closed, HUP when there are no more streams
1041 * with data.
1042 */
1043 if (closed && nb_total == 0) {
1044 send_streams = 0;
1045 response.streams_count = 0;
1046 response.status = htobe32(LTTNG_VIEWER_NEW_STREAMS_HUP);
1047 goto send_reply;
1048 }
1049
1050 send_reply:
1051 health_code_update();
1052 ret = send_response(conn->sock, &response, sizeof(response));
1053 if (ret < 0) {
1054 goto end_put_session;
1055 }
1056 health_code_update();
1057
1058 /*
1059 * Unknown or empty session, just return gracefully, the viewer
1060 * knows what is happening.
1061 */
1062 if (!send_streams || !nb_streams) {
1063 ret = 0;
1064 goto end_put_session;
1065 }
1066
1067 /*
1068 * Send stream and *DON'T* ignore the sent flag so every viewer
1069 * streams that were not sent from that point will be sent to
1070 * the viewer.
1071 */
1072 ret = send_viewer_streams(conn->sock, session, 0);
1073 if (ret < 0) {
1074 goto end_put_session;
1075 }
1076
1077 end_put_session:
1078 if (session) {
1079 session_put(session);
1080 }
1081 error:
1082 return ret;
1083 }
1084
1085 /*
1086 * Send the viewer the list of current sessions.
1087 */
1088 static
1089 int viewer_attach_session(struct relay_connection *conn)
1090 {
1091 int send_streams = 0;
1092 ssize_t ret;
1093 uint32_t nb_streams = 0;
1094 enum lttng_viewer_seek seek_type;
1095 struct lttng_viewer_attach_session_request request;
1096 struct lttng_viewer_attach_session_response response;
1097 struct relay_session *session = NULL;
1098 bool closed = false;
1099
1100 assert(conn);
1101
1102 health_code_update();
1103
1104 /* Receive the request from the connected client. */
1105 ret = recv_request(conn->sock, &request, sizeof(request));
1106 if (ret < 0) {
1107 goto error;
1108 }
1109
1110 health_code_update();
1111
1112 memset(&response, 0, sizeof(response));
1113
1114 if (!conn->viewer_session) {
1115 DBG("Client trying to attach before creating a live viewer session");
1116 response.status = htobe32(LTTNG_VIEWER_ATTACH_NO_SESSION);
1117 goto send_reply;
1118 }
1119
1120 session = session_get_by_id(be64toh(request.session_id));
1121 if (!session) {
1122 DBG("Relay session %" PRIu64 " not found",
1123 (uint64_t) be64toh(request.session_id));
1124 response.status = htobe32(LTTNG_VIEWER_ATTACH_UNK);
1125 goto send_reply;
1126 }
1127 DBG("Attach session ID %" PRIu64 " received",
1128 (uint64_t) be64toh(request.session_id));
1129
1130 if (session->live_timer == 0) {
1131 DBG("Not live session");
1132 response.status = htobe32(LTTNG_VIEWER_ATTACH_NOT_LIVE);
1133 goto send_reply;
1134 }
1135
1136 send_streams = 1;
1137 ret = viewer_session_attach(conn->viewer_session, session);
1138 if (ret) {
1139 DBG("Already a viewer attached");
1140 response.status = htobe32(LTTNG_VIEWER_ATTACH_ALREADY);
1141 goto send_reply;
1142 }
1143
1144 switch (be32toh(request.seek)) {
1145 case LTTNG_VIEWER_SEEK_BEGINNING:
1146 case LTTNG_VIEWER_SEEK_LAST:
1147 response.status = htobe32(LTTNG_VIEWER_ATTACH_OK);
1148 seek_type = be32toh(request.seek);
1149 break;
1150 default:
1151 ERR("Wrong seek parameter");
1152 response.status = htobe32(LTTNG_VIEWER_ATTACH_SEEK_ERR);
1153 send_streams = 0;
1154 goto send_reply;
1155 }
1156
1157 ret = make_viewer_streams(session, seek_type, &nb_streams, NULL,
1158 NULL, &closed);
1159 if (ret < 0) {
1160 goto end_put_session;
1161 }
1162 response.streams_count = htobe32(nb_streams);
1163
1164 /*
1165 * If the session is closed when the viewer is attaching, it
1166 * means some of the streams may have been concurrently removed,
1167 * so we don't allow the viewer to attach, even if there are
1168 * streams available.
1169 */
1170 if (closed) {
1171 send_streams = 0;
1172 response.streams_count = 0;
1173 response.status = htobe32(LTTNG_VIEWER_NEW_STREAMS_HUP);
1174 goto send_reply;
1175 }
1176
1177 send_reply:
1178 health_code_update();
1179 ret = send_response(conn->sock, &response, sizeof(response));
1180 if (ret < 0) {
1181 goto end_put_session;
1182 }
1183 health_code_update();
1184
1185 /*
1186 * Unknown or empty session, just return gracefully, the viewer
1187 * knows what is happening.
1188 */
1189 if (!send_streams || !nb_streams) {
1190 ret = 0;
1191 goto end_put_session;
1192 }
1193
1194 /* Send stream and ignore the sent flag. */
1195 ret = send_viewer_streams(conn->sock, session, 1);
1196 if (ret < 0) {
1197 goto end_put_session;
1198 }
1199
1200 end_put_session:
1201 if (session) {
1202 session_put(session);
1203 }
1204 error:
1205 return ret;
1206 }
1207
1208 /*
1209 * Open the index file if needed for the given vstream.
1210 *
1211 * If an index file is successfully opened, the vstream will set it as its
1212 * current index file.
1213 *
1214 * Return 0 on success, a negative value on error (-ENOENT if not ready yet).
1215 *
1216 * Called with rstream lock held.
1217 */
1218 static int try_open_index(struct relay_viewer_stream *vstream,
1219 struct relay_stream *rstream)
1220 {
1221 int ret = 0;
1222
1223 if (vstream->index_file) {
1224 goto end;
1225 }
1226
1227 /*
1228 * First time, we open the index file and at least one index is ready.
1229 */
1230 if (rstream->index_received_seqcount == 0) {
1231 ret = -ENOENT;
1232 goto end;
1233 }
1234 vstream->index_file = lttng_index_file_open(vstream->path_name,
1235 vstream->channel_name,
1236 vstream->stream->tracefile_count,
1237 vstream->current_tracefile_id);
1238 if (!vstream->index_file) {
1239 ret = -1;
1240 }
1241
1242 end:
1243 return ret;
1244 }
1245
1246 /*
1247 * Check the status of the index for the given stream. This function
1248 * updates the index structure if needed and can put (close) the vstream
1249 * in the HUP situation.
1250 *
1251 * Return 0 means that we can proceed with the index. A value of 1 means
1252 * that the index has been updated and is ready to be sent to the
1253 * client. A negative value indicates an error that can't be handled.
1254 *
1255 * Called with rstream lock held.
1256 */
1257 static int check_index_status(struct relay_viewer_stream *vstream,
1258 struct relay_stream *rstream, struct ctf_trace *trace,
1259 struct lttng_viewer_index *index)
1260 {
1261 int ret;
1262
1263 if (trace->session->connection_closed
1264 && rstream->index_received_seqcount
1265 == vstream->index_sent_seqcount) {
1266 /* Last index sent and session connection is closed. */
1267 index->status = htobe32(LTTNG_VIEWER_INDEX_HUP);
1268 goto hup;
1269 } else if (rstream->beacon_ts_end != -1ULL &&
1270 rstream->index_received_seqcount
1271 == vstream->index_sent_seqcount) {
1272 /*
1273 * We've received a synchronization beacon and the last index
1274 * available has been sent, the index for now is inactive.
1275 *
1276 * In this case, we have received a beacon which allows us to
1277 * inform the client of a time interval during which we can
1278 * guarantee that there are no events to read (and never will
1279 * be).
1280 */
1281 index->status = htobe32(LTTNG_VIEWER_INDEX_INACTIVE);
1282 index->timestamp_end = htobe64(rstream->beacon_ts_end);
1283 index->stream_id = htobe64(rstream->ctf_stream_id);
1284 goto index_ready;
1285 } else if (rstream->index_received_seqcount
1286 == vstream->index_sent_seqcount) {
1287 /*
1288 * This checks whether received == sent seqcount. In
1289 * this case, we have not received a beacon. Therefore,
1290 * we can only ask the client to retry later.
1291 */
1292 index->status = htobe32(LTTNG_VIEWER_INDEX_RETRY);
1293 goto index_ready;
1294 } else if (!tracefile_array_seq_in_file(rstream->tfa,
1295 vstream->current_tracefile_id,
1296 vstream->index_sent_seqcount)) {
1297 /*
1298 * The next index we want to send cannot be read either
1299 * because we need to perform a rotation, or due to
1300 * the producer having overwritten its trace file.
1301 */
1302 DBG("Viewer stream %" PRIu64 " rotation",
1303 vstream->stream->stream_handle);
1304 ret = viewer_stream_rotate(vstream);
1305 if (ret < 0) {
1306 goto end;
1307 } else if (ret == 1) {
1308 /* EOF across entire stream. */
1309 index->status = htobe32(LTTNG_VIEWER_INDEX_HUP);
1310 goto hup;
1311 }
1312 /*
1313 * If we have been pushed due to overwrite, it
1314 * necessarily means there is data that can be read in
1315 * the stream. If we rotated because we reached the end
1316 * of a tracefile, it means the following tracefile
1317 * needs to contain at least one index, else we would
1318 * have already returned LTTNG_VIEWER_INDEX_RETRY to the
1319 * viewer. The updated index_sent_seqcount needs to
1320 * point to a readable index entry now.
1321 *
1322 * In the case where we "rotate" on a single file, we
1323 * can end up in a case where the requested index is
1324 * still unavailable.
1325 */
1326 if (rstream->tracefile_count == 1 &&
1327 !tracefile_array_seq_in_file(
1328 rstream->tfa,
1329 vstream->current_tracefile_id,
1330 vstream->index_sent_seqcount)) {
1331 index->status = htobe32(LTTNG_VIEWER_INDEX_RETRY);
1332 goto index_ready;
1333 }
1334 assert(tracefile_array_seq_in_file(rstream->tfa,
1335 vstream->current_tracefile_id,
1336 vstream->index_sent_seqcount));
1337 }
1338 /* ret == 0 means successful so we continue. */
1339 ret = 0;
1340 end:
1341 return ret;
1342
1343 hup:
1344 viewer_stream_put(vstream);
1345 index_ready:
1346 return 1;
1347 }
1348
1349 /*
1350 * Send the next index for a stream.
1351 *
1352 * Return 0 on success or else a negative value.
1353 */
1354 static
1355 int viewer_get_next_index(struct relay_connection *conn)
1356 {
1357 int ret;
1358 struct lttng_viewer_get_next_index request_index;
1359 struct lttng_viewer_index viewer_index;
1360 struct ctf_packet_index packet_index;
1361 struct relay_viewer_stream *vstream = NULL;
1362 struct relay_stream *rstream = NULL;
1363 struct ctf_trace *ctf_trace = NULL;
1364 struct relay_viewer_stream *metadata_viewer_stream = NULL;
1365
1366 assert(conn);
1367
1368 DBG("Viewer get next index");
1369
1370 memset(&viewer_index, 0, sizeof(viewer_index));
1371 health_code_update();
1372
1373 ret = recv_request(conn->sock, &request_index, sizeof(request_index));
1374 if (ret < 0) {
1375 goto end;
1376 }
1377 health_code_update();
1378
1379 vstream = viewer_stream_get_by_id(be64toh(request_index.stream_id));
1380 if (!vstream) {
1381 DBG("Client requested index of unknown stream id %" PRIu64,
1382 (uint64_t) be64toh(request_index.stream_id));
1383 viewer_index.status = htobe32(LTTNG_VIEWER_INDEX_ERR);
1384 goto send_reply;
1385 }
1386
1387 /* Use back. ref. Protected by refcounts. */
1388 rstream = vstream->stream;
1389 ctf_trace = rstream->trace;
1390
1391 /* metadata_viewer_stream may be NULL. */
1392 metadata_viewer_stream =
1393 ctf_trace_get_viewer_metadata_stream(ctf_trace);
1394
1395 pthread_mutex_lock(&rstream->lock);
1396
1397 /*
1398 * The viewer should not ask for index on metadata stream.
1399 */
1400 if (rstream->is_metadata) {
1401 viewer_index.status = htobe32(LTTNG_VIEWER_INDEX_HUP);
1402 goto send_reply;
1403 }
1404
1405 /* Try to open an index if one is needed for that stream. */
1406 ret = try_open_index(vstream, rstream);
1407 if (ret < 0) {
1408 if (ret == -ENOENT) {
1409 /*
1410 * The index is created only when the first data
1411 * packet arrives, it might not be ready at the
1412 * beginning of the session
1413 */
1414 viewer_index.status = htobe32(LTTNG_VIEWER_INDEX_RETRY);
1415 } else {
1416 /* Unhandled error. */
1417 viewer_index.status = htobe32(LTTNG_VIEWER_INDEX_ERR);
1418 }
1419 goto send_reply;
1420 }
1421
1422 ret = check_index_status(vstream, rstream, ctf_trace, &viewer_index);
1423 if (ret < 0) {
1424 goto error_put;
1425 } else if (ret == 1) {
1426 /*
1427 * We have no index to send and check_index_status has populated
1428 * viewer_index's status.
1429 */
1430 goto send_reply;
1431 }
1432 /* At this point, ret is 0 thus we will be able to read the index. */
1433 assert(!ret);
1434
1435 /*
1436 * vstream->stream_fd may be NULL if it has been closed by
1437 * tracefile rotation, or if we are at the beginning of the
1438 * stream. We open the data stream file here to protect against
1439 * overwrite caused by tracefile rotation (in association with
1440 * unlink performed before overwrite).
1441 */
1442 if (!vstream->stream_fd) {
1443 char fullpath[PATH_MAX];
1444
1445 if (vstream->stream->tracefile_count > 0) {
1446 ret = snprintf(fullpath, PATH_MAX, "%s/%s_%" PRIu64,
1447 vstream->path_name,
1448 vstream->channel_name,
1449 vstream->current_tracefile_id);
1450 } else {
1451 ret = snprintf(fullpath, PATH_MAX, "%s/%s",
1452 vstream->path_name,
1453 vstream->channel_name);
1454 }
1455 if (ret < 0) {
1456 goto error_put;
1457 }
1458 ret = open(fullpath, O_RDONLY);
1459 if (ret < 0) {
1460 PERROR("Relay opening trace file");
1461 goto error_put;
1462 }
1463 vstream->stream_fd = stream_fd_create(ret);
1464 if (!vstream->stream_fd) {
1465 if (close(ret)) {
1466 PERROR("close");
1467 }
1468 goto error_put;
1469 }
1470 }
1471
1472 ret = check_new_streams(conn);
1473 if (ret < 0) {
1474 viewer_index.status = htobe32(LTTNG_VIEWER_INDEX_ERR);
1475 goto send_reply;
1476 } else if (ret == 1) {
1477 viewer_index.flags |= LTTNG_VIEWER_FLAG_NEW_STREAM;
1478 }
1479
1480 ret = lttng_index_file_read(vstream->index_file, &packet_index);
1481 if (ret) {
1482 ERR("Relay error reading index file %d",
1483 vstream->index_file->fd);
1484 viewer_index.status = htobe32(LTTNG_VIEWER_INDEX_ERR);
1485 goto send_reply;
1486 } else {
1487 viewer_index.status = htobe32(LTTNG_VIEWER_INDEX_OK);
1488 vstream->index_sent_seqcount++;
1489 }
1490
1491 /*
1492 * Indexes are stored in big endian, no need to switch before sending.
1493 */
1494 DBG("Sending viewer index for stream %" PRIu64 " offset %" PRIu64,
1495 rstream->stream_handle,
1496 (uint64_t) be64toh(packet_index.offset));
1497 viewer_index.offset = packet_index.offset;
1498 viewer_index.packet_size = packet_index.packet_size;
1499 viewer_index.content_size = packet_index.content_size;
1500 viewer_index.timestamp_begin = packet_index.timestamp_begin;
1501 viewer_index.timestamp_end = packet_index.timestamp_end;
1502 viewer_index.events_discarded = packet_index.events_discarded;
1503 viewer_index.stream_id = packet_index.stream_id;
1504
1505 send_reply:
1506 if (rstream) {
1507 pthread_mutex_unlock(&rstream->lock);
1508 }
1509
1510 if (metadata_viewer_stream) {
1511 pthread_mutex_lock(&metadata_viewer_stream->stream->lock);
1512 DBG("get next index metadata check: recv %" PRIu64
1513 " sent %" PRIu64,
1514 metadata_viewer_stream->stream->metadata_received,
1515 metadata_viewer_stream->metadata_sent);
1516 if (!metadata_viewer_stream->stream->metadata_received ||
1517 metadata_viewer_stream->stream->metadata_received >
1518 metadata_viewer_stream->metadata_sent) {
1519 viewer_index.flags |= LTTNG_VIEWER_FLAG_NEW_METADATA;
1520 }
1521 pthread_mutex_unlock(&metadata_viewer_stream->stream->lock);
1522 }
1523
1524 viewer_index.flags = htobe32(viewer_index.flags);
1525 health_code_update();
1526
1527 ret = send_response(conn->sock, &viewer_index, sizeof(viewer_index));
1528 if (ret < 0) {
1529 goto end;
1530 }
1531 health_code_update();
1532
1533 if (vstream) {
1534 DBG("Index %" PRIu64 " for stream %" PRIu64 " sent",
1535 vstream->index_sent_seqcount,
1536 vstream->stream->stream_handle);
1537 }
1538 end:
1539 if (metadata_viewer_stream) {
1540 viewer_stream_put(metadata_viewer_stream);
1541 }
1542 if (vstream) {
1543 viewer_stream_put(vstream);
1544 }
1545 return ret;
1546
1547 error_put:
1548 pthread_mutex_unlock(&rstream->lock);
1549 if (metadata_viewer_stream) {
1550 viewer_stream_put(metadata_viewer_stream);
1551 }
1552 viewer_stream_put(vstream);
1553 return ret;
1554 }
1555
1556 /*
1557 * Send the next index for a stream
1558 *
1559 * Return 0 on success or else a negative value.
1560 */
1561 static
1562 int viewer_get_packet(struct relay_connection *conn)
1563 {
1564 int ret;
1565 off_t lseek_ret;
1566 char *reply = NULL;
1567 struct lttng_viewer_get_packet get_packet_info;
1568 struct lttng_viewer_trace_packet reply_header;
1569 struct relay_viewer_stream *vstream = NULL;
1570 uint32_t reply_size = sizeof(reply_header);
1571 uint32_t packet_data_len = 0;
1572 ssize_t read_len;
1573
1574 DBG2("Relay get data packet");
1575
1576 health_code_update();
1577
1578 ret = recv_request(conn->sock, &get_packet_info,
1579 sizeof(get_packet_info));
1580 if (ret < 0) {
1581 goto end;
1582 }
1583 health_code_update();
1584
1585 /* From this point on, the error label can be reached. */
1586 memset(&reply_header, 0, sizeof(reply_header));
1587
1588 vstream = viewer_stream_get_by_id(be64toh(get_packet_info.stream_id));
1589 if (!vstream) {
1590 DBG("Client requested packet of unknown stream id %" PRIu64,
1591 (uint64_t) be64toh(get_packet_info.stream_id));
1592 reply_header.status = htobe32(LTTNG_VIEWER_GET_PACKET_ERR);
1593 goto send_reply_nolock;
1594 } else {
1595 packet_data_len = be32toh(get_packet_info.len);
1596 reply_size += packet_data_len;
1597 }
1598
1599 reply = zmalloc(reply_size);
1600 if (!reply) {
1601 PERROR("packet reply zmalloc");
1602 reply_size = sizeof(reply_header);
1603 goto error;
1604 }
1605
1606 pthread_mutex_lock(&vstream->stream->lock);
1607 lseek_ret = lseek(vstream->stream_fd->fd, be64toh(get_packet_info.offset),
1608 SEEK_SET);
1609 if (lseek_ret < 0) {
1610 PERROR("lseek fd %d to offset %" PRIu64, vstream->stream_fd->fd,
1611 (uint64_t) be64toh(get_packet_info.offset));
1612 goto error;
1613 }
1614 read_len = lttng_read(vstream->stream_fd->fd,
1615 reply + sizeof(reply_header),
1616 packet_data_len);
1617 if (read_len < packet_data_len) {
1618 PERROR("Relay reading trace file, fd: %d, offset: %" PRIu64,
1619 vstream->stream_fd->fd,
1620 (uint64_t) be64toh(get_packet_info.offset));
1621 goto error;
1622 }
1623 reply_header.status = htobe32(LTTNG_VIEWER_GET_PACKET_OK);
1624 reply_header.len = htobe32(packet_data_len);
1625 goto send_reply;
1626
1627 error:
1628 reply_header.status = htobe32(LTTNG_VIEWER_GET_PACKET_ERR);
1629
1630 send_reply:
1631 if (vstream) {
1632 pthread_mutex_unlock(&vstream->stream->lock);
1633 }
1634 send_reply_nolock:
1635
1636 health_code_update();
1637
1638 if (reply) {
1639 memcpy(reply, &reply_header, sizeof(reply_header));
1640 ret = send_response(conn->sock, reply, reply_size);
1641 } else {
1642 /* No reply to send. */
1643 ret = send_response(conn->sock, &reply_header,
1644 reply_size);
1645 }
1646
1647 health_code_update();
1648 if (ret < 0) {
1649 PERROR("sendmsg of packet data failed");
1650 goto end_free;
1651 }
1652
1653 DBG("Sent %u bytes for stream %" PRIu64, reply_size,
1654 (uint64_t) be64toh(get_packet_info.stream_id));
1655
1656 end_free:
1657 free(reply);
1658 end:
1659 if (vstream) {
1660 viewer_stream_put(vstream);
1661 }
1662 return ret;
1663 }
1664
1665 /*
1666 * Send the session's metadata
1667 *
1668 * Return 0 on success else a negative value.
1669 */
1670 static
1671 int viewer_get_metadata(struct relay_connection *conn)
1672 {
1673 int ret = 0;
1674 ssize_t read_len;
1675 uint64_t len = 0;
1676 char *data = NULL;
1677 struct lttng_viewer_get_metadata request;
1678 struct lttng_viewer_metadata_packet reply;
1679 struct relay_viewer_stream *vstream = NULL;
1680
1681 assert(conn);
1682
1683 DBG("Relay get metadata");
1684
1685 health_code_update();
1686
1687 ret = recv_request(conn->sock, &request, sizeof(request));
1688 if (ret < 0) {
1689 goto end;
1690 }
1691 health_code_update();
1692
1693 memset(&reply, 0, sizeof(reply));
1694
1695 vstream = viewer_stream_get_by_id(be64toh(request.stream_id));
1696 if (!vstream) {
1697 /*
1698 * The metadata stream can be closed by a CLOSE command
1699 * just before we attach. It can also be closed by
1700 * per-pid tracing during tracing. Therefore, it is
1701 * possible that we cannot find this viewer stream.
1702 * Reply back to the client with an error if we cannot
1703 * find it.
1704 */
1705 DBG("Client requested metadata of unknown stream id %" PRIu64,
1706 (uint64_t) be64toh(request.stream_id));
1707 reply.status = htobe32(LTTNG_VIEWER_METADATA_ERR);
1708 goto send_reply;
1709 }
1710 pthread_mutex_lock(&vstream->stream->lock);
1711 if (!vstream->stream->is_metadata) {
1712 ERR("Invalid metadata stream");
1713 goto error;
1714 }
1715
1716 assert(vstream->metadata_sent <= vstream->stream->metadata_received);
1717
1718 len = vstream->stream->metadata_received - vstream->metadata_sent;
1719 if (len == 0) {
1720 reply.status = htobe32(LTTNG_VIEWER_NO_NEW_METADATA);
1721 goto send_reply;
1722 }
1723
1724 /* first time, we open the metadata file */
1725 if (!vstream->stream_fd) {
1726 char fullpath[PATH_MAX];
1727
1728 ret = snprintf(fullpath, PATH_MAX, "%s/%s", vstream->path_name,
1729 vstream->channel_name);
1730 if (ret < 0) {
1731 goto error;
1732 }
1733 ret = open(fullpath, O_RDONLY);
1734 if (ret < 0) {
1735 PERROR("Relay opening metadata file");
1736 goto error;
1737 }
1738 vstream->stream_fd = stream_fd_create(ret);
1739 if (!vstream->stream_fd) {
1740 if (close(ret)) {
1741 PERROR("close");
1742 }
1743 goto error;
1744 }
1745 }
1746
1747 reply.len = htobe64(len);
1748 data = zmalloc(len);
1749 if (!data) {
1750 PERROR("viewer metadata zmalloc");
1751 goto error;
1752 }
1753
1754 read_len = lttng_read(vstream->stream_fd->fd, data, len);
1755 if (read_len < len) {
1756 PERROR("Relay reading metadata file");
1757 goto error;
1758 }
1759 vstream->metadata_sent += read_len;
1760 if (vstream->metadata_sent == vstream->stream->metadata_received
1761 && vstream->stream->closed) {
1762 /* Release ownership for the viewer metadata stream. */
1763 viewer_stream_put(vstream);
1764 }
1765
1766 reply.status = htobe32(LTTNG_VIEWER_METADATA_OK);
1767
1768 goto send_reply;
1769
1770 error:
1771 reply.status = htobe32(LTTNG_VIEWER_METADATA_ERR);
1772
1773 send_reply:
1774 health_code_update();
1775 if (vstream) {
1776 pthread_mutex_unlock(&vstream->stream->lock);
1777 }
1778 ret = send_response(conn->sock, &reply, sizeof(reply));
1779 if (ret < 0) {
1780 goto end_free;
1781 }
1782 health_code_update();
1783
1784 if (len > 0) {
1785 ret = send_response(conn->sock, data, len);
1786 if (ret < 0) {
1787 goto end_free;
1788 }
1789 }
1790
1791 DBG("Sent %" PRIu64 " bytes of metadata for stream %" PRIu64, len,
1792 (uint64_t) be64toh(request.stream_id));
1793
1794 DBG("Metadata sent");
1795
1796 end_free:
1797 free(data);
1798 end:
1799 if (vstream) {
1800 viewer_stream_put(vstream);
1801 }
1802 return ret;
1803 }
1804
1805 /*
1806 * Create a viewer session.
1807 *
1808 * Return 0 on success or else a negative value.
1809 */
1810 static
1811 int viewer_create_session(struct relay_connection *conn)
1812 {
1813 int ret;
1814 struct lttng_viewer_create_session_response resp;
1815
1816 DBG("Viewer create session received");
1817
1818 memset(&resp, 0, sizeof(resp));
1819 resp.status = htobe32(LTTNG_VIEWER_CREATE_SESSION_OK);
1820 conn->viewer_session = viewer_session_create();
1821 if (!conn->viewer_session) {
1822 ERR("Allocation viewer session");
1823 resp.status = htobe32(LTTNG_VIEWER_CREATE_SESSION_ERR);
1824 goto send_reply;
1825 }
1826
1827 send_reply:
1828 health_code_update();
1829 ret = send_response(conn->sock, &resp, sizeof(resp));
1830 if (ret < 0) {
1831 goto end;
1832 }
1833 health_code_update();
1834 ret = 0;
1835
1836 end:
1837 return ret;
1838 }
1839
1840 /*
1841 * Detach a viewer session.
1842 *
1843 * Return 0 on success or else a negative value.
1844 */
1845 static
1846 int viewer_detach_session(struct relay_connection *conn)
1847 {
1848 int ret;
1849 struct lttng_viewer_detach_session_response response;
1850 struct lttng_viewer_detach_session_request request;
1851 struct relay_session *session = NULL;
1852 uint64_t viewer_session_to_close;
1853
1854 DBG("Viewer detach session received");
1855
1856 assert(conn);
1857
1858 health_code_update();
1859
1860 /* Receive the request from the connected client. */
1861 ret = recv_request(conn->sock, &request, sizeof(request));
1862 if (ret < 0) {
1863 goto end;
1864 }
1865 viewer_session_to_close = be64toh(request.session_id);
1866
1867 if (!conn->viewer_session) {
1868 DBG("Client trying to detach before creating a live viewer session");
1869 response.status = htobe32(LTTNG_VIEWER_DETACH_SESSION_ERR);
1870 goto send_reply;
1871 }
1872
1873 health_code_update();
1874
1875 memset(&response, 0, sizeof(response));
1876 DBG("Detaching from session ID %" PRIu64, viewer_session_to_close);
1877
1878 session = session_get_by_id(be64toh(request.session_id));
1879 if (!session) {
1880 DBG("Relay session %" PRIu64 " not found",
1881 (uint64_t) be64toh(request.session_id));
1882 response.status = htobe32(LTTNG_VIEWER_DETACH_SESSION_UNK);
1883 goto send_reply;
1884 }
1885
1886 ret = viewer_session_is_attached(conn->viewer_session, session);
1887 if (ret != 1) {
1888 DBG("Not attached to this session");
1889 response.status = htobe32(LTTNG_VIEWER_DETACH_SESSION_ERR);
1890 goto send_reply_put;
1891 }
1892
1893 viewer_session_close_one_session(conn->viewer_session, session);
1894 response.status = htobe32(LTTNG_VIEWER_DETACH_SESSION_OK);
1895 DBG("Session %" PRIu64 " detached.", viewer_session_to_close);
1896
1897 send_reply_put:
1898 session_put(session);
1899
1900 send_reply:
1901 health_code_update();
1902 ret = send_response(conn->sock, &response, sizeof(response));
1903 if (ret < 0) {
1904 goto end;
1905 }
1906 health_code_update();
1907 ret = 0;
1908
1909 end:
1910 return ret;
1911 }
1912
1913 /*
1914 * live_relay_unknown_command: send -1 if received unknown command
1915 */
1916 static
1917 void live_relay_unknown_command(struct relay_connection *conn)
1918 {
1919 struct lttcomm_relayd_generic_reply reply;
1920
1921 memset(&reply, 0, sizeof(reply));
1922 reply.ret_code = htobe32(LTTNG_ERR_UNK);
1923 (void) send_response(conn->sock, &reply, sizeof(reply));
1924 }
1925
1926 /*
1927 * Process the commands received on the control socket
1928 */
1929 static
1930 int process_control(struct lttng_viewer_cmd *recv_hdr,
1931 struct relay_connection *conn)
1932 {
1933 int ret = 0;
1934 uint32_t msg_value;
1935
1936 msg_value = be32toh(recv_hdr->cmd);
1937
1938 /*
1939 * Make sure we've done the version check before any command other then a
1940 * new client connection.
1941 */
1942 if (msg_value != LTTNG_VIEWER_CONNECT && !conn->version_check_done) {
1943 ERR("Viewer conn value %" PRIu32 " before version check", msg_value);
1944 ret = -1;
1945 goto end;
1946 }
1947
1948 switch (msg_value) {
1949 case LTTNG_VIEWER_CONNECT:
1950 ret = viewer_connect(conn);
1951 break;
1952 case LTTNG_VIEWER_LIST_SESSIONS:
1953 ret = viewer_list_sessions(conn);
1954 break;
1955 case LTTNG_VIEWER_ATTACH_SESSION:
1956 ret = viewer_attach_session(conn);
1957 break;
1958 case LTTNG_VIEWER_GET_NEXT_INDEX:
1959 ret = viewer_get_next_index(conn);
1960 break;
1961 case LTTNG_VIEWER_GET_PACKET:
1962 ret = viewer_get_packet(conn);
1963 break;
1964 case LTTNG_VIEWER_GET_METADATA:
1965 ret = viewer_get_metadata(conn);
1966 break;
1967 case LTTNG_VIEWER_GET_NEW_STREAMS:
1968 ret = viewer_get_new_streams(conn);
1969 break;
1970 case LTTNG_VIEWER_CREATE_SESSION:
1971 ret = viewer_create_session(conn);
1972 break;
1973 case LTTNG_VIEWER_DETACH_SESSION:
1974 ret = viewer_detach_session(conn);
1975 break;
1976 default:
1977 ERR("Received unknown viewer command (%u)",
1978 be32toh(recv_hdr->cmd));
1979 live_relay_unknown_command(conn);
1980 ret = -1;
1981 goto end;
1982 }
1983
1984 end:
1985 return ret;
1986 }
1987
1988 static
1989 void cleanup_connection_pollfd(struct lttng_poll_event *events, int pollfd)
1990 {
1991 int ret;
1992
1993 (void) lttng_poll_del(events, pollfd);
1994
1995 ret = fd_tracker_close_unsuspendable_fd(the_fd_tracker, &pollfd, 1,
1996 fd_tracker_util_close_fd, NULL);
1997 if (ret < 0) {
1998 ERR("Closing pollfd %d", pollfd);
1999 }
2000 }
2001
2002 /*
2003 * This thread does the actual work
2004 */
2005 static
2006 void *thread_worker(void *data)
2007 {
2008 int ret, err = -1;
2009 uint32_t nb_fd;
2010 struct lttng_poll_event events;
2011 struct lttng_ht *viewer_connections_ht;
2012 struct lttng_ht_iter iter;
2013 struct lttng_viewer_cmd recv_hdr;
2014 struct relay_connection *destroy_conn;
2015
2016 DBG("[thread] Live viewer relay worker started");
2017
2018 rcu_register_thread();
2019
2020 health_register(health_relayd, HEALTH_RELAYD_TYPE_LIVE_WORKER);
2021
2022 if (testpoint(relayd_thread_live_worker)) {
2023 goto error_testpoint;
2024 }
2025
2026 /* table of connections indexed on socket */
2027 viewer_connections_ht = lttng_ht_new(0, LTTNG_HT_TYPE_ULONG);
2028 if (!viewer_connections_ht) {
2029 goto viewer_connections_ht_error;
2030 }
2031
2032 ret = create_named_thread_poll_set(&events, 2,
2033 "Live viewer worker thread epoll");
2034 if (ret < 0) {
2035 goto error_poll_create;
2036 }
2037
2038 ret = lttng_poll_add(&events, live_conn_pipe[0], LPOLLIN | LPOLLRDHUP);
2039 if (ret < 0) {
2040 goto error;
2041 }
2042
2043 restart:
2044 while (1) {
2045 int i;
2046
2047 health_code_update();
2048
2049 /* Infinite blocking call, waiting for transmission */
2050 DBG3("Relayd live viewer worker thread polling...");
2051 health_poll_entry();
2052 ret = lttng_poll_wait(&events, -1);
2053 health_poll_exit();
2054 if (ret < 0) {
2055 /*
2056 * Restart interrupted system call.
2057 */
2058 if (errno == EINTR) {
2059 goto restart;
2060 }
2061 goto error;
2062 }
2063
2064 nb_fd = ret;
2065
2066 /*
2067 * Process control. The control connection is prioritised so we don't
2068 * starve it with high throughput tracing data on the data
2069 * connection.
2070 */
2071 for (i = 0; i < nb_fd; i++) {
2072 /* Fetch once the poll data */
2073 uint32_t revents = LTTNG_POLL_GETEV(&events, i);
2074 int pollfd = LTTNG_POLL_GETFD(&events, i);
2075
2076 health_code_update();
2077
2078 if (!revents) {
2079 /* No activity for this FD (poll implementation). */
2080 continue;
2081 }
2082
2083 /* Thread quit pipe has been closed. Killing thread. */
2084 ret = check_thread_quit_pipe(pollfd, revents);
2085 if (ret) {
2086 err = 0;
2087 goto exit;
2088 }
2089
2090 /* Inspect the relay conn pipe for new connection. */
2091 if (pollfd == live_conn_pipe[0]) {
2092 if (revents & LPOLLIN) {
2093 struct relay_connection *conn;
2094
2095 ret = lttng_read(live_conn_pipe[0],
2096 &conn, sizeof(conn));
2097 if (ret < 0) {
2098 goto error;
2099 }
2100 lttng_poll_add(&events, conn->sock->fd,
2101 LPOLLIN | LPOLLRDHUP);
2102 connection_ht_add(viewer_connections_ht, conn);
2103 DBG("Connection socket %d added to poll", conn->sock->fd);
2104 } else if (revents & (LPOLLERR | LPOLLHUP | LPOLLRDHUP)) {
2105 ERR("Relay live pipe error");
2106 goto error;
2107 } else {
2108 ERR("Unexpected poll events %u for sock %d", revents, pollfd);
2109 goto error;
2110 }
2111 } else {
2112 /* Connection activity. */
2113 struct relay_connection *conn;
2114
2115 conn = connection_get_by_sock(viewer_connections_ht, pollfd);
2116 if (!conn) {
2117 continue;
2118 }
2119
2120 if (revents & LPOLLIN) {
2121 ret = conn->sock->ops->recvmsg(conn->sock, &recv_hdr,
2122 sizeof(recv_hdr), 0);
2123 if (ret <= 0) {
2124 /* Connection closed. */
2125 cleanup_connection_pollfd(&events, pollfd);
2126 /* Put "create" ownership reference. */
2127 connection_put(conn);
2128 DBG("Viewer control conn closed with %d", pollfd);
2129 } else {
2130 ret = process_control(&recv_hdr, conn);
2131 if (ret < 0) {
2132 /* Clear the session on error. */
2133 cleanup_connection_pollfd(&events, pollfd);
2134 /* Put "create" ownership reference. */
2135 connection_put(conn);
2136 DBG("Viewer connection closed with %d", pollfd);
2137 }
2138 }
2139 } else if (revents & (LPOLLERR | LPOLLHUP | LPOLLRDHUP)) {
2140 cleanup_connection_pollfd(&events, pollfd);
2141 /* Put "create" ownership reference. */
2142 connection_put(conn);
2143 } else {
2144 ERR("Unexpected poll events %u for sock %d", revents, pollfd);
2145 connection_put(conn);
2146 goto error;
2147 }
2148 /* Put local "get_by_sock" reference. */
2149 connection_put(conn);
2150 }
2151 }
2152 }
2153
2154 exit:
2155 error:
2156 (void) fd_tracker_util_poll_clean(the_fd_tracker, &events);
2157
2158 /* Cleanup reamaining connection object. */
2159 rcu_read_lock();
2160 cds_lfht_for_each_entry(viewer_connections_ht->ht, &iter.iter,
2161 destroy_conn,
2162 sock_n.node) {
2163 health_code_update();
2164 connection_put(destroy_conn);
2165 }
2166 rcu_read_unlock();
2167 error_poll_create:
2168 lttng_ht_destroy(viewer_connections_ht);
2169 viewer_connections_ht_error:
2170 /* Close relay conn pipes */
2171 (void) fd_tracker_util_pipe_close(the_fd_tracker, live_conn_pipe);
2172 if (err) {
2173 DBG("Viewer worker thread exited with error");
2174 }
2175 DBG("Viewer worker thread cleanup complete");
2176 error_testpoint:
2177 if (err) {
2178 health_error();
2179 ERR("Health error occurred in %s", __func__);
2180 }
2181 health_unregister(health_relayd);
2182 if (lttng_relay_stop_threads()) {
2183 ERR("Error stopping threads");
2184 }
2185 rcu_unregister_thread();
2186 return NULL;
2187 }
2188
2189 /*
2190 * Create the relay command pipe to wake thread_manage_apps.
2191 * Closed in cleanup().
2192 */
2193 static int create_conn_pipe(void)
2194 {
2195 return fd_tracker_util_pipe_open_cloexec(the_fd_tracker,
2196 "Live connection pipe", live_conn_pipe);
2197 }
2198
2199 int relayd_live_join(void)
2200 {
2201 int ret, retval = 0;
2202 void *status;
2203
2204 ret = pthread_join(live_listener_thread, &status);
2205 if (ret) {
2206 errno = ret;
2207 PERROR("pthread_join live listener");
2208 retval = -1;
2209 }
2210
2211 ret = pthread_join(live_worker_thread, &status);
2212 if (ret) {
2213 errno = ret;
2214 PERROR("pthread_join live worker");
2215 retval = -1;
2216 }
2217
2218 ret = pthread_join(live_dispatcher_thread, &status);
2219 if (ret) {
2220 errno = ret;
2221 PERROR("pthread_join live dispatcher");
2222 retval = -1;
2223 }
2224
2225 cleanup_relayd_live();
2226
2227 return retval;
2228 }
2229
2230 /*
2231 * main
2232 */
2233 int relayd_live_create(struct lttng_uri *uri)
2234 {
2235 int ret = 0, retval = 0;
2236 void *status;
2237 int is_root;
2238
2239 if (!uri) {
2240 retval = -1;
2241 goto exit_init_data;
2242 }
2243 live_uri = uri;
2244
2245 /* Check if daemon is UID = 0 */
2246 is_root = !getuid();
2247
2248 if (!is_root) {
2249 if (live_uri->port < 1024) {
2250 ERR("Need to be root to use ports < 1024");
2251 retval = -1;
2252 goto exit_init_data;
2253 }
2254 }
2255
2256 /* Setup the thread apps communication pipe. */
2257 if (create_conn_pipe()) {
2258 retval = -1;
2259 goto exit_init_data;
2260 }
2261
2262 /* Init relay command queue. */
2263 cds_wfcq_init(&viewer_conn_queue.head, &viewer_conn_queue.tail);
2264
2265 /* Set up max poll set size */
2266 if (lttng_poll_set_max_size()) {
2267 retval = -1;
2268 goto exit_init_data;
2269 }
2270
2271 /* Setup the dispatcher thread */
2272 ret = pthread_create(&live_dispatcher_thread, default_pthread_attr(),
2273 thread_dispatcher, (void *) NULL);
2274 if (ret) {
2275 errno = ret;
2276 PERROR("pthread_create viewer dispatcher");
2277 retval = -1;
2278 goto exit_dispatcher_thread;
2279 }
2280
2281 /* Setup the worker thread */
2282 ret = pthread_create(&live_worker_thread, default_pthread_attr(),
2283 thread_worker, NULL);
2284 if (ret) {
2285 errno = ret;
2286 PERROR("pthread_create viewer worker");
2287 retval = -1;
2288 goto exit_worker_thread;
2289 }
2290
2291 /* Setup the listener thread */
2292 ret = pthread_create(&live_listener_thread, default_pthread_attr(),
2293 thread_listener, (void *) NULL);
2294 if (ret) {
2295 errno = ret;
2296 PERROR("pthread_create viewer listener");
2297 retval = -1;
2298 goto exit_listener_thread;
2299 }
2300
2301 /*
2302 * All OK, started all threads.
2303 */
2304 return retval;
2305
2306 /*
2307 * Join on the live_listener_thread should anything be added after
2308 * the live_listener thread's creation.
2309 */
2310
2311 exit_listener_thread:
2312
2313 ret = pthread_join(live_worker_thread, &status);
2314 if (ret) {
2315 errno = ret;
2316 PERROR("pthread_join live worker");
2317 retval = -1;
2318 }
2319 exit_worker_thread:
2320
2321 ret = pthread_join(live_dispatcher_thread, &status);
2322 if (ret) {
2323 errno = ret;
2324 PERROR("pthread_join live dispatcher");
2325 retval = -1;
2326 }
2327 exit_dispatcher_thread:
2328
2329 exit_init_data:
2330 cleanup_relayd_live();
2331
2332 return retval;
2333 }
This page took 0.085544 seconds and 5 git commands to generate.