yumapro  25.10-1
YumaPro SDK
Loading...
Searching...
No Matches
val_util.h
Go to the documentation of this file.
1/*
2 * Copyright (c) 2008 - 2012, Andy Bierman, All Rights Reserved.
3 * Copyright (c) 2012 - 2025, YumaWorks, Inc., All Rights Reserved.
4 *
5 * Unless required by applicable law or agreed to in writing,
6 * software distributed under the License is distributed on an
7 * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
8 * KIND, either express or implied. See the License for the
9 * specific language governing permissions and limitations
10 * under the License.
11 */
12#ifndef _H_val_util
13#define _H_val_util
14
15/* FILE: val_util.h
16*********************************************************************
17* *
18* P U R P O S E *
19* *
20*********************************************************************/
21
27/*********************************************************************
28* *
29* C H A N G E H I S T O R Y *
30* *
31*********************************************************************
32
33date init comment
34----------------------------------------------------------------------
3519-dec-05 abb Begun
3621jul08 abb start obj-based rewrite
3729jul08 abb split out from val.h
38
39*/
40
41#include <xmlstring.h>
42
43#ifndef _H_ncxtypes
44#include "ncxtypes.h"
45#endif
46
47#ifndef _H_obj
48#include "obj.h"
49#endif
50
51#ifndef _H_op
52#include "op.h"
53#endif
54
55#ifndef _H_plock
56#include "plock.h"
57#endif
58
59#ifndef _H_ses
60#include "ses.h"
61#endif
62
63#ifndef _H_runstack
64#include "runstack.h"
65#endif
66
67#ifndef _H_status
68#include "status.h"
69#endif
70
71#ifndef _H_val
72#include "val.h"
73#endif
74
75#ifndef _H_xml_msg
76#include "xml_msg.h"
77#endif
78
79#ifndef _H_xmlns
80#include "xmlns.h"
81#endif
82
83#ifndef _H_xpath
84#include "xpath.h"
85#endif
86
87#ifdef __cplusplus
88extern "C" {
89#endif
90
91/********************************************************************
92* *
93* T Y P E S *
94* *
95*********************************************************************/
96
131typedef boolean
132 (*val_nodetest_fn_t) (xml_msg_hdr_t *mhdr,
133 ncx_withdefaults_t withdef,
134 boolean realtest,
135 val_value_t *node);
136
137
154typedef struct val_getbulk_return_t_ {
156 struct val_value_t_ *retval[NCX_MAX_GETBULK_COUNT];
157
159 uint32 retcount;
160
162 boolean retdone;
163} val_getbulk_return_t;
164
165
187typedef status_t
188 (*val_getbulk_cbfn_t) (obj_template_t *obj,
189 uint32 start_idx,
190 uint32 max_count,
191 uint32 max_depth,
192 val_nodetest_fn_t node_test_fn,
193 val_getbulk_return_t *getbulk_return);
194
195
196
197
198/********************************************************************
199* *
200* F U N C T I O N S *
201* *
202*********************************************************************/
203
204
248extern void
249 val_set_canonical_order (val_value_t *val);
250
251
261extern status_t
262 val_gen_index_comp (const obj_key_t *in,
263 val_value_t *val);
264
265
275extern status_t
276 val_gen_key_entry (val_value_t *keyval);
277
278
292extern status_t
293 val_gen_index_chain (const obj_template_t *obj,
294 val_value_t *val);
295
296
326extern status_t
327 val_add_defaults (val_value_t *val,
328 boolean scriptmode);
329
330
365extern status_t
366 val_add_defaults_ex (val_value_t *val,
367 boolean scriptmode,
368 runstack_context_t *rcxt,
369 time_t last_modified,
370 ncx_etag_t etag);
371
372
388extern status_t
389 val_add_node_defaults (obj_template_t *chobj,
390 val_value_t *val,
391 boolean scriptmode,
392 time_t last_modified,
393 ncx_etag_t etag);
394
395
409extern status_t
410 val_add_npcons (val_value_t *val);
411
412
427status_t
428 val_instance_check (val_value_t *root,
429 val_value_t *val,
430 obj_template_t *obj);
431
432
448extern status_t
449 val_instance_check_ex (val_value_t *root,
450 val_value_t *val,
451 obj_template_t *obj,
452 boolean check_when);
453
454
473extern status_t
474 val_instance_check_max (val_value_t *root,
475 val_value_t *val,
476 obj_template_t *obj,
477 boolean check_when,
478 boolean check_deep,
479 ses_cb_t *scb,
480 xml_msg_hdr_t *msg);
481
482
498extern val_value_t *
499 val_get_choice_first_set (val_value_t *val,
500 const obj_template_t *obj);
501
502
515extern val_value_t *
516 val_get_choice_first_set_full (val_value_t *val,
517 const obj_template_t *obj);
518
519
532extern val_value_t *
533 val_get_choice_first_set_ex (val_value_t *val,
534 const obj_template_t *obj,
535 boolean nondef);
536
537
548extern val_value_t *
549 val_get_choice_next_set (const obj_template_t *obj,
550 val_value_t *curchild);
551
552
564extern boolean
565 val_choice_is_set (val_value_t *val,
566 obj_template_t *obj);
567
568
575extern void
576 val_purge_errors_from_root (val_value_t *val);
577
578
592extern val_value_t *
593 val_new_child_val (xmlns_id_t nsid,
594 const xmlChar *name,
595 boolean copyname,
596 val_value_t *parent,
597 op_editop_t editop,
598 obj_template_t *obj);
599
600
614extern status_t
615 val_gen_instance_id (xml_msg_hdr_t *mhdr,
616 const val_value_t *val,
617 ncx_instfmt_t format,
618 xmlChar **buff);
619
620
636extern status_t
637 val_gen_instance_id_ex (xml_msg_hdr_t *mhdr,
638 const val_value_t *val,
639 ncx_instfmt_t format,
640 boolean stop_at_root,
641 xmlChar **buff);
642
643
664extern status_t
665 val_gen_instance_id_ex2 (xml_msg_hdr_t *mhdr,
666 const val_value_t *val,
667 const val_value_t *stopval,
668 ncx_instfmt_t format,
669 boolean stop_at_root,
670 xmlChar **buff);
671
672
693extern status_t
694 val_gen_split_instance_id (xml_msg_hdr_t *mhdr,
695 const val_value_t *val,
696 ncx_instfmt_t format,
697 xmlns_id_t leaf_nsid,
698 const xmlChar *leaf_name,
699 boolean stop_at_root,
700 xmlChar **buff);
701
702
721extern status_t
722 val_get_index_string (xml_msg_hdr_t *mhdr,
723 ncx_instfmt_t format,
724 boolean force_quotes,
725 const val_value_t *val,
726 xmlChar *buff,
727 uint32 *len);
728
729
750extern status_t
751 val_check_obj_when (val_value_t *val,
752 val_value_t *valroot,
753 val_value_t *objval,
754 obj_template_t *obj,
755 boolean *condresult,
756 uint32 *whencount);
757
758
812extern status_t
813 val_check_obj_when_ex (val_value_t *val,
814 val_value_t *valroot,
815 val_value_t *objval,
816 obj_template_t *obj,
817 xml_msg_hdr_t *mhdr,
818 boolean configonly,
819 boolean get_when,
820 ses_cb_t *pcb_session,
821 struct xpath_get2_cb_t_ *parent_cb,
822 boolean *condresult,
823 uint32 *whencount);
824
825
844extern status_t
845 val_remove_false_when (val_value_t *val,
846 boolean *deleteme);
847
848
866extern status_t
867 val_remove_false_when_error (const xmlChar *name,
868 val_value_t *val,
869 obj_template_t *obj,
870 boolean is_error,
871 boolean real_delete,
872 boolean *deleteme);
873
874
881extern xpath_pcb_t *
882 val_get_xpathpcb (val_value_t *val);
883
884
891extern const xpath_pcb_t *
892 val_get_const_xpathpcb (const val_value_t *val);
893
894
902extern status_t
903 val_copy_xpathpcb (val_value_t *val,
904 const xpath_pcb_t *xpathpcb);
905
906
914extern status_t
915 val_set_xpathpcb (val_value_t *val,
916 xpath_pcb_t *xpathpcb);
917
918
935extern val_value_t *
936 val_make_simval_obj (obj_template_t *obj,
937 const xmlChar *valstr,
938 status_t *res);
939
940
956extern status_t
957 val_set_simval_obj (val_value_t *val,
958 obj_template_t *obj,
959 const xmlChar *valstr);
960
961
972extern val_value_t *
973 val_make_binary_obj (obj_template_t *obj,
974 const xmlChar *binstr,
975 uint32 binstrlen,
976 status_t *res);
977
978
979
989extern val_value_t *
990 val_make_idref_obj (obj_template_t *obj,
991 const val_idref_t *leafval,
992 status_t *res);
993
994
1008extern val_value_t *
1009 val_make_identity_obj (obj_template_t *obj,
1010 typ_def_t *typdef,
1011 ncx_identity_t *ident,
1012 status_t *res);
1013
1014
1034extern status_t
1035 val_set_warning_parms (val_value_t *parentval);
1036
1037
1058extern status_t
1059 val_set_logging_parms (val_value_t *parentval);
1060
1061
1097extern status_t
1098 val_set_logging_parms_ex (val_value_t *parentval,
1099 const xmlChar *fhs_logfile);
1100
1101
1121extern status_t
1122 val_set_path_parms (val_value_t *parentval);
1123
1124
1135extern status_t
1136 val_set_subdirs_parm (val_value_t *parentval);
1137
1138
1159extern status_t
1160 val_set_feature_parms (val_value_t *parentval);
1161
1162
1171extern status_t
1172 val_set_protocols_parm (val_value_t *parentval);
1173
1174
1184extern status_t
1185 val_set_ses_protocols_parm (ses_cb_t *scb,
1186 val_value_t *parentval);
1187
1188
1197extern status_t
1198 val_set_message_indent_parm (val_value_t *parentval);
1199
1200
1212extern status_t
1213 val_set_home_parms (val_value_t *parentval);
1214
1215
1224extern status_t
1225 val_set_with_ocpattern_parm (val_value_t *parentval);
1226
1227
1237extern status_t
1238 val_set_errmsg_parm (val_value_t *parentval);
1239
1240
1254extern status_t
1255 val_ok_to_partial_lock (val_value_t *val,
1256 ses_id_t sesid,
1257 ses_id_t *lockowner);
1258
1259
1271extern status_t
1272 val_set_partial_lock (val_value_t *val,
1273 plock_cb_t *plcb);
1274
1275
1282extern void
1283 val_clear_partial_lock (val_value_t *val,
1284 plock_cb_t *plcb);
1285
1286
1304extern status_t
1305 val_write_ok (val_value_t *val,
1306 op_editop_t editop,
1307 ses_id_t sesid,
1308 boolean checkup,
1309 uint32 *lockid);
1310
1311
1322extern void
1323 val_check_swap_resnode (val_value_t *curval,
1324 val_value_t *newval);
1325
1326
1333extern void
1334 val_check_delete_resnode (val_value_t *curval);
1335
1336
1343extern void
1344 val_write_extern (ses_cb_t *scb,
1345 const val_value_t *val);
1346
1347
1354extern void
1355 val_write_intern (ses_cb_t *scb,
1356 const val_value_t *val);
1357
1358
1383extern val_value_t *
1384 val_get_value (ses_cb_t *scb,
1385 xml_msg_hdr_t *msg,
1386 val_value_t *val,
1387 val_nodetest_fn_t testfn,
1388 boolean acmcheck,
1389 boolean *malloced,
1390 status_t *res);
1391
1392
1420extern val_value_t *
1421 val_get_value_ex (ses_cb_t *scb,
1422 xml_msg_hdr_t *msg,
1423 val_value_t *val,
1424 val_nodetest_fn_t testfn,
1425 boolean acmcheck,
1426 boolean *malloced,
1427 status_t *res,
1428 void *get2cb); // getcb_get2_t *
1429
1430
1444extern void
1445 val_traverse_keys (val_value_t *val,
1446 void *cookie1,
1447 void *cookie2,
1448 val_walker_fn_t walkerfn);
1449
1450
1462extern status_t
1463 val_build_index_chains (val_value_t *val);
1464
1465
1475extern status_t
1476 val_cache_datarule (val_value_t *val,
1477 void *rule);
1478
1479
1488extern void
1489 val_clear_datarule (val_value_t *val,
1490 const void *rule);
1491
1492
1500extern boolean
1501 val_match_datarule (const val_value_t *val,
1502 void *rule);
1503
1504
1516extern val_value_t *
1517 val_find_list_from_keyvalQ (val_value_t *parentval,
1518 val_value_t *firstmatch,
1519 dlq_hdr_t *keyvalQ,
1520 status_t *res);
1521
1522
1541extern status_t
1542 val_move_config_false (val_value_t *newval,
1543 val_value_t *curval);
1544
1545
1553extern status_t
1554 val_add_one_operation_attr (val_value_t *val,
1555 op_editop_t op);
1556
1557
1563extern val_value_t *
1564 val_make_config_root (void);
1565
1566
1584extern status_t
1585 val_expand_var_expr (val_value_t *val,
1586 xmlChar **retstr);
1587
1588
1602extern void
1603 val_fixup_config_subtree (val_value_t *val,
1604 xmlns_id_t fixup_id);
1605
1606
1618extern status_t
1619 val_gen_keyptrs (val_value_t *val,
1620 dlq_hdr_t *keyptrQ);
1621
1622
1633extern status_t
1634 val_gen_keyclones (val_value_t *val,
1635 dlq_hdr_t *keyQ);
1636
1637
1646extern status_t
1647 val_add_datapath_attr (val_value_t *val,
1648 obj_template_t *obj);
1649
1650
1658extern status_t
1659 val_add_fixed_value_attr (val_value_t *val);
1660
1661
1669extern boolean
1670 val_is_fixed_value (val_value_t *val);
1671
1672
1680extern status_t
1681 val_add_btype_attr (val_value_t *val,
1682 ncx_btype_t btype);
1683
1684
1708extern status_t
1709 val_convert_anyxml_to_real (val_value_t *anyxml_val,
1710 val_value_t *real_val,
1711 val_value_t **error_val);
1712
1713
1714
1715
1716
1743extern status_t
1744 val_convert_anyxml_to_real2 (val_value_t *anyxml_val,
1745 val_value_t *real_val,
1746 xml_msg_hdr_t *hdr,
1747 val_value_t **error_val);
1748
1749
1761extern val_value_t *
1762 val_make_internal_value (const xmlChar *name,
1763 const xmlChar *value);
1764
1765
1775extern val_value_t *
1776 val_make_external_value (obj_template_t *obj,
1777 xmlChar *fname);
1778
1779
1789extern val_value_t *
1790 val_make_external_binary_value (obj_template_t *obj,
1791 xmlChar *fname);
1792
1793
1794
1801extern boolean
1802 val_simple_anyxml (const val_value_t *val);
1803
1804
1814extern status_t
1815 val_apply_template (val_value_t *template_val,
1816 val_value_t *target_val);
1817
1818
1832extern status_t
1833 val_convert_children (val_value_t *srcval,
1834 val_value_t *destval);
1835
1836
1850extern void
1851 val_set_children_load (val_value_t *val);
1852
1853
1861extern void
1862 val_merge_return_vals (dlq_hdr_t *srcQ,
1863 dlq_hdr_t *dstQ);
1864
1865
1874extern status_t
1875 val_set_binary_display_maxlen_parm (val_value_t *parentval);
1876
1877
1890extern status_t
1891 val_validate_value (val_value_t *useval);
1892
1893
1900extern boolean
1901 val_type_is_any (const val_value_t *val);
1902
1903
1910extern ncx_nmda_origin_t
1911 val_get_origin (const val_value_t *val);
1912
1913
1914
1921extern void
1922 val_set_origin (val_value_t *val,
1923 ncx_nmda_origin_t origin);
1924
1925
1932extern obj_template_t *
1933 val_get_casobj (val_value_t *val);
1934
1935
1942extern void
1943 val_set_anyxml_tracking (val_value_t *val,
1944 obj_template_t *obj);
1945
1946
1958extern void
1959 val_get_anyxml_tracking (const val_value_t *val,
1960 boolean *iskey,
1961 boolean *isconfig,
1962 boolean *isunknown);
1963
1964
1971extern xmlns_id_t
1972 val_get_idref_nsid (const val_value_t *val);
1973
1974
1981extern void
1982 val_dump_cli_valset (const char *progname,
1983 val_value_t *valset);
1984
1985
1986
2003extern status_t
2004 val_make_subtree (obj_template_t *obj,
2005 dlq_hdr_t *keyQ,
2006 val_value_t **topval,
2007 val_value_t **targetval);
2008
2009
2020extern val_value_t *
2021 val_find_descendant (val_value_t *val,
2022 const xmlChar *modname,
2023 const xmlChar *name);
2024
2025
2042extern val_value_t *
2043 val_find_descendant_obj (val_value_t *val,
2044 obj_template_t *obj,
2045 val_value_t *testval);
2046
2047
2057extern val_value_t *
2058 val_make_from_enumval (obj_template_t *obj,
2059 int32 enumval,
2060 status_t *res);
2061
2062
2063
2075extern val_value_t *
2076 val_make_from_num (obj_template_t *obj,
2077 typ_def_t *typdef,
2078 ncx_btype_t btyp,
2079 const ncx_num_t *num,
2080 status_t *res);
2081
2082
2083
2101extern val_value_t *
2102 val_make_from_bitstring (obj_template_t *obj,
2103 typ_def_t *typdef,
2104 const xmlChar *buff,
2105 uint32 bufflen,
2106 status_t *res);
2107
2124extern status_t
2125 val_set_tcp_connect_parms (val_value_t *parentval);
2126
2127
2138extern val_value_t *
2139 val_find_notif (val_value_t *topval);
2140
2149extern void
2150 val_force_dataclass_config (val_value_t *val);
2151
2152
2169extern status_t
2170 val_check_deprecated_warning (val_value_t *val);
2171
2172
2176#ifdef __cplusplus
2177} /* end extern 'C' */
2178#endif
2179
2180#endif /* _H_val_util */
op_editop_t
op_editop_t
NETCONF edit-config operation types.
Definition: op.h:122
val_walker_fn_t
boolean(* val_walker_fn_t)(val_value_t *val, void *cookie1, void *cookie2)
child or descendant node search walker function
Definition: val.h:1171
val_clear_partial_lock
void val_clear_partial_lock(val_value_t *val, plock_cb_t *plcb)
Clear the partial lock throughout the value tree.
Definition: val_util.c:6251
val_remove_false_when_error
status_t val_remove_false_when_error(const xmlChar *name, val_value_t *val, obj_template_t *obj, boolean is_error, boolean real_delete, boolean *deleteme)
Remove false when-stmt nodes with error.
Definition: val_util.c:4685
val_copy_xpathpcb
status_t val_copy_xpathpcb(val_value_t *val, const xpath_pcb_t *xpathpcb)
Set the xpathpcb field with a clone of the parameter.
Definition: val_util.c:4741
val_make_binary_obj
val_value_t * val_make_binary_obj(obj_template_t *obj, const xmlChar *binstr, uint32 binstrlen, status_t *res)
Malloc and set a val_value_t as a NCX_BT_BINARY type.
Definition: val_util.c:4929
val_purge_errors_from_root
void val_purge_errors_from_root(val_value_t *val)
Remove any error nodes under a root container that were saved for error recording purposes.
Definition: val_util.c:3722
val_cache_datarule
status_t val_cache_datarule(val_value_t *val, void *rule)
Set the data-rule back-ptr for this node.
Definition: val_util.c:6916
val_set_errmsg_parm
status_t val_set_errmsg_parm(val_value_t *parentval)
Check the parent value struct (expected to be a container or list) for the errmsg parameter.
Definition: val_util.c:6054
val_merge_return_vals
void val_merge_return_vals(dlq_hdr_t *srcQ, dlq_hdr_t *dstQ)
Merge return values into a dest Q Remove duplicates.
Definition: val_util.c:8332
val_get_choice_first_set_ex
val_value_t * val_get_choice_first_set_ex(val_value_t *val, const obj_template_t *obj, boolean nondef)
Check a val_value_t struct against its expected OBJ to determine if a specific choice has already bee...
Definition: val_util.c:3476
val_make_from_bitstring
val_value_t * val_make_from_bitstring(obj_template_t *obj, typ_def_t *typdef, const xmlChar *buff, uint32 bufflen, status_t *res)
Make a val_value_t with the bits set in the octet string.
Definition: val_util.c:9132
val_check_obj_when
status_t val_check_obj_when(val_value_t *val, val_value_t *valroot, val_value_t *objval, obj_template_t *obj, boolean *condresult, uint32 *whencount)
checks when-stmt only
Definition: val_util.c:4257
val_set_origin
void val_set_origin(val_value_t *val, ncx_nmda_origin_t origin)
Set the NMDA value origin.
Definition: val_util.c:8525
val_make_subtree
status_t val_make_subtree(obj_template_t *obj, dlq_hdr_t *keyQ, val_value_t **topval, val_value_t **targetval)
Create a hierarchy from root to the target object.
Definition: val_util.c:8739
val_remove_false_when
status_t val_remove_false_when(val_value_t *val, boolean *deleteme)
Remove false when-stmt nodes.
Definition: val_util.c:4655
val_set_path_parms
status_t val_set_path_parms(val_value_t *parentval)
Set the main search paths for files.
Definition: val_util.c:5588
val_add_fixed_value_attr
status_t val_add_fixed_value_attr(val_value_t *val)
Add the ywx:fixed-value attribute to a key value node Set it to true since false is the default.
Definition: val_util.c:7651
val_get_value
val_value_t * val_get_value(ses_cb_t *scb, xml_msg_hdr_t *msg, val_value_t *val, val_nodetest_fn_t testfn, boolean acmcheck, boolean *malloced, status_t *res)
Get the value for a node after lots of internal processing.
Definition: val_util.c:6660
val_traverse_keys
void val_traverse_keys(val_value_t *val, void *cookie1, void *cookie2, val_walker_fn_t walkerfn)
Check ancestor-or-self nodes until root reached.
Definition: val_util.c:6801
val_make_from_enumval
val_value_t * val_make_from_enumval(obj_template_t *obj, int32 enumval, status_t *res)
Create an enumeration leaf from its enum value.
Definition: val_util.c:8923
val_instance_check_ex
status_t val_instance_check_ex(val_value_t *root, val_value_t *val, obj_template_t *obj, boolean check_when)
Check for the proper number of object instances for the specified value struct.
Definition: val_util.c:3219
val_write_intern
void val_write_intern(ses_cb_t *scb, const val_value_t *val)
Write an internal buffer to the session.
Definition: val_util.c:6624
val_set_children_load
void val_set_children_load(val_value_t *val)
Flag the CLI parameters coming from the command line.
Definition: val_util.c:8299
val_gen_index_comp
status_t val_gen_index_comp(const obj_key_t *in, val_value_t *val)
Create an index component.
Definition: val_util.c:2840
val_gen_index_chain
status_t val_gen_index_chain(const obj_template_t *obj, val_value_t *val)
Create an index chain for the just-parsed table or container struct.
Definition: val_util.c:2983
val_set_with_ocpattern_parm
status_t val_set_with_ocpattern_parm(val_value_t *parentval)
Handle the –with-ocpattern parameter.
Definition: val_util.c:6015
val_nodetest_fn_t
boolean(* val_nodetest_fn_t)(xml_msg_hdr_t *mhdr, ncx_withdefaults_t withdef, boolean realtest, val_value_t *node)
user function callback template to test output of a specified node.
Definition: val_util.h:132
val_make_simval_obj
val_value_t * val_make_simval_obj(obj_template_t *obj, const xmlChar *valstr, status_t *res)
Create and set a val_value_t as a simple type from an object template instead of individual fields Ca...
Definition: val_util.c:4837
val_force_dataclass_config
void val_force_dataclass_config(val_value_t *val)
Set the dataclass field to NCX_DC_CONFIG in the 'val' data tree
Definition: val_util.c:9270
val_find_notif
val_value_t * val_find_notif(val_value_t *topval)
Check the 'topval' node for a nested notification node.
Definition: val_util.c:9236
val_getbulk_cbfn_t
status_t(* val_getbulk_cbfn_t)(obj_template_t *obj, uint32 start_idx, uint32 max_count, uint32 max_depth, val_nodetest_fn_t node_test_fn, val_getbulk_return_t *getbulk_return)
user function callback template to bulk get operational values of a specified node.
Definition: val_util.h:188
val_write_ok
status_t val_write_ok(val_value_t *val, op_editop_t editop, ses_id_t sesid, boolean checkup, uint32 *lockid)
Check if there are any partial-locks owned by another session in the node that is going to be written...
Definition: val_util.c:6317
val_set_partial_lock
status_t val_set_partial_lock(val_value_t *val, plock_cb_t *plcb)
Set the partial lock throughout the value tree.
Definition: val_util.c:6190
val_set_home_parms
status_t val_set_home_parms(val_value_t *parentval)
Handle the home and yumapro-home parameters.
Definition: val_util.c:5969
val_gen_split_instance_id
status_t val_gen_split_instance_id(xml_msg_hdr_t *mhdr, const val_value_t *val, ncx_instfmt_t format, xmlns_id_t leaf_nsid, const xmlChar *leaf_name, boolean stop_at_root, xmlChar **buff)
Malloc and Generate the instance ID string for this value node, Add the last node from the parameters...
Definition: val_util.c:3982
val_validate_value
status_t val_validate_value(val_value_t *useval)
Verify that the value is valid and can be safely used later Used in the SIL code to ensure that the c...
Definition: val_util.c:8429
val_add_one_operation_attr
status_t val_add_one_operation_attr(val_value_t *val, op_editop_t op)
Add the nc:operation attribute to a value node.
Definition: val_util.c:7194
val_find_descendant_obj
val_value_t * val_find_descendant_obj(val_value_t *val, obj_template_t *obj, val_value_t *testval)
Find the fist available descendant matching the name.
Definition: val_util.c:8842
val_match_datarule
boolean val_match_datarule(const val_value_t *val, void *rule)
Check if the data-rule back-ptr applies to this node.
Definition: val_util.c:6983
val_check_deprecated_warning
status_t val_check_deprecated_warning(val_value_t *val)
Check if any values in the val_value_t are deprecated YANG nodes.
Definition: val_util.c:9302
val_set_canonical_order
void val_set_canonical_order(val_value_t *val)
Set canonical order No longer used.
Definition: val_util.c:2817
val_get_index_string
status_t val_get_index_string(xml_msg_hdr_t *mhdr, ncx_instfmt_t format, boolean force_quotes, const val_value_t *val, xmlChar *buff, uint32 *len)
Get the index string for the specified table or container entry.
Definition: val_util.c:4089
val_make_external_binary_value
val_value_t * val_make_external_binary_value(obj_template_t *obj, xmlChar *fname)
Make an external binary value node.
Definition: val_util.c:7940
val_add_btype_attr
status_t val_add_btype_attr(val_value_t *val, ncx_btype_t btype)
Add the ye:btype attribute to a <key> node for a SIL-SA edit.
Definition: val_util.c:7738
val_set_warning_parms
status_t val_set_warning_parms(val_value_t *parentval)
Check the parent value struct (expected to be a container or list) for the common warning control par...
Definition: val_util.c:5132
val_set_logging_parms_ex
status_t val_set_logging_parms_ex(val_value_t *parentval, const xmlChar *fhs_logfile)
Check the parent value struct (expected to be a container or list) for the full set of logging contro...
Definition: val_util.c:5272
val_choice_is_set
boolean val_choice_is_set(val_value_t *val, obj_template_t *obj)
Check a val_value_t struct against its expected OBJ to determine if a specific choice has already bee...
Definition: val_util.c:3642
val_gen_instance_id
status_t val_gen_instance_id(xml_msg_hdr_t *mhdr, const val_value_t *val, ncx_instfmt_t format, xmlChar **buff)
Malloc and Generate the instance ID string for this value node,.
Definition: val_util.c:3807
val_new_child_val
val_value_t * val_new_child_val(xmlns_id_t nsid, const xmlChar *name, boolean copyname, val_value_t *parent, op_editop_t editop, obj_template_t *obj)
Internal function used by server to create a new child value.
Definition: val_util.c:3749
val_check_swap_resnode
void val_check_swap_resnode(val_value_t *curval, val_value_t *newval)
Maintain partial locks; Used by server only.
Definition: val_util.c:6436
val_set_tcp_connect_parms
status_t val_set_tcp_connect_parms(val_value_t *parentval)
Set TCP Connect parameters.
Definition: val_util.c:9201
val_set_logging_parms
status_t val_set_logging_parms(val_value_t *parentval)
Check the parent value struct (expected to be a container or list) for the common logging control par...
Definition: val_util.c:5230
val_set_message_indent_parm
status_t val_set_message_indent_parm(val_value_t *parentval)
Handle the message-indent parameter.
Definition: val_util.c:5931
val_fixup_config_subtree
void val_fixup_config_subtree(val_value_t *val, xmlns_id_t fixup_id)
Look for a config subtree (obj_is_root) and make sure all the value nodes in the subtree have proper ...
Definition: val_util.c:7417
val_move_config_false
status_t val_move_config_false(val_value_t *newval, val_value_t *curval)
Move the config false data nodes.
Definition: val_util.c:7142
val_make_from_num
val_value_t * val_make_from_num(obj_template_t *obj, typ_def_t *typdef, ncx_btype_t btyp, const ncx_num_t *num, status_t *res)
Create a numeric leaf from a ncx_num_t struct.
Definition: val_util.c:8979
val_get_choice_first_set_full
val_value_t * val_get_choice_first_set_full(val_value_t *val, const obj_template_t *obj)
Check a val_value_t struct against its expected OBJ to determine if a specific choice has already bee...
Definition: val_util.c:3542
val_gen_instance_id_ex
status_t val_gen_instance_id_ex(xml_msg_hdr_t *mhdr, const val_value_t *val, ncx_instfmt_t format, boolean stop_at_root, xmlChar **buff)
Malloc and Generate the instance ID string for this value node,.
Definition: val_util.c:3845
val_dump_cli_valset
void val_dump_cli_valset(const char *progname, val_value_t *valset)
dump the parameter set with and without defaults
Definition: val_util.c:8672
val_convert_anyxml_to_real
status_t val_convert_anyxml_to_real(val_value_t *anyxml_val, val_value_t *real_val, val_value_t **error_val)
Convert anydata nodes to match a real template.
Definition: val_util.c:7798
val_check_delete_resnode
void val_check_delete_resnode(val_value_t *curval)
Check if the curnode has any partial locks and if so, remove them from the final result.
Definition: val_util.c:6489
val_set_subdirs_parm
status_t val_set_subdirs_parm(val_value_t *parentval)
set the subdirs parameter
Definition: val_util.c:5645
val_gen_instance_id_ex2
status_t val_gen_instance_id_ex2(xml_msg_hdr_t *mhdr, const val_value_t *val, const val_value_t *stopval, ncx_instfmt_t format, boolean stop_at_root, xmlChar **buff)
Malloc and Generate the instance ID string for this value node,.
Definition: val_util.c:3886
val_gen_keyclones
status_t val_gen_keyclones(val_value_t *val, dlq_hdr_t *keyQ)
Get all the keys for the specified data node object.
Definition: val_util.c:7528
val_ok_to_partial_lock
status_t val_ok_to_partial_lock(val_value_t *val, ses_id_t sesid, ses_id_t *lockowner)
Check if the specified root val could be locked right now by the specified session.
Definition: val_util.c:6110
val_convert_anyxml_to_real2
status_t val_convert_anyxml_to_real2(val_value_t *anyxml_val, val_value_t *real_val, xml_msg_hdr_t *hdr, val_value_t **error_val)
Convert anydata nodes to match a real template FOR SCHEMA MOUNT SETUP.
Definition: val_util.c:7843
val_set_feature_parms
status_t val_set_feature_parms(val_value_t *parentval)
Handle the YANG feature parameter set.
Definition: val_util.c:5689
val_get_choice_next_set
val_value_t * val_get_choice_next_set(const obj_template_t *obj, val_value_t *curchild)
Check a val_value_t struct against its expected OBJ to determine if a specific choice has already bee...
Definition: val_util.c:3602
val_clear_datarule
void val_clear_datarule(val_value_t *val, const void *rule)
Clear the datarule back-ptr for this node.
Definition: val_util.c:6953
val_add_defaults_ex
status_t val_add_defaults_ex(val_value_t *val, boolean scriptmode, runstack_context_t *rcxt, time_t last_modified, ncx_etag_t etag)
add defaults to an initialized complex value (extended)
Definition: val_util.c:3089
val_make_external_value
val_value_t * val_make_external_value(obj_template_t *obj, xmlChar *fname)
Make an external value node.
Definition: val_util.c:7910
val_expand_var_expr
status_t val_expand_var_expr(val_value_t *val, xmlChar **retstr)
Expand the variable expression if found.
Definition: val_util.c:7296
val_set_simval_obj
status_t val_set_simval_obj(val_value_t *val, obj_template_t *obj, const xmlChar *valstr)
Set an initialized val_value_t as a simple type.
Definition: val_util.c:4895
val_set_anyxml_tracking
void val_set_anyxml_tracking(val_value_t *val, obj_template_t *obj)
Set the anyxml tracking data for this node.
Definition: val_util.c:8575
val_get_value_ex
val_value_t * val_get_value_ex(ses_cb_t *scb, xml_msg_hdr_t *msg, val_value_t *val, val_nodetest_fn_t testfn, boolean acmcheck, boolean *malloced, status_t *res, void *get2cb)
Get the value for a node after lots of internal processing (extended)
Definition: val_util.c:6707
val_build_index_chains
status_t val_build_index_chains(val_value_t *val)
Build index chains for a value if needed.
Definition: val_util.c:6863
val_add_npcons
status_t val_add_npcons(val_value_t *val)
Check/Add empty NP containers.
Definition: val_util.c:3157
val_set_binary_display_maxlen_parm
status_t val_set_binary_display_maxlen_parm(val_value_t *parentval)
Handle the –binary-display-maxlen parameter.
Definition: val_util.c:8388
val_gen_keyptrs
status_t val_gen_keyptrs(val_value_t *val, dlq_hdr_t *keyptrQ)
Get all the keys for the specified data node object.
Definition: val_util.c:7468
val_find_list_from_keyvalQ
val_value_t * val_find_list_from_keyvalQ(val_value_t *parentval, val_value_t *firstmatch, dlq_hdr_t *keyvalQ, status_t *res)
Find the list entry identified by the Q of yangapi_keyval_t strings.
Definition: val_util.c:7039
val_find_descendant
val_value_t * val_find_descendant(val_value_t *val, const xmlChar *modname, const xmlChar *name)
Find the fist available descendant matching the name also check self.
Definition: val_util.c:8792
val_get_anyxml_tracking
void val_get_anyxml_tracking(const val_value_t *val, boolean *iskey, boolean *isconfig, boolean *isunknown)
Set the anyxml tracking data for this node.
Definition: val_util.c:8613
val_make_idref_obj
val_value_t * val_make_idref_obj(obj_template_t *obj, const val_idref_t *leafval, status_t *res)
make a val_value_t for a specified leaf or leaf-list identityref
Definition: val_util.c:4978
val_write_extern
void val_write_extern(ses_cb_t *scb, const val_value_t *val)
Write an external file to the session.
Definition: val_util.c:6524
val_simple_anyxml
boolean val_simple_anyxml(const val_value_t *val)
Check if val_value node is a proper simple type ANYXML.
Definition: val_util.c:7976
val_get_choice_first_set
val_value_t * val_get_choice_first_set(val_value_t *val, const obj_template_t *obj)
Check a val_value_t struct against its expected OBJ to determine if a specific choice has already bee...
Definition: val_util.c:3453
val_get_origin
ncx_nmda_origin_t val_get_origin(const val_value_t *val)
Get the NMDA origin value for this node.
Definition: val_util.c:8494
val_get_xpathpcb
xpath_pcb_t * val_get_xpathpcb(val_value_t *val)
Get the XPath parser control block in the specified value struct.
Definition: val_util.c:4713
val_make_config_root
val_value_t * val_make_config_root(void)
Make a <config> element.
Definition: val_util.c:7252
val_add_datapath_attr
status_t val_add_datapath_attr(val_value_t *val, obj_template_t *obj)
Add the ye:datapath attribute to a node that is tagged as an ywx:datapath node.
Definition: val_util.c:7577
val_add_node_defaults
status_t val_add_node_defaults(obj_template_t *chobj, val_value_t *val, boolean scriptmode, time_t last_modified, ncx_etag_t etag)
Check/Add defaults for the specified node and descendant nodes.
Definition: val_util.c:3121
val_apply_template
status_t val_apply_template(val_value_t *template_val, val_value_t *target_val)
Apply the specified template to the val_value_t node.
Definition: val_util.c:8003
val_get_idref_nsid
xmlns_id_t val_get_idref_nsid(const val_value_t *val)
get the true namespace ID for the identityref value
Definition: val_util.c:8642
val_get_casobj
obj_template_t * val_get_casobj(val_value_t *val)
Get the case object for the value node.
Definition: val_util.c:8547
val_set_ses_protocols_parm
status_t val_set_ses_protocols_parm(ses_cb_t *scb, val_value_t *parentval)
Handle the -protocols parameter for a session.
Definition: val_util.c:5864
val_add_defaults
status_t val_add_defaults(val_value_t *val, boolean scriptmode)
Add defaults to an initialized complex value.
Definition: val_util.c:3043
val_set_protocols_parm
status_t val_set_protocols_parm(val_value_t *parentval)
Handle the –protocols parameter.
Definition: val_util.c:5789
val_set_xpathpcb
status_t val_set_xpathpcb(val_value_t *val, xpath_pcb_t *xpathpcb)
Set the xpathpcb field with passed field;.
Definition: val_util.c:4773
val_instance_check_max
status_t val_instance_check_max(val_value_t *root, val_value_t *val, obj_template_t *obj, boolean check_when, boolean check_deep, ses_cb_t *scb, xml_msg_hdr_t *msg)
Check for the proper number of object instances for the specified value struct.
Definition: val_util.c:3253
val_make_identity_obj
val_value_t * val_make_identity_obj(obj_template_t *obj, typ_def_t *typdef, ncx_identity_t *ident, status_t *res)
make a val_value_t for a specified leaf or leaf-list from an identity
Definition: val_util.c:5045
val_instance_check
status_t val_instance_check(val_value_t *root, val_value_t *val, obj_template_t *obj)
Check for the proper number of object instances for the specified value struct.
Definition: val_util.c:3189
val_is_fixed_value
boolean val_is_fixed_value(val_value_t *val)
Check if the specified value has a fixed-value=true attribute set in it.
Definition: val_util.c:7705
val_type_is_any
boolean val_type_is_any(const val_value_t *val)
Check if val_value node is a proper simple type ANYXML.
Definition: val_util.c:8467
val_get_const_xpathpcb
const xpath_pcb_t * val_get_const_xpathpcb(const val_value_t *val)
Get the XPath parser control block in the specified value struct.
Definition: val_util.c:4802
val_make_internal_value
val_value_t * val_make_internal_value(const xmlChar *name, const xmlChar *value)
Create an NCX_BT_INTERNAL value that contains the raw XML for the value node.
Definition: val_util.c:7875
val_check_obj_when_ex
status_t val_check_obj_when_ex(val_value_t *val, val_value_t *valroot, val_value_t *objval, obj_template_t *obj, xml_msg_hdr_t *mhdr, boolean configonly, boolean get_when, ses_cb_t *pcb_session, struct xpath_get2_cb_t_ *parent_cb, boolean *condresult, uint32 *whencount)
checks when-stmt only (extended)
val_gen_key_entry
status_t val_gen_key_entry(val_value_t *keyval)
Create a key record within an index comp.
Definition: val_util.c:2911
status_t
status_t
global error return code
Definition: status_enum.h:219
ses_id_t
uint32 ses_id_t
Session ID.
Definition: ses.h:407
xmlns_id_t
uint16 xmlns_id_t
integer handle for registered namespaces
Definition: xmlns.h:89
NCX_MAX_GETBULK_COUNT
#define NCX_MAX_GETBULK_COUNT
size of the val_getbulk_array_t in val_util.h
Definition: ncxconst.h:192
ncx_etag_t
uint32 ncx_etag_t
The ETag used in RESTCONF messages is the lower 32 bits of a ncx_transaction_id_t.
Definition: ncxtypes.h:750
ncx_btype_t
ncx_btype_t
enumeration of the built-in NCX types These types cannot be overridden and cannot be imported
Definition: ncxtypes.h:213
ncx_nmda_origin_t
ncx_nmda_origin_t
internal enumerations for standard NMDA origins
Definition: ncxtypes.h:1623
ncx_withdefaults_t
ncx_withdefaults_t
enum for with-defaults enum values
Definition: ncxtypes.h:1259
ncx_instfmt_t
ncx_instfmt_t
instance identifier string format types
Definition: ncxtypes.h:562
ncxtypes.h
YANG module data structures Many internal representations of YANG module constructs.
obj.h
Data Object Support.
op.h
NETCONF protocol operations.
plock.h
RFC 57517 partial lock support.
runstack.h
CLI run stack manager.
ses.h
NETCONF Session Common definitions module.
status.h
Global error messages for status code enumerations.
ncx_identity_t
YANG identity entry.
Definition: ncxtypes.h:1084
obj_key_t
One YANG list key component.
Definition: obj.h:838
obj_template_t
One YANG data-def-stmt.
Definition: obj.h:1284
plock_cb_t
struct representing 1 configuration database
Definition: plock_cb.h:81
runstack_context_t
Main runstact context control block used by yangcli to process script input loops and conditional sta...
Definition: runstack.h:256
ses_cb_t
Session Control Block.
Definition: ses.h:759
typ_def_t
Discriminated union for all data typedefs.
Definition: typ.h:458
val_getbulk_return_t
return value for a getbulk callback function
Definition: val_util.h:154
val_getbulk_return_t::retcount
uint32 retcount
actual return count
Definition: val_util.h:159
val_getbulk_return_t::retdone
boolean retdone
flag to indicate return is complete
Definition: val_util.h:162
val_idref_t
one QName for the NCX_BT_IDREF value
Definition: val.h:818
val_value_t
one value to match one type
Definition: val.h:939
xml_msg_hdr_t
Common Encoding Message Header No longer XML specific!! Used by JSON and CBOR parsing as well!...
Definition: xml_msg.h:417
xpath_pcb_t
XPath parser control block.
Definition: xpath.h:754
ncx_num_t
union of all the basic number types if float not supported, then it is stored as an int64
Definition: ncxtypes.h:763
val.h
Value Node Basic Support.
xml_msg.h
XML and JSON Message send and receive support.
xmlns.h
XML namespace support.
xpath.h
Schema and data model Xpath search support.