blob: 98743785c3bdb23ec2634aeeee80e2c21686980d [file] [log] [blame]
Radek Krejci5aeea3a2018-09-05 13:29:36 +02001/**
2 * @file tree_schema.h
3 * @author Radek Krejci <rkrejci@cesnet.cz>
4 * @brief libyang representation of YANG schema trees.
5 *
6 * Copyright (c) 2015 - 2018 CESNET, z.s.p.o.
7 *
8 * This source code is licensed under BSD 3-Clause License (the "License").
9 * You may not use this file except in compliance with the License.
10 * You may obtain a copy of the License at
11 *
12 * https://opensource.org/licenses/BSD-3-Clause
13 */
14
15#ifndef LY_TREE_SCHEMA_H_
16#define LY_TREE_SCHEMA_H_
17
Radek Krejci54579462019-04-30 12:47:06 +020018#define PCRE2_CODE_UNIT_WIDTH 8
19
20#include <pcre2.h>
Radek Krejci535ea9f2020-05-29 16:01:05 +020021
Radek Krejci5aeea3a2018-09-05 13:29:36 +020022#include <stdint.h>
Radek Krejcid3ca0632019-04-16 16:54:54 +020023#include <stdio.h>
Radek Krejci5aeea3a2018-09-05 13:29:36 +020024
Michal Vaskobabf0bd2021-08-31 14:55:39 +020025#include "config.h"
Radek Krejcie7b95092019-05-15 11:03:07 +020026#include "log.h"
27#include "tree.h"
Radek Krejcice8c1592018-10-29 15:35:51 +010028
Radek Krejci70853c52018-10-15 14:46:16 +020029#ifdef __cplusplus
30extern "C" {
31#endif
32
Radek Krejcica376bd2020-06-11 16:04:06 +020033struct ly_ctx;
Radek Krejci47fab892020-11-05 17:02:41 +010034struct ly_path;
Radek Krejcica376bd2020-06-11 16:04:06 +020035struct ly_set;
Radek Krejci47fab892020-11-05 17:02:41 +010036struct lys_module;
37struct lysc_node;
38struct lyxp_expr;
Radek Krejcica376bd2020-06-11 16:04:06 +020039
Radek Krejci5aeea3a2018-09-05 13:29:36 +020040/**
Radek Krejci8678fa42020-08-18 16:07:28 +020041 * @page howtoSchema YANG Modules
42 *
43 * To be able to work with YANG data instances, libyang has to represent YANG data models. All the processed modules are stored
44 * in libyang [context](@ref howtoContext) and loaded using [parser functions](@ref howtoSchemaParsers). It means, that there is
45 * no way to create/change YANG module programmatically. However, all the YANG model definitions are available and can be examined
46 * through the C structures. All the context's modules together form YANG Schema for the data being instantiated.
47 *
48 * Any YANG module is represented as ::lys_module. In fact, the module is represented in two different formats. As ::lys_module.parsed,
49 * there is a parsed schema reflecting the source YANG module. It is exactly what is read from the input. This format is good for
50 * converting from one format to another (YANG to YIN and vice versa), but it is not very useful for validating/manipulating YANG
51 * data. Therefore, there is ::lys_module.compiled storing the compiled YANG module. It is based on the parsed module, but all the
52 * references are resolved. It means that, for example, there are no `grouping`s or `typedef`s since they are supposed to be placed instead of
53 * `uses` or `type` references. This split also means, that the YANG module is fully validated after compilation of the parsed
54 * representation of the module. YANG submodules are available only in the parsed representation. When a submodule is compiled, it
55 * is fully integrated into its main module.
56 *
57 * The context can contain even modules without the compiled representation. Such modules are still useful as imports of other
58 * modules. The grouping or typedef definition can be even compiled into the importing modules. This is actually the main
59 * difference between the imported and implemented modules in the libyang context. The implemented modules are compiled while the
60 * imported modules are only parsed.
61 *
Radek Krejcib100b192020-10-26 08:37:45 +010062 * By default, the module is implemented (and compiled) in case it is explicitly loaded or referenced in another module as
63 * target of leafref, augment or deviation. This behavior can be changed via context options ::LY_CTX_ALL_IMPLEMENTED, when
64 * all the modules in the context are marked as implemented (note the problem with multiple revisions of a single module),
65 * or by ::LY_CTX_REF_IMPLEMENTED option, extending the set of references making the module implemented by when, must and
66 * default statements.
Radek Krejci8678fa42020-08-18 16:07:28 +020067 *
68 * All modules with deviation definition are always marked as implemented. The imported (not implemented) module can be set implemented by ::lys_set_implemented(). But
69 * the implemented module cannot be changed back to just imported module. Note also that only one revision of a specific module
70 * can be implemented in a single context. The imported modules are used only as a
71 * source of definitions for types and groupings for uses statements. The data in such modules are ignored - caller
72 * is not allowed to create the data (including instantiating identities) defined in the model via data parsers,
73 * the default nodes are not added into any data tree and mandatory nodes are not checked in the data trees.
74 *
Michal Vasko14ed9cd2021-01-28 14:16:25 +010075 * The compiled schema tree nodes are able to hold private objects (::lysc_node.priv as a pointer to a structure,
aPiecek9922ea92021-04-12 07:59:20 +020076 * function, variable, ...) used by a caller application unless ::LY_CTX_SET_PRIV_PARSED is set, in that case
77 * the ::lysc_node.priv pointers are used by libyang.
Radek Krejci8678fa42020-08-18 16:07:28 +020078 * Note that the object is not freed by libyang when the context is being destroyed. So the caller is responsible
79 * for freeing the provided structure after the context is destroyed or the private pointer is set to NULL in
Radek Krejci90ed21e2021-04-12 14:47:46 +020080 * appropriate schema nodes where the object was previously set. Also ::lysc_tree_dfs_full() can be useful to manage
81 * the private data.
Radek Krejci8678fa42020-08-18 16:07:28 +020082 *
83 * Despite all the schema structures and their members are available as part of the libyang API and callers can use
84 * it to navigate through the schema tree structure or to obtain various information, we recommend to use the following
85 * macros for the specific actions.
86 * - ::LYSC_TREE_DFS_BEGIN and ::LYSC_TREE_DFS_END to traverse the schema tree (depth-first).
87 * - ::LY_LIST_FOR and ::LY_ARRAY_FOR as described on @ref howtoStructures page.
88 *
89 * Further information about modules handling can be found on the following pages:
90 * - @subpage howtoSchemaParsers
91 * - @subpage howtoSchemaFeatures
92 * - @subpage howtoPlugins
93 * - @subpage howtoSchemaPrinters
94 *
95 * \note There are many functions to access information from the schema trees. Details are available in
96 * the [Schema Tree module](@ref schematree).
97 *
98 * For information about difference between implemented and imported modules, see the
99 * [context description](@ref howtoContext).
100 *
101 * Functions List (not assigned to above subsections)
102 * --------------------------------------------------
103 * - ::lys_getnext()
104 * - ::lys_nodetype2str()
105 * - ::lys_set_implemented()
Radek Krejci8678fa42020-08-18 16:07:28 +0200106 *
Michal Vaskod5cfa6e2020-11-23 16:56:08 +0100107 * - ::lysc_has_when()
Michal Vaskoef53c812021-10-13 10:21:03 +0200108 * - ::lysc_owner_module()
Michal Vaskod5cfa6e2020-11-23 16:56:08 +0100109 *
Michal Vasko544e58a2021-01-28 14:33:41 +0100110 * - ::lysc_node_child()
Radek Krejci8678fa42020-08-18 16:07:28 +0200111 * - ::lysc_node_actions()
112 * - ::lysc_node_notifs()
113 *
Michal Vasko544e58a2021-01-28 14:33:41 +0100114 * - ::lysp_node_child()
Radek Krejci8678fa42020-08-18 16:07:28 +0200115 * - ::lysp_node_actions()
116 * - ::lysp_node_notifs()
117 * - ::lysp_node_groupings()
118 * - ::lysp_node_typedefs()
119 */
120
121/**
122 * @page howtoSchemaFeatures YANG Features
123 *
Michal Vasko7b1ad1a2020-11-02 15:41:27 +0100124 * YANG feature statement is an important part of the language which can significantly affect the meaning of the schemas.
125 * Modifying features may have similar effects as loading/removing schema from the context so it is limited to context
126 * preparation period before working with data. YANG features, respectively their use in if-feature
127 * statements, are evaluated as part of schema compilation so a feature-specific compiled schema tree is generated
128 * as a result.
Radek Krejci8678fa42020-08-18 16:07:28 +0200129 *
Michal Vasko7b1ad1a2020-11-02 15:41:27 +0100130 * To enable any features, they must currently be specified when implementing a new schema with ::lys_parse() or
131 * ::ly_ctx_load_module(). To later examine what the status of a feature is, check its ::LYS_FENABLED flag or
132 * search for it first with ::lys_feature_value(). Lastly, to evaluate compiled if-features, use ::lysc_iffeature_value().
Radek Krejci8678fa42020-08-18 16:07:28 +0200133 *
Michal Vasko7b1ad1a2020-11-02 15:41:27 +0100134 * To iterate over all features of a particular YANG module, use ::lysp_feature_next().
Radek Krejci8678fa42020-08-18 16:07:28 +0200135 *
136 * Note, that the feature's state can affect some of the output formats (e.g. Tree format).
137 *
138 * Functions List
139 * --------------
Radek Krejci8678fa42020-08-18 16:07:28 +0200140 * - ::lys_feature_value()
Radek Krejci8678fa42020-08-18 16:07:28 +0200141 * - ::lysc_iffeature_value()
Michal Vasko7b1ad1a2020-11-02 15:41:27 +0100142 * - ::lysp_feature_next()
Radek Krejci8678fa42020-08-18 16:07:28 +0200143 */
144
145/**
Radek Krejci2ff0d572020-05-21 15:27:28 +0200146 * @ingroup trees
Radek Krejci8678fa42020-08-18 16:07:28 +0200147 * @defgroup schematree Schema Tree
Radek Krejci2ff0d572020-05-21 15:27:28 +0200148 * @{
149 *
150 * Data structures and functions to manipulate and access schema tree.
151 */
152
Michal Vasko64246d82020-08-19 12:35:00 +0200153/* *INDENT-OFF* */
154
Radek Krejci2ff0d572020-05-21 15:27:28 +0200155/**
Michal Vasko208a04a2020-10-21 15:17:12 +0200156 * @brief Macro to iterate via all elements in a schema (sub)tree including input and output.
157 * Note that __actions__ and __notifications__ of traversed nodes __are ignored__! To traverse
158 * on all the nodes including those, use ::lysc_tree_dfs_full() instead.
159 *
160 * This is the opening part to the #LYSC_TREE_DFS_END - they always have to be used together.
Radek Krejci0935f412019-08-20 16:15:18 +0200161 *
162 * The function follows deep-first search algorithm:
163 * <pre>
164 * 1
165 * / \
166 * 2 4
167 * / / \
168 * 3 5 6
169 * </pre>
170 *
171 * Use the same parameters for #LYSC_TREE_DFS_BEGIN and #LYSC_TREE_DFS_END. While
Radek Krejci2a9fc652021-01-22 17:44:34 +0100172 * START can be any of the lysc_node* types (including lysc_node_action and lysc_node_notif),
Radek Krejci0935f412019-08-20 16:15:18 +0200173 * ELEM variable must be of the struct lysc_node* type.
174 *
175 * To skip a particular subtree, instead of the continue statement, set LYSC_TREE_DFS_continue
176 * variable to non-zero value.
177 *
178 * Use with opening curly bracket '{' after the macro.
179 *
180 * @param START Pointer to the starting element processed first.
181 * @param ELEM Iterator intended for use in the block.
182 */
183#define LYSC_TREE_DFS_BEGIN(START, ELEM) \
Radek Krejci857189e2020-09-01 13:26:36 +0200184 { ly_bool LYSC_TREE_DFS_continue = 0; struct lysc_node *LYSC_TREE_DFS_next; \
Michal Vasko14ed9cd2021-01-28 14:16:25 +0100185 for ((ELEM) = (LYSC_TREE_DFS_next) = (struct lysc_node *)(START); \
Radek Krejci0935f412019-08-20 16:15:18 +0200186 (ELEM); \
187 (ELEM) = (LYSC_TREE_DFS_next), LYSC_TREE_DFS_continue = 0)
188
189/**
190 * @brief Macro to iterate via all elements in a (sub)tree. This is the closing part
191 * to the #LYSC_TREE_DFS_BEGIN - they always have to be used together.
192 *
193 * Use the same parameters for #LYSC_TREE_DFS_BEGIN and #LYSC_TREE_DFS_END. While
Radek Krejci2a9fc652021-01-22 17:44:34 +0100194 * START can be a pointer to any of the lysc_node* types (including lysc_node_action and lysc_node_notif),
Radek Krejci0935f412019-08-20 16:15:18 +0200195 * ELEM variable must be pointer to the lysc_node type.
196 *
197 * Use with closing curly bracket '}' after the macro.
198 *
199 * @param START Pointer to the starting element processed first.
200 * @param ELEM Iterator intended for use in the block.
201 */
Radek Krejci0935f412019-08-20 16:15:18 +0200202#define LYSC_TREE_DFS_END(START, ELEM) \
203 /* select element for the next run - children first */ \
204 if (LYSC_TREE_DFS_continue) { \
205 (LYSC_TREE_DFS_next) = NULL; \
206 } else { \
Michal Vasko544e58a2021-01-28 14:33:41 +0100207 (LYSC_TREE_DFS_next) = (struct lysc_node *)lysc_node_child(ELEM); \
Michal Vasko208a04a2020-10-21 15:17:12 +0200208 } \
Radek Krejci0935f412019-08-20 16:15:18 +0200209 if (!(LYSC_TREE_DFS_next)) { \
Michal Vasko208a04a2020-10-21 15:17:12 +0200210 /* no children, try siblings */ \
211 _LYSC_TREE_DFS_NEXT(START, ELEM, LYSC_TREE_DFS_next); \
Radek Krejci0935f412019-08-20 16:15:18 +0200212 } \
213 while (!(LYSC_TREE_DFS_next)) { \
214 /* parent is already processed, go to its sibling */ \
Radek Krejci7d95fbb2021-01-26 17:33:13 +0100215 (ELEM) = (ELEM)->parent; \
Michal Vasko208a04a2020-10-21 15:17:12 +0200216 _LYSC_TREE_DFS_NEXT(START, ELEM, LYSC_TREE_DFS_next); \
217 } }
218
219/**
220 * @brief Helper macro for #LYSC_TREE_DFS_END, should not be used directly!
221 */
222#define _LYSC_TREE_DFS_NEXT(START, ELEM, NEXT) \
223 if ((ELEM) == (struct lysc_node *)(START)) { \
224 /* we are done, no next element to process */ \
225 break; \
226 } \
Michal Vasko544e58a2021-01-28 14:33:41 +0100227 (NEXT) = (ELEM)->next;
Radek Krejci0935f412019-08-20 16:15:18 +0200228
Michal Vasko64246d82020-08-19 12:35:00 +0200229/* *INDENT-ON* */
230
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200231#define LY_REV_SIZE 11 /**< revision data string length (including terminating NULL byte) */
232
Radek Krejcide7a9c42021-03-10 13:13:06 +0100233/**
234 * @defgroup schemanodetypes Schema Node Types
235 * Values of the ::lysp_node.nodetype and ::lysc_node.nodetype members.
236 * @{
237 */
Michal Vasko7f45cf22020-10-01 12:49:44 +0200238#define LYS_UNKNOWN 0x0000 /**< uninitalized unknown statement node */
239#define LYS_CONTAINER 0x0001 /**< container statement node */
240#define LYS_CHOICE 0x0002 /**< choice statement node */
241#define LYS_LEAF 0x0004 /**< leaf statement node */
242#define LYS_LEAFLIST 0x0008 /**< leaf-list statement node */
243#define LYS_LIST 0x0010 /**< list statement node */
244#define LYS_ANYXML 0x0020 /**< anyxml statement node */
245#define LYS_ANYDATA 0x0060 /**< anydata statement node, in tests it can be used for both #LYS_ANYXML and #LYS_ANYDATA */
246#define LYS_CASE 0x0080 /**< case statement node */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200247
Michal Vasko7f45cf22020-10-01 12:49:44 +0200248#define LYS_RPC 0x0100 /**< RPC statement node */
249#define LYS_ACTION 0x0200 /**< action statement node */
250#define LYS_NOTIF 0x0400 /**< notification statement node */
Radek Krejcie7b95092019-05-15 11:03:07 +0200251
Michal Vasko7f45cf22020-10-01 12:49:44 +0200252#define LYS_USES 0x0800 /**< uses statement node */
253#define LYS_INPUT 0x1000 /**< RPC/action input node */
254#define LYS_OUTPUT 0x2000 /**< RPC/action output node */
255#define LYS_GROUPING 0x4000
256#define LYS_AUGMENT 0x8000
Radek Krejci6d9b9b52018-11-02 12:43:39 +0100257
Radek Krejcif13b87b2020-12-01 22:02:17 +0100258#define LYS_NODETYPE_MASK 0xffff /**< Mask for nodetypes, the value is limited for 16 bits */
Radek Krejcide7a9c42021-03-10 13:13:06 +0100259/** @} schemanodetypes */
Radek Krejcif13b87b2020-12-01 22:02:17 +0100260
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200261/**
Radek Krejci61837f72021-03-02 19:53:59 +0100262 * @brief Generic test for operation statements.
263 *
264 * This macro matches a subset of schema nodes that maps to common ::lysc_node or ::lysp_node structures. To match all
265 * such nodes, use ::LY_STMT_IS_NODE()
266 *
267 * This macro matches action and RPC.
Radek Krejci6b88a462021-02-17 12:39:34 +0100268 */
269#define LY_STMT_IS_OP(STMT) (((STMT) == LY_STMT_ACTION) || ((STMT) == LY_STMT_RPC))
270
271/**
Radek Krejci61837f72021-03-02 19:53:59 +0100272 * @brief Generic test for schema data nodes.
Radek Krejci6b88a462021-02-17 12:39:34 +0100273 *
Radek Krejci61837f72021-03-02 19:53:59 +0100274 * This macro matches a subset of schema nodes that maps to common ::lysc_node or ::lysp_node structures. To match all
275 * such nodes, use ::LY_STMT_IS_NODE()
Radek Krejci6b88a462021-02-17 12:39:34 +0100276 *
Radek Krejci61837f72021-03-02 19:53:59 +0100277 * This macro matches anydata, anyxml, augment, case, choice, container, grouping, leaf, leaf-list, list and uses. Note
278 * that the list of statements that can appear in parsed or compiled schema trees differs (e.g. no uses in compiled tree).
Radek Krejci6b88a462021-02-17 12:39:34 +0100279 */
Radek Krejci61837f72021-03-02 19:53:59 +0100280#define LY_STMT_IS_DATA_NODE(STMT) (((STMT) >= LY_STMT_ANYDATA) && ((STMT) <= LY_STMT_LIST))
281
282/**
283 * @brief Generic test for any schema node that maps to common ::lysc_node or ::lysp_node structures.
284 *
285 * Note that the list of statements that can appear in parsed or compiled schema trees differs (e.g. no uses in compiled tree).
286 *
287 * To check for some of the subsets of this test, try ::LY_STMT_IS_DATA_NODE() or ::LY_STMT_IS_OP().
288 *
289 * This macro matches action, anydata, anyxml, augment, case, choice, container, grouping, input, leaf, leaf-list, list,
290 * notification, output, RPC and uses.
291 */
292#define LY_STMT_IS_NODE(STMT) (((STMT) >= LY_STMT_NOTIFICATION) && ((STMT) <= LY_STMT_LIST))
Radek Krejci6b88a462021-02-17 12:39:34 +0100293
294/**
Radek Krejcid6b76452019-09-03 17:03:03 +0200295 * @brief List of YANG statements
296 */
297enum ly_stmt {
298 LY_STMT_NONE = 0,
Radek Krejci6b88a462021-02-17 12:39:34 +0100299
300 LY_STMT_NOTIFICATION, /**< in ::lysc_ext_substmt.storage stored as a pointer to linked list of `struct lysc_node_notif *`.
301 The RPCs/Actions and Notifications are expected in a separated lists than the rest of
302 data definition nodes as it is done in generic structures of libyang. */
Radek Krejci61837f72021-03-02 19:53:59 +0100303 LY_STMT_INPUT,
304 LY_STMT_OUTPUT,
Radek Krejci6b88a462021-02-17 12:39:34 +0100305
306/* LY_STMT_IS_OP */
Radek Krejcieccf6602021-02-05 19:42:54 +0100307 LY_STMT_ACTION, /**< in ::lysc_ext_substmt.storage stored as a pointer to linked list of `struct lysc_node_action *`.
Radek Krejci6b88a462021-02-17 12:39:34 +0100308 The RPCs/Actions and Notifications are expected in a separated lists than the rest of
309 data definition nodes as it is done in generic structures of libyang. */
310 LY_STMT_RPC, /**< in ::lysc_ext_substmt.storage stored as a pointer to linked list of `struct lysc_node_action *`.
311 The RPCs/Actions and Notifications are expected in a separated lists than the rest of
312 data definition nodes as it is done in generic structures of libyang. */
313
Radek Krejci61837f72021-03-02 19:53:59 +0100314/* LY_STMT_IS_DATA_NODE */
Radek Krejcieccf6602021-02-05 19:42:54 +0100315 LY_STMT_ANYDATA, /**< in ::lysc_ext_substmt.storage stored as a pointer to linked list of `struct lysc_node *`.
Radek Krejci6b88a462021-02-17 12:39:34 +0100316 Note that due to ::lysc_node compatibility the anydata is expected to be actually
317 mixed in the linked list with other ::lysc_node based nodes. The RPCs/Actions and
318 Notifications are expected in a separated lists as it is done in generic structures
319 of libyang. */
Radek Krejcieccf6602021-02-05 19:42:54 +0100320 LY_STMT_ANYXML, /**< in ::lysc_ext_substmt.storage stored as a pointer to linked list of `struct lysc_node *`.
Radek Krejci6b88a462021-02-17 12:39:34 +0100321 Note that due to ::lysc_node compatibility the anyxml is expected to be actually
322 mixed in the linked list with other ::lysc_node based nodes. The RPCs/Actions and
323 Notifications are expected in a separated lists as it is done in generic structures
324 of libyang. */
325 LY_STMT_AUGMENT,
326 LY_STMT_CASE, /**< TODO is it possible to compile cases without the parent choice? */
327 LY_STMT_CHOICE, /**< in ::lysc_ext_substmt.storage stored as a pointer to linked list of `struct lysc_node *`.
328 Note that due to ::lysc_node compatibility the choice is expected to be actually
329 mixed in the linked list with other ::lysc_node based nodes. The RPCs/Actions and
330 Notifications are expected in a separated lists as it is done in generic structures
331 of libyang. */
332 LY_STMT_CONTAINER, /**< in ::lysc_ext_substmt.storage stored as a pointer to linked list of `struct lysc_node *`.
333 Note that due to ::lysc_node compatibility the container is expected to be actually
334 mixed in the linked list with other ::lysc_node based nodes. The RPCs/Actions and
335 Notifications are expected in a separated lists as it is done in generic structures
336 of libyang. */
337 LY_STMT_GROUPING,
338 LY_STMT_LEAF, /**< in ::lysc_ext_substmt.storage stored as a pointer to linked list of `struct lysc_node *`.
339 Note that due to ::lysc_node compatibility the leaf is expected to be actually
340 mixed in the linked list with other ::lysc_node based nodes. The RPCs/Actions and
341 Notifications are expected in a separated lists as it is done in generic structures
342 of libyang. */
343 LY_STMT_LEAF_LIST, /**< in ::lysc_ext_substmt.storage stored as a pointer to linked list of `struct lysc_node *`.
344 Note that due to ::lysc_node compatibility the leaf-list is expected to be actually
345 mixed in the linked list with other ::lysc_node based nodes. The RPCs/Actions and
346 Notifications are expected in a separated lists as it is done in generic structures
347 of libyang. */
348 LY_STMT_LIST, /**< in ::lysc_ext_substmt.storage stored as a pointer to linked list of `struct lysc_node *`.
349 Note that due to ::lysc_node compatibility the list is expected to be actually
350 mixed in the linked list with other ::lysc_node based nodes. The RPCs/Actions and
351 Notifications are expected in a separated lists as it is done in generic structures
352 of libyang. */
353 LY_STMT_USES,
354
355/* rest */
Radek Krejcid6b76452019-09-03 17:03:03 +0200356 LY_STMT_ARGUMENT,
Radek Krejcid6b76452019-09-03 17:03:03 +0200357 LY_STMT_BASE,
358 LY_STMT_BELONGS_TO,
359 LY_STMT_BIT,
Radek Krejcieccf6602021-02-05 19:42:54 +0100360 LY_STMT_CONFIG, /**< in ::lysc_ext_substmt.storage stored as a pointer to `uint16_t`, only cardinality < #LY_STMT_CARD_SOME is allowed */
Radek Krejcid6b76452019-09-03 17:03:03 +0200361 LY_STMT_CONTACT,
Radek Krejcieccf6602021-02-05 19:42:54 +0100362 LY_STMT_DEFAULT,
Radek Krejci6b88a462021-02-17 12:39:34 +0100363 LY_STMT_DESCRIPTION, /**< in ::lysc_ext_substmt.storage stored as a pointer to `const char *` (cardinality < #LY_STMT_CARD_SOME)
364 or as a pointer to a [sized array](@ref sizedarrays) `const char **` */
Radek Krejcid6b76452019-09-03 17:03:03 +0200365 LY_STMT_DEVIATE,
366 LY_STMT_DEVIATION,
367 LY_STMT_ENUM,
368 LY_STMT_ERROR_APP_TAG,
369 LY_STMT_ERROR_MESSAGE,
370 LY_STMT_EXTENSION,
Radek Krejcieccf6602021-02-05 19:42:54 +0100371 LY_STMT_EXTENSION_INSTANCE,
Radek Krejcid6b76452019-09-03 17:03:03 +0200372 LY_STMT_FEATURE,
373 LY_STMT_FRACTION_DIGITS,
Radek Krejcid6b76452019-09-03 17:03:03 +0200374 LY_STMT_IDENTITY,
Radek Krejci6b88a462021-02-17 12:39:34 +0100375 LY_STMT_IF_FEATURE, /**< if-feature statements are not compiled, they are evaluated and the parent statement is
376 preserved only in case the evaluation of all the if-feature statements is true.
377 Therefore there is no storage expected. */
Radek Krejcid6b76452019-09-03 17:03:03 +0200378 LY_STMT_IMPORT,
379 LY_STMT_INCLUDE,
Radek Krejcid6b76452019-09-03 17:03:03 +0200380 LY_STMT_KEY,
Radek Krejcid6b76452019-09-03 17:03:03 +0200381 LY_STMT_LENGTH,
Radek Krejcieccf6602021-02-05 19:42:54 +0100382 LY_STMT_MANDATORY, /**< in ::lysc_ext_substmt.storage stored as a pointer to `uint16_t`, only cardinality < #LY_STMT_CARD_SOME is allowed */
Radek Krejcid6b76452019-09-03 17:03:03 +0200383 LY_STMT_MAX_ELEMENTS,
384 LY_STMT_MIN_ELEMENTS,
385 LY_STMT_MODIFIER,
386 LY_STMT_MODULE,
387 LY_STMT_MUST,
388 LY_STMT_NAMESPACE,
Radek Krejcid6b76452019-09-03 17:03:03 +0200389 LY_STMT_ORDERED_BY,
390 LY_STMT_ORGANIZATION,
Radek Krejcid6b76452019-09-03 17:03:03 +0200391 LY_STMT_PATH,
392 LY_STMT_PATTERN,
393 LY_STMT_POSITION,
394 LY_STMT_PREFIX,
395 LY_STMT_PRESENCE,
396 LY_STMT_RANGE,
Radek Krejci6b88a462021-02-17 12:39:34 +0100397 LY_STMT_REFERENCE, /**< in ::lysc_ext_substmt.storage stored as a pointer to `const char *` (cardinality < #LY_STMT_CARD_SOME)
398 or as a pointer to a [sized array](@ref sizedarrays) `const char **` */
Radek Krejcid6b76452019-09-03 17:03:03 +0200399 LY_STMT_REFINE,
400 LY_STMT_REQUIRE_INSTANCE,
401 LY_STMT_REVISION,
402 LY_STMT_REVISION_DATE,
Radek Krejcieccf6602021-02-05 19:42:54 +0100403 LY_STMT_STATUS, /**< in ::lysc_ext_substmt.storage stored as a pointer to `uint16_t`, only cardinality < #LY_STMT_CARD_SOME is allowed */
Radek Krejcid6b76452019-09-03 17:03:03 +0200404 LY_STMT_SUBMODULE,
Radek Krejcieccf6602021-02-05 19:42:54 +0100405 LY_STMT_TYPE, /**< in ::lysc_ext_substmt.storage stored as a pointer to `struct lysc_type *` (cardinality < #LY_STMT_CARD_SOME)
406 or as a pointer to a [sized array](@ref sizedarrays) `struct lysc_type **` */
Radek Krejcid6b76452019-09-03 17:03:03 +0200407 LY_STMT_TYPEDEF,
408 LY_STMT_UNIQUE,
Radek Krejcieccf6602021-02-05 19:42:54 +0100409 LY_STMT_UNITS, /**< in ::lysc_ext_substmt.storage stored as a pointer to `const char *` (cardinality < #LY_STMT_CARD_SOME)
410 or as a pointer to a [sized array](@ref sizedarrays) `const char **` */
Radek Krejcid6b76452019-09-03 17:03:03 +0200411 LY_STMT_VALUE,
412 LY_STMT_WHEN,
413 LY_STMT_YANG_VERSION,
Radek Krejci2b0f0f12021-03-02 16:02:35 +0100414 LY_STMT_YIN_ELEMENT,
415
416 /* separated from the list of statements
417 * the following tokens are part of the syntax and parsers have to work
418 * with them, but they are not a standard YANG statements
419 */
420 LY_STMT_SYNTAX_SEMICOLON,
421 LY_STMT_SYNTAX_LEFT_BRACE,
422 LY_STMT_SYNTAX_RIGHT_BRACE,
423
424 /*
425 * YIN-specific tokens, still they are part of the syntax, but not the standard statements
426 */
427 LY_STMT_ARG_TEXT,
428 LY_STMT_ARG_VALUE
Radek Krejcid6b76452019-09-03 17:03:03 +0200429};
430
431/**
Radek Krejcif8ca8192021-03-02 16:50:06 +0100432 * @brief Stringify statement identifier.
433 * @param[in] stmt The statement identifier to stringify.
434 * @return Constant string representation of the given @p stmt.
435 */
Jan Kundrátc53a7ec2021-12-09 16:01:19 +0100436LIBYANG_API_DECL const char *ly_stmt2str(enum ly_stmt stmt);
Radek Krejcif8ca8192021-03-02 16:50:06 +0100437
438/**
Radek Krejci39b7fc22021-02-26 23:29:18 +0100439 * @brief Convert nodetype to statement identifier
440 * @param[in] nodetype Nodetype to convert.
441 * @return Statement identifier representing the given @p nodetype.
442 */
Jan Kundrátc53a7ec2021-12-09 16:01:19 +0100443LIBYANG_API_DECL enum ly_stmt lys_nodetype2stmt(uint16_t nodetype);
Radek Krejci39b7fc22021-02-26 23:29:18 +0100444
445/**
Radek Krejcib1c11532021-03-29 14:14:19 +0200446 * @brief Possible cardinalities of the YANG statements.
447 *
448 * Used in extensions plugins to define cardinalities of the extension instance substatements.
449 */
450enum ly_stmt_cardinality {
451 LY_STMT_CARD_OPT, /* 0..1 */
452 LY_STMT_CARD_MAND, /* 1 */
453 LY_STMT_CARD_SOME, /* 1..n */
454 LY_STMT_CARD_ANY /* 0..n */
455};
456
457/**
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200458 * @brief YANG import-stmt
459 */
460struct lysp_import {
Radek Krejci086c7132018-10-26 15:29:04 +0200461 struct lys_module *module; /**< pointer to the imported module
462 (mandatory, but resolved when the referring module is completely parsed) */
463 const char *name; /**< name of the imported module (mandatory) */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200464 const char *prefix; /**< prefix for the data from the imported schema (mandatory) */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200465 const char *dsc; /**< description */
466 const char *ref; /**< reference */
Radek Krejcie53a8dc2018-10-17 12:52:40 +0200467 struct lysp_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
Michal Vasko3e9bc2f2020-11-04 17:13:56 +0100468 uint16_t flags; /**< LYS_INTERNAL value (@ref snodeflags) */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200469 char rev[LY_REV_SIZE]; /**< revision-date of the imported module */
470};
471
472/**
473 * @brief YANG include-stmt
474 */
475struct lysp_include {
Radek Krejci0bcdaed2019-01-10 10:21:34 +0100476 struct lysp_submodule *submodule;/**< pointer to the parsed submodule structure
Radek Krejci086c7132018-10-26 15:29:04 +0200477 (mandatory, but resolved when the referring module is completely parsed) */
478 const char *name; /**< name of the included submodule (mandatory) */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200479 const char *dsc; /**< description */
480 const char *ref; /**< reference */
Radek Krejcie53a8dc2018-10-17 12:52:40 +0200481 struct lysp_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200482 char rev[LY_REV_SIZE]; /**< revision-date of the included submodule */
Radek Krejci771928a2021-01-19 13:42:36 +0100483 ly_bool injected; /**< flag to mark includes copied into main module from submodules,
484 only for backward compatibility with YANG 1.0, which does not require the
485 main module to include all submodules. */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200486};
487
488/**
489 * @brief YANG extension-stmt
490 */
491struct lysp_ext {
492 const char *name; /**< extension name */
Radek Krejci9f87b0c2021-03-05 14:45:26 +0100493 const char *argname; /**< argument name, NULL if not specified */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200494 const char *dsc; /**< description statement */
495 const char *ref; /**< reference statement */
Radek Krejcie53a8dc2018-10-17 12:52:40 +0200496 struct lysp_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
Radek Krejcif56e2a42019-09-09 14:15:25 +0200497 uint16_t flags; /**< LYS_STATUS_* and LYS_YINELEM_* values (@ref snodeflags) */
Michal Vasko5fe75f12020-03-02 13:52:37 +0100498
Radek Krejci720d2612021-03-03 19:44:22 +0100499 struct lysc_ext *compiled; /**< pointer to the compiled extension definition.
500 The extension definition is compiled only if there is compiled extension instance,
501 otherwise this pointer remains NULL. The compiled extension definition is shared
502 among all extension instances. */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200503};
504
505/**
506 * @brief Helper structure for generic storage of the extension instances content.
507 */
508struct lysp_stmt {
509 const char *stmt; /**< identifier of the statement */
510 const char *arg; /**< statement's argument */
Radek Krejci8df109d2021-04-23 12:19:08 +0200511 LY_VALUE_FORMAT format; /**< prefix format of the identifier/argument (::LY_VALUE_XML is YIN format) */
Radek Krejci0b013302021-03-29 15:22:32 +0200512 void *prefix_data; /**< Format-specific data for prefix resolution (see ly_resolve_prefix()) */
Michal Vaskofc2cd072021-02-24 13:17:17 +0100513
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200514 struct lysp_stmt *next; /**< link to the next statement */
Michal Vaskobc2559f2018-09-07 10:17:50 +0200515 struct lysp_stmt *child; /**< list of the statement's substatements (linked list) */
David Sedlákb9d75c42019-08-14 10:49:42 +0200516 uint16_t flags; /**< statement flags, can be set to LYS_YIN_ATTR */
Radek Krejci335332a2019-09-05 13:03:35 +0200517 enum ly_stmt kw; /**< numeric respresentation of the stmt value */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200518};
519
David Sedlákae4b4512019-08-14 10:45:56 +0200520#define LYS_YIN 0x1 /**< used to specify input format of extension instance */
521
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200522/**
523 * @brief YANG extension instance
524 */
525struct lysp_ext_instance {
David Sedlákbbd06ca2019-06-27 14:15:38 +0200526 const char *name; /**< extension identifier, including possible prefix */
527 const char *argument; /**< optional value of the extension's argument */
aPiecek60d9d672021-04-27 15:49:57 +0200528 LY_VALUE_FORMAT format; /**< prefix format of the extension name/argument (::LY_VALUE_XML is YIN format) */
529 struct lysp_node *parsed; /**< Simply parsed (unresolved) YANG schema tree serving as a cache.
530 Only lys_compile_extension_instance() can set this. */
Michal Vaskofc2cd072021-02-24 13:17:17 +0100531 void *prefix_data; /**< Format-specific data for prefix resolution
Radek Krejci0b013302021-03-29 15:22:32 +0200532 (see ly_resolve_prefix()) */
Michal Vaskofc2cd072021-02-24 13:17:17 +0100533
Radek Krejci5f9a3672021-03-05 21:35:22 +0100534 struct lysp_stmt *child; /**< list of the extension's substatements (linked list) */
535
Radek Krejci335332a2019-09-05 13:03:35 +0200536 void *parent; /**< pointer to the parent element holding the extension instance(s), use
Radek Krejciab430862021-03-02 20:13:40 +0100537 ::lysp_ext_instance#parent_stmt to access the schema element */
Radek Krejciab430862021-03-02 20:13:40 +0100538 enum ly_stmt parent_stmt; /**< value identifying placement of the extension instance */
539 LY_ARRAY_COUNT_TYPE parent_stmt_index; /**< in case the instance is in a substatement, this identifies
540 the index of that substatement in its [sized array](@ref sizedarrays) (if any) */
Michal Vasko3e9bc2f2020-11-04 17:13:56 +0100541 uint16_t flags; /**< LYS_INTERNAL value (@ref snodeflags) */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200542};
543
544/**
545 * @brief YANG feature-stmt
546 */
547struct lysp_feature {
548 const char *name; /**< feature name (mandatory) */
Michal Vasko7b1ad1a2020-11-02 15:41:27 +0100549 struct lysp_qname *iffeatures; /**< list of if-feature expressions ([sized array](@ref sizedarrays)) */
550 struct lysc_iffeature *iffeatures_c; /**< compiled if-features */
551 struct lysp_feature **depfeatures; /**< list of pointers to other features depending on this one
552 ([sized array](@ref sizedarrays)) */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200553 const char *dsc; /**< description statement */
554 const char *ref; /**< reference statement */
Radek Krejcie53a8dc2018-10-17 12:52:40 +0200555 struct lysp_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
Michal Vasko7b1ad1a2020-11-02 15:41:27 +0100556 uint16_t flags; /**< [schema node flags](@ref snodeflags) - only LYS_STATUS_* values and
557 LYS_FENABLED are allowed */
558};
559
560/**
561 * @brief Compiled YANG if-feature-stmt
562 */
563struct lysc_iffeature {
564 uint8_t *expr; /**< 2bits array describing the if-feature expression in prefix format, see @ref ifftokens */
565 struct lysp_feature **features; /**< array of pointers to the features used in expression ([sized array](@ref sizedarrays)) */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200566};
567
568/**
Michal Vasko7f45cf22020-10-01 12:49:44 +0200569 * @brief Qualified name (optional prefix followed by an identifier).
570 */
571struct lysp_qname {
572 const char *str; /**< qualified name string */
Michal Vasko5d24f6c2020-10-13 13:49:06 +0200573 const struct lysp_module *mod; /**< module to resolve any prefixes found in the string, it must be
Michal Vasko7f45cf22020-10-01 12:49:44 +0200574 stored explicitly because of deviations/refines */
575};
576
577/**
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200578 * @brief YANG identity-stmt
579 */
580struct lysp_ident {
581 const char *name; /**< identity name (mandatory), including possible prefix */
Michal Vasko7f45cf22020-10-01 12:49:44 +0200582 struct lysp_qname *iffeatures; /**< list of if-feature expressions ([sized array](@ref sizedarrays)) */
Radek Krejci151a5b72018-10-19 14:21:44 +0200583 const char **bases; /**< list of base identifiers ([sized array](@ref sizedarrays)) */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200584 const char *dsc; /**< description statement */
585 const char *ref; /**< reference statement */
Radek Krejcie53a8dc2018-10-17 12:52:40 +0200586 struct lysp_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200587 uint16_t flags; /**< [schema node flags](@ref snodeflags) - only LYS_STATUS_ values are allowed */
588};
589
Michal Vasko71e64ca2018-09-07 16:30:29 +0200590/**
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200591 * @brief Covers restrictions: range, length, pattern, must
592 */
593struct lysp_restr {
Radek Krejcif13b87b2020-12-01 22:02:17 +0100594#define LYSP_RESTR_PATTERN_ACK 0x06
595#define LYSP_RESTR_PATTERN_NACK 0x15
Michal Vasko7f45cf22020-10-01 12:49:44 +0200596 struct lysp_qname arg; /**< The restriction expression/value (mandatory);
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200597 in case of pattern restriction, the first byte has a special meaning:
598 0x06 (ACK) for regular match and 0x15 (NACK) for invert-match */
599 const char *emsg; /**< error-message */
600 const char *eapptag; /**< error-app-tag value */
601 const char *dsc; /**< description */
602 const char *ref; /**< reference */
Radek Krejcie53a8dc2018-10-17 12:52:40 +0200603 struct lysp_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200604};
605
606/**
Michal Vasko71e64ca2018-09-07 16:30:29 +0200607 * @brief YANG revision-stmt
608 */
609struct lysp_revision {
Radek Krejcicb3e6472021-01-06 08:19:01 +0100610 char date[LY_REV_SIZE]; /**< revision date (madatory) */
Michal Vasko71e64ca2018-09-07 16:30:29 +0200611 const char *dsc; /**< description statement */
612 const char *ref; /**< reference statement */
Radek Krejcie53a8dc2018-10-17 12:52:40 +0200613 struct lysp_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
Michal Vasko71e64ca2018-09-07 16:30:29 +0200614};
615
616/**
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200617 * @brief Enumeration/Bit value definition
618 */
619struct lysp_type_enum {
620 const char *name; /**< name (mandatory) */
621 const char *dsc; /**< description statement */
622 const char *ref; /**< reference statement */
Michal Vaskob55f6c12018-09-12 11:13:15 +0200623 int64_t value; /**< enum's value or bit's position */
Michal Vasko7f45cf22020-10-01 12:49:44 +0200624 struct lysp_qname *iffeatures; /**< list of if-feature expressions ([sized array](@ref sizedarrays)) */
Radek Krejcie53a8dc2018-10-17 12:52:40 +0200625 struct lysp_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
Michal Vaskob55f6c12018-09-12 11:13:15 +0200626 uint16_t flags; /**< [schema node flags](@ref snodeflags) - only LYS_STATUS_ and LYS_SET_VALUE
627 values are allowed */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200628};
629
630/**
631 * @brief YANG type-stmt
632 *
633 * Some of the items in the structure may be mandatory, but it is necessary to resolve the type's base type first
634 */
635struct lysp_type {
636 const char *name; /**< name of the type (mandatory) */
637 struct lysp_restr *range; /**< allowed values range - numerical, decimal64 */
638 struct lysp_restr *length; /**< allowed length of the value - string, binary */
Radek Krejcie53a8dc2018-10-17 12:52:40 +0200639 struct lysp_restr *patterns; /**< list of patterns ([sized array](@ref sizedarrays)) - string */
640 struct lysp_type_enum *enums; /**< list of enum-stmts ([sized array](@ref sizedarrays)) - enum */
641 struct lysp_type_enum *bits; /**< list of bit-stmts ([sized array](@ref sizedarrays)) - bits */
Michal Vasko004d3152020-06-11 19:59:22 +0200642 struct lyxp_expr *path; /**< parsed path - leafref */
Radek Krejci151a5b72018-10-19 14:21:44 +0200643 const char **bases; /**< list of base identifiers ([sized array](@ref sizedarrays)) - identityref */
Radek Krejcie53a8dc2018-10-17 12:52:40 +0200644 struct lysp_type *types; /**< list of sub-types ([sized array](@ref sizedarrays)) - union */
645 struct lysp_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200646
Michal Vasko5d24f6c2020-10-13 13:49:06 +0200647 const struct lysp_module *pmod; /**< (sub)module where the type is defined (needed for deviations) */
Radek Krejci2167ee12018-11-02 16:09:07 +0100648 struct lysc_type *compiled; /**< pointer to the compiled type */
649
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200650 uint8_t fraction_digits; /**< number of fraction digits - decimal64 */
651 uint8_t require_instance; /**< require-instance flag - leafref, instance */
Radek Krejci4f28eda2018-11-12 11:46:16 +0100652 uint16_t flags; /**< [schema node flags](@ref spnodeflags) */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200653};
654
655/**
656 * @brief YANG typedef-stmt
657 */
658struct lysp_tpdf {
659 const char *name; /**< name of the newly defined type (mandatory) */
660 const char *units; /**< units of the newly defined type */
Michal Vasko7f45cf22020-10-01 12:49:44 +0200661 struct lysp_qname dflt; /**< default value of the newly defined type, it may or may not be a qualified name */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200662 const char *dsc; /**< description statement */
663 const char *ref; /**< reference statement */
Radek Krejcie53a8dc2018-10-17 12:52:40 +0200664 struct lysp_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200665 struct lysp_type type; /**< base type from which the typedef is derived (mandatory) */
Radek Krejci4f28eda2018-11-12 11:46:16 +0100666 uint16_t flags; /**< [schema node flags](@ref spnodeflags) */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200667};
668
669/**
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200670 * @brief YANG when-stmt
671 */
672struct lysp_when {
673 const char *cond; /**< specified condition (mandatory) */
674 const char *dsc; /**< description statement */
675 const char *ref; /**< reference statement */
Radek Krejcie53a8dc2018-10-17 12:52:40 +0200676 struct lysp_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200677};
678
679/**
680 * @brief YANG refine-stmt
681 */
682struct lysp_refine {
683 const char *nodeid; /**< target descendant schema nodeid (mandatory) */
684 const char *dsc; /**< description statement */
685 const char *ref; /**< reference statement */
Michal Vasko7f45cf22020-10-01 12:49:44 +0200686 struct lysp_qname *iffeatures; /**< list of if-feature expressions ([sized array](@ref sizedarrays)) */
Radek Krejcie53a8dc2018-10-17 12:52:40 +0200687 struct lysp_restr *musts; /**< list of must restrictions ([sized array](@ref sizedarrays)) */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200688 const char *presence; /**< presence description */
Michal Vasko5d24f6c2020-10-13 13:49:06 +0200689 struct lysp_qname *dflts; /**< list of default values ([sized array](@ref sizedarrays)) */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200690 uint32_t min; /**< min-elements constraint */
691 uint32_t max; /**< max-elements constraint, 0 means unbounded */
Radek Krejcie53a8dc2018-10-17 12:52:40 +0200692 struct lysp_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200693 uint16_t flags; /**< [schema node flags](@ref snodeflags) */
694};
695
696/**
Radek Krejci8678fa42020-08-18 16:07:28 +0200697 * @ingroup schematree
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200698 * @defgroup deviatetypes Deviate types
Radek Krejci8678fa42020-08-18 16:07:28 +0200699 *
700 * Type of the deviate operation (used as ::lysp_deviate.mod)
701 *
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200702 * @{
703 */
704#define LYS_DEV_NOT_SUPPORTED 1 /**< deviate type not-supported */
705#define LYS_DEV_ADD 2 /**< deviate type add */
706#define LYS_DEV_DELETE 3 /**< deviate type delete */
707#define LYS_DEV_REPLACE 4 /**< deviate type replace */
Radek Krejci2ff0d572020-05-21 15:27:28 +0200708/** @} deviatetypes */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200709
710/**
711 * @brief Generic deviate structure to get type and cast to lysp_deviate_* structure
712 */
713struct lysp_deviate {
714 uint8_t mod; /**< [type](@ref deviatetypes) of the deviate modification */
715 struct lysp_deviate *next; /**< next deviate structure in the list */
Radek Krejcie53a8dc2018-10-17 12:52:40 +0200716 struct lysp_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200717};
718
719struct lysp_deviate_add {
720 uint8_t mod; /**< [type](@ref deviatetypes) of the deviate modification */
721 struct lysp_deviate *next; /**< next deviate structure in the list */
Radek Krejcie53a8dc2018-10-17 12:52:40 +0200722 struct lysp_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
Michal Vaskob55f6c12018-09-12 11:13:15 +0200723 const char *units; /**< units of the values */
Radek Krejcie53a8dc2018-10-17 12:52:40 +0200724 struct lysp_restr *musts; /**< list of must restrictions ([sized array](@ref sizedarrays)) */
Michal Vasko5d24f6c2020-10-13 13:49:06 +0200725 struct lysp_qname *uniques; /**< list of uniques specifications ([sized array](@ref sizedarrays)) */
726 struct lysp_qname *dflts; /**< list of default values ([sized array](@ref sizedarrays)) */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200727 uint16_t flags; /**< [schema node flags](@ref snodeflags) */
728 uint32_t min; /**< min-elements constraint */
729 uint32_t max; /**< max-elements constraint, 0 means unbounded */
730};
731
732struct lysp_deviate_del {
733 uint8_t mod; /**< [type](@ref deviatetypes) of the deviate modification */
734 struct lysp_deviate *next; /**< next deviate structure in the list */
Radek Krejcie53a8dc2018-10-17 12:52:40 +0200735 struct lysp_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
Michal Vaskob55f6c12018-09-12 11:13:15 +0200736 const char *units; /**< units of the values */
Radek Krejcie53a8dc2018-10-17 12:52:40 +0200737 struct lysp_restr *musts; /**< list of must restrictions ([sized array](@ref sizedarrays)) */
Michal Vasko5d24f6c2020-10-13 13:49:06 +0200738 struct lysp_qname *uniques; /**< list of uniques specifications ([sized array](@ref sizedarrays)) */
739 struct lysp_qname *dflts; /**< list of default values ([sized array](@ref sizedarrays)) */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200740};
741
742struct lysp_deviate_rpl {
743 uint8_t mod; /**< [type](@ref deviatetypes) of the deviate modification */
744 struct lysp_deviate *next; /**< next deviate structure in the list */
Radek Krejcie53a8dc2018-10-17 12:52:40 +0200745 struct lysp_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
Michal Vaskob55f6c12018-09-12 11:13:15 +0200746 struct lysp_type *type; /**< type of the node */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200747 const char *units; /**< units of the values */
Michal Vasko5d24f6c2020-10-13 13:49:06 +0200748 struct lysp_qname dflt; /**< default value */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200749 uint16_t flags; /**< [schema node flags](@ref snodeflags) */
750 uint32_t min; /**< min-elements constraint */
751 uint32_t max; /**< max-elements constraint, 0 means unbounded */
752};
753
754struct lysp_deviation {
Michal Vaskob55f6c12018-09-12 11:13:15 +0200755 const char *nodeid; /**< target absolute schema nodeid (mandatory) */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200756 const char *dsc; /**< description statement */
757 const char *ref; /**< reference statement */
Michal Vasko22df3f02020-08-24 13:29:22 +0200758 struct lysp_deviate *deviates; /**< list of deviate specifications (linked list) */
Radek Krejcie53a8dc2018-10-17 12:52:40 +0200759 struct lysp_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200760};
761
Radek Krejci4f28eda2018-11-12 11:46:16 +0100762/**
Radek Krejci4f28eda2018-11-12 11:46:16 +0100763 * @ingroup snodeflags
Radek Krejci8678fa42020-08-18 16:07:28 +0200764 * @defgroup spnodeflags Parsed schema nodes flags
Radek Krejci4f28eda2018-11-12 11:46:16 +0100765 *
Radek Krejci8678fa42020-08-18 16:07:28 +0200766 * Various flags for parsed schema nodes (used as ::lysp_node.flags).
Radek Krejci4f28eda2018-11-12 11:46:16 +0100767 *
768 * 1 - container 6 - anydata/anyxml 11 - output 16 - grouping 21 - enum
769 * 2 - choice 7 - case 12 - feature 17 - uses 22 - type
Radek Krejcid3ca0632019-04-16 16:54:54 +0200770 * 3 - leaf 8 - notification 13 - identity 18 - refine 23 - stmt
Radek Krejci4f28eda2018-11-12 11:46:16 +0100771 * 4 - leaflist 9 - rpc 14 - extension 19 - augment
772 * 5 - list 10 - input 15 - typedef 20 - deviate
773 *
Radek Krejcid3ca0632019-04-16 16:54:54 +0200774 * 1 1 1 1 1 1 1 1 1 1 2 2 2 2
775 * bit name 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3
776 * ---------------------+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
Michal Vasko5297a432020-08-31 12:27:51 +0200777 * 1 LYS_CONFIG_W |x|x|x|x|x|x| | | | | | | | | | | |x| |x| | | |
Radek Krejcid3ca0632019-04-16 16:54:54 +0200778 * LYS_SET_BASE | | | | | | | | | | | | | | | | | | | | | |x| |
779 * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
Michal Vasko5297a432020-08-31 12:27:51 +0200780 * 2 LYS_CONFIG_R |x|x|x|x|x|x| | | | | | | | | | | |x| |x| | | |
Radek Krejcid3ca0632019-04-16 16:54:54 +0200781 * LYS_SET_BIT | | | | | | | | | | | | | | | | | | | | | |x| |
782 * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
783 * 3 LYS_STATUS_CURR |x|x|x|x|x|x|x|x|x| | |x|x|x|x|x|x| |x|x|x| | |
784 * LYS_SET_ENUM | | | | | | | | | | | | | | | | | | | | | |x| |
785 * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
786 * 4 LYS_STATUS_DEPRC |x|x|x|x|x|x|x|x|x| | |x|x|x|x|x|x| |x|x|x| | |
787 * LYS_SET_FRDIGITS | | | | | | | | | | | | | | | | | | | | | |x| |
788 * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
789 * 5 LYS_STATUS_OBSLT |x|x|x|x|x|x|x|x|x| | |x|x|x|x|x|x| |x|x|x| | |
790 * LYS_SET_LENGTH | | | | | | | | | | | | | | | | | | | | | |x| |
791 * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
792 * 6 LYS_MAND_TRUE | |x|x| | |x| | | | | | | | | | | |x| |x| | | |
793 * LYS_SET_PATH | | | | | | | | | | | | | | | | | | | | | |x| |
Michal Vasko7b1ad1a2020-11-02 15:41:27 +0100794 * LYS_FENABLED | | | | | | | | | | | |x| | | | | | | | | | | |
Radek Krejcid3ca0632019-04-16 16:54:54 +0200795 * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
796 * 7 LYS_MAND_FALSE | |x|x| | |x| | | | | | | | | | | |x| |x| | | |
797 * LYS_ORDBY_USER | | | |x|x| | | | | | | | | | | | | | | | | | |
798 * LYS_SET_PATTERN | | | | | | | | | | | | | | | | | | | | | |x| |
799 * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
800 * 8 LYS_ORDBY_SYSTEM | | | |x|x| | | | | | | | | | | | | | | | | | |
801 * LYS_YINELEM_TRUE | | | | | | | | | | | | | |x| | | | | | | | | |
802 * LYS_SET_RANGE | | | | | | | | | | | | | | | | | | | | | |x| |
803 * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
804 * 9 LYS_YINELEM_FALSE| | | | | | | | | | | | | |x| | | | | | | | | |
805 * LYS_SET_TYPE | | | | | | | | | | | | | | | | | | | | | |x| |
806 * LYS_SINGLEQUOTED | | | | | | | | | | | | | | | | | | | | | | |x|
807 * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
808 * 10 LYS_SET_VALUE | | | | | | | | | | | | | | | | | | | | |x| | |
809 * LYS_SET_REQINST | | | | | | | | | | | | | | | | | | | | | |x| |
810 * LYS_SET_MIN | | | |x|x| | | | | | | | | | | | |x| |x| | | |
811 * LYS_DOUBLEQUOTED | | | | | | | | | | | | | | | | | | | | | | |x|
812 * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
813 * 11 LYS_SET_MAX | | | |x|x| | | | | | | | | | | | |x| |x| | | |
Radek Krejcif2de0ed2019-05-02 14:13:18 +0200814 * LYS_USED_GRP | | | | | | | | | | | | | | | |x| | | | | | | |
David Sedlákae4b4512019-08-14 10:45:56 +0200815 * LYS_YIN_ATTR | | | | | | | | | | | | | | | | | | | | | | |x|
Michal Vasko5297a432020-08-31 12:27:51 +0200816 * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
817 * 12 LYS_YIN_ARGUMENT | | | | | | | | | | | | | | | | | | | | | | |x|
Michal Vasko3e9bc2f2020-11-04 17:13:56 +0100818 * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
819 * 13 LYS_INTERNAL |x|x|x|x|x|x|x|x|x|x|x|x|x|x|x|x|x|x|x|x|x|x|x|
Radek Krejcif56e2a42019-09-09 14:15:25 +0200820 * ---------------------+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
Radek Krejci4f28eda2018-11-12 11:46:16 +0100821 *
822 */
823
824/**
Radek Krejci4f28eda2018-11-12 11:46:16 +0100825 * @ingroup snodeflags
Radek Krejci8678fa42020-08-18 16:07:28 +0200826 * @defgroup scnodeflags Compiled schema nodes flags
Radek Krejci4f28eda2018-11-12 11:46:16 +0100827 *
Radek Krejci8678fa42020-08-18 16:07:28 +0200828 * Various flags for compiled schema nodes (used as ::lysc_node.flags).
Radek Krejci4f28eda2018-11-12 11:46:16 +0100829 *
Radek Krejci61e042e2019-09-10 15:53:09 +0200830 * 1 - container 6 - anydata/anyxml 11 - identity
831 * 2 - choice 7 - case 12 - extension
832 * 3 - leaf 8 - notification 13 - bitenum
Michal Vasko03ff5a72019-09-11 13:49:33 +0200833 * 4 - leaflist 9 - rpc/action 14 - when
Michal Vaskoecd62de2019-11-13 12:35:11 +0100834 * 5 - list 10 - feature
Radek Krejci4f28eda2018-11-12 11:46:16 +0100835 *
Michal Vaskoecd62de2019-11-13 12:35:11 +0100836 * 1 1 1 1 1
837 * bit name 1 2 3 4 5 6 7 8 9 0 1 2 3 4
838 * ---------------------+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
Michal Vaskod09b7622021-01-26 09:14:13 +0100839 * 1 LYS_CONFIG_W |x|x|x|x|x|x|x| | | | | | | |
Michal Vaskoecd62de2019-11-13 12:35:11 +0100840 * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+
Michal Vaskod09b7622021-01-26 09:14:13 +0100841 * 2 LYS_CONFIG_R |x|x|x|x|x|x|x| | | | | | | |
Michal Vaskoecd62de2019-11-13 12:35:11 +0100842 * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+
Michal Vaskof4fa90d2021-11-11 15:05:19 +0100843 * 3 LYS_STATUS_CURR |x|x|x|x|x|x|x|x|x|x|x|x|x|x|
Michal Vaskoecd62de2019-11-13 12:35:11 +0100844 * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+
Michal Vaskof4fa90d2021-11-11 15:05:19 +0100845 * 4 LYS_STATUS_DEPRC |x|x|x|x|x|x|x|x|x|x|x|x|x|x|
Michal Vaskoecd62de2019-11-13 12:35:11 +0100846 * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+
Michal Vaskof4fa90d2021-11-11 15:05:19 +0100847 * 5 LYS_STATUS_OBSLT |x|x|x|x|x|x|x|x|x|x|x|x|x|x|
Michal Vaskoecd62de2019-11-13 12:35:11 +0100848 * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+
849 * 6 LYS_MAND_TRUE |x|x|x|x|x|x| | | | | | | | |
850 * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+
851 * 7 LYS_ORDBY_USER | | | |x|x| | | | | | | | | |
852 * LYS_MAND_FALSE | |x|x| | |x| | | | | | | | |
853 * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+
854 * 8 LYS_ORDBY_SYSTEM | | | |x|x| | | | | | | | | |
855 * LYS_PRESENCE |x| | | | | | | | | | | | | |
856 * LYS_UNIQUE | | |x| | | | | | | | | | | |
857 * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+
858 * 9 LYS_KEY | | |x| | | | | | | | | | | |
Michal Vaskof4fa90d2021-11-11 15:05:19 +0100859 * LYS_DISABLED | | | | | | | | | | | | |x| |
Michal Vaskoecd62de2019-11-13 12:35:11 +0100860 * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+
861 * 10 LYS_SET_DFLT | | |x|x| | |x| | | | | | | |
Michal Vaskod1e53b92021-01-28 13:11:06 +0100862 * LYS_IS_ENUM | | | | | | | | | | | | |x| |
Michal Vaskoecd62de2019-11-13 12:35:11 +0100863 * LYS_KEYLESS | | | | |x| | | | | | | | | |
864 * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+
865 * 11 LYS_SET_UNITS | | |x|x| | | | | | | | | | |
866 * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+
867 * 12 LYS_SET_CONFIG |x|x|x|x|x|x| | | | | | | | |
Michal Vaskod1e53b92021-01-28 13:11:06 +0100868 * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+
869 * 13 LYS_IS_INPUT |x|x|x|x|x|x|x| | | | | | | |
870 * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+
871 * 14 LYS_IS_OUTPUT |x|x|x|x|x|x|x| | | | | | | |
872 * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+
873 * 15 LYS_IS_NOTIF |x|x|x|x|x|x|x| | | | | | | |
Michal Vaskoecd62de2019-11-13 12:35:11 +0100874 * ---------------------+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
Radek Krejci4f28eda2018-11-12 11:46:16 +0100875 *
876 */
877
878/**
879 * @defgroup snodeflags Schema nodes flags
Radek Krejci8678fa42020-08-18 16:07:28 +0200880 *
881 * Various flags for schema nodes ([parsed](@ref spnodeflags) as well as [compiled](@ref scnodeflags)).
882 *
Radek Krejci4f28eda2018-11-12 11:46:16 +0100883 * @{
884 */
Michal Vaskod1e53b92021-01-28 13:11:06 +0100885#define LYS_CONFIG_W 0x01 /**< config true; */
886#define LYS_CONFIG_R 0x02 /**< config false; */
Michal Vaskob55f6c12018-09-12 11:13:15 +0200887#define LYS_CONFIG_MASK 0x03 /**< mask for config value */
Radek Krejci4f28eda2018-11-12 11:46:16 +0100888#define LYS_STATUS_CURR 0x04 /**< status current; */
889#define LYS_STATUS_DEPRC 0x08 /**< status deprecated; */
890#define LYS_STATUS_OBSLT 0x10 /**< status obsolete; */
891#define LYS_STATUS_MASK 0x1C /**< mask for status value */
892#define LYS_MAND_TRUE 0x20 /**< mandatory true; applicable only to ::lysp_node_choice/::lysc_node_choice,
Radek Krejcife909632019-02-12 15:34:42 +0100893 ::lysp_node_leaf/::lysc_node_leaf and ::lysp_node_anydata/::lysc_node_anydata.
894 The ::lysc_node_leaflist and ::lysc_node_leaflist have this flag in case that min-elements > 0.
895 The ::lysc_node_container has this flag if it is not a presence container and it has at least one
896 child with LYS_MAND_TRUE. */
Radek Krejcif1421c22019-02-19 13:05:20 +0100897#define LYS_MAND_FALSE 0x40 /**< mandatory false; applicable only to ::lysp_node_choice/::lysc_node_choice,
898 ::lysp_node_leaf/::lysc_node_leaf and ::lysp_node_anydata/::lysc_node_anydata.
899 This flag is present only in case the mandatory false statement was explicitly specified. */
Radek Krejci4f28eda2018-11-12 11:46:16 +0100900#define LYS_MAND_MASK 0x60 /**< mask for mandatory values */
Michal Vaskoc118ae22020-08-06 14:51:09 +0200901#define LYS_PRESENCE 0x80 /**< flag for presence property of a container, but it is not only for explicit presence
902 containers, but also for NP containers with some meaning, applicable only to
903 ::lysc_node_container */
Radek Krejci7adf4ff2018-12-05 08:55:00 +0100904#define LYS_UNIQUE 0x80 /**< flag for leafs being part of a unique set, applicable only to ::lysc_node_leaf */
Michal Vaskod1e53b92021-01-28 13:11:06 +0100905#define LYS_KEY 0x0100 /**< flag for leafs being a key of a list, applicable only to ::lysc_node_leaf */
906#define LYS_KEYLESS 0x0200 /**< flag for list without any key, applicable only to ::lysc_node_list */
Michal Vaskof4fa90d2021-11-11 15:05:19 +0100907#define LYS_DISABLED 0x0100 /**< internal flag for a disabled statement, used only for bits/enums */
Michal Vasko7b1ad1a2020-11-02 15:41:27 +0100908#define LYS_FENABLED 0x20 /**< feature enabled flag, applicable only to ::lysp_feature. */
Michal Vaskoe78faec2021-04-08 17:24:43 +0200909#define LYS_ORDBY_SYSTEM 0x80 /**< ordered-by system configuration lists, applicable only to
910 ::lysc_node_leaflist/::lysp_node_leaflist and ::lysc_node_list/::lysp_node_list */
911#define LYS_ORDBY_USER 0x40 /**< ordered-by user configuration lists, applicable only to
912 ::lysc_node_leaflist/::lysp_node_leaflist and ::lysc_node_list/::lysp_node_list;
913 is always set for state leaf-lists, and key-less lists */
Radek Krejci4f28eda2018-11-12 11:46:16 +0100914#define LYS_ORDBY_MASK 0x60 /**< mask for ordered-by values */
915#define LYS_YINELEM_TRUE 0x80 /**< yin-element true for extension's argument */
Michal Vaskod1e53b92021-01-28 13:11:06 +0100916#define LYS_YINELEM_FALSE 0x0100 /**< yin-element false for extension's argument */
917#define LYS_YINELEM_MASK 0x0180 /**< mask for yin-element value */
918#define LYS_USED_GRP 0x0400 /**< internal flag for validating not-instantiated groupings
Radek Krejcif2de0ed2019-05-02 14:13:18 +0200919 (resp. do not validate again the instantiated groupings). */
Michal Vaskod1e53b92021-01-28 13:11:06 +0100920#define LYS_SET_VALUE 0x0200 /**< value attribute is set */
921#define LYS_SET_MIN 0x0200 /**< min attribute is set */
922#define LYS_SET_MAX 0x0400 /**< max attribute is set */
Radek Krejcid505e3d2018-11-13 09:04:17 +0100923
924#define LYS_SET_BASE 0x0001 /**< type's flag for present base substatement */
925#define LYS_SET_BIT 0x0002 /**< type's flag for present bit substatement */
926#define LYS_SET_ENUM 0x0004 /**< type's flag for present enum substatement */
927#define LYS_SET_FRDIGITS 0x0008 /**< type's flag for present fraction-digits substatement */
928#define LYS_SET_LENGTH 0x0010 /**< type's flag for present length substatement */
929#define LYS_SET_PATH 0x0020 /**< type's flag for present path substatement */
930#define LYS_SET_PATTERN 0x0040 /**< type's flag for present pattern substatement */
931#define LYS_SET_RANGE 0x0080 /**< type's flag for present range substatement */
932#define LYS_SET_TYPE 0x0100 /**< type's flag for present type substatement */
933#define LYS_SET_REQINST 0x0200 /**< type's flag for present require-instance substatement */
Radek Krejciccd20f12019-02-15 14:12:27 +0100934#define LYS_SET_DFLT 0x0200 /**< flag to mark leaf/leaflist with own (or refined) default value, not a default value taken from its type, and default
Radek Krejci76b3e962018-12-14 17:01:25 +0100935 cases of choice. This information is important for refines, since it is prohibited to make leafs
936 with default statement mandatory. In case the default leaf value is taken from type, it is thrown
Radek Krejciccd20f12019-02-15 14:12:27 +0100937 away when it is refined to be mandatory node. Similarly it is used for deviations to distinguish
938 between own default or the default values taken from the type. */
939#define LYS_SET_UNITS 0x0400 /**< flag to know if the leaf's/leaflist's units are their own (flag set) or it is taken from the type. */
Radek Krejcif1421c22019-02-19 13:05:20 +0100940#define LYS_SET_CONFIG 0x0800 /**< flag to know if the config property was set explicitly (flag set) or it is inherited. */
Radek Krejci0e5d8382018-11-28 16:37:53 +0100941
Michal Vaskod1e53b92021-01-28 13:11:06 +0100942#define LYS_SINGLEQUOTED 0x0100 /**< flag for single-quoted argument of an extension instance's substatement, only when the source is YANG */
943#define LYS_DOUBLEQUOTED 0x0200 /**< flag for double-quoted argument of an extension instance's substatement, only when the source is YANG */
Radek Krejcid3ca0632019-04-16 16:54:54 +0200944
Michal Vaskod1e53b92021-01-28 13:11:06 +0100945#define LYS_YIN_ATTR 0x0400 /**< flag to identify YIN attribute parsed as extension's substatement, only when the source is YIN */
946#define LYS_YIN_ARGUMENT 0x0800 /**< flag to identify statement representing extension's argument, only when the source is YIN */
David Sedlákbbd06ca2019-06-27 14:15:38 +0200947
Michal Vasko3e9bc2f2020-11-04 17:13:56 +0100948#define LYS_INTERNAL 0x1000 /**< flag to identify internal parsed statements that should not be printed */
949
Michal Vaskod1e53b92021-01-28 13:11:06 +0100950#define LYS_IS_ENUM 0x0200 /**< flag to simply distinguish type in struct lysc_type_bitenum_item */
951
952#define LYS_IS_INPUT 0x1000 /**< flag for nodes that are in the subtree of an input statement */
953
954#define LYS_IS_OUTPUT 0x2000 /**< flag for nodes that are in the subtree of an output statement */
955
956#define LYS_IS_NOTIF 0x4000 /**< flag for nodes that are in the subtree of a notification statement */
Radek Krejci693262f2019-04-29 15:23:20 +0200957
Radek Krejcife909632019-02-12 15:34:42 +0100958#define LYS_FLAGS_COMPILED_MASK 0xff /**< mask for flags that maps to the compiled structures */
Radek Krejci2ff0d572020-05-21 15:27:28 +0200959/** @} snodeflags */
Michal Vaskob55f6c12018-09-12 11:13:15 +0200960
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200961/**
962 * @brief Generic YANG data node
963 */
964struct lysp_node {
Radek Krejci6d9b9b52018-11-02 12:43:39 +0100965 struct lysp_node *parent; /**< parent node (NULL if this is a top-level node) */
Radek Krejcide7a9c42021-03-10 13:13:06 +0100966 uint16_t nodetype; /**< [type of the node](@ref schemanodetypes) (mandatory) */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200967 uint16_t flags; /**< [schema node flags](@ref snodeflags) */
Radek Krejci6d9b9b52018-11-02 12:43:39 +0100968 struct lysp_node *next; /**< next sibling node (NULL if there is no one) */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200969 const char *name; /**< node name (mandatory) */
970 const char *dsc; /**< description statement */
971 const char *ref; /**< reference statement */
Michal Vasko7f45cf22020-10-01 12:49:44 +0200972 struct lysp_qname *iffeatures; /**< list of if-feature expressions ([sized array](@ref sizedarrays)),
973 must be qname because of refines */
Radek Krejcie53a8dc2018-10-17 12:52:40 +0200974 struct lysp_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200975};
976
977/**
978 * @brief Extension structure of the lysp_node for YANG container
979 */
980struct lysp_node_container {
Radek Krejci2a9fc652021-01-22 17:44:34 +0100981 union {
982 struct lysp_node node; /**< implicit cast for the members compatible with ::lysp_node */
983 struct {
984 struct lysp_node *parent; /**< parent node (NULL if this is a top-level node) */
985 uint16_t nodetype; /**< LYS_CONTAINER */
986 uint16_t flags; /**< [schema node flags](@ref snodeflags) */
987 struct lysp_node *next; /**< pointer to the next sibling node (NULL if there is no one) */
988 const char *name; /**< node name (mandatory) */
989 const char *dsc; /**< description statement */
990 const char *ref; /**< reference statement */
Radek Krejci2a9fc652021-01-22 17:44:34 +0100991 struct lysp_qname *iffeatures; /**< list of if-feature expressions ([sized array](@ref sizedarrays)) */
992 struct lysp_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
993 };
994 }; /**< common part corresponding to ::lysp_node */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200995
996 /* container */
Radek Krejcie53a8dc2018-10-17 12:52:40 +0200997 struct lysp_restr *musts; /**< list of must restrictions ([sized array](@ref sizedarrays)) */
Radek Krejci9a3823e2021-01-27 20:26:46 +0100998 struct lysp_when *when; /**< when statement */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200999 const char *presence; /**< presence description */
Radek Krejcie53a8dc2018-10-17 12:52:40 +02001000 struct lysp_tpdf *typedefs; /**< list of typedefs ([sized array](@ref sizedarrays)) */
Radek Krejci2a9fc652021-01-22 17:44:34 +01001001 struct lysp_node_grp *groupings; /**< list of groupings (linked list) */
Radek Krejci5aeea3a2018-09-05 13:29:36 +02001002 struct lysp_node *child; /**< list of data nodes (linked list) */
Radek Krejci2a9fc652021-01-22 17:44:34 +01001003 struct lysp_node_action *actions;/**< list of actions (linked list) */
1004 struct lysp_node_notif *notifs; /**< list of notifications (linked list) */
Radek Krejci5aeea3a2018-09-05 13:29:36 +02001005};
1006
1007struct lysp_node_leaf {
Radek Krejci2a9fc652021-01-22 17:44:34 +01001008 union {
1009 struct lysp_node node; /**< implicit cast for the members compatible with ::lysp_node */
1010 struct {
1011 struct lysp_node *parent; /**< parent node (NULL if this is a top-level node) */
1012 uint16_t nodetype; /**< LYS_LEAF */
1013 uint16_t flags; /**< [schema node flags](@ref snodeflags) */
1014 struct lysp_node *next; /**< pointer to the next sibling node (NULL if there is no one) */
1015 const char *name; /**< node name (mandatory) */
1016 const char *dsc; /**< description statement */
1017 const char *ref; /**< reference statement */
Radek Krejci2a9fc652021-01-22 17:44:34 +01001018 struct lysp_qname *iffeatures; /**< list of if-feature expressions ([sized array](@ref sizedarrays)) */
1019 struct lysp_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
1020 };
1021 }; /**< common part corresponding to ::lysp_node */
Radek Krejci5aeea3a2018-09-05 13:29:36 +02001022
1023 /* leaf */
Radek Krejcie53a8dc2018-10-17 12:52:40 +02001024 struct lysp_restr *musts; /**< list of must restrictions ([sized array](@ref sizedarrays)) */
Radek Krejci9a3823e2021-01-27 20:26:46 +01001025 struct lysp_when *when; /**< when statement */
Radek Krejci5aeea3a2018-09-05 13:29:36 +02001026 struct lysp_type type; /**< type of the leaf node (mandatory) */
1027 const char *units; /**< units of the leaf's type */
Michal Vasko7f45cf22020-10-01 12:49:44 +02001028 struct lysp_qname dflt; /**< default value, it may or may not be a qualified name */
Radek Krejci5aeea3a2018-09-05 13:29:36 +02001029};
1030
1031struct lysp_node_leaflist {
Radek Krejci2a9fc652021-01-22 17:44:34 +01001032 union {
1033 struct lysp_node node; /**< implicit cast for the members compatible with ::lysp_node */
1034 struct {
1035 struct lysp_node *parent; /**< parent node (NULL if this is a top-level node) */
1036 uint16_t nodetype; /**< LYS_LEAFLIST */
1037 uint16_t flags; /**< [schema node flags](@ref snodeflags) */
1038 struct lysp_node *next; /**< pointer to the next sibling node (NULL if there is no one) */
1039 const char *name; /**< node name (mandatory) */
1040 const char *dsc; /**< description statement */
1041 const char *ref; /**< reference statement */
Radek Krejci2a9fc652021-01-22 17:44:34 +01001042 struct lysp_qname *iffeatures; /**< list of if-feature expressions ([sized array](@ref sizedarrays)) */
1043 struct lysp_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
1044 };
1045 }; /**< common part corresponding to ::lysp_node */
Radek Krejci5aeea3a2018-09-05 13:29:36 +02001046
1047 /* leaf-list */
Radek Krejcie53a8dc2018-10-17 12:52:40 +02001048 struct lysp_restr *musts; /**< list of must restrictions ([sized array](@ref sizedarrays)) */
Radek Krejci9a3823e2021-01-27 20:26:46 +01001049 struct lysp_when *when; /**< when statement */
Radek Krejci5aeea3a2018-09-05 13:29:36 +02001050 struct lysp_type type; /**< type of the leaf node (mandatory) */
1051 const char *units; /**< units of the leaf's type */
Michal Vasko7f45cf22020-10-01 12:49:44 +02001052 struct lysp_qname *dflts; /**< list of default values ([sized array](@ref sizedarrays)), they may or
1053 may not be qualified names */
Radek Krejci5aeea3a2018-09-05 13:29:36 +02001054 uint32_t min; /**< min-elements constraint */
1055 uint32_t max; /**< max-elements constraint, 0 means unbounded */
1056};
1057
1058struct lysp_node_list {
Radek Krejci2a9fc652021-01-22 17:44:34 +01001059 union {
1060 struct lysp_node node; /**< implicit cast for the members compatible with ::lysp_node */
1061 struct {
1062 struct lysp_node *parent; /**< parent node (NULL if this is a top-level node) */
1063 uint16_t nodetype; /**< LYS_LIST */
1064 uint16_t flags; /**< [schema node flags](@ref snodeflags) */
1065 struct lysp_node *next; /**< pointer to the next sibling node (NULL if there is no one) */
1066 const char *name; /**< node name (mandatory) */
1067 const char *dsc; /**< description statement */
1068 const char *ref; /**< reference statement */
Radek Krejci2a9fc652021-01-22 17:44:34 +01001069 struct lysp_qname *iffeatures; /**< list of if-feature expressions ([sized array](@ref sizedarrays)) */
1070 struct lysp_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
1071 };
1072 }; /**< common part corresponding to ::lysp_node */
Radek Krejci5aeea3a2018-09-05 13:29:36 +02001073
1074 /* list */
Radek Krejcie53a8dc2018-10-17 12:52:40 +02001075 struct lysp_restr *musts; /**< list of must restrictions ([sized array](@ref sizedarrays)) */
Radek Krejci9a3823e2021-01-27 20:26:46 +01001076 struct lysp_when *when; /**< when statement */
Radek Krejci5aeea3a2018-09-05 13:29:36 +02001077 const char *key; /**< keys specification */
Radek Krejcie53a8dc2018-10-17 12:52:40 +02001078 struct lysp_tpdf *typedefs; /**< list of typedefs ([sized array](@ref sizedarrays)) */
Radek Krejci2a9fc652021-01-22 17:44:34 +01001079 struct lysp_node_grp *groupings; /**< list of groupings (linked list) */
Radek Krejci5aeea3a2018-09-05 13:29:36 +02001080 struct lysp_node *child; /**< list of data nodes (linked list) */
Radek Krejci2a9fc652021-01-22 17:44:34 +01001081 struct lysp_node_action *actions;/**< list of actions (linked list) */
1082 struct lysp_node_notif *notifs; /**< list of notifications (linked list) */
Michal Vasko7f45cf22020-10-01 12:49:44 +02001083 struct lysp_qname *uniques; /**< list of unique specifications ([sized array](@ref sizedarrays)) */
Radek Krejci5aeea3a2018-09-05 13:29:36 +02001084 uint32_t min; /**< min-elements constraint */
1085 uint32_t max; /**< max-elements constraint, 0 means unbounded */
1086};
1087
1088struct lysp_node_choice {
Radek Krejci2a9fc652021-01-22 17:44:34 +01001089 union {
1090 struct lysp_node node; /**< implicit cast for the members compatible with ::lysp_node */
1091 struct {
1092 struct lysp_node *parent; /**< parent node (NULL if this is a top-level node) */
1093 uint16_t nodetype; /**< LYS_CHOICE */
1094 uint16_t flags; /**< [schema node flags](@ref snodeflags) */
1095 struct lysp_node *next; /**< pointer to the next sibling node (NULL if there is no one) */
1096 const char *name; /**< node name (mandatory) */
1097 const char *dsc; /**< description statement */
1098 const char *ref; /**< reference statement */
Radek Krejci2a9fc652021-01-22 17:44:34 +01001099 struct lysp_qname *iffeatures; /**< list of if-feature expressions ([sized array](@ref sizedarrays)) */
1100 struct lysp_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
1101 };
1102 }; /**< common part corresponding to ::lysp_node */
Radek Krejci5aeea3a2018-09-05 13:29:36 +02001103
1104 /* choice */
1105 struct lysp_node *child; /**< list of data nodes (linked list) */
Radek Krejci9a3823e2021-01-27 20:26:46 +01001106 struct lysp_when *when; /**< when statement */
Michal Vasko7f45cf22020-10-01 12:49:44 +02001107 struct lysp_qname dflt; /**< default case */
Radek Krejci5aeea3a2018-09-05 13:29:36 +02001108};
1109
1110struct lysp_node_case {
Radek Krejci2a9fc652021-01-22 17:44:34 +01001111 union {
1112 struct lysp_node node; /**< implicit cast for the members compatible with ::lysp_node */
1113 struct {
1114 struct lysp_node *parent; /**< parent node (NULL if this is a top-level node) */
1115 uint16_t nodetype; /**< LYS_CASE */
1116 uint16_t flags; /**< [schema node flags](@ref snodeflags) */
1117 struct lysp_node *next; /**< pointer to the next sibling node (NULL if there is no one) */
1118 const char *name; /**< node name (mandatory) */
1119 const char *dsc; /**< description statement */
1120 const char *ref; /**< reference statement */
Radek Krejci2a9fc652021-01-22 17:44:34 +01001121 struct lysp_qname *iffeatures; /**< list of if-feature expressions ([sized array](@ref sizedarrays)) */
1122 struct lysp_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
1123 };
1124 }; /**< common part corresponding to ::lysp_node */
Radek Krejci5aeea3a2018-09-05 13:29:36 +02001125
1126 /* case */
1127 struct lysp_node *child; /**< list of data nodes (linked list) */
Radek Krejci9a3823e2021-01-27 20:26:46 +01001128 struct lysp_when *when; /**< when statement */
Radek Krejci5aeea3a2018-09-05 13:29:36 +02001129};
1130
1131struct lysp_node_anydata {
Radek Krejci2a9fc652021-01-22 17:44:34 +01001132 union {
1133 struct lysp_node node; /**< implicit cast for the members compatible with ::lysp_node */
1134 struct {
1135 struct lysp_node *parent; /**< parent node (NULL if this is a top-level node) */
1136 uint16_t nodetype; /**< LYS_ANYXML or LYS_ANYDATA */
1137 uint16_t flags; /**< [schema node flags](@ref snodeflags) */
1138 struct lysp_node *next; /**< pointer to the next sibling node (NULL if there is no one) */
1139 const char *name; /**< node name (mandatory) */
1140 const char *dsc; /**< description statement */
1141 const char *ref; /**< reference statement */
Radek Krejci2a9fc652021-01-22 17:44:34 +01001142 struct lysp_qname *iffeatures; /**< list of if-feature expressions ([sized array](@ref sizedarrays)) */
1143 struct lysp_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
1144 };
1145 }; /**< common part corresponding to ::lysp_node */
Radek Krejci5aeea3a2018-09-05 13:29:36 +02001146
1147 /* anyxml/anydata */
Radek Krejcie53a8dc2018-10-17 12:52:40 +02001148 struct lysp_restr *musts; /**< list of must restrictions ([sized array](@ref sizedarrays)) */
Radek Krejci9a3823e2021-01-27 20:26:46 +01001149 struct lysp_when *when; /**< when statement */
Radek Krejci5aeea3a2018-09-05 13:29:36 +02001150};
1151
1152struct lysp_node_uses {
Radek Krejci2a9fc652021-01-22 17:44:34 +01001153 union {
1154 struct lysp_node node; /**< implicit cast for the members compatible with ::lysp_node */
1155 struct {
1156 struct lysp_node *parent; /**< parent node (NULL if this is a top-level node) */
1157 uint16_t nodetype; /**< LYS_USES */
1158 uint16_t flags; /**< [schema node flags](@ref snodeflags) */
1159 struct lysp_node *next; /**< pointer to the next sibling node (NULL if there is no one) */
1160 const char *name; /**< grouping name reference (mandatory) */
1161 const char *dsc; /**< description statement */
1162 const char *ref; /**< reference statement */
Radek Krejci2a9fc652021-01-22 17:44:34 +01001163 struct lysp_qname *iffeatures; /**< list of if-feature expressions ([sized array](@ref sizedarrays)) */
1164 struct lysp_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
1165 };
1166 }; /**< common part corresponding to ::lysp_node */
Radek Krejci5aeea3a2018-09-05 13:29:36 +02001167
1168 /* uses */
Radek Krejcie53a8dc2018-10-17 12:52:40 +02001169 struct lysp_refine *refines; /**< list of uses's refines ([sized array](@ref sizedarrays)) */
Radek Krejci2a9fc652021-01-22 17:44:34 +01001170 struct lysp_node_augment *augments; /**< list of augments (linked list) */
Radek Krejci9a3823e2021-01-27 20:26:46 +01001171 struct lysp_when *when; /**< when statement */
Radek Krejci5aeea3a2018-09-05 13:29:36 +02001172};
1173
1174/**
1175 * @brief YANG input-stmt and output-stmt
1176 */
Radek Krejci2a9fc652021-01-22 17:44:34 +01001177struct lysp_node_action_inout {
1178 union {
1179 struct lysp_node node; /**< implicit cast for the members compatible with ::lysp_node */
1180 struct {
1181 struct lysp_node *parent; /**< parent node (NULL if this is a top-level node) */
1182 uint16_t nodetype; /**< LYS_INPUT or LYS_OUTPUT */
1183 uint16_t flags; /**< [schema node flags](@ref snodeflags) */
1184 struct lysp_node *next; /**< NULL */
1185 const char *name; /**< empty string */
1186 const char *dsc; /**< ALWAYS NULL, compatibility member with ::lysp_node */
1187 const char *ref; /**< ALWAYS NULL, compatibility member with ::lysp_node */
Radek Krejci2a9fc652021-01-22 17:44:34 +01001188 struct lysp_qname *iffeatures; /**< ALWAYS NULL, compatibility member with ::lysp_node */
1189 struct lysp_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
1190 };
1191 }; /**< common part corresponding to ::lysp_node */
1192
1193 /* inout */
Radek Krejcie53a8dc2018-10-17 12:52:40 +02001194 struct lysp_restr *musts; /**< list of must restrictions ([sized array](@ref sizedarrays)) */
1195 struct lysp_tpdf *typedefs; /**< list of typedefs ([sized array](@ref sizedarrays)) */
Radek Krejci2a9fc652021-01-22 17:44:34 +01001196 struct lysp_node_grp *groupings; /**< list of groupings (linked list) */
Radek Krejci01180ac2021-01-27 08:48:22 +01001197 struct lysp_node *child; /**< list of data nodes (linked list) */
Radek Krejci5aeea3a2018-09-05 13:29:36 +02001198};
1199
1200/**
1201 * @brief YANG rpc-stmt and action-stmt
1202 */
Radek Krejci2a9fc652021-01-22 17:44:34 +01001203struct lysp_node_action {
1204 union {
1205 struct lysp_node node; /**< implicit cast for the members compatible with ::lysp_node */
1206 struct {
1207 struct lysp_node *parent; /**< parent node (NULL if this is a top-level node) */
1208 uint16_t nodetype; /**< LYS_RPC or LYS_ACTION */
1209 uint16_t flags; /**< [schema node flags](@ref snodeflags) */
1210 struct lysp_node_action *next; /**< pointer to the next action (NULL if there is no one) */
1211 const char *name; /**< grouping name reference (mandatory) */
1212 const char *dsc; /**< description statement */
1213 const char *ref; /**< reference statement */
Radek Krejci2a9fc652021-01-22 17:44:34 +01001214 struct lysp_qname *iffeatures; /**< list of if-feature expressions ([sized array](@ref sizedarrays)) */
1215 struct lysp_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
1216 };
1217 }; /**< common part corresponding to ::lysp_node */
Michal Vasko7f45cf22020-10-01 12:49:44 +02001218
1219 /* action */
Radek Krejci2a9fc652021-01-22 17:44:34 +01001220 struct lysp_tpdf *typedefs; /**< list of typedefs ([sized array](@ref sizedarrays)) */
1221 struct lysp_node_grp *groupings; /**< list of groupings (linked list) */
1222
1223 struct lysp_node_action_inout input; /**< RPC's/Action's input */
1224 struct lysp_node_action_inout output; /**< RPC's/Action's output */
Radek Krejci5aeea3a2018-09-05 13:29:36 +02001225};
1226
1227/**
1228 * @brief YANG notification-stmt
1229 */
Radek Krejci2a9fc652021-01-22 17:44:34 +01001230struct lysp_node_notif {
1231 union {
1232 struct lysp_node node; /**< implicit cast for the members compatible with ::lysp_node */
1233 struct {
1234 struct lysp_node *parent; /**< parent node (NULL if this is a top-level node) */
1235 uint16_t nodetype; /**< LYS_NOTIF */
1236 uint16_t flags; /**< [schema node flags](@ref snodeflags) - only LYS_STATUS_* values are allowed */
1237 struct lysp_node_notif *next; /**< pointer to the next notification (NULL if there is no one) */
1238 const char *name; /**< grouping name reference (mandatory) */
1239 const char *dsc; /**< description statement */
1240 const char *ref; /**< reference statement */
Radek Krejci2a9fc652021-01-22 17:44:34 +01001241 struct lysp_qname *iffeatures; /**< list of if-feature expressions ([sized array](@ref sizedarrays)) */
1242 struct lysp_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
1243 };
1244 }; /**< common part corresponding to ::lysp_node */
Michal Vasko7f45cf22020-10-01 12:49:44 +02001245
1246 /* notif */
1247 struct lysp_restr *musts; /**< list of must restrictions ([sized array](@ref sizedarrays)) */
Radek Krejci2a9fc652021-01-22 17:44:34 +01001248 struct lysp_tpdf *typedefs; /**< list of typedefs ([sized array](@ref sizedarrays)) */
1249 struct lysp_node_grp *groupings; /**< list of groupings (linked list) */
Radek Krejci01180ac2021-01-27 08:48:22 +01001250 struct lysp_node *child; /**< list of data nodes (linked list) */
Radek Krejci5aeea3a2018-09-05 13:29:36 +02001251};
1252
1253/**
Radek Krejci2a9fc652021-01-22 17:44:34 +01001254 * @brief YANG grouping-stmt
1255 */
1256struct lysp_node_grp {
1257 union {
1258 struct lysp_node node; /**< implicit cast for the members compatible with ::lysp_node */
1259 struct {
1260 struct lysp_node *parent;/**< parent node (NULL if this is a top-level grouping) */
1261 uint16_t nodetype; /**< LYS_GROUPING */
1262 uint16_t flags; /**< [schema node flags](@ref snodeflags) - only LYS_STATUS_* values are allowed */
1263 struct lysp_node_grp *next; /**< pointer to the next grouping (NULL if there is no one) */
1264 const char *name; /**< grouping name (mandatory) */
1265 const char *dsc; /**< description statement */
1266 const char *ref; /**< reference statement */
Radek Krejci2a9fc652021-01-22 17:44:34 +01001267 struct lysp_qname *iffeatures; /**< ALWAYS NULL, compatibility member with ::lysp_node */
1268 struct lysp_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
1269 };
1270 }; /**< common part corresponding to ::lysp_node */
1271
1272 /* grp */
1273 struct lysp_tpdf *typedefs; /**< list of typedefs ([sized array](@ref sizedarrays)) */
1274 struct lysp_node_grp *groupings; /**< list of groupings (linked list) */
Radek Krejci01180ac2021-01-27 08:48:22 +01001275 struct lysp_node *child; /**< list of data nodes (linked list) */
Radek Krejci2a9fc652021-01-22 17:44:34 +01001276 struct lysp_node_action *actions; /**< list of actions (linked list) */
1277 struct lysp_node_notif *notifs; /**< list of notifications (linked list) */
1278};
1279
1280/**
1281 * @brief YANG uses-augment-stmt and augment-stmt (compatible with struct lysp_node )
1282 */
1283struct lysp_node_augment {
1284 union {
1285 struct lysp_node node; /**< implicit cast for the members compatible with ::lysp_node */
1286 struct {
1287 struct lysp_node *parent;/**< parent node (NULL if this is a top-level augment) */
1288 uint16_t nodetype; /**< LYS_AUGMENT */
1289 uint16_t flags; /**< [schema node flags](@ref snodeflags) - only LYS_STATUS_* values are allowed */
1290 struct lysp_node_augment *next; /**< pointer to the next augment (NULL if there is no one) */
1291 const char *nodeid; /**< target schema nodeid (mandatory) - absolute for global augments, descendant for uses's augments */
1292 const char *dsc; /**< description statement */
1293 const char *ref; /**< reference statement */
Radek Krejci2a9fc652021-01-22 17:44:34 +01001294 struct lysp_qname *iffeatures; /**< list of if-feature expressions ([sized array](@ref sizedarrays)) */
1295 struct lysp_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
1296 };
1297 }; /**< common part corresponding to ::lysp_node */
1298
1299 struct lysp_node *child; /**< list of data nodes (linked list) */
Radek Krejci9a3823e2021-01-27 20:26:46 +01001300 struct lysp_when *when; /**< when statement */
Radek Krejci2a9fc652021-01-22 17:44:34 +01001301 struct lysp_node_action *actions;/**< list of actions (linked list) */
1302 struct lysp_node_notif *notifs; /**< list of notifications (linked list) */
1303};
1304
1305/**
Radek Krejcif0fceb62018-09-05 14:58:45 +02001306 * @brief supported YANG schema version values
1307 */
1308typedef enum LYS_VERSION {
1309 LYS_VERSION_UNDEF = 0, /**< no specific version, YANG 1.0 as default */
Radek Krejci96e48da2020-09-04 13:18:06 +02001310 LYS_VERSION_1_0 = 1, /**< YANG 1 (1.0) */
Radek Krejcif0fceb62018-09-05 14:58:45 +02001311 LYS_VERSION_1_1 = 2 /**< YANG 1.1 */
1312} LYS_VERSION;
1313
1314/**
Radek Krejci5aeea3a2018-09-05 13:29:36 +02001315 * @brief Printable YANG schema tree structure representing YANG module.
1316 *
1317 * Simple structure corresponding to the YANG format. The schema is only syntactically validated.
1318 */
1319struct lysp_module {
Radek Krejci0bcdaed2019-01-10 10:21:34 +01001320 struct lys_module *mod; /**< covering module structure */
1321
Radek Krejcib7db73a2018-10-24 14:18:40 +02001322 struct lysp_revision *revs; /**< list of the module revisions ([sized array](@ref sizedarrays)), the first revision
1323 in the list is always the last (newest) revision of the module */
Radek Krejcie53a8dc2018-10-17 12:52:40 +02001324 struct lysp_import *imports; /**< list of imported modules ([sized array](@ref sizedarrays)) */
1325 struct lysp_include *includes; /**< list of included submodules ([sized array](@ref sizedarrays)) */
Radek Krejcie53a8dc2018-10-17 12:52:40 +02001326 struct lysp_ext *extensions; /**< list of extension statements ([sized array](@ref sizedarrays)) */
1327 struct lysp_feature *features; /**< list of feature definitions ([sized array](@ref sizedarrays)) */
1328 struct lysp_ident *identities; /**< list of identities ([sized array](@ref sizedarrays)) */
1329 struct lysp_tpdf *typedefs; /**< list of typedefs ([sized array](@ref sizedarrays)) */
Radek Krejci2a9fc652021-01-22 17:44:34 +01001330 struct lysp_node_grp *groupings; /**< list of groupings (linked list) */
Radek Krejci5aeea3a2018-09-05 13:29:36 +02001331 struct lysp_node *data; /**< list of module's top-level data nodes (linked list) */
Radek Krejci2a9fc652021-01-22 17:44:34 +01001332 struct lysp_node_augment *augments; /**< list of augments (linked list) */
1333 struct lysp_node_action *rpcs; /**< list of RPCs (linked list) */
1334 struct lysp_node_notif *notifs; /**< list of notifications (linked list) */
Radek Krejcie53a8dc2018-10-17 12:52:40 +02001335 struct lysp_deviation *deviations; /**< list of deviations ([sized array](@ref sizedarrays)) */
Michal Vaskoc3781c32020-10-06 14:04:08 +02001336 struct lysp_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
Radek Krejci5aeea3a2018-09-05 13:29:36 +02001337
Michal Vasko5d24f6c2020-10-13 13:49:06 +02001338 uint8_t version; /**< yang-version (LYS_VERSION values) */
Michal Vaskoc3781c32020-10-06 14:04:08 +02001339 uint8_t parsing : 1; /**< flag for circular check */
1340 uint8_t is_submod : 1; /**< always 0 */
Radek Krejci0bcdaed2019-01-10 10:21:34 +01001341};
1342
1343struct lysp_submodule {
Michal Vaskoc3781c32020-10-06 14:04:08 +02001344 struct lys_module *mod; /**< belongs to parent module (submodule - mandatory) */
Radek Krejci0bcdaed2019-01-10 10:21:34 +01001345
1346 struct lysp_revision *revs; /**< list of the module revisions ([sized array](@ref sizedarrays)), the first revision
1347 in the list is always the last (newest) revision of the module */
1348 struct lysp_import *imports; /**< list of imported modules ([sized array](@ref sizedarrays)) */
1349 struct lysp_include *includes; /**< list of included submodules ([sized array](@ref sizedarrays)) */
1350 struct lysp_ext *extensions; /**< list of extension statements ([sized array](@ref sizedarrays)) */
1351 struct lysp_feature *features; /**< list of feature definitions ([sized array](@ref sizedarrays)) */
1352 struct lysp_ident *identities; /**< list of identities ([sized array](@ref sizedarrays)) */
1353 struct lysp_tpdf *typedefs; /**< list of typedefs ([sized array](@ref sizedarrays)) */
Radek Krejci2a9fc652021-01-22 17:44:34 +01001354 struct lysp_node_grp *groupings; /**< list of groupings (linked list) */
Radek Krejci0bcdaed2019-01-10 10:21:34 +01001355 struct lysp_node *data; /**< list of module's top-level data nodes (linked list) */
Radek Krejci2a9fc652021-01-22 17:44:34 +01001356 struct lysp_node_augment *augments; /**< list of augments (linked list) */
1357 struct lysp_node_action *rpcs; /**< list of RPCs (linked list) */
1358 struct lysp_node_notif *notifs; /**< list of notifications (linked list) */
Radek Krejci0bcdaed2019-01-10 10:21:34 +01001359 struct lysp_deviation *deviations; /**< list of deviations ([sized array](@ref sizedarrays)) */
Michal Vaskoc3781c32020-10-06 14:04:08 +02001360 struct lysp_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
Radek Krejci0bcdaed2019-01-10 10:21:34 +01001361
Michal Vasko5d24f6c2020-10-13 13:49:06 +02001362 uint8_t version; /**< yang-version (LYS_VERSION values) */
Michal Vaskoc3781c32020-10-06 14:04:08 +02001363 uint8_t parsing : 1; /**< flag for circular check */
1364 uint8_t is_submod : 1; /**< always 1 */
Radek Krejci0bcdaed2019-01-10 10:21:34 +01001365
Michal Vaskoc3781c32020-10-06 14:04:08 +02001366 uint8_t latest_revision : 2; /**< flag to mark the latest available revision:
Radek Krejci086c7132018-10-26 15:29:04 +02001367 1 - the latest revision in searchdirs was not searched yet and this is the
1368 latest revision in the current context
1369 2 - searchdirs were searched and this is the latest available revision */
Radek Krejci0bcdaed2019-01-10 10:21:34 +01001370 const char *name; /**< name of the module (mandatory) */
1371 const char *filepath; /**< path, if the schema was read from a file, NULL in case of reading from memory */
1372 const char *prefix; /**< submodule belongsto prefix of main module (mandatory) */
1373 const char *org; /**< party/company responsible for the module */
1374 const char *contact; /**< contact information for the module */
1375 const char *dsc; /**< description of the module */
1376 const char *ref; /**< cross-reference for the module */
Radek Krejci5aeea3a2018-09-05 13:29:36 +02001377};
1378
1379/**
Michal Vasko5d24f6c2020-10-13 13:49:06 +02001380 * @brief Get the parsed module or submodule name.
1381 *
1382 * @param[in] PMOD Parsed module or submodule.
1383 * @return Module or submodule name.
1384 */
1385#define LYSP_MODULE_NAME(PMOD) (PMOD->is_submod ? ((struct lysp_submodule *)PMOD)->name : ((struct lysp_module *)PMOD)->mod->name)
1386
1387/**
Radek Krejci8df109d2021-04-23 12:19:08 +02001388 * @brief Compiled prefix data pair mapping of prefixes to modules. In case the format is ::LY_VALUE_SCHEMA_RESOLVED,
Michal Vasko5d24f6c2020-10-13 13:49:06 +02001389 * the expected prefix data is a sized array of these structures.
1390 */
1391struct lysc_prefix {
1392 char *prefix; /**< used prefix */
1393 const struct lys_module *mod; /**< mapping to a module */
1394};
1395
1396/**
Radek Krejci0e59c312019-08-15 15:34:15 +02001397 * @brief Compiled YANG extension-stmt
Radek Krejci9f87b0c2021-03-05 14:45:26 +01001398 *
1399 * Note that the compiled extension definition is created only in case the extension is instantiated. It is not available
1400 * from the compiled schema, but from the parsed extension definition which is being searched when an extension instance
1401 * is being compiled.
Radek Krejci0e59c312019-08-15 15:34:15 +02001402 */
1403struct lysc_ext {
1404 const char *name; /**< extension name */
Radek Krejci9f87b0c2021-03-05 14:45:26 +01001405 const char *argname; /**< argument name, NULL if not specified */
Radek Krejci0e59c312019-08-15 15:34:15 +02001406 struct lysc_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
Radek Krejcicc9e30f2021-03-29 12:45:08 +02001407 struct lyplg_ext *plugin; /**< Plugin implementing the specific extension */
Radek Krejci0935f412019-08-20 16:15:18 +02001408 struct lys_module *module; /**< module structure */
Michal Vasko6f4cbb62020-02-28 11:15:47 +01001409 uint32_t refcount; /**< reference counter since extension definition is shared among all its instances */
Radek Krejci0e59c312019-08-15 15:34:15 +02001410 uint16_t flags; /**< LYS_STATUS_* value (@ref snodeflags) */
1411};
1412
1413/**
Radek Krejcib1c11532021-03-29 14:14:19 +02001414 * @brief Description of the extension instance substatements.
1415 *
1416 * Provided by extensions plugins to libyang to be able to correctly compile the content of extension instances.
1417 * Note that order of the defined records matters - just follow the values of ::ly_stmt and order the records from lower to higher values.
1418 */
1419struct lysc_ext_substmt {
1420 enum ly_stmt stmt; /**< allowed substatement */
1421 enum ly_stmt_cardinality cardinality; /**< cardinality of the substatement */
1422 void *storage; /**< pointer to the storage of the compiled statement according to the specific
1423 lysc_ext_substmt::stmt and lysc_ext_substmt::cardinality */
1424};
1425
1426/**
Radek Krejcice8c1592018-10-29 15:35:51 +01001427 * @brief YANG extension instance
1428 */
1429struct lysc_ext_instance {
Radek Krejciad5963b2019-09-06 16:03:05 +02001430 struct lysc_ext *def; /**< pointer to the extension definition */
Radek Krejcice8c1592018-10-29 15:35:51 +01001431 const char *argument; /**< optional value of the extension's argument */
Radek Krejciab430862021-03-02 20:13:40 +01001432 struct lys_module *module; /**< module where the extension instantiated is defined */
Radek Krejci2a408df2018-10-29 16:32:26 +01001433 struct lysc_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
Radek Krejci5f9a3672021-03-05 21:35:22 +01001434 struct lysc_ext_substmt *substmts; /**< list of allowed substatements with the storage to access the present
1435 substatements ([sized array](@ref sizedarrays)) */
Radek Krejci0e59c312019-08-15 15:34:15 +02001436 void *data; /**< private plugins's data, not used by libyang */
Radek Krejciab430862021-03-02 20:13:40 +01001437
1438 void *parent; /**< pointer to the parent element holding the extension instance(s), use
1439 ::lysc_ext_instance#parent_stmt to access the schema element */
1440 enum ly_stmt parent_stmt; /**< value identifying placement of the extension instance in specific statement */
1441 LY_ARRAY_COUNT_TYPE parent_stmt_index; /**< in case the instance is in a substatement, this identifies
1442 the index of that substatement in its [sized array](@ref sizedarrays) (if any) */
Radek Krejcice8c1592018-10-29 15:35:51 +01001443};
1444
1445/**
Radek Krejcidd4e8d42018-10-16 14:55:43 +02001446 * @brief YANG when-stmt
Radek Krejci5aeea3a2018-09-05 13:29:36 +02001447 */
Radek Krejcidd4e8d42018-10-16 14:55:43 +02001448struct lysc_when {
1449 struct lyxp_expr *cond; /**< XPath when condition */
Michal Vasko175012e2019-11-06 15:49:14 +01001450 struct lysc_node *context; /**< context node for evaluating the expression, NULL if the context is root node */
Michal Vasko5d24f6c2020-10-13 13:49:06 +02001451 struct lysc_prefix *prefixes; /**< compiled used prefixes in the condition */
Radek Krejcic8b31002019-01-08 10:24:45 +01001452 const char *dsc; /**< description */
1453 const char *ref; /**< reference */
Radek Krejcie53a8dc2018-10-17 12:52:40 +02001454 struct lysc_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
Radek Krejci00b874b2019-02-12 10:54:50 +01001455 uint32_t refcount; /**< reference counter since some of the when statements are shared among several nodes */
Michal Vaskoecd62de2019-11-13 12:35:11 +01001456 uint16_t flags; /**< [schema node flags](@ref snodeflags) - only LYS_STATUS is allowed */
Radek Krejcidd4e8d42018-10-16 14:55:43 +02001457};
1458
1459/**
Radek Krejci2a408df2018-10-29 16:32:26 +01001460 * @brief YANG identity-stmt
1461 */
1462struct lysc_ident {
Michal Vaskoe313c382022-03-14 13:04:47 +01001463 const char *name; /**< identity name (mandatory, no prefix) */
Radek Krejcic8b31002019-01-08 10:24:45 +01001464 const char *dsc; /**< description */
1465 const char *ref; /**< reference */
Radek Krejci693262f2019-04-29 15:23:20 +02001466 struct lys_module *module; /**< module structure */
aPiecek6b3d5422021-07-30 15:55:43 +02001467 struct lysc_ident **derived; /**< list of (pointers to the) derived identities ([sized array](@ref sizedarrays))
1468 It also contains references to identities located in unimplemented modules. */
Radek Krejci2a408df2018-10-29 16:32:26 +01001469 struct lysc_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
1470 uint16_t flags; /**< [schema node flags](@ref snodeflags) - only LYS_STATUS_ values are allowed */
1471};
1472
1473/**
Radek Krejci151a5b72018-10-19 14:21:44 +02001474 * @defgroup ifftokens if-feature expression tokens
Radek Krejci8678fa42020-08-18 16:07:28 +02001475 * Tokens of if-feature expression used in ::lysc_iffeature.expr.
Radek Krejci151a5b72018-10-19 14:21:44 +02001476 *
1477 * @{
1478 */
1479#define LYS_IFF_NOT 0x00 /**< operand "not" */
1480#define LYS_IFF_AND 0x01 /**< operand "and" */
1481#define LYS_IFF_OR 0x02 /**< operand "or" */
1482#define LYS_IFF_F 0x03 /**< feature */
Radek Krejci2ff0d572020-05-21 15:27:28 +02001483/** @} ifftokens */
Radek Krejci151a5b72018-10-19 14:21:44 +02001484
1485/**
Radek Krejcib7db73a2018-10-24 14:18:40 +02001486 * @brief Compiled YANG revision statement
1487 */
1488struct lysc_revision {
1489 char date[LY_REV_SIZE]; /**< revision-date (mandatory) */
1490 struct lysc_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
1491};
1492
Radek Krejci2167ee12018-11-02 16:09:07 +01001493struct lysc_range {
Radek Krejci4f28eda2018-11-12 11:46:16 +01001494 struct lysc_range_part {
Radek Krejci693262f2019-04-29 15:23:20 +02001495 union { /**< min boundary */
Radek Krejcie7b95092019-05-15 11:03:07 +02001496 int64_t min_64; /**< for int8, int16, int32, int64 and decimal64 ( >= LY_TYPE_DEC64) */
1497 uint64_t min_u64; /**< for uint8, uint16, uint32, uint64, string and binary ( < LY_TYPE_DEC64) */
Radek Krejci2167ee12018-11-02 16:09:07 +01001498 };
Radek Krejci693262f2019-04-29 15:23:20 +02001499 union { /**< max boundary */
Radek Krejcie7b95092019-05-15 11:03:07 +02001500 int64_t max_64; /**< for int8, int16, int32, int64 and decimal64 ( >= LY_TYPE_DEC64) */
1501 uint64_t max_u64; /**< for uint8, uint16, uint32, uint64, string and binary ( < LY_TYPE_DEC64) */
Radek Krejci2167ee12018-11-02 16:09:07 +01001502 };
Radek Krejci4f28eda2018-11-12 11:46:16 +01001503 } *parts; /**< compiled range expression ([sized array](@ref sizedarrays)) */
Radek Krejcic8b31002019-01-08 10:24:45 +01001504 const char *dsc; /**< description */
1505 const char *ref; /**< reference */
Radek Krejci2167ee12018-11-02 16:09:07 +01001506 const char *emsg; /**< error-message */
1507 const char *eapptag; /**< error-app-tag value */
1508 struct lysc_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
1509};
1510
1511struct lysc_pattern {
Radek Krejci54579462019-04-30 12:47:06 +02001512 const char *expr; /**< original, not compiled, regular expression */
1513 pcre2_code *code; /**< compiled regular expression */
Radek Krejcic8b31002019-01-08 10:24:45 +01001514 const char *dsc; /**< description */
1515 const char *ref; /**< reference */
Radek Krejci2167ee12018-11-02 16:09:07 +01001516 const char *emsg; /**< error-message */
1517 const char *eapptag; /**< error-app-tag value */
1518 struct lysc_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
Radek Krejci0f969882020-08-21 16:56:47 +02001519 uint32_t inverted : 1; /**< invert-match flag */
1520 uint32_t refcount : 31; /**< reference counter */
Radek Krejci2167ee12018-11-02 16:09:07 +01001521};
1522
1523struct lysc_must {
Radek Krejci2167ee12018-11-02 16:09:07 +01001524 struct lyxp_expr *cond; /**< XPath when condition */
Michal Vasko5d24f6c2020-10-13 13:49:06 +02001525 struct lysc_prefix *prefixes; /**< compiled used prefixes in the condition */
Radek Krejcic8b31002019-01-08 10:24:45 +01001526 const char *dsc; /**< description */
1527 const char *ref; /**< reference */
Radek Krejci2167ee12018-11-02 16:09:07 +01001528 const char *emsg; /**< error-message */
1529 const char *eapptag; /**< error-app-tag value */
1530 struct lysc_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
1531};
1532
1533struct lysc_type {
Radek Krejci4f28eda2018-11-12 11:46:16 +01001534 struct lysc_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
Radek Krejci5f351892021-03-22 16:13:05 +01001535 struct lyplg_type *plugin; /**< type's plugin with built-in as well as user functions to canonize or validate the value of the type */
Radek Krejci2167ee12018-11-02 16:09:07 +01001536 LY_DATA_TYPE basetype; /**< Base type of the type */
Michal Vasko080064b2021-08-31 15:20:44 +02001537 uint32_t refcount; /**< reference counter for type sharing, it may be accessed concurrently when
Michal Vaskobabf0bd2021-08-31 14:55:39 +02001538 creating/freeing data node values that reference it (instance-identifier) */
Radek Krejci2167ee12018-11-02 16:09:07 +01001539};
1540
1541struct lysc_type_num {
Radek Krejci4f28eda2018-11-12 11:46:16 +01001542 struct lysc_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
Radek Krejci5f351892021-03-22 16:13:05 +01001543 struct lyplg_type *plugin; /**< type's plugin with built-in as well as user functions to canonize or validate the value of the type */
Radek Krejci2167ee12018-11-02 16:09:07 +01001544 LY_DATA_TYPE basetype; /**< Base type of the type */
Michal Vasko080064b2021-08-31 15:20:44 +02001545 uint32_t refcount; /**< reference counter for type sharing */
Radek Krejci2167ee12018-11-02 16:09:07 +01001546 struct lysc_range *range; /**< Optional range limitation */
1547};
1548
1549struct lysc_type_dec {
Radek Krejci4f28eda2018-11-12 11:46:16 +01001550 struct lysc_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
Radek Krejci5f351892021-03-22 16:13:05 +01001551 struct lyplg_type *plugin; /**< type's plugin with built-in as well as user functions to canonize or validate the value of the type */
Radek Krejci2167ee12018-11-02 16:09:07 +01001552 LY_DATA_TYPE basetype; /**< Base type of the type */
Michal Vasko080064b2021-08-31 15:20:44 +02001553 uint32_t refcount; /**< reference counter for type sharing */
Radek Krejci6cba4292018-11-15 17:33:29 +01001554 uint8_t fraction_digits; /**< fraction digits specification */
Radek Krejci2167ee12018-11-02 16:09:07 +01001555 struct lysc_range *range; /**< Optional range limitation */
1556};
1557
1558struct lysc_type_str {
Radek Krejci4f28eda2018-11-12 11:46:16 +01001559 struct lysc_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
Radek Krejci5f351892021-03-22 16:13:05 +01001560 struct lyplg_type *plugin; /**< type's plugin with built-in as well as user functions to canonize or validate the value of the type */
Radek Krejci2167ee12018-11-02 16:09:07 +01001561 LY_DATA_TYPE basetype; /**< Base type of the type */
Michal Vasko080064b2021-08-31 15:20:44 +02001562 uint32_t refcount; /**< reference counter for type sharing */
Radek Krejci2167ee12018-11-02 16:09:07 +01001563 struct lysc_range *length; /**< Optional length limitation */
Radek Krejci4586a022018-11-13 11:29:26 +01001564 struct lysc_pattern **patterns; /**< Optional list of pointers to pattern limitations ([sized array](@ref sizedarrays)) */
Radek Krejci2167ee12018-11-02 16:09:07 +01001565};
1566
Radek Krejci693262f2019-04-29 15:23:20 +02001567struct lysc_type_bitenum_item {
1568 const char *name; /**< enumeration identifier */
1569 const char *dsc; /**< description */
1570 const char *ref; /**< reference */
1571 struct lysc_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
Radek Krejci693262f2019-04-29 15:23:20 +02001572 union {
1573 int32_t value; /**< integer value associated with the enumeration */
1574 uint32_t position; /**< non-negative integer value associated with the bit */
1575 };
Michal Vaskof4fa90d2021-11-11 15:05:19 +01001576 uint16_t flags; /**< [schema node flags](@ref snodeflags) - only LYS_STATUS_ and LYS_IS_ENUM values
1577 are allowed */
Radek Krejci693262f2019-04-29 15:23:20 +02001578};
1579
Radek Krejci2167ee12018-11-02 16:09:07 +01001580struct lysc_type_enum {
Radek Krejci4f28eda2018-11-12 11:46:16 +01001581 struct lysc_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
Radek Krejci5f351892021-03-22 16:13:05 +01001582 struct lyplg_type *plugin; /**< type's plugin with built-in as well as user functions to canonize or validate the value of the type */
Radek Krejci2167ee12018-11-02 16:09:07 +01001583 LY_DATA_TYPE basetype; /**< Base type of the type */
Michal Vasko080064b2021-08-31 15:20:44 +02001584 uint32_t refcount; /**< reference counter for type sharing */
Radek Krejci693262f2019-04-29 15:23:20 +02001585 struct lysc_type_bitenum_item *enums; /**< enumerations list ([sized array](@ref sizedarrays)), mandatory (at least 1 item) */
1586};
1587
1588struct lysc_type_bits {
1589 struct lysc_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
Radek Krejci5f351892021-03-22 16:13:05 +01001590 struct lyplg_type *plugin; /**< type's plugin with built-in as well as user functions to canonize or validate the value of the type */
Radek Krejci693262f2019-04-29 15:23:20 +02001591 LY_DATA_TYPE basetype; /**< Base type of the type */
Michal Vasko080064b2021-08-31 15:20:44 +02001592 uint32_t refcount; /**< reference counter for type sharing */
Radek Krejci849a62a2019-05-22 15:29:05 +02001593 struct lysc_type_bitenum_item *bits; /**< bits list ([sized array](@ref sizedarrays)), mandatory (at least 1 item),
1594 the items are ordered by their position value. */
Radek Krejci2167ee12018-11-02 16:09:07 +01001595};
1596
1597struct lysc_type_leafref {
Radek Krejci4f28eda2018-11-12 11:46:16 +01001598 struct lysc_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
Radek Krejci5f351892021-03-22 16:13:05 +01001599 struct lyplg_type *plugin; /**< type's plugin with built-in as well as user functions to canonize or validate the value of the type */
Radek Krejci2167ee12018-11-02 16:09:07 +01001600 LY_DATA_TYPE basetype; /**< Base type of the type */
Michal Vasko080064b2021-08-31 15:20:44 +02001601 uint32_t refcount; /**< reference counter for type sharing */
Michal Vasko004d3152020-06-11 19:59:22 +02001602 struct lyxp_expr *path; /**< parsed target path, compiled path cannot be stored because of type sharing */
Michal Vasko5d24f6c2020-10-13 13:49:06 +02001603 struct lysc_prefix *prefixes; /**< resolved prefixes used in the path */
Michal Vaskoed725d72021-06-23 12:03:45 +02001604 const struct lys_module *cur_mod;/**< unused, not needed */
Radek Krejci412ddfa2018-11-23 11:44:11 +01001605 struct lysc_type *realtype; /**< pointer to the real (first non-leafref in possible leafrefs chain) type. */
Radek Krejci2167ee12018-11-02 16:09:07 +01001606 uint8_t require_instance; /**< require-instance flag */
1607};
1608
1609struct lysc_type_identityref {
Radek Krejci4f28eda2018-11-12 11:46:16 +01001610 struct lysc_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
Radek Krejci5f351892021-03-22 16:13:05 +01001611 struct lyplg_type *plugin; /**< type's plugin with built-in as well as user functions to canonize or validate the value of the type */
Radek Krejci2167ee12018-11-02 16:09:07 +01001612 LY_DATA_TYPE basetype; /**< Base type of the type */
Michal Vasko080064b2021-08-31 15:20:44 +02001613 uint32_t refcount; /**< reference counter for type sharing */
Radek Krejci555cb5b2018-11-16 14:54:33 +01001614 struct lysc_ident **bases; /**< list of pointers to the base identities ([sized array](@ref sizedarrays)),
Radek Krejci2167ee12018-11-02 16:09:07 +01001615 mandatory (at least 1 item) */
1616};
1617
1618struct lysc_type_instanceid {
Radek Krejci4f28eda2018-11-12 11:46:16 +01001619 struct lysc_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
Radek Krejci5f351892021-03-22 16:13:05 +01001620 struct lyplg_type *plugin; /**< type's plugin with built-in as well as user functions to canonize or validate the value of the type */
Radek Krejci2167ee12018-11-02 16:09:07 +01001621 LY_DATA_TYPE basetype; /**< Base type of the type */
Michal Vasko080064b2021-08-31 15:20:44 +02001622 uint32_t refcount; /**< reference counter for type sharing */
Radek Krejci2167ee12018-11-02 16:09:07 +01001623 uint8_t require_instance; /**< require-instance flag */
1624};
1625
Radek Krejci2167ee12018-11-02 16:09:07 +01001626struct lysc_type_union {
Radek Krejci4f28eda2018-11-12 11:46:16 +01001627 struct lysc_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
Radek Krejci5f351892021-03-22 16:13:05 +01001628 struct lyplg_type *plugin; /**< type's plugin with built-in as well as user functions to canonize or validate the value of the type */
Radek Krejci2167ee12018-11-02 16:09:07 +01001629 LY_DATA_TYPE basetype; /**< Base type of the type */
Michal Vasko080064b2021-08-31 15:20:44 +02001630 uint32_t refcount; /**< reference counter for type sharing */
Radek Krejci2167ee12018-11-02 16:09:07 +01001631 struct lysc_type **types; /**< list of types in the union ([sized array](@ref sizedarrays)), mandatory (at least 1 item) */
1632};
1633
1634struct lysc_type_bin {
Radek Krejci4f28eda2018-11-12 11:46:16 +01001635 struct lysc_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
Radek Krejci5f351892021-03-22 16:13:05 +01001636 struct lyplg_type *plugin; /**< type's plugin with built-in as well as user functions to canonize or validate the value of the type */
Radek Krejci2167ee12018-11-02 16:09:07 +01001637 LY_DATA_TYPE basetype; /**< Base type of the type */
Michal Vasko080064b2021-08-31 15:20:44 +02001638 uint32_t refcount; /**< reference counter for type sharing */
Radek Krejci2167ee12018-11-02 16:09:07 +01001639 struct lysc_range *length; /**< Optional length limitation */
Radek Krejci5aeea3a2018-09-05 13:29:36 +02001640};
1641
Michal Vasko60ea6352020-06-29 13:39:39 +02001642/**
1643 * @brief Maximum number of hashes stored in a schema node.
1644 */
1645#define LYS_NODE_HASH_COUNT 4
1646
Radek Krejci5aeea3a2018-09-05 13:29:36 +02001647/**
Radek Krejci0af5f5d2018-09-07 15:00:30 +02001648 * @brief Compiled YANG data node
1649 */
1650struct lysc_node {
Radek Krejcide7a9c42021-03-10 13:13:06 +01001651 uint16_t nodetype; /**< [type of the node](@ref schemanodetypes) (mandatory) */
Radek Krejcidd4e8d42018-10-16 14:55:43 +02001652 uint16_t flags; /**< [schema node flags](@ref snodeflags) */
Michal Vasko60ea6352020-06-29 13:39:39 +02001653 uint8_t hash[LYS_NODE_HASH_COUNT]; /**< schema hash required for LYB printer/parser */
Radek Krejcibd8d9ba2018-11-02 16:06:26 +01001654 struct lys_module *module; /**< module structure */
Radek Krejcibd8d9ba2018-11-02 16:06:26 +01001655 struct lysc_node *parent; /**< parent node (NULL in case of top level node) */
1656 struct lysc_node *next; /**< next sibling node (NULL if there is no one) */
1657 struct lysc_node *prev; /**< pointer to the previous sibling node \note Note that this pointer is
1658 never NULL. If there is no sibling node, pointer points to the node
1659 itself. In case of the first node, this pointer points to the last
1660 node in the list. */
Radek Krejcidd4e8d42018-10-16 14:55:43 +02001661 const char *name; /**< node name (mandatory) */
Radek Krejci12fb9142019-01-08 09:45:30 +01001662 const char *dsc; /**< description */
1663 const char *ref; /**< reference */
Radek Krejcie53a8dc2018-10-17 12:52:40 +02001664 struct lysc_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
aPiecek9922ea92021-04-12 07:59:20 +02001665 void *priv; /**< private arbitrary user data, not used by libyang unless ::LY_CTX_SET_PRIV_PARSED is set */
Radek Krejcidd4e8d42018-10-16 14:55:43 +02001666};
1667
Radek Krejci00a3e8a2021-01-27 08:24:49 +01001668struct lysc_node_action_inout {
1669 union {
1670 struct lysc_node node; /**< implicit cast for the members compatible with ::lysc_node */
1671 struct {
1672 uint16_t nodetype; /**< LYS_INPUT or LYS_OUTPUT */
1673 uint16_t flags; /**< [schema node flags](@ref snodeflags) */
1674 uint8_t hash[LYS_NODE_HASH_COUNT]; /**< schema hash required for LYB printer/parser */
1675 struct lys_module *module; /**< module structure */
Radek Krejci5960c312021-01-27 20:24:22 +01001676 struct lysc_node *parent;/**< parent node (NULL in case of top level node) */
Michal Vasko544e58a2021-01-28 14:33:41 +01001677 struct lysc_node *next; /**< next sibling node (output node for input, NULL for output) */
1678 struct lysc_node *prev; /**< pointer to the previous sibling node (input and output node pointing to each other) */
Radek Krejci5960c312021-01-27 20:24:22 +01001679 const char *name; /**< "input" or "output" */
1680 const char *dsc; /**< ALWAYS NULL, compatibility member with ::lysc_node */
1681 const char *ref; /**< ALWAYS NULL, compatibility member with ::lysc_node */
Radek Krejci00a3e8a2021-01-27 08:24:49 +01001682 struct lysc_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
aPiecek9922ea92021-04-12 07:59:20 +02001683 void *priv; /** private arbitrary user data, not used by libyang unless ::LY_CTX_SET_PRIV_PARSED is set */
Radek Krejci00a3e8a2021-01-27 08:24:49 +01001684 };
1685 };
1686
Radek Krejci9a3823e2021-01-27 20:26:46 +01001687 struct lysc_node *child; /**< first child node (linked list) */
Radek Krejci00a3e8a2021-01-27 08:24:49 +01001688 struct lysc_must *musts; /**< list of must restrictions ([sized array](@ref sizedarrays)) */
1689};
1690
1691struct lysc_node_action {
1692 union {
1693 struct lysc_node node; /**< implicit cast for the members compatible with ::lysc_node */
1694 struct {
1695 uint16_t nodetype; /**< LYS_RPC or LYS_ACTION */
1696 uint16_t flags; /**< [schema node flags](@ref snodeflags) */
1697 uint8_t hash[LYS_NODE_HASH_COUNT]; /**< schema hash required for LYB printer/parser */
1698 struct lys_module *module; /**< module structure */
1699 struct lysc_node *parent; /**< parent node (NULL in case of top level node - RPC) */
1700 struct lysc_node_action *next; /**< next sibling node (NULL if there is no one) */
1701 struct lysc_node_action *prev; /**< pointer to the previous sibling node \note Note that this pointer is
1702 never NULL. If there is no sibling node, pointer points to the node
1703 itself. In case of the first node, this pointer points to the last
1704 node in the list. */
1705 const char *name; /**< action/RPC name (mandatory) */
1706 const char *dsc; /**< description */
1707 const char *ref; /**< reference */
1708 struct lysc_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
aPiecek9922ea92021-04-12 07:59:20 +02001709 void *priv; /** private arbitrary user data, not used by libyang unless ::LY_CTX_SET_PRIV_PARSED is set */
Radek Krejci00a3e8a2021-01-27 08:24:49 +01001710 };
1711 };
1712
Radek Krejci9a3823e2021-01-27 20:26:46 +01001713 struct lysc_when **when; /**< list of pointers to when statements ([sized array](@ref sizedarrays)),
1714 the action/RPC nodes do not contain the when statement on their own, but they can
1715 inherit it from the parent's uses. */
Radek Krejci00a3e8a2021-01-27 08:24:49 +01001716 struct lysc_node_action_inout input; /**< RPC's/action's input */
1717 struct lysc_node_action_inout output; /**< RPC's/action's output */
1718
1719};
1720
1721struct lysc_node_notif {
1722 union {
1723 struct lysc_node node; /**< implicit cast for the members compatible with ::lysc_node */
1724 struct {
1725 uint16_t nodetype; /**< LYS_NOTIF */
1726 uint16_t flags; /**< [schema node flags](@ref snodeflags) */
1727 uint8_t hash[LYS_NODE_HASH_COUNT]; /**< schema hash required for LYB printer/parser */
1728 struct lys_module *module; /**< module structure */
1729 struct lysc_node *parent; /**< parent node (NULL in case of top level node) */
1730 struct lysc_node_notif *next; /**< next sibling node (NULL if there is no one) */
1731 struct lysc_node_notif *prev; /**< pointer to the previous sibling node \note Note that this pointer is
1732 never NULL. If there is no sibling node, pointer points to the node
1733 itself. In case of the first node, this pointer points to the last
1734 node in the list. */
1735 const char *name; /**< Notification name (mandatory) */
1736 const char *dsc; /**< description */
1737 const char *ref; /**< reference */
1738 struct lysc_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
aPiecek9922ea92021-04-12 07:59:20 +02001739 void *priv; /** private arbitrary user data, not used by libyang unless ::LY_CTX_SET_PRIV_PARSED is set */
Radek Krejci00a3e8a2021-01-27 08:24:49 +01001740 };
1741 };
1742
Radek Krejci9a3823e2021-01-27 20:26:46 +01001743 struct lysc_node *child; /**< first child node (linked list) */
Radek Krejci00a3e8a2021-01-27 08:24:49 +01001744 struct lysc_must *musts; /**< list of must restrictions ([sized array](@ref sizedarrays)) */
Radek Krejci9a3823e2021-01-27 20:26:46 +01001745 struct lysc_when **when; /**< list of pointers to when statements ([sized array](@ref sizedarrays)),
1746 the notification nodes do not contain the when statement on their own, but they can
1747 inherit it from the parent's uses. */
Radek Krejci00a3e8a2021-01-27 08:24:49 +01001748};
1749
1750struct lysc_node_container {
1751 union {
1752 struct lysc_node node; /**< implicit cast for the members compatible with ::lysc_node */
1753 struct {
1754 uint16_t nodetype; /**< LYS_CONTAINER */
1755 uint16_t flags; /**< [schema node flags](@ref snodeflags) */
1756 uint8_t hash[LYS_NODE_HASH_COUNT]; /**< schema hash required for LYB printer/parser */
1757 struct lys_module *module; /**< module structure */
1758 struct lysc_node *parent; /**< parent node (NULL in case of top level node) */
1759 struct lysc_node *next; /**< next sibling node (NULL if there is no one) */
1760 struct lysc_node *prev; /**< pointer to the previous sibling node \note Note that this pointer is
1761 never NULL. If there is no sibling node, pointer points to the node
1762 itself. In case of the first node, this pointer points to the last
1763 node in the list. */
1764 const char *name; /**< node name (mandatory) */
1765 const char *dsc; /**< description */
1766 const char *ref; /**< reference */
1767 struct lysc_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
aPiecek9922ea92021-04-12 07:59:20 +02001768 void *priv; /**< private arbitrary user data, not used by libyang unless ::LY_CTX_SET_PRIV_PARSED is set */
Radek Krejci00a3e8a2021-01-27 08:24:49 +01001769 };
1770 };
Radek Krejci4f28eda2018-11-12 11:46:16 +01001771
1772 struct lysc_node *child; /**< first child node (linked list) */
1773 struct lysc_must *musts; /**< list of must restrictions ([sized array](@ref sizedarrays)) */
Radek Krejci9a3823e2021-01-27 20:26:46 +01001774 struct lysc_when **when; /**< list of pointers to when statements ([sized array](@ref sizedarrays)) */
Radek Krejci2a9fc652021-01-22 17:44:34 +01001775 struct lysc_node_action *actions;/**< first of actions nodes (linked list) */
1776 struct lysc_node_notif *notifs; /**< first of notifications nodes (linked list) */
Radek Krejcibd8d9ba2018-11-02 16:06:26 +01001777};
1778
Radek Krejcia3045382018-11-22 14:30:31 +01001779struct lysc_node_case {
Radek Krejci00a3e8a2021-01-27 08:24:49 +01001780 union {
1781 struct lysc_node node; /**< implicit cast for the members compatible with ::lysc_node */
1782 struct {
1783 uint16_t nodetype; /**< LYS_CASE */
1784 uint16_t flags; /**< [schema node flags](@ref snodeflags) */
1785 uint8_t hash[LYS_NODE_HASH_COUNT]; /**< schema hash required for LYB printer/parser, unused */
1786 struct lys_module *module; /**< module structure */
1787 struct lysc_node *parent; /**< parent node (NULL in case of top level node) */
1788 struct lysc_node *next; /**< next sibling node (NULL if there is no one) */
1789 struct lysc_node *prev; /**< pointer to the previous sibling node \note Note that this pointer is
Radek Krejci056d0a82018-12-06 16:57:25 +01001790 never NULL. If there is no sibling node, pointer points to the node
1791 itself. In case of the first node, this pointer points to the last
1792 node in the list. */
Radek Krejci00a3e8a2021-01-27 08:24:49 +01001793 const char *name; /**< name of the case, including the implicit case */
1794 const char *dsc; /**< description */
1795 const char *ref; /**< reference */
1796 struct lysc_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
aPiecek9922ea92021-04-12 07:59:20 +02001797 void *priv; /**< private arbitrary user data, not used by libyang unless ::LY_CTX_SET_PRIV_PARSED is set */
Radek Krejci00a3e8a2021-01-27 08:24:49 +01001798 };
1799 };
Radek Krejci056d0a82018-12-06 16:57:25 +01001800
Radek Krejcia3045382018-11-22 14:30:31 +01001801 struct lysc_node *child; /**< first child node of the case (linked list). Note that all the children of all the sibling cases are linked
Radek Krejcife13da42019-02-15 14:51:01 +01001802 each other as siblings with the parent pointer pointing to appropriate case node. */
Radek Krejci9a3823e2021-01-27 20:26:46 +01001803 struct lysc_when **when; /**< list of pointers to when statements ([sized array](@ref sizedarrays)) */
Radek Krejcia3045382018-11-22 14:30:31 +01001804};
1805
Radek Krejcibd8d9ba2018-11-02 16:06:26 +01001806struct lysc_node_choice {
Radek Krejci00a3e8a2021-01-27 08:24:49 +01001807 union {
1808 struct lysc_node node; /**< implicit cast for the members compatible with ::lysc_node */
1809 struct {
1810 uint16_t nodetype; /**< LYS_CHOICE */
1811 uint16_t flags; /**< [schema node flags](@ref snodeflags) */
1812 uint8_t hash[LYS_NODE_HASH_COUNT]; /**< schema hash required for LYB printer/parser, unused */
1813 struct lys_module *module; /**< module structure */
1814 struct lysc_node *parent; /**< parent node (NULL in case of top level node) */
1815 struct lysc_node *next; /**< next sibling node (NULL if there is no one) */
1816 struct lysc_node *prev; /**< pointer to the previous sibling node \note Note that this pointer is
Radek Krejcibd8d9ba2018-11-02 16:06:26 +01001817 never NULL. If there is no sibling node, pointer points to the node
1818 itself. In case of the first node, this pointer points to the last
1819 node in the list. */
Radek Krejci00a3e8a2021-01-27 08:24:49 +01001820 const char *name; /**< node name (mandatory) */
1821 const char *dsc; /**< description */
1822 const char *ref; /**< reference */
1823 struct lysc_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
aPiecek9922ea92021-04-12 07:59:20 +02001824 void *priv; /**< private arbitrary user data, not used by libyang unless ::LY_CTX_SET_PRIV_PARSED is set */
Radek Krejci00a3e8a2021-01-27 08:24:49 +01001825 };
1826 };
Radek Krejcibd8d9ba2018-11-02 16:06:26 +01001827
Radek Krejcia9026eb2018-12-12 16:04:47 +01001828 struct lysc_node_case *cases; /**< list of the cases (linked list). Note that all the children of all the cases are linked each other
1829 as siblings. Their parent pointers points to the specific case they belongs to, so distinguish the
1830 case is simple. */
Radek Krejci9a3823e2021-01-27 20:26:46 +01001831 struct lysc_when **when; /**< list of pointers to when statements ([sized array](@ref sizedarrays)) */
Radek Krejci056d0a82018-12-06 16:57:25 +01001832 struct lysc_node_case *dflt; /**< default case of the choice, only a pointer into the cases array. */
Radek Krejcibd8d9ba2018-11-02 16:06:26 +01001833};
1834
1835struct lysc_node_leaf {
Radek Krejci00a3e8a2021-01-27 08:24:49 +01001836 union {
1837 struct lysc_node node; /**< implicit cast for the members compatible with ::lysc_node */
1838 struct {
1839 uint16_t nodetype; /**< LYS_LEAF */
1840 uint16_t flags; /**< [schema node flags](@ref snodeflags) */
1841 uint8_t hash[LYS_NODE_HASH_COUNT]; /**< schema hash required for LYB printer/parser */
1842 struct lys_module *module; /**< module structure */
1843 struct lysc_node *parent; /**< parent node (NULL in case of top level node) */
1844 struct lysc_node *next; /**< next sibling node (NULL if there is no one) */
1845 struct lysc_node *prev; /**< pointer to the previous sibling node \note Note that this pointer is
Radek Krejcibd8d9ba2018-11-02 16:06:26 +01001846 never NULL. If there is no sibling node, pointer points to the node
1847 itself. In case of the first node, this pointer points to the last
1848 node in the list. */
Radek Krejci00a3e8a2021-01-27 08:24:49 +01001849 const char *name; /**< node name (mandatory) */
1850 const char *dsc; /**< description */
1851 const char *ref; /**< reference */
1852 struct lysc_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
aPiecek9922ea92021-04-12 07:59:20 +02001853 void *priv; /**< private arbitrary user data, not used by libyang unless ::LY_CTX_SET_PRIV_PARSED is set */
Radek Krejci00a3e8a2021-01-27 08:24:49 +01001854 };
1855 };
Radek Krejci4f28eda2018-11-12 11:46:16 +01001856
1857 struct lysc_must *musts; /**< list of must restrictions ([sized array](@ref sizedarrays)) */
Radek Krejci9a3823e2021-01-27 20:26:46 +01001858 struct lysc_when **when; /**< list of pointers to when statements ([sized array](@ref sizedarrays)) */
Radek Krejci4f28eda2018-11-12 11:46:16 +01001859 struct lysc_type *type; /**< type of the leaf node (mandatory) */
Radek Krejcib57cf1e2018-11-23 14:07:05 +01001860
Radek Krejci4f28eda2018-11-12 11:46:16 +01001861 const char *units; /**< units of the leaf's type */
Michal Vasko33876022021-04-27 16:42:24 +02001862 struct lyd_value *dflt; /**< default value, use ::lyd_value_get_canonical() to get the canonical string */
Radek Krejcibd8d9ba2018-11-02 16:06:26 +01001863};
1864
1865struct lysc_node_leaflist {
Radek Krejci00a3e8a2021-01-27 08:24:49 +01001866 union {
1867 struct lysc_node node; /**< implicit cast for the members compatible with ::lysc_node */
1868 struct {
1869 uint16_t nodetype; /**< LYS_LEAFLIST */
1870 uint16_t flags; /**< [schema node flags](@ref snodeflags) */
1871 uint8_t hash[LYS_NODE_HASH_COUNT]; /**< schema hash required for LYB printer/parser */
1872 struct lys_module *module; /**< module structure */
1873 struct lysc_node *parent; /**< parent node (NULL in case of top level node) */
1874 struct lysc_node *next; /**< next sibling node (NULL if there is no one) */
1875 struct lysc_node *prev; /**< pointer to the previous sibling node \note Note that this pointer is
Radek Krejcibd8d9ba2018-11-02 16:06:26 +01001876 never NULL. If there is no sibling node, pointer points to the node
1877 itself. In case of the first node, this pointer points to the last
1878 node in the list. */
Radek Krejci00a3e8a2021-01-27 08:24:49 +01001879 const char *name; /**< node name (mandatory) */
1880 const char *dsc; /**< description */
1881 const char *ref; /**< reference */
1882 struct lysc_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
aPiecek9922ea92021-04-12 07:59:20 +02001883 void *priv; /**< private arbitrary user data, not used by libyang unless ::LY_CTX_SET_PRIV_PARSED is set */
Radek Krejci00a3e8a2021-01-27 08:24:49 +01001884 };
1885 };
Radek Krejcib57cf1e2018-11-23 14:07:05 +01001886
1887 struct lysc_must *musts; /**< list of must restrictions ([sized array](@ref sizedarrays)) */
Radek Krejci9a3823e2021-01-27 20:26:46 +01001888 struct lysc_when **when; /**< list of pointers to when statements ([sized array](@ref sizedarrays)) */
Radek Krejcib57cf1e2018-11-23 14:07:05 +01001889 struct lysc_type *type; /**< type of the leaf node (mandatory) */
1890
Radek Krejci0e5d8382018-11-28 16:37:53 +01001891 const char *units; /**< units of the leaf's type */
Michal Vasko33876022021-04-27 16:42:24 +02001892 struct lyd_value **dflts; /**< list ([sized array](@ref sizedarrays)) of default values, use
1893 ::lyd_value_get_canonical() to get the canonical strings */
Michal Vaskoba99a3e2020-08-18 15:50:05 +02001894
Radek Krejci0e5d8382018-11-28 16:37:53 +01001895 uint32_t min; /**< min-elements constraint */
1896 uint32_t max; /**< max-elements constraint */
1897
Radek Krejcibd8d9ba2018-11-02 16:06:26 +01001898};
1899
1900struct lysc_node_list {
Radek Krejci00a3e8a2021-01-27 08:24:49 +01001901 union {
1902 struct lysc_node node; /**< implicit cast for the members compatible with ::lysc_node */
1903 struct {
1904 uint16_t nodetype; /**< LYS_LIST */
1905 uint16_t flags; /**< [schema node flags](@ref snodeflags) */
1906 uint8_t hash[LYS_NODE_HASH_COUNT]; /**< schema hash required for LYB printer/parser */
1907 struct lys_module *module; /**< module structure */
1908 struct lysc_node *parent; /**< parent node (NULL in case of top level node) */
1909 struct lysc_node *next; /**< next sibling node (NULL if there is no one) */
1910 struct lysc_node *prev; /**< pointer to the previous sibling node \note Note that this pointer is
Radek Krejcibd8d9ba2018-11-02 16:06:26 +01001911 never NULL. If there is no sibling node, pointer points to the node
1912 itself. In case of the first node, this pointer points to the last
1913 node in the list. */
Radek Krejci00a3e8a2021-01-27 08:24:49 +01001914 const char *name; /**< node name (mandatory) */
1915 const char *dsc; /**< description */
1916 const char *ref; /**< reference */
1917 struct lysc_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
aPiecek9922ea92021-04-12 07:59:20 +02001918 void *priv; /**< private arbitrary user data, not used by libyang unless ::LY_CTX_SET_PRIV_PARSED is set */
Radek Krejci00a3e8a2021-01-27 08:24:49 +01001919 };
1920 };
Radek Krejci9bb94eb2018-12-04 16:48:35 +01001921
1922 struct lysc_node *child; /**< first child node (linked list) */
1923 struct lysc_must *musts; /**< list of must restrictions ([sized array](@ref sizedarrays)) */
Radek Krejci9a3823e2021-01-27 20:26:46 +01001924 struct lysc_when **when; /**< list of pointers to when statements ([sized array](@ref sizedarrays)) */
Radek Krejci2a9fc652021-01-22 17:44:34 +01001925 struct lysc_node_action *actions;/**< first of actions nodes (linked list) */
1926 struct lysc_node_notif *notifs; /**< first of notifications nodes (linked list) */
Radek Krejci9bb94eb2018-12-04 16:48:35 +01001927
Radek Krejci2a9fc652021-01-22 17:44:34 +01001928 struct lysc_node_leaf ***uniques;/**< list of sized arrays of pointers to the unique nodes ([sized array](@ref sizedarrays)) */
Radek Krejci9bb94eb2018-12-04 16:48:35 +01001929 uint32_t min; /**< min-elements constraint */
1930 uint32_t max; /**< max-elements constraint */
Radek Krejcibd8d9ba2018-11-02 16:06:26 +01001931};
1932
1933struct lysc_node_anydata {
Radek Krejci00a3e8a2021-01-27 08:24:49 +01001934 union {
1935 struct lysc_node node; /**< implicit cast for the members compatible with ::lysc_node */
1936 struct {
1937 uint16_t nodetype; /**< LYS_ANYXML or LYS_ANYDATA */
1938 uint16_t flags; /**< [schema node flags](@ref snodeflags) */
1939 uint8_t hash[LYS_NODE_HASH_COUNT]; /**< schema hash required for LYB printer/parser */
1940 struct lys_module *module; /**< module structure */
1941 struct lysc_node *parent; /**< parent node (NULL in case of top level node) */
1942 struct lysc_node *next; /**< next sibling node (NULL if there is no one) */
1943 struct lysc_node *prev; /**< pointer to the previous sibling node \note Note that this pointer is
Radek Krejcibd8d9ba2018-11-02 16:06:26 +01001944 never NULL. If there is no sibling node, pointer points to the node
1945 itself. In case of the first node, this pointer points to the last
1946 node in the list. */
Radek Krejci00a3e8a2021-01-27 08:24:49 +01001947 const char *name; /**< node name (mandatory) */
1948 const char *dsc; /**< description */
1949 const char *ref; /**< reference */
1950 struct lysc_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
aPiecek9922ea92021-04-12 07:59:20 +02001951 void *priv; /**< private arbitrary user data, not used by libyang unless ::LY_CTX_SET_PRIV_PARSED is set */
Radek Krejci00a3e8a2021-01-27 08:24:49 +01001952 };
1953 };
Radek Krejci9800fb82018-12-13 14:26:23 +01001954
1955 struct lysc_must *musts; /**< list of must restrictions ([sized array](@ref sizedarrays)) */
Radek Krejci9a3823e2021-01-27 20:26:46 +01001956 struct lysc_when **when; /**< list of pointers to when statements ([sized array](@ref sizedarrays)) */
Radek Krejcibd8d9ba2018-11-02 16:06:26 +01001957};
1958
Radek Krejcidd4e8d42018-10-16 14:55:43 +02001959/**
1960 * @brief Compiled YANG schema tree structure representing YANG module.
1961 *
1962 * Semantically validated YANG schema tree for data tree parsing.
1963 * Contains only the necessary information for the data validation.
1964 */
1965struct lysc_module {
Radek Krejci0bcdaed2019-01-10 10:21:34 +01001966 struct lys_module *mod; /**< covering module structure */
Radek Krejcidd4e8d42018-10-16 14:55:43 +02001967
Radek Krejci2a408df2018-10-29 16:32:26 +01001968 struct lysc_node *data; /**< list of module's top-level data nodes (linked list) */
Radek Krejci2a9fc652021-01-22 17:44:34 +01001969 struct lysc_node_action *rpcs; /**< first of actions nodes (linked list) */
1970 struct lysc_node_notif *notifs; /**< first of notifications nodes (linked list) */
Radek Krejcice8c1592018-10-29 15:35:51 +01001971 struct lysc_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
Radek Krejci0af5f5d2018-09-07 15:00:30 +02001972};
1973
1974/**
Radek Krejci490a5462020-11-05 08:44:42 +01001975 * @brief Examine whether a node is user-ordered list or leaf-list.
1976 *
1977 * @param[in] lysc_node Schema node to examine.
1978 * @return Boolean value whether the @p node is user-ordered or not.
1979 */
1980#define lysc_is_userordered(lysc_node) \
1981 ((!lysc_node || !(lysc_node->nodetype & (LYS_LEAFLIST | LYS_LIST)) || !(lysc_node->flags & LYS_ORDBY_USER)) ? 0 : 1)
1982
1983/**
1984 * @brief Examine whether a node is a list's key.
1985 *
1986 * @param[in] lysc_node Schema node to examine.
1987 * @return Boolean value whether the @p node is a key or not.
1988 */
1989#define lysc_is_key(lysc_node) \
Michal Vaskobce7ee32021-02-04 11:05:25 +01001990 ((!lysc_node || (lysc_node->nodetype != LYS_LEAF) || !(lysc_node->flags & LYS_KEY)) ? 0 : 1)
Radek Krejci490a5462020-11-05 08:44:42 +01001991
1992/**
Michal Vasko5c123b02020-12-04 14:34:04 +01001993 * @brief Examine whether a node is a non-presence container.
1994 *
1995 * @param[in] lysc_node Schema node to examine.
1996 * @return Boolean value whether the @p node is a NP container or not.
1997 */
1998#define lysc_is_np_cont(lysc_node) \
Michal Vaskobce7ee32021-02-04 11:05:25 +01001999 ((!lysc_node || (lysc_node->nodetype != LYS_CONTAINER) || (lysc_node->flags & LYS_PRESENCE)) ? 0 : 1)
2000
2001/**
Michal Vaskoe78faec2021-04-08 17:24:43 +02002002 * @brief Examine whether a node is a key-less list or a non-configuration leaf-list.
Michal Vaskobce7ee32021-02-04 11:05:25 +01002003 *
2004 * @param[in] lysc_node Schema node to examine.
2005 * @return Boolean value whether the @p node is a list with duplicate instances allowed.
2006 */
2007#define lysc_is_dup_inst_list(lysc_node) \
2008 ((lysc_node && (((lysc_node->nodetype == LYS_LIST) && (lysc_node->flags & LYS_KEYLESS)) || \
Michal Vaskoe78faec2021-04-08 17:24:43 +02002009 ((lysc_node->nodetype == LYS_LEAFLIST) && !(lysc_node->flags & LYS_CONFIG_W)))) ? 1 : 0)
Michal Vasko5c123b02020-12-04 14:34:04 +01002010
2011/**
Michal Vaskof8ded142022-02-17 10:48:01 +01002012 * @brief Get nearest @p schema parent (including the node itself) that can be instantiated in data.
2013 *
2014 * @param[in] schema Schema node to get the nearest data node for.
2015 * @return Schema data node, NULL if top-level (in data).
2016 */
2017LIBYANG_API_DECL const struct lysc_node *lysc_data_node(const struct lysc_node *schema);
2018
2019/**
2020 * @brief Same as ::lysc_data_node() but never returns the node itself.
2021 */
2022#define lysc_data_parent(SCHEMA) lysc_data_node((SCHEMA) ? (SCHEMA)->parent : NULL)
2023
2024/**
Michal Vaskod5cfa6e2020-11-23 16:56:08 +01002025 * @brief Check whether the schema node data instance existence depends on any when conditions.
2026 * This node and any direct parent choice and case schema nodes are also examined for when conditions.
2027 *
2028 * Be careful, this function is not recursive and checks only conditions that apply to this node directly.
2029 * Meaning if there are any conditions associated with any data parent instance of @p node, they are not returned.
2030 *
2031 * @param[in] node Schema node to examine.
2032 * @return When condition associated with the node data instance, NULL if there is none.
2033 */
Jan Kundrátc53a7ec2021-12-09 16:01:19 +01002034LIBYANG_API_DECL const struct lysc_when *lysc_has_when(const struct lysc_node *node);
Michal Vaskod5cfa6e2020-11-23 16:56:08 +01002035
2036/**
Michal Vaskoef53c812021-10-13 10:21:03 +02002037 * @brief Get the owner module of the schema node. It is the module of the top-level node. Generally,
2038 * in case of augments it is the target module, recursively, otherwise it is the module where the node is defined.
2039 *
2040 * @param[in] node Schema node to examine.
2041 * @return Module owner of the node.
2042 */
Jan Kundrátc53a7ec2021-12-09 16:01:19 +01002043LIBYANG_API_DECL const struct lys_module *lysc_owner_module(const struct lysc_node *node);
Michal Vaskoef53c812021-10-13 10:21:03 +02002044
2045/**
Radek Krejci2a9fc652021-01-22 17:44:34 +01002046 * @brief Get the groupings linked list of the given (parsed) schema node.
Radek Krejci53ea6152018-12-13 15:21:15 +01002047 * Decides the node's type and in case it has a groupings array, returns it.
2048 * @param[in] node Node to examine.
Radek Krejci2a9fc652021-01-22 17:44:34 +01002049 * @return The node's groupings linked list if any, NULL otherwise.
Radek Krejci53ea6152018-12-13 15:21:15 +01002050 */
Jan Kundrátc53a7ec2021-12-09 16:01:19 +01002051LIBYANG_API_DECL const struct lysp_node_grp *lysp_node_groupings(const struct lysp_node *node);
Radek Krejci53ea6152018-12-13 15:21:15 +01002052
2053/**
Radek Krejci056d0a82018-12-06 16:57:25 +01002054 * @brief Get the typedefs sized array of the given (parsed) schema node.
2055 * Decides the node's type and in case it has a typedefs array, returns it.
2056 * @param[in] node Node to examine.
2057 * @return The node's typedefs sized array if any, NULL otherwise.
2058 */
Jan Kundrátc53a7ec2021-12-09 16:01:19 +01002059LIBYANG_API_DECL const struct lysp_tpdf *lysp_node_typedefs(const struct lysp_node *node);
Radek Krejci056d0a82018-12-06 16:57:25 +01002060
2061/**
Radek Krejci2a9fc652021-01-22 17:44:34 +01002062 * @brief Get the actions/RPCs linked list of the given (parsed) schema node.
Radek Krejci056d0a82018-12-06 16:57:25 +01002063 * Decides the node's type and in case it has a actions/RPCs array, returns it.
2064 * @param[in] node Node to examine.
Radek Krejci2a9fc652021-01-22 17:44:34 +01002065 * @return The node's actions/RPCs linked list if any, NULL otherwise.
Radek Krejci056d0a82018-12-06 16:57:25 +01002066 */
Jan Kundrátc53a7ec2021-12-09 16:01:19 +01002067LIBYANG_API_DECL const struct lysp_node_action *lysp_node_actions(const struct lysp_node *node);
Radek Krejci056d0a82018-12-06 16:57:25 +01002068
2069/**
Radek Krejci2a9fc652021-01-22 17:44:34 +01002070 * @brief Get the Notifications linked list of the given (parsed) schema node.
Radek Krejci056d0a82018-12-06 16:57:25 +01002071 * Decides the node's type and in case it has a Notifications array, returns it.
2072 * @param[in] node Node to examine.
Radek Krejci2a9fc652021-01-22 17:44:34 +01002073 * @return The node's Notifications linked list if any, NULL otherwise.
Radek Krejci056d0a82018-12-06 16:57:25 +01002074 */
Jan Kundrátc53a7ec2021-12-09 16:01:19 +01002075LIBYANG_API_DECL const struct lysp_node_notif *lysp_node_notifs(const struct lysp_node *node);
Radek Krejci056d0a82018-12-06 16:57:25 +01002076
2077/**
2078 * @brief Get the children linked list of the given (parsed) schema node.
2079 * Decides the node's type and in case it has a children list, returns it.
2080 * @param[in] node Node to examine.
2081 * @return The node's children linked list if any, NULL otherwise.
2082 */
Jan Kundrátc53a7ec2021-12-09 16:01:19 +01002083LIBYANG_API_DECL const struct lysp_node *lysp_node_child(const struct lysp_node *node);
Radek Krejci056d0a82018-12-06 16:57:25 +01002084
2085/**
Radek Krejci2a9fc652021-01-22 17:44:34 +01002086 * @brief Get the actions/RPCs linked list of the given (compiled) schema node.
Radek Krejci056d0a82018-12-06 16:57:25 +01002087 * Decides the node's type and in case it has a actions/RPCs array, returns it.
2088 * @param[in] node Node to examine.
Radek Krejci2a9fc652021-01-22 17:44:34 +01002089 * @return The node's actions/RPCs linked list if any, NULL otherwise.
Radek Krejci056d0a82018-12-06 16:57:25 +01002090 */
Jan Kundrátc53a7ec2021-12-09 16:01:19 +01002091LIBYANG_API_DECL const struct lysc_node_action *lysc_node_actions(const struct lysc_node *node);
Radek Krejci056d0a82018-12-06 16:57:25 +01002092
2093/**
Radek Krejci2a9fc652021-01-22 17:44:34 +01002094 * @brief Get the Notifications linked list of the given (compiled) schema node.
Radek Krejci056d0a82018-12-06 16:57:25 +01002095 * Decides the node's type and in case it has a Notifications array, returns it.
2096 * @param[in] node Node to examine.
Radek Krejci2a9fc652021-01-22 17:44:34 +01002097 * @return The node's Notifications linked list if any, NULL otherwise.
Radek Krejci056d0a82018-12-06 16:57:25 +01002098 */
Jan Kundrátc53a7ec2021-12-09 16:01:19 +01002099LIBYANG_API_DECL const struct lysc_node_notif *lysc_node_notifs(const struct lysc_node *node);
Radek Krejci056d0a82018-12-06 16:57:25 +01002100
2101/**
2102 * @brief Get the children linked list of the given (compiled) schema node.
Michal Vasko2a668712020-10-21 11:48:09 +02002103 *
Michal Vasko544e58a2021-01-28 14:33:41 +01002104 * Note that ::LYS_CHOICE has only ::LYS_CASE children.
2105 * Also, ::LYS_RPC and ::LYS_ACTION have the first child ::LYS_INPUT, its sibling is ::LYS_OUTPUT.
2106 *
Michal Vasko2a668712020-10-21 11:48:09 +02002107 * @param[in] node Node to examine.
Michal Vasko2a668712020-10-21 11:48:09 +02002108 * @return Children linked list if any,
2109 * @return NULL otherwise.
2110 */
Jan Kundrátc53a7ec2021-12-09 16:01:19 +01002111LIBYANG_API_DECL const struct lysc_node *lysc_node_child(const struct lysc_node *node);
Michal Vasko2a668712020-10-21 11:48:09 +02002112
2113/**
Radek Krejci9a3823e2021-01-27 20:26:46 +01002114 * @brief Get the must statements list if present in the @p node
2115 *
2116 * @param[in] node Node to examine.
2117 * @return Pointer to the list of must restrictions ([sized array](@ref sizedarrays))
2118 * @return NULL if there is no must statement in the node, no matter if it is not even allowed or just present
2119 */
Jan Kundrátc53a7ec2021-12-09 16:01:19 +01002120LIBYANG_API_DECL struct lysc_must *lysc_node_musts(const struct lysc_node *node);
Radek Krejci9a3823e2021-01-27 20:26:46 +01002121
2122/**
2123 * @brief Get the when statements list if present in the @p node
2124 *
2125 * @param[in] node Node to examine.
2126 * @return Pointer to the list of pointers to when statements ([sized array](@ref sizedarrays))
2127 * @return NULL if there is no when statement in the node, no matter if it is not even allowed or just present
2128 */
Jan Kundrátc53a7ec2021-12-09 16:01:19 +01002129LIBYANG_API_DECL struct lysc_when **lysc_node_when(const struct lysc_node *node);
Radek Krejci9a3823e2021-01-27 20:26:46 +01002130
2131/**
Michal Vaskof1ab44f2020-10-22 08:58:32 +02002132 * @brief Callback to be called for every schema node in a DFS traversal.
2133 *
2134 * @param[in] node Current node.
2135 * @param[in] data Arbitrary user data.
2136 * @param[out] dfs_continue Set to true if the current subtree should be skipped and continue with siblings instead.
2137 * @return LY_SUCCESS on success,
2138 * @return LY_ERR value to terminate DFS and return this value.
2139 */
Michal Vasko8f07dfe2021-03-02 16:10:24 +01002140typedef LY_ERR (*lysc_dfs_clb)(struct lysc_node *node, void *data, ly_bool *dfs_continue);
Michal Vaskof1ab44f2020-10-22 08:58:32 +02002141
2142/**
2143 * @brief DFS traversal of all the schema nodes in a (sub)tree including any actions and nested notifications.
2144 *
2145 * Node with children, actions, and notifications is traversed in this order:
2146 * 1) each child subtree;
2147 * 2) each action subtree;
2148 * 3) each notification subtree.
2149 *
2150 * For algorithm illustration or traversal with actions and notifications skipped, see ::LYSC_TREE_DFS_BEGIN.
2151 *
2152 * @param[in] root Schema root to fully traverse.
2153 * @param[in] dfs_clb Callback to call for each node.
2154 * @param[in] data Arbitrary user data passed to @p dfs_clb.
2155 * @return LY_SUCCESS on success,
2156 * @return LY_ERR value returned by @p dfs_clb.
2157 */
Jan Kundrátc53a7ec2021-12-09 16:01:19 +01002158LIBYANG_API_DECL LY_ERR lysc_tree_dfs_full(const struct lysc_node *root, lysc_dfs_clb dfs_clb, void *data);
Michal Vaskof1ab44f2020-10-22 08:58:32 +02002159
2160/**
2161 * @brief DFS traversal of all the schema nodes in a module including RPCs and notifications.
2162 *
2163 * For more details, see ::lysc_tree_dfs_full().
2164 *
2165 * @param[in] mod Module to fully traverse.
2166 * @param[in] dfs_clb Callback to call for each node.
2167 * @param[in] data Arbitrary user data passed to @p dfs_clb.
2168 * @return LY_SUCCESS on success,
2169 * @return LY_ERR value returned by @p dfs_clb.
2170 */
Jan Kundrátc53a7ec2021-12-09 16:01:19 +01002171LIBYANG_API_DECL LY_ERR lysc_module_dfs_full(const struct lys_module *mod, lysc_dfs_clb dfs_clb, void *data);
Michal Vaskof1ab44f2020-10-22 08:58:32 +02002172
2173/**
Radek Krejci151a5b72018-10-19 14:21:44 +02002174 * @brief Get how the if-feature statement currently evaluates.
2175 *
2176 * @param[in] iff Compiled if-feature statement to evaluate.
Michal Vasko28d78432020-05-26 13:10:53 +02002177 * @return LY_SUCCESS if the statement evaluates to true,
2178 * @return LY_ENOT if it evaluates to false,
2179 * @return LY_ERR on error.
Radek Krejci151a5b72018-10-19 14:21:44 +02002180 */
Jan Kundrátc53a7ec2021-12-09 16:01:19 +01002181LIBYANG_API_DECL LY_ERR lysc_iffeature_value(const struct lysc_iffeature *iff);
Radek Krejci151a5b72018-10-19 14:21:44 +02002182
2183/**
aPiecekf4a0a192021-08-03 15:14:17 +02002184 * @brief Get how the if-feature statement is evaluated for certain identity.
2185 *
2186 * The function can be called even if the identity does not contain
2187 * if-features, in which case ::LY_SUCCESS is returned.
2188 *
2189 * @param[in] ident Compiled identity statement to evaluate.
2190 * @return LY_SUCCESS if the statement evaluates to true,
2191 * @return LY_ENOT if it evaluates to false,
2192 * @return LY_ERR on error.
2193 */
Jan Kundrátc53a7ec2021-12-09 16:01:19 +01002194LIBYANG_API_DECL LY_ERR lys_identity_iffeature_value(const struct lysc_ident *ident);
aPiecekf4a0a192021-08-03 15:14:17 +02002195
2196/**
Michal Vasko7b1ad1a2020-11-02 15:41:27 +01002197 * @brief Get the next feature in the module or submodules.
Radek Krejci151a5b72018-10-19 14:21:44 +02002198 *
Michal Vasko7b1ad1a2020-11-02 15:41:27 +01002199 * @param[in] last Last returned feature.
Michal Vasko4ec4bc02021-10-12 10:17:28 +02002200 * @param[in] pmod Parsed module and submodules whose features to iterate over.
Michal Vasko7b1ad1a2020-11-02 15:41:27 +01002201 * @param[in,out] idx Submodule index, set to 0 on first call.
2202 * @return Next found feature, NULL if the last has already been returned.
Radek Krejci151a5b72018-10-19 14:21:44 +02002203 */
Michal Vaskoc1a0ff62022-02-28 14:27:16 +01002204LIBYANG_API_DECL struct lysp_feature *lysp_feature_next(const struct lysp_feature *last, const struct lysp_module *pmod,
2205 uint32_t *idx);
Radek Krejci151a5b72018-10-19 14:21:44 +02002206
Radek Krejcibed13942020-10-19 16:06:28 +02002207/**
Radek Krejcidab4f0b2021-03-29 14:07:18 +02002208 * @brief Get pointer to the storage of the specified substatement in the given extension instance.
2209 *
2210 * The function simplifies access into the ::lysc_ext_instance.substmts sized array.
2211 *
2212 * @param[in] ext Compiled extension instance to process.
2213 * @param[in] substmt Extension substatement to search for.
2214 * @param[out] instance_p Pointer where the storage of the @p substmt will be provided. The specific type returned depends
2215 * on the @p substmt and can be found in the documentation of each ::ly_stmt value. Also note that some of the substatements
2216 * (::lysc_node based or flags) can share the storage with other substatements. In case the pointer is NULL, still the return
2217 * code can be used to at least know if the substatement is allowed for the extension.
2218 * @param[out] cardinality_p Pointer to provide allowed cardinality of the substatements in the extension. Note that in some
2219 * cases, the type of the storage depends also on the cardinality of the substatement.
2220 * @return LY_SUCCESS if the @p substmt found.
2221 * @return LY_ENOT in case the @p ext is not able to store (does not allow) the specified @p substmt.
2222 */
Jan Kundrátc53a7ec2021-12-09 16:01:19 +01002223LIBYANG_API_DECL LY_ERR lysc_ext_substmt(const struct lysc_ext_instance *ext, enum ly_stmt substmt,
Radek Krejcidab4f0b2021-03-29 14:07:18 +02002224 void **instance_p, enum ly_stmt_cardinality *cardinality_p);
2225
2226/**
Radek Krejcibed13942020-10-19 16:06:28 +02002227 * @defgroup findxpathoptions Atomize XPath options
2228 * Options to modify behavior of ::lys_find_xpath() and ::lys_find_xpath_atoms() searching for schema nodes in schema tree.
2229 * @{
2230 */
Michal Vasko4ad69e72021-10-26 16:25:55 +02002231#define LYS_FIND_XP_SCHEMA 0x08 /**< Apply node access restrictions defined for 'when' and 'must' evaluation. */
2232#define LYS_FIND_XP_OUTPUT 0x10 /**< Search RPC/action output nodes instead of input ones. */
2233#define LYS_FIND_NO_MATCH_ERROR 0x40 /**< Return error if a path segmenbt matches no nodes, otherwise only warning
2234 is printed. */
Radek Krejci576f8fa2020-10-26 21:23:58 +01002235/** @} findxpathoptions */
Michal Vasko072de482020-08-05 13:27:21 +02002236
Radek Krejci151a5b72018-10-19 14:21:44 +02002237/**
Michal Vasko40308e72020-10-20 16:38:40 +02002238 * @brief Get all the schema nodes that are required for @p xpath to be evaluated (atoms).
Michal Vasko519fd602020-05-26 12:17:39 +02002239 *
Michal Vasko26512682021-01-11 11:35:40 +01002240 * @param[in] ctx libyang context to use. May be NULL if @p ctx_node is set.
2241 * @param[in] ctx_node XPath schema context node. Use NULL for the root node.
Radek Krejci8df109d2021-04-23 12:19:08 +02002242 * @param[in] xpath Data XPath expression filtering the matching nodes. ::LY_VALUE_JSON prefix format is expected.
Radek Krejcibed13942020-10-19 16:06:28 +02002243 * @param[in] options Whether to apply some node access restrictions, see @ref findxpathoptions.
Michal Vasko519fd602020-05-26 12:17:39 +02002244 * @param[out] set Set of found atoms (schema nodes).
2245 * @return LY_SUCCESS on success, @p set is returned.
Michal Vasko40308e72020-10-20 16:38:40 +02002246 * @return LY_ERR value on error.
Michal Vasko519fd602020-05-26 12:17:39 +02002247 */
Jan Kundrátc53a7ec2021-12-09 16:01:19 +01002248LIBYANG_API_DECL LY_ERR lys_find_xpath_atoms(const struct ly_ctx *ctx, const struct lysc_node *ctx_node, const char *xpath,
Michal Vasko26512682021-01-11 11:35:40 +01002249 uint32_t options, struct ly_set **set);
Michal Vasko519fd602020-05-26 12:17:39 +02002250
Michal Vasko072de482020-08-05 13:27:21 +02002251/**
Michal Vasko40308e72020-10-20 16:38:40 +02002252 * @brief Get all the schema nodes that are required for @p expr to be evaluated (atoms).
Michal Vasko072de482020-08-05 13:27:21 +02002253 *
Michal Vasko26512682021-01-11 11:35:40 +01002254 * @param[in] ctx_node XPath schema context node. Use NULL for the root node.
Michal Vasko40308e72020-10-20 16:38:40 +02002255 * @param[in] cur_mod Current module for the expression (where it was "instantiated").
2256 * @param[in] expr Parsed expression to use.
2257 * @param[in] prefixes Sized array of compiled prefixes.
2258 * @param[in] options Whether to apply some node access restrictions, see @ref findxpathoptions.
2259 * @param[out] set Set of found atoms (schema nodes).
2260 * @return LY_SUCCESS on success, @p set is returned.
2261 * @return LY_ERR value on error.
2262 */
Jan Kundrátc53a7ec2021-12-09 16:01:19 +01002263LIBYANG_API_DECL LY_ERR lys_find_expr_atoms(const struct lysc_node *ctx_node, const struct lys_module *cur_mod,
Michal Vasko40308e72020-10-20 16:38:40 +02002264 const struct lyxp_expr *expr, const struct lysc_prefix *prefixes, uint32_t options, struct ly_set **set);
2265
2266/**
2267 * @brief Evaluate an @p xpath expression on schema nodes.
2268 *
Michal Vasko26512682021-01-11 11:35:40 +01002269 * @param[in] ctx libyang context to use for absolute @p xpath. May be NULL if @p ctx_node is set.
2270 * @param[in] ctx_node XPath schema context node for relative @p xpath. Use NULL for the root node.
Radek Krejci8df109d2021-04-23 12:19:08 +02002271 * @param[in] xpath Data XPath expression filtering the matching nodes. ::LY_VALUE_JSON prefix format is expected.
Radek Krejcibed13942020-10-19 16:06:28 +02002272 * @param[in] options Whether to apply some node access restrictions, see @ref findxpathoptions.
Michal Vasko072de482020-08-05 13:27:21 +02002273 * @param[out] set Set of found schema nodes.
2274 * @return LY_SUCCESS on success, @p set is returned.
2275 * @return LY_ERR value if an error occurred.
2276 */
Michal Vaskoc1a0ff62022-02-28 14:27:16 +01002277LIBYANG_API_DECL LY_ERR lys_find_xpath(const struct ly_ctx *ctx, const struct lysc_node *ctx_node, const char *xpath,
2278 uint32_t options, struct ly_set **set);
Michal Vasko519fd602020-05-26 12:17:39 +02002279
2280/**
Radek Krejcibc5644c2020-10-27 14:53:17 +01002281 * @brief Get all the schema nodes that are required for @p path to be evaluated (atoms).
2282 *
2283 * @param[in] path Compiled path to use.
2284 * @param[out] set Set of found atoms (schema nodes).
2285 * @return LY_SUCCESS on success, @p set is returned.
2286 * @return LY_ERR value on error.
2287 */
Jan Kundrátc53a7ec2021-12-09 16:01:19 +01002288LIBYANG_API_DECL LY_ERR lys_find_lypath_atoms(const struct ly_path *path, struct ly_set **set);
Radek Krejcibc5644c2020-10-27 14:53:17 +01002289
2290/**
2291 * @brief Get all the schema nodes that are required for @p path to be evaluated (atoms).
2292 *
Michal Vasko26512682021-01-11 11:35:40 +01002293 * @param[in] ctx libyang context to use for absolute @p path. May be NULL if @p ctx_node is set.
2294 * @param[in] ctx_node XPath schema context node for relative @p path. Use NULL for the root node.
Radek Krejcibc5644c2020-10-27 14:53:17 +01002295 * @param[in] path JSON path to examine.
2296 * @param[in] output Search operation output instead of input.
2297 * @param[out] set Set of found atoms (schema nodes).
2298 * @return LY_ERR value on error.
2299 */
Michal Vaskoc1a0ff62022-02-28 14:27:16 +01002300LIBYANG_API_DECL LY_ERR lys_find_path_atoms(const struct ly_ctx *ctx, const struct lysc_node *ctx_node, const char *path,
2301 ly_bool output, struct ly_set **set);
Radek Krejcibc5644c2020-10-27 14:53:17 +01002302
2303/**
2304 * @brief Get a schema node based on the given data path (JSON format, see @ref howtoXPath).
2305 *
Michal Vasko26512682021-01-11 11:35:40 +01002306 * @param[in] ctx libyang context to use for absolute @p path. May be NULL if @p ctx_node is set.
2307 * @param[in] ctx_node XPath schema context node for relative @p path. Use NULL for the root node.
Radek Krejcibc5644c2020-10-27 14:53:17 +01002308 * @param[in] path JSON path of the node to get.
2309 * @param[in] output Search operation output instead of input.
2310 * @return Found schema node or NULL.
2311 */
Michal Vaskoc1a0ff62022-02-28 14:27:16 +01002312LIBYANG_API_DECL const struct lysc_node *lys_find_path(const struct ly_ctx *ctx, const struct lysc_node *ctx_node,
2313 const char *path, ly_bool output);
Radek Krejcibc5644c2020-10-27 14:53:17 +01002314
2315/**
Michal Vasko03ff5a72019-09-11 13:49:33 +02002316 * @brief Types of the different schema paths.
2317 */
2318typedef enum {
Michal Vasko65de0402020-08-03 16:34:19 +02002319 LYSC_PATH_LOG, /**< Descriptive path format used in log messages */
Michal Vaskobde22b62022-03-22 15:32:56 +01002320 LYSC_PATH_DATA, /**< Similar to ::LYSC_PATH_LOG except that schema-only nodes (choice, case) are skipped */
2321 LYSC_PATH_DATA_PATTERN /**< Similar to ::LYSC_PATH_DATA but there are predicates for all list keys added with
2322 "%s" where their values should be so that they can be printed there */
Michal Vasko03ff5a72019-09-11 13:49:33 +02002323} LYSC_PATH_TYPE;
2324
2325/**
Radek Krejci327de162019-06-14 12:52:07 +02002326 * @brief Generate path of the given node in the requested format.
2327 *
2328 * @param[in] node Schema path of this node will be generated.
2329 * @param[in] pathtype Format of the path to generate.
Radek Krejci1c0c3442019-07-23 16:08:47 +02002330 * @param[in,out] buffer Prepared buffer of the @p buflen length to store the generated path.
2331 * If NULL, memory for the complete path is allocated.
2332 * @param[in] buflen Size of the provided @p buffer.
Radek Krejci327de162019-06-14 12:52:07 +02002333 * @return NULL in case of memory allocation error, path of the node otherwise.
Radek Krejci1c0c3442019-07-23 16:08:47 +02002334 * In case the @p buffer is NULL, the returned string is dynamically allocated and caller is responsible to free it.
Radek Krejci327de162019-06-14 12:52:07 +02002335 */
Jan Kundrátc53a7ec2021-12-09 16:01:19 +01002336LIBYANG_API_DECL char *lysc_path(const struct lysc_node *node, LYSC_PATH_TYPE pathtype, char *buffer, size_t buflen);
Radek Krejci327de162019-06-14 12:52:07 +02002337
2338/**
Radek Krejci5aeea3a2018-09-05 13:29:36 +02002339 * @brief Available YANG schema tree structures representing YANG module.
2340 */
2341struct lys_module {
Radek Krejci0bcdaed2019-01-10 10:21:34 +01002342 struct ly_ctx *ctx; /**< libyang context of the module (mandatory) */
2343 const char *name; /**< name of the module (mandatory) */
Radek Krejci0af46292019-01-11 16:02:31 +01002344 const char *revision; /**< revision of the module (if present) */
Radek Krejci0bcdaed2019-01-10 10:21:34 +01002345 const char *ns; /**< namespace of the module (module - mandatory) */
2346 const char *prefix; /**< module prefix or submodule belongsto prefix of main module (mandatory) */
2347 const char *filepath; /**< path, if the schema was read from a file, NULL in case of reading from memory */
2348 const char *org; /**< party/company responsible for the module */
2349 const char *contact; /**< contact information for the module */
2350 const char *dsc; /**< description of the module */
2351 const char *ref; /**< cross-reference for the module */
2352
Radek Krejci5aeea3a2018-09-05 13:29:36 +02002353 struct lysp_module *parsed; /**< Simply parsed (unresolved) YANG schema tree */
Radek Krejci0af46292019-01-11 16:02:31 +01002354 struct lysc_module *compiled; /**< Compiled and fully validated YANG schema tree for data parsing.
2355 Available only for implemented modules. */
Michal Vasko7f45cf22020-10-01 12:49:44 +02002356
Radek Krejci80d281e2020-09-14 17:42:54 +02002357 struct lysc_ident *identities; /**< List of compiled identities of the module ([sized array](@ref sizedarrays))
aPiecek6b3d5422021-07-30 15:55:43 +02002358 also contains the disabled identities when their if-feature(s) are evaluated to \"false\",
2359 and also the list is filled even if the module is not implemented.
2360 The list is located here because it avoids problems when the module became implemented in
Radek Krejci80d281e2020-09-14 17:42:54 +02002361 future (no matter if implicitly via augment/deviate or explicitly via
2362 ::lys_set_implemented()). Note that if the module is not implemented (compiled), the
2363 identities cannot be instantiated in data (in identityrefs). */
Michal Vasko7f45cf22020-10-01 12:49:44 +02002364
2365 struct lys_module **augmented_by;/**< List of modules that augment this module ([sized array](@ref sizedarrays)) */
2366 struct lys_module **deviated_by; /**< List of modules that deviate this module ([sized array](@ref sizedarrays)) */
2367
Michal Vasko89b5c072020-10-06 13:52:44 +02002368 ly_bool implemented; /**< flag if the module is implemented, not just imported */
Michal Vasko01db7de2021-04-16 12:23:30 +02002369 ly_bool to_compile; /**< flag marking a module that was changed but not (re)compiled, see
2370 ::LY_CTX_EXPLICIT_COMPILE. */
aPiecek8ca21bd2021-07-26 14:31:01 +02002371 uint8_t latest_revision; /**< Flag to mark the latest available revision, see [latest_revision options](@ref latestrevflags). */
Radek Krejci5aeea3a2018-09-05 13:29:36 +02002372};
2373
Radek Krejci151a5b72018-10-19 14:21:44 +02002374/**
aPiecek8ca21bd2021-07-26 14:31:01 +02002375 * @defgroup latestrevflags Options for ::lys_module.latest_revision.
2376 *
2377 * Various information bits of ::lys_module.latest_revision.
2378 *
2379 * @{
2380 */
aPiecek94d330b2021-08-04 11:57:31 +02002381#define LYS_MOD_LATEST_REV 0x01 /**< This is the latest revision of the module in the current context. */
2382#define LYS_MOD_LATEST_SEARCHDIRS 0x02 /**< This is the latest revision of the module found in searchdirs. */
Michal Vaskobdac23f2022-01-12 14:02:35 +01002383#define LYS_MOD_IMPORTED_REV 0x04 /**< This is the module revision used when importing the module without
2384 an explicit revision-date. It is used for all such imports regardless of
2385 any changes made in the context. */
2386#define LYS_MOD_LATEST_IMPCLB 0x08 /**< This is the latest revision of the module obtained from import callback. */
aPiecek8ca21bd2021-07-26 14:31:01 +02002387/** @} latestrevflags */
2388
2389/**
Michal Vasko82c31e62020-07-17 15:30:40 +02002390 * @brief Get the current real status of the specified feature in the module.
2391 *
2392 * If the feature is enabled, but some of its if-features are false, the feature is considered
2393 * disabled.
Radek Krejci151a5b72018-10-19 14:21:44 +02002394 *
2395 * @param[in] module Module where the feature is defined.
2396 * @param[in] feature Name of the feature to inspect.
Michal Vasko82c31e62020-07-17 15:30:40 +02002397 * @return LY_SUCCESS if the feature is enabled,
2398 * @return LY_ENOT if the feature is disabled,
2399 * @return LY_ENOTFOUND if the feature was not found.
Radek Krejci151a5b72018-10-19 14:21:44 +02002400 */
Jan Kundrátc53a7ec2021-12-09 16:01:19 +01002401LIBYANG_API_DECL LY_ERR lys_feature_value(const struct lys_module *module, const char *feature);
Radek Krejcidd4e8d42018-10-16 14:55:43 +02002402
2403/**
Michal Vasko3608d252022-02-28 14:28:12 +01002404 * @brief Get next schema (sibling) node element in the schema order that can be instantiated in a data tree.
2405 * Returned node may be from an augment.
Radek Krejcia3045382018-11-22 14:30:31 +01002406 *
Michal Vasko3608d252022-02-28 14:28:12 +01002407 * ::lys_getnext() is supposed to be called sequentially. In the first call, the @p last parameter is usually NULL
2408 * and function starts returning 1) the first @p parent child (if it is set) or 2) the first top level element of
2409 * @p module. Consequent calls should provide the previously returned node as @p last and the same @p parent and
2410 * @p module parameters.
Radek Krejcia3045382018-11-22 14:30:31 +01002411 *
2412 * Without options, the function is used to traverse only the schema nodes that can be paired with corresponding
Michal Vasko3608d252022-02-28 14:28:12 +01002413 * data nodes in a data tree. By setting some @p options the behavior can be modified to the extent that
Radek Krejcia3045382018-11-22 14:30:31 +01002414 * all the schema nodes are iteratively returned.
2415 *
2416 * @param[in] last Previously returned schema tree node, or NULL in case of the first call.
Michal Vasko3608d252022-02-28 14:28:12 +01002417 * @param[in] parent Parent of the subtree to iterate over. If set, @p module is ignored.
2418 * @param[in] module Module of the top level elements to iterate over. If @p parent is NULL, it must be specified.
Radek Krejcia3045382018-11-22 14:30:31 +01002419 * @param[in] options [ORed options](@ref sgetnextflags).
Michal Vasko3608d252022-02-28 14:28:12 +01002420 * @return Next schema tree node, NULL in case there are no more.
Radek Krejcia3045382018-11-22 14:30:31 +01002421 */
Jan Kundrátc53a7ec2021-12-09 16:01:19 +01002422LIBYANG_API_DECL const struct lysc_node *lys_getnext(const struct lysc_node *last, const struct lysc_node *parent,
Radek Krejci1deb5be2020-08-26 16:43:36 +02002423 const struct lysc_module *module, uint32_t options);
Radek Krejcia3045382018-11-22 14:30:31 +01002424
2425/**
Michal Vasko3608d252022-02-28 14:28:12 +01002426 * @brief Get next schema (sibling) node element in the schema order of an extension that can be instantiated in
2427 * a data tree.
Radek Krejci8678fa42020-08-18 16:07:28 +02002428 *
Michal Vasko3608d252022-02-28 14:28:12 +01002429 * It is just ::lys_getnext() for extensions.
Radek Krejci035dacf2021-02-12 18:25:53 +01002430 *
2431 * @param[in] last Previously returned schema tree node, or NULL in case of the first call.
Michal Vasko3608d252022-02-28 14:28:12 +01002432 * @param[in] parent Parent of the subtree to iterate over. If set, @p ext is ignored.
2433 * @param[in] ext Extension instance with schema nodes to iterate over. If @p parent is NULL, it must be specified.
Radek Krejci035dacf2021-02-12 18:25:53 +01002434 * @param[in] options [ORed options](@ref sgetnextflags).
Michal Vasko3608d252022-02-28 14:28:12 +01002435 * @return Next schema tree node, NULL in case there are no more.
Radek Krejci035dacf2021-02-12 18:25:53 +01002436 */
Jan Kundrátc53a7ec2021-12-09 16:01:19 +01002437LIBYANG_API_DECL const struct lysc_node *lys_getnext_ext(const struct lysc_node *last, const struct lysc_node *parent,
Radek Krejci035dacf2021-02-12 18:25:53 +01002438 const struct lysc_ext_instance *ext, uint32_t options);
2439
2440/**
2441 * @defgroup sgetnextflags Options for ::lys_getnext() and ::lys_getnext_ext().
2442 *
2443 * Various options setting behavior of ::lys_getnext() and ::lys_getnext_ext().
Radek Krejci8678fa42020-08-18 16:07:28 +02002444 *
Radek Krejcia3045382018-11-22 14:30:31 +01002445 * @{
2446 */
Radek Krejci8678fa42020-08-18 16:07:28 +02002447#define LYS_GETNEXT_WITHCHOICE 0x01 /**< ::lys_getnext() option to allow returning #LYS_CHOICE nodes instead of looking into them */
2448#define LYS_GETNEXT_NOCHOICE 0x02 /**< ::lys_getnext() option to ignore (kind of conditional) nodes within choice node */
2449#define LYS_GETNEXT_WITHCASE 0x04 /**< ::lys_getnext() option to allow returning #LYS_CASE nodes instead of looking into them */
Michal Vasko7b1ad1a2020-11-02 15:41:27 +01002450#define LYS_GETNEXT_INTONPCONT 0x08 /**< ::lys_getnext() option to look into non-presence container, instead of returning container itself */
2451#define LYS_GETNEXT_OUTPUT 0x10 /**< ::lys_getnext() option to provide RPC's/action's output schema nodes instead of input schema nodes
Radek Krejci6eeb58f2019-02-22 16:29:37 +01002452 provided by default */
Radek Krejcia3045382018-11-22 14:30:31 +01002453/** @} sgetnextflags */
2454
2455/**
2456 * @brief Get child node according to the specified criteria.
2457 *
2458 * @param[in] parent Optional parent of the node to find. If not specified, the module's top-level nodes are searched.
2459 * @param[in] module module of the node to find. It is also limitation for the children node of the given parent.
2460 * @param[in] name Name of the node to find.
2461 * @param[in] name_len Optional length of the name in case it is not NULL-terminated string.
2462 * @param[in] nodetype Optional criteria (to speedup) specifying nodetype(s) of the node to find.
2463 * Used as a bitmask, so multiple nodetypes can be specified.
2464 * @param[in] options [ORed options](@ref sgetnextflags).
2465 * @return Found node if any.
2466 */
Jan Kundrátc53a7ec2021-12-09 16:01:19 +01002467LIBYANG_API_DECL const struct lysc_node *lys_find_child(const struct lysc_node *parent, const struct lys_module *module,
Radek Krejci1deb5be2020-08-26 16:43:36 +02002468 const char *name, size_t name_len, uint16_t nodetype, uint32_t options);
Radek Krejcia3045382018-11-22 14:30:31 +01002469
2470/**
Radek Krejci77a8bcd2019-09-11 11:20:02 +02002471 * @brief Make the specific module implemented.
2472 *
Michal Vaskoe8988e92021-01-25 11:26:29 +01002473 * If the module is already implemented but with a different set of features, the whole context is recompiled.
2474 *
Radek Krejci77a8bcd2019-09-11 11:20:02 +02002475 * @param[in] mod Module to make implemented. It is not an error
2476 * to provide already implemented module, it just does nothing.
Michal Vaskoe8988e92021-01-25 11:26:29 +01002477 * @param[in] features Optional array specifying the enabled features terminated with NULL overriding any previous
2478 * feature setting. The feature string '*' enables all the features and array of length 1 with only the terminating
2479 * NULL explicitly disables all the features. In case the parameter is NULL, the features are untouched - left disabled
2480 * in a newly implemented module or with the current features settings in case the module is already implemented.
Michal Vaskoe444f752020-02-10 12:20:06 +01002481 * @return LY_SUCCESS on success.
2482 * @return LY_EDENIED in case the context contains some other revision of the same module which is already implemented.
Michal Vasko7b1ad1a2020-11-02 15:41:27 +01002483 * @return LY_ERR on other errors during module compilation.
Radek Krejci77a8bcd2019-09-11 11:20:02 +02002484 */
Jan Kundrátc53a7ec2021-12-09 16:01:19 +01002485LIBYANG_API_DECL LY_ERR lys_set_implemented(struct lys_module *mod, const char **features);
Radek Krejcia3045382018-11-22 14:30:31 +01002486
Radek Krejci084289f2019-07-09 17:35:30 +02002487/**
Radek Krejci0935f412019-08-20 16:15:18 +02002488 * @brief Stringify schema nodetype.
Michal Vaskod43d71a2020-08-07 14:54:58 +02002489 *
Radek Krejci0935f412019-08-20 16:15:18 +02002490 * @param[in] nodetype Nodetype to stringify.
2491 * @return Constant string with the name of the node's type.
2492 */
Jan Kundrátc53a7ec2021-12-09 16:01:19 +01002493LIBYANG_API_DECL const char *lys_nodetype2str(uint16_t nodetype);
Radek Krejci0935f412019-08-20 16:15:18 +02002494
Michal Vaskod43d71a2020-08-07 14:54:58 +02002495/**
2496 * @brief Getter for original XPath expression from a parsed expression.
2497 *
2498 * @param[in] path Parsed expression.
2499 * @return Original string expression.
2500 */
Jan Kundrátc53a7ec2021-12-09 16:01:19 +01002501LIBYANG_API_DECL const char *lyxp_get_expr(const struct lyxp_expr *path);
Michal Vaskod43d71a2020-08-07 14:54:58 +02002502
Radek Krejci2ff0d572020-05-21 15:27:28 +02002503/** @} schematree */
Radek Krejci5aeea3a2018-09-05 13:29:36 +02002504
Radek Krejci70853c52018-10-15 14:46:16 +02002505#ifdef __cplusplus
2506}
2507#endif
2508
Radek Krejci5aeea3a2018-09-05 13:29:36 +02002509#endif /* LY_TREE_SCHEMA_H_ */