9fa5e216c4
w-level general upgrades and as a complement to module-specific upgrade. * Called on startup after initial XML parsing, but before module-specific upgrades * Enabled by definign the `.ca_datastore_upgrade` * [General-purpose upgrade documentation](https://clixon-docs.readthedocs.io/en/latest/backend.html#ge neral-purpose) * JSON parse error messages change from ` on line x: syntax error,..` to `json_parse: line x: syntax err or` * Unknown-element error message is more descriptive, eg from `namespace is: urn:example:clixon` to: `Fai led to find YANG spec of XML node: x with parent: xp in namespace urn:example:clixon`. * C-API parse and validation API more capable * `xml_spec_populate` family of functions extended with three-value return values * -1: error, 0: parse OK, 1: parse and YANG binding OK. * `xml_parse` and `json_parse` API changes * Three value returns: -1: error, 0: parse OK, 1: parse and YANG binding OK. * Extended `xml_parse_file2` and `xml_parse_string2` extended API functions with all options available. * New concept called `yang_bind` that defines how XML symbols are bound to YANG after parsing * Existing API same except `xml_parse_file` `endtag` argument moved to `xml_parse_file2` * C-API: Added instrumentation: `xml_size` and `xml_stats_get`. * Fixed: Enabling modstate (CLICON_XMLDB_MODSTATE), changing a revision on a yang, and restarting made the backend daemon exit at start (thanks Matt) * Also: ensure to load `ietf-yang-library.yang ` if CLICON_XMLDB_MODSTATE is set
78 lines
2.8 KiB
C
78 lines
2.8 KiB
C
/*
|
|
*
|
|
***** BEGIN LICENSE BLOCK *****
|
|
|
|
Copyright (C) 2009-2019 Olof Hagsand
|
|
Copyright (C) 2020 Olof Hagsand and Rubicon Communications, LLC
|
|
|
|
This file is part of CLIXON.
|
|
|
|
Licensed under the Apache License, Version 2.0 (the "License");
|
|
you may not use this file except in compliance with the License.
|
|
You may obtain a copy of the License at
|
|
|
|
http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
Unless required by applicable law or agreed to in writing, software
|
|
distributed under the License is distributed on an "AS IS" BASIS,
|
|
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
See the License for the specific language governing permissions and
|
|
limitations under the License.
|
|
|
|
Alternatively, the contents of this file may be used under the terms of
|
|
the GNU General Public License Version 3 or later (the "GPL"),
|
|
in which case the provisions of the GPL are applicable instead
|
|
of those above. If you wish to allow use of your version of this file only
|
|
under the terms of the GPL, and not to allow others to
|
|
use your version of this file under the terms of Apache License version 2,
|
|
indicate your decision by deleting the provisions above and replace them with
|
|
the notice and other provisions required by the GPL. If you do not delete
|
|
the provisions above, a recipient may use your version of this file under
|
|
the terms of any one of the Apache License version 2 or the GPL.
|
|
|
|
***** END LICENSE BLOCK *****
|
|
|
|
* Yang module and feature handling
|
|
* @see https://tools.ietf.org/html/rfc7895
|
|
*/
|
|
|
|
#ifndef _CLIXON_YANG_MODULE_H_
|
|
#define _CLIXON_YANG_MODULE_H_
|
|
|
|
/*
|
|
* Constants
|
|
*/
|
|
|
|
/*
|
|
* Types
|
|
*/
|
|
|
|
/* Struct containing module state differences between two modules or two
|
|
* revisions of same module.
|
|
* This is in state of flux so it needs to be contained and easily changed.
|
|
*/
|
|
typedef struct {
|
|
int md_status; /* 0 if no module-state in a datastore, 1 if there is */
|
|
char *md_set_id; /* server-specific identifier */
|
|
cxobj *md_del; /* yang module state deletes */
|
|
cxobj *md_mod; /* yang module state modifications */
|
|
} modstate_diff_t;
|
|
|
|
/*
|
|
* Prototypes
|
|
*/
|
|
modstate_diff_t * modstate_diff_new(void);
|
|
int modstate_diff_free(modstate_diff_t *);
|
|
|
|
int yang_modules_init(clicon_handle h);
|
|
char *yang_modules_revision(clicon_handle h);
|
|
|
|
int yang_modules_state_get(clicon_handle h, yang_stmt *yspec, char *xpath,
|
|
cvec *nsc, int brief, cxobj **xret);
|
|
int clixon_module_upgrade(clicon_handle h, cxobj *xt, modstate_diff_t *msd, cbuf *cb);
|
|
yang_stmt *yang_find_module_by_prefix(yang_stmt *ys, char *prefix);
|
|
yang_stmt *yang_find_module_by_prefix_yspec(yang_stmt *yspec, char *prefix);
|
|
yang_stmt *yang_find_module_by_namespace(yang_stmt *yspec, char *namespace);
|
|
yang_stmt *yang_find_module_by_name(yang_stmt *yspec, char *name);
|
|
|
|
#endif /* _CLIXON_YANG_MODULE_H_ */
|