src/bin/lttng-sessiond/cmd.h

   1 /*
   2  * Copyright (C) 2012 David Goulet <dgoulet@efficios.com>
   3  *
   4  * SPDX-License-Identifier: GPL-2.0-only
   5  *
   6  */
   7
   8 #ifndef CMD_H
   9 #define CMD_H
  10
  11 #include "context.h"
  12 #include "lttng-sessiond.h"
  13 #include "lttng/tracker.h"
  14 #include "session.h"
  15 #include <common/tracker.h>
  16
  17 struct notification_thread_handle;
  18 struct lttng_dynamic_buffer;
  19
  20 /*
  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.
  23  *
  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.
  27  */
  28 typedef enum lttng_error_code (*completion_handler_function)(void *);
  29 struct cmd_completion_handler {
  30         completion_handler_function run;
  31         void *data;
  32 };
  33
  34 /*
  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.
  37  */
  38 void cmd_init(void);
  39
  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,
  45                 int *sock_fd);
  46
  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);
  51
  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);
  78
  79 /* Event commands */
  80 int cmd_disable_event(struct command_ctx *cmd_ctx,
  81                 struct lttng_event *event,
  82                 char *filter_expression,
  83                 struct lttng_bytecode *filter,
  84                 struct lttng_event_exclusion *exclusion);
  85 int cmd_add_context(struct ltt_session *session, enum lttng_domain_type domain,
  86                 char *channel_name, const struct lttng_event_context *ctx, int kwpipe);
  87 int cmd_set_filter(struct ltt_session *session, enum lttng_domain_type domain,
  88                 char *channel_name, struct lttng_event *event,
  89                 struct lttng_bytecode *bytecode);
  90 int cmd_enable_event(struct command_ctx *cmd_ctx,
  91                 struct lttng_event *event,
  92                 char *filter_expression,
  93                 struct lttng_event_exclusion *exclusion,
  94                 struct lttng_bytecode *bytecode,
  95                 int wpipe);
  96
  97 /* Trace session action commands */
  98 int cmd_start_trace(struct ltt_session *session);
  99 int cmd_stop_trace(struct ltt_session *session);
 100
 101 /* Consumer commands */
 102 int cmd_register_consumer(struct ltt_session *session,
 103                 enum lttng_domain_type domain,
 104                 const char *sock_path, struct consumer_data *cdata);
 105 int cmd_set_consumer_uri(struct ltt_session *session, size_t nb_uri,
 106                 struct lttng_uri *uris);
 107 int cmd_setup_relayd(struct ltt_session *session);
 108
 109 /* Listing commands */
 110 ssize_t cmd_list_domains(struct ltt_session *session,
 111                 struct lttng_domain **domains);
 112 enum lttng_error_code cmd_list_events(enum lttng_domain_type domain,
 113                 struct ltt_session *session,
 114                 char *channel_name,
 115                 struct lttng_payload *payload);
 116 enum lttng_error_code cmd_list_channels(enum lttng_domain_type domain,
 117                 struct ltt_session *session,
 118                 struct lttng_payload *payload);
 119 ssize_t cmd_list_domains(struct ltt_session *session,
 120                 struct lttng_domain **domains);
 121 void cmd_list_lttng_sessions(struct lttng_session *sessions,
 122                 size_t session_count, uid_t uid, gid_t gid);
 123 ssize_t cmd_list_tracepoint_fields(enum lttng_domain_type domain,
 124                 struct lttng_event_field **fields);
 125 enum lttng_error_code cmd_list_tracepoints(enum lttng_domain_type domain,
 126                 struct lttng_payload *reply_payload);
 127 ssize_t cmd_snapshot_list_outputs(struct ltt_session *session,
 128                 struct lttng_snapshot_output **outputs);
 129 enum lttng_error_code cmd_list_syscalls(
 130                 struct lttng_payload *reply_payload);
 131
 132 int cmd_data_pending(struct ltt_session *session);
 133
 134 /* Snapshot */
 135 int cmd_snapshot_add_output(struct ltt_session *session,
 136                 const struct lttng_snapshot_output *output, uint32_t *id);
 137 int cmd_snapshot_del_output(struct ltt_session *session,
 138                 const struct lttng_snapshot_output *output);
 139 int cmd_snapshot_record(struct ltt_session *session,
 140                 const struct lttng_snapshot_output *output, int wait);
 141
 142 int cmd_set_session_shm_path(struct ltt_session *session,
 143                 const char *shm_path);
 144 int cmd_regenerate_metadata(struct ltt_session *session);
 145 int cmd_regenerate_statedump(struct ltt_session *session);
 146
 147 enum lttng_error_code cmd_register_trigger(
 148                 const struct lttng_credentials *cmd_creds,
 149                 struct lttng_trigger *trigger,
 150                 bool is_anonymous_trigger,
 151                 struct notification_thread_handle *notification_thread_handle,
 152                 struct lttng_trigger **return_trigger);
 153 enum lttng_error_code cmd_unregister_trigger(
 154                 const struct lttng_credentials *cmd_creds,
 155                 const struct lttng_trigger *trigger,
 156                 struct notification_thread_handle *notification_thread_handle);
 157
 158 enum lttng_error_code cmd_list_triggers(struct command_ctx *cmd_ctx,
 159                 struct notification_thread_handle *notification_thread_handle,
 160                 struct lttng_triggers **return_triggers);
 161 enum lttng_error_code cmd_execute_error_query(const struct lttng_credentials *cmd_creds,
 162                 const struct lttng_error_query *query,
 163                 struct lttng_error_query_results **_results,
 164                 struct notification_thread_handle *notification_thread);
 165
 166 int cmd_rotate_session(struct ltt_session *session,
 167                 struct lttng_rotate_session_return *rotate_return,
 168                 bool quiet_rotation,
 169                 enum lttng_trace_chunk_command_type command);
 170 int cmd_rotate_get_info(struct ltt_session *session,
 171                 struct lttng_rotation_get_info_return *info_return,
 172                 uint64_t rotate_id);
 173 int cmd_rotation_set_schedule(struct ltt_session *session,
 174                 bool activate, enum lttng_rotation_schedule_type schedule_type,
 175                 uint64_t value,
 176                 struct notification_thread_handle *notification_thread_handle);
 177
 178 const struct cmd_completion_handler *cmd_pop_completion_handler(void);
 179 int start_kernel_session(struct ltt_kernel_session *ksess);
 180 int stop_kernel_session(struct ltt_kernel_session *ksess);
 181
 182 #endif /* CMD_H */