Monado OpenXR Runtime
oxr_api_verify.h
Go to the documentation of this file.
1// Copyright 2018-2024, Collabora, Ltd.
2// SPDX-License-Identifier: BSL-1.0
3/*!
4 * @file
5 * @brief File for verifying app input into api functions.
6 * @author Jakob Bornecrantz <jakob@collabora.com>
7 * @author Korcan Hussein <korcan.hussein@collabora.com>
8 * @ingroup oxr_api
9 */
10
11#pragma once
12
13#include "oxr_frame_sync.h" // iwyu pragma: keep
14
15#include <stddef.h>
16
17
18#ifdef __cplusplus
19extern "C" {
20#endif
21
22struct oxr_action_set;
24struct oxr_instance;
25struct oxr_logger;
27
28#define OXR_VERIFY_AND_SET_AND_INIT(log, thing, new_thing, oxr_thing, THING, name, lookup) \
29 do { \
30 oxr_log_init(log, name); \
31 if (thing == XR_NULL_HANDLE) { \
32 return oxr_error(log, XR_ERROR_HANDLE_INVALID, "(" #thing " == NULL)"); \
33 } \
34 new_thing = (struct oxr_thing *)((uintptr_t)thing); \
35 if (new_thing->handle.debug != OXR_XR_DEBUG_##THING) { \
36 return oxr_error(log, XR_ERROR_HANDLE_INVALID, "(" #thing " == %p)", (void *)new_thing); \
37 } \
38 if (new_thing->handle.state != OXR_HANDLE_STATE_LIVE) { \
39 return oxr_error(log, XR_ERROR_HANDLE_INVALID, "(" #thing " == %p) state == %s", \
40 (void *)new_thing, oxr_handle_state_to_string(new_thing->handle.state)); \
41 } \
42 oxr_log_set_instance(log, lookup); \
43 } while (0)
44
45#define OXR_VERIFY_SET(log, arg, new_arg, oxr_thing, THING) \
46 do { \
47 if (arg == XR_NULL_HANDLE) { \
48 return oxr_error(log, XR_ERROR_HANDLE_INVALID, "(" #arg " == NULL)"); \
49 } \
50 new_arg = (struct oxr_thing *)((uintptr_t)arg); \
51 if (new_arg->handle.debug != OXR_XR_DEBUG_##THING) { \
52 return oxr_error(log, XR_ERROR_HANDLE_INVALID, "(" #arg " == %p)", (void *)new_arg); \
53 } \
54 } while (0)
55
56
57/*!
58 * @addtogroup oxr_api
59 * @{
60 */
61
62// clang-format off
63#define OXR_VERIFY_INSTANCE_AND_INIT_LOG(log, thing, new_thing, name) \
64 OXR_VERIFY_AND_SET_AND_INIT(log, thing, new_thing, oxr_instance, INSTANCE, name, new_thing)
65#define OXR_VERIFY_MESSENGER_AND_INIT_LOG(log, thing, new_thing, name) \
66 OXR_VERIFY_AND_SET_AND_INIT(log, thing, new_thing, oxr_messenger, MESSENGER, name, new_thing->inst)
67#define OXR_VERIFY_SESSION_AND_INIT_LOG(log, thing, new_thing, name) \
68 OXR_VERIFY_AND_SET_AND_INIT(log, thing, new_thing, oxr_session, SESSION, name, new_thing->sys->inst)
69#define OXR_VERIFY_SPACE_AND_INIT_LOG(log, thing, new_thing, name) \
70 OXR_VERIFY_AND_SET_AND_INIT(log, thing, new_thing, oxr_space, SPACE, name, new_thing->sess->sys->inst)
71#define OXR_VERIFY_ACTION_AND_INIT_LOG(log, thing, new_thing, name) \
72 OXR_VERIFY_AND_SET_AND_INIT(log, thing, new_thing, oxr_action, ACTION, name, new_thing->act_set->inst)
73#define OXR_VERIFY_SWAPCHAIN_AND_INIT_LOG(log, thing, new_thing, name) \
74 OXR_VERIFY_AND_SET_AND_INIT(log, thing, new_thing, oxr_swapchain, SWAPCHAIN, name, new_thing->sess->sys->inst)
75#define OXR_VERIFY_ACTIONSET_AND_INIT_LOG(log, thing, new_thing, name) \
76 OXR_VERIFY_AND_SET_AND_INIT(log, thing, new_thing, oxr_action_set, ACTIONSET, name, new_thing->inst)
77#define OXR_VERIFY_HAND_TRACKER_AND_INIT_LOG(log, thing, new_thing, name) \
78 OXR_VERIFY_AND_SET_AND_INIT(log, thing, new_thing, oxr_hand_tracker, HTRACKER, name, new_thing->sess->sys->inst)
79#define OXR_VERIFY_FORCE_FEEDBACK_AND_INIT_LOG(log, thing, new_thing, name) \
80 OXR_VERIFY_AND_SET_AND_INIT(log, thing, new_thing, oxr_force_feedback, FFB, name, new_thing->sess->sys->inst)
81#define OXR_VERIFY_PASSTHROUGH_AND_INIT_LOG(log, thing, new_thing, name) \
82 OXR_VERIFY_AND_SET_AND_INIT(log, thing, new_thing, oxr_passthrough, PASSTHROUGH, name, new_thing->sess->sys->inst)
83#define OXR_VERIFY_PASSTHROUGH_LAYER_AND_INIT_LOG(log, thing, new_thing, name) \
84 OXR_VERIFY_AND_SET_AND_INIT(log, thing, new_thing, oxr_passthrough_layer, PASSTHROUGH_LAYER, name, new_thing->sess->sys->inst)
85#define OXR_VERIFY_FACE_TRACKER_HTC_AND_INIT_LOG(log, thing, new_thing, name) \
86 OXR_VERIFY_AND_SET_AND_INIT(log, thing, new_thing, oxr_facial_tracker_htc, FTRACKER, name, new_thing->sess->sys->inst)
87#define OXR_VERIFY_FACE_TRACKER2_FB_AND_INIT_LOG(log, thing, new_thing, name) \
88 OXR_VERIFY_AND_SET_AND_INIT(log, thing, new_thing, oxr_face_tracker2_fb, FTRACKER, name, new_thing->sess->sys->inst)
89#define OXR_VERIFY_BODY_TRACKER_FB_AND_INIT_LOG(log, thing, new_thing, name) \
90 OXR_VERIFY_AND_SET_AND_INIT(log, thing, new_thing, oxr_body_tracker_fb, BTRACKER, name, new_thing->sess->sys->inst)
91#define OXR_VERIFY_XDEVLIST_AND_INIT_LOG(log, thing, new_thing, name) \
92 OXR_VERIFY_AND_SET_AND_INIT(log, thing, new_thing, oxr_xdev_list, XDEVLIST, name, new_thing->sess->sys->inst)
93// clang-format on
94
95#define OXR_VERIFY_INSTANCE_NOT_NULL(log, arg, new_arg) OXR_VERIFY_SET(log, arg, new_arg, oxr_instance, INSTANCE);
96#define OXR_VERIFY_MESSENGER_NOT_NULL(log, arg, new_arg) OXR_VERIFY_SET(log, arg, new_arg, oxr_messenger, MESSENGER);
97#define OXR_VERIFY_SESSION_NOT_NULL(log, arg, new_arg) OXR_VERIFY_SET(log, arg, new_arg, oxr_session, SESSION);
98#define OXR_VERIFY_SPACE_NOT_NULL(log, arg, new_arg) OXR_VERIFY_SET(log, arg, new_arg, oxr_space, SPACE);
99#define OXR_VERIFY_ACTION_NOT_NULL(log, arg, new_arg) OXR_VERIFY_SET(log, arg, new_arg, oxr_action, ACTION);
100#define OXR_VERIFY_SWAPCHAIN_NOT_NULL(log, arg, new_arg) OXR_VERIFY_SET(log, arg, new_arg, oxr_swapchain, SWAPCHAIN);
101#define OXR_VERIFY_ACTIONSET_NOT_NULL(log, arg, new_arg) OXR_VERIFY_SET(log, arg, new_arg, oxr_action_set, ACTIONSET);
102#define OXR_VERIFY_XDEVLIST_NOT_NULL(log, arg, new_arg) OXR_VERIFY_SET(log, arg, new_arg, oxr_xdev_list, XDEVLIST);
103
104/*!
105 * Checks if a required extension is enabled.
106 *
107 * mixed_case_name should be the extension name without the XR_ prefix.
108 */
109#define OXR_VERIFY_EXTENSION(log, inst, mixed_case_name) \
110 do { \
111 if (!(inst)->extensions.mixed_case_name) { \
112 return oxr_error((log), XR_ERROR_FUNCTION_UNSUPPORTED, \
113 "Requires XR_" #mixed_case_name " extension enabled"); \
114 } \
115 } while (false)
116
117/*!
118 * Checks if either one of two required extensions is enabled.
119 *
120 * mixed_case_name should be the extension name without the XR_ prefix.
121 */
122#define OXR_VERIFY_EXTENSIONS_OR(log, inst, mixed_case_name1, mixed_case_name2) \
123 do { \
124 if (!(inst)->extensions.mixed_case_name1 && !(inst)->extensions.mixed_case_name2) { \
125 return oxr_error((log), XR_ERROR_FUNCTION_UNSUPPORTED, \
126 "Requires XR_" #mixed_case_name1 "or XR_" #mixed_case_name2 \
127 " extension enabled"); \
128 } \
129 } while (false)
130
131/*!
132 * A condition if the instance is created with at least a given OpenXR version
133 */
134#define OXR_API_VERSION_AT_LEAST(inst, major, minor) \
135 ((inst)->openxr_version.major_minor >= XR_MAKE_VERSION(major, minor, 0))
136
137/*!
138 * Checks if the instance is created with at least a given OpenXR version
139 */
140#define OXR_VERIFY_API_VERSION_AT_LEAST(log, inst, major, minor) \
141 do { \
142 if (!OXR_VERSION_AT_LEAST(inst, major, minor)) { \
143 return oxr_error((log), XR_ERROR_FUNCTION_UNSUPPORTED, "Requires OpenXR version %d.%d.x", \
144 major, minor); \
145 } \
146 } while (false)
147
148#define OXR_VERIFY_ARG_NOT_NULL(log, arg) \
149 do { \
150 if (arg == NULL) { \
151 return oxr_error(log, XR_ERROR_VALIDATION_FAILURE, "(" #arg " == NULL)"); \
152 } \
153 } while (false)
154
155#define OXR_VERIFY_ARG_NOT_ZERO(log, arg) \
156 do { \
157 if (arg == 0) { \
158 return oxr_error(log, XR_ERROR_VALIDATION_FAILURE, "(" #arg " == 0) must be non-zero"); \
159 } \
160 } while (false)
161
162#define OXR_VERIFY_ARG_ZERO(log, arg) \
163 do { \
164 if (arg != 0) { \
165 return oxr_error(log, XR_ERROR_VALIDATION_FAILURE, "(" #arg " == 0) must be zero"); \
166 } \
167 } while (false)
168
169#define OXR_VERIFY_ARG_TYPE_CAN_BE_NULL(log, arg, type_enum) \
170 do { \
171 if (arg != NULL && arg->type != type_enum) { \
172 return oxr_error(log, XR_ERROR_VALIDATION_FAILURE, "(" #arg "->type == %u)", arg->type); \
173 } \
174 } while (false)
175
176#define OXR_VERIFY_ARG_TYPE_AND_NOT_NULL(log, arg, type_enum) \
177 do { \
178 if (arg == NULL) { \
179 return oxr_error(log, XR_ERROR_VALIDATION_FAILURE, "(" #arg " == NULL)"); \
180 } \
181 OXR_VERIFY_ARG_TYPE_CAN_BE_NULL(log, arg, type_enum); \
182 } while (false)
183
184/*!
185 * Must only be used with full typed arrays, aka non-basetyped arrays like that
186 * passed into xrEnumerateSwapchainImages.
187 */
188#define OXR_VERIFY_ARG_ARRAY_ELEMENT_TYPE(log, array, index, type_enum) \
189 do { \
190 if ((array)[index].type != type_enum) { \
191 return oxr_error(log, XR_ERROR_VALIDATION_FAILURE, \
192 "(" #array "[%u]->type == 0x%08x) expected 0x%08x", index, \
193 (array)[index].type, type_enum); \
194 } \
195 } while (false)
196
197#define OXR_VERIFY_SUBACTION_PATHS(log, count, paths) \
198 do { \
199 if (count > 0 && paths == NULL) { \
200 return oxr_error(log, XR_ERROR_VALIDATION_FAILURE, \
201 "(" #count ") is not zero but " #paths " is NULL"); \
202 } \
203 } while (false)
204
205#define OXR_VERIFY_ARG_SINGLE_LEVEL_FIXED_LENGTH_PATH(log, path) \
206 do { \
207 XrResult verify_ret = oxr_verify_fixed_size_single_level_path(log, path, ARRAY_SIZE(path), #path); \
208 if (verify_ret != XR_SUCCESS) { \
209 return verify_ret; \
210 } \
211 } while (false)
212
213#define OXR_VERIFY_ARG_LOCALIZED_NAME(log, string) \
214 do { \
215 XrResult verify_ret = oxr_verify_localized_name(log, string, ARRAY_SIZE(string), #string); \
216 if (verify_ret != XR_SUCCESS) { \
217 return verify_ret; \
218 } \
219 } while (false)
220
221#define OXR_VERIFY_POSE(log, p) \
222 do { \
223 if (!math_quat_validate((struct xrt_quat *)&p.orientation)) { \
224 return oxr_error(log, XR_ERROR_POSE_INVALID, "(" #p ".orientation) is not a valid quat"); \
225 } \
226 \
227 if (!math_vec3_validate((struct xrt_vec3 *)&p.position)) { \
228 return oxr_error(log, XR_ERROR_POSE_INVALID, "(" #p ".position) is not valid"); \
229 } \
230 } while (false)
231
232#define OXR_VERIFY_VIEW_CONFIG_TYPE(log, inst, view_conf) \
233 do { \
234 XrResult verify_ret = oxr_verify_view_config_type(log, inst, view_conf, #view_conf); \
235 if (verify_ret != XR_SUCCESS) { \
236 return verify_ret; \
237 } \
238 } while (false)
239
240#define OXR_VERIFY_VIEW_INDEX(log, index) \
241 do { \
242 if (index > 2) { \
243 return oxr_error(log, XR_ERROR_VALIDATION_FAILURE, \
244 "Invalid view index %d, only 2 views supported", index); \
245 } \
246 } while (false)
247
248#define OXR_VERIFY_SWAPCHAIN_USAGE_FLAGS_NOT_MUTUALLY_EXCLUSIVE(log, flags, mutually_exclusive_a, \
249 mutually_exclusive_b) \
250 do { \
251 if (((flags) & (mutually_exclusive_a)) != 0 && ((flags) & (mutually_exclusive_b)) != 0) { \
252 return oxr_error(log, XR_ERROR_VALIDATION_FAILURE, \
253 "(" #flags ") Swapchain usage flags " #mutually_exclusive_a \
254 " and " #mutually_exclusive_b \
255 " are mutually exclusive in this graphics API"); \
256 } \
257 } while (false)
258
259#define OXR_VERIFY_SESSION_NOT_LOST(log, sess) \
260 do { \
261 if (sess->has_lost) { \
262 return oxr_error(log, XR_ERROR_SESSION_LOST, "Session is lost"); \
263 } \
264 } while (false)
265
266#define OXR_VERIFY_SESSION_RUNNING(log, sess) \
267 do { \
268 if (!oxr_frame_sync_is_session_running(&sess->frame_sync)) { \
269 return oxr_error(log, XR_ERROR_SESSION_NOT_RUNNING, "Session is not running"); \
270 } \
271 } while (false)
272
273#define OXR_VERIFY_PASSTHROUGH_FLAGS(log, flags) \
274 if (flags == 0 || \
275 (flags & (XR_PASSTHROUGH_IS_RUNNING_AT_CREATION_BIT_FB | XR_PASSTHROUGH_LAYER_DEPTH_BIT_FB)) == 0) \
276 return oxr_error(log, XR_ERROR_VALIDATION_FAILURE, \
277 "flags is not a valid combination of XrPassthroughFlagBitsFB values");
278
279#define OXR_VERIFY_PASSTHROUGH_LAYER_PURPOSE(log, purpose) \
280 if ((purpose != XR_PASSTHROUGH_LAYER_PURPOSE_RECONSTRUCTION_FB && \
281 purpose != XR_PASSTHROUGH_LAYER_PURPOSE_PROJECTED_FB && \
282 purpose != XR_PASSTHROUGH_LAYER_PURPOSE_TRACKED_KEYBOARD_HANDS_FB && \
283 purpose != XR_PASSTHROUGH_LAYER_PURPOSE_TRACKED_KEYBOARD_MASKED_HANDS_FB)) \
284 return oxr_error(log, XR_ERROR_VALIDATION_FAILURE, \
285 "purpose is not a valid XrPassthroughLayerPurposeFB value");
286
287#define OXR_VERIFY_PASSTHROUGH_LAYER_STYLE(log, style) \
288 do { \
289 uint32_t duplicate_check = 0; \
290 const XrPassthroughStyleFB *next = style->next; \
291 while (next) { \
292 if (next->type != XR_TYPE_PASSTHROUGH_COLOR_MAP_MONO_TO_RGBA_FB && \
293 next->type != XR_TYPE_PASSTHROUGH_COLOR_MAP_MONO_TO_MONO_FB && \
294 next->type != XR_TYPE_PASSTHROUGH_BRIGHTNESS_CONTRAST_SATURATION_FB) \
295 return oxr_error(log, XR_ERROR_VALIDATION_FAILURE, \
296 "style next structure chain contains invalid pointers"); \
297 if ((next->type & duplicate_check) != 0) \
298 return oxr_error(log, XR_ERROR_VALIDATION_FAILURE, \
299 "style next structure chain contains duplicate items"); \
300 duplicate_check |= next->type; \
301 next = (const XrPassthroughStyleFB *)next->next; \
302 } \
303 } while (false)
304
305/*
306 *
307 * Implementation in oxr_verify.cpp
308 *
309 */
310
311XrResult
312oxr_verify_full_path_c(struct oxr_logger *log, const char *path, const char *name);
313
314/*!
315 * Verify a full path.
316 *
317 * Length not including zero terminator character but must be there.
318 */
319XrResult
320oxr_verify_full_path(struct oxr_logger *log, const char *path, size_t length, const char *name);
321
322/*!
323 * Verify a single path level that sits inside of a fixed sized array.
324 */
325XrResult
327 const char *path,
328 uint32_t array_size,
329 const char *name);
330
331/*!
332 * Verify an arbitrary UTF-8 string that sits inside of a fixed sized array.
333 */
334XrResult
335oxr_verify_localized_name(struct oxr_logger * /*log*/, const char *string, uint32_t array_size, const char *name);
336
337/*!
338 * Verify a set of subaction paths for action creation.
339 */
340XrResult
342 struct oxr_instance *inst,
343 uint32_t countSubactionPaths,
344 const XrPath *subactionPaths,
345 const char *variable);
346
347/*!
348 * Verify a set of subaction paths for action sync.
349 */
350XrResult
352 const struct oxr_instance *inst,
353 const struct oxr_action_set *act_set,
354 XrPath path,
355 uint32_t index);
356
357/*!
358 * Verify a set of subaction paths for action state get.
359 */
360XrResult
362 struct oxr_instance *inst,
363 XrPath path,
364 const struct oxr_subaction_paths *act_subaction_paths,
365 struct oxr_subaction_paths *out_subaction_paths,
366 const char *variable);
367
368XrResult
369oxr_verify_extensions(struct oxr_logger *log, const struct oxr_extension_status *extensions);
370
371XrResult
372oxr_verify_view_config_type(struct oxr_logger *log,
373 struct oxr_instance *inst,
374 XrViewConfigurationType view_conf,
375 const char *view_conf_name);
376
377XrResult
378oxr_verify_XrSessionCreateInfo(struct oxr_logger * /*log*/,
379 const struct oxr_instance * /*inst*/,
380 const XrSessionCreateInfo * /*createInfo*/);
381
382#if defined(XR_USE_PLATFORM_XLIB) && defined(XR_USE_GRAPHICS_API_OPENGL)
383XrResult
384oxr_verify_XrGraphicsBindingOpenGLXlibKHR(struct oxr_logger * /*log*/, const XrGraphicsBindingOpenGLXlibKHR * /*next*/);
385#endif // defined(XR_USE_PLATFORM_XLIB) && defined(XR_USE_GRAPHICS_API_OPENGL)
386
387#if defined(XR_USE_PLATFORM_WIN32) && defined(XR_USE_GRAPHICS_API_OPENGL)
388XrResult
389oxr_verify_XrGraphicsBindingOpenGLWin32KHR(struct oxr_logger * /*log*/,
390 const XrGraphicsBindingOpenGLWin32KHR * /*next*/);
391#endif // defined(XR_USE_PLATFORM_WIN32) && defined(XR_USE_GRAPHICS_API_OPENGL)
392
393#if defined(XR_USE_GRAPHICS_API_VULKAN)
394XrResult
395oxr_verify_XrGraphicsBindingVulkanKHR(struct oxr_logger * /*log*/, const XrGraphicsBindingVulkanKHR * /*next*/);
396#endif // defined(XR_USE_GRAPHICS_API_VULKAN)
397
398#if defined(XR_USE_PLATFORM_EGL) && defined(XR_USE_GRAPHICS_API_OPENGL)
399XrResult
400oxr_verify_XrGraphicsBindingEGLMNDX(struct oxr_logger *log, const XrGraphicsBindingEGLMNDX *next);
401#endif // defined(XR_USE_PLATFORM_EGL) && defined(XR_USE_GRAPHICS_API_OPENGL)
402
403#if defined(XR_USE_PLATFORM_ANDROID) && defined(XR_USE_GRAPHICS_API_OPENGL_ES)
404XrResult
405oxr_verify_XrGraphicsBindingOpenGLESAndroidKHR(struct oxr_logger *, const XrGraphicsBindingOpenGLESAndroidKHR *);
406#endif // defined(XR_USE_PLATFORM_ANDROID) &&
407 // defined(XR_USE_GRAPHICS_API_OPENGL_ES)
408
409#if defined(XR_USE_GRAPHICS_API_D3D11)
410XrResult
411oxr_verify_XrGraphicsBindingD3D11KHR(struct oxr_logger *, const XrGraphicsBindingD3D11KHR *);
412#endif // defined(XR_USE_GRAPHICS_API_D3D11)
413
414#if defined(XR_USE_GRAPHICS_API_D3D12)
415XrResult
416oxr_verify_XrGraphicsBindingD3D12KHR(struct oxr_logger *, const XrGraphicsBindingD3D12KHR *);
417#endif // defined(XR_USE_GRAPHICS_API_D3D12)
418
419#ifdef XR_EXT_dpad_binding
420XrResult
421oxr_verify_XrInteractionProfileDpadBindingEXT(struct oxr_logger *,
422 const XrInteractionProfileDpadBindingEXT *,
423 const char *error_prefix);
424#endif // XR_EXT_dpad_binding
425
426/*!
427 * @}
428 */
429
430
431#ifdef __cplusplus
432}
433#endif
XrResult oxr_verify_subaction_paths_create(struct oxr_logger *log, struct oxr_instance *inst, uint32_t countSubactionPaths, const XrPath *subactionPaths, const char *variable)
Verify a set of subaction paths for action creation.
Definition: oxr_verify.c:298
XrResult oxr_verify_subaction_path_sync(struct oxr_logger *log, const struct oxr_instance *inst, const struct oxr_action_set *act_set, XrPath path, uint32_t index)
Verify a set of subaction paths for action sync.
Definition: oxr_verify.c:319
XrResult oxr_verify_fixed_size_single_level_path(struct oxr_logger *, const char *path, uint32_t array_size, const char *name)
Verify a single path level that sits inside of a fixed sized array.
Definition: oxr_verify.c:64
XrResult oxr_verify_subaction_path_get(struct oxr_logger *log, struct oxr_instance *inst, XrPath path, const struct oxr_subaction_paths *act_subaction_paths, struct oxr_subaction_paths *out_subaction_paths, const char *variable)
Verify a set of subaction paths for action state get.
Definition: oxr_verify.c:349
XrResult oxr_verify_full_path(struct oxr_logger *log, const char *path, size_t length, const char *name)
Verify a full path.
Definition: oxr_verify.c:139
XrResult oxr_verify_localized_name(struct oxr_logger *, const char *string, uint32_t array_size, const char *name)
Verify an arbitrary UTF-8 string that sits inside of a fixed sized array.
Definition: oxr_verify.c:95
The objects that handle session running status and blocking of xrWaitFrame.
A group of actions.
Definition: oxr_objects.h:2475
Structure tracking which extensions are enabled for a given instance.
Definition: oxr_objects.h:1613
Main object that ties everything together.
Definition: oxr_objects.h:1626
Logger struct that lives on the stack, one for each call client call.
Definition: oxr_logger.h:40
A parsed equivalent of a list of sub-action paths.
Definition: oxr_objects.h:2052