include/lttng/ust-context-provider.h

   1 #ifndef _LTTNG_UST_CONTEXT_PROVIDER_H
   2 #define _LTTNG_UST_CONTEXT_PROVIDER_H
   3
   4 /*
   5  * Copyright 2016 - Mathieu Desnoyers <mathieu.desnoyers@efficios.com>
   6  *
   7  * Permission is hereby granted, free of charge, to any person obtaining a copy
   8  * of this software and associated documentation files (the "Software"), to deal
   9  * in the Software without restriction, including without limitation the rights
  10  * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
  11  * copies of the Software, and to permit persons to whom the Software is
  12  * furnished to do so, subject to the following conditions:
  13  *
  14  * The above copyright notice and this permission notice shall be included in
  15  * all copies or substantial portions of the Software.
  16  *
  17  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  18  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  19  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
  20  * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  21  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
  22  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  23  * SOFTWARE.
  24  */
  25
  26 #include <lttng/ust-events.h>
  27 #include <urcu/hlist.h>
  28
  29 struct lttng_ust_context_provider {
  30         char *name;
  31         size_t (*get_size)(struct lttng_ctx_field *field, size_t offset);
  32         void (*record)(struct lttng_ctx_field *field,
  33                        struct lttng_ust_lib_ring_buffer_ctx *ctx,
  34                        struct lttng_channel *chan);
  35         void (*get_value)(struct lttng_ctx_field *field,
  36                          struct lttng_ctx_value *value);
  37         struct cds_hlist_node node;
  38 };
  39
  40 int lttng_ust_context_provider_register(struct lttng_ust_context_provider *provider);
  41 void lttng_ust_context_provider_unregister(struct lttng_ust_context_provider *provider);
  42
  43 int lttng_context_is_app(const char *name);
  44
  45 void lttng_ust_context_set_session_provider(const char *name,
  46                 size_t (*get_size)(struct lttng_ctx_field *field, size_t offset),
  47                 void (*record)(struct lttng_ctx_field *field,
  48                         struct lttng_ust_lib_ring_buffer_ctx *ctx,
  49                         struct lttng_channel *chan),
  50                 void (*get_value)(struct lttng_ctx_field *field,
  51                         struct lttng_ctx_value *value));
  52
  53 int lttng_ust_add_app_context_to_ctx_rcu(const char *name, struct lttng_ctx **ctx);
  54 int lttng_ust_context_set_provider_rcu(struct lttng_ctx **_ctx,
  55                 const char *name,
  56                 size_t (*get_size)(struct lttng_ctx_field *field, size_t offset),
  57                 void (*record)(struct lttng_ctx_field *field,
  58                         struct lttng_ust_lib_ring_buffer_ctx *ctx,
  59                         struct lttng_channel *chan),
  60                 void (*get_value)(struct lttng_ctx_field *field,
  61                         struct lttng_ctx_value *value));
  62 int lttng_context_add_rcu(struct lttng_ctx **ctx_p,
  63                 const struct lttng_ctx_field *f);
  64
  65 #endif /* _LTTNG_UST_CONTEXT_PROVIDER_H */