2 * Copyright (C) 2012 David Goulet <dgoulet@efficios.com>
4 * SPDX-License-Identifier: GPL-2.0-only
12 #include "lttng-sessiond.h"
13 #include "lttng/tracker.h"
15 #include <common/tracker.h>
17 struct notification_thread_handle
;
18 struct lttng_dynamic_buffer
;
21 * A callback (and associated user data) that should be run after a command
22 * has been executed. No locks should be taken while executing this handler.
24 * The command's reply should not be sent until the handler has run and
25 * completed successfully. On failure, the handler's return code should
26 * be the only reply sent to the client.
28 typedef enum lttng_error_code (*completion_handler_function
)(void *);
29 struct cmd_completion_handler
{
30 completion_handler_function run
;
35 * Init the command subsystem. Must be called before using any of the functions
36 * above. This is called in the main() of the session daemon.
40 /* Session commands */
41 enum lttng_error_code
cmd_create_session(struct command_ctx
*cmd_ctx
, int sock
,
42 struct lttng_session_descriptor
**return_descriptor
);
43 int cmd_destroy_session(struct ltt_session
*session
,
44 struct notification_thread_handle
*notification_thread_handle
,
47 /* Channel commands */
48 int cmd_disable_channel(struct ltt_session
*session
,
49 enum lttng_domain_type domain
, char *channel_name
);
50 int cmd_enable_channel(struct command_ctx
*cmd_ctx
, int sock
, int wpipe
);
52 /* Process attribute tracker commands */
53 enum lttng_error_code
cmd_process_attr_tracker_get_tracking_policy(
54 struct ltt_session
*session
,
55 enum lttng_domain_type domain
,
56 enum lttng_process_attr process_attr
,
57 enum lttng_tracking_policy
*policy
);
58 enum lttng_error_code
cmd_process_attr_tracker_set_tracking_policy(
59 struct ltt_session
*session
,
60 enum lttng_domain_type domain
,
61 enum lttng_process_attr process_attr
,
62 enum lttng_tracking_policy policy
);
63 enum lttng_error_code
cmd_process_attr_tracker_inclusion_set_add_value(
64 struct ltt_session
*session
,
65 enum lttng_domain_type domain
,
66 enum lttng_process_attr process_attr
,
67 const struct process_attr_value
*value
);
68 enum lttng_error_code
cmd_process_attr_tracker_inclusion_set_remove_value(
69 struct ltt_session
*session
,
70 enum lttng_domain_type domain
,
71 enum lttng_process_attr process_attr
,
72 const struct process_attr_value
*value
);
73 enum lttng_error_code
cmd_process_attr_tracker_get_inclusion_set(
74 struct ltt_session
*session
,
75 enum lttng_domain_type domain
,
76 enum lttng_process_attr process_attr
,
77 struct lttng_process_attr_values
**values
);
80 int cmd_disable_event(struct command_ctx
*cmd_ctx
, int sock
);
81 int cmd_add_context(struct ltt_session
*session
, enum lttng_domain_type domain
,
82 char *channel_name
, const struct lttng_event_context
*ctx
, int kwpipe
);
83 int cmd_set_filter(struct ltt_session
*session
, enum lttng_domain_type domain
,
84 char *channel_name
, struct lttng_event
*event
,
85 struct lttng_filter_bytecode
*bytecode
);
86 int cmd_enable_event(struct command_ctx
*cmd_ctx
, int sock
, int wpipe
);
88 /* Trace session action commands */
89 int cmd_start_trace(struct ltt_session
*session
);
90 int cmd_stop_trace(struct ltt_session
*session
);
92 /* Consumer commands */
93 int cmd_register_consumer(struct ltt_session
*session
,
94 enum lttng_domain_type domain
,
95 const char *sock_path
, struct consumer_data
*cdata
);
96 int cmd_set_consumer_uri(struct ltt_session
*session
, size_t nb_uri
,
97 struct lttng_uri
*uris
);
98 int cmd_setup_relayd(struct ltt_session
*session
);
100 /* Listing commands */
101 ssize_t
cmd_list_domains(struct ltt_session
*session
,
102 struct lttng_domain
**domains
);
103 enum lttng_error_code
cmd_list_events(enum lttng_domain_type domain
,
104 struct ltt_session
*session
,
106 struct lttng_dynamic_buffer
*payload
,
107 unsigned int *nb_events
);
108 enum lttng_error_code
cmd_list_channels(enum lttng_domain_type domain
,
109 struct ltt_session
*session
,
110 struct lttng_dynamic_buffer
*buffer
,
111 uint32_t *nb_channel
);
112 ssize_t
cmd_list_domains(struct ltt_session
*session
,
113 struct lttng_domain
**domains
);
114 void cmd_list_lttng_sessions(struct lttng_session
*sessions
,
115 size_t session_count
, uid_t uid
, gid_t gid
);
116 ssize_t
cmd_list_tracepoint_fields(enum lttng_domain_type domain
,
117 struct lttng_event_field
**fields
);
118 enum lttng_error_code
cmd_list_tracepoints(enum lttng_domain_type domain
,
119 struct lttng_dynamic_buffer
*buffer
,
120 unsigned int *nb_tracepoints
);
121 ssize_t
cmd_snapshot_list_outputs(struct ltt_session
*session
,
122 struct lttng_snapshot_output
**outputs
);
123 enum lttng_error_code
cmd_list_syscalls(
124 struct lttng_dynamic_buffer
*buffer
, unsigned int *nb_syscalls
);
126 int cmd_data_pending(struct ltt_session
*session
);
129 int cmd_snapshot_add_output(struct ltt_session
*session
,
130 const struct lttng_snapshot_output
*output
, uint32_t *id
);
131 int cmd_snapshot_del_output(struct ltt_session
*session
,
132 const struct lttng_snapshot_output
*output
);
133 int cmd_snapshot_record(struct ltt_session
*session
,
134 const struct lttng_snapshot_output
*output
, int wait
);
136 int cmd_set_session_shm_path(struct ltt_session
*session
,
137 const char *shm_path
);
138 int cmd_regenerate_metadata(struct ltt_session
*session
);
139 int cmd_regenerate_statedump(struct ltt_session
*session
);
141 int cmd_register_trigger(struct command_ctx
*cmd_ctx
, int sock
,
142 struct notification_thread_handle
*notification_thread_handle
);
143 int cmd_unregister_trigger(struct command_ctx
*cmd_ctx
, int sock
,
144 struct notification_thread_handle
*notification_thread_handle
);
146 int cmd_rotate_session(struct ltt_session
*session
,
147 struct lttng_rotate_session_return
*rotate_return
,
149 enum lttng_trace_chunk_command_type command
);
150 int cmd_rotate_get_info(struct ltt_session
*session
,
151 struct lttng_rotation_get_info_return
*info_return
,
153 int cmd_rotation_set_schedule(struct ltt_session
*session
,
154 bool activate
, enum lttng_rotation_schedule_type schedule_type
,
156 struct notification_thread_handle
*notification_thread_handle
);
158 const struct cmd_completion_handler
*cmd_pop_completion_handler(void);
159 int start_kernel_session(struct ltt_kernel_session
*ksess
);
160 int stop_kernel_session(struct ltt_kernel_session
*ksess
);