src/common/relayd/relayd.h

   1 /*
   2  * Copyright (C) 2012 - David Goulet <dgoulet@efficios.com>
   3  *
   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.
   7  *
   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
  11  * more details.
  12  *
  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.
  16  */
  17
  18 #ifndef _RELAYD_H
  19 #define _RELAYD_H
  20
  21 #include <unistd.h>
  22 #include <stdbool.h>
  23
  24 #include <common/sessiond-comm/relayd.h>
  25 #include <common/sessiond-comm/sessiond-comm.h>
  26 #include <common/trace-chunk.h>
  27 #include <common/dynamic-array.h>
  28
  29 struct relayd_stream_rotation_position {
  30         uint64_t stream_id;
  31         /*
  32          * Sequence number of the first packet belonging to the new
  33          * "destination" trace chunk to which the stream is rotating.
  34          *
  35          * Ignored for metadata streams.
  36          */
  37         uint64_t rotate_at_seq_num;
  38 };
  39
  40 int relayd_connect(struct lttcomm_relayd_sock *sock);
  41 int relayd_close(struct lttcomm_relayd_sock *sock);
  42 int relayd_create_session(struct lttcomm_relayd_sock *rsock,
  43                 uint64_t *relayd_session_id,
  44                 const char *session_name, const char *hostname,
  45                 const char *base_path, int session_live_timer,
  46                 unsigned int snapshot, uint64_t sessiond_session_id,
  47                 const lttng_uuid sessiond_uuid,
  48                 const uint64_t *current_chunk_id,
  49                 time_t creation_time, bool session_name_contains_creation_time,
  50                 char *output_path);
  51 int relayd_add_stream(struct lttcomm_relayd_sock *sock, const char *channel_name,
  52                 const char *pathname, uint64_t *stream_id,
  53                 uint64_t tracefile_size, uint64_t tracefile_count,
  54                 struct lttng_trace_chunk *trace_chunk);
  55 int relayd_streams_sent(struct lttcomm_relayd_sock *rsock);
  56 int relayd_send_close_stream(struct lttcomm_relayd_sock *sock, uint64_t stream_id,
  57                 uint64_t last_net_seq_num);
  58 int relayd_version_check(struct lttcomm_relayd_sock *sock);
  59 int relayd_start_data(struct lttcomm_relayd_sock *sock);
  60 int relayd_send_metadata(struct lttcomm_relayd_sock *sock, size_t len);
  61 int relayd_send_data_hdr(struct lttcomm_relayd_sock *sock,
  62                 struct lttcomm_relayd_data_hdr *hdr, size_t size);
  63 int relayd_data_pending(struct lttcomm_relayd_sock *sock, uint64_t stream_id,
  64                 uint64_t last_net_seq_num);
  65 int relayd_quiescent_control(struct lttcomm_relayd_sock *sock,
  66                 uint64_t metadata_stream_id);
  67 int relayd_begin_data_pending(struct lttcomm_relayd_sock *sock, uint64_t id);
  68 int relayd_end_data_pending(struct lttcomm_relayd_sock *sock, uint64_t id,
  69                 unsigned int *is_data_inflight);
  70 int relayd_send_index(struct lttcomm_relayd_sock *rsock,
  71                 struct ctf_packet_index *index, uint64_t relay_stream_id,
  72                 uint64_t net_seq_num);
  73 int relayd_reset_metadata(struct lttcomm_relayd_sock *rsock,
  74                 uint64_t stream_id, uint64_t version);
  75 /* `positions` is an array of `stream_count` relayd_stream_rotation_position. */
  76 int relayd_rotate_streams(struct lttcomm_relayd_sock *sock,
  77                 unsigned int stream_count, const uint64_t *new_chunk_id,
  78                 const struct relayd_stream_rotation_position *positions);
  79 int relayd_create_trace_chunk(struct lttcomm_relayd_sock *sock,
  80                 struct lttng_trace_chunk *chunk);
  81 int relayd_close_trace_chunk(struct lttcomm_relayd_sock *sock,
  82                 struct lttng_trace_chunk *chunk,
  83                 char *path);
  84 int relayd_trace_chunk_exists(struct lttcomm_relayd_sock *sock,
  85                 uint64_t chunk_id, bool *chunk_exists);
  86
  87 #endif /* _RELAYD_H */