libamxb  4.8.2
Bus Agnostic C API
amxb_ba_op_get.c
Go to the documentation of this file.
1 /****************************************************************************
2 **
3 ** SPDX-License-Identifier: BSD-2-Clause-Patent
4 **
5 ** SPDX-FileCopyrightText: Copyright (c) 2023 SoftAtHome
6 **
7 ** Redistribution and use in source and binary forms, with or without modification,
8 ** are permitted provided that the following conditions are met:
9 **
10 ** 1. Redistributions of source code must retain the above copyright notice,
11 ** this list of conditions and the following disclaimer.
12 **
13 ** 2. Redistributions in binary form must reproduce the above copyright notice,
14 ** this list of conditions and the following disclaimer in the documentation
15 ** and/or other materials provided with the distribution.
16 **
17 ** Subject to the terms and conditions of this license, each copyright holder
18 ** and contributor hereby grants to those receiving rights under this license
19 ** a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable
20 ** (except for failure to satisfy the conditions of this license) patent license
21 ** to make, have made, use, offer to sell, sell, import, and otherwise transfer
22 ** this software, where such license applies only to those patent claims, already
23 ** acquired or hereafter acquired, licensable by such copyright holder or contributor
24 ** that are necessarily infringed by:
25 **
26 ** (a) their Contribution(s) (the licensed copyrights of copyright holders and
27 ** non-copyrightable additions of contributors, in source or binary form) alone;
28 ** or
29 **
30 ** (b) combination of their Contribution(s) with the work of authorship to which
31 ** such Contribution(s) was added by such copyright holder or contributor, if,
32 ** at the time the Contribution is added, such addition causes such combination
33 ** to be necessarily infringed. The patent license shall not apply to any other
34 ** combinations which include the Contribution.
35 **
36 ** Except as expressly stated above, no rights or licenses from any copyright
37 ** holder or contributor is granted under this license, whether expressly, by
38 ** implication, estoppel or otherwise.
39 **
40 ** DISCLAIMER
41 **
42 ** THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
43 ** AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
44 ** IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
45 ** ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR CONTRIBUTORS BE
46 ** LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
47 ** DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
48 ** SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
49 ** CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
50 ** OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
51 ** USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
52 **
53 ****************************************************************************/
54 
55 #ifndef _GNU_SOURCE
56 #define _GNU_SOURCE
57 #endif
58 
59 #include <stdlib.h>
60 #include <stdio.h>
61 #include <errno.h>
62 #include <fcntl.h>
63 #include <string.h>
64 
65 #include <amxc/amxc.h>
66 #include <amxp/amxp.h>
67 
68 #include <amxd/amxd_common.h>
69 #include <amxd/amxd_dm.h>
70 #include <amxd/amxd_path.h>
71 #include <amxd/amxd_object.h>
72 
73 #include <amxb/amxb_be_intf.h>
74 #include <amxb/amxb.h>
75 
76 #include "amxb_priv.h"
77 
79  const char* object,
80  const char* search_path,
81  const char* filter,
82  int32_t depth,
83  amxc_var_t* ret,
84  int timeout) {
85  amxb_invoke_t* invoke_ctx = NULL;
86  int retval = amxd_status_unknown_error;
87  amxc_var_t* args = NULL;
88  amxc_string_t full_path;
89 
90  amxc_string_init(&full_path, 0);
91  amxc_var_new(&args);
92  amxc_var_set_type(args, AMXC_VAR_ID_HTABLE);
93 
94  if(search_path != NULL) {
95  amxc_var_add_key(cstring_t, args, "rel_path", search_path);
96  }
97  if((filter != NULL) && (*filter != 0)) {
98  amxc_var_add_key(cstring_t, args, "filter", filter);
99  }
100  amxc_var_add_key(int32_t, args, "depth", depth);
101  amxc_var_add_key(uint32_t, args, "access", bus_ctx->access);
102 
103  retval = amxb_new_invoke(&invoke_ctx, bus_ctx, object, NULL, "_get");
104  when_failed(retval, exit);
105  retval = amxb_invoke(invoke_ctx, args, ret, NULL, NULL, timeout);
106 
107 exit:
108  amxc_string_clean(&full_path);
109  amxc_var_delete(&args);
110  amxb_free_invoke(&invoke_ctx);
111  return retval;
112 }
113 
115  const char* search_path,
116  int32_t depth,
117  amxc_var_t* ret,
118  int timeout) {
119  return amxb_get_filtered(bus_ctx, search_path, NULL, depth, ret, timeout);
120 }
121 
123  const char* search_path,
124  const char* filter,
125  int32_t depth,
126  amxc_var_t* ret,
127  int timeout) {
128  int retval = amxd_status_unknown_error;
129  const amxb_be_funcs_t* fns = NULL;
130  amxd_path_t path;
131  bool islocal = false;
132  char* object = NULL;
133  const char* param = NULL;
134  amxc_string_t temp;
135 
136  amxc_string_init(&temp, 0);
137  amxd_path_init(&path, search_path);
138  when_null(bus_ctx, exit);
139  when_null(bus_ctx->bus_ctx, exit);
140 
141  while(amxd_path_get_type(&path) == amxd_path_reference) {
142  retval = amxb_follow_reference(bus_ctx, &path, timeout);
143  when_failed(retval, exit);
144  }
145 
146  object = amxd_path_get_fixed_part(&path, true);
147  if((object == NULL) || (strcmp(object, ".") == 0)) {
148  retval = amxd_status_object_not_found;
149  goto exit;
150  }
151  search_path = amxd_path_get(&path, AMXD_OBJECT_TERMINATE);
152  search_path = search_path == NULL ? "" : search_path;
153  param = amxd_path_get_param(&path);
154  islocal = amxb_is_local_object(bus_ctx, object);
155  fns = bus_ctx->bus_fn;
156 
157  if(param != NULL) {
158  amxc_string_setf(&temp, "%s%s", search_path, param);
159  search_path = amxc_string_get(&temp, 0);
160  }
161 
162  if(islocal ||
163  (!amxb_is_valid_be_func(fns, get, fns->get) &&
164  !amxb_is_valid_be_func(fns, get, fns->get_filtered))) {
165  retval = amxb_invoke_get(bus_ctx, object, search_path, filter,
166  depth, ret, timeout);
167  } else {
168  if(amxb_is_valid_be_func(fns, get, fns->get_filtered)) {
169  retval = fns->get_filtered(bus_ctx->bus_ctx, object, search_path, filter,
170  depth, bus_ctx->access, ret, timeout);
171 
172  } else if(amxb_is_valid_be_func(fns, get, fns->get)) {
173  retval = fns->get(bus_ctx->bus_ctx, object, search_path,
174  depth, bus_ctx->access, ret, timeout);
175  }
176  }
177 
178  if(retval == amxd_status_invalid_path) {
179  retval = amxd_status_object_not_found;
180  }
181 
182 exit:
183  amxc_string_clean(&temp);
184  free(object);
185  amxd_path_clean(&path);
186  return retval;
187 }
Ambiorix bus agnostic API header file.
static int amxb_invoke_get(amxb_bus_ctx_t *const bus_ctx, const char *object, const char *search_path, const char *filter, int32_t depth, amxc_var_t *ret, int timeout)
Ambiorix Bus Backend Interface.
#define amxb_is_valid_be_func(ft, member, ptr)
Definition: amxb_priv.h:78
int PRIVATE amxb_follow_reference(amxb_bus_ctx_t *const bus_ctx, amxd_path_t *reference, int timeout)
Definition: amxb_ba_priv.c:116
bool PRIVATE amxb_is_local_object(amxb_bus_ctx_t *ctx, const char *obj_path)
Definition: amxb_ba_priv.c:94
int amxb_new_invoke(amxb_invoke_t **invoke_ctx, amxb_bus_ctx_t *const ctx, const char *object, const char *interface, const char *method)
Prepares a remote function invocation.
void amxb_free_invoke(amxb_invoke_t **invoke_ctx)
Deletes a function invoke context, and frees allocated memory.
int amxb_invoke(amxb_invoke_t *invoke_ctx, amxc_var_t *args, amxc_var_t *ret, amxb_be_cb_fn_t fn, void *priv, int timeout)
Invokes a remote function, as defined by the function invoke context.
int amxb_get(amxb_bus_ctx_t *const bus_ctx, const char *search_path, int32_t depth, amxc_var_t *ret, int timeout)
Fetches one or more objects or a single parameter.
int amxb_get_filtered(amxb_bus_ctx_t *const bus_ctx, const char *search_path, const char *filter, int32_t depth, amxc_var_t *ret, int timeout)
Fetches one or more objects and their parameters that are matching a filter.
The back-end interface structure.
amxb_be_get_t get
amxb_be_get_filtered_t get_filtered
const amxb_be_funcs_t * bus_fn
Definition: amxb_types.h:121
uint32_t access
Definition: amxb_types.h:125
void * bus_ctx
Definition: amxb_types.h:122
static amxb_bus_ctx_t * bus_ctx
Definition: test_amxb_e2e.c:84