lttng-enable-event.1.txt: fix SDT acronym, add missing "are supported"
[lttng-tools.git] / 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 */
This page took 0.034803 seconds and 4 git commands to generate.