liblttng-ust/ust-events-internal.h

   1 #ifndef _LTTNG_UST_EVENTS_INTERNAL_H
   2 #define _LTTNG_UST_EVENTS_INTERNAL_H
   3
   4 /*
   5  * ust-events-internal.h
   6  *
   7  * Copyright 2019 (c) - Francis Deslauriers <francis.deslauriers@efficios.com>
   8  *
   9  * Permission is hereby granted, free of charge, to any person obtaining a copy
  10  * of this software and associated documentation files (the "Software"), to deal
  11  * in the Software without restriction, including without limitation the rights
  12  * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
  13  * copies of the Software, and to permit persons to whom the Software is
  14  * furnished to do so, subject to the following conditions:
  15  *
  16  * The above copyright notice and this permission notice shall be included in
  17  * all copies or substantial portions of the Software.
  18  *
  19  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  20  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  21  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
  22  * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  23  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
  24  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  25  * SOFTWARE.
  26  */
  27
  28 #include <stdint.h>
  29
  30 #include <urcu/list.h>
  31 #include <urcu/hlist.h>
  32
  33 #include <helper.h>
  34 #include <lttng/ust-events.h>
  35
  36 struct lttng_event_enabler {
  37         struct lttng_enabler base;
  38         struct cds_list_head node;      /* per-session list of enablers */
  39         struct lttng_channel *chan;
  40         /*
  41          * Unused, but kept around to make it explicit that the tracer can do
  42          * it.
  43          */
  44         struct lttng_ctx *ctx;
  45 };
  46
  47 struct lttng_trigger_enabler {
  48         struct lttng_enabler base;
  49         uint64_t id;
  50         struct cds_list_head node;      /* per-app list of trigger enablers */
  51         struct cds_list_head capture_bytecode_head;
  52         struct lttng_trigger_group *group; /* weak ref */
  53         uint64_t num_captures;
  54 };
  55
  56 enum lttng_ust_bytecode_node_type{
  57         LTTNG_UST_BYTECODE_NODE_TYPE_FILTER,
  58         LTTNG_UST_BYTECODE_NODE_TYPE_CAPTURE,
  59 };
  60
  61
  62 struct lttng_ust_bytecode_node {
  63         enum lttng_ust_bytecode_node_type type;
  64         struct cds_list_head node;
  65         struct lttng_enabler *enabler;
  66         struct  {
  67                 uint32_t len;
  68                 uint32_t reloc_offset;
  69                 uint64_t seqnum;
  70                 char data[];
  71         } bc;
  72 };
  73
  74 struct lttng_ust_excluder_node {
  75         struct cds_list_head node;
  76         struct lttng_enabler *enabler;
  77         /*
  78          * struct lttng_ust_event_exclusion had variable sized array,
  79          * must be last field.
  80          */
  81         struct lttng_ust_event_exclusion excluder;
  82 };
  83
  84 static inline
  85 struct lttng_enabler *lttng_event_enabler_as_enabler(
  86                 struct lttng_event_enabler *event_enabler)
  87 {
  88         return &event_enabler->base;
  89 }
  90
  91 static inline
  92 struct lttng_enabler *lttng_trigger_enabler_as_enabler(
  93                 struct lttng_trigger_enabler *trigger_enabler)
  94 {
  95         return &trigger_enabler->base;
  96 }
  97
  98 /*
  99  * Allocate and initialize a `struct lttng_event_enabler` object.
 100  *
 101  * On success, returns a `struct lttng_event_enabler`,
 102  * On memory error, returns NULL.
 103  */
 104 LTTNG_HIDDEN
 105 struct lttng_event_enabler *lttng_event_enabler_create(
 106                 enum lttng_enabler_format_type format_type,
 107                 struct lttng_ust_event *event_param,
 108                 struct lttng_channel *chan);
 109
 110 /*
 111  * Destroy a `struct lttng_event_enabler` object.
 112  */
 113 LTTNG_HIDDEN
 114 void lttng_event_enabler_destroy(struct lttng_event_enabler *enabler);
 115
 116 /*
 117  * Enable a `struct lttng_event_enabler` object and all events related to this
 118  * enabler.
 119  */
 120 LTTNG_HIDDEN
 121 int lttng_event_enabler_enable(struct lttng_event_enabler *enabler);
 122
 123 /*
 124  * Disable a `struct lttng_event_enabler` object and all events related to this
 125  * enabler.
 126  */
 127 LTTNG_HIDDEN
 128 int lttng_event_enabler_disable(struct lttng_event_enabler *enabler);
 129
 130 /*
 131  * Attach filter bytecode program to `struct lttng_event_enabler` and all
 132  * events related to this enabler.
 133  */
 134 LTTNG_HIDDEN
 135 int lttng_event_enabler_attach_filter_bytecode(
 136                 struct lttng_event_enabler *enabler,
 137                 struct lttng_ust_bytecode_node *bytecode);
 138
 139 /*
 140  * Attach an application context to an event enabler.
 141  *
 142  * Not implemented.
 143  */
 144 LTTNG_HIDDEN
 145 int lttng_event_enabler_attach_context(struct lttng_event_enabler *enabler,
 146                 struct lttng_ust_context *ctx);
 147
 148 /*
 149  * Attach exclusion list to `struct lttng_event_enabler` and all
 150  * events related to this enabler.
 151  */
 152 LTTNG_HIDDEN
 153 int lttng_event_enabler_attach_exclusion(struct lttng_event_enabler *enabler,
 154                 struct lttng_ust_excluder_node *excluder);
 155
 156 /*
 157  * Synchronize bytecodes for the enabler and the instance (event or trigger).
 158  *
 159  * This function goes over all bytecode programs of the enabler (event or
 160  * trigger enabler) to ensure each is linked to the provided instance.
 161  */
 162 LTTNG_HIDDEN
 163 void lttng_enabler_link_bytecode(const struct lttng_event_desc *event_desc,
 164                 struct lttng_ctx **ctx,
 165                 struct cds_list_head *instance_bytecode_runtime_head,
 166                 struct cds_list_head *enabler_bytecode_runtime_head);
 167
 168 /* TODO doc */
 169 LTTNG_HIDDEN
 170 struct lttng_trigger_group *lttng_trigger_group_create(void);
 171
 172 /* TODO doc */
 173 LTTNG_HIDDEN
 174 void lttng_trigger_group_destroy(
 175                 struct lttng_trigger_group *trigger_group);
 176
 177 /* TODO doc */
 178 LTTNG_HIDDEN
 179 struct lttng_trigger_enabler *lttng_trigger_enabler_create(
 180                 struct lttng_trigger_group *trigger_group,
 181                 enum lttng_enabler_format_type format_type,
 182                 struct lttng_ust_trigger *trigger_param);
 183
 184 /* TODO doc */
 185 LTTNG_HIDDEN
 186 void lttng_trigger_enabler_destroy(struct lttng_trigger_enabler *trigger_enabler);
 187
 188 /* TODO doc */
 189 LTTNG_HIDDEN
 190 int lttng_trigger_enabler_enable(struct lttng_trigger_enabler *trigger_enabler);
 191
 192 /* TODO doc */
 193 LTTNG_HIDDEN
 194 int lttng_trigger_enabler_disable(struct lttng_trigger_enabler *trigger_enabler);
 195
 196 /* TODO doc */
 197 LTTNG_HIDDEN
 198 int lttng_trigger_enabler_attach_filter_bytecode(
 199                 struct lttng_trigger_enabler *trigger_enabler,
 200                 struct lttng_ust_bytecode_node *bytecode);
 201
 202 int lttng_trigger_enabler_attach_capture_bytecode(
 203                 struct lttng_trigger_enabler *trigger_enabler,
 204                 struct lttng_ust_bytecode_node *bytecode);
 205
 206 /* TODO doc */
 207 LTTNG_HIDDEN
 208 int lttng_trigger_enabler_attach_exclusion(
 209                 struct lttng_trigger_enabler *trigger_enabler,
 210                 struct lttng_ust_excluder_node *excluder);
 211
 212 /* TODO doc */
 213 LTTNG_HIDDEN
 214 void lttng_free_trigger_filter_runtime(struct lttng_trigger *trigger);
 215
 216 /* TODO doc */
 217 LTTNG_HIDDEN
 218 int lttng_fix_pending_triggers(void);
 219
 220 #endif /* _LTTNG_UST_EVENTS_INTERNAL_H */