libamxs  0.6.0
Data Model Synchronization C API
amxs_common.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 <string.h>
61 
62 #include <amxc/amxc.h>
63 
64 #include <amxs/amxs_types.h>
65 
66 #include "amxs_priv.h"
67 
68 static int amxs_validate_attributes_single(int attr) {
69  int ret = -1;
70 
71  if(((attr & AMXS_SYNC_ONLY_A_TO_B) != 0) &&
72  ((attr & AMXS_SYNC_ONLY_B_TO_A) != 0)) {
73  goto exit;
74  }
75 
76  if(((attr & AMXS_SYNC_ONLY_A_TO_B) != 0) &&
77  ((attr & AMXS_SYNC_INIT_B) != 0)) {
78  goto exit;
79  }
80 
81  if(((attr & AMXS_SYNC_ONLY_B_TO_A) != 0) &&
82  ((attr & AMXS_SYNC_INIT_B) == 0)) {
83  goto exit;
84  }
85 
86  ret = 0;
87 
88 exit:
89  return ret;
90 }
91 
92 static int amxs_validate_attributes_hierarchy(int parent_attr, int child_attr) {
93  int ret = -1;
94 
95  if(((parent_attr & AMXS_SYNC_ONLY_B_TO_A) != 0) &&
96  ((child_attr & AMXS_SYNC_ONLY_A_TO_B) != 0)) {
97  goto exit;
98  }
99 
100  if(((parent_attr & AMXS_SYNC_ONLY_A_TO_B) != 0) &&
101  ((child_attr & AMXS_SYNC_ONLY_B_TO_A) != 0)) {
102  goto exit;
103  }
104 
105  ret = 0;
106 
107 exit:
108  return ret;
109 }
110 
111 amxs_status_t amxs_validate_attributes(int parent_attr, int child_attr) {
113 
114  when_failed(amxs_validate_attributes_single(parent_attr), exit);
115  when_failed(amxs_validate_attributes_single(child_attr), exit);
116  when_failed(amxs_validate_attributes_hierarchy(parent_attr, child_attr), exit);
117 
118  status = amxs_status_ok;
119 
120 exit:
121  return status;
122 }
123 
124 amxs_status_t amxs_update_child_attributes(int parent_attr, int* child_attr) {
126  when_null(child_attr, exit);
127 
128  *child_attr |= (parent_attr & (AMXS_SYNC_ONLY_A_TO_B | AMXS_SYNC_ONLY_B_TO_A));
129 
130  if((*child_attr & AMXS_SYNC_ONLY_B_TO_A) != 0) {
131  *child_attr |= AMXS_SYNC_INIT_B;
132  }
133 
134  status = amxs_status_ok;
135 
136 exit:
137  return status;
138 }
139 
140 void amxs_llist_it_delete_subscription(amxc_llist_it_t* it) {
141  amxb_subscription_t* sub = amxc_container_of(it, amxb_subscription_t, it);
142 
143  amxb_subscription_delete(&sub);
144 }
145 
static int amxs_validate_attributes_single(int attr)
Definition: amxs_common.c:68
static int amxs_validate_attributes_hierarchy(int parent_attr, int child_attr)
Definition: amxs_common.c:92
amxs_status_t amxs_update_child_attributes(int parent_attr, int *child_attr)
Definition: amxs_common.c:124
amxs_status_t amxs_validate_attributes(int parent_attr, int child_attr)
Definition: amxs_common.c:111
void amxs_llist_it_delete_subscription(amxc_llist_it_t *it)
Definition: amxs_common.c:140
Ambiorix Object Synchronization API header file.
@ amxs_status_ok
Definition: amxs_types.h:86
@ amxs_status_invalid_attr
Definition: amxs_types.h:88
enum _amxs_status amxs_status_t
#define AMXS_SYNC_INIT_B
Take the initial values from object B.
Definition: amxs_types.h:205
#define AMXS_SYNC_ONLY_B_TO_A
Only synchronize from object B to object A.
Definition: amxs_types.h:195
#define AMXS_SYNC_ONLY_A_TO_B
Only synchronize from object A to object B.
Definition: amxs_types.h:200