2 * SPDX-License-Identifier: MIT
4 * Copyright (C) 2016 Mathieu Desnoyers <mathieu.desnoyers@efficios.com>
6 * The context provider feature is part of the ABI and used by the Java jni
7 * interface. This header should be moved to the public header directory once
8 * some test code and documentation is written.
11 #ifndef _LTTNG_UST_CONTEXT_PROVIDER_H
12 #define _LTTNG_UST_CONTEXT_PROVIDER_H
15 #include <lttng/ust-events.h>
16 #include <urcu/hlist.h>
18 #include "ust-dynamic-type.h"
23 * IMPORTANT: this structure is part of the ABI between the probe and
24 * UST. Additional selectors may be added in the future, mapping to new
25 * union fields, which means the overall size of this structure may
26 * increase. This means this structure should never be nested within a
27 * public structure interface, nor embedded in an array.
30 struct lttng_ust_ctx_value
{
31 enum lttng_ust_dynamic_type sel
; /* Type selector */
43 * IMPORTANT: this structure is part of the ABI between the probe and
44 * UST. Fields need to be only added at the end, never reordered, never
47 * The field @struct_size should be used to determine the size of the
48 * structure. It should be queried before using additional fields added
49 * at the end of the structure.
52 struct lttng_ust_ctx_field
{
56 struct lttng_ust_event_field
*event_field
;
57 size_t (*get_size
)(struct lttng_ust_ctx_field
*field
, size_t offset
);
58 void (*record
)(struct lttng_ust_ctx_field
*field
,
59 struct lttng_ust_lib_ring_buffer_ctx
*ctx
,
60 struct lttng_ust_channel_buffer
*chan
);
61 void (*get_value
)(struct lttng_ust_ctx_field
*field
,
62 struct lttng_ust_ctx_value
*value
);
63 void (*destroy
)(struct lttng_ust_ctx_field
*field
);
65 /* End of base ABI. Fields below should be used after checking struct_size. */
69 * All context fields for a given event/channel
71 * IMPORTANT: this structure is part of the ABI between the probe and
72 * UST. Fields need to be only added at the end, never reordered, never
75 * The field @struct_size should be used to determine the size of the
76 * structure. It should be queried before using additional fields added
77 * at the end of the structure.
80 struct lttng_ust_ctx
{
83 struct lttng_ust_ctx_field
**fields
;
84 unsigned int nr_fields
;
85 unsigned int allocated_fields
;
86 unsigned int largest_align
;
88 /* End of base ABI. Fields below should be used after checking struct_size. */
94 * IMPORTANT: this structure is part of the ABI between the probe and
95 * UST. Fields need to be only added at the end, never reordered, never
98 * The field @struct_size should be used to determine the size of the
99 * structure. It should be queried before using additional fields added
100 * at the end of the structure.
103 struct lttng_ust_context_provider
{
104 uint32_t struct_size
;
107 size_t (*get_size
)(struct lttng_ust_ctx_field
*field
, size_t offset
);
108 void (*record
)(struct lttng_ust_ctx_field
*field
,
109 struct lttng_ust_lib_ring_buffer_ctx
*ctx
,
110 struct lttng_ust_channel_buffer
*chan
);
111 void (*get_value
)(struct lttng_ust_ctx_field
*field
,
112 struct lttng_ust_ctx_value
*value
);
113 struct cds_hlist_node node
;
115 /* End of base ABI. Fields below should be used after checking struct_size. */
118 int lttng_ust_context_provider_register(struct lttng_ust_context_provider
*provider
);
119 void lttng_ust_context_provider_unregister(struct lttng_ust_context_provider
*provider
);
121 void lttng_ust_context_set_session_provider(const char *name
,
122 size_t (*get_size
)(struct lttng_ust_ctx_field
*field
, size_t offset
),
123 void (*record
)(struct lttng_ust_ctx_field
*field
,
124 struct lttng_ust_lib_ring_buffer_ctx
*ctx
,
125 struct lttng_ust_channel_buffer
*chan
),
126 void (*get_value
)(struct lttng_ust_ctx_field
*field
,
127 struct lttng_ust_ctx_value
*value
));
129 int lttng_ust_add_app_context_to_ctx_rcu(const char *name
, struct lttng_ust_ctx
**ctx
);
130 int lttng_ust_context_set_provider_rcu(struct lttng_ust_ctx
**_ctx
,
132 size_t (*get_size
)(struct lttng_ust_ctx_field
*field
, size_t offset
),
133 void (*record
)(struct lttng_ust_ctx_field
*field
,
134 struct lttng_ust_lib_ring_buffer_ctx
*ctx
,
135 struct lttng_ust_channel_buffer
*chan
),
136 void (*get_value
)(struct lttng_ust_ctx_field
*field
,
137 struct lttng_ust_ctx_value
*value
));
139 #endif /* _LTTNG_UST_CONTEXT_PROVIDER_H */