2 * Copyright (C) 2019 Jérémie Galarneau <jeremie.galarneau@efficios.com>
4 * SPDX-License-Identifier: LGPL-2.1-only
8 #ifndef LTTNG_SESSION_DESCRIPTOR_INTERNAL_H
9 #define LTTNG_SESSION_DESCRIPTOR_INTERNAL_H
11 #include <common/buffer-view.hpp>
12 #include <common/dynamic-buffer.hpp>
13 #include <common/uri.hpp>
15 #include <lttng/lttng-error.h>
16 #include <lttng/session-descriptor.h>
20 /* Note that these enums are used as part of the lttnctl protocol. */
21 enum lttng_session_descriptor_type {
22 LTTNG_SESSION_DESCRIPTOR_TYPE_UNKNOWN = -1,
24 * The output type determines whether this is a no-output, local,
25 * or networked tracing session.
27 LTTNG_SESSION_DESCRIPTOR_TYPE_REGULAR = 1,
28 LTTNG_SESSION_DESCRIPTOR_TYPE_SNAPSHOT = 2,
29 LTTNG_SESSION_DESCRIPTOR_TYPE_LIVE = 3,
32 enum lttng_session_descriptor_output_type {
33 LTTNG_SESSION_DESCRIPTOR_OUTPUT_TYPE_NONE = 0,
34 LTTNG_SESSION_DESCRIPTOR_OUTPUT_TYPE_LOCAL = 1,
35 LTTNG_SESSION_DESCRIPTOR_OUTPUT_TYPE_NETWORK = 2,
38 ssize_t lttng_session_descriptor_create_from_buffer(const struct lttng_buffer_view *view,
39 struct lttng_session_descriptor **descriptor);
41 int lttng_session_descriptor_serialize(const struct lttng_session_descriptor *descriptor,
42 struct lttng_dynamic_buffer *buffer);
44 enum lttng_session_descriptor_type
45 lttng_session_descriptor_get_type(const struct lttng_session_descriptor *descriptor);
47 enum lttng_session_descriptor_output_type
48 lttng_session_descriptor_get_output_type(const struct lttng_session_descriptor *descriptor);
50 void lttng_session_descriptor_get_local_output_uri(
51 const struct lttng_session_descriptor *descriptor, struct lttng_uri *local_uri);
53 void lttng_session_descriptor_get_network_output_uris(
54 const struct lttng_session_descriptor *descriptor,
55 struct lttng_uri *control,
56 struct lttng_uri *data);
59 lttng_session_descriptor_live_get_timer_interval(const struct lttng_session_descriptor *descriptor);
61 int lttng_session_descriptor_set_session_name(struct lttng_session_descriptor *descriptor,
64 bool lttng_session_descriptor_is_output_destination_initialized(
65 const struct lttng_session_descriptor *descriptor);
67 bool lttng_session_descriptor_has_output_directory(
68 const struct lttng_session_descriptor *descriptor);
71 lttng_session_descriptor_set_default_output(struct lttng_session_descriptor *descriptor,
72 time_t *session_creation_time,
73 const char *absolute_home_path);
75 int lttng_session_descriptor_assign(struct lttng_session_descriptor *dst_descriptor,
76 const struct lttng_session_descriptor *src_descriptor);
78 #endif /* LTTNG_SESSION_DESCRIPTOR_INTERNAL_H */