Fix: relayd: wrong stream type used in DBG statement
[lttng-tools.git] / src / bin / lttng-relayd / lttng-viewer-abi.h
CommitLineData
1e26e04e
JD
1#ifndef LTTNG_VIEWER_ABI_H
2#define LTTNG_VIEWER_ABI_H
ddea0ada 3
d3e2ba59 4/*
ab5be9fa
MJ
5 * Copyright (C) 2013 Julien Desfossez <jdesfossez@efficios.com>
6 * Copyright (C) 2013 Mathieu Desnoyers <mathieu.desnoyers@efficios.com>
7 * Copyright (C) 2013 David Goulet <dgoulet@efficios.com>
d3e2ba59 8 *
ab5be9fa 9 * SPDX-License-Identifier: MIT
d3e2ba59 10 *
d3e2ba59
JD
11 */
12
d3e2ba59 13#include <limits.h>
62d07d1c 14#include <common/macros.h>
d3e2ba59
JD
15
16#define LTTNG_VIEWER_PATH_MAX 4096
17#define LTTNG_VIEWER_NAME_MAX 255
c4e361a4 18#define LTTNG_VIEWER_HOST_NAME_MAX 64
d3e2ba59
JD
19
20/* Flags in reply to get_next_index and get_packet. */
c4e361a4
JD
21enum {
22 /* New metadata is required to read this packet. */
23 LTTNG_VIEWER_FLAG_NEW_METADATA = (1 << 0),
24 /* New stream got added to the trace. */
25 LTTNG_VIEWER_FLAG_NEW_STREAM = (1 << 1),
26};
d3e2ba59
JD
27
28enum lttng_viewer_command {
c4e361a4
JD
29 LTTNG_VIEWER_CONNECT = 1,
30 LTTNG_VIEWER_LIST_SESSIONS = 2,
31 LTTNG_VIEWER_ATTACH_SESSION = 3,
32 LTTNG_VIEWER_GET_NEXT_INDEX = 4,
33 LTTNG_VIEWER_GET_PACKET = 5,
34 LTTNG_VIEWER_GET_METADATA = 6,
35 LTTNG_VIEWER_GET_NEW_STREAMS = 7,
c3b7390b 36 LTTNG_VIEWER_CREATE_SESSION = 8,
d62023be 37 LTTNG_VIEWER_DETACH_SESSION = 9,
d3e2ba59
JD
38};
39
40enum lttng_viewer_attach_return_code {
c4e361a4
JD
41 LTTNG_VIEWER_ATTACH_OK = 1, /* The attach command succeeded. */
42 LTTNG_VIEWER_ATTACH_ALREADY = 2, /* A viewer is already attached. */
43 LTTNG_VIEWER_ATTACH_UNK = 3, /* The session ID is unknown. */
44 LTTNG_VIEWER_ATTACH_NOT_LIVE = 4, /* The session is not live. */
45 LTTNG_VIEWER_ATTACH_SEEK_ERR = 5, /* Seek error. */
c3b7390b 46 LTTNG_VIEWER_ATTACH_NO_SESSION = 6, /* No viewer session created. */
d3e2ba59
JD
47};
48
49enum lttng_viewer_next_index_return_code {
c4e361a4
JD
50 LTTNG_VIEWER_INDEX_OK = 1, /* Index is available. */
51 LTTNG_VIEWER_INDEX_RETRY = 2, /* Index not yet available. */
52 LTTNG_VIEWER_INDEX_HUP = 3, /* Index closed (trace destroyed). */
53 LTTNG_VIEWER_INDEX_ERR = 4, /* Unknow error. */
54 LTTNG_VIEWER_INDEX_INACTIVE = 5, /* Inactive stream beacon. */
55 LTTNG_VIEWER_INDEX_EOF = 6, /* End of index file. */
d3e2ba59
JD
56};
57
58enum lttng_viewer_get_packet_return_code {
c4e361a4
JD
59 LTTNG_VIEWER_GET_PACKET_OK = 1,
60 LTTNG_VIEWER_GET_PACKET_RETRY = 2,
61 LTTNG_VIEWER_GET_PACKET_ERR = 3,
62 LTTNG_VIEWER_GET_PACKET_EOF = 4,
d3e2ba59
JD
63};
64
65enum lttng_viewer_get_metadata_return_code {
c4e361a4
JD
66 LTTNG_VIEWER_METADATA_OK = 1,
67 LTTNG_VIEWER_NO_NEW_METADATA = 2,
68 LTTNG_VIEWER_METADATA_ERR = 3,
d3e2ba59
JD
69};
70
71enum lttng_viewer_connection_type {
c4e361a4
JD
72 LTTNG_VIEWER_CLIENT_COMMAND = 1,
73 LTTNG_VIEWER_CLIENT_NOTIFICATION = 2,
d3e2ba59
JD
74};
75
76enum lttng_viewer_seek {
ddea0ada 77 /* Receive the trace packets from the beginning. */
c4e361a4 78 LTTNG_VIEWER_SEEK_BEGINNING = 1,
ddea0ada 79 /* Receive the trace packets from now. */
c4e361a4 80 LTTNG_VIEWER_SEEK_LAST = 2,
d3e2ba59
JD
81};
82
80e8027a 83enum lttng_viewer_new_streams_return_code {
c4e361a4
JD
84 LTTNG_VIEWER_NEW_STREAMS_OK = 1, /* If new streams are being sent. */
85 LTTNG_VIEWER_NEW_STREAMS_NO_NEW = 2, /* If no new streams are available. */
86 LTTNG_VIEWER_NEW_STREAMS_ERR = 3, /* Error. */
4479f682 87 LTTNG_VIEWER_NEW_STREAMS_HUP = 4, /* Session closed. */
80e8027a
JD
88};
89
c3b7390b
JD
90enum lttng_viewer_create_session_return_code {
91 LTTNG_VIEWER_CREATE_SESSION_OK = 1,
92 LTTNG_VIEWER_CREATE_SESSION_ERR = 2,
93};
94
d62023be
JD
95enum lttng_viewer_detach_session_return_code {
96 LTTNG_VIEWER_DETACH_SESSION_OK = 1,
97 LTTNG_VIEWER_DETACH_SESSION_UNK = 2,
98 LTTNG_VIEWER_DETACH_SESSION_ERR = 3,
99};
100
d3e2ba59
JD
101struct lttng_viewer_session {
102 uint64_t id;
d3e2ba59
JD
103 uint32_t live_timer;
104 uint32_t clients;
87b576ec 105 uint32_t streams;
c4e361a4 106 char hostname[LTTNG_VIEWER_HOST_NAME_MAX];
ddea0ada 107 char session_name[LTTNG_VIEWER_NAME_MAX];
62d07d1c 108} LTTNG_PACKED;
d3e2ba59
JD
109
110struct lttng_viewer_stream {
111 uint64_t id;
112 uint64_t ctf_trace_id;
94143186 113 uint32_t metadata_flag;
d3e2ba59
JD
114 char path_name[LTTNG_VIEWER_PATH_MAX];
115 char channel_name[LTTNG_VIEWER_NAME_MAX];
62d07d1c 116} LTTNG_PACKED;
d3e2ba59
JD
117
118struct lttng_viewer_cmd {
119 uint64_t data_size; /* data size following this header */
120 uint32_t cmd; /* enum lttcomm_relayd_command */
121 uint32_t cmd_version; /* command version */
62d07d1c 122} LTTNG_PACKED;
d3e2ba59
JD
123
124/*
c4e361a4 125 * LTTNG_VIEWER_CONNECT payload.
d3e2ba59
JD
126 */
127struct lttng_viewer_connect {
ddea0ada
JD
128 /* session ID assigned by the relay for command connections */
129 uint64_t viewer_session_id;
d3e2ba59
JD
130 uint32_t major;
131 uint32_t minor;
c4e361a4 132 uint32_t type; /* enum lttng_viewer_connection_type */
62d07d1c 133} LTTNG_PACKED;
d3e2ba59
JD
134
135/*
c4e361a4 136 * LTTNG_VIEWER_LIST_SESSIONS payload.
d3e2ba59
JD
137 */
138struct lttng_viewer_list_sessions {
139 uint32_t sessions_count;
c4e361a4 140 char session_list[]; /* struct lttng_viewer_session */
62d07d1c 141} LTTNG_PACKED;
d3e2ba59
JD
142
143/*
c4e361a4 144 * LTTNG_VIEWER_ATTACH_SESSION payload.
d3e2ba59
JD
145 */
146struct lttng_viewer_attach_session_request {
147 uint64_t session_id;
d3e2ba59 148 uint64_t offset; /* unused for now */
ddea0ada 149 uint32_t seek; /* enum lttng_viewer_seek */
62d07d1c 150} LTTNG_PACKED;
d3e2ba59
JD
151
152struct lttng_viewer_attach_session_response {
ddea0ada
JD
153 /* enum lttng_viewer_attach_return_code */
154 uint32_t status;
d3e2ba59 155 uint32_t streams_count;
ddea0ada
JD
156 /* struct lttng_viewer_stream */
157 char stream_list[];
62d07d1c 158} LTTNG_PACKED;
d3e2ba59
JD
159
160/*
c4e361a4 161 * LTTNG_VIEWER_GET_NEXT_INDEX payload.
d3e2ba59
JD
162 */
163struct lttng_viewer_get_next_index {
164 uint64_t stream_id;
165} __attribute__ ((__packed__));
166
167struct lttng_viewer_index {
d3e2ba59
JD
168 uint64_t offset;
169 uint64_t packet_size;
170 uint64_t content_size;
171 uint64_t timestamp_begin;
172 uint64_t timestamp_end;
173 uint64_t events_discarded;
174 uint64_t stream_id;
c4e361a4
JD
175 uint32_t status; /* enum lttng_viewer_next_index_return_code */
176 uint32_t flags; /* LTTNG_VIEWER_FLAG_* */
d3e2ba59
JD
177} __attribute__ ((__packed__));
178
179/*
c4e361a4 180 * LTTNG_VIEWER_GET_PACKET payload.
d3e2ba59
JD
181 */
182struct lttng_viewer_get_packet {
183 uint64_t stream_id;
184 uint64_t offset;
185 uint32_t len;
62d07d1c 186} LTTNG_PACKED;
d3e2ba59
JD
187
188struct lttng_viewer_trace_packet {
c4e361a4 189 uint32_t status; /* enum lttng_viewer_get_packet_return_code */
d3e2ba59 190 uint32_t len;
c4e361a4 191 uint32_t flags; /* LTTNG_VIEWER_FLAG_* */
d3e2ba59 192 char data[];
62d07d1c 193} LTTNG_PACKED;
d3e2ba59
JD
194
195/*
c4e361a4 196 * LTTNG_VIEWER_GET_METADATA payload.
d3e2ba59
JD
197 */
198struct lttng_viewer_get_metadata {
199 uint64_t stream_id;
62d07d1c 200} LTTNG_PACKED;
d3e2ba59
JD
201
202struct lttng_viewer_metadata_packet {
d3e2ba59 203 uint64_t len;
c4e361a4 204 uint32_t status; /* enum lttng_viewer_get_metadata_return_code */
d3e2ba59 205 char data[];
62d07d1c 206} LTTNG_PACKED;
d3e2ba59 207
80e8027a 208/*
c4e361a4 209 * LTTNG_VIEWER_GET_NEW_STREAMS payload.
80e8027a
JD
210 */
211struct lttng_viewer_new_streams_request {
212 uint64_t session_id;
62d07d1c 213} LTTNG_PACKED;
80e8027a
JD
214
215struct lttng_viewer_new_streams_response {
216 /* enum lttng_viewer_new_streams_return_code */
217 uint32_t status;
218 uint32_t streams_count;
219 /* struct lttng_viewer_stream */
220 char stream_list[];
62d07d1c 221} LTTNG_PACKED;
80e8027a 222
c3b7390b
JD
223struct lttng_viewer_create_session_response {
224 /* enum lttng_viewer_create_session_return_code */
225 uint32_t status;
62d07d1c 226} LTTNG_PACKED;
c3b7390b 227
d62023be
JD
228/*
229 * LTTNG_VIEWER_DETACH_SESSION payload.
230 */
231struct lttng_viewer_detach_session_request {
232 uint64_t session_id;
62d07d1c 233} LTTNG_PACKED;
d62023be
JD
234
235struct lttng_viewer_detach_session_response {
236 /* enum lttng_viewer_detach_session_return_code */
237 uint32_t status;
62d07d1c 238} LTTNG_PACKED;
d62023be 239
1e26e04e 240#endif /* LTTNG_VIEWER_ABI_H */
This page took 0.072628 seconds and 5 git commands to generate.