src/bin/lttng-sessiond/cmd.h

   1 /*
   2  * Copyright (C) 2012 - David Goulet <dgoulet@efficios.com>
   3  *
   4  * This program is free software; you can redistribute it and/or modify it
   5  * under the terms of the GNU General Public License, version 2 only, as
   6  * published by the Free Software Foundation.
   7  *
   8  * This program is distributed in the hope that it will be useful, but WITHOUT
   9  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  10  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
  11  * more details.
  12  *
  13  * You should have received a copy of the GNU General Public License along with
  14  * this program; if not, write to the Free Software Foundation, Inc., 51
  15  * Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
  16  */
  17
  18 #ifndef CMD_H
  19 #define CMD_H
  20
  21 #include "context.h"
  22 #include "session.h"
  23
  24 struct notification_thread_handle;
  25
  26 /*
  27  * A callback (and associated user data) that should be run after a command
  28  * has been executed. No locks should be taken while executing this handler.
  29  *
  30  * The command's reply should not be sent until the handler has run and
  31  * completed successfully. On failure, the handler's return code should
  32  * be the only reply sent to the client.
  33  */
  34 typedef enum lttng_error_code (*completion_handler_function)(void *);
  35 struct cmd_completion_handler {
  36         completion_handler_function run;
  37         void *data;
  38 };
  39
  40 /*
  41  * Init the command subsystem. Must be called before using any of the functions
  42  * above. This is called in the main() of the session daemon.
  43  */
  44 void cmd_init(void);
  45
  46 /* Session commands */
  47 int cmd_create_session_uri(char *name, struct lttng_uri *uris,
  48                 size_t nb_uri, lttng_sock_cred *creds, unsigned int live_timer);
  49 int cmd_create_session_snapshot(char *name, struct lttng_uri *uris,
  50                 size_t nb_uri, lttng_sock_cred *creds);
  51 int cmd_destroy_session(struct ltt_session *session, int wpipe,
  52                 struct notification_thread_handle *notification_thread_handle);
  53
  54 /* Channel commands */
  55 int cmd_disable_channel(struct ltt_session *session,
  56                 enum lttng_domain_type domain, char *channel_name);
  57 int cmd_enable_channel(struct ltt_session *session,
  58                 struct lttng_domain *domain, struct lttng_channel *attr,
  59                 int wpipe);
  60 int cmd_track_pid(struct ltt_session *session, enum lttng_domain_type domain,
  61                 int pid);
  62 int cmd_untrack_pid(struct ltt_session *session, enum lttng_domain_type domain,
  63                 int pid);
  64
  65 /* Event commands */
  66 int cmd_disable_event(struct ltt_session *session,
  67                 enum lttng_domain_type domain,
  68                 char *channel_name,
  69                 struct lttng_event *event);
  70 int cmd_add_context(struct ltt_session *session, enum lttng_domain_type domain,
  71                 char *channel_name, struct lttng_event_context *ctx, int kwpipe);
  72 int cmd_set_filter(struct ltt_session *session, enum lttng_domain_type domain,
  73                 char *channel_name, struct lttng_event *event,
  74                 struct lttng_filter_bytecode *bytecode);
  75 int cmd_enable_event(struct ltt_session *session, struct lttng_domain *domain,
  76                 char *channel_name, struct lttng_event *event,
  77                 char *filter_expression,
  78                 struct lttng_filter_bytecode *filter,
  79                 struct lttng_event_exclusion *exclusion,
  80                 int wpipe);
  81
  82 /* Trace session action commands */
  83 int cmd_start_trace(struct ltt_session *session);
  84 int cmd_stop_trace(struct ltt_session *session);
  85
  86 /* Consumer commands */
  87 int cmd_register_consumer(struct ltt_session *session,
  88                 enum lttng_domain_type domain,
  89                 const char *sock_path, struct consumer_data *cdata);
  90 int cmd_set_consumer_uri(struct ltt_session *session, size_t nb_uri,
  91                 struct lttng_uri *uris);
  92 int cmd_setup_relayd(struct ltt_session *session);
  93
  94 /* Listing commands */
  95 ssize_t cmd_list_domains(struct ltt_session *session,
  96                 struct lttng_domain **domains);
  97 ssize_t cmd_list_events(enum lttng_domain_type domain,
  98                 struct ltt_session *session, char *channel_name,
  99                 struct lttng_event **events, size_t *total_size);
 100 ssize_t cmd_list_channels(enum lttng_domain_type domain,
 101                 struct ltt_session *session, struct lttng_channel **channels);
 102 ssize_t cmd_list_domains(struct ltt_session *session,
 103                 struct lttng_domain **domains);
 104 void cmd_list_lttng_sessions(struct lttng_session *sessions, uid_t uid,
 105                 gid_t gid);
 106 ssize_t cmd_list_tracepoint_fields(enum lttng_domain_type domain,
 107                 struct lttng_event_field **fields);
 108 ssize_t cmd_list_tracepoints(enum lttng_domain_type domain,
 109                 struct lttng_event **events);
 110 ssize_t cmd_snapshot_list_outputs(struct ltt_session *session,
 111                 struct lttng_snapshot_output **outputs);
 112 ssize_t cmd_list_syscalls(struct lttng_event **events);
 113 ssize_t cmd_list_tracker_pids(struct ltt_session *session,
 114                 enum lttng_domain_type domain, int32_t **pids);
 115
 116 int cmd_data_pending(struct ltt_session *session);
 117
 118 /* Snapshot */
 119 int cmd_snapshot_add_output(struct ltt_session *session,
 120                 struct lttng_snapshot_output *output, uint32_t *id);
 121 int cmd_snapshot_del_output(struct ltt_session *session,
 122                 struct lttng_snapshot_output *output);
 123 int cmd_snapshot_record(struct ltt_session *session,
 124                 struct lttng_snapshot_output *output, int wait);
 125
 126 int cmd_set_session_shm_path(struct ltt_session *session,
 127                 const char *shm_path);
 128 int cmd_regenerate_metadata(struct ltt_session *session);
 129 int cmd_regenerate_statedump(struct ltt_session *session);
 130
 131 int cmd_register_trigger(struct command_ctx *cmd_ctx, int sock,
 132                 struct notification_thread_handle *notification_thread_handle);
 133 int cmd_unregister_trigger(struct command_ctx *cmd_ctx, int sock,
 134                 struct notification_thread_handle *notification_thread_handle);
 135
 136 int cmd_rotate_session(struct ltt_session *session,
 137                 struct lttng_rotate_session_return *rotate_return);
 138 int cmd_rotate_get_info(struct ltt_session *session,
 139                 struct lttng_rotation_get_info_return *info_return,
 140                 uint64_t rotate_id);
 141 int cmd_rotation_set_schedule(struct ltt_session *session,
 142                 bool activate, enum lttng_rotation_schedule_type schedule_type,
 143                 uint64_t value,
 144                 struct notification_thread_handle *notification_thread_handle);
 145
 146 const struct cmd_completion_handler *cmd_pop_completion_handler(void);
 147
 148 #endif /* CMD_H */