| /** |
| * @file tree_schema.h |
| * @author Radek Krejci <rkrejci@cesnet.cz> |
| * @brief libyang representation of YANG schema trees. |
| * |
| * Copyright (c) 2015 - 2018 CESNET, z.s.p.o. |
| * |
| * This source code is licensed under BSD 3-Clause License (the "License"). |
| * You may not use this file except in compliance with the License. |
| * You may obtain a copy of the License at |
| * |
| * https://opensource.org/licenses/BSD-3-Clause |
| */ |
| |
| #ifndef LY_TREE_SCHEMA_H_ |
| #define LY_TREE_SCHEMA_H_ |
| |
| #include <stdint.h> |
| |
| /** |
| * @defgroup schematree Schema Tree |
| * @{ |
| * |
| * Data structures and functions to manipulate and access schema tree. |
| */ |
| |
| /** |
| * @brief Schema input formats accepted by libyang [parser functions](@ref howtoschemasparsers). |
| */ |
| typedef enum { |
| LYS_IN_UNKNOWN = 0, /**< unknown format, used as return value in case of error */ |
| LYS_IN_YANG = 1, /**< YANG schema input format */ |
| LYS_IN_YIN = 2 /**< YIN schema input format */ |
| } LYS_INFORMAT; |
| |
| /** |
| * @brief Schema output formats accepted by libyang [printer functions](@ref howtoschemasprinters). |
| */ |
| typedef enum { |
| LYS_OUT_UNKNOWN = 0, /**< unknown format, used as return value in case of error */ |
| LYS_OUT_YANG = 1, /**< YANG schema output format */ |
| LYS_OUT_YIN = 2, /**< YIN schema output format */ |
| LYS_OUT_TREE, /**< Tree schema output format, for more information see the [printers](@ref howtoschemasprinters) page */ |
| LYS_OUT_INFO, /**< Info schema output format, for more information see the [printers](@ref howtoschemasprinters) page */ |
| LYS_OUT_JSON, /**< JSON schema output format, reflecting YIN format with conversion of attributes to object's members */ |
| } LYS_OUTFORMAT; |
| |
| #define LY_REV_SIZE 11 /**< revision data string length (including terminating NULL byte) */ |
| |
| #define LYS_UNKNOWN 0x0000 /**< uninitalized unknown statement node */ |
| #define LYS_CONTAINER 0x0001 /**< container statement node */ |
| #define LYS_CHOICE 0x0002 /**< choice statement node */ |
| #define LYS_LEAF 0x0004 /**< leaf statement node */ |
| #define LYS_LEAFLIST 0x0008 /**< leaf-list statement node */ |
| #define LYS_LIST 0x0010 /**< list statement node */ |
| #define LYS_ANYXML 0x0020 /**< anyxml statement node */ |
| #define LYS_CASE 0x0040 /**< case statement node */ |
| #define LYS_USES 0x0080 /**< uses statement node */ |
| #define LYS_ANYDATA 0x0120 /**< anydata statement node, in tests it can be used for both #LYS_ANYXML and #LYS_ANYDATA */ |
| |
| /** |
| * @brief YANG import-stmt |
| */ |
| struct lysp_import { |
| const char *name; /**< name of the module to import (mandatory) */ |
| const char *prefix; /**< prefix for the data from the imported schema (mandatory) */ |
| const char *dsc; /**< description */ |
| const char *ref; /**< reference */ |
| struct lysp_ext_instance *exts; /**< list of the extension instances (0-terminated) */ |
| char rev[LY_REV_SIZE]; /**< revision-date of the imported module */ |
| }; |
| |
| /** |
| * @brief YANG include-stmt |
| */ |
| struct lysp_include { |
| const char *name; /**< name of the submodule to include (mandatory) */ |
| const char *dsc; /**< description */ |
| const char *ref; /**< reference */ |
| struct lysp_ext_instance *exts; /**< list of the extension instances (0-terminated) */ |
| char rev[LY_REV_SIZE]; /**< revision-date of the included submodule */ |
| }; |
| |
| /** |
| * @brief YANG extension-stmt |
| */ |
| struct lysp_ext { |
| const char *name; /**< extension name */ |
| const char *argument; /**< argument name, NULL if not specified */ |
| const char *dsc; /**< description statement */ |
| const char *ref; /**< reference statement */ |
| struct lysp_ext_instance *exts; /**< list of the extension instances (0-terminated) */ |
| uint16_t flags; /**< LYS_STATUS_* and LYS_YINELEM values (@ref snodeflags) */ |
| }; |
| |
| /** |
| * @brief Helper structure for generic storage of the extension instances content. |
| */ |
| struct lysp_stmt { |
| const char *stmt; /**< identifier of the statement */ |
| const char *arg; /**< statement's argument */ |
| struct lysp_stmt *next; /**< link to the next statement */ |
| struct lysp_stmt *child; /**< list of the statement's substatements (linked list) */ |
| }; |
| |
| /** |
| * @brief Enum of substatements in which extension instances can appear. |
| */ |
| typedef enum { |
| LYEXT_SUBSTMT_SELF = 0, /**< extension of the structure itself, not substatement's */ |
| LYEXT_SUBSTMT_ARGUMENT, /**< extension of the argument statement, can appear in lys_ext */ |
| LYEXT_SUBSTMT_BASE, /**< extension of the base statement, can appear (repeatedly) in lys_type and lys_ident */ |
| LYEXT_SUBSTMT_BELONGSTO, /**< extension of the belongs-to statement, can appear in lys_submodule */ |
| LYEXT_SUBSTMT_CONTACT, /**< extension of the contact statement, can appear in lys_module */ |
| LYEXT_SUBSTMT_DEFAULT, /**< extension of the default statement, can appear in lys_node_leaf, lys_node_leaflist, |
| lys_node_choice and lys_deviate */ |
| LYEXT_SUBSTMT_DESCRIPTION, /**< extension of the description statement, can appear in lys_module, lys_submodule, |
| lys_node, lys_import, lys_include, lys_ext, lys_feature, lys_tpdf, lys_restr, |
| lys_ident, lys_deviation, lys_type_enum, lys_type_bit, lys_when and lys_revision */ |
| LYEXT_SUBSTMT_ERRTAG, /**< extension of the error-app-tag statement, can appear in lys_restr */ |
| LYEXT_SUBSTMT_ERRMSG, /**< extension of the error-message statement, can appear in lys_restr */ |
| LYEXT_SUBSTMT_KEY, /**< extension of the key statement, can appear in lys_node_list */ |
| LYEXT_SUBSTMT_NAMESPACE, /**< extension of the namespace statement, can appear in lys_module */ |
| LYEXT_SUBSTMT_ORGANIZATION, /**< extension of the organization statement, can appear in lys_module and lys_submodule */ |
| LYEXT_SUBSTMT_PATH, /**< extension of the path statement, can appear in lys_type */ |
| LYEXT_SUBSTMT_PREFIX, /**< extension of the prefix statement, can appear in lys_module, lys_submodule (for |
| belongs-to's prefix) and lys_import */ |
| LYEXT_SUBSTMT_PRESENCE, /**< extension of the presence statement, can appear in lys_node_container */ |
| LYEXT_SUBSTMT_REFERENCE, /**< extension of the reference statement, can appear in lys_module, lys_submodule, |
| lys_node, lys_import, lys_include, lys_revision, lys_tpdf, lys_restr, lys_ident, |
| lys_ext, lys_feature, lys_deviation, lys_type_enum, lys_type_bit and lys_when */ |
| LYEXT_SUBSTMT_REVISIONDATE, /**< extension of the revision-date statement, can appear in lys_import and lys_include */ |
| LYEXT_SUBSTMT_UNITS, /**< extension of the units statement, can appear in lys_tpdf, lys_node_leaf, |
| lys_node_leaflist and lys_deviate */ |
| LYEXT_SUBSTMT_VALUE, /**< extension of the value statement, can appear in lys_type_enum */ |
| LYEXT_SUBSTMT_VERSION, /**< extension of the yang-version statement, can appear in lys_module and lys_submodule */ |
| LYEXT_SUBSTMT_MODIFIER, /**< extension of the modifier statement, can appear in lys_restr */ |
| LYEXT_SUBSTMT_REQINSTANCE, /**< extension of the require-instance statement, can appear in lys_type */ |
| LYEXT_SUBSTMT_YINELEM, /**< extension of the yin-element statement, can appear in lys_ext */ |
| LYEXT_SUBSTMT_CONFIG, /**< extension of the config statement, can appear in lys_node and lys_deviate */ |
| LYEXT_SUBSTMT_MANDATORY, /**< extension of the mandatory statement, can appear in lys_node_leaf, lys_node_choice, |
| lys_node_anydata and lys_deviate */ |
| LYEXT_SUBSTMT_ORDEREDBY, /**< extension of the ordered-by statement, can appear in lys_node_list and lys_node_leaflist */ |
| LYEXT_SUBSTMT_STATUS, /**< extension of the status statement, can appear in lys_tpdf, lys_node, lys_ident, |
| lys_ext, lys_feature, lys_type_enum and lys_type_bit */ |
| LYEXT_SUBSTMT_FRACDIGITS, /**< extension of the fraction-digits statement, can appear in lys_type */ |
| LYEXT_SUBSTMT_MAX, /**< extension of the max-elements statement, can appear in lys_node_list, |
| lys_node_leaflist and lys_deviate */ |
| LYEXT_SUBSTMT_MIN, /**< extension of the min-elements statement, can appear in lys_node_list, |
| lys_node_leaflist and lys_deviate */ |
| LYEXT_SUBSTMT_POSITION, /**< extension of the position statement, can appear in lys_type_bit */ |
| LYEXT_SUBSTMT_UNIQUE, /**< extension of the unique statement, can appear in lys_node_list and lys_deviate */ |
| LYEXT_SUBSTMT_IFFEATURE, /**< extension of the if-feature statement */ |
| } LYEXT_SUBSTMT; |
| |
| /** |
| * @brief YANG extension instance |
| */ |
| struct lysp_ext_instance { |
| const char *name; /**< extension identifier, including possible prefix */ |
| const char *argument; /**< optional value of the extension's argument */ |
| LYEXT_SUBSTMT insubstmt; /**< value identifying placement of the extension instance */ |
| uint32_t insubstmt_index; /**< in case the instance is in a substatement, this identifies |
| the index of that substatement */ |
| struct lysp_stmt *child; /**< list of the extension's substatements (linked list) */ |
| }; |
| |
| /** |
| * @brief YANG feature-stmt |
| */ |
| struct lysp_feature { |
| const char *name; /**< feature name (mandatory) */ |
| const char **iffeatures; /**< list of if-feature expressions (NULL-terminated) */ |
| const char *dsc; /**< description statement */ |
| const char *ref; /**< reference statement */ |
| struct lysp_ext_instance *exts; /**< list of the extension instances (0-terminated) */ |
| uint16_t flags; /**< [schema node flags](@ref snodeflags) - only LYS_STATUS_* values allowed */ |
| }; |
| |
| /** |
| * @brief YANG identity-stmt |
| */ |
| struct lysp_ident { |
| const char *name; /**< identity name (mandatory), including possible prefix */ |
| const char **iffeatures; /**< list of if-feature expressions (NULL-terminated) */ |
| const char **bases; /**< list of base identifiers (NULL-terminated) */ |
| const char *dsc; /**< description statement */ |
| const char *ref; /**< reference statement */ |
| struct lysp_ext_instance *exts; /**< list of the extension instances (0-terminated) */ |
| uint16_t flags; /**< [schema node flags](@ref snodeflags) - only LYS_STATUS_ values are allowed */ |
| }; |
| |
| /** |
| * @brief Covers restrictions: range, length, pattern, must |
| */ |
| struct lysp_restr { |
| const char *arg; /**< The restriction expression/value (mandatory); |
| in case of pattern restriction, the first byte has a special meaning: |
| 0x06 (ACK) for regular match and 0x15 (NACK) for invert-match */ |
| const char *emsg; /**< error-message */ |
| const char *eapptag; /**< error-app-tag value */ |
| const char *dsc; /**< description */ |
| const char *ref; /**< reference */ |
| struct lysp_ext_instance *exts; /**< list of the extension instances (0-terminated) */ |
| }; |
| |
| /** |
| * @brief YANG revision-stmt |
| */ |
| struct lysp_revision { |
| char rev[LY_REV_SIZE]; /**< revision date (madatory) */ |
| const char *dsc; /**< description statement */ |
| const char *ref; /**< reference statement */ |
| struct lysp_ext_instance *exts; /**< list of the extension instances (0-terminated) */ |
| }; |
| |
| /** |
| * @brief Enumeration/Bit value definition |
| */ |
| struct lysp_type_enum { |
| const char *name; /**< name (mandatory) */ |
| const char *dsc; /**< description statement */ |
| const char *ref; /**< reference statement */ |
| int64_t value; /**< enum's value or bit's position */ |
| const char **iffeatures; /**< list of if-feature expressions (NULL-terminated) */ |
| struct lysp_ext_instance *exts; /**< list of the extension instances (0-terminated) */ |
| uint16_t flags; /**< [schema node flags](@ref snodeflags) - only LYS_STATUS_ and LYS_SET_VALUE |
| values are allowed */ |
| }; |
| |
| /** |
| * @brief YANG type-stmt |
| * |
| * Some of the items in the structure may be mandatory, but it is necessary to resolve the type's base type first |
| */ |
| struct lysp_type { |
| const char *name; /**< name of the type (mandatory) */ |
| struct lysp_restr *range; /**< allowed values range - numerical, decimal64 */ |
| struct lysp_restr *length; /**< allowed length of the value - string, binary */ |
| struct lysp_restr *patterns; /**< list of patterns (0-terminated) - string */ |
| struct lysp_type_enum *enums; /**< list of enum-stmts (0-terminated) - enum */ |
| struct lysp_type_enum *bits; /**< list of bit-stmts (0-terminated) - bits */ |
| const char *path; /**< path - leafref */ |
| const char **bases; /**< list of base identifiers (NULL-terminated) - identityref */ |
| struct lysp_type *types; /**< list of sub-types (0-terminated) - union */ |
| struct lysp_ext_instance *exts; /**< list of the extension instances (0-terminated) */ |
| |
| uint8_t fraction_digits; /**< number of fraction digits - decimal64 */ |
| uint8_t require_instance; /**< require-instance flag - leafref, instance */ |
| uint16_t flags; /**< [schema node flags](@ref snodeflags) - only LYS_SET_REQINST allowed */ |
| }; |
| |
| /** |
| * @brief YANG typedef-stmt |
| */ |
| struct lysp_tpdf { |
| const char *name; /**< name of the newly defined type (mandatory) */ |
| const char *units; /**< units of the newly defined type */ |
| const char *dflt; /**< default value of the newly defined type */ |
| const char *dsc; /**< description statement */ |
| const char *ref; /**< reference statement */ |
| struct lysp_ext_instance *exts; /**< list of the extension instances (0-terminated) */ |
| struct lysp_type type; /**< base type from which the typedef is derived (mandatory) */ |
| uint16_t flags; /**< [schema node flags](@ref snodeflags) - only LYS_STATUS_* values allowed */ |
| }; |
| |
| /** |
| * @brief YANG grouping-stmt |
| */ |
| struct lysp_grp { |
| const char *name; /**< grouping name (mandatory) */ |
| const char *dsc; /**< description statement */ |
| const char *ref; /**< reference statement */ |
| struct lysp_tpdf *typedefs; /**< list of typedefs (0-terminated) */ |
| struct lysp_grp *groupings; /**< list of groupings (0-terminated) */ |
| struct lysp_node *data; /**< list of data nodes (linked list) */ |
| struct lysp_action *actions; /**< list of actions (0-terminated) */ |
| struct lysp_notif *notifs; /**< list of notifications (0-terminated) */ |
| struct lysp_ext_instance *exts; /**< list of the extension instances (0-terminated) */ |
| uint16_t flags; /**< [schema node flags](@ref snodeflags) - only LYS_STATUS_* values are allowed */ |
| }; |
| |
| /** |
| * @brief YANG when-stmt |
| */ |
| struct lysp_when { |
| const char *cond; /**< specified condition (mandatory) */ |
| const char *dsc; /**< description statement */ |
| const char *ref; /**< reference statement */ |
| struct lysp_ext_instance *exts; /**< list of the extension instances (0-terminated) */ |
| }; |
| |
| /** |
| * @brief YANG refine-stmt |
| */ |
| struct lysp_refine { |
| const char *nodeid; /**< target descendant schema nodeid (mandatory) */ |
| const char *dsc; /**< description statement */ |
| const char *ref; /**< reference statement */ |
| const char **iffeatures; /**< list of if-feature expressions (NULL-terminated) */ |
| struct lysp_restr *musts; /**< list of must restrictions (0-terminated) */ |
| const char *presence; /**< presence description */ |
| const char **dflts; /**< list of default values (NULL-terminated) */ |
| uint32_t min; /**< min-elements constraint */ |
| uint32_t max; /**< max-elements constraint, 0 means unbounded */ |
| struct lysp_ext_instance *exts; /**< list of the extension instances (0-terminated) */ |
| uint16_t flags; /**< [schema node flags](@ref snodeflags) */ |
| }; |
| |
| /** |
| * @brief YANG uses-augment-stmt and augment-stmt |
| */ |
| struct lysp_augment { |
| const char *nodeid; /**< target schema nodeid (mandatory) - absolute for global augments, descendant for uses's augments */ |
| const char *dsc; /**< description statement */ |
| const char *ref; /**< reference statement */ |
| struct lysp_when *when; /**< when statement */ |
| const char **iffeatures; /**< list of if-feature expressions (NULL-terminated) */ |
| struct lysp_node *child; /**< list of data nodes (linked list) */ |
| struct lysp_action *actions; /**< list of actions (0-terminated) */ |
| struct lysp_notif *notifs; /**< list of notifications (0-terminated) */ |
| struct lysp_ext_instance *exts; /**< list of the extension instances (0-terminated) */ |
| uint16_t flags; /**< [schema node flags](@ref snodeflags) - only LYS_STATUS_* values are allowed */ |
| }; |
| |
| /** |
| * @defgroup deviatetypes Deviate types |
| * @{ |
| */ |
| #define LYS_DEV_NOT_SUPPORTED 1 /**< deviate type not-supported */ |
| #define LYS_DEV_ADD 2 /**< deviate type add */ |
| #define LYS_DEV_DELETE 3 /**< deviate type delete */ |
| #define LYS_DEV_REPLACE 4 /**< deviate type replace */ |
| /** @} */ |
| |
| /** |
| * @brief Generic deviate structure to get type and cast to lysp_deviate_* structure |
| */ |
| struct lysp_deviate { |
| uint8_t mod; /**< [type](@ref deviatetypes) of the deviate modification */ |
| struct lysp_deviate *next; /**< next deviate structure in the list */ |
| struct lysp_ext_instance *exts; /**< list of the extension instances (0-terminated) */ |
| }; |
| |
| struct lysp_deviate_add { |
| uint8_t mod; /**< [type](@ref deviatetypes) of the deviate modification */ |
| struct lysp_deviate *next; /**< next deviate structure in the list */ |
| struct lysp_ext_instance *exts; /**< list of the extension instances (0-terminated) */ |
| const char *units; /**< units of the values */ |
| struct lysp_restr *musts; /**< list of must restrictions (0-terminated) */ |
| const char **uniques; /**< list of uniques specifications (NULL-terminated) */ |
| const char **dflts; /**< list of default values (NULL-terminated) */ |
| uint16_t flags; /**< [schema node flags](@ref snodeflags) */ |
| uint32_t min; /**< min-elements constraint */ |
| uint32_t max; /**< max-elements constraint, 0 means unbounded */ |
| }; |
| |
| struct lysp_deviate_del { |
| uint8_t mod; /**< [type](@ref deviatetypes) of the deviate modification */ |
| struct lysp_deviate *next; /**< next deviate structure in the list */ |
| struct lysp_ext_instance *exts; /**< list of the extension instances (0-terminated) */ |
| const char *units; /**< units of the values */ |
| struct lysp_restr *musts; /**< list of must restrictions (0-terminated) */ |
| const char **uniques; /**< list of uniques specifications (NULL-terminated) */ |
| const char **dflts; /**< list of default values (NULL-terminated) */ |
| uint16_t flags; /**< [schema node flags](@ref snodeflags) */ |
| }; |
| |
| struct lysp_deviate_rpl { |
| uint8_t mod; /**< [type](@ref deviatetypes) of the deviate modification */ |
| struct lysp_deviate *next; /**< next deviate structure in the list */ |
| struct lysp_ext_instance *exts; /**< list of the extension instances (0-terminated) */ |
| struct lysp_type *type; /**< type of the node */ |
| const char *units; /**< units of the values */ |
| const char *dflt; /**< default value */ |
| uint16_t flags; /**< [schema node flags](@ref snodeflags) */ |
| uint32_t min; /**< min-elements constraint */ |
| uint32_t max; /**< max-elements constraint, 0 means unbounded */ |
| }; |
| |
| struct lysp_deviation { |
| const char *nodeid; /**< target absolute schema nodeid (mandatory) */ |
| const char *dsc; /**< description statement */ |
| const char *ref; /**< reference statement */ |
| struct lysp_deviate* deviates; /**< list of deviate specifications (linked list) */ |
| struct lysp_ext_instance *exts; /**< list of the extension instances (0-terminated) */ |
| }; |
| |
| #define LYS_CONFIG_W 0x01 /**< config true; */ |
| #define LYS_CONFIG_R 0x02 /**< config false; */ |
| #define LYS_CONFIG_MASK 0x03 /**< mask for config value */ |
| #define LYS_STATUS_CURR 0x08 /**< status current; */ |
| #define LYS_STATUS_DEPRC 0x10 /**< status deprecated; */ |
| #define LYS_STATUS_OBSLT 0x20 /**< status obsolete; */ |
| #define LYS_STATUS_MASK 0x38 /**< mask for status value */ |
| #define LYS_MAND_TRUE 0x40 /**< mandatory true; applicable only to |
| ::lys_node_choice, ::lys_node_leaf and ::lys_node_anydata */ |
| #define LYS_MAND_FALSE 0x80 /**< mandatory false; applicable only to |
| ::lys_node_choice, ::lys_node_leaf and ::lys_node_anydata */ |
| #define LYS_MAND_MASK 0xc0 /**< mask for mandatory values */ |
| #define LYS_ORDBY_SYSTEM 0x100 /**< ordered-by system lists, applicable only to |
| ::lys_node_list and ::lys_node_leaflist */ |
| #define LYS_ORDBY_USER 0x200 /**< ordered-by user lists, applicable only to |
| ::lys_node_list and ::lys_node_leaflist */ |
| #define LYS_ORDBY_MASK 0x300 /**< mask for ordered-by flags */ |
| #define LYS_FENABLED 0x100 /**< feature enabled flag, applicable only to ::lys_feature */ |
| #define LYS_AUTOASSIGNED 0x01 /**< value was auto-assigned, applicable only to |
| ::lys_type enum and bits flags */ |
| #define LYS_YINELEM_TRUE 0x01 /**< yin-element true for extension's argument */ |
| #define LYS_YINELEM_FALSE 0x02 /**< yin-element false for extension's argument */ |
| #define LYS_YINELEM_MASK 0x03 /**< mask for yin-element value */ |
| #define LYS_SET_VALUE 0x01 /**< value attribute is set */ |
| #define LYS_SET_MAX 0x400 /**< max attribute is set */ |
| #define LYS_SET_MIN 0x800 /**< min attribute is set */ |
| #define LYS_SET_REQINST 0x01 /**< require_instance attribute is set */ |
| |
| /** |
| * @brief Generic YANG data node |
| */ |
| struct lysp_node { |
| uint16_t nodetype; /**< type of the node (mandatory) */ |
| uint16_t flags; /**< [schema node flags](@ref snodeflags) */ |
| struct lysp_node *next; /**< pointer to the next sibling node (NULL if there is no one) */ |
| const char *name; /**< node name (mandatory) */ |
| const char *dsc; /**< description statement */ |
| const char *ref; /**< reference statement */ |
| struct lysp_when *when; /**< when statement */ |
| const char **iffeatures; /**< list of if-feature expressions (NULL-terminated) */ |
| struct lysp_ext_instance *exts; /**< list of the extension instances (0-terminated) */ |
| }; |
| |
| /** |
| * @brief Extension structure of the lysp_node for YANG container |
| */ |
| struct lysp_node_container { |
| uint16_t nodetype; /**< LYS_CONTAINER */ |
| uint16_t flags; /**< [schema node flags](@ref snodeflags) */ |
| struct lysp_node *next; /**< pointer to the next sibling node (NULL if there is no one) */ |
| const char *name; /**< node name (mandatory) */ |
| const char *dsc; /**< description statement */ |
| const char *ref; /**< reference statement */ |
| struct lysp_when *when; /**< when statement */ |
| const char **iffeatures; /**< list of if-feature expressions (NULL-terminated) */ |
| struct lysp_ext_instance *exts; /**< list of the extension instances (0-terminated) */ |
| |
| /* container */ |
| struct lysp_restr *musts; /**< list of must restrictions (0-terminated) */ |
| const char *presence; /**< presence description */ |
| struct lysp_tpdf *typedefs; /**< list of typedefs (0-terminated) */ |
| struct lysp_grp *groupings; /**< list of groupings (0-terminated) */ |
| struct lysp_node *child; /**< list of data nodes (linked list) */ |
| struct lysp_action *actions; /**< list of actions (0-terminated) */ |
| struct lysp_notif *notifs; /**< list of notifications (0-terminated) */ |
| }; |
| |
| struct lysp_node_leaf { |
| uint16_t nodetype; /**< LYS_LEAF */ |
| uint16_t flags; /**< [schema node flags](@ref snodeflags) */ |
| struct lysp_node *next; /**< pointer to the next sibling node (NULL if there is no one) */ |
| const char *name; /**< node name (mandatory) */ |
| const char *dsc; /**< description statement */ |
| const char *ref; /**< reference statement */ |
| struct lysp_when *when; /**< when statement */ |
| const char **iffeatures; /**< list of if-feature expressions (NULL-terminated) */ |
| struct lysp_ext_instance *exts; /**< list of the extension instances (0-terminated) */ |
| |
| /* leaf */ |
| struct lysp_restr *musts; /**< list of must restrictions (0-terminated) */ |
| struct lysp_type type; /**< type of the leaf node (mandatory) */ |
| const char *units; /**< units of the leaf's type */ |
| const char *dflt; /**< default value */ |
| }; |
| |
| struct lysp_node_leaflist { |
| uint16_t nodetype; /**< LYS_LEAFLIST */ |
| uint16_t flags; /**< [schema node flags](@ref snodeflags) */ |
| struct lysp_node *next; /**< pointer to the next sibling node (NULL if there is no one) */ |
| const char *name; /**< node name (mandatory) */ |
| const char *dsc; /**< description statement */ |
| const char *ref; /**< reference statement */ |
| struct lysp_when *when; /**< when statement */ |
| const char **iffeatures; /**< list of if-feature expressions (NULL-terminated) */ |
| struct lysp_ext_instance *exts; /**< list of the extension instances (0-terminated) */ |
| |
| /* leaf-list */ |
| struct lysp_restr *musts; /**< list of must restrictions (0-terminated) */ |
| struct lysp_type type; /**< type of the leaf node (mandatory) */ |
| const char *units; /**< units of the leaf's type */ |
| const char **dflts; /**< list of default values (NULL-terminated) */ |
| uint32_t min; /**< min-elements constraint */ |
| uint32_t max; /**< max-elements constraint, 0 means unbounded */ |
| }; |
| |
| struct lysp_node_list { |
| uint16_t nodetype; /**< LYS_LIST */ |
| uint16_t flags; /**< [schema node flags](@ref snodeflags) */ |
| struct lysp_node *next; /**< pointer to the next sibling node (NULL if there is no one) */ |
| const char *name; /**< node name (mandatory) */ |
| const char *dsc; /**< description statement */ |
| const char *ref; /**< reference statement */ |
| struct lysp_when *when; /**< when statement */ |
| const char **iffeatures; /**< list of if-feature expressions (NULL-terminated) */ |
| struct lysp_ext_instance *exts; /**< list of the extension instances (0-terminated) */ |
| |
| /* list */ |
| struct lysp_restr *musts; /**< list of must restrictions (0-terminated) */ |
| const char *key; /**< keys specification */ |
| struct lysp_tpdf *typedefs; /**< list of typedefs (0-terminated) */ |
| struct lysp_grp *groupings; /**< list of groupings (0-terminated) */ |
| struct lysp_node *child; /**< list of data nodes (linked list) */ |
| struct lysp_action *actions; /**< list of actions (0-terminated) */ |
| struct lysp_notif *notifs; /**< list of notifications (0-terminated) */ |
| const char **uniques; /**< list of uniques specifications (NULL-terminated) */ |
| uint32_t min; /**< min-elements constraint */ |
| uint32_t max; /**< max-elements constraint, 0 means unbounded */ |
| }; |
| |
| struct lysp_node_choice { |
| uint16_t nodetype; /**< LYS_CHOICE */ |
| uint16_t flags; /**< [schema node flags](@ref snodeflags) */ |
| struct lysp_node *next; /**< pointer to the next sibling node (NULL if there is no one) */ |
| const char *name; /**< node name (mandatory) */ |
| const char *dsc; /**< description statement */ |
| const char *ref; /**< reference statement */ |
| struct lysp_when *when; /**< when statement */ |
| const char **iffeatures; /**< list of if-feature expressions (NULL-terminated) */ |
| struct lysp_ext_instance *exts; /**< list of the extension instances (0-terminated) */ |
| |
| /* choice */ |
| struct lysp_node *child; /**< list of data nodes (linked list) */ |
| const char* dflt; /**< default case */ |
| }; |
| |
| struct lysp_node_case { |
| uint16_t nodetype; /**< LYS_CASE */ |
| uint16_t flags; /**< [schema node flags](@ref snodeflags) */ |
| struct lysp_node *next; /**< pointer to the next sibling node (NULL if there is no one) */ |
| const char *name; /**< node name (mandatory) */ |
| const char *dsc; /**< description statement */ |
| const char *ref; /**< reference statement */ |
| struct lysp_when *when; /**< when statement */ |
| const char **iffeatures; /**< list of if-feature expressions (NULL-terminated) */ |
| struct lysp_ext_instance *exts; /**< list of the extension instances (0-terminated) */ |
| |
| /* case */ |
| struct lysp_node *child; /**< list of data nodes (linked list) */ |
| }; |
| |
| struct lysp_node_anydata { |
| uint16_t nodetype; /**< LYS_ANYXML || LYS_ANYDATA */ |
| uint16_t flags; /**< [schema node flags](@ref snodeflags) */ |
| struct lysp_node *next; /**< pointer to the next sibling node (NULL if there is no one) */ |
| const char *name; /**< node name (mandatory) */ |
| const char *dsc; /**< description statement */ |
| const char *ref; /**< reference statement */ |
| struct lysp_when *when; /**< when statement */ |
| const char **iffeatures; /**< list of if-feature expressions (NULL-terminated) */ |
| struct lysp_ext_instance *exts; /**< list of the extension instances (0-terminated) */ |
| |
| /* anyxml/anydata */ |
| struct lysp_restr *musts; /**< list of must restrictions (0-terminated) */ |
| }; |
| |
| struct lysp_node_uses { |
| uint16_t nodetype; /**< LYS_USES */ |
| uint16_t flags; /**< [schema node flags](@ref snodeflags) */ |
| struct lysp_node *next; /**< pointer to the next sibling node (NULL if there is no one) */ |
| const char *name; /**< grouping name reference (mandatory) */ |
| const char *dsc; /**< description statement */ |
| const char *ref; /**< reference statement */ |
| struct lysp_when *when; /**< when statement */ |
| const char **iffeatures; /**< list of if-feature expressions (NULL-terminated) */ |
| struct lysp_ext_instance *exts; /**< list of the extension instances (0-terminated) */ |
| |
| /* uses */ |
| struct lysp_refine *refines; /**< list of uses's refines (0-terminated) */ |
| struct lysp_augment *augments; /**< list of uses's augment (0-terminated) */ |
| }; |
| |
| /** |
| * @brief YANG input-stmt and output-stmt |
| */ |
| struct lysp_action_inout { |
| struct lysp_restr *musts; /**< list of must restrictions (0-terminated) */ |
| struct lysp_tpdf *typedefs; /**< list of typedefs (0-terminated) */ |
| struct lysp_grp *groupings; /**< list of groupings (0-terminated) */ |
| struct lysp_node *data; /**< list of data nodes (linked list) */ |
| struct lysp_ext_instance *exts; /**< list of the extension instances (0-terminated) */ |
| }; |
| |
| /** |
| * @brief YANG rpc-stmt and action-stmt |
| */ |
| struct lysp_action { |
| const char *name; /**< grouping name reference (mandatory) */ |
| const char *dsc; /**< description statement */ |
| const char *ref; /**< reference statement */ |
| const char **iffeatures; /**< list of if-feature expressions (NULL-terminated) */ |
| struct lysp_tpdf *typedefs; /**< list of typedefs (0-terminated) */ |
| struct lysp_grp *groupings; /**< list of groupings (0-terminated) */ |
| struct lysp_action_inout *input; /**< RPC's/Action's input */ |
| struct lysp_action_inout *output;/**< RPC's/Action's output */ |
| struct lysp_ext_instance *exts; /**< list of the extension instances (0-terminated) */ |
| uint16_t flags; /**< [schema node flags](@ref snodeflags) */ |
| }; |
| |
| /** |
| * @brief YANG notification-stmt |
| */ |
| struct lysp_notif { |
| const char *name; /**< grouping name reference (mandatory) */ |
| const char *dsc; /**< description statement */ |
| const char *ref; /**< reference statement */ |
| const char **iffeatures; /**< list of if-feature expressions (NULL-terminated) */ |
| struct lysp_restr *musts; /**< list of must restrictions (0-terminated) */ |
| struct lysp_tpdf *typedefs; /**< list of typedefs (0-terminated) */ |
| struct lysp_grp *groupings; /**< list of groupings (0-terminated) */ |
| struct lysp_node *data; /**< list of data nodes (linked list) */ |
| struct lysp_ext_instance *exts; /**< list of the extension instances (0-terminated) */ |
| uint16_t flags; /**< [schema node flags](@ref snodeflags) - only LYS_STATUS_* values are allowed */ |
| }; |
| |
| /** |
| * @brief supported YANG schema version values |
| */ |
| typedef enum LYS_VERSION { |
| LYS_VERSION_UNDEF = 0, /**< no specific version, YANG 1.0 as default */ |
| LYS_VERSION_1_0 = 1, /**< YANG 1.0 */ |
| LYS_VERSION_1_1 = 2 /**< YANG 1.1 */ |
| } LYS_VERSION; |
| |
| /** |
| * @brief Printable YANG schema tree structure representing YANG module. |
| * |
| * Simple structure corresponding to the YANG format. The schema is only syntactically validated. |
| */ |
| struct lysp_module { |
| struct ly_ctx *ctx; /**< libyang context of the module (mandatory) */ |
| const char *name; /**< name of the module (mandatory) */ |
| const char *filepath; /**< path, if the schema was read from a file, NULL in case of reading from memory */ |
| union { |
| /* module */ |
| const char *ns; /**< namespace of the module (module - mandatory) */ |
| /* submodule */ |
| const char *belongsto; /**< belongs to parent module (submodule - mandatory) */ |
| }; |
| const char *prefix; /**< module prefix or submodule belongsto prefix of main module (mandatory) */ |
| struct lysp_import *imports; /**< list of imported modules (0-terminated) */ |
| struct lysp_include *includes; /**< list of included submodules (0-terminated) */ |
| const char *org; /**< party/company responsible for the module */ |
| const char *contact; /**< contact information for the module */ |
| const char *dsc; /**< description of the module */ |
| const char *ref; /**< cross-reference for the module */ |
| struct lysp_revision *revs; /**< list of the module revisions (0-terminated), the first revision |
| in the list is always the last (newest) revision of the module */ |
| struct lysp_ext *extensions; /**< list of extension statements (0-terminated) */ |
| struct lysp_feature *features; /**< list of feature definitions (0-terminated) */ |
| struct lysp_ident *identities; /**< list of identities (0-terminated) */ |
| struct lysp_tpdf *typedefs; /**< list of typedefs (0-terminated) */ |
| struct lysp_grp *groupings; /**< list of groupings (0-terminated) */ |
| struct lysp_node *data; /**< list of module's top-level data nodes (linked list) */ |
| struct lysp_augment *augments; /**< list of augments (0-terminated) */ |
| struct lysp_action *rpcs; /**< list of RPCs (0-terminated) */ |
| struct lysp_notif *notifs; /**< list of notifications (0-terminated) */ |
| struct lysp_deviation *deviations; /**< list of deviations (0-terminated) */ |
| struct lysp_ext_instance *exts; /**< list of the extension instances (0-terminated) */ |
| |
| uint8_t submodule:1; /**< flag to distinguish main modules and submodules */ |
| uint8_t deviated:1; /**< flag if the module is deviated by another module */ |
| uint8_t implemented:1; /**< flag if the module is implemented, not just imported */ |
| uint8_t latest_revision:1; /**< flag if the module was loaded without specific revision and is |
| the latest revision found */ |
| uint8_t version:4; /**< yang-version (LYS_VERSION values) */ |
| }; |
| |
| /** |
| * @brief Free the printable YANG schema tree structure. |
| * |
| * @param[in] module Printable YANG schema tree structure to free. |
| */ |
| void lysp_module_free(struct lysp_module *module); |
| |
| /** |
| * @brief Compiled YANG schema tree structure representing YANG module. |
| * |
| * Semantically validated YANG schema tree for data tree parsing. |
| * Contains only the necessary information for the data validation. |
| */ |
| struct lysc_module { |
| }; |
| |
| /** |
| * @brief Compiled YANG data node |
| */ |
| struct lysc_node { |
| }; |
| |
| /** |
| * @brief Available YANG schema tree structures representing YANG module. |
| */ |
| struct lys_module { |
| struct lysp_module *parsed; /**< Simply parsed (unresolved) YANG schema tree */ |
| struct lysc_module *compiled; /**< Compiled and fully validated YANG schema tree for data parsing */ |
| }; |
| |
| /** @} */ |
| |
| #endif /* LY_TREE_SCHEMA_H_ */ |