blob: c24e7da9cefab005484faf9b86bb024b8b2c95f0 [file] [log] [blame]
Radek Krejci5aeea3a2018-09-05 13:29:36 +02001/**
2 * @file tree_schema.h
3 * @author Radek Krejci <rkrejci@cesnet.cz>
Michal Vaskoedb0fa52022-10-04 10:36:00 +02004 * @author Michal Vasko <mvasko@cesnet.cz>
Radek Krejci5aeea3a2018-09-05 13:29:36 +02005 * @brief libyang representation of YANG schema trees.
6 *
Michal Vaskoedb0fa52022-10-04 10:36:00 +02007 * Copyright (c) 2015 - 2022 CESNET, z.s.p.o.
Radek Krejci5aeea3a2018-09-05 13:29:36 +02008 *
9 * This source code is licensed under BSD 3-Clause License (the "License").
10 * You may not use this file except in compliance with the License.
11 * You may obtain a copy of the License at
12 *
13 * https://opensource.org/licenses/BSD-3-Clause
14 */
15
16#ifndef LY_TREE_SCHEMA_H_
17#define LY_TREE_SCHEMA_H_
18
Radek Krejci54579462019-04-30 12:47:06 +020019#define PCRE2_CODE_UNIT_WIDTH 8
20
21#include <pcre2.h>
Radek Krejci535ea9f2020-05-29 16:01:05 +020022
Radek Krejci5aeea3a2018-09-05 13:29:36 +020023#include <stdint.h>
Radek Krejcid3ca0632019-04-16 16:54:54 +020024#include <stdio.h>
Radek Krejci5aeea3a2018-09-05 13:29:36 +020025
Radek Krejcie7b95092019-05-15 11:03:07 +020026#include "log.h"
Michal Vasko8f702ee2024-02-20 15:44:24 +010027#include "ly_config.h"
Radek Krejcie7b95092019-05-15 11:03:07 +020028#include "tree.h"
Radek Krejcice8c1592018-10-29 15:35:51 +010029
Radek Krejci70853c52018-10-15 14:46:16 +020030#ifdef __cplusplus
31extern "C" {
32#endif
33
Radek Krejcica376bd2020-06-11 16:04:06 +020034struct ly_ctx;
Radek Krejci47fab892020-11-05 17:02:41 +010035struct ly_path;
Radek Krejcica376bd2020-06-11 16:04:06 +020036struct ly_set;
Radek Krejci47fab892020-11-05 17:02:41 +010037struct lys_module;
38struct lysc_node;
39struct lyxp_expr;
Radek Krejcica376bd2020-06-11 16:04:06 +020040
Radek Krejci5aeea3a2018-09-05 13:29:36 +020041/**
Radek Krejci8678fa42020-08-18 16:07:28 +020042 * @page howtoSchema YANG Modules
43 *
44 * To be able to work with YANG data instances, libyang has to represent YANG data models. All the processed modules are stored
45 * in libyang [context](@ref howtoContext) and loaded using [parser functions](@ref howtoSchemaParsers). It means, that there is
46 * no way to create/change YANG module programmatically. However, all the YANG model definitions are available and can be examined
47 * through the C structures. All the context's modules together form YANG Schema for the data being instantiated.
48 *
49 * Any YANG module is represented as ::lys_module. In fact, the module is represented in two different formats. As ::lys_module.parsed,
50 * there is a parsed schema reflecting the source YANG module. It is exactly what is read from the input. This format is good for
51 * converting from one format to another (YANG to YIN and vice versa), but it is not very useful for validating/manipulating YANG
52 * data. Therefore, there is ::lys_module.compiled storing the compiled YANG module. It is based on the parsed module, but all the
53 * 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
54 * `uses` or `type` references. This split also means, that the YANG module is fully validated after compilation of the parsed
55 * representation of the module. YANG submodules are available only in the parsed representation. When a submodule is compiled, it
56 * is fully integrated into its main module.
57 *
58 * The context can contain even modules without the compiled representation. Such modules are still useful as imports of other
59 * modules. The grouping or typedef definition can be even compiled into the importing modules. This is actually the main
60 * difference between the imported and implemented modules in the libyang context. The implemented modules are compiled while the
61 * imported modules are only parsed.
62 *
Radek Krejcib100b192020-10-26 08:37:45 +010063 * By default, the module is implemented (and compiled) in case it is explicitly loaded or referenced in another module as
64 * target of leafref, augment or deviation. This behavior can be changed via context options ::LY_CTX_ALL_IMPLEMENTED, when
65 * all the modules in the context are marked as implemented (note the problem with multiple revisions of a single module),
66 * or by ::LY_CTX_REF_IMPLEMENTED option, extending the set of references making the module implemented by when, must and
67 * default statements.
Radek Krejci8678fa42020-08-18 16:07:28 +020068 *
69 * All modules with deviation definition are always marked as implemented. The imported (not implemented) module can be set implemented by ::lys_set_implemented(). But
70 * the implemented module cannot be changed back to just imported module. Note also that only one revision of a specific module
71 * can be implemented in a single context. The imported modules are used only as a
72 * source of definitions for types and groupings for uses statements. The data in such modules are ignored - caller
73 * is not allowed to create the data (including instantiating identities) defined in the model via data parsers,
74 * the default nodes are not added into any data tree and mandatory nodes are not checked in the data trees.
75 *
Michal Vasko14ed9cd2021-01-28 14:16:25 +010076 * 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 +020077 * function, variable, ...) used by a caller application unless ::LY_CTX_SET_PRIV_PARSED is set, in that case
78 * the ::lysc_node.priv pointers are used by libyang.
Radek Krejci8678fa42020-08-18 16:07:28 +020079 * Note that the object is not freed by libyang when the context is being destroyed. So the caller is responsible
80 * 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 +020081 * appropriate schema nodes where the object was previously set. Also ::lysc_tree_dfs_full() can be useful to manage
82 * the private data.
Radek Krejci8678fa42020-08-18 16:07:28 +020083 *
84 * Despite all the schema structures and their members are available as part of the libyang API and callers can use
85 * it to navigate through the schema tree structure or to obtain various information, we recommend to use the following
86 * macros for the specific actions.
87 * - ::LYSC_TREE_DFS_BEGIN and ::LYSC_TREE_DFS_END to traverse the schema tree (depth-first).
88 * - ::LY_LIST_FOR and ::LY_ARRAY_FOR as described on @ref howtoStructures page.
89 *
90 * Further information about modules handling can be found on the following pages:
91 * - @subpage howtoSchemaParsers
92 * - @subpage howtoSchemaFeatures
93 * - @subpage howtoPlugins
94 * - @subpage howtoSchemaPrinters
95 *
96 * \note There are many functions to access information from the schema trees. Details are available in
97 * the [Schema Tree module](@ref schematree).
98 *
99 * For information about difference between implemented and imported modules, see the
100 * [context description](@ref howtoContext).
101 *
102 * Functions List (not assigned to above subsections)
103 * --------------------------------------------------
104 * - ::lys_getnext()
105 * - ::lys_nodetype2str()
106 * - ::lys_set_implemented()
Radek Krejci8678fa42020-08-18 16:07:28 +0200107 *
Michal Vaskod5cfa6e2020-11-23 16:56:08 +0100108 * - ::lysc_has_when()
Michal Vaskoef53c812021-10-13 10:21:03 +0200109 * - ::lysc_owner_module()
Michal Vaskod5cfa6e2020-11-23 16:56:08 +0100110 *
Michal Vasko544e58a2021-01-28 14:33:41 +0100111 * - ::lysc_node_child()
Radek Krejci8678fa42020-08-18 16:07:28 +0200112 * - ::lysc_node_actions()
113 * - ::lysc_node_notifs()
114 *
Michal Vasko544e58a2021-01-28 14:33:41 +0100115 * - ::lysp_node_child()
Radek Krejci8678fa42020-08-18 16:07:28 +0200116 * - ::lysp_node_actions()
117 * - ::lysp_node_notifs()
118 * - ::lysp_node_groupings()
119 * - ::lysp_node_typedefs()
120 */
121
122/**
123 * @page howtoSchemaFeatures YANG Features
124 *
Michal Vasko7b1ad1a2020-11-02 15:41:27 +0100125 * YANG feature statement is an important part of the language which can significantly affect the meaning of the schemas.
126 * Modifying features may have similar effects as loading/removing schema from the context so it is limited to context
127 * preparation period before working with data. YANG features, respectively their use in if-feature
128 * statements, are evaluated as part of schema compilation so a feature-specific compiled schema tree is generated
129 * as a result.
Radek Krejci8678fa42020-08-18 16:07:28 +0200130 *
Michal Vasko7b1ad1a2020-11-02 15:41:27 +0100131 * To enable any features, they must currently be specified when implementing a new schema with ::lys_parse() or
132 * ::ly_ctx_load_module(). To later examine what the status of a feature is, check its ::LYS_FENABLED flag or
133 * 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 +0200134 *
Michal Vasko7b1ad1a2020-11-02 15:41:27 +0100135 * To iterate over all features of a particular YANG module, use ::lysp_feature_next().
Radek Krejci8678fa42020-08-18 16:07:28 +0200136 *
137 * Note, that the feature's state can affect some of the output formats (e.g. Tree format).
138 *
139 * Functions List
140 * --------------
Radek Krejci8678fa42020-08-18 16:07:28 +0200141 * - ::lys_feature_value()
Radek Krejci8678fa42020-08-18 16:07:28 +0200142 * - ::lysc_iffeature_value()
Michal Vasko7b1ad1a2020-11-02 15:41:27 +0100143 * - ::lysp_feature_next()
Radek Krejci8678fa42020-08-18 16:07:28 +0200144 */
145
146/**
Radek Krejci2ff0d572020-05-21 15:27:28 +0200147 * @ingroup trees
Radek Krejci8678fa42020-08-18 16:07:28 +0200148 * @defgroup schematree Schema Tree
Radek Krejci2ff0d572020-05-21 15:27:28 +0200149 * @{
150 *
151 * Data structures and functions to manipulate and access schema tree.
152 */
153
Michal Vasko64246d82020-08-19 12:35:00 +0200154/* *INDENT-OFF* */
155
Radek Krejci2ff0d572020-05-21 15:27:28 +0200156/**
Michal Vasko208a04a2020-10-21 15:17:12 +0200157 * @brief Macro to iterate via all elements in a schema (sub)tree including input and output.
158 * Note that __actions__ and __notifications__ of traversed nodes __are ignored__! To traverse
159 * on all the nodes including those, use ::lysc_tree_dfs_full() instead.
160 *
161 * 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 +0200162 *
163 * The function follows deep-first search algorithm:
164 * <pre>
165 * 1
166 * / \
167 * 2 4
168 * / / \
169 * 3 5 6
170 * </pre>
171 *
172 * Use the same parameters for #LYSC_TREE_DFS_BEGIN and #LYSC_TREE_DFS_END. While
Radek Krejci2a9fc652021-01-22 17:44:34 +0100173 * START can be any of the lysc_node* types (including lysc_node_action and lysc_node_notif),
Radek Krejci0935f412019-08-20 16:15:18 +0200174 * ELEM variable must be of the struct lysc_node* type.
175 *
176 * To skip a particular subtree, instead of the continue statement, set LYSC_TREE_DFS_continue
177 * variable to non-zero value.
178 *
179 * Use with opening curly bracket '{' after the macro.
180 *
181 * @param START Pointer to the starting element processed first.
182 * @param ELEM Iterator intended for use in the block.
183 */
184#define LYSC_TREE_DFS_BEGIN(START, ELEM) \
Radek Krejci857189e2020-09-01 13:26:36 +0200185 { ly_bool LYSC_TREE_DFS_continue = 0; struct lysc_node *LYSC_TREE_DFS_next; \
Michal Vasko14ed9cd2021-01-28 14:16:25 +0100186 for ((ELEM) = (LYSC_TREE_DFS_next) = (struct lysc_node *)(START); \
Radek Krejci0935f412019-08-20 16:15:18 +0200187 (ELEM); \
188 (ELEM) = (LYSC_TREE_DFS_next), LYSC_TREE_DFS_continue = 0)
189
190/**
191 * @brief Macro to iterate via all elements in a (sub)tree. This is the closing part
192 * to the #LYSC_TREE_DFS_BEGIN - they always have to be used together.
193 *
194 * Use the same parameters for #LYSC_TREE_DFS_BEGIN and #LYSC_TREE_DFS_END. While
Radek Krejci2a9fc652021-01-22 17:44:34 +0100195 * 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 +0200196 * ELEM variable must be pointer to the lysc_node type.
197 *
198 * Use with closing curly bracket '}' after the macro.
199 *
200 * @param START Pointer to the starting element processed first.
201 * @param ELEM Iterator intended for use in the block.
202 */
Radek Krejci0935f412019-08-20 16:15:18 +0200203#define LYSC_TREE_DFS_END(START, ELEM) \
204 /* select element for the next run - children first */ \
205 if (LYSC_TREE_DFS_continue) { \
206 (LYSC_TREE_DFS_next) = NULL; \
207 } else { \
Michal Vasko544e58a2021-01-28 14:33:41 +0100208 (LYSC_TREE_DFS_next) = (struct lysc_node *)lysc_node_child(ELEM); \
Michal Vasko208a04a2020-10-21 15:17:12 +0200209 } \
Radek Krejci0935f412019-08-20 16:15:18 +0200210 if (!(LYSC_TREE_DFS_next)) { \
Michal Vasko208a04a2020-10-21 15:17:12 +0200211 /* no children, try siblings */ \
212 _LYSC_TREE_DFS_NEXT(START, ELEM, LYSC_TREE_DFS_next); \
Radek Krejci0935f412019-08-20 16:15:18 +0200213 } \
214 while (!(LYSC_TREE_DFS_next)) { \
215 /* parent is already processed, go to its sibling */ \
Radek Krejci7d95fbb2021-01-26 17:33:13 +0100216 (ELEM) = (ELEM)->parent; \
Michal Vasko208a04a2020-10-21 15:17:12 +0200217 _LYSC_TREE_DFS_NEXT(START, ELEM, LYSC_TREE_DFS_next); \
218 } }
219
220/**
221 * @brief Helper macro for #LYSC_TREE_DFS_END, should not be used directly!
222 */
223#define _LYSC_TREE_DFS_NEXT(START, ELEM, NEXT) \
224 if ((ELEM) == (struct lysc_node *)(START)) { \
225 /* we are done, no next element to process */ \
226 break; \
227 } \
Michal Vasko544e58a2021-01-28 14:33:41 +0100228 (NEXT) = (ELEM)->next;
Radek Krejci0935f412019-08-20 16:15:18 +0200229
Michal Vasko64246d82020-08-19 12:35:00 +0200230/* *INDENT-ON* */
231
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200232#define LY_REV_SIZE 11 /**< revision data string length (including terminating NULL byte) */
233
Radek Krejcide7a9c42021-03-10 13:13:06 +0100234/**
235 * @defgroup schemanodetypes Schema Node Types
236 * Values of the ::lysp_node.nodetype and ::lysc_node.nodetype members.
237 * @{
238 */
Michal Vasko7f45cf22020-10-01 12:49:44 +0200239#define LYS_UNKNOWN 0x0000 /**< uninitalized unknown statement node */
240#define LYS_CONTAINER 0x0001 /**< container statement node */
241#define LYS_CHOICE 0x0002 /**< choice statement node */
242#define LYS_LEAF 0x0004 /**< leaf statement node */
243#define LYS_LEAFLIST 0x0008 /**< leaf-list statement node */
244#define LYS_LIST 0x0010 /**< list statement node */
245#define LYS_ANYXML 0x0020 /**< anyxml statement node */
246#define LYS_ANYDATA 0x0060 /**< anydata statement node, in tests it can be used for both #LYS_ANYXML and #LYS_ANYDATA */
247#define LYS_CASE 0x0080 /**< case statement node */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200248
Michal Vasko7f45cf22020-10-01 12:49:44 +0200249#define LYS_RPC 0x0100 /**< RPC statement node */
250#define LYS_ACTION 0x0200 /**< action statement node */
251#define LYS_NOTIF 0x0400 /**< notification statement node */
Radek Krejcie7b95092019-05-15 11:03:07 +0200252
Michal Vasko7f45cf22020-10-01 12:49:44 +0200253#define LYS_USES 0x0800 /**< uses statement node */
254#define LYS_INPUT 0x1000 /**< RPC/action input node */
255#define LYS_OUTPUT 0x2000 /**< RPC/action output node */
256#define LYS_GROUPING 0x4000
257#define LYS_AUGMENT 0x8000
Radek Krejci6d9b9b52018-11-02 12:43:39 +0100258
Radek Krejcif13b87b2020-12-01 22:02:17 +0100259#define LYS_NODETYPE_MASK 0xffff /**< Mask for nodetypes, the value is limited for 16 bits */
Radek Krejcide7a9c42021-03-10 13:13:06 +0100260/** @} schemanodetypes */
Radek Krejcif13b87b2020-12-01 22:02:17 +0100261
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200262/**
263 * @brief YANG import-stmt
264 */
265struct lysp_import {
Radek Krejci086c7132018-10-26 15:29:04 +0200266 struct lys_module *module; /**< pointer to the imported module
267 (mandatory, but resolved when the referring module is completely parsed) */
268 const char *name; /**< name of the imported module (mandatory) */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200269 const char *prefix; /**< prefix for the data from the imported schema (mandatory) */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200270 const char *dsc; /**< description */
271 const char *ref; /**< reference */
Radek Krejcie53a8dc2018-10-17 12:52:40 +0200272 struct lysp_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
Michal Vasko3e9bc2f2020-11-04 17:13:56 +0100273 uint16_t flags; /**< LYS_INTERNAL value (@ref snodeflags) */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200274 char rev[LY_REV_SIZE]; /**< revision-date of the imported module */
275};
276
277/**
278 * @brief YANG include-stmt
279 */
280struct lysp_include {
Radek Krejci0bcdaed2019-01-10 10:21:34 +0100281 struct lysp_submodule *submodule;/**< pointer to the parsed submodule structure
Radek Krejci086c7132018-10-26 15:29:04 +0200282 (mandatory, but resolved when the referring module is completely parsed) */
283 const char *name; /**< name of the included submodule (mandatory) */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200284 const char *dsc; /**< description */
285 const char *ref; /**< reference */
Radek Krejcie53a8dc2018-10-17 12:52:40 +0200286 struct lysp_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200287 char rev[LY_REV_SIZE]; /**< revision-date of the included submodule */
Radek Krejci771928a2021-01-19 13:42:36 +0100288 ly_bool injected; /**< flag to mark includes copied into main module from submodules,
289 only for backward compatibility with YANG 1.0, which does not require the
290 main module to include all submodules. */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200291};
292
293/**
294 * @brief YANG extension-stmt
295 */
296struct lysp_ext {
297 const char *name; /**< extension name */
Radek Krejci9f87b0c2021-03-05 14:45:26 +0100298 const char *argname; /**< argument name, NULL if not specified */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200299 const char *dsc; /**< description statement */
300 const char *ref; /**< reference statement */
Radek Krejcie53a8dc2018-10-17 12:52:40 +0200301 struct lysp_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
Radek Krejcif56e2a42019-09-09 14:15:25 +0200302 uint16_t flags; /**< LYS_STATUS_* and LYS_YINELEM_* values (@ref snodeflags) */
Michal Vasko5fe75f12020-03-02 13:52:37 +0100303
Radek Krejci720d2612021-03-03 19:44:22 +0100304 struct lysc_ext *compiled; /**< pointer to the compiled extension definition.
305 The extension definition is compiled only if there is compiled extension instance,
306 otherwise this pointer remains NULL. The compiled extension definition is shared
307 among all extension instances. */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200308};
309
310/**
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200311 * @brief YANG feature-stmt
312 */
313struct lysp_feature {
314 const char *name; /**< feature name (mandatory) */
Michal Vasko7b1ad1a2020-11-02 15:41:27 +0100315 struct lysp_qname *iffeatures; /**< list of if-feature expressions ([sized array](@ref sizedarrays)) */
316 struct lysc_iffeature *iffeatures_c; /**< compiled if-features */
317 struct lysp_feature **depfeatures; /**< list of pointers to other features depending on this one
318 ([sized array](@ref sizedarrays)) */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200319 const char *dsc; /**< description statement */
320 const char *ref; /**< reference statement */
Radek Krejcie53a8dc2018-10-17 12:52:40 +0200321 struct lysp_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
Michal Vasko7b1ad1a2020-11-02 15:41:27 +0100322 uint16_t flags; /**< [schema node flags](@ref snodeflags) - only LYS_STATUS_* values and
323 LYS_FENABLED are allowed */
324};
325
326/**
327 * @brief Compiled YANG if-feature-stmt
328 */
329struct lysc_iffeature {
330 uint8_t *expr; /**< 2bits array describing the if-feature expression in prefix format, see @ref ifftokens */
331 struct lysp_feature **features; /**< array of pointers to the features used in expression ([sized array](@ref sizedarrays)) */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200332};
333
334/**
Michal Vasko7f45cf22020-10-01 12:49:44 +0200335 * @brief Qualified name (optional prefix followed by an identifier).
336 */
337struct lysp_qname {
338 const char *str; /**< qualified name string */
Michal Vasko5d24f6c2020-10-13 13:49:06 +0200339 const struct lysp_module *mod; /**< module to resolve any prefixes found in the string, it must be
Michal Vasko7f45cf22020-10-01 12:49:44 +0200340 stored explicitly because of deviations/refines */
341};
342
343/**
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200344 * @brief YANG identity-stmt
345 */
346struct lysp_ident {
347 const char *name; /**< identity name (mandatory), including possible prefix */
Michal Vasko7f45cf22020-10-01 12:49:44 +0200348 struct lysp_qname *iffeatures; /**< list of if-feature expressions ([sized array](@ref sizedarrays)) */
Radek Krejci151a5b72018-10-19 14:21:44 +0200349 const char **bases; /**< list of base identifiers ([sized array](@ref sizedarrays)) */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200350 const char *dsc; /**< description statement */
351 const char *ref; /**< reference statement */
Radek Krejcie53a8dc2018-10-17 12:52:40 +0200352 struct lysp_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200353 uint16_t flags; /**< [schema node flags](@ref snodeflags) - only LYS_STATUS_ values are allowed */
354};
355
Michal Vasko71e64ca2018-09-07 16:30:29 +0200356/**
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200357 * @brief Covers restrictions: range, length, pattern, must
358 */
359struct lysp_restr {
Radek Krejcif13b87b2020-12-01 22:02:17 +0100360#define LYSP_RESTR_PATTERN_ACK 0x06
361#define LYSP_RESTR_PATTERN_NACK 0x15
Michal Vasko7f45cf22020-10-01 12:49:44 +0200362 struct lysp_qname arg; /**< The restriction expression/value (mandatory);
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200363 in case of pattern restriction, the first byte has a special meaning:
364 0x06 (ACK) for regular match and 0x15 (NACK) for invert-match */
365 const char *emsg; /**< error-message */
366 const char *eapptag; /**< error-app-tag value */
367 const char *dsc; /**< description */
368 const char *ref; /**< reference */
Radek Krejcie53a8dc2018-10-17 12:52:40 +0200369 struct lysp_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200370};
371
372/**
Michal Vasko71e64ca2018-09-07 16:30:29 +0200373 * @brief YANG revision-stmt
374 */
375struct lysp_revision {
Radek Krejcicb3e6472021-01-06 08:19:01 +0100376 char date[LY_REV_SIZE]; /**< revision date (madatory) */
Michal Vasko71e64ca2018-09-07 16:30:29 +0200377 const char *dsc; /**< description statement */
378 const char *ref; /**< reference statement */
Radek Krejcie53a8dc2018-10-17 12:52:40 +0200379 struct lysp_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
Michal Vasko71e64ca2018-09-07 16:30:29 +0200380};
381
382/**
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200383 * @brief Enumeration/Bit value definition
384 */
385struct lysp_type_enum {
386 const char *name; /**< name (mandatory) */
387 const char *dsc; /**< description statement */
388 const char *ref; /**< reference statement */
Michal Vaskob55f6c12018-09-12 11:13:15 +0200389 int64_t value; /**< enum's value or bit's position */
Michal Vasko7f45cf22020-10-01 12:49:44 +0200390 struct lysp_qname *iffeatures; /**< list of if-feature expressions ([sized array](@ref sizedarrays)) */
Radek Krejcie53a8dc2018-10-17 12:52:40 +0200391 struct lysp_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
Michal Vaskob55f6c12018-09-12 11:13:15 +0200392 uint16_t flags; /**< [schema node flags](@ref snodeflags) - only LYS_STATUS_ and LYS_SET_VALUE
393 values are allowed */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200394};
395
396/**
397 * @brief YANG type-stmt
398 *
399 * Some of the items in the structure may be mandatory, but it is necessary to resolve the type's base type first
400 */
401struct lysp_type {
402 const char *name; /**< name of the type (mandatory) */
403 struct lysp_restr *range; /**< allowed values range - numerical, decimal64 */
404 struct lysp_restr *length; /**< allowed length of the value - string, binary */
Radek Krejcie53a8dc2018-10-17 12:52:40 +0200405 struct lysp_restr *patterns; /**< list of patterns ([sized array](@ref sizedarrays)) - string */
406 struct lysp_type_enum *enums; /**< list of enum-stmts ([sized array](@ref sizedarrays)) - enum */
407 struct lysp_type_enum *bits; /**< list of bit-stmts ([sized array](@ref sizedarrays)) - bits */
Michal Vasko004d3152020-06-11 19:59:22 +0200408 struct lyxp_expr *path; /**< parsed path - leafref */
Radek Krejci151a5b72018-10-19 14:21:44 +0200409 const char **bases; /**< list of base identifiers ([sized array](@ref sizedarrays)) - identityref */
Radek Krejcie53a8dc2018-10-17 12:52:40 +0200410 struct lysp_type *types; /**< list of sub-types ([sized array](@ref sizedarrays)) - union */
411 struct lysp_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200412
Michal Vasko5d24f6c2020-10-13 13:49:06 +0200413 const struct lysp_module *pmod; /**< (sub)module where the type is defined (needed for deviations) */
Michal Vasko00e8e652022-06-08 10:09:18 +0200414 struct lysc_type *compiled; /**< pointer to the compiled custom type, not used for built-in types */
Radek Krejci2167ee12018-11-02 16:09:07 +0100415
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200416 uint8_t fraction_digits; /**< number of fraction digits - decimal64 */
417 uint8_t require_instance; /**< require-instance flag - leafref, instance */
Radek Krejci4f28eda2018-11-12 11:46:16 +0100418 uint16_t flags; /**< [schema node flags](@ref spnodeflags) */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200419};
420
421/**
422 * @brief YANG typedef-stmt
423 */
424struct lysp_tpdf {
425 const char *name; /**< name of the newly defined type (mandatory) */
426 const char *units; /**< units of the newly defined type */
Michal Vasko7f45cf22020-10-01 12:49:44 +0200427 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 +0200428 const char *dsc; /**< description statement */
429 const char *ref; /**< reference statement */
Radek Krejcie53a8dc2018-10-17 12:52:40 +0200430 struct lysp_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200431 struct lysp_type type; /**< base type from which the typedef is derived (mandatory) */
Radek Krejci4f28eda2018-11-12 11:46:16 +0100432 uint16_t flags; /**< [schema node flags](@ref spnodeflags) */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200433};
434
435/**
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200436 * @brief YANG when-stmt
437 */
438struct lysp_when {
439 const char *cond; /**< specified condition (mandatory) */
440 const char *dsc; /**< description statement */
441 const char *ref; /**< reference statement */
Radek Krejcie53a8dc2018-10-17 12:52:40 +0200442 struct lysp_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200443};
444
445/**
446 * @brief YANG refine-stmt
447 */
448struct lysp_refine {
449 const char *nodeid; /**< target descendant schema nodeid (mandatory) */
450 const char *dsc; /**< description statement */
451 const char *ref; /**< reference statement */
Michal Vasko7f45cf22020-10-01 12:49:44 +0200452 struct lysp_qname *iffeatures; /**< list of if-feature expressions ([sized array](@ref sizedarrays)) */
Radek Krejcie53a8dc2018-10-17 12:52:40 +0200453 struct lysp_restr *musts; /**< list of must restrictions ([sized array](@ref sizedarrays)) */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200454 const char *presence; /**< presence description */
Michal Vasko5d24f6c2020-10-13 13:49:06 +0200455 struct lysp_qname *dflts; /**< list of default values ([sized array](@ref sizedarrays)) */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200456 uint32_t min; /**< min-elements constraint */
457 uint32_t max; /**< max-elements constraint, 0 means unbounded */
Radek Krejcie53a8dc2018-10-17 12:52:40 +0200458 struct lysp_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200459 uint16_t flags; /**< [schema node flags](@ref snodeflags) */
460};
461
462/**
Radek Krejci8678fa42020-08-18 16:07:28 +0200463 * @ingroup schematree
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200464 * @defgroup deviatetypes Deviate types
Radek Krejci8678fa42020-08-18 16:07:28 +0200465 *
466 * Type of the deviate operation (used as ::lysp_deviate.mod)
467 *
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200468 * @{
469 */
470#define LYS_DEV_NOT_SUPPORTED 1 /**< deviate type not-supported */
471#define LYS_DEV_ADD 2 /**< deviate type add */
472#define LYS_DEV_DELETE 3 /**< deviate type delete */
473#define LYS_DEV_REPLACE 4 /**< deviate type replace */
Radek Krejci2ff0d572020-05-21 15:27:28 +0200474/** @} deviatetypes */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200475
476/**
477 * @brief Generic deviate structure to get type and cast to lysp_deviate_* structure
478 */
479struct lysp_deviate {
480 uint8_t mod; /**< [type](@ref deviatetypes) of the deviate modification */
481 struct lysp_deviate *next; /**< next deviate structure in the list */
Radek Krejcie53a8dc2018-10-17 12:52:40 +0200482 struct lysp_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200483};
484
485struct lysp_deviate_add {
486 uint8_t mod; /**< [type](@ref deviatetypes) of the deviate modification */
487 struct lysp_deviate *next; /**< next deviate structure in the list */
Radek Krejcie53a8dc2018-10-17 12:52:40 +0200488 struct lysp_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
Michal Vaskob55f6c12018-09-12 11:13:15 +0200489 const char *units; /**< units of the values */
Radek Krejcie53a8dc2018-10-17 12:52:40 +0200490 struct lysp_restr *musts; /**< list of must restrictions ([sized array](@ref sizedarrays)) */
Michal Vasko5d24f6c2020-10-13 13:49:06 +0200491 struct lysp_qname *uniques; /**< list of uniques specifications ([sized array](@ref sizedarrays)) */
492 struct lysp_qname *dflts; /**< list of default values ([sized array](@ref sizedarrays)) */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200493 uint16_t flags; /**< [schema node flags](@ref snodeflags) */
494 uint32_t min; /**< min-elements constraint */
495 uint32_t max; /**< max-elements constraint, 0 means unbounded */
496};
497
498struct lysp_deviate_del {
499 uint8_t mod; /**< [type](@ref deviatetypes) of the deviate modification */
500 struct lysp_deviate *next; /**< next deviate structure in the list */
Radek Krejcie53a8dc2018-10-17 12:52:40 +0200501 struct lysp_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
Michal Vaskob55f6c12018-09-12 11:13:15 +0200502 const char *units; /**< units of the values */
Radek Krejcie53a8dc2018-10-17 12:52:40 +0200503 struct lysp_restr *musts; /**< list of must restrictions ([sized array](@ref sizedarrays)) */
Michal Vasko5d24f6c2020-10-13 13:49:06 +0200504 struct lysp_qname *uniques; /**< list of uniques specifications ([sized array](@ref sizedarrays)) */
505 struct lysp_qname *dflts; /**< list of default values ([sized array](@ref sizedarrays)) */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200506};
507
508struct lysp_deviate_rpl {
509 uint8_t mod; /**< [type](@ref deviatetypes) of the deviate modification */
510 struct lysp_deviate *next; /**< next deviate structure in the list */
Radek Krejcie53a8dc2018-10-17 12:52:40 +0200511 struct lysp_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
Michal Vaskob55f6c12018-09-12 11:13:15 +0200512 struct lysp_type *type; /**< type of the node */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200513 const char *units; /**< units of the values */
Michal Vasko5d24f6c2020-10-13 13:49:06 +0200514 struct lysp_qname dflt; /**< default value */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200515 uint16_t flags; /**< [schema node flags](@ref snodeflags) */
516 uint32_t min; /**< min-elements constraint */
517 uint32_t max; /**< max-elements constraint, 0 means unbounded */
518};
519
520struct lysp_deviation {
Michal Vaskob55f6c12018-09-12 11:13:15 +0200521 const char *nodeid; /**< target absolute schema nodeid (mandatory) */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200522 const char *dsc; /**< description statement */
523 const char *ref; /**< reference statement */
Michal Vasko22df3f02020-08-24 13:29:22 +0200524 struct lysp_deviate *deviates; /**< list of deviate specifications (linked list) */
Radek Krejcie53a8dc2018-10-17 12:52:40 +0200525 struct lysp_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200526};
527
Radek Krejci4f28eda2018-11-12 11:46:16 +0100528/**
Radek Krejci4f28eda2018-11-12 11:46:16 +0100529 * @ingroup snodeflags
Radek Krejci8678fa42020-08-18 16:07:28 +0200530 * @defgroup spnodeflags Parsed schema nodes flags
Radek Krejci4f28eda2018-11-12 11:46:16 +0100531 *
Radek Krejci8678fa42020-08-18 16:07:28 +0200532 * Various flags for parsed schema nodes (used as ::lysp_node.flags).
Radek Krejci4f28eda2018-11-12 11:46:16 +0100533 *
534 * 1 - container 6 - anydata/anyxml 11 - output 16 - grouping 21 - enum
535 * 2 - choice 7 - case 12 - feature 17 - uses 22 - type
Radek Krejcid3ca0632019-04-16 16:54:54 +0200536 * 3 - leaf 8 - notification 13 - identity 18 - refine 23 - stmt
Michal Vaskoa0ba01e2022-10-19 13:26:57 +0200537 * 4 - leaflist 9 - rpc 14 - extension 19 - augment
Radek Krejci4f28eda2018-11-12 11:46:16 +0100538 * 5 - list 10 - input 15 - typedef 20 - deviate
539 *
Radek Krejcid3ca0632019-04-16 16:54:54 +0200540 * 1 1 1 1 1 1 1 1 1 1 2 2 2 2
541 * 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
Michal Vaskoa0ba01e2022-10-19 13:26:57 +0200542 * ---------------------+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
543 * 1 LYS_CONFIG_W |x|x|x|x|x|x| | | | | | | | | | | |x| |x| | | |
544 * LYS_SET_BASE | | | | | | | | | | | | | | | | | | | | | |x| |
545 * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
546 * 2 LYS_CONFIG_R |x|x|x|x|x|x| | | | | | | | | | | |x| |x| | | |
547 * LYS_SET_BIT | | | | | | | | | | | | | | | | | | | | | |x| |
548 * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
549 * 3 LYS_STATUS_CURR |x|x|x|x|x|x|x|x|x| | |x|x|x|x|x|x| |x|x|x| | |
550 * LYS_SET_ENUM | | | | | | | | | | | | | | | | | | | | | |x| |
551 * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
552 * 4 LYS_STATUS_DEPRC |x|x|x|x|x|x|x|x|x| | |x|x|x|x|x|x| |x|x|x| | |
553 * LYS_SET_FRDIGITS | | | | | | | | | | | | | | | | | | | | | |x| |
554 * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
555 * 5 LYS_STATUS_OBSLT |x|x|x|x|x|x|x|x|x| | |x|x|x|x|x|x| |x|x|x| | |
556 * LYS_SET_LENGTH | | | | | | | | | | | | | | | | | | | | | |x| |
557 * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
558 * 6 LYS_MAND_TRUE | |x|x| | |x| | | | | | | | | | | |x| |x| | | |
559 * LYS_SET_PATH | | | | | | | | | | | | | | | | | | | | | |x| |
560 * LYS_FENABLED | | | | | | | | | | | |x| | | | | | | | | | | |
561 * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
562 * 7 LYS_MAND_FALSE | |x|x| | |x| | | | | | | | | | | |x| |x| | | |
563 * LYS_ORDBY_USER | | | |x|x| | | | | | | | | | | | | | | | | | |
564 * LYS_SET_PATTERN | | | | | | | | | | | | | | | | | | | | | |x| |
565 * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
566 * 8 LYS_ORDBY_SYSTEM | | | |x|x| | | | | | | | | | | | | | | | | | |
567 * LYS_YINELEM_TRUE | | | | | | | | | | | | | |x| | | | | | | | | |
568 * LYS_SET_RANGE | | | | | | | | | | | | | | | | | | | | | |x| |
569 * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
570 * 9 LYS_YINELEM_FALSE| | | | | | | | | | | | | |x| | | | | | | | | |
571 * LYS_SET_TYPE | | | | | | | | | | | | | | | | | | | | | |x| |
572 * LYS_SINGLEQUOTED | | | | | | | | | | | | | | | | | | | | | | |x|
573 * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
574 * 10 LYS_SET_VALUE | | | | | | | | | | | | | | | | | | | | |x| | |
575 * LYS_SET_REQINST | | | | | | | | | | | | | | | | | | | | | |x| |
576 * LYS_SET_MIN | | | |x|x| | | | | | | | | | | | |x| |x| | | |
577 * LYS_DOUBLEQUOTED | | | | | | | | | | | | | | | | | | | | | | |x|
578 * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
579 * 11 LYS_SET_MAX | | | |x|x| | | | | | | | | | | | |x| |x| | | |
580 * LYS_USED_GRP | | | | | | | | | | | | | | | |x| | | | | | | |
581 * LYS_YIN_ATTR | | | | | | | | | | | | | | | | | | | | | | |x|
582 * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
583 * 12 LYS_YIN_ARGUMENT | | | | | | | | | | | | | | | | | | | | | | |x|
584 * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
585 * 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|
586 * ---------------------+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
Radek Krejci4f28eda2018-11-12 11:46:16 +0100587 *
588 */
589
590/**
Radek Krejci4f28eda2018-11-12 11:46:16 +0100591 * @ingroup snodeflags
Radek Krejci8678fa42020-08-18 16:07:28 +0200592 * @defgroup scnodeflags Compiled schema nodes flags
Radek Krejci4f28eda2018-11-12 11:46:16 +0100593 *
Radek Krejci8678fa42020-08-18 16:07:28 +0200594 * Various flags for compiled schema nodes (used as ::lysc_node.flags).
Radek Krejci4f28eda2018-11-12 11:46:16 +0100595 *
Radek Krejci61e042e2019-09-10 15:53:09 +0200596 * 1 - container 6 - anydata/anyxml 11 - identity
597 * 2 - choice 7 - case 12 - extension
598 * 3 - leaf 8 - notification 13 - bitenum
Michal Vasko03ff5a72019-09-11 13:49:33 +0200599 * 4 - leaflist 9 - rpc/action 14 - when
Michal Vaskoecd62de2019-11-13 12:35:11 +0100600 * 5 - list 10 - feature
Radek Krejci4f28eda2018-11-12 11:46:16 +0100601 *
Michal Vaskoecd62de2019-11-13 12:35:11 +0100602 * 1 1 1 1 1
603 * bit name 1 2 3 4 5 6 7 8 9 0 1 2 3 4
604 * ---------------------+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
Michal Vaskod09b7622021-01-26 09:14:13 +0100605 * 1 LYS_CONFIG_W |x|x|x|x|x|x|x| | | | | | | |
Michal Vaskoecd62de2019-11-13 12:35:11 +0100606 * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+
Michal Vaskod09b7622021-01-26 09:14:13 +0100607 * 2 LYS_CONFIG_R |x|x|x|x|x|x|x| | | | | | | |
Michal Vaskoecd62de2019-11-13 12:35:11 +0100608 * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+
Michal Vaskof4fa90d2021-11-11 15:05:19 +0100609 * 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 +0100610 * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+
Michal Vaskof4fa90d2021-11-11 15:05:19 +0100611 * 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 +0100612 * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+
Michal Vaskof4fa90d2021-11-11 15:05:19 +0100613 * 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 +0100614 * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+
615 * 6 LYS_MAND_TRUE |x|x|x|x|x|x| | | | | | | | |
616 * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+
617 * 7 LYS_ORDBY_USER | | | |x|x| | | | | | | | | |
618 * LYS_MAND_FALSE | |x|x| | |x| | | | | | | | |
619 * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+
620 * 8 LYS_ORDBY_SYSTEM | | | |x|x| | | | | | | | | |
621 * LYS_PRESENCE |x| | | | | | | | | | | | | |
622 * LYS_UNIQUE | | |x| | | | | | | | | | | |
623 * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+
624 * 9 LYS_KEY | | |x| | | | | | | | | | | |
Michal Vaskof4fa90d2021-11-11 15:05:19 +0100625 * LYS_DISABLED | | | | | | | | | | | | |x| |
Michal Vaskoecd62de2019-11-13 12:35:11 +0100626 * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+
627 * 10 LYS_SET_DFLT | | |x|x| | |x| | | | | | | |
Michal Vaskod1e53b92021-01-28 13:11:06 +0100628 * LYS_IS_ENUM | | | | | | | | | | | | |x| |
Michal Vaskoecd62de2019-11-13 12:35:11 +0100629 * LYS_KEYLESS | | | | |x| | | | | | | | | |
630 * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+
631 * 11 LYS_SET_UNITS | | |x|x| | | | | | | | | | |
632 * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+
633 * 12 LYS_SET_CONFIG |x|x|x|x|x|x| | | | | | | | |
Michal Vaskod1e53b92021-01-28 13:11:06 +0100634 * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+
635 * 13 LYS_IS_INPUT |x|x|x|x|x|x|x| | | | | | | |
636 * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+
637 * 14 LYS_IS_OUTPUT |x|x|x|x|x|x|x| | | | | | | |
638 * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+
639 * 15 LYS_IS_NOTIF |x|x|x|x|x|x|x| | | | | | | |
Michal Vaskoecd62de2019-11-13 12:35:11 +0100640 * ---------------------+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
Radek Krejci4f28eda2018-11-12 11:46:16 +0100641 *
642 */
643
644/**
645 * @defgroup snodeflags Schema nodes flags
Radek Krejci8678fa42020-08-18 16:07:28 +0200646 *
647 * Various flags for schema nodes ([parsed](@ref spnodeflags) as well as [compiled](@ref scnodeflags)).
648 *
Radek Krejci4f28eda2018-11-12 11:46:16 +0100649 * @{
650 */
Michal Vaskod1e53b92021-01-28 13:11:06 +0100651#define LYS_CONFIG_W 0x01 /**< config true; */
652#define LYS_CONFIG_R 0x02 /**< config false; */
Michal Vaskob55f6c12018-09-12 11:13:15 +0200653#define LYS_CONFIG_MASK 0x03 /**< mask for config value */
Radek Krejci4f28eda2018-11-12 11:46:16 +0100654#define LYS_STATUS_CURR 0x04 /**< status current; */
655#define LYS_STATUS_DEPRC 0x08 /**< status deprecated; */
656#define LYS_STATUS_OBSLT 0x10 /**< status obsolete; */
657#define LYS_STATUS_MASK 0x1C /**< mask for status value */
658#define LYS_MAND_TRUE 0x20 /**< mandatory true; applicable only to ::lysp_node_choice/::lysc_node_choice,
Radek Krejcife909632019-02-12 15:34:42 +0100659 ::lysp_node_leaf/::lysc_node_leaf and ::lysp_node_anydata/::lysc_node_anydata.
660 The ::lysc_node_leaflist and ::lysc_node_leaflist have this flag in case that min-elements > 0.
661 The ::lysc_node_container has this flag if it is not a presence container and it has at least one
662 child with LYS_MAND_TRUE. */
Radek Krejcif1421c22019-02-19 13:05:20 +0100663#define LYS_MAND_FALSE 0x40 /**< mandatory false; applicable only to ::lysp_node_choice/::lysc_node_choice,
664 ::lysp_node_leaf/::lysc_node_leaf and ::lysp_node_anydata/::lysc_node_anydata.
665 This flag is present only in case the mandatory false statement was explicitly specified. */
Radek Krejci4f28eda2018-11-12 11:46:16 +0100666#define LYS_MAND_MASK 0x60 /**< mask for mandatory values */
Michal Vaskoc118ae22020-08-06 14:51:09 +0200667#define LYS_PRESENCE 0x80 /**< flag for presence property of a container, but it is not only for explicit presence
668 containers, but also for NP containers with some meaning, applicable only to
669 ::lysc_node_container */
Radek Krejci7adf4ff2018-12-05 08:55:00 +0100670#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 +0100671#define LYS_KEY 0x0100 /**< flag for leafs being a key of a list, applicable only to ::lysc_node_leaf */
672#define LYS_KEYLESS 0x0200 /**< flag for list without any key, applicable only to ::lysc_node_list */
Michal Vaskof4fa90d2021-11-11 15:05:19 +0100673#define LYS_DISABLED 0x0100 /**< internal flag for a disabled statement, used only for bits/enums */
Michal Vasko7b1ad1a2020-11-02 15:41:27 +0100674#define LYS_FENABLED 0x20 /**< feature enabled flag, applicable only to ::lysp_feature. */
Michal Vaskoe78faec2021-04-08 17:24:43 +0200675#define LYS_ORDBY_SYSTEM 0x80 /**< ordered-by system configuration lists, applicable only to
676 ::lysc_node_leaflist/::lysp_node_leaflist and ::lysc_node_list/::lysp_node_list */
677#define LYS_ORDBY_USER 0x40 /**< ordered-by user configuration lists, applicable only to
678 ::lysc_node_leaflist/::lysp_node_leaflist and ::lysc_node_list/::lysp_node_list;
679 is always set for state leaf-lists, and key-less lists */
Radek Krejci4f28eda2018-11-12 11:46:16 +0100680#define LYS_ORDBY_MASK 0x60 /**< mask for ordered-by values */
681#define LYS_YINELEM_TRUE 0x80 /**< yin-element true for extension's argument */
Michal Vaskod1e53b92021-01-28 13:11:06 +0100682#define LYS_YINELEM_FALSE 0x0100 /**< yin-element false for extension's argument */
683#define LYS_YINELEM_MASK 0x0180 /**< mask for yin-element value */
684#define LYS_USED_GRP 0x0400 /**< internal flag for validating not-instantiated groupings
Radek Krejcif2de0ed2019-05-02 14:13:18 +0200685 (resp. do not validate again the instantiated groupings). */
Michal Vaskod1e53b92021-01-28 13:11:06 +0100686#define LYS_SET_VALUE 0x0200 /**< value attribute is set */
687#define LYS_SET_MIN 0x0200 /**< min attribute is set */
688#define LYS_SET_MAX 0x0400 /**< max attribute is set */
Radek Krejcid505e3d2018-11-13 09:04:17 +0100689
690#define LYS_SET_BASE 0x0001 /**< type's flag for present base substatement */
691#define LYS_SET_BIT 0x0002 /**< type's flag for present bit substatement */
692#define LYS_SET_ENUM 0x0004 /**< type's flag for present enum substatement */
693#define LYS_SET_FRDIGITS 0x0008 /**< type's flag for present fraction-digits substatement */
694#define LYS_SET_LENGTH 0x0010 /**< type's flag for present length substatement */
695#define LYS_SET_PATH 0x0020 /**< type's flag for present path substatement */
696#define LYS_SET_PATTERN 0x0040 /**< type's flag for present pattern substatement */
697#define LYS_SET_RANGE 0x0080 /**< type's flag for present range substatement */
698#define LYS_SET_TYPE 0x0100 /**< type's flag for present type substatement */
699#define LYS_SET_REQINST 0x0200 /**< type's flag for present require-instance substatement */
Radek Krejciccd20f12019-02-15 14:12:27 +0100700#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 +0100701 cases of choice. This information is important for refines, since it is prohibited to make leafs
702 with default statement mandatory. In case the default leaf value is taken from type, it is thrown
Radek Krejciccd20f12019-02-15 14:12:27 +0100703 away when it is refined to be mandatory node. Similarly it is used for deviations to distinguish
704 between own default or the default values taken from the type. */
705#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 +0100706#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 +0100707
Michal Vaskod1e53b92021-01-28 13:11:06 +0100708#define LYS_SINGLEQUOTED 0x0100 /**< flag for single-quoted argument of an extension instance's substatement, only when the source is YANG */
709#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 +0200710
Michal Vaskod1e53b92021-01-28 13:11:06 +0100711#define LYS_YIN_ATTR 0x0400 /**< flag to identify YIN attribute parsed as extension's substatement, only when the source is YIN */
712#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 +0200713
Michal Vasko3e9bc2f2020-11-04 17:13:56 +0100714#define LYS_INTERNAL 0x1000 /**< flag to identify internal parsed statements that should not be printed */
715
Michal Vaskod1e53b92021-01-28 13:11:06 +0100716#define LYS_IS_ENUM 0x0200 /**< flag to simply distinguish type in struct lysc_type_bitenum_item */
717
718#define LYS_IS_INPUT 0x1000 /**< flag for nodes that are in the subtree of an input statement */
719
720#define LYS_IS_OUTPUT 0x2000 /**< flag for nodes that are in the subtree of an output statement */
721
722#define LYS_IS_NOTIF 0x4000 /**< flag for nodes that are in the subtree of a notification statement */
Radek Krejci693262f2019-04-29 15:23:20 +0200723
Radek Krejcife909632019-02-12 15:34:42 +0100724#define LYS_FLAGS_COMPILED_MASK 0xff /**< mask for flags that maps to the compiled structures */
Radek Krejci2ff0d572020-05-21 15:27:28 +0200725/** @} snodeflags */
Michal Vaskob55f6c12018-09-12 11:13:15 +0200726
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200727/**
728 * @brief Generic YANG data node
729 */
730struct lysp_node {
Radek Krejci6d9b9b52018-11-02 12:43:39 +0100731 struct lysp_node *parent; /**< parent node (NULL if this is a top-level node) */
Radek Krejcide7a9c42021-03-10 13:13:06 +0100732 uint16_t nodetype; /**< [type of the node](@ref schemanodetypes) (mandatory) */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200733 uint16_t flags; /**< [schema node flags](@ref snodeflags) */
Radek Krejci6d9b9b52018-11-02 12:43:39 +0100734 struct lysp_node *next; /**< next sibling node (NULL if there is no one) */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200735 const char *name; /**< node name (mandatory) */
736 const char *dsc; /**< description statement */
737 const char *ref; /**< reference statement */
Michal Vasko7f45cf22020-10-01 12:49:44 +0200738 struct lysp_qname *iffeatures; /**< list of if-feature expressions ([sized array](@ref sizedarrays)),
739 must be qname because of refines */
Radek Krejcie53a8dc2018-10-17 12:52:40 +0200740 struct lysp_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200741};
742
743/**
744 * @brief Extension structure of the lysp_node for YANG container
745 */
746struct lysp_node_container {
Radek Krejci2a9fc652021-01-22 17:44:34 +0100747 union {
748 struct lysp_node node; /**< implicit cast for the members compatible with ::lysp_node */
Michal Vasko26bbb272022-08-02 14:54:33 +0200749
Radek Krejci2a9fc652021-01-22 17:44:34 +0100750 struct {
751 struct lysp_node *parent; /**< parent node (NULL if this is a top-level node) */
752 uint16_t nodetype; /**< LYS_CONTAINER */
753 uint16_t flags; /**< [schema node flags](@ref snodeflags) */
754 struct lysp_node *next; /**< pointer to the next sibling node (NULL if there is no one) */
755 const char *name; /**< node name (mandatory) */
756 const char *dsc; /**< description statement */
757 const char *ref; /**< reference statement */
Radek Krejci2a9fc652021-01-22 17:44:34 +0100758 struct lysp_qname *iffeatures; /**< list of if-feature expressions ([sized array](@ref sizedarrays)) */
759 struct lysp_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
760 };
761 }; /**< common part corresponding to ::lysp_node */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200762
763 /* container */
Radek Krejcie53a8dc2018-10-17 12:52:40 +0200764 struct lysp_restr *musts; /**< list of must restrictions ([sized array](@ref sizedarrays)) */
Radek Krejci9a3823e2021-01-27 20:26:46 +0100765 struct lysp_when *when; /**< when statement */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200766 const char *presence; /**< presence description */
Radek Krejcie53a8dc2018-10-17 12:52:40 +0200767 struct lysp_tpdf *typedefs; /**< list of typedefs ([sized array](@ref sizedarrays)) */
Radek Krejci2a9fc652021-01-22 17:44:34 +0100768 struct lysp_node_grp *groupings; /**< list of groupings (linked list) */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200769 struct lysp_node *child; /**< list of data nodes (linked list) */
Radek Krejci2a9fc652021-01-22 17:44:34 +0100770 struct lysp_node_action *actions;/**< list of actions (linked list) */
771 struct lysp_node_notif *notifs; /**< list of notifications (linked list) */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200772};
773
774struct lysp_node_leaf {
Radek Krejci2a9fc652021-01-22 17:44:34 +0100775 union {
776 struct lysp_node node; /**< implicit cast for the members compatible with ::lysp_node */
Michal Vasko26bbb272022-08-02 14:54:33 +0200777
Radek Krejci2a9fc652021-01-22 17:44:34 +0100778 struct {
779 struct lysp_node *parent; /**< parent node (NULL if this is a top-level node) */
780 uint16_t nodetype; /**< LYS_LEAF */
781 uint16_t flags; /**< [schema node flags](@ref snodeflags) */
782 struct lysp_node *next; /**< pointer to the next sibling node (NULL if there is no one) */
783 const char *name; /**< node name (mandatory) */
784 const char *dsc; /**< description statement */
785 const char *ref; /**< reference statement */
Radek Krejci2a9fc652021-01-22 17:44:34 +0100786 struct lysp_qname *iffeatures; /**< list of if-feature expressions ([sized array](@ref sizedarrays)) */
787 struct lysp_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
788 };
789 }; /**< common part corresponding to ::lysp_node */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200790
791 /* leaf */
Radek Krejcie53a8dc2018-10-17 12:52:40 +0200792 struct lysp_restr *musts; /**< list of must restrictions ([sized array](@ref sizedarrays)) */
Radek Krejci9a3823e2021-01-27 20:26:46 +0100793 struct lysp_when *when; /**< when statement */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200794 struct lysp_type type; /**< type of the leaf node (mandatory) */
795 const char *units; /**< units of the leaf's type */
Michal Vasko7f45cf22020-10-01 12:49:44 +0200796 struct lysp_qname dflt; /**< default value, it may or may not be a qualified name */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200797};
798
799struct lysp_node_leaflist {
Radek Krejci2a9fc652021-01-22 17:44:34 +0100800 union {
801 struct lysp_node node; /**< implicit cast for the members compatible with ::lysp_node */
Michal Vasko26bbb272022-08-02 14:54:33 +0200802
Radek Krejci2a9fc652021-01-22 17:44:34 +0100803 struct {
804 struct lysp_node *parent; /**< parent node (NULL if this is a top-level node) */
805 uint16_t nodetype; /**< LYS_LEAFLIST */
806 uint16_t flags; /**< [schema node flags](@ref snodeflags) */
807 struct lysp_node *next; /**< pointer to the next sibling node (NULL if there is no one) */
808 const char *name; /**< node name (mandatory) */
809 const char *dsc; /**< description statement */
810 const char *ref; /**< reference statement */
Radek Krejci2a9fc652021-01-22 17:44:34 +0100811 struct lysp_qname *iffeatures; /**< list of if-feature expressions ([sized array](@ref sizedarrays)) */
812 struct lysp_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
813 };
814 }; /**< common part corresponding to ::lysp_node */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200815
816 /* leaf-list */
Radek Krejcie53a8dc2018-10-17 12:52:40 +0200817 struct lysp_restr *musts; /**< list of must restrictions ([sized array](@ref sizedarrays)) */
Radek Krejci9a3823e2021-01-27 20:26:46 +0100818 struct lysp_when *when; /**< when statement */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200819 struct lysp_type type; /**< type of the leaf node (mandatory) */
820 const char *units; /**< units of the leaf's type */
Michal Vasko7f45cf22020-10-01 12:49:44 +0200821 struct lysp_qname *dflts; /**< list of default values ([sized array](@ref sizedarrays)), they may or
822 may not be qualified names */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200823 uint32_t min; /**< min-elements constraint */
824 uint32_t max; /**< max-elements constraint, 0 means unbounded */
825};
826
827struct lysp_node_list {
Radek Krejci2a9fc652021-01-22 17:44:34 +0100828 union {
829 struct lysp_node node; /**< implicit cast for the members compatible with ::lysp_node */
Michal Vasko26bbb272022-08-02 14:54:33 +0200830
Radek Krejci2a9fc652021-01-22 17:44:34 +0100831 struct {
832 struct lysp_node *parent; /**< parent node (NULL if this is a top-level node) */
833 uint16_t nodetype; /**< LYS_LIST */
834 uint16_t flags; /**< [schema node flags](@ref snodeflags) */
835 struct lysp_node *next; /**< pointer to the next sibling node (NULL if there is no one) */
836 const char *name; /**< node name (mandatory) */
837 const char *dsc; /**< description statement */
838 const char *ref; /**< reference statement */
Radek Krejci2a9fc652021-01-22 17:44:34 +0100839 struct lysp_qname *iffeatures; /**< list of if-feature expressions ([sized array](@ref sizedarrays)) */
840 struct lysp_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
841 };
842 }; /**< common part corresponding to ::lysp_node */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200843
844 /* list */
Radek Krejcie53a8dc2018-10-17 12:52:40 +0200845 struct lysp_restr *musts; /**< list of must restrictions ([sized array](@ref sizedarrays)) */
Radek Krejci9a3823e2021-01-27 20:26:46 +0100846 struct lysp_when *when; /**< when statement */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200847 const char *key; /**< keys specification */
Radek Krejcie53a8dc2018-10-17 12:52:40 +0200848 struct lysp_tpdf *typedefs; /**< list of typedefs ([sized array](@ref sizedarrays)) */
Radek Krejci2a9fc652021-01-22 17:44:34 +0100849 struct lysp_node_grp *groupings; /**< list of groupings (linked list) */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200850 struct lysp_node *child; /**< list of data nodes (linked list) */
Radek Krejci2a9fc652021-01-22 17:44:34 +0100851 struct lysp_node_action *actions;/**< list of actions (linked list) */
852 struct lysp_node_notif *notifs; /**< list of notifications (linked list) */
Michal Vasko7f45cf22020-10-01 12:49:44 +0200853 struct lysp_qname *uniques; /**< list of unique specifications ([sized array](@ref sizedarrays)) */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200854 uint32_t min; /**< min-elements constraint */
855 uint32_t max; /**< max-elements constraint, 0 means unbounded */
856};
857
858struct lysp_node_choice {
Radek Krejci2a9fc652021-01-22 17:44:34 +0100859 union {
860 struct lysp_node node; /**< implicit cast for the members compatible with ::lysp_node */
Michal Vasko26bbb272022-08-02 14:54:33 +0200861
Radek Krejci2a9fc652021-01-22 17:44:34 +0100862 struct {
863 struct lysp_node *parent; /**< parent node (NULL if this is a top-level node) */
864 uint16_t nodetype; /**< LYS_CHOICE */
865 uint16_t flags; /**< [schema node flags](@ref snodeflags) */
866 struct lysp_node *next; /**< pointer to the next sibling node (NULL if there is no one) */
867 const char *name; /**< node name (mandatory) */
868 const char *dsc; /**< description statement */
869 const char *ref; /**< reference statement */
Radek Krejci2a9fc652021-01-22 17:44:34 +0100870 struct lysp_qname *iffeatures; /**< list of if-feature expressions ([sized array](@ref sizedarrays)) */
871 struct lysp_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
872 };
873 }; /**< common part corresponding to ::lysp_node */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200874
875 /* choice */
876 struct lysp_node *child; /**< list of data nodes (linked list) */
Radek Krejci9a3823e2021-01-27 20:26:46 +0100877 struct lysp_when *when; /**< when statement */
Michal Vasko7f45cf22020-10-01 12:49:44 +0200878 struct lysp_qname dflt; /**< default case */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200879};
880
881struct lysp_node_case {
Radek Krejci2a9fc652021-01-22 17:44:34 +0100882 union {
883 struct lysp_node node; /**< implicit cast for the members compatible with ::lysp_node */
Michal Vasko26bbb272022-08-02 14:54:33 +0200884
Radek Krejci2a9fc652021-01-22 17:44:34 +0100885 struct {
886 struct lysp_node *parent; /**< parent node (NULL if this is a top-level node) */
887 uint16_t nodetype; /**< LYS_CASE */
888 uint16_t flags; /**< [schema node flags](@ref snodeflags) */
889 struct lysp_node *next; /**< pointer to the next sibling node (NULL if there is no one) */
890 const char *name; /**< node name (mandatory) */
891 const char *dsc; /**< description statement */
892 const char *ref; /**< reference statement */
Radek Krejci2a9fc652021-01-22 17:44:34 +0100893 struct lysp_qname *iffeatures; /**< list of if-feature expressions ([sized array](@ref sizedarrays)) */
894 struct lysp_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
895 };
896 }; /**< common part corresponding to ::lysp_node */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200897
898 /* case */
899 struct lysp_node *child; /**< list of data nodes (linked list) */
Radek Krejci9a3823e2021-01-27 20:26:46 +0100900 struct lysp_when *when; /**< when statement */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200901};
902
903struct lysp_node_anydata {
Radek Krejci2a9fc652021-01-22 17:44:34 +0100904 union {
905 struct lysp_node node; /**< implicit cast for the members compatible with ::lysp_node */
Michal Vasko26bbb272022-08-02 14:54:33 +0200906
Radek Krejci2a9fc652021-01-22 17:44:34 +0100907 struct {
908 struct lysp_node *parent; /**< parent node (NULL if this is a top-level node) */
909 uint16_t nodetype; /**< LYS_ANYXML or LYS_ANYDATA */
910 uint16_t flags; /**< [schema node flags](@ref snodeflags) */
911 struct lysp_node *next; /**< pointer to the next sibling node (NULL if there is no one) */
912 const char *name; /**< node name (mandatory) */
913 const char *dsc; /**< description statement */
914 const char *ref; /**< reference statement */
Radek Krejci2a9fc652021-01-22 17:44:34 +0100915 struct lysp_qname *iffeatures; /**< list of if-feature expressions ([sized array](@ref sizedarrays)) */
916 struct lysp_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
917 };
918 }; /**< common part corresponding to ::lysp_node */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200919
920 /* anyxml/anydata */
Radek Krejcie53a8dc2018-10-17 12:52:40 +0200921 struct lysp_restr *musts; /**< list of must restrictions ([sized array](@ref sizedarrays)) */
Radek Krejci9a3823e2021-01-27 20:26:46 +0100922 struct lysp_when *when; /**< when statement */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200923};
924
925struct lysp_node_uses {
Radek Krejci2a9fc652021-01-22 17:44:34 +0100926 union {
927 struct lysp_node node; /**< implicit cast for the members compatible with ::lysp_node */
Michal Vasko26bbb272022-08-02 14:54:33 +0200928
Radek Krejci2a9fc652021-01-22 17:44:34 +0100929 struct {
930 struct lysp_node *parent; /**< parent node (NULL if this is a top-level node) */
931 uint16_t nodetype; /**< LYS_USES */
932 uint16_t flags; /**< [schema node flags](@ref snodeflags) */
933 struct lysp_node *next; /**< pointer to the next sibling node (NULL if there is no one) */
934 const char *name; /**< grouping name reference (mandatory) */
935 const char *dsc; /**< description statement */
936 const char *ref; /**< reference statement */
Radek Krejci2a9fc652021-01-22 17:44:34 +0100937 struct lysp_qname *iffeatures; /**< list of if-feature expressions ([sized array](@ref sizedarrays)) */
938 struct lysp_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
939 };
940 }; /**< common part corresponding to ::lysp_node */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200941
942 /* uses */
Radek Krejcie53a8dc2018-10-17 12:52:40 +0200943 struct lysp_refine *refines; /**< list of uses's refines ([sized array](@ref sizedarrays)) */
Radek Krejci2a9fc652021-01-22 17:44:34 +0100944 struct lysp_node_augment *augments; /**< list of augments (linked list) */
Radek Krejci9a3823e2021-01-27 20:26:46 +0100945 struct lysp_when *when; /**< when statement */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200946};
947
948/**
949 * @brief YANG input-stmt and output-stmt
950 */
Radek Krejci2a9fc652021-01-22 17:44:34 +0100951struct lysp_node_action_inout {
952 union {
953 struct lysp_node node; /**< implicit cast for the members compatible with ::lysp_node */
Michal Vasko26bbb272022-08-02 14:54:33 +0200954
Radek Krejci2a9fc652021-01-22 17:44:34 +0100955 struct {
956 struct lysp_node *parent; /**< parent node (NULL if this is a top-level node) */
957 uint16_t nodetype; /**< LYS_INPUT or LYS_OUTPUT */
958 uint16_t flags; /**< [schema node flags](@ref snodeflags) */
959 struct lysp_node *next; /**< NULL */
960 const char *name; /**< empty string */
961 const char *dsc; /**< ALWAYS NULL, compatibility member with ::lysp_node */
962 const char *ref; /**< ALWAYS NULL, compatibility member with ::lysp_node */
Radek Krejci2a9fc652021-01-22 17:44:34 +0100963 struct lysp_qname *iffeatures; /**< ALWAYS NULL, compatibility member with ::lysp_node */
964 struct lysp_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
965 };
966 }; /**< common part corresponding to ::lysp_node */
967
968 /* inout */
Radek Krejcie53a8dc2018-10-17 12:52:40 +0200969 struct lysp_restr *musts; /**< list of must restrictions ([sized array](@ref sizedarrays)) */
970 struct lysp_tpdf *typedefs; /**< list of typedefs ([sized array](@ref sizedarrays)) */
Radek Krejci2a9fc652021-01-22 17:44:34 +0100971 struct lysp_node_grp *groupings; /**< list of groupings (linked list) */
Radek Krejci01180ac2021-01-27 08:48:22 +0100972 struct lysp_node *child; /**< list of data nodes (linked list) */
Radek Krejci5aeea3a2018-09-05 13:29:36 +0200973};
974
975/**
976 * @brief YANG rpc-stmt and action-stmt
977 */
Radek Krejci2a9fc652021-01-22 17:44:34 +0100978struct lysp_node_action {
979 union {
980 struct lysp_node node; /**< implicit cast for the members compatible with ::lysp_node */
Michal Vasko26bbb272022-08-02 14:54:33 +0200981
Radek Krejci2a9fc652021-01-22 17:44:34 +0100982 struct {
983 struct lysp_node *parent; /**< parent node (NULL if this is a top-level node) */
984 uint16_t nodetype; /**< LYS_RPC or LYS_ACTION */
985 uint16_t flags; /**< [schema node flags](@ref snodeflags) */
986 struct lysp_node_action *next; /**< pointer to the next action (NULL if there is no one) */
987 const char *name; /**< grouping name reference (mandatory) */
988 const char *dsc; /**< description statement */
989 const char *ref; /**< reference statement */
Radek Krejci2a9fc652021-01-22 17:44:34 +0100990 struct lysp_qname *iffeatures; /**< list of if-feature expressions ([sized array](@ref sizedarrays)) */
991 struct lysp_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
992 };
993 }; /**< common part corresponding to ::lysp_node */
Michal Vasko7f45cf22020-10-01 12:49:44 +0200994
995 /* action */
Radek Krejci2a9fc652021-01-22 17:44:34 +0100996 struct lysp_tpdf *typedefs; /**< list of typedefs ([sized array](@ref sizedarrays)) */
997 struct lysp_node_grp *groupings; /**< list of groupings (linked list) */
998
999 struct lysp_node_action_inout input; /**< RPC's/Action's input */
1000 struct lysp_node_action_inout output; /**< RPC's/Action's output */
Radek Krejci5aeea3a2018-09-05 13:29:36 +02001001};
1002
1003/**
1004 * @brief YANG notification-stmt
1005 */
Radek Krejci2a9fc652021-01-22 17:44:34 +01001006struct lysp_node_notif {
1007 union {
1008 struct lysp_node node; /**< implicit cast for the members compatible with ::lysp_node */
Michal Vasko26bbb272022-08-02 14:54:33 +02001009
Radek Krejci2a9fc652021-01-22 17:44:34 +01001010 struct {
1011 struct lysp_node *parent; /**< parent node (NULL if this is a top-level node) */
1012 uint16_t nodetype; /**< LYS_NOTIF */
1013 uint16_t flags; /**< [schema node flags](@ref snodeflags) - only LYS_STATUS_* values are allowed */
1014 struct lysp_node_notif *next; /**< pointer to the next notification (NULL if there is no one) */
1015 const char *name; /**< grouping name reference (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 */
Michal Vasko7f45cf22020-10-01 12:49:44 +02001022
1023 /* notif */
1024 struct lysp_restr *musts; /**< list of must restrictions ([sized array](@ref sizedarrays)) */
Radek Krejci2a9fc652021-01-22 17:44:34 +01001025 struct lysp_tpdf *typedefs; /**< list of typedefs ([sized array](@ref sizedarrays)) */
1026 struct lysp_node_grp *groupings; /**< list of groupings (linked list) */
Radek Krejci01180ac2021-01-27 08:48:22 +01001027 struct lysp_node *child; /**< list of data nodes (linked list) */
Radek Krejci5aeea3a2018-09-05 13:29:36 +02001028};
1029
1030/**
Radek Krejci2a9fc652021-01-22 17:44:34 +01001031 * @brief YANG grouping-stmt
1032 */
1033struct lysp_node_grp {
1034 union {
1035 struct lysp_node node; /**< implicit cast for the members compatible with ::lysp_node */
Michal Vasko26bbb272022-08-02 14:54:33 +02001036
Radek Krejci2a9fc652021-01-22 17:44:34 +01001037 struct {
1038 struct lysp_node *parent;/**< parent node (NULL if this is a top-level grouping) */
1039 uint16_t nodetype; /**< LYS_GROUPING */
1040 uint16_t flags; /**< [schema node flags](@ref snodeflags) - only LYS_STATUS_* values are allowed */
1041 struct lysp_node_grp *next; /**< pointer to the next grouping (NULL if there is no one) */
1042 const char *name; /**< grouping name (mandatory) */
1043 const char *dsc; /**< description statement */
1044 const char *ref; /**< reference statement */
Radek Krejci2a9fc652021-01-22 17:44:34 +01001045 struct lysp_qname *iffeatures; /**< ALWAYS NULL, compatibility member with ::lysp_node */
1046 struct lysp_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
1047 };
1048 }; /**< common part corresponding to ::lysp_node */
1049
1050 /* grp */
1051 struct lysp_tpdf *typedefs; /**< list of typedefs ([sized array](@ref sizedarrays)) */
1052 struct lysp_node_grp *groupings; /**< list of groupings (linked list) */
Radek Krejci01180ac2021-01-27 08:48:22 +01001053 struct lysp_node *child; /**< list of data nodes (linked list) */
Radek Krejci2a9fc652021-01-22 17:44:34 +01001054 struct lysp_node_action *actions; /**< list of actions (linked list) */
1055 struct lysp_node_notif *notifs; /**< list of notifications (linked list) */
1056};
1057
1058/**
1059 * @brief YANG uses-augment-stmt and augment-stmt (compatible with struct lysp_node )
1060 */
1061struct lysp_node_augment {
1062 union {
1063 struct lysp_node node; /**< implicit cast for the members compatible with ::lysp_node */
Michal Vasko26bbb272022-08-02 14:54:33 +02001064
Radek Krejci2a9fc652021-01-22 17:44:34 +01001065 struct {
1066 struct lysp_node *parent;/**< parent node (NULL if this is a top-level augment) */
1067 uint16_t nodetype; /**< LYS_AUGMENT */
1068 uint16_t flags; /**< [schema node flags](@ref snodeflags) - only LYS_STATUS_* values are allowed */
1069 struct lysp_node_augment *next; /**< pointer to the next augment (NULL if there is no one) */
1070 const char *nodeid; /**< target schema nodeid (mandatory) - absolute for global augments, descendant for uses's augments */
1071 const char *dsc; /**< description statement */
1072 const char *ref; /**< reference statement */
Radek Krejci2a9fc652021-01-22 17:44:34 +01001073 struct lysp_qname *iffeatures; /**< list of if-feature expressions ([sized array](@ref sizedarrays)) */
1074 struct lysp_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
1075 };
1076 }; /**< common part corresponding to ::lysp_node */
1077
1078 struct lysp_node *child; /**< list of data nodes (linked list) */
Radek Krejci9a3823e2021-01-27 20:26:46 +01001079 struct lysp_when *when; /**< when statement */
Radek Krejci2a9fc652021-01-22 17:44:34 +01001080 struct lysp_node_action *actions;/**< list of actions (linked list) */
1081 struct lysp_node_notif *notifs; /**< list of notifications (linked list) */
1082};
1083
1084/**
Radek Krejcif0fceb62018-09-05 14:58:45 +02001085 * @brief supported YANG schema version values
1086 */
1087typedef enum LYS_VERSION {
1088 LYS_VERSION_UNDEF = 0, /**< no specific version, YANG 1.0 as default */
Radek Krejci96e48da2020-09-04 13:18:06 +02001089 LYS_VERSION_1_0 = 1, /**< YANG 1 (1.0) */
Radek Krejcif0fceb62018-09-05 14:58:45 +02001090 LYS_VERSION_1_1 = 2 /**< YANG 1.1 */
1091} LYS_VERSION;
1092
1093/**
Radek Krejci5aeea3a2018-09-05 13:29:36 +02001094 * @brief Printable YANG schema tree structure representing YANG module.
1095 *
1096 * Simple structure corresponding to the YANG format. The schema is only syntactically validated.
1097 */
1098struct lysp_module {
Radek Krejci0bcdaed2019-01-10 10:21:34 +01001099 struct lys_module *mod; /**< covering module structure */
1100
Radek Krejcib7db73a2018-10-24 14:18:40 +02001101 struct lysp_revision *revs; /**< list of the module revisions ([sized array](@ref sizedarrays)), the first revision
1102 in the list is always the last (newest) revision of the module */
Radek Krejcie53a8dc2018-10-17 12:52:40 +02001103 struct lysp_import *imports; /**< list of imported modules ([sized array](@ref sizedarrays)) */
1104 struct lysp_include *includes; /**< list of included submodules ([sized array](@ref sizedarrays)) */
Radek Krejcie53a8dc2018-10-17 12:52:40 +02001105 struct lysp_ext *extensions; /**< list of extension statements ([sized array](@ref sizedarrays)) */
1106 struct lysp_feature *features; /**< list of feature definitions ([sized array](@ref sizedarrays)) */
1107 struct lysp_ident *identities; /**< list of identities ([sized array](@ref sizedarrays)) */
1108 struct lysp_tpdf *typedefs; /**< list of typedefs ([sized array](@ref sizedarrays)) */
Radek Krejci2a9fc652021-01-22 17:44:34 +01001109 struct lysp_node_grp *groupings; /**< list of groupings (linked list) */
Radek Krejci5aeea3a2018-09-05 13:29:36 +02001110 struct lysp_node *data; /**< list of module's top-level data nodes (linked list) */
Radek Krejci2a9fc652021-01-22 17:44:34 +01001111 struct lysp_node_augment *augments; /**< list of augments (linked list) */
1112 struct lysp_node_action *rpcs; /**< list of RPCs (linked list) */
1113 struct lysp_node_notif *notifs; /**< list of notifications (linked list) */
Radek Krejcie53a8dc2018-10-17 12:52:40 +02001114 struct lysp_deviation *deviations; /**< list of deviations ([sized array](@ref sizedarrays)) */
Michal Vaskoc3781c32020-10-06 14:04:08 +02001115 struct lysp_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
Radek Krejci5aeea3a2018-09-05 13:29:36 +02001116
Michal Vasko5d24f6c2020-10-13 13:49:06 +02001117 uint8_t version; /**< yang-version (LYS_VERSION values) */
Michal Vaskoc3781c32020-10-06 14:04:08 +02001118 uint8_t parsing : 1; /**< flag for circular check */
1119 uint8_t is_submod : 1; /**< always 0 */
Radek Krejci0bcdaed2019-01-10 10:21:34 +01001120};
1121
1122struct lysp_submodule {
Michal Vaskoc3781c32020-10-06 14:04:08 +02001123 struct lys_module *mod; /**< belongs to parent module (submodule - mandatory) */
Radek Krejci0bcdaed2019-01-10 10:21:34 +01001124
1125 struct lysp_revision *revs; /**< list of the module revisions ([sized array](@ref sizedarrays)), the first revision
1126 in the list is always the last (newest) revision of the module */
1127 struct lysp_import *imports; /**< list of imported modules ([sized array](@ref sizedarrays)) */
1128 struct lysp_include *includes; /**< list of included submodules ([sized array](@ref sizedarrays)) */
1129 struct lysp_ext *extensions; /**< list of extension statements ([sized array](@ref sizedarrays)) */
1130 struct lysp_feature *features; /**< list of feature definitions ([sized array](@ref sizedarrays)) */
1131 struct lysp_ident *identities; /**< list of identities ([sized array](@ref sizedarrays)) */
1132 struct lysp_tpdf *typedefs; /**< list of typedefs ([sized array](@ref sizedarrays)) */
Radek Krejci2a9fc652021-01-22 17:44:34 +01001133 struct lysp_node_grp *groupings; /**< list of groupings (linked list) */
Radek Krejci0bcdaed2019-01-10 10:21:34 +01001134 struct lysp_node *data; /**< list of module's top-level data nodes (linked list) */
Radek Krejci2a9fc652021-01-22 17:44:34 +01001135 struct lysp_node_augment *augments; /**< list of augments (linked list) */
1136 struct lysp_node_action *rpcs; /**< list of RPCs (linked list) */
1137 struct lysp_node_notif *notifs; /**< list of notifications (linked list) */
Radek Krejci0bcdaed2019-01-10 10:21:34 +01001138 struct lysp_deviation *deviations; /**< list of deviations ([sized array](@ref sizedarrays)) */
Michal Vaskoc3781c32020-10-06 14:04:08 +02001139 struct lysp_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
Radek Krejci0bcdaed2019-01-10 10:21:34 +01001140
Michal Vasko5d24f6c2020-10-13 13:49:06 +02001141 uint8_t version; /**< yang-version (LYS_VERSION values) */
Michal Vaskoc3781c32020-10-06 14:04:08 +02001142 uint8_t parsing : 1; /**< flag for circular check */
1143 uint8_t is_submod : 1; /**< always 1 */
Radek Krejci0bcdaed2019-01-10 10:21:34 +01001144
Michal Vaskoc3781c32020-10-06 14:04:08 +02001145 uint8_t latest_revision : 2; /**< flag to mark the latest available revision:
Radek Krejci086c7132018-10-26 15:29:04 +02001146 1 - the latest revision in searchdirs was not searched yet and this is the
1147 latest revision in the current context
1148 2 - searchdirs were searched and this is the latest available revision */
Radek Krejci0bcdaed2019-01-10 10:21:34 +01001149 const char *name; /**< name of the module (mandatory) */
1150 const char *filepath; /**< path, if the schema was read from a file, NULL in case of reading from memory */
1151 const char *prefix; /**< submodule belongsto prefix of main module (mandatory) */
1152 const char *org; /**< party/company responsible for the module */
1153 const char *contact; /**< contact information for the module */
1154 const char *dsc; /**< description of the module */
1155 const char *ref; /**< cross-reference for the module */
Radek Krejci5aeea3a2018-09-05 13:29:36 +02001156};
1157
1158/**
Michal Vasko5d24f6c2020-10-13 13:49:06 +02001159 * @brief Get the parsed module or submodule name.
1160 *
1161 * @param[in] PMOD Parsed module or submodule.
1162 * @return Module or submodule name.
1163 */
1164#define LYSP_MODULE_NAME(PMOD) (PMOD->is_submod ? ((struct lysp_submodule *)PMOD)->name : ((struct lysp_module *)PMOD)->mod->name)
1165
1166/**
Radek Krejci8df109d2021-04-23 12:19:08 +02001167 * @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 +02001168 * the expected prefix data is a sized array of these structures.
1169 */
1170struct lysc_prefix {
1171 char *prefix; /**< used prefix */
1172 const struct lys_module *mod; /**< mapping to a module */
1173};
1174
1175/**
Radek Krejci0e59c312019-08-15 15:34:15 +02001176 * @brief Compiled YANG extension-stmt
Radek Krejci9f87b0c2021-03-05 14:45:26 +01001177 *
1178 * Note that the compiled extension definition is created only in case the extension is instantiated. It is not available
1179 * from the compiled schema, but from the parsed extension definition which is being searched when an extension instance
1180 * is being compiled.
Radek Krejci0e59c312019-08-15 15:34:15 +02001181 */
1182struct lysc_ext {
1183 const char *name; /**< extension name */
Radek Krejci9f87b0c2021-03-05 14:45:26 +01001184 const char *argname; /**< argument name, NULL if not specified */
Radek Krejci0e59c312019-08-15 15:34:15 +02001185 struct lysc_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
Radek Krejcicc9e30f2021-03-29 12:45:08 +02001186 struct lyplg_ext *plugin; /**< Plugin implementing the specific extension */
Radek Krejci0935f412019-08-20 16:15:18 +02001187 struct lys_module *module; /**< module structure */
Radek Krejci0e59c312019-08-15 15:34:15 +02001188 uint16_t flags; /**< LYS_STATUS_* value (@ref snodeflags) */
1189};
1190
1191/**
Radek Krejcidd4e8d42018-10-16 14:55:43 +02001192 * @brief YANG when-stmt
Radek Krejci5aeea3a2018-09-05 13:29:36 +02001193 */
Radek Krejcidd4e8d42018-10-16 14:55:43 +02001194struct lysc_when {
1195 struct lyxp_expr *cond; /**< XPath when condition */
Michal Vasko175012e2019-11-06 15:49:14 +01001196 struct lysc_node *context; /**< context node for evaluating the expression, NULL if the context is root node */
Michal Vasko5d24f6c2020-10-13 13:49:06 +02001197 struct lysc_prefix *prefixes; /**< compiled used prefixes in the condition */
Radek Krejcic8b31002019-01-08 10:24:45 +01001198 const char *dsc; /**< description */
1199 const char *ref; /**< reference */
Radek Krejcie53a8dc2018-10-17 12:52:40 +02001200 struct lysc_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
Radek Krejci00b874b2019-02-12 10:54:50 +01001201 uint32_t refcount; /**< reference counter since some of the when statements are shared among several nodes */
Michal Vaskoecd62de2019-11-13 12:35:11 +01001202 uint16_t flags; /**< [schema node flags](@ref snodeflags) - only LYS_STATUS is allowed */
Radek Krejcidd4e8d42018-10-16 14:55:43 +02001203};
1204
1205/**
Radek Krejci2a408df2018-10-29 16:32:26 +01001206 * @brief YANG identity-stmt
1207 */
1208struct lysc_ident {
Michal Vaskoe313c382022-03-14 13:04:47 +01001209 const char *name; /**< identity name (mandatory, no prefix) */
Radek Krejcic8b31002019-01-08 10:24:45 +01001210 const char *dsc; /**< description */
1211 const char *ref; /**< reference */
Radek Krejci693262f2019-04-29 15:23:20 +02001212 struct lys_module *module; /**< module structure */
aPiecek6b3d5422021-07-30 15:55:43 +02001213 struct lysc_ident **derived; /**< list of (pointers to the) derived identities ([sized array](@ref sizedarrays))
1214 It also contains references to identities located in unimplemented modules. */
Radek Krejci2a408df2018-10-29 16:32:26 +01001215 struct lysc_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
1216 uint16_t flags; /**< [schema node flags](@ref snodeflags) - only LYS_STATUS_ values are allowed */
1217};
1218
1219/**
Radek Krejci151a5b72018-10-19 14:21:44 +02001220 * @defgroup ifftokens if-feature expression tokens
Radek Krejci8678fa42020-08-18 16:07:28 +02001221 * Tokens of if-feature expression used in ::lysc_iffeature.expr.
Radek Krejci151a5b72018-10-19 14:21:44 +02001222 *
1223 * @{
1224 */
1225#define LYS_IFF_NOT 0x00 /**< operand "not" */
1226#define LYS_IFF_AND 0x01 /**< operand "and" */
1227#define LYS_IFF_OR 0x02 /**< operand "or" */
1228#define LYS_IFF_F 0x03 /**< feature */
Radek Krejci2ff0d572020-05-21 15:27:28 +02001229/** @} ifftokens */
Radek Krejci151a5b72018-10-19 14:21:44 +02001230
1231/**
Radek Krejcib7db73a2018-10-24 14:18:40 +02001232 * @brief Compiled YANG revision statement
1233 */
1234struct lysc_revision {
1235 char date[LY_REV_SIZE]; /**< revision-date (mandatory) */
1236 struct lysc_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
1237};
1238
Radek Krejci2167ee12018-11-02 16:09:07 +01001239struct lysc_range {
Radek Krejci4f28eda2018-11-12 11:46:16 +01001240 struct lysc_range_part {
Radek Krejci693262f2019-04-29 15:23:20 +02001241 union { /**< min boundary */
Radek Krejcie7b95092019-05-15 11:03:07 +02001242 int64_t min_64; /**< for int8, int16, int32, int64 and decimal64 ( >= LY_TYPE_DEC64) */
1243 uint64_t min_u64; /**< for uint8, uint16, uint32, uint64, string and binary ( < LY_TYPE_DEC64) */
Radek Krejci2167ee12018-11-02 16:09:07 +01001244 };
Radek Krejci693262f2019-04-29 15:23:20 +02001245 union { /**< max boundary */
Radek Krejcie7b95092019-05-15 11:03:07 +02001246 int64_t max_64; /**< for int8, int16, int32, int64 and decimal64 ( >= LY_TYPE_DEC64) */
1247 uint64_t max_u64; /**< for uint8, uint16, uint32, uint64, string and binary ( < LY_TYPE_DEC64) */
Radek Krejci2167ee12018-11-02 16:09:07 +01001248 };
Radek Krejci4f28eda2018-11-12 11:46:16 +01001249 } *parts; /**< compiled range expression ([sized array](@ref sizedarrays)) */
Radek Krejcic8b31002019-01-08 10:24:45 +01001250 const char *dsc; /**< description */
1251 const char *ref; /**< reference */
Radek Krejci2167ee12018-11-02 16:09:07 +01001252 const char *emsg; /**< error-message */
1253 const char *eapptag; /**< error-app-tag value */
1254 struct lysc_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
1255};
1256
1257struct lysc_pattern {
Radek Krejci54579462019-04-30 12:47:06 +02001258 const char *expr; /**< original, not compiled, regular expression */
1259 pcre2_code *code; /**< compiled regular expression */
Radek Krejcic8b31002019-01-08 10:24:45 +01001260 const char *dsc; /**< description */
1261 const char *ref; /**< reference */
Radek Krejci2167ee12018-11-02 16:09:07 +01001262 const char *emsg; /**< error-message */
1263 const char *eapptag; /**< error-app-tag value */
1264 struct lysc_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
Radek Krejci0f969882020-08-21 16:56:47 +02001265 uint32_t inverted : 1; /**< invert-match flag */
1266 uint32_t refcount : 31; /**< reference counter */
Radek Krejci2167ee12018-11-02 16:09:07 +01001267};
1268
1269struct lysc_must {
Radek Krejci2167ee12018-11-02 16:09:07 +01001270 struct lyxp_expr *cond; /**< XPath when condition */
Michal Vasko5d24f6c2020-10-13 13:49:06 +02001271 struct lysc_prefix *prefixes; /**< compiled used prefixes in the condition */
Radek Krejcic8b31002019-01-08 10:24:45 +01001272 const char *dsc; /**< description */
1273 const char *ref; /**< reference */
Radek Krejci2167ee12018-11-02 16:09:07 +01001274 const char *emsg; /**< error-message */
1275 const char *eapptag; /**< error-app-tag value */
1276 struct lysc_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
1277};
1278
1279struct lysc_type {
Michal Vaskof309c482024-01-22 12:07:00 +01001280 const char *name; /**< referenced typedef name (without prefix, if any), NULL for built-in types */
Radek Krejci4f28eda2018-11-12 11:46:16 +01001281 struct lysc_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
Michal Vaskof309c482024-01-22 12:07:00 +01001282 struct lyplg_type *plugin; /**< type's manipulation callbacks plugin */
1283 LY_DATA_TYPE basetype; /**< base type of the type */
Michal Vasko080064b2021-08-31 15:20:44 +02001284 uint32_t refcount; /**< reference counter for type sharing, it may be accessed concurrently when
Michal Vaskobabf0bd2021-08-31 14:55:39 +02001285 creating/freeing data node values that reference it (instance-identifier) */
Radek Krejci2167ee12018-11-02 16:09:07 +01001286};
1287
1288struct lysc_type_num {
Michal Vaskof309c482024-01-22 12:07:00 +01001289 const char *name; /**< referenced typedef name (without prefix, if any), NULL for built-in types */
Radek Krejci4f28eda2018-11-12 11:46:16 +01001290 struct lysc_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
Michal Vaskof309c482024-01-22 12:07:00 +01001291 struct lyplg_type *plugin; /**< type's manipulation callbacks plugin */
1292 LY_DATA_TYPE basetype; /**< base type of the type */
Michal Vasko080064b2021-08-31 15:20:44 +02001293 uint32_t refcount; /**< reference counter for type sharing */
Michal Vaskof309c482024-01-22 12:07:00 +01001294
Radek Krejci2167ee12018-11-02 16:09:07 +01001295 struct lysc_range *range; /**< Optional range limitation */
1296};
1297
1298struct lysc_type_dec {
Michal Vaskof309c482024-01-22 12:07:00 +01001299 const char *name; /**< referenced typedef name (without prefix, if any), NULL for built-in types */
Radek Krejci4f28eda2018-11-12 11:46:16 +01001300 struct lysc_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
Michal Vaskof309c482024-01-22 12:07:00 +01001301 struct lyplg_type *plugin; /**< type's manipulation callbacks plugin */
1302 LY_DATA_TYPE basetype; /**< base type of the type */
Michal Vasko080064b2021-08-31 15:20:44 +02001303 uint32_t refcount; /**< reference counter for type sharing */
Michal Vaskof309c482024-01-22 12:07:00 +01001304
Radek Krejci6cba4292018-11-15 17:33:29 +01001305 uint8_t fraction_digits; /**< fraction digits specification */
Radek Krejci2167ee12018-11-02 16:09:07 +01001306 struct lysc_range *range; /**< Optional range limitation */
1307};
1308
1309struct lysc_type_str {
Michal Vaskof309c482024-01-22 12:07:00 +01001310 const char *name; /**< referenced typedef name (without prefix, if any), NULL for built-in types */
Radek Krejci4f28eda2018-11-12 11:46:16 +01001311 struct lysc_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
Michal Vaskof309c482024-01-22 12:07:00 +01001312 struct lyplg_type *plugin; /**< type's manipulation callbacks plugin */
1313 LY_DATA_TYPE basetype; /**< base type of the type */
Michal Vasko080064b2021-08-31 15:20:44 +02001314 uint32_t refcount; /**< reference counter for type sharing */
Michal Vaskof309c482024-01-22 12:07:00 +01001315
1316 struct lysc_range *length; /**< optional length limitation */
1317 struct lysc_pattern **patterns; /**< optional list of pointers to pattern limitations ([sized array](@ref sizedarrays)) */
Radek Krejci2167ee12018-11-02 16:09:07 +01001318};
1319
Radek Krejci693262f2019-04-29 15:23:20 +02001320struct lysc_type_bitenum_item {
1321 const char *name; /**< enumeration identifier */
1322 const char *dsc; /**< description */
1323 const char *ref; /**< reference */
1324 struct lysc_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
Michal Vasko26bbb272022-08-02 14:54:33 +02001325
Radek Krejci693262f2019-04-29 15:23:20 +02001326 union {
1327 int32_t value; /**< integer value associated with the enumeration */
1328 uint32_t position; /**< non-negative integer value associated with the bit */
1329 };
Michal Vaskof4fa90d2021-11-11 15:05:19 +01001330 uint16_t flags; /**< [schema node flags](@ref snodeflags) - only LYS_STATUS_ and LYS_IS_ENUM values
1331 are allowed */
Radek Krejci693262f2019-04-29 15:23:20 +02001332};
1333
Radek Krejci2167ee12018-11-02 16:09:07 +01001334struct lysc_type_enum {
Michal Vaskof309c482024-01-22 12:07:00 +01001335 const char *name; /**< referenced typedef name (without prefix, if any), NULL for built-in types */
Radek Krejci4f28eda2018-11-12 11:46:16 +01001336 struct lysc_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
Michal Vaskof309c482024-01-22 12:07:00 +01001337 struct lyplg_type *plugin; /**< type's manipulation callbacks plugin */
1338 LY_DATA_TYPE basetype; /**< base type of the type */
Michal Vasko080064b2021-08-31 15:20:44 +02001339 uint32_t refcount; /**< reference counter for type sharing */
Michal Vaskof309c482024-01-22 12:07:00 +01001340
Radek Krejci693262f2019-04-29 15:23:20 +02001341 struct lysc_type_bitenum_item *enums; /**< enumerations list ([sized array](@ref sizedarrays)), mandatory (at least 1 item) */
1342};
1343
1344struct lysc_type_bits {
Michal Vaskof309c482024-01-22 12:07:00 +01001345 const char *name; /**< referenced typedef name (without prefix, if any), NULL for built-in types */
Radek Krejci693262f2019-04-29 15:23:20 +02001346 struct lysc_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
Michal Vaskof309c482024-01-22 12:07:00 +01001347 struct lyplg_type *plugin; /**< type's manipulation callbacks plugin */
1348 LY_DATA_TYPE basetype; /**< base type of the type */
Michal Vasko080064b2021-08-31 15:20:44 +02001349 uint32_t refcount; /**< reference counter for type sharing */
Michal Vaskof309c482024-01-22 12:07:00 +01001350
Radek Krejci849a62a2019-05-22 15:29:05 +02001351 struct lysc_type_bitenum_item *bits; /**< bits list ([sized array](@ref sizedarrays)), mandatory (at least 1 item),
1352 the items are ordered by their position value. */
Radek Krejci2167ee12018-11-02 16:09:07 +01001353};
1354
1355struct lysc_type_leafref {
Michal Vaskof309c482024-01-22 12:07:00 +01001356 const char *name; /**< referenced typedef name (without prefix, if any), NULL for built-in types */
Radek Krejci4f28eda2018-11-12 11:46:16 +01001357 struct lysc_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
Michal Vaskof309c482024-01-22 12:07:00 +01001358 struct lyplg_type *plugin; /**< type's manipulation callbacks plugin */
1359 LY_DATA_TYPE basetype; /**< base type of the type */
Michal Vasko080064b2021-08-31 15:20:44 +02001360 uint32_t refcount; /**< reference counter for type sharing */
Michal Vaskof309c482024-01-22 12:07:00 +01001361
Michal Vasko004d3152020-06-11 19:59:22 +02001362 struct lyxp_expr *path; /**< parsed target path, compiled path cannot be stored because of type sharing */
Michal Vasko5d24f6c2020-10-13 13:49:06 +02001363 struct lysc_prefix *prefixes; /**< resolved prefixes used in the path */
Radek Krejci412ddfa2018-11-23 11:44:11 +01001364 struct lysc_type *realtype; /**< pointer to the real (first non-leafref in possible leafrefs chain) type. */
Radek Krejci2167ee12018-11-02 16:09:07 +01001365 uint8_t require_instance; /**< require-instance flag */
1366};
1367
1368struct lysc_type_identityref {
Michal Vaskof309c482024-01-22 12:07:00 +01001369 const char *name; /**< referenced typedef name (without prefix, if any), NULL for built-in types */
Radek Krejci4f28eda2018-11-12 11:46:16 +01001370 struct lysc_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
Michal Vaskof309c482024-01-22 12:07:00 +01001371 struct lyplg_type *plugin; /**< type's manipulation callbacks plugin */
1372 LY_DATA_TYPE basetype; /**< base type of the type */
Michal Vasko080064b2021-08-31 15:20:44 +02001373 uint32_t refcount; /**< reference counter for type sharing */
Michal Vaskof309c482024-01-22 12:07:00 +01001374
Radek Krejci555cb5b2018-11-16 14:54:33 +01001375 struct lysc_ident **bases; /**< list of pointers to the base identities ([sized array](@ref sizedarrays)),
Radek Krejci2167ee12018-11-02 16:09:07 +01001376 mandatory (at least 1 item) */
1377};
1378
1379struct lysc_type_instanceid {
Michal Vaskof309c482024-01-22 12:07:00 +01001380 const char *name; /**< referenced typedef name (without prefix, if any), NULL for built-in types */
Radek Krejci4f28eda2018-11-12 11:46:16 +01001381 struct lysc_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
Michal Vaskof309c482024-01-22 12:07:00 +01001382 struct lyplg_type *plugin; /**< type's manipulation callbacks plugin */
1383 LY_DATA_TYPE basetype; /**< base type of the type */
Michal Vasko080064b2021-08-31 15:20:44 +02001384 uint32_t refcount; /**< reference counter for type sharing */
Michal Vaskof309c482024-01-22 12:07:00 +01001385
Radek Krejci2167ee12018-11-02 16:09:07 +01001386 uint8_t require_instance; /**< require-instance flag */
1387};
1388
Radek Krejci2167ee12018-11-02 16:09:07 +01001389struct lysc_type_union {
Michal Vaskof309c482024-01-22 12:07:00 +01001390 const char *name; /**< referenced typedef name (without prefix, if any), NULL for built-in types */
Radek Krejci4f28eda2018-11-12 11:46:16 +01001391 struct lysc_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
Michal Vaskof309c482024-01-22 12:07:00 +01001392 struct lyplg_type *plugin; /**< type's manipulation callbacks plugin */
1393 LY_DATA_TYPE basetype; /**< base type of the type */
Michal Vasko080064b2021-08-31 15:20:44 +02001394 uint32_t refcount; /**< reference counter for type sharing */
Michal Vaskof309c482024-01-22 12:07:00 +01001395
Radek Krejci2167ee12018-11-02 16:09:07 +01001396 struct lysc_type **types; /**< list of types in the union ([sized array](@ref sizedarrays)), mandatory (at least 1 item) */
1397};
1398
1399struct lysc_type_bin {
Michal Vaskof309c482024-01-22 12:07:00 +01001400 const char *name; /**< referenced typedef name (without prefix, if any), NULL for built-in types */
Radek Krejci4f28eda2018-11-12 11:46:16 +01001401 struct lysc_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
Michal Vaskof309c482024-01-22 12:07:00 +01001402 struct lyplg_type *plugin; /**< type's manipulation callbacks plugin */
1403 LY_DATA_TYPE basetype; /**< base type of the type */
Michal Vasko080064b2021-08-31 15:20:44 +02001404 uint32_t refcount; /**< reference counter for type sharing */
Michal Vaskof309c482024-01-22 12:07:00 +01001405
1406 struct lysc_range *length; /**< optional length limitation */
Radek Krejci5aeea3a2018-09-05 13:29:36 +02001407};
1408
Michal Vasko60ea6352020-06-29 13:39:39 +02001409/**
1410 * @brief Maximum number of hashes stored in a schema node.
1411 */
1412#define LYS_NODE_HASH_COUNT 4
1413
Radek Krejci5aeea3a2018-09-05 13:29:36 +02001414/**
Radek Krejci0af5f5d2018-09-07 15:00:30 +02001415 * @brief Compiled YANG data node
1416 */
1417struct lysc_node {
Radek Krejcide7a9c42021-03-10 13:13:06 +01001418 uint16_t nodetype; /**< [type of the node](@ref schemanodetypes) (mandatory) */
Radek Krejcidd4e8d42018-10-16 14:55:43 +02001419 uint16_t flags; /**< [schema node flags](@ref snodeflags) */
Michal Vasko60ea6352020-06-29 13:39:39 +02001420 uint8_t hash[LYS_NODE_HASH_COUNT]; /**< schema hash required for LYB printer/parser */
Radek Krejcibd8d9ba2018-11-02 16:06:26 +01001421 struct lys_module *module; /**< module structure */
Radek Krejcibd8d9ba2018-11-02 16:06:26 +01001422 struct lysc_node *parent; /**< parent node (NULL in case of top level node) */
1423 struct lysc_node *next; /**< next sibling node (NULL if there is no one) */
1424 struct lysc_node *prev; /**< pointer to the previous sibling node \note Note that this pointer is
1425 never NULL. If there is no sibling node, pointer points to the node
1426 itself. In case of the first node, this pointer points to the last
1427 node in the list. */
Radek Krejcidd4e8d42018-10-16 14:55:43 +02001428 const char *name; /**< node name (mandatory) */
Radek Krejci12fb9142019-01-08 09:45:30 +01001429 const char *dsc; /**< description */
1430 const char *ref; /**< reference */
Radek Krejcie53a8dc2018-10-17 12:52:40 +02001431 struct lysc_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
aPiecek9922ea92021-04-12 07:59:20 +02001432 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 +02001433};
1434
Radek Krejci00a3e8a2021-01-27 08:24:49 +01001435struct lysc_node_action_inout {
1436 union {
1437 struct lysc_node node; /**< implicit cast for the members compatible with ::lysc_node */
Michal Vasko26bbb272022-08-02 14:54:33 +02001438
Radek Krejci00a3e8a2021-01-27 08:24:49 +01001439 struct {
1440 uint16_t nodetype; /**< LYS_INPUT or LYS_OUTPUT */
1441 uint16_t flags; /**< [schema node flags](@ref snodeflags) */
1442 uint8_t hash[LYS_NODE_HASH_COUNT]; /**< schema hash required for LYB printer/parser */
1443 struct lys_module *module; /**< module structure */
Radek Krejci5960c312021-01-27 20:24:22 +01001444 struct lysc_node *parent;/**< parent node (NULL in case of top level node) */
Michal Vasko544e58a2021-01-28 14:33:41 +01001445 struct lysc_node *next; /**< next sibling node (output node for input, NULL for output) */
1446 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 +01001447 const char *name; /**< "input" or "output" */
1448 const char *dsc; /**< ALWAYS NULL, compatibility member with ::lysc_node */
1449 const char *ref; /**< ALWAYS NULL, compatibility member with ::lysc_node */
Radek Krejci00a3e8a2021-01-27 08:24:49 +01001450 struct lysc_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
aPiecek9922ea92021-04-12 07:59:20 +02001451 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 +01001452 };
1453 };
1454
Radek Krejci9a3823e2021-01-27 20:26:46 +01001455 struct lysc_node *child; /**< first child node (linked list) */
Radek Krejci00a3e8a2021-01-27 08:24:49 +01001456 struct lysc_must *musts; /**< list of must restrictions ([sized array](@ref sizedarrays)) */
1457};
1458
1459struct lysc_node_action {
1460 union {
1461 struct lysc_node node; /**< implicit cast for the members compatible with ::lysc_node */
Michal Vasko26bbb272022-08-02 14:54:33 +02001462
Radek Krejci00a3e8a2021-01-27 08:24:49 +01001463 struct {
1464 uint16_t nodetype; /**< LYS_RPC or LYS_ACTION */
1465 uint16_t flags; /**< [schema node flags](@ref snodeflags) */
1466 uint8_t hash[LYS_NODE_HASH_COUNT]; /**< schema hash required for LYB printer/parser */
1467 struct lys_module *module; /**< module structure */
1468 struct lysc_node *parent; /**< parent node (NULL in case of top level node - RPC) */
1469 struct lysc_node_action *next; /**< next sibling node (NULL if there is no one) */
1470 struct lysc_node_action *prev; /**< pointer to the previous sibling node \note Note that this pointer is
1471 never NULL. If there is no sibling node, pointer points to the node
1472 itself. In case of the first node, this pointer points to the last
1473 node in the list. */
1474 const char *name; /**< action/RPC name (mandatory) */
1475 const char *dsc; /**< description */
1476 const char *ref; /**< reference */
1477 struct lysc_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
aPiecek9922ea92021-04-12 07:59:20 +02001478 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 +01001479 };
1480 };
1481
Radek Krejci9a3823e2021-01-27 20:26:46 +01001482 struct lysc_when **when; /**< list of pointers to when statements ([sized array](@ref sizedarrays)),
1483 the action/RPC nodes do not contain the when statement on their own, but they can
1484 inherit it from the parent's uses. */
Radek Krejci00a3e8a2021-01-27 08:24:49 +01001485 struct lysc_node_action_inout input; /**< RPC's/action's input */
1486 struct lysc_node_action_inout output; /**< RPC's/action's output */
1487
1488};
1489
1490struct lysc_node_notif {
1491 union {
1492 struct lysc_node node; /**< implicit cast for the members compatible with ::lysc_node */
Michal Vasko26bbb272022-08-02 14:54:33 +02001493
Radek Krejci00a3e8a2021-01-27 08:24:49 +01001494 struct {
1495 uint16_t nodetype; /**< LYS_NOTIF */
1496 uint16_t flags; /**< [schema node flags](@ref snodeflags) */
1497 uint8_t hash[LYS_NODE_HASH_COUNT]; /**< schema hash required for LYB printer/parser */
1498 struct lys_module *module; /**< module structure */
1499 struct lysc_node *parent; /**< parent node (NULL in case of top level node) */
1500 struct lysc_node_notif *next; /**< next sibling node (NULL if there is no one) */
1501 struct lysc_node_notif *prev; /**< pointer to the previous sibling node \note Note that this pointer is
1502 never NULL. If there is no sibling node, pointer points to the node
1503 itself. In case of the first node, this pointer points to the last
1504 node in the list. */
1505 const char *name; /**< Notification name (mandatory) */
1506 const char *dsc; /**< description */
1507 const char *ref; /**< reference */
1508 struct lysc_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
aPiecek9922ea92021-04-12 07:59:20 +02001509 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 +01001510 };
1511 };
1512
Radek Krejci9a3823e2021-01-27 20:26:46 +01001513 struct lysc_node *child; /**< first child node (linked list) */
Radek Krejci00a3e8a2021-01-27 08:24:49 +01001514 struct lysc_must *musts; /**< list of must restrictions ([sized array](@ref sizedarrays)) */
Radek Krejci9a3823e2021-01-27 20:26:46 +01001515 struct lysc_when **when; /**< list of pointers to when statements ([sized array](@ref sizedarrays)),
1516 the notification nodes do not contain the when statement on their own, but they can
1517 inherit it from the parent's uses. */
Radek Krejci00a3e8a2021-01-27 08:24:49 +01001518};
1519
1520struct lysc_node_container {
1521 union {
1522 struct lysc_node node; /**< implicit cast for the members compatible with ::lysc_node */
Michal Vasko26bbb272022-08-02 14:54:33 +02001523
Radek Krejci00a3e8a2021-01-27 08:24:49 +01001524 struct {
1525 uint16_t nodetype; /**< LYS_CONTAINER */
1526 uint16_t flags; /**< [schema node flags](@ref snodeflags) */
1527 uint8_t hash[LYS_NODE_HASH_COUNT]; /**< schema hash required for LYB printer/parser */
1528 struct lys_module *module; /**< module structure */
1529 struct lysc_node *parent; /**< parent node (NULL in case of top level node) */
1530 struct lysc_node *next; /**< next sibling node (NULL if there is no one) */
1531 struct lysc_node *prev; /**< pointer to the previous sibling node \note Note that this pointer is
1532 never NULL. If there is no sibling node, pointer points to the node
1533 itself. In case of the first node, this pointer points to the last
1534 node in the list. */
1535 const char *name; /**< node name (mandatory) */
1536 const char *dsc; /**< description */
1537 const char *ref; /**< reference */
1538 struct lysc_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
aPiecek9922ea92021-04-12 07:59:20 +02001539 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 +01001540 };
1541 };
Radek Krejci4f28eda2018-11-12 11:46:16 +01001542
1543 struct lysc_node *child; /**< first child node (linked list) */
1544 struct lysc_must *musts; /**< list of must restrictions ([sized array](@ref sizedarrays)) */
Radek Krejci9a3823e2021-01-27 20:26:46 +01001545 struct lysc_when **when; /**< list of pointers to when statements ([sized array](@ref sizedarrays)) */
Radek Krejci2a9fc652021-01-22 17:44:34 +01001546 struct lysc_node_action *actions;/**< first of actions nodes (linked list) */
1547 struct lysc_node_notif *notifs; /**< first of notifications nodes (linked list) */
Radek Krejcibd8d9ba2018-11-02 16:06:26 +01001548};
1549
Radek Krejcia3045382018-11-22 14:30:31 +01001550struct lysc_node_case {
Radek Krejci00a3e8a2021-01-27 08:24:49 +01001551 union {
1552 struct lysc_node node; /**< implicit cast for the members compatible with ::lysc_node */
Michal Vasko26bbb272022-08-02 14:54:33 +02001553
Radek Krejci00a3e8a2021-01-27 08:24:49 +01001554 struct {
1555 uint16_t nodetype; /**< LYS_CASE */
1556 uint16_t flags; /**< [schema node flags](@ref snodeflags) */
1557 uint8_t hash[LYS_NODE_HASH_COUNT]; /**< schema hash required for LYB printer/parser, unused */
1558 struct lys_module *module; /**< module structure */
1559 struct lysc_node *parent; /**< parent node (NULL in case of top level node) */
1560 struct lysc_node *next; /**< next sibling node (NULL if there is no one) */
1561 struct lysc_node *prev; /**< pointer to the previous sibling node \note Note that this pointer is
Radek Krejci056d0a82018-12-06 16:57:25 +01001562 never NULL. If there is no sibling node, pointer points to the node
1563 itself. In case of the first node, this pointer points to the last
1564 node in the list. */
Radek Krejci00a3e8a2021-01-27 08:24:49 +01001565 const char *name; /**< name of the case, including the implicit case */
1566 const char *dsc; /**< description */
1567 const char *ref; /**< reference */
1568 struct lysc_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
aPiecek9922ea92021-04-12 07:59:20 +02001569 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 +01001570 };
1571 };
Radek Krejci056d0a82018-12-06 16:57:25 +01001572
Radek Krejcia3045382018-11-22 14:30:31 +01001573 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 +01001574 each other as siblings with the parent pointer pointing to appropriate case node. */
Radek Krejci9a3823e2021-01-27 20:26:46 +01001575 struct lysc_when **when; /**< list of pointers to when statements ([sized array](@ref sizedarrays)) */
Radek Krejcia3045382018-11-22 14:30:31 +01001576};
1577
Radek Krejcibd8d9ba2018-11-02 16:06:26 +01001578struct lysc_node_choice {
Radek Krejci00a3e8a2021-01-27 08:24:49 +01001579 union {
1580 struct lysc_node node; /**< implicit cast for the members compatible with ::lysc_node */
Michal Vasko26bbb272022-08-02 14:54:33 +02001581
Radek Krejci00a3e8a2021-01-27 08:24:49 +01001582 struct {
1583 uint16_t nodetype; /**< LYS_CHOICE */
1584 uint16_t flags; /**< [schema node flags](@ref snodeflags) */
1585 uint8_t hash[LYS_NODE_HASH_COUNT]; /**< schema hash required for LYB printer/parser, unused */
1586 struct lys_module *module; /**< module structure */
1587 struct lysc_node *parent; /**< parent node (NULL in case of top level node) */
1588 struct lysc_node *next; /**< next sibling node (NULL if there is no one) */
1589 struct lysc_node *prev; /**< pointer to the previous sibling node \note Note that this pointer is
Radek Krejcibd8d9ba2018-11-02 16:06:26 +01001590 never NULL. If there is no sibling node, pointer points to the node
1591 itself. In case of the first node, this pointer points to the last
1592 node in the list. */
Radek Krejci00a3e8a2021-01-27 08:24:49 +01001593 const char *name; /**< node name (mandatory) */
1594 const char *dsc; /**< description */
1595 const char *ref; /**< reference */
1596 struct lysc_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
aPiecek9922ea92021-04-12 07:59:20 +02001597 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 +01001598 };
1599 };
Radek Krejcibd8d9ba2018-11-02 16:06:26 +01001600
Michal Vaskod098f5d2024-01-11 08:51:31 +01001601 struct lysc_node_case *cases; /**< list of all the cases (linked list) */
Radek Krejci9a3823e2021-01-27 20:26:46 +01001602 struct lysc_when **when; /**< list of pointers to when statements ([sized array](@ref sizedarrays)) */
Radek Krejci056d0a82018-12-06 16:57:25 +01001603 struct lysc_node_case *dflt; /**< default case of the choice, only a pointer into the cases array. */
Radek Krejcibd8d9ba2018-11-02 16:06:26 +01001604};
1605
1606struct lysc_node_leaf {
Radek Krejci00a3e8a2021-01-27 08:24:49 +01001607 union {
1608 struct lysc_node node; /**< implicit cast for the members compatible with ::lysc_node */
Michal Vasko26bbb272022-08-02 14:54:33 +02001609
Radek Krejci00a3e8a2021-01-27 08:24:49 +01001610 struct {
1611 uint16_t nodetype; /**< LYS_LEAF */
1612 uint16_t flags; /**< [schema node flags](@ref snodeflags) */
1613 uint8_t hash[LYS_NODE_HASH_COUNT]; /**< schema hash required for LYB printer/parser */
1614 struct lys_module *module; /**< module structure */
1615 struct lysc_node *parent; /**< parent node (NULL in case of top level node) */
1616 struct lysc_node *next; /**< next sibling node (NULL if there is no one) */
1617 struct lysc_node *prev; /**< pointer to the previous sibling node \note Note that this pointer is
Radek Krejcibd8d9ba2018-11-02 16:06:26 +01001618 never NULL. If there is no sibling node, pointer points to the node
1619 itself. In case of the first node, this pointer points to the last
1620 node in the list. */
Radek Krejci00a3e8a2021-01-27 08:24:49 +01001621 const char *name; /**< node name (mandatory) */
1622 const char *dsc; /**< description */
1623 const char *ref; /**< reference */
1624 struct lysc_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
aPiecek9922ea92021-04-12 07:59:20 +02001625 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 +01001626 };
1627 };
Radek Krejci4f28eda2018-11-12 11:46:16 +01001628
1629 struct lysc_must *musts; /**< list of must restrictions ([sized array](@ref sizedarrays)) */
Radek Krejci9a3823e2021-01-27 20:26:46 +01001630 struct lysc_when **when; /**< list of pointers to when statements ([sized array](@ref sizedarrays)) */
Radek Krejci4f28eda2018-11-12 11:46:16 +01001631 struct lysc_type *type; /**< type of the leaf node (mandatory) */
Radek Krejcib57cf1e2018-11-23 14:07:05 +01001632
Radek Krejci4f28eda2018-11-12 11:46:16 +01001633 const char *units; /**< units of the leaf's type */
Michal Vasko33876022021-04-27 16:42:24 +02001634 struct lyd_value *dflt; /**< default value, use ::lyd_value_get_canonical() to get the canonical string */
Radek Krejcibd8d9ba2018-11-02 16:06:26 +01001635};
1636
1637struct lysc_node_leaflist {
Radek Krejci00a3e8a2021-01-27 08:24:49 +01001638 union {
1639 struct lysc_node node; /**< implicit cast for the members compatible with ::lysc_node */
Michal Vasko26bbb272022-08-02 14:54:33 +02001640
Radek Krejci00a3e8a2021-01-27 08:24:49 +01001641 struct {
1642 uint16_t nodetype; /**< LYS_LEAFLIST */
1643 uint16_t flags; /**< [schema node flags](@ref snodeflags) */
1644 uint8_t hash[LYS_NODE_HASH_COUNT]; /**< schema hash required for LYB printer/parser */
1645 struct lys_module *module; /**< module structure */
1646 struct lysc_node *parent; /**< parent node (NULL in case of top level node) */
1647 struct lysc_node *next; /**< next sibling node (NULL if there is no one) */
1648 struct lysc_node *prev; /**< pointer to the previous sibling node \note Note that this pointer is
Radek Krejcibd8d9ba2018-11-02 16:06:26 +01001649 never NULL. If there is no sibling node, pointer points to the node
1650 itself. In case of the first node, this pointer points to the last
1651 node in the list. */
Radek Krejci00a3e8a2021-01-27 08:24:49 +01001652 const char *name; /**< node name (mandatory) */
1653 const char *dsc; /**< description */
1654 const char *ref; /**< reference */
1655 struct lysc_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
aPiecek9922ea92021-04-12 07:59:20 +02001656 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 +01001657 };
1658 };
Radek Krejcib57cf1e2018-11-23 14:07:05 +01001659
1660 struct lysc_must *musts; /**< list of must restrictions ([sized array](@ref sizedarrays)) */
Radek Krejci9a3823e2021-01-27 20:26:46 +01001661 struct lysc_when **when; /**< list of pointers to when statements ([sized array](@ref sizedarrays)) */
Radek Krejcib57cf1e2018-11-23 14:07:05 +01001662 struct lysc_type *type; /**< type of the leaf node (mandatory) */
1663
Radek Krejci0e5d8382018-11-28 16:37:53 +01001664 const char *units; /**< units of the leaf's type */
Michal Vasko33876022021-04-27 16:42:24 +02001665 struct lyd_value **dflts; /**< list ([sized array](@ref sizedarrays)) of default values, use
1666 ::lyd_value_get_canonical() to get the canonical strings */
Michal Vaskoba99a3e2020-08-18 15:50:05 +02001667
Radek Krejci0e5d8382018-11-28 16:37:53 +01001668 uint32_t min; /**< min-elements constraint */
1669 uint32_t max; /**< max-elements constraint */
1670
Radek Krejcibd8d9ba2018-11-02 16:06:26 +01001671};
1672
1673struct lysc_node_list {
Radek Krejci00a3e8a2021-01-27 08:24:49 +01001674 union {
1675 struct lysc_node node; /**< implicit cast for the members compatible with ::lysc_node */
Michal Vasko26bbb272022-08-02 14:54:33 +02001676
Radek Krejci00a3e8a2021-01-27 08:24:49 +01001677 struct {
1678 uint16_t nodetype; /**< LYS_LIST */
1679 uint16_t flags; /**< [schema node flags](@ref snodeflags) */
1680 uint8_t hash[LYS_NODE_HASH_COUNT]; /**< schema hash required for LYB printer/parser */
1681 struct lys_module *module; /**< module structure */
1682 struct lysc_node *parent; /**< parent node (NULL in case of top level node) */
1683 struct lysc_node *next; /**< next sibling node (NULL if there is no one) */
1684 struct lysc_node *prev; /**< pointer to the previous sibling node \note Note that this pointer is
Radek Krejcibd8d9ba2018-11-02 16:06:26 +01001685 never NULL. If there is no sibling node, pointer points to the node
1686 itself. In case of the first node, this pointer points to the last
1687 node in the list. */
Radek Krejci00a3e8a2021-01-27 08:24:49 +01001688 const char *name; /**< node name (mandatory) */
1689 const char *dsc; /**< description */
1690 const char *ref; /**< reference */
1691 struct lysc_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
aPiecek9922ea92021-04-12 07:59:20 +02001692 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 +01001693 };
1694 };
Radek Krejci9bb94eb2018-12-04 16:48:35 +01001695
1696 struct lysc_node *child; /**< first child node (linked list) */
1697 struct lysc_must *musts; /**< list of must restrictions ([sized array](@ref sizedarrays)) */
Radek Krejci9a3823e2021-01-27 20:26:46 +01001698 struct lysc_when **when; /**< list of pointers to when statements ([sized array](@ref sizedarrays)) */
Radek Krejci2a9fc652021-01-22 17:44:34 +01001699 struct lysc_node_action *actions;/**< first of actions nodes (linked list) */
1700 struct lysc_node_notif *notifs; /**< first of notifications nodes (linked list) */
Radek Krejci9bb94eb2018-12-04 16:48:35 +01001701
Radek Krejci2a9fc652021-01-22 17:44:34 +01001702 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 +01001703 uint32_t min; /**< min-elements constraint */
1704 uint32_t max; /**< max-elements constraint */
Radek Krejcibd8d9ba2018-11-02 16:06:26 +01001705};
1706
1707struct lysc_node_anydata {
Radek Krejci00a3e8a2021-01-27 08:24:49 +01001708 union {
1709 struct lysc_node node; /**< implicit cast for the members compatible with ::lysc_node */
Michal Vasko26bbb272022-08-02 14:54:33 +02001710
Radek Krejci00a3e8a2021-01-27 08:24:49 +01001711 struct {
1712 uint16_t nodetype; /**< LYS_ANYXML or LYS_ANYDATA */
1713 uint16_t flags; /**< [schema node flags](@ref snodeflags) */
1714 uint8_t hash[LYS_NODE_HASH_COUNT]; /**< schema hash required for LYB printer/parser */
1715 struct lys_module *module; /**< module structure */
1716 struct lysc_node *parent; /**< parent node (NULL in case of top level node) */
1717 struct lysc_node *next; /**< next sibling node (NULL if there is no one) */
1718 struct lysc_node *prev; /**< pointer to the previous sibling node \note Note that this pointer is
Radek Krejcibd8d9ba2018-11-02 16:06:26 +01001719 never NULL. If there is no sibling node, pointer points to the node
1720 itself. In case of the first node, this pointer points to the last
1721 node in the list. */
Radek Krejci00a3e8a2021-01-27 08:24:49 +01001722 const char *name; /**< node name (mandatory) */
1723 const char *dsc; /**< description */
1724 const char *ref; /**< reference */
1725 struct lysc_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
aPiecek9922ea92021-04-12 07:59:20 +02001726 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 +01001727 };
1728 };
Radek Krejci9800fb82018-12-13 14:26:23 +01001729
1730 struct lysc_must *musts; /**< list of must restrictions ([sized array](@ref sizedarrays)) */
Radek Krejci9a3823e2021-01-27 20:26:46 +01001731 struct lysc_when **when; /**< list of pointers to when statements ([sized array](@ref sizedarrays)) */
Radek Krejcibd8d9ba2018-11-02 16:06:26 +01001732};
1733
Radek Krejcidd4e8d42018-10-16 14:55:43 +02001734/**
1735 * @brief Compiled YANG schema tree structure representing YANG module.
1736 *
1737 * Semantically validated YANG schema tree for data tree parsing.
1738 * Contains only the necessary information for the data validation.
1739 */
1740struct lysc_module {
Radek Krejci0bcdaed2019-01-10 10:21:34 +01001741 struct lys_module *mod; /**< covering module structure */
Radek Krejcidd4e8d42018-10-16 14:55:43 +02001742
Radek Krejci2a408df2018-10-29 16:32:26 +01001743 struct lysc_node *data; /**< list of module's top-level data nodes (linked list) */
Radek Krejci2a9fc652021-01-22 17:44:34 +01001744 struct lysc_node_action *rpcs; /**< first of actions nodes (linked list) */
1745 struct lysc_node_notif *notifs; /**< first of notifications nodes (linked list) */
Radek Krejcice8c1592018-10-29 15:35:51 +01001746 struct lysc_ext_instance *exts; /**< list of the extension instances ([sized array](@ref sizedarrays)) */
Radek Krejci0af5f5d2018-09-07 15:00:30 +02001747};
1748
1749/**
Radek Krejci490a5462020-11-05 08:44:42 +01001750 * @brief Examine whether a node is user-ordered list or leaf-list.
1751 *
1752 * @param[in] lysc_node Schema node to examine.
1753 * @return Boolean value whether the @p node is user-ordered or not.
1754 */
1755#define lysc_is_userordered(lysc_node) \
1756 ((!lysc_node || !(lysc_node->nodetype & (LYS_LEAFLIST | LYS_LIST)) || !(lysc_node->flags & LYS_ORDBY_USER)) ? 0 : 1)
1757
1758/**
1759 * @brief Examine whether a node is a list's key.
1760 *
1761 * @param[in] lysc_node Schema node to examine.
1762 * @return Boolean value whether the @p node is a key or not.
1763 */
1764#define lysc_is_key(lysc_node) \
Michal Vaskobce7ee32021-02-04 11:05:25 +01001765 ((!lysc_node || (lysc_node->nodetype != LYS_LEAF) || !(lysc_node->flags & LYS_KEY)) ? 0 : 1)
Radek Krejci490a5462020-11-05 08:44:42 +01001766
1767/**
Michal Vasko5c123b02020-12-04 14:34:04 +01001768 * @brief Examine whether a node is a non-presence container.
1769 *
1770 * @param[in] lysc_node Schema node to examine.
1771 * @return Boolean value whether the @p node is a NP container or not.
1772 */
1773#define lysc_is_np_cont(lysc_node) \
Michal Vaskobce7ee32021-02-04 11:05:25 +01001774 ((!lysc_node || (lysc_node->nodetype != LYS_CONTAINER) || (lysc_node->flags & LYS_PRESENCE)) ? 0 : 1)
1775
1776/**
Michal Vaskoe78faec2021-04-08 17:24:43 +02001777 * @brief Examine whether a node is a key-less list or a non-configuration leaf-list.
Michal Vaskobce7ee32021-02-04 11:05:25 +01001778 *
1779 * @param[in] lysc_node Schema node to examine.
1780 * @return Boolean value whether the @p node is a list with duplicate instances allowed.
1781 */
1782#define lysc_is_dup_inst_list(lysc_node) \
1783 ((lysc_node && (((lysc_node->nodetype == LYS_LIST) && (lysc_node->flags & LYS_KEYLESS)) || \
Michal Vaskoe78faec2021-04-08 17:24:43 +02001784 ((lysc_node->nodetype == LYS_LEAFLIST) && !(lysc_node->flags & LYS_CONFIG_W)))) ? 1 : 0)
Michal Vasko5c123b02020-12-04 14:34:04 +01001785
1786/**
Michal Vaskof8ded142022-02-17 10:48:01 +01001787 * @brief Get nearest @p schema parent (including the node itself) that can be instantiated in data.
1788 *
1789 * @param[in] schema Schema node to get the nearest data node for.
1790 * @return Schema data node, NULL if top-level (in data).
1791 */
1792LIBYANG_API_DECL const struct lysc_node *lysc_data_node(const struct lysc_node *schema);
1793
1794/**
1795 * @brief Same as ::lysc_data_node() but never returns the node itself.
1796 */
1797#define lysc_data_parent(SCHEMA) lysc_data_node((SCHEMA) ? (SCHEMA)->parent : NULL)
1798
1799/**
Michal Vaskod5cfa6e2020-11-23 16:56:08 +01001800 * @brief Check whether the schema node data instance existence depends on any when conditions.
1801 * This node and any direct parent choice and case schema nodes are also examined for when conditions.
1802 *
1803 * Be careful, this function is not recursive and checks only conditions that apply to this node directly.
1804 * Meaning if there are any conditions associated with any data parent instance of @p node, they are not returned.
1805 *
1806 * @param[in] node Schema node to examine.
1807 * @return When condition associated with the node data instance, NULL if there is none.
1808 */
Jan Kundrátc53a7ec2021-12-09 16:01:19 +01001809LIBYANG_API_DECL const struct lysc_when *lysc_has_when(const struct lysc_node *node);
Michal Vaskod5cfa6e2020-11-23 16:56:08 +01001810
1811/**
Michal Vaskoef53c812021-10-13 10:21:03 +02001812 * @brief Get the owner module of the schema node. It is the module of the top-level node. Generally,
1813 * in case of augments it is the target module, recursively, otherwise it is the module where the node is defined.
1814 *
1815 * @param[in] node Schema node to examine.
1816 * @return Module owner of the node.
1817 */
Jan Kundrátc53a7ec2021-12-09 16:01:19 +01001818LIBYANG_API_DECL const struct lys_module *lysc_owner_module(const struct lysc_node *node);
Michal Vaskoef53c812021-10-13 10:21:03 +02001819
1820/**
Radek Krejci2a9fc652021-01-22 17:44:34 +01001821 * @brief Get the groupings linked list of the given (parsed) schema node.
Radek Krejci53ea6152018-12-13 15:21:15 +01001822 * Decides the node's type and in case it has a groupings array, returns it.
1823 * @param[in] node Node to examine.
Radek Krejci2a9fc652021-01-22 17:44:34 +01001824 * @return The node's groupings linked list if any, NULL otherwise.
Radek Krejci53ea6152018-12-13 15:21:15 +01001825 */
Jan Kundrátc53a7ec2021-12-09 16:01:19 +01001826LIBYANG_API_DECL const struct lysp_node_grp *lysp_node_groupings(const struct lysp_node *node);
Radek Krejci53ea6152018-12-13 15:21:15 +01001827
1828/**
Radek Krejci056d0a82018-12-06 16:57:25 +01001829 * @brief Get the typedefs sized array of the given (parsed) schema node.
1830 * Decides the node's type and in case it has a typedefs array, returns it.
1831 * @param[in] node Node to examine.
1832 * @return The node's typedefs sized array if any, NULL otherwise.
1833 */
Jan Kundrátc53a7ec2021-12-09 16:01:19 +01001834LIBYANG_API_DECL const struct lysp_tpdf *lysp_node_typedefs(const struct lysp_node *node);
Radek Krejci056d0a82018-12-06 16:57:25 +01001835
1836/**
Radek Krejci2a9fc652021-01-22 17:44:34 +01001837 * @brief Get the actions/RPCs linked list of the given (parsed) schema node.
Radek Krejci056d0a82018-12-06 16:57:25 +01001838 * Decides the node's type and in case it has a actions/RPCs array, returns it.
1839 * @param[in] node Node to examine.
Radek Krejci2a9fc652021-01-22 17:44:34 +01001840 * @return The node's actions/RPCs linked list if any, NULL otherwise.
Radek Krejci056d0a82018-12-06 16:57:25 +01001841 */
Jan Kundrátc53a7ec2021-12-09 16:01:19 +01001842LIBYANG_API_DECL const struct lysp_node_action *lysp_node_actions(const struct lysp_node *node);
Radek Krejci056d0a82018-12-06 16:57:25 +01001843
1844/**
Radek Krejci2a9fc652021-01-22 17:44:34 +01001845 * @brief Get the Notifications linked list of the given (parsed) schema node.
Radek Krejci056d0a82018-12-06 16:57:25 +01001846 * Decides the node's type and in case it has a Notifications array, returns it.
1847 * @param[in] node Node to examine.
Radek Krejci2a9fc652021-01-22 17:44:34 +01001848 * @return The node's Notifications linked list if any, NULL otherwise.
Radek Krejci056d0a82018-12-06 16:57:25 +01001849 */
Jan Kundrátc53a7ec2021-12-09 16:01:19 +01001850LIBYANG_API_DECL const struct lysp_node_notif *lysp_node_notifs(const struct lysp_node *node);
Radek Krejci056d0a82018-12-06 16:57:25 +01001851
1852/**
1853 * @brief Get the children linked list of the given (parsed) schema node.
1854 * Decides the node's type and in case it has a children list, returns it.
1855 * @param[in] node Node to examine.
1856 * @return The node's children linked list if any, NULL otherwise.
1857 */
Jan Kundrátc53a7ec2021-12-09 16:01:19 +01001858LIBYANG_API_DECL const struct lysp_node *lysp_node_child(const struct lysp_node *node);
Radek Krejci056d0a82018-12-06 16:57:25 +01001859
1860/**
Radek Krejci2a9fc652021-01-22 17:44:34 +01001861 * @brief Get the actions/RPCs linked list of the given (compiled) schema node.
Radek Krejci056d0a82018-12-06 16:57:25 +01001862 * Decides the node's type and in case it has a actions/RPCs array, returns it.
1863 * @param[in] node Node to examine.
Radek Krejci2a9fc652021-01-22 17:44:34 +01001864 * @return The node's actions/RPCs linked list if any, NULL otherwise.
Radek Krejci056d0a82018-12-06 16:57:25 +01001865 */
Jan Kundrátc53a7ec2021-12-09 16:01:19 +01001866LIBYANG_API_DECL const struct lysc_node_action *lysc_node_actions(const struct lysc_node *node);
Radek Krejci056d0a82018-12-06 16:57:25 +01001867
1868/**
Radek Krejci2a9fc652021-01-22 17:44:34 +01001869 * @brief Get the Notifications linked list of the given (compiled) schema node.
Radek Krejci056d0a82018-12-06 16:57:25 +01001870 * Decides the node's type and in case it has a Notifications array, returns it.
1871 * @param[in] node Node to examine.
Radek Krejci2a9fc652021-01-22 17:44:34 +01001872 * @return The node's Notifications linked list if any, NULL otherwise.
Radek Krejci056d0a82018-12-06 16:57:25 +01001873 */
Jan Kundrátc53a7ec2021-12-09 16:01:19 +01001874LIBYANG_API_DECL const struct lysc_node_notif *lysc_node_notifs(const struct lysc_node *node);
Radek Krejci056d0a82018-12-06 16:57:25 +01001875
1876/**
1877 * @brief Get the children linked list of the given (compiled) schema node.
Michal Vasko2a668712020-10-21 11:48:09 +02001878 *
Michal Vasko544e58a2021-01-28 14:33:41 +01001879 * Note that ::LYS_CHOICE has only ::LYS_CASE children.
1880 * Also, ::LYS_RPC and ::LYS_ACTION have the first child ::LYS_INPUT, its sibling is ::LYS_OUTPUT.
1881 *
Michal Vasko2a668712020-10-21 11:48:09 +02001882 * @param[in] node Node to examine.
Michal Vasko2a668712020-10-21 11:48:09 +02001883 * @return Children linked list if any,
1884 * @return NULL otherwise.
1885 */
Jan Kundrátc53a7ec2021-12-09 16:01:19 +01001886LIBYANG_API_DECL const struct lysc_node *lysc_node_child(const struct lysc_node *node);
Michal Vasko2a668712020-10-21 11:48:09 +02001887
1888/**
Radek Krejci9a3823e2021-01-27 20:26:46 +01001889 * @brief Get the must statements list if present in the @p node
1890 *
1891 * @param[in] node Node to examine.
1892 * @return Pointer to the list of must restrictions ([sized array](@ref sizedarrays))
1893 * @return NULL if there is no must statement in the node, no matter if it is not even allowed or just present
1894 */
Jan Kundrátc53a7ec2021-12-09 16:01:19 +01001895LIBYANG_API_DECL struct lysc_must *lysc_node_musts(const struct lysc_node *node);
Radek Krejci9a3823e2021-01-27 20:26:46 +01001896
1897/**
1898 * @brief Get the when statements list if present in the @p node
1899 *
1900 * @param[in] node Node to examine.
1901 * @return Pointer to the list of pointers to when statements ([sized array](@ref sizedarrays))
1902 * @return NULL if there is no when statement in the node, no matter if it is not even allowed or just present
1903 */
Jan Kundrátc53a7ec2021-12-09 16:01:19 +01001904LIBYANG_API_DECL struct lysc_when **lysc_node_when(const struct lysc_node *node);
Radek Krejci9a3823e2021-01-27 20:26:46 +01001905
1906/**
Michal Vasko510554a2023-09-11 09:03:29 +02001907 * @brief Get the target node of a leafref node.
1908 *
1909 * @param[in] node Leafref node.
1910 * @return Leafref target, NULL on any error.
1911 */
1912LIBYANG_API_DECL const struct lysc_node *lysc_node_lref_target(const struct lysc_node *node);
1913
1914/**
Michal Vaskof1ab44f2020-10-22 08:58:32 +02001915 * @brief Callback to be called for every schema node in a DFS traversal.
1916 *
1917 * @param[in] node Current node.
1918 * @param[in] data Arbitrary user data.
1919 * @param[out] dfs_continue Set to true if the current subtree should be skipped and continue with siblings instead.
1920 * @return LY_SUCCESS on success,
1921 * @return LY_ERR value to terminate DFS and return this value.
1922 */
Michal Vasko8f07dfe2021-03-02 16:10:24 +01001923typedef LY_ERR (*lysc_dfs_clb)(struct lysc_node *node, void *data, ly_bool *dfs_continue);
Michal Vaskof1ab44f2020-10-22 08:58:32 +02001924
1925/**
1926 * @brief DFS traversal of all the schema nodes in a (sub)tree including any actions and nested notifications.
1927 *
1928 * Node with children, actions, and notifications is traversed in this order:
1929 * 1) each child subtree;
1930 * 2) each action subtree;
1931 * 3) each notification subtree.
1932 *
1933 * For algorithm illustration or traversal with actions and notifications skipped, see ::LYSC_TREE_DFS_BEGIN.
1934 *
1935 * @param[in] root Schema root to fully traverse.
1936 * @param[in] dfs_clb Callback to call for each node.
1937 * @param[in] data Arbitrary user data passed to @p dfs_clb.
1938 * @return LY_SUCCESS on success,
1939 * @return LY_ERR value returned by @p dfs_clb.
1940 */
Jan Kundrátc53a7ec2021-12-09 16:01:19 +01001941LIBYANG_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 +02001942
1943/**
1944 * @brief DFS traversal of all the schema nodes in a module including RPCs and notifications.
1945 *
1946 * For more details, see ::lysc_tree_dfs_full().
1947 *
1948 * @param[in] mod Module to fully traverse.
1949 * @param[in] dfs_clb Callback to call for each node.
1950 * @param[in] data Arbitrary user data passed to @p dfs_clb.
1951 * @return LY_SUCCESS on success,
1952 * @return LY_ERR value returned by @p dfs_clb.
1953 */
Jan Kundrátc53a7ec2021-12-09 16:01:19 +01001954LIBYANG_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 +02001955
1956/**
Radek Krejci151a5b72018-10-19 14:21:44 +02001957 * @brief Get how the if-feature statement currently evaluates.
1958 *
1959 * @param[in] iff Compiled if-feature statement to evaluate.
Michal Vasko28d78432020-05-26 13:10:53 +02001960 * @return LY_SUCCESS if the statement evaluates to true,
1961 * @return LY_ENOT if it evaluates to false,
1962 * @return LY_ERR on error.
Radek Krejci151a5b72018-10-19 14:21:44 +02001963 */
Jan Kundrátc53a7ec2021-12-09 16:01:19 +01001964LIBYANG_API_DECL LY_ERR lysc_iffeature_value(const struct lysc_iffeature *iff);
Radek Krejci151a5b72018-10-19 14:21:44 +02001965
1966/**
aPiecekf4a0a192021-08-03 15:14:17 +02001967 * @brief Get how the if-feature statement is evaluated for certain identity.
1968 *
1969 * The function can be called even if the identity does not contain
1970 * if-features, in which case ::LY_SUCCESS is returned.
1971 *
1972 * @param[in] ident Compiled identity statement to evaluate.
1973 * @return LY_SUCCESS if the statement evaluates to true,
1974 * @return LY_ENOT if it evaluates to false,
1975 * @return LY_ERR on error.
1976 */
Jan Kundrátc53a7ec2021-12-09 16:01:19 +01001977LIBYANG_API_DECL LY_ERR lys_identity_iffeature_value(const struct lysc_ident *ident);
aPiecekf4a0a192021-08-03 15:14:17 +02001978
1979/**
Michal Vasko7b1ad1a2020-11-02 15:41:27 +01001980 * @brief Get the next feature in the module or submodules.
Radek Krejci151a5b72018-10-19 14:21:44 +02001981 *
Michal Vasko7b1ad1a2020-11-02 15:41:27 +01001982 * @param[in] last Last returned feature.
Michal Vasko4ec4bc02021-10-12 10:17:28 +02001983 * @param[in] pmod Parsed module and submodules whose features to iterate over.
Michal Vasko7b1ad1a2020-11-02 15:41:27 +01001984 * @param[in,out] idx Submodule index, set to 0 on first call.
1985 * @return Next found feature, NULL if the last has already been returned.
Radek Krejci151a5b72018-10-19 14:21:44 +02001986 */
Michal Vaskoc1a0ff62022-02-28 14:27:16 +01001987LIBYANG_API_DECL struct lysp_feature *lysp_feature_next(const struct lysp_feature *last, const struct lysp_module *pmod,
1988 uint32_t *idx);
Radek Krejci151a5b72018-10-19 14:21:44 +02001989
Radek Krejcibed13942020-10-19 16:06:28 +02001990/**
1991 * @defgroup findxpathoptions Atomize XPath options
1992 * Options to modify behavior of ::lys_find_xpath() and ::lys_find_xpath_atoms() searching for schema nodes in schema tree.
1993 * @{
1994 */
Michal Vasko4ad69e72021-10-26 16:25:55 +02001995#define LYS_FIND_XP_SCHEMA 0x08 /**< Apply node access restrictions defined for 'when' and 'must' evaluation. */
1996#define LYS_FIND_XP_OUTPUT 0x10 /**< Search RPC/action output nodes instead of input ones. */
Michal Vaskoa2fe0812022-05-26 09:24:32 +02001997#define LYS_FIND_NO_MATCH_ERROR 0x40 /**< Return error if a path segment matches no nodes, otherwise only warning
Michal Vasko4ad69e72021-10-26 16:25:55 +02001998 is printed. */
Michal Vaskoe482bb92023-02-01 11:41:41 +01001999#define LYS_FIND_SCHEMAMOUNT 0x0200 /**< Traverse also nodes from mounted modules. If any such nodes are returned,
2000 the caller **must free** their context! */
Radek Krejci576f8fa2020-10-26 21:23:58 +01002001/** @} findxpathoptions */
Michal Vasko072de482020-08-05 13:27:21 +02002002
Radek Krejci151a5b72018-10-19 14:21:44 +02002003/**
Michal Vasko40308e72020-10-20 16:38:40 +02002004 * @brief Get all the schema nodes that are required for @p xpath to be evaluated (atoms).
Michal Vasko519fd602020-05-26 12:17:39 +02002005 *
Michal Vasko26512682021-01-11 11:35:40 +01002006 * @param[in] ctx libyang context to use. May be NULL if @p ctx_node is set.
2007 * @param[in] ctx_node XPath schema context node. Use NULL for the root node.
Radek Krejci8df109d2021-04-23 12:19:08 +02002008 * @param[in] xpath Data XPath expression filtering the matching nodes. ::LY_VALUE_JSON prefix format is expected.
Radek Krejcibed13942020-10-19 16:06:28 +02002009 * @param[in] options Whether to apply some node access restrictions, see @ref findxpathoptions.
Michal Vasko519fd602020-05-26 12:17:39 +02002010 * @param[out] set Set of found atoms (schema nodes).
2011 * @return LY_SUCCESS on success, @p set is returned.
Michal Vasko40308e72020-10-20 16:38:40 +02002012 * @return LY_ERR value on error.
Michal Vasko519fd602020-05-26 12:17:39 +02002013 */
Jan Kundrátc53a7ec2021-12-09 16:01:19 +01002014LIBYANG_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 +01002015 uint32_t options, struct ly_set **set);
Michal Vasko519fd602020-05-26 12:17:39 +02002016
Michal Vasko072de482020-08-05 13:27:21 +02002017/**
Michal Vasko40308e72020-10-20 16:38:40 +02002018 * @brief Get all the schema nodes that are required for @p expr to be evaluated (atoms).
Michal Vasko072de482020-08-05 13:27:21 +02002019 *
Michal Vasko26512682021-01-11 11:35:40 +01002020 * @param[in] ctx_node XPath schema context node. Use NULL for the root node.
Michal Vasko40308e72020-10-20 16:38:40 +02002021 * @param[in] cur_mod Current module for the expression (where it was "instantiated").
2022 * @param[in] expr Parsed expression to use.
2023 * @param[in] prefixes Sized array of compiled prefixes.
2024 * @param[in] options Whether to apply some node access restrictions, see @ref findxpathoptions.
2025 * @param[out] set Set of found atoms (schema nodes).
2026 * @return LY_SUCCESS on success, @p set is returned.
2027 * @return LY_ERR value on error.
2028 */
Jan Kundrátc53a7ec2021-12-09 16:01:19 +01002029LIBYANG_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 +02002030 const struct lyxp_expr *expr, const struct lysc_prefix *prefixes, uint32_t options, struct ly_set **set);
2031
2032/**
2033 * @brief Evaluate an @p xpath expression on schema nodes.
2034 *
Michal Vasko26512682021-01-11 11:35:40 +01002035 * @param[in] ctx libyang context to use for absolute @p xpath. May be NULL if @p ctx_node is set.
2036 * @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 +02002037 * @param[in] xpath Data XPath expression filtering the matching nodes. ::LY_VALUE_JSON prefix format is expected.
Radek Krejcibed13942020-10-19 16:06:28 +02002038 * @param[in] options Whether to apply some node access restrictions, see @ref findxpathoptions.
Michal Vasko072de482020-08-05 13:27:21 +02002039 * @param[out] set Set of found schema nodes.
2040 * @return LY_SUCCESS on success, @p set is returned.
2041 * @return LY_ERR value if an error occurred.
2042 */
Michal Vaskoc1a0ff62022-02-28 14:27:16 +01002043LIBYANG_API_DECL LY_ERR lys_find_xpath(const struct ly_ctx *ctx, const struct lysc_node *ctx_node, const char *xpath,
2044 uint32_t options, struct ly_set **set);
Michal Vasko519fd602020-05-26 12:17:39 +02002045
2046/**
Radek Krejcibc5644c2020-10-27 14:53:17 +01002047 * @brief Get all the schema nodes that are required for @p path to be evaluated (atoms).
2048 *
2049 * @param[in] path Compiled path to use.
2050 * @param[out] set Set of found atoms (schema nodes).
2051 * @return LY_SUCCESS on success, @p set is returned.
2052 * @return LY_ERR value on error.
2053 */
Jan Kundrátc53a7ec2021-12-09 16:01:19 +01002054LIBYANG_API_DECL LY_ERR lys_find_lypath_atoms(const struct ly_path *path, struct ly_set **set);
Radek Krejcibc5644c2020-10-27 14:53:17 +01002055
2056/**
2057 * @brief Get all the schema nodes that are required for @p path to be evaluated (atoms).
2058 *
Michal Vasko26512682021-01-11 11:35:40 +01002059 * @param[in] ctx libyang context to use for absolute @p path. May be NULL if @p ctx_node is set.
2060 * @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 +01002061 * @param[in] path JSON path to examine.
2062 * @param[in] output Search operation output instead of input.
2063 * @param[out] set Set of found atoms (schema nodes).
2064 * @return LY_ERR value on error.
2065 */
Michal Vaskoc1a0ff62022-02-28 14:27:16 +01002066LIBYANG_API_DECL LY_ERR lys_find_path_atoms(const struct ly_ctx *ctx, const struct lysc_node *ctx_node, const char *path,
2067 ly_bool output, struct ly_set **set);
Radek Krejcibc5644c2020-10-27 14:53:17 +01002068
2069/**
2070 * @brief Get a schema node based on the given data path (JSON format, see @ref howtoXPath).
2071 *
Michal Vasko26512682021-01-11 11:35:40 +01002072 * @param[in] ctx libyang context to use for absolute @p path. May be NULL if @p ctx_node is set.
2073 * @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 +01002074 * @param[in] path JSON path of the node to get.
2075 * @param[in] output Search operation output instead of input.
2076 * @return Found schema node or NULL.
2077 */
Michal Vaskoc1a0ff62022-02-28 14:27:16 +01002078LIBYANG_API_DECL const struct lysc_node *lys_find_path(const struct ly_ctx *ctx, const struct lysc_node *ctx_node,
2079 const char *path, ly_bool output);
Radek Krejcibc5644c2020-10-27 14:53:17 +01002080
2081/**
Michal Vasko03ff5a72019-09-11 13:49:33 +02002082 * @brief Types of the different schema paths.
2083 */
2084typedef enum {
Michal Vasko65de0402020-08-03 16:34:19 +02002085 LYSC_PATH_LOG, /**< Descriptive path format used in log messages */
Michal Vaskobde22b62022-03-22 15:32:56 +01002086 LYSC_PATH_DATA, /**< Similar to ::LYSC_PATH_LOG except that schema-only nodes (choice, case) are skipped */
2087 LYSC_PATH_DATA_PATTERN /**< Similar to ::LYSC_PATH_DATA but there are predicates for all list keys added with
2088 "%s" where their values should be so that they can be printed there */
Michal Vasko03ff5a72019-09-11 13:49:33 +02002089} LYSC_PATH_TYPE;
2090
2091/**
Radek Krejci327de162019-06-14 12:52:07 +02002092 * @brief Generate path of the given node in the requested format.
2093 *
2094 * @param[in] node Schema path of this node will be generated.
2095 * @param[in] pathtype Format of the path to generate.
Radek Krejci1c0c3442019-07-23 16:08:47 +02002096 * @param[in,out] buffer Prepared buffer of the @p buflen length to store the generated path.
2097 * If NULL, memory for the complete path is allocated.
2098 * @param[in] buflen Size of the provided @p buffer.
Radek Krejci327de162019-06-14 12:52:07 +02002099 * @return NULL in case of memory allocation error, path of the node otherwise.
Radek Krejci1c0c3442019-07-23 16:08:47 +02002100 * 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 +02002101 */
Jan Kundrátc53a7ec2021-12-09 16:01:19 +01002102LIBYANG_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 +02002103
2104/**
Radek Krejci5aeea3a2018-09-05 13:29:36 +02002105 * @brief Available YANG schema tree structures representing YANG module.
2106 */
2107struct lys_module {
Radek Krejci0bcdaed2019-01-10 10:21:34 +01002108 struct ly_ctx *ctx; /**< libyang context of the module (mandatory) */
2109 const char *name; /**< name of the module (mandatory) */
Radek Krejci0af46292019-01-11 16:02:31 +01002110 const char *revision; /**< revision of the module (if present) */
Radek Krejci0bcdaed2019-01-10 10:21:34 +01002111 const char *ns; /**< namespace of the module (module - mandatory) */
2112 const char *prefix; /**< module prefix or submodule belongsto prefix of main module (mandatory) */
2113 const char *filepath; /**< path, if the schema was read from a file, NULL in case of reading from memory */
2114 const char *org; /**< party/company responsible for the module */
2115 const char *contact; /**< contact information for the module */
2116 const char *dsc; /**< description of the module */
2117 const char *ref; /**< cross-reference for the module */
2118
Radek Krejci5aeea3a2018-09-05 13:29:36 +02002119 struct lysp_module *parsed; /**< Simply parsed (unresolved) YANG schema tree */
Radek Krejci0af46292019-01-11 16:02:31 +01002120 struct lysc_module *compiled; /**< Compiled and fully validated YANG schema tree for data parsing.
2121 Available only for implemented modules. */
Michal Vasko7f45cf22020-10-01 12:49:44 +02002122
Radek Krejci80d281e2020-09-14 17:42:54 +02002123 struct lysc_ident *identities; /**< List of compiled identities of the module ([sized array](@ref sizedarrays))
aPiecek6b3d5422021-07-30 15:55:43 +02002124 also contains the disabled identities when their if-feature(s) are evaluated to \"false\",
2125 and also the list is filled even if the module is not implemented.
2126 The list is located here because it avoids problems when the module became implemented in
Radek Krejci80d281e2020-09-14 17:42:54 +02002127 future (no matter if implicitly via augment/deviate or explicitly via
2128 ::lys_set_implemented()). Note that if the module is not implemented (compiled), the
2129 identities cannot be instantiated in data (in identityrefs). */
Michal Vasko7f45cf22020-10-01 12:49:44 +02002130
2131 struct lys_module **augmented_by;/**< List of modules that augment this module ([sized array](@ref sizedarrays)) */
2132 struct lys_module **deviated_by; /**< List of modules that deviate this module ([sized array](@ref sizedarrays)) */
2133
Michal Vasko89b5c072020-10-06 13:52:44 +02002134 ly_bool implemented; /**< flag if the module is implemented, not just imported */
Michal Vasko01db7de2021-04-16 12:23:30 +02002135 ly_bool to_compile; /**< flag marking a module that was changed but not (re)compiled, see
2136 ::LY_CTX_EXPLICIT_COMPILE. */
aPiecek8ca21bd2021-07-26 14:31:01 +02002137 uint8_t latest_revision; /**< Flag to mark the latest available revision, see [latest_revision options](@ref latestrevflags). */
Radek Krejci5aeea3a2018-09-05 13:29:36 +02002138};
2139
Radek Krejci151a5b72018-10-19 14:21:44 +02002140/**
aPiecek8ca21bd2021-07-26 14:31:01 +02002141 * @defgroup latestrevflags Options for ::lys_module.latest_revision.
2142 *
2143 * Various information bits of ::lys_module.latest_revision.
2144 *
2145 * @{
2146 */
aPiecek94d330b2021-08-04 11:57:31 +02002147#define LYS_MOD_LATEST_REV 0x01 /**< This is the latest revision of the module in the current context. */
2148#define LYS_MOD_LATEST_SEARCHDIRS 0x02 /**< This is the latest revision of the module found in searchdirs. */
Michal Vaskobdac23f2022-01-12 14:02:35 +01002149#define LYS_MOD_IMPORTED_REV 0x04 /**< This is the module revision used when importing the module without
2150 an explicit revision-date. It is used for all such imports regardless of
2151 any changes made in the context. */
2152#define LYS_MOD_LATEST_IMPCLB 0x08 /**< This is the latest revision of the module obtained from import callback. */
aPiecek8ca21bd2021-07-26 14:31:01 +02002153/** @} latestrevflags */
2154
2155/**
Michal Vasko82c31e62020-07-17 15:30:40 +02002156 * @brief Get the current real status of the specified feature in the module.
2157 *
2158 * If the feature is enabled, but some of its if-features are false, the feature is considered
2159 * disabled.
Radek Krejci151a5b72018-10-19 14:21:44 +02002160 *
2161 * @param[in] module Module where the feature is defined.
2162 * @param[in] feature Name of the feature to inspect.
Michal Vasko82c31e62020-07-17 15:30:40 +02002163 * @return LY_SUCCESS if the feature is enabled,
2164 * @return LY_ENOT if the feature is disabled,
2165 * @return LY_ENOTFOUND if the feature was not found.
Radek Krejci151a5b72018-10-19 14:21:44 +02002166 */
Jan Kundrátc53a7ec2021-12-09 16:01:19 +01002167LIBYANG_API_DECL LY_ERR lys_feature_value(const struct lys_module *module, const char *feature);
Radek Krejcidd4e8d42018-10-16 14:55:43 +02002168
2169/**
Michal Vasko3608d252022-02-28 14:28:12 +01002170 * @brief Get next schema (sibling) node element in the schema order that can be instantiated in a data tree.
2171 * Returned node may be from an augment.
Radek Krejcia3045382018-11-22 14:30:31 +01002172 *
Michal Vasko3608d252022-02-28 14:28:12 +01002173 * ::lys_getnext() is supposed to be called sequentially. In the first call, the @p last parameter is usually NULL
2174 * and function starts returning 1) the first @p parent child (if it is set) or 2) the first top level element of
2175 * @p module. Consequent calls should provide the previously returned node as @p last and the same @p parent and
2176 * @p module parameters.
Radek Krejcia3045382018-11-22 14:30:31 +01002177 *
2178 * 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 +01002179 * 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 +01002180 * all the schema nodes are iteratively returned.
2181 *
2182 * @param[in] last Previously returned schema tree node, or NULL in case of the first call.
Michal Vasko3608d252022-02-28 14:28:12 +01002183 * @param[in] parent Parent of the subtree to iterate over. If set, @p module is ignored.
2184 * @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 +01002185 * @param[in] options [ORed options](@ref sgetnextflags).
Michal Vasko3608d252022-02-28 14:28:12 +01002186 * @return Next schema tree node, NULL in case there are no more.
Radek Krejcia3045382018-11-22 14:30:31 +01002187 */
Jan Kundrátc53a7ec2021-12-09 16:01:19 +01002188LIBYANG_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 +02002189 const struct lysc_module *module, uint32_t options);
Radek Krejcia3045382018-11-22 14:30:31 +01002190
2191/**
Michal Vasko3608d252022-02-28 14:28:12 +01002192 * @brief Get next schema (sibling) node element in the schema order of an extension that can be instantiated in
2193 * a data tree.
Radek Krejci8678fa42020-08-18 16:07:28 +02002194 *
Michal Vasko3608d252022-02-28 14:28:12 +01002195 * It is just ::lys_getnext() for extensions.
Radek Krejci035dacf2021-02-12 18:25:53 +01002196 *
2197 * @param[in] last Previously returned schema tree node, or NULL in case of the first call.
Michal Vasko3608d252022-02-28 14:28:12 +01002198 * @param[in] parent Parent of the subtree to iterate over. If set, @p ext is ignored.
2199 * @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 +01002200 * @param[in] options [ORed options](@ref sgetnextflags).
Michal Vasko3608d252022-02-28 14:28:12 +01002201 * @return Next schema tree node, NULL in case there are no more.
Radek Krejci035dacf2021-02-12 18:25:53 +01002202 */
Jan Kundrátc53a7ec2021-12-09 16:01:19 +01002203LIBYANG_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 +01002204 const struct lysc_ext_instance *ext, uint32_t options);
2205
2206/**
2207 * @defgroup sgetnextflags Options for ::lys_getnext() and ::lys_getnext_ext().
2208 *
2209 * Various options setting behavior of ::lys_getnext() and ::lys_getnext_ext().
Radek Krejci8678fa42020-08-18 16:07:28 +02002210 *
Radek Krejcia3045382018-11-22 14:30:31 +01002211 * @{
2212 */
Radek Krejci8678fa42020-08-18 16:07:28 +02002213#define LYS_GETNEXT_WITHCHOICE 0x01 /**< ::lys_getnext() option to allow returning #LYS_CHOICE nodes instead of looking into them */
2214#define LYS_GETNEXT_NOCHOICE 0x02 /**< ::lys_getnext() option to ignore (kind of conditional) nodes within choice node */
2215#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 +01002216#define LYS_GETNEXT_INTONPCONT 0x08 /**< ::lys_getnext() option to look into non-presence container, instead of returning container itself */
2217#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 +01002218 provided by default */
Michal Vaskoe482bb92023-02-01 11:41:41 +01002219#define LYS_GETNEXT_WITHSCHEMAMOUNT 0x20 /**< ::lys_getnext() option to also traverse top-level nodes of all the mounted modules
2220 on the parent mount point but note that if any such nodes are returned,
2221 the caller **must free** their context */
Radek Krejcia3045382018-11-22 14:30:31 +01002222/** @} sgetnextflags */
2223
2224/**
2225 * @brief Get child node according to the specified criteria.
2226 *
2227 * @param[in] parent Optional parent of the node to find. If not specified, the module's top-level nodes are searched.
2228 * @param[in] module module of the node to find. It is also limitation for the children node of the given parent.
2229 * @param[in] name Name of the node to find.
2230 * @param[in] name_len Optional length of the name in case it is not NULL-terminated string.
2231 * @param[in] nodetype Optional criteria (to speedup) specifying nodetype(s) of the node to find.
2232 * Used as a bitmask, so multiple nodetypes can be specified.
2233 * @param[in] options [ORed options](@ref sgetnextflags).
2234 * @return Found node if any.
2235 */
Jan Kundrátc53a7ec2021-12-09 16:01:19 +01002236LIBYANG_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 +02002237 const char *name, size_t name_len, uint16_t nodetype, uint32_t options);
Radek Krejcia3045382018-11-22 14:30:31 +01002238
2239/**
Radek Krejci77a8bcd2019-09-11 11:20:02 +02002240 * @brief Make the specific module implemented.
2241 *
Michal Vaskoe8988e92021-01-25 11:26:29 +01002242 * If the module is already implemented but with a different set of features, the whole context is recompiled.
2243 *
Radek Krejci77a8bcd2019-09-11 11:20:02 +02002244 * @param[in] mod Module to make implemented. It is not an error
2245 * to provide already implemented module, it just does nothing.
Michal Vaskoe8988e92021-01-25 11:26:29 +01002246 * @param[in] features Optional array specifying the enabled features terminated with NULL overriding any previous
2247 * feature setting. The feature string '*' enables all the features and array of length 1 with only the terminating
2248 * NULL explicitly disables all the features. In case the parameter is NULL, the features are untouched - left disabled
2249 * 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 +01002250 * @return LY_SUCCESS on success.
2251 * @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 +01002252 * @return LY_ERR on other errors during module compilation.
Radek Krejci77a8bcd2019-09-11 11:20:02 +02002253 */
Jan Kundrátc53a7ec2021-12-09 16:01:19 +01002254LIBYANG_API_DECL LY_ERR lys_set_implemented(struct lys_module *mod, const char **features);
Radek Krejcia3045382018-11-22 14:30:31 +01002255
Radek Krejci084289f2019-07-09 17:35:30 +02002256/**
Radek Krejci0935f412019-08-20 16:15:18 +02002257 * @brief Stringify schema nodetype.
Michal Vaskod43d71a2020-08-07 14:54:58 +02002258 *
Radek Krejci0935f412019-08-20 16:15:18 +02002259 * @param[in] nodetype Nodetype to stringify.
2260 * @return Constant string with the name of the node's type.
2261 */
Jan Kundrátc53a7ec2021-12-09 16:01:19 +01002262LIBYANG_API_DECL const char *lys_nodetype2str(uint16_t nodetype);
Radek Krejci0935f412019-08-20 16:15:18 +02002263
Michal Vaskod43d71a2020-08-07 14:54:58 +02002264/**
2265 * @brief Getter for original XPath expression from a parsed expression.
2266 *
2267 * @param[in] path Parsed expression.
2268 * @return Original string expression.
2269 */
Jan Kundrátc53a7ec2021-12-09 16:01:19 +01002270LIBYANG_API_DECL const char *lyxp_get_expr(const struct lyxp_expr *path);
Michal Vaskod43d71a2020-08-07 14:54:58 +02002271
Radek Krejci2ff0d572020-05-21 15:27:28 +02002272/** @} schematree */
Radek Krejci5aeea3a2018-09-05 13:29:36 +02002273
Radek Krejci70853c52018-10-15 14:46:16 +02002274#ifdef __cplusplus
2275}
2276#endif
2277
Radek Krejci5aeea3a2018-09-05 13:29:36 +02002278#endif /* LY_TREE_SCHEMA_H_ */