blob: fab6f2ba52b554689d2d34dd522d0206cdbebd6e [file] [log] [blame]
Radek Krejci70853c52018-10-15 14:46:16 +02001/**
2 * @file tree_schema_internal.h
3 * @author Radek Krejci <rkrejci@cesnet.cz>
4 * @brief internal functions for YANG schema trees.
5 *
Michal Vaskodd992582021-06-10 14:34:57 +02006 * Copyright (c) 2015 - 2021 CESNET, z.s.p.o.
Radek Krejci70853c52018-10-15 14:46:16 +02007 *
8 * This source code is licensed under BSD 3-Clause License (the "License").
9 * You may not use this file except in compliance with the License.
10 * You may obtain a copy of the License at
11 *
12 * https://opensource.org/licenses/BSD-3-Clause
13 */
14
15#ifndef LY_TREE_SCHEMA_INTERNAL_H_
16#define LY_TREE_SCHEMA_INTERNAL_H_
17
Radek Krejci2d7a47b2019-05-16 13:34:10 +020018#include <stdint.h>
19
Radek Krejci535ea9f2020-05-29 16:01:05 +020020#include "common.h"
Radek Krejci2d7a47b2019-05-16 13:34:10 +020021#include "set.h"
22#include "tree_schema.h"
David Sedlákebd3acf2019-07-26 15:04:32 +020023#include "xml.h"
Radek Krejci2d7a47b2019-05-16 13:34:10 +020024
Michal Vasko1a7a7bd2020-10-16 14:39:15 +020025struct lysc_ctx;
Michal Vasko405cc9e2020-12-01 12:01:27 +010026struct lys_glob_unres;
Michal Vasko1a7a7bd2020-10-16 14:39:15 +020027
Radek Krejcif13b87b2020-12-01 22:02:17 +010028#define LY_YANG_SUFFIX ".yang"
29#define LY_YANG_SUFFIX_LEN 5
30#define LY_YIN_SUFFIX ".yin"
31#define LY_YIN_SUFFIX_LEN 4
32
FredGand944bdc2019-11-05 21:57:07 +080033#define YIN_NS_URI "urn:ietf:params:xml:ns:yang:yin:1"
34
Radek Krejcif13b87b2020-12-01 22:02:17 +010035#define LY_PCRE2_MSG_LIMIT 256
36
Radek Krejci335332a2019-09-05 13:03:35 +020037/**
aPiecek93582ed2021-05-25 14:49:06 +020038 * @brief The maximum depth at which the last nested block is located.
39 * Designed to protect against corrupted input that causes a stack-overflow error.
40 * For yang language and json format, the block is bounded by "{ }".
41 * For the xml format, the opening and closing element tag is considered as the block.
42 */
43#define LY_MAX_BLOCK_DEPTH 500
44
45/**
Radek Krejcieccf6602021-02-05 19:42:54 +010046 * @brief Informational structure for YANG statements
47 */
48struct stmt_info_s {
49 const char *name; /**< name of the statement */
50 const char *arg; /**< name of YIN's attribute to present the statement */
51 uint8_t flags; /**< various flags to clarify printing of the statement */
52#define STMT_FLAG_YIN 0x1 /**< has YIN element */
53#define STMT_FLAG_ID 0x2 /**< the value is identifier -> no quotes */
54};
55
56/* statements informations filled in tree_schema.c */
57extern struct stmt_info_s stmt_attr_info[];
58
Radek Krejcieccf6602021-02-05 19:42:54 +010059/* list of the deviate modifications strings */
60extern const char * const ly_devmod_list[];
61#define ly_devmod2str(TYPE) ly_devmod_list[TYPE]
62
63/**
Radek Krejci335332a2019-09-05 13:03:35 +020064 * @brief Check module version is at least 2 (YANG 1.1) because of the keyword presence.
65 * Logs error message and returns LY_EVALID in case of module in YANG version 1.0.
66 * @param[in] CTX yang parser context to get current module and for logging.
67 * @param[in] KW keyword allowed only in YANG version 1.1 (or later) - for logging.
68 * @param[in] PARENT parent statement where the KW is present - for logging.
69 */
70#define PARSER_CHECK_STMTVER2_RET(CTX, KW, PARENT) \
Michal Vasko5d24f6c2020-10-13 13:49:06 +020071 if ((CTX)->parsed_mod->version < LYS_VERSION_1_1) {LOGVAL_PARSER((CTX), LY_VCODE_INCHILDSTMT2, KW, PARENT); return LY_EVALID;}
Radek Krejcid33273d2018-10-25 14:55:52 +020072
Radek Krejcia9026eb2018-12-12 16:04:47 +010073/* These 2 macros checks YANG's identifier grammar rule */
74#define is_yangidentstartchar(c) ((c >= 'a' && c <= 'z') || (c >= 'A' && c <= 'Z') || c == '_')
75#define is_yangidentchar(c) ((c >= 'a' && c <= 'z') || (c >= 'A' && c <= 'Z') || (c >= '0' && c <= '9') || \
David Sedlákebd3acf2019-07-26 15:04:32 +020076 c == '_' || c == '-' || c == '.')
Radek Krejcia9026eb2018-12-12 16:04:47 +010077
David Sedlák4a650532019-07-10 11:55:18 +020078/* Macro to check YANG's yang-char grammar rule */
David Sedlák2c0d5ef2019-08-14 11:40:44 +020079#define is_yangutf8char(c) ((c >= 0x20 && c <= 0xd7ff) || c == 0x09 || c == 0x0a || c == 0x0d || \
David Sedlák4a650532019-07-10 11:55:18 +020080 (c >= 0xe000 && c <= 0xfdcf) || (c >= 0xfdf0 && c <= 0xfffd) || \
81 (c >= 0x10000 && c <= 0x1fffd) || (c >= 0x20000 && c <= 0x2fffd) || \
82 (c >= 0x30000 && c <= 0x3fffd) || (c >= 0x40000 && c <= 0x2fffd) || \
83 (c >= 0x50000 && c <= 0x5fffd) || (c >= 0x60000 && c <= 0x6fffd) || \
84 (c >= 0x70000 && c <= 0x7fffd) || (c >= 0x80000 && c <= 0x8fffd) || \
85 (c >= 0x90000 && c <= 0x9fffd) || (c >= 0xa0000 && c <= 0xafffd) || \
86 (c >= 0xb0000 && c <= 0xbfffd) || (c >= 0xc0000 && c <= 0xcfffd) || \
87 (c >= 0xd0000 && c <= 0xdfffd) || (c >= 0xe0000 && c <= 0xefffd) || \
88 (c >= 0xf0000 && c <= 0xffffd) || (c >= 0x100000 && c <= 0x10fffd))
89
Radek Krejci70853c52018-10-15 14:46:16 +020090/**
David Sedlákca36c422019-07-12 12:47:55 +020091 * @brief Try to find object with MEMBER string matching the IDENT in the given ARRAY.
92 * Macro logs an error message and returns LY_EVALID in case of existence of a matching object.
93 *
94 * @param[in] CTX yang parser context for logging.
95 * @param[in] ARRAY [sized array](@ref sizedarrays) of a generic objects with member named MEMBER to search.
96 * @param[in] MEMBER Name of the member of the objects in the ARRAY to compare.
97 * @param[in] STMT Name of the compared YANG statements for logging.
98 * @param[in] IDENT String trying to find in the ARRAY's objects inside the MEMBER member.
99 */
100#define CHECK_UNIQUENESS(CTX, ARRAY, MEMBER, STMT, IDENT) \
101 if (ARRAY) { \
Michal Vaskofd69e1d2020-07-03 11:57:17 +0200102 for (LY_ARRAY_COUNT_TYPE u_ = 0; u_ < LY_ARRAY_COUNT(ARRAY) - 1; ++u_) { \
Radek Krejci7eb54ba2020-05-18 16:30:04 +0200103 if (!strcmp((ARRAY)[u_].MEMBER, IDENT)) { \
David Sedlákca36c422019-07-12 12:47:55 +0200104 LOGVAL_PARSER(CTX, LY_VCODE_DUPIDENT, IDENT, STMT); \
105 return LY_EVALID; \
106 } \
107 } \
108 }
109
Michal Vaskob36053d2020-03-26 15:49:30 +0100110#define CHECK_NONEMPTY(CTX, VALUE_LEN, STMT) \
David Sedlák129a09c2019-07-12 14:08:34 +0200111 if (!VALUE_LEN) { \
Michal Vaskob36053d2020-03-26 15:49:30 +0100112 LOGWRN(PARSER_CTX(CTX), "Empty argument of %s statement does not make sense.", STMT); \
David Sedlák129a09c2019-07-12 14:08:34 +0200113 }
Radek Krejci70853c52018-10-15 14:46:16 +0200114
Radek Krejcif13b87b2020-12-01 22:02:17 +0100115/*
116 * Additional YANG constants
117 */
118#define Y_TAB_SPACES 8 /**< number of spaces instead of tab character */
119#define LY_TYPE_DEC64_FD_MAX 18 /**< Maximal value of decimal64's fraction-digits */
120
Radek Krejci70853c52018-10-15 14:46:16 +0200121/**
Radek Krejcie3846472018-10-15 15:24:51 +0200122 * @brief List of YANG statement groups - the (sub)module's substatements
123 */
124enum yang_module_stmt {
125 Y_MOD_MODULE_HEADER,
126 Y_MOD_LINKAGE,
127 Y_MOD_META,
128 Y_MOD_REVISION,
129 Y_MOD_BODY
130};
131
132/**
133 * @brief Types of arguments of YANG statements
134 */
135enum yang_arg {
136 Y_IDENTIF_ARG, /**< YANG "identifier-arg-str" rule */
Radek Krejcia9026eb2018-12-12 16:04:47 +0100137 Y_PREF_IDENTIF_ARG, /**< YANG "identifier-ref-arg-str" or node-identifier rule */
Radek Krejcie3846472018-10-15 15:24:51 +0200138 Y_STR_ARG, /**< YANG "string" rule */
139 Y_MAYBE_STR_ARG /**< optional YANG "string" rule */
140};
141
Michal Vasko5d24f6c2020-10-13 13:49:06 +0200142#define PARSER_CTX(CTX) ((CTX)->parsed_mod->mod->ctx)
Radek Krejci2efc45b2020-12-22 16:25:44 +0100143#define LOGVAL_PARSER(CTX, ...) LOGVAL((CTX) ? PARSER_CTX(CTX) : NULL, __VA_ARGS__)
Michal Vaskob36053d2020-03-26 15:49:30 +0100144
145struct lys_parser_ctx {
aPiecek8d4e75d2021-06-24 14:47:06 +0200146 LYS_INFORMAT format; /**< parser format */
147 struct ly_set tpdfs_nodes; /**< Set of nodes that contain typedef(s). Invalid in case of
148 submodule, use ::lys_parser_ctx.main_ctx instead. */
149 struct ly_set grps_nodes; /**< Set of nodes that contain grouping(s). Invalid in case of
aPiecek63e080d2021-06-29 13:53:28 +0200150 submodule, use ::lys_parser_ctx.main_ctx instead. */
aPiecek8d4e75d2021-06-24 14:47:06 +0200151 struct lysp_module *parsed_mod; /**< (sub)module being parsed */
152 struct lys_parser_ctx *main_ctx; /**< This pointer must not be NULL. If this context deals with the submodule,
153 then should be set to the context of the module to which it belongs,
154 otherwise it points to the beginning of this structure. */
Michal Vaskob36053d2020-03-26 15:49:30 +0100155};
156
Radek Krejcie3846472018-10-15 15:24:51 +0200157/**
David Sedlákebd3acf2019-07-26 15:04:32 +0200158 * @brief Internal context for yang schema parser.
Radek Krejci70853c52018-10-15 14:46:16 +0200159 */
Michal Vaskob36053d2020-03-26 15:49:30 +0100160struct lys_yang_parser_ctx {
aPiecek8d4e75d2021-06-24 14:47:06 +0200161 LYS_INFORMAT format; /**< parser format */
162 struct ly_set tpdfs_nodes; /**< Set of nodes that contain typedef(s). Invalid in case of
163 submodule, use ::lys_parser_ctx.main_ctx instead. */
164 struct ly_set grps_nodes; /**< Set of nodes that contain grouping(s). Invalid in case of
aPiecek63e080d2021-06-29 13:53:28 +0200165 submodule, use ::lys_parser_ctx.main_ctx instead. */
aPiecek8d4e75d2021-06-24 14:47:06 +0200166 struct lysp_module *parsed_mod; /**< (sub)module being parsed */
167 struct lys_parser_ctx *main_ctx; /**< This pointer must not be NULL. If this context deals with the submodule,
168 then should be set to the context of the module to which it belongs,
169 otherwise it points to the beginning of this structure. */
170 struct ly_in *in; /**< input handler for the parser */
171 uint64_t indent; /**< current position on the line for YANG indentation */
172 uint32_t depth; /**< current number of nested blocks, see ::LY_MAX_BLOCK_DEPTH */
Radek Krejci70853c52018-10-15 14:46:16 +0200173};
174
David Sedlákebd3acf2019-07-26 15:04:32 +0200175/**
176 * @brief free lys parser context.
177 */
Michal Vaskob36053d2020-03-26 15:49:30 +0100178void yang_parser_ctx_free(struct lys_yang_parser_ctx *ctx);
David Sedlákebd3acf2019-07-26 15:04:32 +0200179
180/**
181 * @brief Internal context for yin schema parser.
182 */
Michal Vaskob36053d2020-03-26 15:49:30 +0100183struct lys_yin_parser_ctx {
aPiecek8d4e75d2021-06-24 14:47:06 +0200184 LYS_INFORMAT format; /**< parser format */
185 struct ly_set tpdfs_nodes; /**< Set of nodes that contain typedef(s). Invalid in case of
186 submodule, use ::lys_parser_ctx.main_ctx instead. */
187 struct ly_set grps_nodes; /**< Set of nodes that contain grouping(s). Invalid in case of
aPiecek63e080d2021-06-29 13:53:28 +0200188 submodule, use ::lys_parser_ctx.main_ctx instead. */
aPiecek8d4e75d2021-06-24 14:47:06 +0200189 struct lysp_module *parsed_mod; /**< (sub)module being parsed */
190 struct lys_parser_ctx *main_ctx; /**< This pointer must not be NULL. If this context deals with the submodule,
191 then should be set to the context of the module to which it belongs,
192 otherwise it points to the beginning of this structure. */
193 struct lyxml_ctx *xmlctx; /**< context for xml parser */
David Sedlákebd3acf2019-07-26 15:04:32 +0200194};
195
196/**
197 * @brief free yin parser context
198 *
199 * @param[in] ctx Context to free.
200 */
Michal Vaskob36053d2020-03-26 15:49:30 +0100201void yin_parser_ctx_free(struct lys_yin_parser_ctx *ctx);
David Sedlákebd3acf2019-07-26 15:04:32 +0200202
Michal Vasko7f45cf22020-10-01 12:49:44 +0200203/**
David Sedlák4a650532019-07-10 11:55:18 +0200204 * @brief Check that \p c is valid UTF8 code point for YANG string.
205 *
Michal Vaskob36053d2020-03-26 15:49:30 +0100206 * @param[in] ctx parser context for logging.
David Sedlák4a650532019-07-10 11:55:18 +0200207 * @param[in] c UTF8 code point of a character to check.
208 * @return LY_ERR values.
209 */
Radek Krejci1deb5be2020-08-26 16:43:36 +0200210LY_ERR lysp_check_stringchar(struct lys_parser_ctx *ctx, uint32_t c);
David Sedlák4a650532019-07-10 11:55:18 +0200211
212/**
213 * @brief Check that \p c is valid UTF8 code point for YANG identifier.
214 *
Michal Vaskob36053d2020-03-26 15:49:30 +0100215 * @param[in] ctx parser context for logging.
David Sedlák4a650532019-07-10 11:55:18 +0200216 * @param[in] c UTF8 code point of a character to check.
217 * @param[in] first Flag to check the first character of an identifier, which is more restricted.
218 * @param[in,out] prefix Storage for internally used flag in case of possible prefixed identifiers:
219 * 0 - colon not yet found (no prefix)
220 * 1 - \p c is the colon character
221 * 2 - prefix already processed, now processing the identifier
222 *
223 * If the identifier cannot be prefixed, NULL is expected.
224 * @return LY_ERR values.
225 */
Radek Krejci857189e2020-09-01 13:26:36 +0200226LY_ERR lysp_check_identifierchar(struct lys_parser_ctx *ctx, uint32_t c, ly_bool first, uint8_t *prefix);
David Sedlák4a650532019-07-10 11:55:18 +0200227
228/**
Radek Krejci70853c52018-10-15 14:46:16 +0200229 * @brief Check the currently present prefixes in the module for collision with the new one.
230 *
Radek Krejcibbe09a92018-11-08 09:36:54 +0100231 * @param[in] ctx Context for logging.
Radek Krejci0bcdaed2019-01-10 10:21:34 +0100232 * @param[in] imports List of current imports of the module to check prefix collision.
233 * @param[in] module_prefix Prefix of the module to check collision.
Radek Krejci70853c52018-10-15 14:46:16 +0200234 * @param[in] value Newly added prefix value (including its location to distinguish collision with itself).
235 * @return LY_EEXIST when prefix is already used in the module, LY_SUCCESS otherwise
236 */
Radek Krejcie7b95092019-05-15 11:03:07 +0200237LY_ERR lysp_check_prefix(struct lys_parser_ctx *ctx, struct lysp_import *imports, const char *module_prefix, const char **value);
Radek Krejci70853c52018-10-15 14:46:16 +0200238
Radek Krejci86d106e2018-10-18 09:53:19 +0200239/**
240 * @brief Check date string (4DIGIT "-" 2DIGIT "-" 2DIGIT)
241 *
Radek Krejcibbe09a92018-11-08 09:36:54 +0100242 * @param[in] ctx Optional context for logging.
Radek Krejci86d106e2018-10-18 09:53:19 +0200243 * @param[in] date Date string to check (non-necessarily terminated by \0)
244 * @param[in] date_len Length of the date string, 10 expected.
245 * @param[in] stmt Statement name for error message.
246 * @return LY_ERR value.
247 */
Juraj Vijtiuk74dad9e2021-05-26 12:42:14 +0200248LY_ERR lysp_check_date(struct lys_parser_ctx *ctx, const char *date, size_t date_len, const char *stmt);
Radek Krejcibbe09a92018-11-08 09:36:54 +0100249
250/**
251 * @brief Check names of typedefs in the parsed module to detect collisions.
252 *
Radek Krejci0bcdaed2019-01-10 10:21:34 +0100253 * @param[in] ctx Parser context for logging and to maintain tpdfs_nodes
254 * @param[in] mod Module where the type is being defined.
Radek Krejcibbe09a92018-11-08 09:36:54 +0100255 * @return LY_ERR value.
256 */
Michal Vasko7b1ad1a2020-11-02 15:41:27 +0100257LY_ERR lysp_check_dup_typedefs(struct lys_parser_ctx *ctx, struct lysp_module *mod);
258
259/**
aPiecek63e080d2021-06-29 13:53:28 +0200260 * @brief Check names of groupings in the parsed module to detect collisions.
261 *
262 * @param[in] ctx Parser context for logging and to maintain grps_nodes.
263 * @param[in] mod Module where the type is being defined.
264 * @return LY_ERR value.
265 */
266LY_ERR lysp_check_dup_groupings(struct lys_parser_ctx *ctx, struct lysp_module *mod);
267
268/**
Michal Vasko7b1ad1a2020-11-02 15:41:27 +0100269 * @brief Check names of features in the parsed module and submodules to detect collisions.
270 *
271 * @param[in] ctx Parser context.
272 * @param[in] mod Module where the type is being defined.
273 * @return LY_ERR value.
274 */
275LY_ERR lysp_check_dup_features(struct lys_parser_ctx *ctx, struct lysp_module *mod);
276
277/**
278 * @brief Check names of identities in the parsed module and submodules to detect collisions.
279 *
280 * @param[in] ctx Parser context.
281 * @param[in] mod Module where the type is being defined.
282 * @return LY_ERR value.
283 */
284LY_ERR lysp_check_dup_identities(struct lys_parser_ctx *ctx, struct lysp_module *mod);
Radek Krejci86d106e2018-10-18 09:53:19 +0200285
286/**
287 * @brief Just move the newest revision into the first position, does not sort the rest
288 * @param[in] revs Sized-array of the revisions in a printable schema tree.
289 */
290void lysp_sort_revisions(struct lysp_revision *revs);
291
292/**
David Sedlák6544c182019-07-12 13:17:33 +0200293 * @brief Find type specified type definition.
Radek Krejcibbe09a92018-11-08 09:36:54 +0100294 *
295 * @param[in] id Name of the type including possible prefix. Module where the prefix is being searched is start_module.
296 * @param[in] start_node Context node where the type is being instantiated to be able to search typedefs in parents.
297 * @param[in] start_module Module where the type is being instantiated for search for typedefs.
Radek Krejci4f28eda2018-11-12 11:46:16 +0100298 * @param[out] type Built-in type identifier of the id. If #LY_TYPE_UNKNOWN, tpdf is expected to contain found YANG schema typedef statement.
Radek Krejcibbe09a92018-11-08 09:36:54 +0100299 * @param[out] tpdf Found type definition.
300 * @param[out] node Node where the found typedef is defined, NULL in case of a top-level typedef.
Radek Krejcibbe09a92018-11-08 09:36:54 +0100301 */
Michal Vaskoa99b3572021-02-01 11:54:58 +0100302LY_ERR lysp_type_find(const char *id, struct lysp_node *start_node, const struct lysp_module *start_module,
303 LY_DATA_TYPE *type, const struct lysp_tpdf **tpdf, struct lysp_node **node);
Radek Krejcibbe09a92018-11-08 09:36:54 +0100304
305/**
David Sedlák6544c182019-07-12 13:17:33 +0200306 * @brief Validate enum name.
307 *
308 * @param[in] ctx yang parser context for logging.
309 * @param[in] name String to check.
310 * @param[in] name_len Length of name.
311 *
312 * @return LY_ERR values
313 */
David Sedlák07869a52019-07-12 14:28:19 +0200314LY_ERR lysp_check_enum_name(struct lys_parser_ctx *ctx, const char *name, size_t name_len);
David Sedlák6544c182019-07-12 13:17:33 +0200315
316/**
Michal Vasko4e205e82021-06-08 14:01:47 +0200317 * @brief Find source data for a specific module, parse it, and add into the context.
Radek Krejci086c7132018-10-26 15:29:04 +0200318 *
319 * @param[in] ctx libyang context.
320 * @param[in] name Name of the module to load.
Radek Krejci84d7fd72021-07-14 18:32:21 +0200321 * @param[in] revision Optional revision of the module to load. If NULL, the newest revision is loaded.
Michal Vaskodd992582021-06-10 14:34:57 +0200322 * @param[in,out] new_mods Set of all the new mods added to the context. Includes this module and all of its imports.
Michal Vasko18a86e52021-04-16 11:50:13 +0200323 * @param[out] mod Created module structure.
Michal Vasko4e205e82021-06-08 14:01:47 +0200324 * @return LY_SUCCESS on success.
325 * @return LY_ERR on error.
Radek Krejci086c7132018-10-26 15:29:04 +0200326 */
Michal Vaskodd992582021-06-10 14:34:57 +0200327LY_ERR lys_parse_load(struct ly_ctx *ctx, const char *name, const char *revision, struct ly_set *new_mods,
Michal Vasko4e205e82021-06-08 14:01:47 +0200328 struct lys_module **mod);
Radek Krejci086c7132018-10-26 15:29:04 +0200329
330/**
Radek Krejci771928a2021-01-19 13:42:36 +0100331 * @brief Parse included submodules into the simply parsed YANG module.
332 *
333 * YANG 1.0 does not require the main module to include all the submodules. Therefore, parsing submodules can cause
334 * reallocating and extending the includes array in the main module by the submodules included only in submodules.
Radek Krejcid33273d2018-10-25 14:55:52 +0200335 *
Michal Vasko7c8439f2020-08-05 13:25:19 +0200336 * @param[in] pctx main parser context
Radek Krejci771928a2021-01-19 13:42:36 +0100337 * @param[in] pmod Parsed module with the includes array to be processed.
aPiecekc3e26142021-06-22 14:25:49 +0200338 * @param[in,out] new_mods Set of all the new mods added to the context. Includes this module and all of its imports.
Radek Krejcid33273d2018-10-25 14:55:52 +0200339 * @return LY_ERR value.
340 */
aPiecekc3e26142021-06-22 14:25:49 +0200341LY_ERR lysp_load_submodules(struct lys_parser_ctx *pctx, struct lysp_module *pmod, struct ly_set *new_mods);
Radek Krejcid33273d2018-10-25 14:55:52 +0200342
343/**
Michal Vasko7f45cf22020-10-01 12:49:44 +0200344 * @brief Free a parsed restriction.
345 *
346 * @param[in] ctx libyang context.
347 * @param[in] restr Restriction to free.
348 */
349void lysp_restr_free(struct ly_ctx *ctx, struct lysp_restr *restr);
350
351/**
352 * @brief Free a parsed qualified name.
353 *
354 * @param[in] ctx libyang context.
355 * @param[in] qname Qualified name to free.
356 */
357void lysp_qname_free(struct ly_ctx *ctx, struct lysp_qname *qname);
358
359/**
360 * @brief Free a parsed node.
361 *
362 * @param[in] ctx libyang context.
363 * @param[in] node Node to free.
364 */
365void lysp_node_free(struct ly_ctx *ctx, struct lysp_node *node);
366
367/**
Radek Krejcibbe09a92018-11-08 09:36:54 +0100368 * @brief Get address of a node's actions list if any.
Radek Krejcibbe09a92018-11-08 09:36:54 +0100369 * Decides the node's type and in case it has an actions list, returns its address.
Michal Vasko544e58a2021-01-28 14:33:41 +0100370 *
Radek Krejcibbe09a92018-11-08 09:36:54 +0100371 * @param[in] node Node to check.
372 * @return Address of the node's actions member if any, NULL otherwise.
373 */
Radek Krejci2a9fc652021-01-22 17:44:34 +0100374struct lysp_node_action **lysp_node_actions_p(struct lysp_node *node);
Radek Krejcibbe09a92018-11-08 09:36:54 +0100375
376/**
377 * @brief Get address of a node's notifications list if any.
Radek Krejcibbe09a92018-11-08 09:36:54 +0100378 * Decides the node's type and in case it has a notifications list, returns its address.
Michal Vasko544e58a2021-01-28 14:33:41 +0100379 *
Radek Krejcibbe09a92018-11-08 09:36:54 +0100380 * @param[in] node Node to check.
381 * @return Address of the node's notifs member if any, NULL otherwise.
382 */
Radek Krejci2a9fc652021-01-22 17:44:34 +0100383struct lysp_node_notif **lysp_node_notifs_p(struct lysp_node *node);
Radek Krejcibbe09a92018-11-08 09:36:54 +0100384
385/**
386 * @brief Get address of a node's child pointer if any.
Radek Krejcibbe09a92018-11-08 09:36:54 +0100387 * Decides the node's type and in case it has a children list, returns its address.
Michal Vasko544e58a2021-01-28 14:33:41 +0100388 *
Radek Krejcibbe09a92018-11-08 09:36:54 +0100389 * @param[in] node Node to check.
390 * @return Address of the node's child member if any, NULL otherwise.
391 */
Michal Vasko544e58a2021-01-28 14:33:41 +0100392struct lysp_node **lysp_node_child_p(struct lysp_node *node);
Radek Krejcibbe09a92018-11-08 09:36:54 +0100393
394/**
Radek Krejci9a3823e2021-01-27 20:26:46 +0100395 * @brief Get the address of the node's musts member, if any.
396 * Decides the node's type and in case it has a musts member, returns its address.
Michal Vasko544e58a2021-01-28 14:33:41 +0100397 *
Radek Krejci9a3823e2021-01-27 20:26:46 +0100398 * @param[in] node Node to examine.
399 * @return The address of the node's musts member if any, NULL otherwise.
400 */
401struct lysp_restr **lysp_node_musts_p(const struct lysp_node *node);
402
403/**
404 * @brief Get the node's musts member, if any.
405 * Decides the node's type and in case it has a musts member, returns its address.
Michal Vasko544e58a2021-01-28 14:33:41 +0100406 *
Radek Krejci9a3823e2021-01-27 20:26:46 +0100407 * @param[in] node Node to examine.
408 * @return The node's musts member if any, NULL otherwise.
409 */
410struct lysp_restr *lysp_node_musts(const struct lysp_node *node);
411
412/**
413 * @brief Get the address of the node's when member, if any.
414 * Decides the node's type and in case it has a when, returns it.
Michal Vasko544e58a2021-01-28 14:33:41 +0100415 *
Radek Krejci9a3823e2021-01-27 20:26:46 +0100416 * @param[in] node Node to examine.
417 * @return The address of the node's when member if any, NULL otherwise.
418 */
419struct lysp_when **lysp_node_when_p(const struct lysp_node *node);
420
421/**
422 * @brief Get the node's when member, if any.
423 * Decides the node's type and in case it has a when, returns it.
Michal Vasko544e58a2021-01-28 14:33:41 +0100424 *
Radek Krejci9a3823e2021-01-27 20:26:46 +0100425 * @param[in] node Node to examine.
426 * @return The node's when member if any, NULL otherwise.
427 */
428struct lysp_when *lysp_node_when(const struct lysp_node *node);
429
430/**
Radek Krejcibbe09a92018-11-08 09:36:54 +0100431 * @brief Get address of a node's child pointer if any.
Radek Krejcibbe09a92018-11-08 09:36:54 +0100432 * Decides the node's type and in case it has a children list, returns its address.
Michal Vasko544e58a2021-01-28 14:33:41 +0100433 *
434 * Do not use for RPC and action nodes.
435 *
Radek Krejcibbe09a92018-11-08 09:36:54 +0100436 * @param[in] node Node to check.
437 * @return Address of the node's child member if any, NULL otherwise.
438 */
Michal Vasko544e58a2021-01-28 14:33:41 +0100439struct lysc_node **lysc_node_child_p(const struct lysc_node *node);
Radek Krejcibbe09a92018-11-08 09:36:54 +0100440
441/**
Radek Krejcifc11bd72019-04-11 16:00:05 +0200442 * @brief Get address of a node's notifs pointer if any.
Radek Krejcifc11bd72019-04-11 16:00:05 +0200443 * Decides the node's type and in case it has a notifs array, returns its address.
Michal Vasko544e58a2021-01-28 14:33:41 +0100444 *
Radek Krejcifc11bd72019-04-11 16:00:05 +0200445 * @param[in] node Node to check.
446 * @return Address of the node's notifs member if any, NULL otherwise.
447 */
Radek Krejci2a9fc652021-01-22 17:44:34 +0100448struct lysc_node_notif **lysc_node_notifs_p(struct lysc_node *node);
Radek Krejcifc11bd72019-04-11 16:00:05 +0200449
450/**
451 * @brief Get address of a node's actions pointer if any.
Radek Krejcifc11bd72019-04-11 16:00:05 +0200452 * Decides the node's type and in case it has a actions array, returns its address.
Michal Vasko544e58a2021-01-28 14:33:41 +0100453 *
Radek Krejcifc11bd72019-04-11 16:00:05 +0200454 * @param[in] node Node to check.
455 * @return Address of the node's actions member if any, NULL otherwise.
456 */
Radek Krejci2a9fc652021-01-22 17:44:34 +0100457struct lysc_node_action **lysc_node_actions_p(struct lysc_node *node);
Radek Krejcifc11bd72019-04-11 16:00:05 +0200458
459/**
Radek Krejci9a3823e2021-01-27 20:26:46 +0100460 * @brief Get address of a node's when member if any.
Radek Krejci9a3823e2021-01-27 20:26:46 +0100461 * Decides the node's type and in case it has a when member, returns its address.
Michal Vasko544e58a2021-01-28 14:33:41 +0100462 *
Radek Krejci9a3823e2021-01-27 20:26:46 +0100463 * @param[in] node Node to check.
464 * @return Address of the node's when member if any, NULL otherwise.
465 */
466struct lysc_when ***lysc_node_when_p(const struct lysc_node *node);
467
468/**
469 * @brief Get address of a node's musts member if any.
Radek Krejci9a3823e2021-01-27 20:26:46 +0100470 * Decides the node's type and in case it has a musts member, returns its address.
Michal Vasko544e58a2021-01-28 14:33:41 +0100471 *
Radek Krejci9a3823e2021-01-27 20:26:46 +0100472 * @param[in] node Node to check.
473 * @return Address of the node's musts member if any, NULL otherwise.
474 */
475struct lysc_must **lysc_node_musts_p(const struct lysc_node *node);
476
477/**
Radek Krejci85ac8312021-03-03 20:21:33 +0100478 * @brief Find parsed extension definition for the given extension instance.
479 *
480 * @param[in] ctx libyang context.
481 * @param[in] ext Extension instance for which the definition will be searched.
482 * @param[in, out] ext_mod Pointer to the module where the extension definition of the @p ext to correctly resolve prefixes.
483 * @param[out] ext_def Pointer to return found extension definition.
484 * @return LY_SUCCESS when the definition was found.
485 * @return LY_EVALID when the extension instance is invalid and/or the definition not found.
486 */
487LY_ERR lysp_ext_find_definition(const struct ly_ctx *ctx, const struct lysp_ext_instance *ext, const struct lys_module **ext_mod,
488 struct lysp_ext **ext_def);
489
490/**
Radek Krejciba05eab2021-03-10 13:19:29 +0100491 * @brief Get schema node in extension instance according to the given parameters.
492 *
493 * Wraps ::lys_getnext_ext() and match according to the given arguments.
494 *
495 * @param[in] ext Extension instance which top-level schema node is being searched.
496 * @param[in] module Optional parameter to match the extension instance's (and its data) module.
497 * @param[in] name Name of the schema node to find, if the string is not NULL-terminated, the @p name_len must be set.
498 * @param[in] name_len Length of the @p name string, use in case the @p name is not NULL-terminated string.
499 * @param[in] nodetype Allowed [type of the node](@ref schemanodetypes).
500 * @param[in] options ORed [lys_getnext options](@ref sgetnextflags).
501 * @return Found schema node if there is some satisfy the provided requirements.
502 */
503const struct lysc_node *lysc_ext_find_node(const struct lysc_ext_instance *ext, const struct lys_module *module,
504 const char *name, size_t name_len, uint16_t nodetype, uint32_t options);
505
506/**
Radek Krejci85ac8312021-03-03 20:21:33 +0100507 * @brief When the module comes from YIN format, the argument name is unknown because of missing extension definition
508 * (it might come from import modules which is not yet parsed at that time). Therefore, all the attributes are stored
509 * as substatements and resolving argument is postponed.
510 *
511 * There are 3 places which need the argument, so they resolve it when missing - YIN and YANG printers and extension instance
512 * compiler.
513 *
514 * @param[in] ctx libyang context
515 * @param[in] ext_p Parsed extension to be updated.
516 * @param[in] ext_def Extension definition, found with ::lysp_ext_find_definition().
517 * @return LY_ERR value.
518 */
519LY_ERR lysp_ext_instance_resolve_argument(struct ly_ctx *ctx, struct lysp_ext_instance *ext_p, struct lysp_ext *ext_def);
520
521/**
Radek Krejcid3ca0632019-04-16 16:54:54 +0200522 * @brief Iterate over the specified type of the extension instances
523 *
524 * @param[in] ext ([Sized array](@ref sizedarrays)) of extensions to explore
525 * @param[in] index Index in the \p ext array where to start searching (first call with 0, the consequent calls with
Michal Vaskofd69e1d2020-07-03 11:57:17 +0200526 * the returned index increased by 1 (until the iteration is not terminated by returning LY_ARRAY_COUNT(ext).
Radek Krejcifc596f92021-02-26 22:40:26 +0100527 * @param[in] substmt The statement the extension is supposed to belong to.
Michal Vaskofd69e1d2020-07-03 11:57:17 +0200528 * @result index in the ext array, LY_ARRAY_COUNT(ext) value if not present.
Radek Krejcid3ca0632019-04-16 16:54:54 +0200529 */
Radek Krejcifc596f92021-02-26 22:40:26 +0100530LY_ARRAY_COUNT_TYPE lysp_ext_instance_iter(struct lysp_ext_instance *ext, LY_ARRAY_COUNT_TYPE index, enum ly_stmt substmt);
Radek Krejcid3ca0632019-04-16 16:54:54 +0200531
532/**
Radek Krejci96a0bfd2018-11-22 15:25:06 +0100533 * @brief Get the covering schema module structure for the given parsed module structure.
Michal Vasko544e58a2021-01-28 14:33:41 +0100534 *
Radek Krejci96a0bfd2018-11-22 15:25:06 +0100535 * @param[in] ctx libyang context to search.
536 * @param[in] mod Parsed schema structure.
537 * @return Corresponding lys_module structure for the given parsed schema structure.
538 */
539struct lys_module *lysp_find_module(struct ly_ctx *ctx, const struct lysp_module *mod);
540
541/**
Radek Krejci693262f2019-04-29 15:23:20 +0200542 * @brief Stringify YANG built-in type.
Michal Vasko1bf09392020-03-27 12:38:10 +0100543 * @param[in] basetype Built-in type ID to stringify.
Radek Krejci693262f2019-04-29 15:23:20 +0200544 * @return Constant string with the name of the built-in type.
545 */
546const char *lys_datatype2str(LY_DATA_TYPE basetype);
547
Michal Vasko405cc9e2020-12-01 12:01:27 +0100548/**
Michal Vasko65333882021-06-10 14:12:16 +0200549 * @brief Implement a module and resolve all global unres.
Michal Vasko405cc9e2020-12-01 12:01:27 +0100550 *
551 * @param[in] mod Module to implement.
Michal Vasko4e205e82021-06-08 14:01:47 +0200552 * @param[in] features Features to set, see ::lys_set_features().
Michal Vasko65333882021-06-10 14:12:16 +0200553 * @param[in] unres Global unres with all the created modules.
554 * @return LY_SUCCESS on success.
Michal Vasko4e205e82021-06-08 14:01:47 +0200555 * @return LY_ERR on error.
Michal Vasko405cc9e2020-12-01 12:01:27 +0100556 */
Michal Vasko65333882021-06-10 14:12:16 +0200557LY_ERR _lys_set_implemented(struct lys_module *mod, const char **features, struct lys_glob_unres *unres);
Michal Vasko405cc9e2020-12-01 12:01:27 +0100558
Michal Vaskof4258e12021-06-15 12:11:42 +0200559/**
560 * @brief Create dependency sets for all modules in a context.
Michal Vasko50bc09a2021-06-17 17:31:56 +0200561 * Also sets to_compile flags for all the modules that should be (re)compiled.
Michal Vaskof4258e12021-06-15 12:11:42 +0200562 *
563 * @param[in] ctx Context to use.
564 * @param[in,out] main_set Set of dependency module sets.
565 * @param[in] mod Optional only module whose dependency set is needed, otherwise all sets are created.
566 * @return LY_ERR value.
567 */
Michal Vasko50bc09a2021-06-17 17:31:56 +0200568LY_ERR lys_unres_dep_sets_create(struct ly_ctx *ctx, struct ly_set *main_set, struct lys_module *mod);
Michal Vaskof4258e12021-06-15 12:11:42 +0200569
570/**
571 * @brief Revert changes stored in global compile context after a failed compilation.
572 *
573 * @param[in] ctx libyang context.
574 * @param[in] unres Global unres to use.
575 */
576void lys_unres_glob_revert(struct ly_ctx *ctx, struct lys_glob_unres *unres);
577
578/**
579 * @brief Erase the global compile context.
580 *
581 * @param[in] unres Global unres to erase.
582 */
583void lys_unres_glob_erase(struct lys_glob_unres *unres);
584
Michal Vasko3a41dff2020-07-15 14:30:28 +0200585typedef LY_ERR (*lys_custom_check)(const struct ly_ctx *ctx, struct lysp_module *mod, struct lysp_submodule *submod,
Radek Krejci0f969882020-08-21 16:56:47 +0200586 void *check_data);
Michal Vaskob36053d2020-03-26 15:49:30 +0100587
Radek Krejci693262f2019-04-29 15:23:20 +0200588/**
Michal Vasko4e205e82021-06-08 14:01:47 +0200589 * @brief Parse a module and add it into the context.
Radek Krejcid33273d2018-10-25 14:55:52 +0200590 *
591 * @param[in] ctx libyang context where to process the data model.
Michal Vasko63f3d842020-07-08 10:10:14 +0200592 * @param[in] in Input structure.
Radek Krejcid33273d2018-10-25 14:55:52 +0200593 * @param[in] format Format of the input data (YANG or YIN).
Radek Krejci9ed7a192018-10-31 16:23:51 +0100594 * @param[in] custom_check Callback to check the parsed schema before it is accepted.
595 * @param[in] check_data Caller's data to pass to the custom_check callback.
Michal Vaskodd992582021-06-10 14:34:57 +0200596 * @param[in,out] new_mods Set of all the new mods added to the context. Includes this module and all of its imports.
Michal Vasko7a0b0762020-09-02 16:37:01 +0200597 * @param[out] module Created module.
Michal Vaskodd992582021-06-10 14:34:57 +0200598 * @return LY_SUCCESS on success.
599 * @return LY_ERR on error, @p new_mods may be modified.
Radek Krejcid33273d2018-10-25 14:55:52 +0200600 */
Michal Vasko4e205e82021-06-08 14:01:47 +0200601LY_ERR lys_parse_in(struct ly_ctx *ctx, struct ly_in *in, LYS_INFORMAT format, lys_custom_check custom_check,
Michal Vaskodd992582021-06-10 14:34:57 +0200602 void *check_data, struct ly_set *new_mods, struct lys_module **module);
Radek Krejcid33273d2018-10-25 14:55:52 +0200603
604/**
Michal Vasko7a0b0762020-09-02 16:37:01 +0200605 * @brief Parse submodule.
Radek Krejcid33273d2018-10-25 14:55:52 +0200606 *
Radek Krejci0bcdaed2019-01-10 10:21:34 +0100607 * The latest_revision flag of submodule is updated.
608 *
609 * @param[in] ctx libyang context where to process the data model.
Michal Vasko63f3d842020-07-08 10:10:14 +0200610 * @param[in] in Input structure.
Radek Krejci0bcdaed2019-01-10 10:21:34 +0100611 * @param[in] format Format of the input data (YANG or YIN).
612 * @param[in] main_ctx Parser context of the main module.
613 * @param[in] custom_check Callback to check the parsed schema before it is accepted.
614 * @param[in] check_data Caller's data to pass to the custom_check callback.
aPiecekc3e26142021-06-22 14:25:49 +0200615 * @param[in] new_mods Set of all the new mods added to the context. Includes this module and all of its imports.
Michal Vasko3a41dff2020-07-15 14:30:28 +0200616 * @param[out] submodule Parsed submodule.
617 * @return LY_ERR value.
Radek Krejci0bcdaed2019-01-10 10:21:34 +0100618 */
Michal Vasko87f1cf02021-06-08 14:02:47 +0200619LY_ERR lys_parse_submodule(struct ly_ctx *ctx, struct ly_in *in, LYS_INFORMAT format, struct lys_parser_ctx *main_ctx,
aPiecekc3e26142021-06-22 14:25:49 +0200620 lys_custom_check custom_check, void *check_data, struct ly_set *new_mods, struct lysp_submodule **submodule);
Radek Krejci0bcdaed2019-01-10 10:21:34 +0100621
622/**
Radek Krejcif0e1ba52020-05-22 15:14:35 +0200623 * @brief Fill filepath value if available in input handler @p in
Radek Krejci0bcdaed2019-01-10 10:21:34 +0100624 *
Radek Krejcif0e1ba52020-05-22 15:14:35 +0200625 * @param[in] ctx Context with dictionary where the filepath value will be stored.
626 * @param[in] in Input handler to examine (filepath is not available for all the input types).
627 * @param[out] filepath Address of the variable where the filepath is stored.
Radek Krejcid33273d2018-10-25 14:55:52 +0200628 */
Radek Krejcif0e1ba52020-05-22 15:14:35 +0200629void lys_parser_fill_filepath(struct ly_ctx *ctx, struct ly_in *in, const char **filepath);
Radek Krejcid33273d2018-10-25 14:55:52 +0200630
631/**
Radek Krejci693262f2019-04-29 15:23:20 +0200632 * @brief Get the @ref ifftokens from the given position in the 2bits array
633 * (libyang format of the if-feature expression).
634 * @param[in] list The 2bits array with the compiled if-feature expression.
635 * @param[in] pos Position (0-based) to specify from which position get the operator.
636 */
Radek Krejci1deb5be2020-08-26 16:43:36 +0200637uint8_t lysc_iff_getop(uint8_t *list, size_t pos);
Radek Krejci0af46292019-01-11 16:02:31 +0100638
639/**
Radek Krejcifc11bd72019-04-11 16:00:05 +0200640 * @brief Macro to free [sized array](@ref sizedarrays) of items using the provided free function. The ARRAY itself is also freed,
641 * but the memory is not sanitized.
642 */
Radek Krejci0a03a342021-01-19 13:39:28 +0100643#define FREE_ARRAY(CTX, ARRAY, FUNC) {LY_ARRAY_COUNT_TYPE c__; LY_ARRAY_FOR(ARRAY, c__){(FUNC)(CTX, &(ARRAY)[c__]);}LY_ARRAY_FREE(ARRAY);}
Radek Krejcifc11bd72019-04-11 16:00:05 +0200644
645/**
646 * @brief Macro to free the specified MEMBER of a structure using the provided free function. The memory is not sanitized.
647 */
Radek Krejci0a03a342021-01-19 13:39:28 +0100648#define FREE_MEMBER(CTX, MEMBER, FUNC) if (MEMBER) {(FUNC)(CTX, MEMBER);free(MEMBER);}
Radek Krejcifc11bd72019-04-11 16:00:05 +0200649
650/**
651 * @brief Macro to free [sized array](@ref sizedarrays) of strings stored in the context's dictionary. The ARRAY itself is also freed,
652 * but the memory is not sanitized.
653 */
Michal Vaskoe180ed02021-02-05 16:31:20 +0100654#define FREE_STRINGS(CTX, ARRAY) {LY_ARRAY_COUNT_TYPE c__; LY_ARRAY_FOR(ARRAY, c__){lydict_remove(CTX, ARRAY[c__]);}LY_ARRAY_FREE(ARRAY);}
Radek Krejcifc11bd72019-04-11 16:00:05 +0200655
656/**
Radek Krejci15f10ab2020-11-03 14:14:14 +0100657 * @brief Free the printable YANG schema tree structure. Works for both modules and submodules.
658 *
659 * @param[in] module Printable YANG schema tree structure to free.
660 */
661void lysp_module_free(struct lysp_module *module);
662
663/**
Radek Krejci38d85362019-09-05 16:26:38 +0200664 * @brief Free the parsed type structure.
665 * @param[in] ctx libyang context where the string data resides in a dictionary.
Michal Vasko8d544252020-03-02 10:19:52 +0100666 * @param[in] type Parsed schema type structure to free. Note that the type itself is not freed.
Radek Krejci38d85362019-09-05 16:26:38 +0200667 */
668void lysp_type_free(struct ly_ctx *ctx, struct lysp_type *type);
Radek Krejci335332a2019-09-05 13:03:35 +0200669
Radek Krejciad5963b2019-09-06 16:03:05 +0200670/**
Michal Vasko8d544252020-03-02 10:19:52 +0100671 * @brief Free the parsed extension instance structure.
672 * @param[in] ctx libyang context where the string data resides in a dictionary.
Radek Krejci84d7fd72021-07-14 18:32:21 +0200673 * @param[in] ext Parsed extension instance structure to free. Note that the instance itself is not freed.
Michal Vasko8d544252020-03-02 10:19:52 +0100674 */
675void lysp_ext_instance_free(struct ly_ctx *ctx, struct lysp_ext_instance *ext);
676
677/**
Radek Krejci84d7fd72021-07-14 18:32:21 +0200678 * @brief Parse generic statement structure into a specific parsed-schema structure.
679 *
680 * @param[in] ctx The compilation context of the @p stmt being processed
681 * @param[in] stmt Generic statement structure to process.
682 * @param[out] result Specific parsed-schema structure for the given statement. For the specific type for the particular statement, check the function code.
Radek Krejciad5963b2019-09-06 16:03:05 +0200683 * @param[in,out] exts [sized array](@ref sizedarrays) For extension instances in case of statements that do not store extension instances in their own list.
Radek Krejci84d7fd72021-07-14 18:32:21 +0200684 * @return LY_ERR value.
Radek Krejciad5963b2019-09-06 16:03:05 +0200685 */
Radek Krejci76c8c4e2021-02-17 10:16:48 +0100686LY_ERR lysp_stmt_parse(struct lysc_ctx *ctx, const struct lysp_stmt *stmt, void **result, struct lysp_ext_instance **exts);
Radek Krejci335332a2019-09-05 13:03:35 +0200687
Radek Krejcid33273d2018-10-25 14:55:52 +0200688/**
Michal Vasko20424b42020-08-31 12:29:38 +0200689 * @brief Free a parsed node.
690 *
691 * @param[in] ctx libyang context.
692 * @param[in] node Node to free.
693 */
694void lysp_node_free(struct ly_ctx *ctx, struct lysp_node *node);
695
696/**
Radek Krejcicdfecd92018-11-26 11:27:32 +0100697 * @brief Free the compiled type structure.
698 * @param[in] ctx libyang context where the string data resides in a dictionary.
699 * @param[in,out] type Compiled type structure to be freed. The structure has refcount, so it is freed only in case the value is decreased to 0.
700 */
701void lysc_type_free(struct ly_ctx *ctx, struct lysc_type *type);
702
703/**
Radek Krejci0af46292019-01-11 16:02:31 +0100704 * @brief Free the compiled if-feature structure.
705 * @param[in] ctx libyang context where the string data resides in a dictionary.
706 * @param[in,out] iff Compiled if-feature structure to be cleaned.
707 * Since the structure is typically part of the sized array, the structure itself is not freed.
708 */
709void lysc_iffeature_free(struct ly_ctx *ctx, struct lysc_iffeature *iff);
710
711/**
Michal Vasko7b1ad1a2020-11-02 15:41:27 +0100712 * @brief Free the compiled identity structure.
713 * @param[in] ctx libyang context where the string data resides in a dictionary.
714 * @param[in,out] ident Compiled identity structure to be cleaned.
715 * Since the structure is typically part of the sized array, the structure itself is not freed.
716 */
717void lysc_ident_free(struct ly_ctx *ctx, struct lysc_ident *ident);
718
719/**
Radek Krejciccd20f12019-02-15 14:12:27 +0100720 * @brief Free the compiled must structure.
721 * @param[in] ctx libyang context where the string data resides in a dictionary.
722 * @param[in,out] must Compiled must structure to be cleaned.
723 * Since the structure is typically part of the sized array, the structure itself is not freed.
724 */
725void lysc_must_free(struct ly_ctx *ctx, struct lysc_must *must);
726
727/**
Radek Krejcif538ce52019-03-05 10:46:14 +0100728 * @brief Free the data inside compiled input/output structure.
729 * @param[in] ctx libyang context where the string data resides in a dictionary.
730 * @param[in,out] inout Compiled inout structure to be cleaned.
731 * Since the structure is part of the RPC/action structure, it is not freed itself.
732 */
Radek Krejci2a9fc652021-01-22 17:44:34 +0100733void lysc_node_action_inout_free(struct ly_ctx *ctx, struct lysc_node_action_inout *inout);
Radek Krejcif538ce52019-03-05 10:46:14 +0100734
735/**
736 * @brief Free the data inside compiled RPC/action structure.
737 * @param[in] ctx libyang context where the string data resides in a dictionary.
738 * @param[in,out] action Compiled action structure to be cleaned.
739 * Since the structure is typically part of the sized array, the structure itself is not freed.
740 */
Radek Krejci2a9fc652021-01-22 17:44:34 +0100741void lysc_node_action_free(struct ly_ctx *ctx, struct lysc_node_action *action);
Radek Krejcif538ce52019-03-05 10:46:14 +0100742
743/**
Radek Krejcifc11bd72019-04-11 16:00:05 +0200744 * @brief Free the items inside the compiled Notification structure.
745 * @param[in] ctx libyang context where the string data resides in a dictionary.
Radek Krejci720d2612021-03-03 19:44:22 +0100746 * @param[in,out] notif Compiled Notification structure to be cleaned.
Radek Krejcifc11bd72019-04-11 16:00:05 +0200747 * Since the structure is typically part of the sized array, the structure itself is not freed.
748 */
Radek Krejci2a9fc652021-01-22 17:44:34 +0100749void lysc_node_notif_free(struct ly_ctx *ctx, struct lysc_node_notif *notif);
Radek Krejcifc11bd72019-04-11 16:00:05 +0200750
751/**
Radek Krejci720d2612021-03-03 19:44:22 +0100752 * @brief Free the compiled extension definition and NULL the provided pointer.
753 * @param[in] ctx libyang context where the string data resides in a dictionary.
aPiecekb0445f22021-06-24 11:34:07 +0200754 * @param[in,out] ext Compiled extension definition to be freed.
Radek Krejci720d2612021-03-03 19:44:22 +0100755 */
756void lysc_extension_free(struct ly_ctx *ctx, struct lysc_ext **ext);
757
758/**
Radek Krejci0af46292019-01-11 16:02:31 +0100759 * @brief Free the compiled extension instance structure.
760 * @param[in] ctx libyang context where the string data resides in a dictionary.
761 * @param[in,out] ext Compiled extension instance structure to be cleaned.
762 * Since the structure is typically part of the sized array, the structure itself is not freed.
763 */
764void lysc_ext_instance_free(struct ly_ctx *ctx, struct lysc_ext_instance *ext);
765
766/**
Radek Krejci19a96102018-11-15 13:38:09 +0100767 * @brief Free the compiled node structure.
768 * @param[in] ctx libyang context where the string data resides in a dictionary.
Michal Vasko7b1ad1a2020-11-02 15:41:27 +0100769 * @param[in] node Compiled node structure to be freed.
770 * @param[in] unlink Whether to first unlink the node before freeing.
Radek Krejci19a96102018-11-15 13:38:09 +0100771 */
Michal Vasko7b1ad1a2020-11-02 15:41:27 +0100772void lysc_node_free(struct ly_ctx *ctx, struct lysc_node *node, ly_bool unlink);
Radek Krejci19a96102018-11-15 13:38:09 +0100773
774/**
Radek Krejcif2de0ed2019-05-02 14:13:18 +0200775 * @brief Free the compiled container node structure.
776 *
777 * Only the container-specific members are freed, for generic node free function,
Radek Krejci8678fa42020-08-18 16:07:28 +0200778 * use ::lysc_node_free().
Radek Krejcif2de0ed2019-05-02 14:13:18 +0200779 *
780 * @param[in] ctx libyang context where the string data resides in a dictionary.
781 * @param[in,out] node Compiled container node structure to be freed.
782 */
783void lysc_node_container_free(struct ly_ctx *ctx, struct lysc_node_container *node);
784
785/**
Radek Krejci19a96102018-11-15 13:38:09 +0100786 * @brief Free the compiled schema structure.
787 * @param[in,out] module Compiled schema module structure to free.
Radek Krejci19a96102018-11-15 13:38:09 +0100788 */
Radek Krejci90ed21e2021-04-12 14:47:46 +0200789void lysc_module_free(struct lysc_module *module);
Radek Krejci19a96102018-11-15 13:38:09 +0100790
791/**
Radek Krejci86d106e2018-10-18 09:53:19 +0200792 * @brief Free the schema structure. It just frees, it does not remove the schema from its context.
793 * @param[in,out] module Schema module structure to free.
Radek Krejci86d106e2018-10-18 09:53:19 +0200794 */
Radek Krejci90ed21e2021-04-12 14:47:46 +0200795void lys_module_free(struct lys_module *module);
Radek Krejci86d106e2018-10-18 09:53:19 +0200796
797/**
David Sedlák18e494b2018-12-17 03:58:39 +0100798 * @brief match yang keyword
David Sedlák1bccdfa2019-06-17 15:55:27 +0200799 *
Michal Vasko63f3d842020-07-08 10:10:14 +0200800 * @param[in,out] in Input structure, is updated.
Radek Krejcid54412f2020-12-17 20:25:35 +0100801 * @param[in,out] indent Pointer to the counter of current position on the line for YANG indentation (optional).
Michal Vasko14654712020-02-06 08:35:21 +0100802 * @return yang_keyword values.
David Sedlák18e494b2018-12-17 03:58:39 +0100803 */
Radek Krejcid54412f2020-12-17 20:25:35 +0100804enum ly_stmt lysp_match_kw(struct ly_in *in, uint64_t *indent);
David Sedlák1bccdfa2019-06-17 15:55:27 +0200805
Michal Vasko14654712020-02-06 08:35:21 +0100806/**
807 * @brief Generate path of the given node in the requested format.
808 *
809 * @param[in] node Schema path of this node will be generated.
810 * @param[in] parent Build relative path only until this parent is found. If NULL, the full absolute path is printed.
811 * @param[in] pathtype Format of the path to generate.
812 * @param[in,out] buffer Prepared buffer of the @p buflen length to store the generated path.
813 * If NULL, memory for the complete path is allocated.
814 * @param[in] buflen Size of the provided @p buffer.
815 * @return NULL in case of memory allocation error, path of the node otherwise.
816 * In case the @p buffer is NULL, the returned string is dynamically allocated and caller is responsible to free it.
817 */
818char *lysc_path_until(const struct lysc_node *node, const struct lysc_node *parent, LYSC_PATH_TYPE pathtype, char *buffer,
Radek Krejci0f969882020-08-21 16:56:47 +0200819 size_t buflen);
Michal Vasko14654712020-02-06 08:35:21 +0100820
Michal Vasko62ed12d2020-05-21 10:08:25 +0200821/**
Michal Vasko72244882021-01-12 15:21:05 +0100822 * @brief Get nearest @p schema parent (including the node itself) that can be instantiated in data.
Michal Vasko62ed12d2020-05-21 10:08:25 +0200823 *
Michal Vasko72244882021-01-12 15:21:05 +0100824 * @param[in] schema Schema node to get the nearest data node for.
825 * @return Schema data node, NULL if top-level (in data).
Michal Vasko62ed12d2020-05-21 10:08:25 +0200826 */
Michal Vasko72244882021-01-12 15:21:05 +0100827const struct lysc_node *lysc_data_node(const struct lysc_node *schema);
828
829/**
830 * @brief Same as ::lysc_data_node() but never returns the node itself.
831 */
Radek Krejci7d95fbb2021-01-26 17:33:13 +0100832#define lysc_data_parent(SCHEMA) lysc_data_node((SCHEMA)->parent)
Michal Vasko62ed12d2020-05-21 10:08:25 +0200833
Michal Vasko00cbf532020-06-15 13:58:47 +0200834/**
Radek Krejci239c38a2020-10-19 10:58:25 +0200835 * @brief Get format-specific prefix for a module.
836 *
Radek Krejci84d7fd72021-07-14 18:32:21 +0200837 * This function is available for type plugins via ::lyplg_type_get_prefix() API function.
Radek Krejci239c38a2020-10-19 10:58:25 +0200838 *
839 * @param[in] mod Module whose prefix to get.
840 * @param[in] format Format of the prefix.
Radek Krejci8df109d2021-04-23 12:19:08 +0200841 * @param[in] prefix_data Format-specific data based on @p format:
Radek Krejci224d4b42021-04-23 13:54:59 +0200842 * LY_VALUE_CANON - NULL
Radek Krejci84d7fd72021-07-14 18:32:21 +0200843 * LY_VALUE_SCHEMA - const struct ::lysp_module* (module used for resolving imports to prefixes)
844 * LY_VALUE_SCHEMA_RESOLVED - struct ::lysc_prefix* (sized array of pairs: prefix - module)
845 * LY_VALUE_XML - struct ::ly_set* (set of all returned modules as struct ::lys_module)
Radek Krejci8df109d2021-04-23 12:19:08 +0200846 * LY_VALUE_JSON - NULL
Radek Krejcif9943642021-04-26 10:18:21 +0200847 * LY_VALUE_LYB - NULL
Radek Krejci239c38a2020-10-19 10:58:25 +0200848 * @return Module prefix to print.
849 * @return NULL on error.
850 */
Radek Krejci8df109d2021-04-23 12:19:08 +0200851const char *ly_get_prefix(const struct lys_module *mod, LY_VALUE_FORMAT format, void *prefix_data);
Radek Krejci239c38a2020-10-19 10:58:25 +0200852
853/**
854 * @brief Resolve format-specific prefixes to modules.
855 *
Radek Krejci239c38a2020-10-19 10:58:25 +0200856 * @param[in] ctx libyang context.
857 * @param[in] prefix Prefix to resolve.
858 * @param[in] prefix_len Length of @p prefix.
859 * @param[in] format Format of the prefix.
Radek Krejcif9943642021-04-26 10:18:21 +0200860 * @param[in] prefix_data Format-specific data based on @p format:
861 * LY_VALUE_CANON - NULL
862 * LY_VALUE_SCHEMA - const struct lysp_module * (module used for resolving prefixes from imports)
863 * LY_VALUE_SCHEMA_RESOLVED - struct lyd_value_prefix * (sized array of pairs: prefix - module)
864 * LY_VALUE_XML - const struct ly_set * (set with defined namespaces stored as ::lyxml_ns)
865 * LY_VALUE_JSON - NULL
866 * LY_VALUE_LYB - NULL
Radek Krejci239c38a2020-10-19 10:58:25 +0200867 * @return Resolved prefix module,
868 * @return NULL otherwise.
869 */
Radek Krejcif9943642021-04-26 10:18:21 +0200870const struct lys_module *ly_resolve_prefix(const struct ly_ctx *ctx, const void *prefix, size_t prefix_len,
Radek Krejci8df109d2021-04-23 12:19:08 +0200871 LY_VALUE_FORMAT format, const void *prefix_data);
Radek Krejci239c38a2020-10-19 10:58:25 +0200872
Michal Vaskof4258e12021-06-15 12:11:42 +0200873/**
874 * @brief Learn whether @p PMOD needs to be recompiled if it is implemented.
875 *
876 * @param[in] PMOD Parsed module or submodule.
877 * @return Whether it has statements that are recompiled or not.
878 */
879#define LYSP_HAS_RECOMPILED(PMOD) \
880 (PMOD->data || PMOD->rpcs || PMOD->notifs || PMOD->exts)
881
882/**
883 * @brief Learn whether the module has statements that need to be recompiled or not.
884 *
885 * @param[in] mod Module to examine.
886 * @return Whether it has statements that are recompiled or not.
887 */
888ly_bool lys_has_recompiled(const struct lys_module *mod);
889
890/**
891 * @brief Learn whether @p PMOD needs to be compiled if it is implemented.
892 *
893 * @param[in] PMOD Parsed module or submodule.
894 * @return Whether it needs (has) a compiled module or not.
895 */
896#define LYSP_HAS_COMPILED(PMOD) \
aPiecek6b3d5422021-07-30 15:55:43 +0200897 (LYSP_HAS_RECOMPILED(PMOD) || PMOD->augments || PMOD->deviations)
Michal Vaskof4258e12021-06-15 12:11:42 +0200898
899/**
900 * @brief Learn whether the module has statements that need to be compiled or not.
901 *
902 * @param[in] mod Module to examine.
903 * @return Whether it needs compiled module or not.
904 */
905ly_bool lys_has_compiled(const struct lys_module *mod);
906
Michal Vasko7ee5be22021-06-16 17:03:34 +0200907/**
908 * @brief Learn whether the module has any grouping statements or not.
909 *
910 * @param[in] mod Module to examine.
911 * @return Whether it has groupings or not.
912 */
913ly_bool lys_has_groupings(const struct lys_module *mod);
914
Radek Krejci70853c52018-10-15 14:46:16 +0200915#endif /* LY_TREE_SCHEMA_INTERNAL_H_ */