yumapro  25.10-3
YumaPro SDK
Loading...
Searching...
No Matches
agt_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_agt_util
13#define _H_agt_util
14
15/* FILE: agt_util.h
16*********************************************************************
17* *
18* P U R P O S E *
19* *
20*********************************************************************/
21
32/*********************************************************************
33* *
34* C H A N G E H I S T O R Y *
35* *
36*********************************************************************
37
38date init comment
39----------------------------------------------------------------------
4024-may-06 abb Begun
41
42*/
43
44#ifndef _H_agt
45#include "agt.h"
46#endif
47
48#ifndef _H_agt_cfg
49#include "agt_cfg.h"
50#endif
51
52#ifndef _H_cfg
53#include "cfg.h"
54#endif
55
56#ifndef _H_dlq
57#include "dlq.h"
58#endif
59
60#ifndef _H_getcb
61#include "getcb.h"
62#endif
63
64#ifndef _H_ncxconst
65#include "ncxconst.h"
66#endif
67
68#ifndef _H_ncxtypes
69#include "ncxtypes.h"
70#endif
71
72#ifndef _H_obj
73#include "obj.h"
74#endif
75
76#ifndef _H_rpc
77#include "rpc.h"
78#endif
79
80#ifndef _H_ses
81#include "ses.h"
82#endif
83
84#ifndef _H_status
85#include "status.h"
86#endif
87
88#ifndef _H_val
89#include "val.h"
90#endif
91
92#ifndef _H_xml_msg
93#include "xml_msg.h"
94#endif
95
96#ifndef _H_xml_util
97#include "xml_util.h"
98#endif
99
100#ifndef _H_xpath
101#include "xpath.h"
102#endif
103
104#ifndef _H_yang_patch
105#include "yang_patch.h"
106#endif
107
108#ifdef __cplusplus
109extern "C" {
110#endif
111
112/********************************************************************
113* *
114* F U N C T I O N S *
115* *
116*********************************************************************/
117
143extern status_t
144 agt_get_cfg_from_parm (const xmlChar *parmname,
145 rpc_msg_t *msg,
146 xml_node_t *methnode,
147 cfg_template_t **retcfg);
148
149
161extern status_t
162 agt_get_inline_cfg_from_parm (const xmlChar *parmname,
163 rpc_msg_t *msg,
164 xml_node_t *methnode,
165 val_value_t **retval);
166
167
190extern status_t
191 agt_get_url_from_parm (const xmlChar *parmname,
192 rpc_msg_t *msg,
193 xml_node_t *methnode,
194 const xmlChar **returl,
195 val_value_t **retval);
196
197
207extern xmlChar *
208 agt_get_filespec_from_url (const xmlChar *urlstr,
209 status_t *res);
210
211
223extern const val_value_t *
224 agt_get_parmval (const xmlChar *parmname,
225 rpc_msg_t *msg);
226
227
259extern void
260 agt_record_error (ses_cb_t *scb,
261 xml_msg_hdr_t *msghdr,
262 ncx_layer_t layer,
263 status_t res,
264 const xml_node_t *xmlnode,
265 ncx_node_t parmtyp,
266 const void *error_info,
267 ncx_node_t nodetyp,
268 void *error_path);
269
270
284extern void
285 agt_record_error_obj (ses_cb_t *scb,
286 xml_msg_hdr_t *msghdr,
287 status_t res,
288 obj_template_t *errobj,
289 const xmlChar *badval);
290
291
325extern void
326 agt_record_error_errinfo (ses_cb_t *scb,
327 xml_msg_hdr_t *msghdr,
328 ncx_layer_t layer,
329 status_t res,
330 const xml_node_t *xmlnode,
331 ncx_node_t parmtyp,
332 const void *error_info,
333 ncx_node_t nodetyp,
334 void *error_path,
335 const ncx_errinfo_t *errinfo);
336
337
374extern void
375 agt_record_warning (ses_cb_t *scb,
376 xml_msg_hdr_t *msghdr,
377 ncx_layer_t layer,
378 status_t res,
379 const xml_node_t *xmlnode,
380 ncx_node_t parmtyp,
381 const void *error_parm,
382 ncx_node_t nodetyp,
383 void *error_path,
384 const ncx_errinfo_t *errinfo);
385
386
410extern void
411 agt_record_attr_error (ses_cb_t *scb,
412 xml_msg_hdr_t *msghdr,
413 ncx_layer_t layer,
414 status_t res,
415 const xml_attr_t *xmlattr,
416 const xml_node_t *xmlnode,
417 const xmlChar *badns,
418 ncx_node_t nodetyp,
419 void *errnode);
420
421
440extern void
441 agt_record_insert_error (ses_cb_t *scb,
442 xml_msg_hdr_t *msghdr,
443 status_t res,
444 val_value_t *errval);
445
446
465extern void
466 agt_record_unique_error (ses_cb_t *scb,
467 xml_msg_hdr_t *msghdr,
468 val_value_t *errval,
469 dlq_hdr_t *valuniqueQ);
470
471
483extern status_t
484 agt_validate_filter (ses_cb_t *scb,
485 rpc_msg_t *msg);
486
487
500extern status_t
501 agt_validate_filter_ex (ses_cb_t *scb,
502 rpc_msg_t *msg,
503 val_value_t *filter);
504
505
518extern status_t
519 agt_validate_filter_nmda (rpc_msg_t *msg,
520 val_value_t *filter,
521 boolean is_subtree,
522 boolean is_operational);
523
524
539extern boolean
540 agt_check_config (xml_msg_hdr_t *mhdr,
541 ncx_withdefaults_t withdef,
542 boolean realtest,
543 val_value_t *node);
544
545
562extern boolean
563 agt_check_default (xml_msg_hdr_t *mhdr,
564 ncx_withdefaults_t withdef,
565 boolean realtest,
566 val_value_t *node);
567
568
585extern boolean
586 agt_check_config_false (xml_msg_hdr_t *mhdr,
587 ncx_withdefaults_t withdef,
588 boolean realtest,
589 val_value_t *node);
590
591
610extern boolean
611 agt_check_config_false_default (xml_msg_hdr_t *mhdr,
612 ncx_withdefaults_t withdef,
613 boolean realtest,
614 val_value_t *node);
615
616
633extern boolean
634 agt_check_save (xml_msg_hdr_t *mhdr,
635 ncx_withdefaults_t withdef,
636 boolean realtest,
637 val_value_t *node);
638
639
656extern boolean
657 agt_check_modtags (xml_msg_hdr_t *mhdr,
658 ncx_withdefaults_t withdef,
659 boolean realtest,
660 val_value_t *node);
661
662
679extern boolean agt_check_basic (xml_msg_hdr_t *mhdr,
680 ncx_withdefaults_t withdef,
681 boolean realtest,
682 val_value_t *node);
683
684
696extern status_t
697 agt_output_filter (ses_cb_t *scb,
698 rpc_msg_t *msg,
699 int32 indent);
700
701
712extern status_t
713 agt_output_schema (ses_cb_t *scb,
714 rpc_msg_t *msg,
715 int32 indent);
716
717
729extern status_t
730 agt_output_empty (ses_cb_t *scb,
731 rpc_msg_t *msg,
732 int32 indent);
733
734
744extern status_t
745 agt_check_max_access (val_value_t *newval,
746 boolean cur_exists);
747
748
787extern status_t
788 agt_check_editop (op_editop_t pop,
789 op_editop_t *cop,
790 val_value_t *newnode,
791 val_value_t *curnode,
792 ncx_iqual_t iqual,
793 ncx_protocol_t proto,
794 boolean is_commit,
795 boolean *delete_default);
796
797
810extern status_t
811 agt_enable_feature (const xmlChar *modname,
812 const xmlChar *featurename);
813
814
827extern status_t
828 agt_disable_feature (const xmlChar *modname,
829 const xmlChar *featurename);
830
831
847extern val_value_t *
848 agt_make_leaf (obj_template_t *parentobj,
849 const xmlChar *leafname,
850 const xmlChar *leafstrval,
851 status_t *res);
852
853
869extern val_value_t *
870 agt_make_uint_leaf (obj_template_t *parentobj,
871 const xmlChar *leafname,
872 uint32 leafval,
873 status_t *res);
874
890extern val_value_t *
891 agt_make_int_leaf (obj_template_t *parentobj,
892 const xmlChar *leafname,
893 int32 leafval,
894 status_t *res);
895
896
912extern val_value_t *
913 agt_make_uint64_leaf (obj_template_t *parentobj,
914 const xmlChar *leafname,
915 uint64 leafval,
916 status_t *res);
917
918
934extern val_value_t *
935 agt_make_int64_leaf (obj_template_t *parentobj,
936 const xmlChar *leafname,
937 int64 leafval,
938 status_t *res);
939
940
957extern val_value_t *
958 agt_make_idref_leaf (obj_template_t *parentobj,
959 const xmlChar *leafname,
960 const val_idref_t *leafval,
961 status_t *res);
962
963
978extern val_value_t *
979 agt_make_list (obj_template_t *parentobj,
980 const xmlChar *listname,
981 status_t *res);
982
983
994extern val_value_t *
995 agt_make_object (obj_template_t *parentobj,
996 const xmlChar *objname,
997 status_t *res);
998
999
1000#define agt_make_virtual_node agt_make_virtual_leaf
1001
1002
1021extern val_value_t *
1022 agt_make_virtual_leaf (obj_template_t *parentobj,
1023 const xmlChar *leafname,
1024 getcb_fn_t callbackfn,
1025 status_t *res);
1026
1027
1041extern status_t
1042 agt_add_top_virtual (obj_template_t *obj,
1043 getcb_fn_t callbackfn);
1044
1045
1067extern status_t
1068 agt_add_top_container (obj_template_t *obj,
1069 val_value_t **val);
1070
1071
1095extern status_t
1096 agt_add_container (const xmlChar *modname,
1097 const xmlChar *objname,
1098 val_value_t *parentval,
1099 val_value_t **val);
1100
1101
1102
1119extern val_value_t *
1120 agt_init_cache (const xmlChar *modname,
1121 const xmlChar *objname,
1122 status_t *res);
1123
1124
1142extern status_t
1143 agt_check_cache (val_value_t **cacheptr,
1144 val_value_t *newval,
1145 val_value_t *curval,
1146 op_editop_t editop);
1147
1148
1162extern xpath_pcb_t *
1163 agt_new_xpath_pcb (ses_cb_t *scb,
1164 const xmlChar *expr,
1165 status_t *res);
1166
1167
1180extern xmlChar *
1181 agt_make_srid_filespec (const xmlChar *basestr,
1182 const xmlChar *patstr,
1183 const xmlChar *valstr);
1184
1194extern xmlChar *
1195 agt_get_startup_filespec (status_t *res);
1196
1197
1210extern xmlChar *
1211 agt_get_target_filespec (const xmlChar *target_url,
1212 status_t *res);
1213
1214
1236extern status_t
1237 agt_set_mod_defaults (ncx_module_t *mod,
1238 val_value_t *valroot,
1239 boolean set_candidate,
1240 boolean set_augment,
1241 boolean force);
1242
1243
1252extern status_t
1253 agt_set_val_defaults (val_value_t *val);
1254
1255
1277extern status_t
1278 agt_set_with_defaults (rpc_msg_t *msg,
1279 const xmlChar *modname,
1280 val_value_t **errval);
1281
1282
1292extern void
1293 agt_set_with_owners (rpc_msg_t *msg);
1294
1295
1304extern void
1305 agt_set_depth (rpc_msg_t *msg);
1306
1307
1316extern void
1317 agt_set_depth_nmda (rpc_msg_t *msg);
1318
1319
1336extern val_value_t *
1337 agt_get_key_value (val_value_t *startval,
1338 val_value_t **lastkey);
1339
1340
1361extern val_value_t *
1362 agt_add_top_node_if_missing (ncx_module_t *mod,
1363 const xmlChar *objname,
1364 boolean *added,
1365 status_t *res);
1366
1376extern boolean
1377 agt_any_operations_set (val_value_t *val);
1378
1379
1391extern boolean
1392 agt_apply_this_node (op_editop_t editop,
1393 const val_value_t *newnode,
1394 const val_value_t *curnode);
1395
1396
1417extern boolean
1418 agt_apply_this_node_ex (op_editop_t editop,
1419 const val_value_t *newnode,
1420 const val_value_t *curnode,
1421 boolean ignore_defaults,
1422 boolean childonly,
1423 boolean top_replace);
1424
1425
1433extern boolean
1434 agt_backups_enabled (void);
1435
1436
1446extern xpath_result_t *
1447 agt_get_result_from_xpath (xpath_pcb_t *pcb,
1448 val_value_t *rootval,
1449 status_t *retres);
1450
1451
1460extern val_value_t *
1461 agt_get_first_result_val (xpath_result_t *result);
1462
1463
1478extern void
1479 agt_output_start_container (ses_cb_t *scb,
1480 xml_msg_hdr_t *mhdr,
1481 xmlns_id_t parent_nsid,
1482 xmlns_id_t node_nsid,
1483 const xmlChar *node_name,
1484 int32 indent);
1485
1486
1502extern void
1503 agt_output_start_node (ses_cb_t *scb,
1504 xml_msg_hdr_t *mhdr,
1505 xmlns_id_t parent_nsid,
1506 xmlns_id_t node_nsid,
1507 const xmlChar *node_name,
1508 int32 indent,
1509 boolean try_modname);
1510
1511
1512
1532extern void
1533 agt_output_start_node2 (ses_cb_t *scb,
1534 xml_msg_hdr_t *mhdr,
1535 xmlns_id_t parent_nsid,
1536 xmlns_id_t node_nsid,
1537 const xmlChar *node_name,
1538 int32 indent,
1539 boolean try_modname,
1540 val_value_t *metaval);
1541
1542
1543
1565extern void
1566 agt_output_start_errors_container (ses_cb_t *scb,
1567 xml_msg_hdr_t *mhdr,
1568 xmlns_id_t parent_nsid,
1569 xmlns_id_t nsid,
1570 const xmlChar *elname,
1571 const dlq_hdr_t *attrQ,
1572 boolean isattrq,
1573 int32 indent,
1574 boolean empty);
1575
1576
1589extern void
1590 agt_output_end_container (ses_cb_t *scb,
1591 xml_msg_hdr_t *mhdr,
1592 xmlns_id_t node_nsid,
1593 const xmlChar *node_name,
1594 int32 indent);
1595
1596
1605extern boolean
1606 agt_match_etag (val_value_t *val,
1607 const xmlChar *etag);
1608
1609
1620extern boolean
1621 agt_match_etag_binary (val_value_t *val,
1622 ncx_etag_t etag);
1623
1624
1635extern boolean
1636 agt_modified_since (val_value_t *val,
1637 time_t *timerec);
1638
1639
1648extern boolean
1649 agt_notifications_enabled (void);
1650
1651
1668extern val_value_t *
1669 agt_make_leaf2 (obj_template_t *parentobj,
1670 const xmlChar *modname,
1671 const xmlChar *leafname,
1672 const xmlChar *leafstrval,
1673 status_t *res);
1674
1675
1689extern val_value_t *
1690 agt_make_union_leaf (obj_template_t *parentobj,
1691 const xmlChar *modname,
1692 const xmlChar *leafname,
1693 const val_value_t *leafval,
1694 status_t *res);
1695
1696
1713extern val_value_t *
1714 agt_make_uint_leaf2 (obj_template_t *parentobj,
1715 const xmlChar *modname,
1716 const xmlChar *leafname,
1717 uint32 leafval,
1718 status_t *res);
1719
1720
1737extern val_value_t *
1738 agt_make_int_leaf2 (obj_template_t *parentobj,
1739 const xmlChar *modname,
1740 const xmlChar *leafname,
1741 int32 leafval,
1742 status_t *res);
1743
1744
1761extern val_value_t *
1762 agt_make_uint64_leaf2 (obj_template_t *parentobj,
1763 const xmlChar *modname,
1764 const xmlChar *leafname,
1765 uint64 leafval,
1766 status_t *res);
1767
1768
1785extern val_value_t *
1786 agt_make_int64_leaf2 (obj_template_t *parentobj,
1787 const xmlChar *modname,
1788 const xmlChar *leafname,
1789 int64 leafval,
1790 status_t *res);
1791
1792
1813extern val_value_t *
1814 agt_make_idref_leaf2 (obj_template_t *parentobj,
1815 const xmlChar *modname,
1816 const xmlChar *leafname,
1817 const val_idref_t *leafval,
1818 status_t *res);
1819
1820
1834extern val_value_t *
1835 agt_make_bits_leaf (obj_template_t *parentobj,
1836 const xmlChar *modname,
1837 const xmlChar *leafname,
1838 const ncx_list_t *listval,
1839 status_t *res);
1840
1841
1855extern val_value_t *
1856 agt_make_boolean_leaf (obj_template_t *parentobj,
1857 const xmlChar *modname,
1858 const xmlChar *leafname,
1859 boolean boolval,
1860 status_t *res);
1861
1862
1876extern val_value_t *
1877 agt_make_empty_leaf (obj_template_t *parentobj,
1878 const xmlChar *modname,
1879 const xmlChar *leafname,
1880 boolean boolval,
1881 status_t *res);
1882
1883
1899extern val_value_t *
1900 agt_make_object2 (obj_template_t *parentobj,
1901 const xmlChar *modname,
1902 const xmlChar *objname,
1903 status_t *res);
1904
1905
1927extern val_value_t *
1928 agt_make_virtual_leaf2 (obj_template_t *parentobj,
1929 const xmlChar *modname,
1930 const xmlChar *leafname,
1931 getcb_fn_t callbackfn,
1932 status_t *res);
1933
1934
1948extern ncx_cfg_t
1949 agt_get_edit_config_id (rpc_msg_t *rpcmsg);
1950
1951
1961extern boolean
1962 agt_module_in_cli_valset (const xmlChar *modname);
1963
1964
1972extern void
1973 agt_set_basic_withdef_enabled (void);
1974
1975
1976
1986extern boolean
1987 agt_check_delete_all_allowed (obj_template_t *testobj);
1988
1989
2001extern op_editop_t
2002 agt_cvt_editop (op_editop_t editop,
2003 const val_value_t *newval,
2004 const val_value_t *curval);
2005
2006
2016extern op_editop_t
2017 agt_cvt_editop_acm (op_editop_t editop,
2018 const val_value_t *newval,
2019 const val_value_t *curval);
2020
2021
2032extern op_editop_t
2033 agt_cvt_editop_ex (op_editop_t editop,
2034 const val_value_t *newval,
2035 const val_value_t *curval);
2036
2037
2048extern int
2049 agt_connect_client (const xmlChar *hostname,
2050 uint16_t port);
2051
2052
2053
2065extern int
2066 agt_connect_udp_client (const xmlChar *hostname,
2067 uint16_t port,
2068 boolean *is_ipv6);
2069
2070
2087extern status_t
2088 agt_find_in_datastore (ncx_cfg_t cfg_id,
2089 val_value_t *err_value,
2090 val_value_t **retval);
2091
2092
2101extern uint32
2102 agt_get_error_count (rpc_msg_t *msg);
2103
2104
2115extern val_value_t *
2116 agt_get_rpc_input (rpc_msg_t *msg);
2117
2118
2127extern obj_template_t *
2128 agt_get_rpc_output_obj (rpc_msg_t *msg);
2129
2130
2131
2140extern obj_template_t *
2141 agt_get_action_output_obj (val_value_t *actionval);
2142
2143
2152extern const xmlChar*
2153 agt_getTermReasonStr ( ses_term_reason_t termreason);
2154
2155
2156#ifdef PTHREADS
2166extern boolean
2167 agt_get_ok_for_nolock (rpc_msg_t *msg);
2168
2169
2179extern boolean
2180 agt_getbulk_ok_for_nolock (const xmlChar *pathstr);
2181
2182#endif // PTHREADS
2183
2184
2195extern boolean
2196 agt_op_ok_for_maintenance_mode (const obj_template_t *rpcobj);
2197
2198
2207extern const xmlChar *
2208 agt_crl_mode_str (agt_crl_mode_t crl_mode);
2209
2210
2219extern agt_crl_mode_t
2220 agt_crl_mode_enum (const xmlChar *crl_mode);
2221
2222
2234extern val_nodetest_fn_t
2235 agt_util_get_testfn (xml_msg_hdr_t *msg,
2236 boolean getop);
2237
2238
2239
2256extern status_t
2257 agt_fill_dummy_method (const xmlChar *modname,
2258 const xmlChar *rpcname,
2259 xml_node_t *node,
2260 obj_template_t **rpcobj);
2261
2262
2278extern yang_patch_cb_t *
2279 agt_make_yang_patch_cb (const xmlChar *patch_id,
2280 const xmlChar *the_comment,
2281 const xmlChar *patch_root,
2282 agt_cfg_transaction_t *txcb,
2283 uint32 included_changes);
2284
2285
2302extern yang_patch_cb_t *
2303 agt_make_yang_patch_cb_targobj (const xmlChar *patch_id,
2304 const xmlChar *the_comment,
2305 const xmlChar *patch_root,
2306 agt_cfg_transaction_t *txcb,
2307 uint32 included_changes,
2308 obj_template_t *targobj);
2309
2310
2325extern yang_patch_cb_t *
2326 agt_make_yang_patch_cb_file (const xmlChar *patch_id,
2327 const xmlChar *the_comment,
2328 const xmlChar *patch_root,
2329 const xmlChar *filespec,
2330 boolean is_binary);
2331
2332
2348extern boolean
2349 agt_check_included_changes (agt_cfg_transaction_t *txcb,
2350 uint32 included_changes,
2351 obj_template_t *targobj);
2352
2353
2354
2355
2356
2372extern status_t
2373 agt_add_leafy (val_value_t *parentval,
2374 const xmlChar *modname,
2375 const xmlChar *leafname,
2376 const xmlChar *leafstrval);
2377
2378
2394extern status_t
2395 agt_add_uint_leafy (val_value_t *parentval,
2396 const xmlChar *modname,
2397 const xmlChar *leafname,
2398 uint32 leafval);
2399
2400
2401
2417extern status_t
2418 agt_add_int_leafy (val_value_t *parentval,
2419 const xmlChar *modname,
2420 const xmlChar *leafname,
2421 int32 leafval);
2422
2423
2439extern status_t
2440 agt_add_uint64_leafy (val_value_t *parentval,
2441 const xmlChar *modname,
2442 const xmlChar *leafname,
2443 uint64 leafval);
2444
2445
2461extern status_t
2462 agt_add_int64_leafy (val_value_t *parentval,
2463 const xmlChar *modname,
2464 const xmlChar *leafname,
2465 int64 leafval);
2466
2467
2468
2484extern status_t
2485 agt_add_boolean_leafy (val_value_t *parentval,
2486 const xmlChar *modname,
2487 const xmlChar *leafname,
2488 boolean boolval);
2489
2490
2509extern status_t
2510 agt_add_idref_leafy (val_value_t *parentval,
2511 const xmlChar *modname,
2512 const xmlChar *leafname,
2513 const val_idref_t *leafval);
2514
2515
2534extern status_t
2535 agt_add_bits_leafy (val_value_t *parentval,
2536 const xmlChar *modname,
2537 const xmlChar *leafname,
2538 const ncx_list_t *leafval);
2539
2540
2541
2542
2543/***** APIS USED FOR NESTED NOTIFICATION GENERATION ****/
2544
2545
2556extern val_value_t *
2557 agt_make_string_key (const xmlChar *leafval);
2558
2559
2560
2571extern val_value_t *
2572 agt_make_uint_key (uint32 leafval);
2573
2574
2575
2586extern val_value_t *
2587 agt_make_int_key (int32 leafval);
2588
2589
2590
2601extern val_value_t *
2602 agt_make_uint64_key (uint64 leafval);
2603
2604
2605
2616extern val_value_t *
2617 agt_make_int64_key (int64 leafval);
2618
2619
2620
2631extern val_value_t *
2632 agt_make_boolean_key (boolean leafval);
2633
2634
2645extern val_value_t *
2646 agt_make_idref_key (const val_idref_t *leafval);
2647
2648
2659extern val_value_t *
2660 agt_make_bits_key (const ncx_list_t *leafval);
2661
2662
2663/*
2664* @brief make a generic key leaf node from a union
2665*
2666* - OK for SIL or SIL-SA
2667*
2668* @param leafval union version of value to set for key leaf
2669* @return malloced value node
2670*/
2671extern val_value_t *
2672 agt_make_union_key (const val_value_t *leafval);
2673
2674
2685extern status_t
2686 agt_get_sid_set_id (xmlChar *buff,
2687 uint32 bufflen);
2688
2689
2690
2691
2727extern status_t
2728 agt_xpath_force_true (struct xpath_pcb_t_ *pcb,
2729 val_value_t *context,
2730 val_value_t *docroot,
2731 boolean *result);
2732
2733
2770extern status_t
2771 agt_xpath_example (struct xpath_pcb_t_ *pcb,
2772 val_value_t *context,
2773 val_value_t *docroot,
2774 boolean *result);
2775
2776
2777
2794extern agt_edit_parms_cb_t *
2795 agt_new_edit_parms (const xmlChar *patch_id_str,
2796 boolean system_edit,
2797 boolean skip_sil,
2798 const xmlChar *comment);
2799
2800
2817extern status_t
2818 agt_init_edit_parms (agt_edit_parms_cb_t *parms,
2819 const xmlChar *patch_id_str,
2820 boolean system_edit,
2821 boolean skip_sil,
2822 const xmlChar *comment);
2823
2824
2825
2834extern void
2835 agt_clean_edit_parms (agt_edit_parms_cb_t *parms);
2836
2837
2846extern void
2847 agt_free_edit_parms (agt_edit_parms_cb_t *parms);
2848
2849
2873extern status_t
2874 agt_add_patch_edit (agt_edit_parms_cb_t *parms,
2875 const xmlChar *edit_id_str,
2876 const xmlChar *edit_target,
2877 const xmlChar *edit_operation,
2878 const xmlChar *edit_xml_value,
2879 const xmlChar *insert_point,
2880 const xmlChar *insert_where);
2881
2882
2902extern status_t
2903 agt_apply_patch_edit (ses_cb_t *scb,
2904 agt_edit_parms_cb_t *parms);
2905
2906
2907/*
2908* @brief create malloced struct with SA Push parms
2909*
2910* @return malloced struct
2911* @see agt_free_sa_push_parms
2912*/
2913extern agt_sa_push_parms_t *
2914 agt_new_sa_push_parms (void);
2915
2916
2917/*
2918* @brief free malloced SA parms
2919*
2920* @param sa_parms malloced struct to free
2921* @see agt_new_sa_push_parms
2922*/
2923extern void
2924 agt_free_sa_push_parms (agt_sa_push_parms_t *sa_parms);
2925
2934extern agt_sa_push_parms_t *
2935 agt_cvt_val2parms (val_value_t *reqval,
2936 status_t *res);
2937
2938
2939
2940
2941
2961extern status_t
2962 agt_get_bulktest (const xml_msg_hdr_t *msg,
2963 const obj_template_t *obj,
2964 const xpath_pcb_t **retpcb,
2965 const xmlChar **retexpr);
2966
2967
2973extern void
2974 agt_print_error_headers (void);
2975
2976
2980#ifdef __cplusplus
2981} /* end extern 'C' */
2982#endif
2983
2984#endif /* _H_agt_util */
agt.h
Multi-Protocol Network Management Server.
agt_cfg.h
Manage Server configuration edit transactions.
cfg.h
NCX configuration database manager.
dlq.h
dlq provides general double-linked list and queue support:
getcb.h
GET1 and GET2 Callback Support.
agt_crl_mode_t
agt_crl_mode_t
server TLS CRL mode
Definition: agt.h:845
agt_make_boolean_leaf
val_value_t * agt_make_boolean_leaf(obj_template_t *parentobj, const xmlChar *modname, const xmlChar *leafname, boolean boolval, status_t *res)
make a val_value_t struct for a specified leaf or leaf-list (NCX_BT_BOOL)
Definition: agt_util.c:6653
agt_get_rpc_output_obj
obj_template_t * agt_get_rpc_output_obj(rpc_msg_t *msg)
Get the rpc output object template.
Definition: agt_util.c:7389
agt_modified_since
boolean agt_modified_since(val_value_t *val, time_t *timerec)
Check if the timestamp for the object is later then the specified timestamp.
Definition: agt_util.c:6247
agt_notifications_enabled
boolean agt_notifications_enabled(void)
Check if notifications are enabled.
Definition: agt_util.c:6270
agt_make_leaf2
val_value_t * agt_make_leaf2(obj_template_t *parentobj, const xmlChar *modname, const xmlChar *leafname, const xmlChar *leafstrval, status_t *res)
make a val_value_t struct for a specified leaf or leaf-list
Definition: agt_util.c:6292
agt_add_int64_leafy
status_t agt_add_int64_leafy(val_value_t *parentval, const xmlChar *modname, const xmlChar *leafname, int64 leafval)
make a child node from a int64 and add to parent.
Definition: agt_util.c:8489
agt_check_max_access
status_t agt_check_max_access(val_value_t *newval, boolean cur_exists)
Check if the max-access for a parameter is exceeded.
Definition: agt_util.c:3568
agt_add_uint64_leafy
status_t agt_add_uint64_leafy(val_value_t *parentval, const xmlChar *modname, const xmlChar *leafname, uint64 leafval)
make a child node from a uint64 and add to parent.
Definition: agt_util.c:8435
agt_backups_enabled
boolean agt_backups_enabled(void)
Check if the backup commands are enabled.
Definition: agt_util.c:5827
agt_make_idref_leaf2
val_value_t * agt_make_idref_leaf2(obj_template_t *parentobj, const xmlChar *modname, const xmlChar *leafname, const val_idref_t *leafval, status_t *res)
make a val_value_t struct for a specified leaf or leaf-list
Definition: agt_util.c:6537
agt_make_uint_key
val_value_t * agt_make_uint_key(uint32 leafval)
make a generic key leaf node from a uint
Definition: agt_util.c:8739
agt_make_int_leaf
val_value_t * agt_make_int_leaf(obj_template_t *parentobj, const xmlChar *leafname, int32 leafval, status_t *res)
make an int32 val_value_t struct for a specified leaf or leaf-list
Definition: agt_util.c:4245
agt_record_error_errinfo
void agt_record_error_errinfo(ses_cb_t *scb, xml_msg_hdr_t *msghdr, ncx_layer_t layer, status_t res, const xml_node_t *xmlnode, ncx_node_t parmtyp, const void *error_info, ncx_node_t nodetyp, void *error_path, const ncx_errinfo_t *errinfo)
Generate an rpc_err_rec_t and save it in the msg Use provided error fields.
Definition: agt_util.c:2495
agt_xpath_force_true
status_t agt_xpath_force_true(struct xpath_pcb_t_ *pcb, val_value_t *context, val_value_t *docroot, boolean *result)
XPath Boolean EVAL Replacement Callback.
Definition: agt_util.c:9044
agt_make_uint_leaf
val_value_t * agt_make_uint_leaf(obj_template_t *parentobj, const xmlChar *leafname, uint32 leafval, status_t *res)
make a uint32 val_value_t struct for a specified leaf or leaf-list
Definition: agt_util.c:4226
agt_get_action_output_obj
obj_template_t * agt_get_action_output_obj(val_value_t *actionval)
Get the action output object template.
Definition: agt_util.c:7416
agt_make_virtual_leaf
val_value_t * agt_make_virtual_leaf(obj_template_t *parentobj, const xmlChar *leafname, getcb_fn_t callbackfn, status_t *res)
make a val_value_t struct for a specified virtual leaf or leaf-list
Definition: agt_util.c:4396
agt_add_bits_leafy
status_t agt_add_bits_leafy(val_value_t *parentval, const xmlChar *modname, const xmlChar *leafname, const ncx_list_t *leafval)
make a child node from a ncx_list_t struct (bits) and add to parent.
Definition: agt_util.c:8661
agt_record_error
void agt_record_error(ses_cb_t *scb, xml_msg_hdr_t *msghdr, ncx_layer_t layer, status_t res, const xml_node_t *xmlnode, ncx_node_t parmtyp, const void *error_info, ncx_node_t nodetyp, void *error_path)
Generate an rpc_err_rec_t and save it in the msg.
Definition: agt_util.c:2386
agt_apply_patch_edit
status_t agt_apply_patch_edit(ses_cb_t *scb, agt_edit_parms_cb_t *parms)
SIL version of the db_api_send_edt_full2 API.
Definition: agt_util.c:9344
agt_add_idref_leafy
status_t agt_add_idref_leafy(val_value_t *parentval, const xmlChar *modname, const xmlChar *leafname, const val_idref_t *leafval)
make a child node from a val_idref_t struct and add to parent.
Definition: agt_util.c:8601
agt_new_xpath_pcb
xpath_pcb_t * agt_new_xpath_pcb(ses_cb_t *scb, const xmlChar *expr, status_t *res)
Get a new XPath parser control block and set up the server variable bindings.
Definition: agt_util.c:4703
agt_make_int64_key
val_value_t * agt_make_int64_key(int64 leafval)
make a generic key leaf node from an int64
Definition: agt_util.c:8813
agt_make_list
val_value_t * agt_make_list(obj_template_t *parentobj, const xmlChar *listname, status_t *res)
make a val_value_t struct for a specified list
Definition: agt_util.c:4339
agt_get_parmval
const val_value_t * agt_get_parmval(const xmlChar *parmname, rpc_msg_t *msg)
Get the identified val_value_t for a given parameter.
Definition: agt_util.c:2341
agt_print_error_headers
void agt_print_error_headers(void)
Print the error number and error message for each error to STDOUT or the logfile; Used for doxygen he...
Definition: agt_util.c:9703
agt_get_startup_filespec
xmlChar * agt_get_startup_filespec(status_t *res)
Figure out where to store the startup file.
Definition: agt_util.c:4805
agt_module_in_cli_valset
boolean agt_module_in_cli_valset(const xmlChar *modname)
Check if there is a module=foo parameter in the CLI parameter set.
Definition: agt_util.c:6862
agt_crl_mode_enum
agt_crl_mode_t agt_crl_mode_enum(const xmlChar *crl_mode)
Get the enum for the CRL mode string.
Definition: agt_util.c:7811
agt_make_object
val_value_t * agt_make_object(obj_template_t *parentobj, const xmlChar *objname, status_t *res)
make a val_value_t struct for a specified node
Definition: agt_util.c:4365
agt_make_leaf
val_value_t * agt_make_leaf(obj_template_t *parentobj, const xmlChar *leafname, const xmlChar *leafstrval, status_t *res)
make a string val_value_t struct for a specified leaf or leaf-list
Definition: agt_util.c:4207
agt_get_rpc_input
val_value_t * agt_get_rpc_input(rpc_msg_t *msg)
Get the rpc input value node.
Definition: agt_util.c:7361
agt_make_int64_leaf2
val_value_t * agt_make_int64_leaf2(obj_template_t *parentobj, const xmlChar *modname, const xmlChar *leafname, int64 leafval, status_t *res)
make a val_value_t struct for a specified leaf or leaf-list
Definition: agt_util.c:6499
agt_make_object2
val_value_t * agt_make_object2(obj_template_t *parentobj, const xmlChar *modname, const xmlChar *objname, status_t *res)
make a val_value_t struct for a specified node
Definition: agt_util.c:6722
agt_record_attr_error
void agt_record_attr_error(ses_cb_t *scb, xml_msg_hdr_t *msghdr, ncx_layer_t layer, status_t res, const xml_attr_t *xmlattr, const xml_node_t *xmlnode, const xmlChar *badns, ncx_node_t nodetyp, void *errnode)
Generate an rpc_err_rec_t and save it in the msg.
Definition: agt_util.c:2606
agt_make_uint_leaf2
val_value_t * agt_make_uint_leaf2(obj_template_t *parentobj, const xmlChar *modname, const xmlChar *leafname, uint32 leafval, status_t *res)
make a val_value_t struct for a specified leaf or leaf-list
Definition: agt_util.c:6399
agt_crl_mode_str
const xmlChar * agt_crl_mode_str(agt_crl_mode_t crl_mode)
Get the string for the CRL mode enum.
Definition: agt_util.c:7780
agt_op_ok_for_maintenance_mode
boolean agt_op_ok_for_maintenance_mode(const obj_template_t *rpcobj)
Check if the operation is OK for maintenance mode.
Definition: agt_util.c:7687
agt_make_int64_leaf
val_value_t * agt_make_int64_leaf(obj_template_t *parentobj, const xmlChar *leafname, int64 leafval, status_t *res)
make an int64 val_value_t struct for a specified leaf or leaf-list
Definition: agt_util.c:4283
agt_make_bits_key
val_value_t * agt_make_bits_key(const ncx_list_t *leafval)
make a generic key leaf node from a bits struct
Definition: agt_util.c:8914
agt_make_empty_leaf
val_value_t * agt_make_empty_leaf(obj_template_t *parentobj, const xmlChar *modname, const xmlChar *leafname, boolean boolval, status_t *res)
make a val_value_t struct for a specified leaf or leaf-list (NCX_BT_EMPTY)
Definition: agt_util.c:6685
agt_record_warning
void agt_record_warning(ses_cb_t *scb, xml_msg_hdr_t *msghdr, ncx_layer_t layer, status_t res, const xml_node_t *xmlnode, ncx_node_t parmtyp, const void *error_parm, ncx_node_t nodetyp, void *error_path, const ncx_errinfo_t *errinfo)
Generate an rpc_err_rec_t and save it in the msg.
Definition: agt_util.c:2554
agt_getTermReasonStr
const xmlChar * agt_getTermReasonStr(ses_term_reason_t termreason)
Convert the termination reason enum to a string.
Definition: agt_util.c:7446
agt_make_string_key
val_value_t * agt_make_string_key(const xmlChar *leafval)
make a generic key leaf node from a string
Definition: agt_util.c:8713
agt_find_in_datastore
status_t agt_find_in_datastore(ncx_cfg_t cfg_id, val_value_t *err_value, val_value_t **retval)
Find the node (should be from an <edit-config> content node) in the specified datastore.
Definition: agt_util.c:7260
agt_xpath_example
status_t agt_xpath_example(struct xpath_pcb_t_ *pcb, val_value_t *context, val_value_t *docroot, boolean *result)
XPath Boolean EVAL Replacement Callback.
Definition: agt_util.c:9063
agt_make_boolean_key
val_value_t * agt_make_boolean_key(boolean leafval)
make a generic key leaf node from a boolean
Definition: agt_util.c:8838
agt_make_int_key
val_value_t * agt_make_int_key(int32 leafval)
make a generic key leaf node from an int
Definition: agt_util.c:8763
agt_get_error_count
uint32 agt_get_error_count(rpc_msg_t *msg)
Get the current number of errors in the rpc msg Q.
Definition: agt_util.c:7334
agt_record_error_obj
void agt_record_error_obj(ses_cb_t *scb, xml_msg_hdr_t *msghdr, status_t res, obj_template_t *errobj, const xmlChar *badval)
Generate an rpc_err_rec_t and save it in the msg Use the provided object for <rpc-error> fields.
Definition: agt_util.c:2425
agt_make_idref_leaf
val_value_t * agt_make_idref_leaf(obj_template_t *parentobj, const xmlChar *leafname, const val_idref_t *leafval, status_t *res)
make an identityref val_value_t struct for a specified leaf or leaf-list
Definition: agt_util.c:4312
agt_add_patch_edit
status_t agt_add_patch_edit(agt_edit_parms_cb_t *parms, const xmlChar *edit_id_str, const xmlChar *edit_target, const xmlChar *edit_operation, const xmlChar *edit_xml_value, const xmlChar *insert_point, const xmlChar *insert_where)
Create an edit request and add to YANG Patch in progress.
Definition: agt_util.c:9252
agt_cvt_val2parms
agt_sa_push_parms_t * agt_cvt_val2parms(val_value_t *reqval, status_t *res)
Fill in sa_push_parms from a message val_value_t.
Definition: agt_util.c:9487
agt_get_key_value
val_value_t * agt_get_key_value(val_value_t *startval, val_value_t **lastkey)
Get the next expected key value in the ancestor chain.
Definition: agt_util.c:5414
agt_make_uint64_key
val_value_t * agt_make_uint64_key(uint64 leafval)
make a generic key leaf node from a uint64
Definition: agt_util.c:8788
agt_check_delete_all_allowed
boolean agt_check_delete_all_allowed(obj_template_t *testobj)
Check if the delete-all or remove-all operation is enabled for for specified object.
Definition: agt_util.c:6933
agt_make_union_leaf
val_value_t * agt_make_union_leaf(obj_template_t *parentobj, const xmlChar *modname, const xmlChar *leafname, const val_value_t *leafval, status_t *res)
make a val_value_t struct for a specified leaf or leaf-list use a val_value_t for a union
Definition: agt_util.c:6341
agt_make_int_leaf2
val_value_t * agt_make_int_leaf2(obj_template_t *parentobj, const xmlChar *modname, const xmlChar *leafname, int32 leafval, status_t *res)
make a val_value_t struct for a specified leaf or leaf-list
Definition: agt_util.c:6432
agt_get_edit_config_id
ncx_cfg_t agt_get_edit_config_id(rpc_msg_t *rpcmsg)
Get the enum ID of the configuration that is being edited.
Definition: agt_util.c:6837
agt_add_leafy
status_t agt_add_leafy(val_value_t *parentval, const xmlChar *modname, const xmlChar *leafname, const xmlChar *leafstrval)
make a child node from a string and add to parent.
Definition: agt_util.c:8273
agt_make_bits_leaf
val_value_t * agt_make_bits_leaf(obj_template_t *parentobj, const xmlChar *modname, const xmlChar *leafname, const ncx_list_t *listval, status_t *res)
make a val_value_t struct for a specified leaf or leaf-list (NCX_BT_BITS or NCX_BT_SLIST)
Definition: agt_util.c:6613
agt_add_boolean_leafy
status_t agt_add_boolean_leafy(val_value_t *parentval, const xmlChar *modname, const xmlChar *leafname, boolean boolval)
make a child node from a boolean and add to parent.
Definition: agt_util.c:8544
agt_make_srid_filespec
xmlChar * agt_make_srid_filespec(const xmlChar *basestr, const xmlChar *patstr, const xmlChar *valstr)
Make a filespec string needed for a filespec with SRID in it.
Definition: agt_util.c:4726
agt_make_uint64_leaf
val_value_t * agt_make_uint64_leaf(obj_template_t *parentobj, const xmlChar *leafname, uint64 leafval, status_t *res)
make a uint64 val_value_t struct for a specified leaf or leaf-list
Definition: agt_util.c:4264
agt_add_int_leafy
status_t agt_add_int_leafy(val_value_t *parentval, const xmlChar *modname, const xmlChar *leafname, int32 leafval)
make a child node from a int32 and add to parent.
Definition: agt_util.c:8381
agt_make_idref_key
val_value_t * agt_make_idref_key(const val_idref_t *leafval)
make a generic key leaf node from an idref struct
Definition: agt_util.c:8859
agt_make_uint64_leaf2
val_value_t * agt_make_uint64_leaf2(obj_template_t *parentobj, const xmlChar *modname, const xmlChar *leafname, uint64 leafval, status_t *res)
make a val_value_t struct for a specified leaf or leaf-list
Definition: agt_util.c:6465
agt_add_uint_leafy
status_t agt_add_uint_leafy(val_value_t *parentval, const xmlChar *modname, const xmlChar *leafname, uint32 leafval)
make a child node from a uint32 and add to parent.
Definition: agt_util.c:8327
getcb_fn_t
status_t(* getcb_fn_t)(ses_cb_t *scb, getcb_mode_t cbmode, const val_value_t *virval, val_value_t *dstval)
GET1 Callback function for agent node get handler.
Definition: getcb.h:666
op_editop_t
op_editop_t
NETCONF edit-config operation types.
Definition: op.h:122
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
status_t
status_t
global error return code
Definition: status_enum.h:219
ses_term_reason_t
ses_term_reason_t
Session Termination reason.
Definition: ses.h:491
xmlns_id_t
uint16 xmlns_id_t
integer handle for registered namespaces
Definition: xmlns.h:89
ncx_node_t
ncx_node_t
NCX Internal Node Types.
Definition: ncxtypes.h:460
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:777
ncx_cfg_t
ncx_cfg_t
hardwire the 3 standard configs
Definition: ncxtypes.h:571
ncx_iqual_t
ncx_iqual_t
The instance qualifier types are borrowed from ABNF and RelaxNG.
Definition: ncxtypes.h:483
ncx_protocol_t
ncx_protocol_t
NCX session protocol versions supported.
Definition: ncxtypes.h:1036
ncx_layer_t
ncx_layer_t
Enumeration of NETCONF protocol layers.
Definition: ncxtypes.h:530
ncx_withdefaults_t
ncx_withdefaults_t
enum for with-defaults enum values
Definition: ncxtypes.h:1332
ncxconst.h
Contains NCX constants.
ncxtypes.h
YANG module data structures Many internal representations of YANG module constructs.
obj.h
Data Object Support.
rpc.h
NETCONF protocol remote procedure call common definitions.
ses.h
NETCONF Session Common definitions module.
status.h
Global error messages for status code enumerations.
agt_cfg_transaction_t
Transaction Control Block.
Definition: agt_cfg.h:235
agt_edit_parms_cb_t
struct to contain all agt_send_edit parameters
Definition: agt.h:2149
agt_sa_push_parms_t
SIL-SA PUSH Parameter Block.
Definition: agt.h:897
cfg_template_t
struct representing 1 configuration database
Definition: cfg.h:229
ncx_errinfo_t
YANG error info statement struct used to override default error handling in the server.
Definition: ncxtypes.h:1420
ncx_list_t
header for a NCX List
Definition: ncxtypes.h:894
ncx_module_t
representation of one module or submodule during and after parsing
Definition: ncxtypes.h:1180
obj_template_t
One YANG data-def-stmt.
Definition: obj.h:1284
rpc_msg_t
NETCONF Server and Client RPC Request/Reply Message Header.
Definition: rpc.h:185
ses_cb_t
Session Control Block.
Definition: ses.h:759
val_idref_t
one QName for the NCX_BT_IDREF value
Definition: val.h:897
val_value_t
one value to match one type
Definition: val.h:1024
xml_attr_t
represents one attribute
Definition: xml_util.h:159
xml_msg_hdr_t
Common Encoding Message Header No longer XML specific!! Used by JSON and CBOR parsing as well!...
Definition: xml_msg.h:476
xml_node_t
gather node data into a simple struct.
Definition: xml_util.h:207
xpath_pcb_t
XPath parser control block.
Definition: xpath.h:754
xpath_result_t
XPath expression result.
Definition: xpath.h:705
yang_patch_cb_t
One YANG Patch Request.
Definition: yang_patch.h:155
val.h
Value Node Basic Support.
xml_msg.h
XML and JSON Message send and receive support.
xml_util.h
XML Utilities.
xpath.h
Schema and data model Xpath search support.
yang_patch.h
YANG Patch Media Type.