formats/lttng-live/lttng-live.h

   1 #ifndef _LTTNG_LIVE_H
   2 #define _LTTNG_LIVE_H
   3
   4 /*
   5  * Copyright 2013 Julien Desfossez <julien.desfossez@efficios.com>
   6  *                Mathieu Desnoyers <mathieu.desnoyers@efficios.com>
   7  *
   8  * Permission is hereby granted, free of charge, to any person obtaining a copy
   9  * of this software and associated documentation files (the "Software"), to deal
  10  * in the Software without restriction, including without limitation the rights
  11  * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
  12  * copies of the Software, and to permit persons to whom the Software is
  13  * furnished to do so, subject to the following conditions:
  14  *
  15  * The above copyright notice and this permission notice shall be included in
  16  * all copies or substantial portions of the Software.
  17  *
  18  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  19  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  20  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
  21  * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  22  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
  23  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  24  * SOFTWARE.
  25  */
  26
  27 #include <stdint.h>
  28 #include "lttng-viewer-abi.h"
  29
  30 #define LTTNG_DEFAULT_NETWORK_VIEWER_PORT       5344
  31
  32 #define LTTNG_LIVE_MAJOR                        2
  33 #define LTTNG_LIVE_MINOR                        4
  34
  35 /*
  36  * The lttng-live output file pointer is currently hardcoded to stdout,
  37  * and is expected to be hardcoded to this by fflush() performed between
  38  * each packet.
  39  */
  40 #define LTTNG_LIVE_OUTPUT_FP                    stdout
  41
  42 struct lttng_live_ctx {
  43         char traced_hostname[MAXNAMLEN];
  44         char session_name[MAXNAMLEN];
  45         char relay_hostname[MAXNAMLEN];
  46         int control_sock;
  47         int port;
  48         /* Protocol version to use for this connection. */
  49         uint32_t major;
  50         uint32_t minor;
  51         struct lttng_live_session *session;
  52         struct bt_context *bt_ctx;
  53         GArray *session_ids;
  54 };
  55
  56 struct lttng_live_viewer_stream {
  57         uint64_t id;
  58         uint64_t mmap_size;
  59         uint64_t ctf_stream_id;
  60         FILE *metadata_fp_write;
  61         ssize_t metadata_len;
  62         int metadata_flag;
  63         int data_pending;
  64         struct lttng_live_session *session;
  65         struct lttng_live_ctf_trace *ctf_trace;
  66         struct lttng_viewer_index current_index;
  67         char path[PATH_MAX];
  68 };
  69
  70 struct lttng_live_session {
  71         uint64_t live_timer_interval;
  72         uint64_t stream_count;
  73         struct lttng_live_ctx *ctx;
  74         struct lttng_live_viewer_stream *streams;
  75         GHashTable *ctf_traces;
  76 };
  77
  78 struct lttng_live_ctf_trace {
  79         uint64_t ctf_trace_id;
  80         struct lttng_live_viewer_stream *metadata_stream;
  81         GPtrArray *streams;
  82         FILE *metadata_fp;
  83         struct bt_trace_handle *handle;
  84         int trace_id;
  85         int in_use;
  86 };
  87
  88 /* Just used in listing. */
  89 struct lttng_live_relay_session {
  90         uint32_t streams;
  91         uint32_t clients;
  92         uint32_t timer;
  93         char *name;
  94         char *hostname;
  95 };
  96
  97 int lttng_live_connect_viewer(struct lttng_live_ctx *ctx);
  98 int lttng_live_establish_connection(struct lttng_live_ctx *ctx);
  99 int lttng_live_list_sessions(struct lttng_live_ctx *ctx, const char *path);
 100 int lttng_live_attach_session(struct lttng_live_ctx *ctx, uint64_t id);
 101 int lttng_live_read(struct lttng_live_ctx *ctx);
 102 int lttng_live_get_new_streams(struct lttng_live_ctx *ctx, uint64_t id);
 103 int lttng_live_should_quit(void);
 104
 105 #endif /* _LTTNG_LIVE_H */