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 <stddef.h>
  27 #include <lttng/ust-events.h>
  28 #include <urcu/hlist.h>
  29
  30 struct lttng_ust_context_provider {
  31         char *name;
  32         size_t (*get_size)(struct lttng_ctx_field *field, size_t offset);
  33         void (*record)(struct lttng_ctx_field *field,
  34                        struct lttng_ust_lib_ring_buffer_ctx *ctx,
  35                        struct lttng_channel *chan);
  36         void (*get_value)(struct lttng_ctx_field *field,
  37                          struct lttng_ctx_value *value);
  38         struct cds_hlist_node node;
  39 };
  40
  41 int lttng_ust_context_provider_register(struct lttng_ust_context_provider *provider);
  42 void lttng_ust_context_provider_unregister(struct lttng_ust_context_provider *provider);
  43
  44 int lttng_context_is_app(const char *name);
  45
  46 void lttng_ust_context_set_session_provider(const char *name,
  47                 size_t (*get_size)(struct lttng_ctx_field *field, size_t offset),
  48                 void (*record)(struct lttng_ctx_field *field,
  49                         struct lttng_ust_lib_ring_buffer_ctx *ctx,
  50                         struct lttng_channel *chan),
  51                 void (*get_value)(struct lttng_ctx_field *field,
  52                         struct lttng_ctx_value *value));
  53
  54 int lttng_ust_add_app_context_to_ctx_rcu(const char *name, struct lttng_ctx **ctx);
  55 int lttng_ust_context_set_provider_rcu(struct lttng_ctx **_ctx,
  56                 const char *name,
  57                 size_t (*get_size)(struct lttng_ctx_field *field, size_t offset),
  58                 void (*record)(struct lttng_ctx_field *field,
  59                         struct lttng_ust_lib_ring_buffer_ctx *ctx,
  60                         struct lttng_channel *chan),
  61                 void (*get_value)(struct lttng_ctx_field *field,
  62                         struct lttng_ctx_value *value));
  63 int lttng_context_add_rcu(struct lttng_ctx **ctx_p,
  64                 const struct lttng_ctx_field *f);
  65
  66 #endif /* _LTTNG_UST_CONTEXT_PROVIDER_H */