diff options
author | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-09 13:16:35 +0000 |
---|---|---|
committer | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-09 13:16:35 +0000 |
commit | e2bbf175a2184bd76f6c54ccf8456babeb1a46fc (patch) | |
tree | f0b76550d6e6f500ada964a3a4ee933a45e5a6f1 /lib/northbound_cli.c | |
parent | Initial commit. (diff) | |
download | frr-e2bbf175a2184bd76f6c54ccf8456babeb1a46fc.tar.xz frr-e2bbf175a2184bd76f6c54ccf8456babeb1a46fc.zip |
Adding upstream version 9.1.upstream/9.1
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'lib/northbound_cli.c')
-rw-r--r-- | lib/northbound_cli.c | 1937 |
1 files changed, 1937 insertions, 0 deletions
diff --git a/lib/northbound_cli.c b/lib/northbound_cli.c new file mode 100644 index 0000000..8003679 --- /dev/null +++ b/lib/northbound_cli.c @@ -0,0 +1,1937 @@ +// SPDX-License-Identifier: GPL-2.0-or-later +/* + * Copyright (C) 2018 NetDEF, Inc. + * Renato Westphal + */ + +#include <zebra.h> + +#include "libfrr.h" +#include "lib/version.h" +#include "defaults.h" +#include "log.h" +#include "lib_errors.h" +#include "command.h" +#include "termtable.h" +#include "db.h" +#include "debug.h" +#include "yang_translator.h" +#include "northbound.h" +#include "northbound_cli.h" +#include "northbound_db.h" +#include "lib/northbound_cli_clippy.c" + +struct debug nb_dbg_cbs_config = {0, "Northbound callbacks: configuration"}; +struct debug nb_dbg_cbs_state = {0, "Northbound callbacks: state"}; +struct debug nb_dbg_cbs_rpc = {0, "Northbound callbacks: RPCs"}; +struct debug nb_dbg_notif = {0, "Northbound notifications"}; +struct debug nb_dbg_events = {0, "Northbound events"}; +struct debug nb_dbg_libyang = {0, "libyang debugging"}; + +struct nb_config *vty_shared_candidate_config; +static struct event_loop *master; + +static void vty_show_nb_errors(struct vty *vty, int error, const char *errmsg) +{ + vty_out(vty, "Error type: %s\n", nb_err_name(error)); + if (strlen(errmsg) > 0) + vty_out(vty, "Error description: %s\n", errmsg); +} + +static int nb_cli_classic_commit(struct vty *vty) +{ + struct nb_context context = {}; + char errmsg[BUFSIZ] = {0}; + int ret; + + context.client = NB_CLIENT_CLI; + context.user = vty; + ret = nb_candidate_commit(context, vty->candidate_config, true, NULL, + NULL, errmsg, sizeof(errmsg)); + switch (ret) { + case NB_OK: + /* Successful commit. Print warnings (if any). */ + if (strlen(errmsg) > 0) + vty_out(vty, "%s\n", errmsg); + break; + case NB_ERR_NO_CHANGES: + break; + default: + vty_out(vty, "%% Configuration failed.\n\n"); + vty_show_nb_errors(vty, ret, errmsg); + if (vty->pending_commit) + vty_out(vty, + "The following commands were dynamically grouped into the same transaction and rejected:\n%s", + vty->pending_cmds_buf); + + /* Regenerate candidate for consistency. */ + nb_config_replace(vty->candidate_config, running_config, true); + return CMD_WARNING_CONFIG_FAILED; + } + + return CMD_SUCCESS; +} + +static void nb_cli_pending_commit_clear(struct vty *vty) +{ + vty->pending_commit = 0; + XFREE(MTYPE_TMP, vty->pending_cmds_buf); + vty->pending_cmds_buflen = 0; + vty->pending_cmds_bufpos = 0; +} + +int nb_cli_pending_commit_check(struct vty *vty) +{ + int ret = CMD_SUCCESS; + + if (vty->pending_commit) { + ret = nb_cli_classic_commit(vty); + nb_cli_pending_commit_clear(vty); + } + + return ret; +} + +static int nb_cli_schedule_command(struct vty *vty) +{ + /* Append command to dynamically sized buffer of scheduled commands. */ + if (!vty->pending_cmds_buf) { + vty->pending_cmds_buflen = 4096; + vty->pending_cmds_buf = + XCALLOC(MTYPE_TMP, vty->pending_cmds_buflen); + } + if ((strlen(vty->buf) + 3) + > (vty->pending_cmds_buflen - vty->pending_cmds_bufpos)) { + vty->pending_cmds_buflen *= 2; + vty->pending_cmds_buf = + XREALLOC(MTYPE_TMP, vty->pending_cmds_buf, + vty->pending_cmds_buflen); + } + strlcat(vty->pending_cmds_buf, "- ", vty->pending_cmds_buflen); + vty->pending_cmds_bufpos = strlcat(vty->pending_cmds_buf, vty->buf, + vty->pending_cmds_buflen); + + /* Schedule the commit operation. */ + vty->pending_commit = 1; + + return CMD_SUCCESS; +} + +void nb_cli_enqueue_change(struct vty *vty, const char *xpath, + enum nb_operation operation, const char *value) +{ + struct nb_cfg_change *change; + + if (vty->num_cfg_changes == VTY_MAXCFGCHANGES) { + /* Not expected to happen. */ + vty_out(vty, + "%% Exceeded the maximum number of changes (%u) for a single command\n\n", + VTY_MAXCFGCHANGES); + return; + } + + change = &vty->cfg_changes[vty->num_cfg_changes++]; + strlcpy(change->xpath, xpath, sizeof(change->xpath)); + change->operation = operation; + change->value = value; +} + +static int nb_cli_apply_changes_internal(struct vty *vty, + const char *xpath_base, + bool clear_pending) +{ + bool error = false; + char buf[BUFSIZ]; + + VTY_CHECK_XPATH; + + nb_candidate_edit_config_changes( + vty->candidate_config, vty->cfg_changes, vty->num_cfg_changes, + xpath_base, VTY_CURR_XPATH, vty->xpath_index, buf, sizeof(buf), + &error); + if (error) { + /* + * Failure to edit the candidate configuration should never + * happen in practice, unless there's a bug in the code. When + * that happens, log the error but otherwise ignore it. + */ + vty_out(vty, "%s", buf); + } + + /* + * Maybe do an implicit commit when using the classic CLI mode. + * + * NOTE: the implicit commit might be scheduled to run later when + * too many commands are being sent at the same time. This is a + * protection mechanism where multiple commands are grouped into the + * same configuration transaction, allowing them to be processed much + * faster. + */ + if (frr_get_cli_mode() == FRR_CLI_CLASSIC) { + if (clear_pending) { + if (vty->pending_commit) + return nb_cli_pending_commit_check(vty); + } else if (vty->pending_allowed) + return nb_cli_schedule_command(vty); + assert(!vty->pending_commit); + return nb_cli_classic_commit(vty); + } + + return CMD_SUCCESS; +} + +int nb_cli_apply_changes(struct vty *vty, const char *xpath_base_fmt, ...) +{ + char xpath_base[XPATH_MAXLEN] = {}; + bool implicit_commit; + int ret; + + /* Parse the base XPath format string. */ + if (xpath_base_fmt) { + va_list ap; + + va_start(ap, xpath_base_fmt); + vsnprintf(xpath_base, sizeof(xpath_base), xpath_base_fmt, ap); + va_end(ap); + } + + if (vty_mgmt_should_process_cli_apply_changes(vty)) { + VTY_CHECK_XPATH; + + if (vty->type == VTY_FILE) + return CMD_SUCCESS; + + implicit_commit = vty_needs_implicit_commit(vty); + ret = vty_mgmt_send_config_data(vty, implicit_commit); + if (ret >= 0 && !implicit_commit) + vty->mgmt_num_pending_setcfg++; + return ret; + } + + return nb_cli_apply_changes_internal(vty, xpath_base, false); +} + +int nb_cli_apply_changes_clear_pending(struct vty *vty, + const char *xpath_base_fmt, ...) +{ + char xpath_base[XPATH_MAXLEN] = {}; + bool implicit_commit; + int ret; + + /* Parse the base XPath format string. */ + if (xpath_base_fmt) { + va_list ap; + + va_start(ap, xpath_base_fmt); + vsnprintf(xpath_base, sizeof(xpath_base), xpath_base_fmt, ap); + va_end(ap); + } + + if (vty_mgmt_should_process_cli_apply_changes(vty)) { + VTY_CHECK_XPATH; + /* + * The legacy user wanted to clear pending (i.e., perform a + * commit immediately) due to some non-yang compatible + * functionality. This new mgmtd code however, continues to send + * changes putting off the commit until XFRR_end is received + * (i.e., end-of-config-file). This should be fine b/c all + * conversions to mgmtd require full proper implementations. + */ + implicit_commit = vty_needs_implicit_commit(vty); + ret = vty_mgmt_send_config_data(vty, implicit_commit); + if (ret >= 0 && !implicit_commit) + vty->mgmt_num_pending_setcfg++; + return ret; + } + + return nb_cli_apply_changes_internal(vty, xpath_base, true); +} + +int nb_cli_rpc(struct vty *vty, const char *xpath, struct list *input, + struct list *output) +{ + struct nb_node *nb_node; + int ret; + char errmsg[BUFSIZ] = {0}; + + nb_node = nb_node_find(xpath); + if (!nb_node) { + flog_warn(EC_LIB_YANG_UNKNOWN_DATA_PATH, + "%s: unknown data path: %s", __func__, xpath); + return CMD_WARNING; + } + + ret = nb_callback_rpc(nb_node, xpath, input, output, errmsg, + sizeof(errmsg)); + switch (ret) { + case NB_OK: + return CMD_SUCCESS; + default: + if (strlen(errmsg)) + vty_show_nb_errors(vty, ret, errmsg); + return CMD_WARNING; + } +} + +void nb_cli_confirmed_commit_clean(struct vty *vty) +{ + event_cancel(&vty->t_confirmed_commit_timeout); + nb_config_free(vty->confirmed_commit_rollback); + vty->confirmed_commit_rollback = NULL; +} + +int nb_cli_confirmed_commit_rollback(struct vty *vty) +{ + struct nb_context context = {}; + uint32_t transaction_id; + char errmsg[BUFSIZ] = {0}; + int ret; + + /* Perform the rollback. */ + context.client = NB_CLIENT_CLI; + context.user = vty; + ret = nb_candidate_commit( + context, vty->confirmed_commit_rollback, true, + "Rollback to previous configuration - confirmed commit has timed out", + &transaction_id, errmsg, sizeof(errmsg)); + if (ret == NB_OK) { + vty_out(vty, + "Rollback performed successfully (Transaction ID #%u).\n", + transaction_id); + /* Print warnings (if any). */ + if (strlen(errmsg) > 0) + vty_out(vty, "%s\n", errmsg); + } else { + vty_out(vty, + "Failed to rollback to previous configuration.\n\n"); + vty_show_nb_errors(vty, ret, errmsg); + } + + return ret; +} + +static void nb_cli_confirmed_commit_timeout(struct event *thread) +{ + struct vty *vty = EVENT_ARG(thread); + + /* XXX: broadcast this message to all logged-in users? */ + vty_out(vty, + "\nConfirmed commit has timed out, rolling back to previous configuration.\n\n"); + + nb_cli_confirmed_commit_rollback(vty); + nb_cli_confirmed_commit_clean(vty); +} + +static int nb_cli_commit(struct vty *vty, bool force, + unsigned int confirmed_timeout, char *comment) +{ + struct nb_context context = {}; + uint32_t transaction_id = 0; + char errmsg[BUFSIZ] = {0}; + int ret; + + /* Check if there's a pending confirmed commit. */ + if (vty->t_confirmed_commit_timeout) { + if (confirmed_timeout) { + /* Reset timeout if "commit confirmed" is used again. */ + vty_out(vty, + "%% Resetting confirmed-commit timeout to %u minute(s)\n\n", + confirmed_timeout); + + event_cancel(&vty->t_confirmed_commit_timeout); + event_add_timer(master, nb_cli_confirmed_commit_timeout, + vty, confirmed_timeout * 60, + &vty->t_confirmed_commit_timeout); + } else { + /* Accept commit confirmation. */ + vty_out(vty, "%% Commit complete.\n\n"); + nb_cli_confirmed_commit_clean(vty); + } + return CMD_SUCCESS; + } + + /* "force" parameter. */ + if (!force && nb_candidate_needs_update(vty->candidate_config)) { + vty_out(vty, + "%% Candidate configuration needs to be updated before commit.\n\n"); + vty_out(vty, + "Use the \"update\" command or \"commit force\".\n"); + return CMD_WARNING; + } + + /* "confirm" parameter. */ + if (confirmed_timeout) { + vty->confirmed_commit_rollback = nb_config_dup(running_config); + + vty->t_confirmed_commit_timeout = NULL; + event_add_timer(master, nb_cli_confirmed_commit_timeout, vty, + confirmed_timeout * 60, + &vty->t_confirmed_commit_timeout); + } + + context.client = NB_CLIENT_CLI; + context.user = vty; + ret = nb_candidate_commit(context, vty->candidate_config, true, comment, + &transaction_id, errmsg, sizeof(errmsg)); + + /* Map northbound return code to CLI return code. */ + switch (ret) { + case NB_OK: + nb_config_replace(vty->candidate_config_base, running_config, + true); + vty_out(vty, + "%% Configuration committed successfully (Transaction ID #%u).\n\n", + transaction_id); + /* Print warnings (if any). */ + if (strlen(errmsg) > 0) + vty_out(vty, "%s\n", errmsg); + return CMD_SUCCESS; + case NB_ERR_NO_CHANGES: + vty_out(vty, "%% No configuration changes to commit.\n\n"); + return CMD_SUCCESS; + default: + vty_out(vty, + "%% Failed to commit candidate configuration.\n\n"); + vty_show_nb_errors(vty, ret, errmsg); + return CMD_WARNING; + } +} + +static int nb_cli_candidate_load_file(struct vty *vty, + enum nb_cfg_format format, + struct yang_translator *translator, + const char *path, bool replace) +{ + struct nb_config *loaded_config = NULL; + struct lyd_node *dnode; + struct ly_ctx *ly_ctx; + int ly_format; + char buf[BUFSIZ]; + LY_ERR err; + + switch (format) { + case NB_CFG_FMT_CMDS: + loaded_config = nb_config_new(NULL); + if (!vty_read_config(loaded_config, path, config_default)) { + vty_out(vty, "%% Failed to load configuration.\n\n"); + vty_out(vty, + "Please check the logs for more details.\n"); + nb_config_free(loaded_config); + return CMD_WARNING; + } + break; + case NB_CFG_FMT_JSON: + case NB_CFG_FMT_XML: + ly_format = (format == NB_CFG_FMT_JSON) ? LYD_JSON : LYD_XML; + + ly_ctx = translator ? translator->ly_ctx : ly_native_ctx; + err = lyd_parse_data_path(ly_ctx, path, ly_format, + LYD_PARSE_ONLY | LYD_PARSE_NO_STATE, + 0, &dnode); + if (err || !dnode) { + flog_warn(EC_LIB_LIBYANG, "%s: lyd_parse_path() failed", + __func__); + vty_out(vty, "%% Failed to load configuration:\n\n"); + vty_out(vty, "%s", + yang_print_errors(ly_native_ctx, buf, + sizeof(buf))); + return CMD_WARNING; + } + if (translator + && yang_translate_dnode(translator, + YANG_TRANSLATE_TO_NATIVE, &dnode) + != YANG_TRANSLATE_SUCCESS) { + vty_out(vty, "%% Failed to translate configuration\n"); + yang_dnode_free(dnode); + return CMD_WARNING; + } + loaded_config = nb_config_new(dnode); + break; + } + + if (replace) + nb_config_replace(vty->candidate_config, loaded_config, false); + else if (nb_config_merge(vty->candidate_config, loaded_config, false) + != NB_OK) { + vty_out(vty, + "%% Failed to merge the loaded configuration:\n\n"); + vty_out(vty, "%s", + yang_print_errors(ly_native_ctx, buf, sizeof(buf))); + return CMD_WARNING; + } + + return CMD_SUCCESS; +} + +static int nb_cli_candidate_load_transaction(struct vty *vty, + uint32_t transaction_id, + bool replace) +{ + struct nb_config *loaded_config; + char buf[BUFSIZ]; + + loaded_config = nb_db_transaction_load(transaction_id); + if (!loaded_config) { + vty_out(vty, "%% Transaction %u does not exist.\n\n", + transaction_id); + return CMD_WARNING; + } + + if (replace) + nb_config_replace(vty->candidate_config, loaded_config, false); + else if (nb_config_merge(vty->candidate_config, loaded_config, false) + != NB_OK) { + vty_out(vty, + "%% Failed to merge the loaded configuration:\n\n"); + vty_out(vty, "%s", + yang_print_errors(ly_native_ctx, buf, sizeof(buf))); + return CMD_WARNING; + } + + return CMD_SUCCESS; +} + +/* Prepare the configuration for display. */ +void nb_cli_show_config_prepare(struct nb_config *config, bool with_defaults) +{ + /* Nothing to do for daemons that don't implement any YANG module. */ + if (config->dnode == NULL) + return; + + /* + * Call lyd_validate() only to create default child nodes, ignoring + * any possible validation error. This doesn't need to be done when + * displaying the running configuration since it's always fully + * validated. + */ + if (config != running_config) + (void)lyd_validate_all(&config->dnode, ly_native_ctx, + LYD_VALIDATE_NO_STATE, NULL); +} + +static int lyd_node_cmp(const struct lyd_node **dnode1, + const struct lyd_node **dnode2) +{ + struct nb_node *nb_node = (*dnode1)->schema->priv; + + return nb_node->cbs.cli_cmp(*dnode1, *dnode2); +} + +static void show_dnode_children_cmds(struct vty *vty, + const struct lyd_node *root, + bool with_defaults) +{ + struct nb_node *nb_node, *sort_node = NULL; + struct listnode *listnode; + struct lyd_node *child; + struct list *sort_list; + void *data; + + LY_LIST_FOR (lyd_child(root), child) { + nb_node = child->schema->priv; + + /* + * We finished processing current list, + * it's time to print the config. + */ + if (sort_node && nb_node != sort_node) { + list_sort(sort_list, + (int (*)(const void **, + const void **))lyd_node_cmp); + + for (ALL_LIST_ELEMENTS_RO(sort_list, listnode, data)) + nb_cli_show_dnode_cmds(vty, data, + with_defaults); + + list_delete(&sort_list); + sort_node = NULL; + } + + /* + * If the config needs to be sorted, + * then add the dnode to the sorting + * list for later processing. + */ + if (nb_node && nb_node->cbs.cli_cmp) { + if (!sort_node) { + sort_node = nb_node; + sort_list = list_new(); + } + + listnode_add(sort_list, child); + continue; + } + + nb_cli_show_dnode_cmds(vty, child, with_defaults); + } + + if (sort_node) { + list_sort(sort_list, + (int (*)(const void **, const void **))lyd_node_cmp); + + for (ALL_LIST_ELEMENTS_RO(sort_list, listnode, data)) + nb_cli_show_dnode_cmds(vty, data, with_defaults); + + list_delete(&sort_list); + sort_node = NULL; + } +} + +void nb_cli_show_dnode_cmds(struct vty *vty, const struct lyd_node *root, + bool with_defaults) +{ + struct nb_node *nb_node; + + if (!with_defaults && yang_dnode_is_default_recursive(root)) + return; + + nb_node = root->schema->priv; + + if (nb_node && nb_node->cbs.cli_show) + (*nb_node->cbs.cli_show)(vty, root, with_defaults); + + if (!(root->schema->nodetype & (LYS_LEAF | LYS_LEAFLIST | LYS_ANYDATA))) + show_dnode_children_cmds(vty, root, with_defaults); + + if (nb_node && nb_node->cbs.cli_show_end) + (*nb_node->cbs.cli_show_end)(vty, root); +} + +static void nb_cli_show_config_cmds(struct vty *vty, struct nb_config *config, + bool with_defaults) +{ + struct lyd_node *root; + + vty_out(vty, "Configuration:\n"); + vty_out(vty, "!\n"); + vty_out(vty, "frr version %s\n", FRR_VER_SHORT); + vty_out(vty, "frr defaults %s\n", frr_defaults_profile()); + + LY_LIST_FOR (config->dnode, root) { + nb_cli_show_dnode_cmds(vty, root, with_defaults); + } + + vty_out(vty, "!\n"); + vty_out(vty, "end\n"); +} + +static int nb_cli_show_config_libyang(struct vty *vty, LYD_FORMAT format, + struct nb_config *config, + struct yang_translator *translator, + bool with_defaults) +{ + struct lyd_node *dnode; + char *strp; + int options = 0; + + dnode = yang_dnode_dup(config->dnode); + if (translator + && yang_translate_dnode(translator, YANG_TRANSLATE_FROM_NATIVE, + &dnode) + != YANG_TRANSLATE_SUCCESS) { + vty_out(vty, "%% Failed to translate configuration\n"); + yang_dnode_free(dnode); + return CMD_WARNING; + } + + SET_FLAG(options, LYD_PRINT_WITHSIBLINGS); + if (with_defaults) + SET_FLAG(options, LYD_PRINT_WD_ALL); + else + SET_FLAG(options, LYD_PRINT_WD_TRIM); + + if (lyd_print_mem(&strp, dnode, format, options) == 0 && strp) { + vty_out(vty, "%s", strp); + free(strp); + } + + yang_dnode_free(dnode); + + return CMD_SUCCESS; +} + +static int nb_cli_show_config(struct vty *vty, struct nb_config *config, + enum nb_cfg_format format, + struct yang_translator *translator, + bool with_defaults) +{ + nb_cli_show_config_prepare(config, with_defaults); + + switch (format) { + case NB_CFG_FMT_CMDS: + nb_cli_show_config_cmds(vty, config, with_defaults); + break; + case NB_CFG_FMT_JSON: + return nb_cli_show_config_libyang(vty, LYD_JSON, config, + translator, with_defaults); + case NB_CFG_FMT_XML: + return nb_cli_show_config_libyang(vty, LYD_XML, config, + translator, with_defaults); + } + + return CMD_SUCCESS; +} + +static int nb_write_config(struct nb_config *config, enum nb_cfg_format format, + struct yang_translator *translator, char *path, + size_t pathlen) +{ + int fd; + struct vty *file_vty; + int ret = 0; + + snprintf(path, pathlen, "/tmp/frr.tmp.XXXXXXXX"); + fd = mkstemp(path); + if (fd < 0) { + flog_warn(EC_LIB_SYSTEM_CALL, "%s: mkstemp() failed: %s", + __func__, safe_strerror(errno)); + return -1; + } + if (fchmod(fd, CONFIGFILE_MASK) != 0) { + flog_warn(EC_LIB_SYSTEM_CALL, + "%s: fchmod() failed: %s(%d):", __func__, + safe_strerror(errno), errno); + return -1; + } + + /* Make vty for configuration file. */ + file_vty = vty_new(); + file_vty->wfd = fd; + file_vty->type = VTY_FILE; + if (config) + ret = nb_cli_show_config(file_vty, config, format, translator, + false); + vty_close(file_vty); + + return ret; +} + +static int nb_cli_show_config_compare(struct vty *vty, + struct nb_config *config1, + struct nb_config *config2, + enum nb_cfg_format format, + struct yang_translator *translator) +{ + char config1_path[256]; + char config2_path[256]; + char command[BUFSIZ]; + FILE *fp; + char line[1024]; + int lineno = 0; + + if (nb_write_config(config1, format, translator, config1_path, + sizeof(config1_path)) + != 0) { + vty_out(vty, "%% Failed to process configurations.\n\n"); + return CMD_WARNING; + } + if (nb_write_config(config2, format, translator, config2_path, + sizeof(config2_path)) + != 0) { + vty_out(vty, "%% Failed to process configurations.\n\n"); + unlink(config1_path); + return CMD_WARNING; + } + + snprintf(command, sizeof(command), "diff -u %s %s", config1_path, + config2_path); + fp = popen(command, "r"); + if (!fp) { + vty_out(vty, "%% Failed to generate configuration diff.\n\n"); + unlink(config1_path); + unlink(config2_path); + return CMD_WARNING; + } + /* Print diff line by line. */ + while (fgets(line, sizeof(line), fp) != NULL) { + if (lineno++ < 2) + continue; + vty_out(vty, "%s", line); + } + pclose(fp); + + unlink(config1_path); + unlink(config2_path); + + return CMD_SUCCESS; +} + +/* Configure exclusively from this terminal. */ +DEFUN (config_exclusive, + config_exclusive_cmd, + "configure exclusive", + "Configuration from vty interface\n" + "Configure exclusively from this terminal\n") +{ + return vty_config_enter(vty, true, true, false); +} + +/* Configure using a private candidate configuration. */ +DEFUN (config_private, + config_private_cmd, + "configure private", + "Configuration from vty interface\n" + "Configure using a private candidate configuration\n") +{ + return vty_config_enter(vty, true, false, false); +} + +DEFPY (config_commit, + config_commit_cmd, + "commit [{force$force|confirmed (1-60)}]", + "Commit changes into the running configuration\n" + "Force commit even if the candidate is outdated\n" + "Rollback this commit unless there is a confirming commit\n" + "Timeout in minutes for the commit to be confirmed\n") +{ + return nb_cli_commit(vty, !!force, confirmed, NULL); +} + +DEFPY (config_commit_comment, + config_commit_comment_cmd, + "commit [{force$force|confirmed (1-60)}] comment LINE...", + "Commit changes into the running configuration\n" + "Force commit even if the candidate is outdated\n" + "Rollback this commit unless there is a confirming commit\n" + "Timeout in minutes for the commit to be confirmed\n" + "Assign a comment to this commit\n" + "Comment for this commit (Max 80 characters)\n") +{ + char *comment; + int idx = 0; + int ret; + + argv_find(argv, argc, "LINE", &idx); + comment = argv_concat(argv, argc, idx); + ret = nb_cli_commit(vty, !!force, confirmed, comment); + XFREE(MTYPE_TMP, comment); + + return ret; +} + +DEFPY (config_commit_check, + config_commit_check_cmd, + "commit check", + "Commit changes into the running configuration\n" + "Check if the configuration changes are valid\n") +{ + struct nb_context context = {}; + char errmsg[BUFSIZ] = {0}; + int ret; + + context.client = NB_CLIENT_CLI; + context.user = vty; + ret = nb_candidate_validate(&context, vty->candidate_config, errmsg, + sizeof(errmsg)); + if (ret != NB_OK) { + vty_out(vty, + "%% Failed to validate candidate configuration.\n\n"); + vty_show_nb_errors(vty, ret, errmsg); + return CMD_WARNING; + } + + vty_out(vty, "%% Candidate configuration validated successfully.\n\n"); + + return CMD_SUCCESS; +} + +DEFPY (config_update, + config_update_cmd, + "update", + "Update candidate configuration\n") +{ + if (!nb_candidate_needs_update(vty->candidate_config)) { + vty_out(vty, "%% Update is not necessary.\n\n"); + return CMD_SUCCESS; + } + + if (nb_candidate_update(vty->candidate_config) != NB_OK) { + vty_out(vty, + "%% Failed to update the candidate configuration.\n\n"); + vty_out(vty, "Please check the logs for more details.\n"); + return CMD_WARNING; + } + + nb_config_replace(vty->candidate_config_base, running_config, true); + + vty_out(vty, "%% Candidate configuration updated successfully.\n\n"); + + return CMD_SUCCESS; +} + +DEFPY (config_discard, + config_discard_cmd, + "discard", + "Discard changes in the candidate configuration\n") +{ + nb_config_replace(vty->candidate_config, vty->candidate_config_base, + true); + + return CMD_SUCCESS; +} + +DEFPY (config_load, + config_load_cmd, + "configuration load\ + <\ + file [<json$json|xml$xml> [translate WORD$translator_family]] FILENAME$filename\ + |transaction (1-4294967295)$tid\ + >\ + [replace$replace]", + "Configuration related settings\n" + "Load configuration into candidate\n" + "Load configuration file into candidate\n" + "Load configuration file in JSON format\n" + "Load configuration file in XML format\n" + "Translate configuration file\n" + "YANG module translator\n" + "Configuration file name (full path)\n" + "Load configuration from transaction into candidate\n" + "Transaction ID\n" + "Replace instead of merge\n") +{ + if (filename) { + enum nb_cfg_format format; + struct yang_translator *translator = NULL; + + if (json) + format = NB_CFG_FMT_JSON; + else if (xml) + format = NB_CFG_FMT_XML; + else + format = NB_CFG_FMT_CMDS; + + if (translator_family) { + translator = yang_translator_find(translator_family); + if (!translator) { + vty_out(vty, + "%% Module translator \"%s\" not found\n", + translator_family); + return CMD_WARNING; + } + } + + return nb_cli_candidate_load_file(vty, format, translator, + filename, !!replace); + } + + return nb_cli_candidate_load_transaction(vty, tid, !!replace); +} + +DEFPY (show_config_running, + show_config_running_cmd, + "show configuration running\ + [<json$json|xml$xml> [translate WORD$translator_family]]\ + [with-defaults$with_defaults]", + SHOW_STR + "Configuration information\n" + "Running configuration\n" + "Change output format to JSON\n" + "Change output format to XML\n" + "Translate output\n" + "YANG module translator\n" + "Show default values\n") + +{ + enum nb_cfg_format format; + struct yang_translator *translator = NULL; + + if (json) + format = NB_CFG_FMT_JSON; + else if (xml) + format = NB_CFG_FMT_XML; + else + format = NB_CFG_FMT_CMDS; + + if (translator_family) { + translator = yang_translator_find(translator_family); + if (!translator) { + vty_out(vty, "%% Module translator \"%s\" not found\n", + translator_family); + return CMD_WARNING; + } + } + + nb_cli_show_config(vty, running_config, format, translator, + !!with_defaults); + + return CMD_SUCCESS; +} + +DEFPY (show_config_candidate, + show_config_candidate_cmd, + "show configuration candidate\ + [<json$json|xml$xml> [translate WORD$translator_family]]\ + [<\ + with-defaults$with_defaults\ + |changes$changes\ + >]", + SHOW_STR + "Configuration information\n" + "Candidate configuration\n" + "Change output format to JSON\n" + "Change output format to XML\n" + "Translate output\n" + "YANG module translator\n" + "Show default values\n" + "Show changes applied in the candidate configuration\n") + +{ + enum nb_cfg_format format; + struct yang_translator *translator = NULL; + + if (json) + format = NB_CFG_FMT_JSON; + else if (xml) + format = NB_CFG_FMT_XML; + else + format = NB_CFG_FMT_CMDS; + + if (translator_family) { + translator = yang_translator_find(translator_family); + if (!translator) { + vty_out(vty, "%% Module translator \"%s\" not found\n", + translator_family); + return CMD_WARNING; + } + } + + if (changes) + return nb_cli_show_config_compare( + vty, vty->candidate_config_base, vty->candidate_config, + format, translator); + + nb_cli_show_config(vty, vty->candidate_config, format, translator, + !!with_defaults); + + return CMD_SUCCESS; +} + +DEFPY (show_config_candidate_section, + show_config_candidate_section_cmd, + "show", + SHOW_STR) +{ + struct lyd_node *dnode; + + /* Top-level configuration node, display everything. */ + if (vty->xpath_index == 0) + return nb_cli_show_config(vty, vty->candidate_config, + NB_CFG_FMT_CMDS, NULL, false); + + /* Display only the current section of the candidate configuration. */ + dnode = yang_dnode_get(vty->candidate_config->dnode, VTY_CURR_XPATH); + if (!dnode) + /* Shouldn't happen. */ + return CMD_WARNING; + + nb_cli_show_dnode_cmds(vty, dnode, 0); + vty_out(vty, "!\n"); + + return CMD_SUCCESS; +} + +DEFPY (show_config_compare, + show_config_compare_cmd, + "show configuration compare\ + <\ + candidate$c1_candidate\ + |running$c1_running\ + |transaction (1-4294967295)$c1_tid\ + >\ + <\ + candidate$c2_candidate\ + |running$c2_running\ + |transaction (1-4294967295)$c2_tid\ + >\ + [<json$json|xml$xml> [translate WORD$translator_family]]", + SHOW_STR + "Configuration information\n" + "Compare two different configurations\n" + "Candidate configuration\n" + "Running configuration\n" + "Configuration transaction\n" + "Transaction ID\n" + "Candidate configuration\n" + "Running configuration\n" + "Configuration transaction\n" + "Transaction ID\n" + "Change output format to JSON\n" + "Change output format to XML\n" + "Translate output\n" + "YANG module translator\n") +{ + enum nb_cfg_format format; + struct yang_translator *translator = NULL; + struct nb_config *config1, *config_transaction1 = NULL; + struct nb_config *config2, *config_transaction2 = NULL; + int ret = CMD_WARNING; + + if (c1_candidate) + config1 = vty->candidate_config; + else if (c1_running) + config1 = running_config; + else { + config_transaction1 = nb_db_transaction_load(c1_tid); + if (!config_transaction1) { + vty_out(vty, "%% Transaction %u does not exist\n\n", + (unsigned int)c1_tid); + goto exit; + } + config1 = config_transaction1; + } + + if (c2_candidate) + config2 = vty->candidate_config; + else if (c2_running) + config2 = running_config; + else { + config_transaction2 = nb_db_transaction_load(c2_tid); + if (!config_transaction2) { + vty_out(vty, "%% Transaction %u does not exist\n\n", + (unsigned int)c2_tid); + goto exit; + } + config2 = config_transaction2; + } + + if (json) + format = NB_CFG_FMT_JSON; + else if (xml) + format = NB_CFG_FMT_XML; + else + format = NB_CFG_FMT_CMDS; + + if (translator_family) { + translator = yang_translator_find(translator_family); + if (!translator) { + vty_out(vty, "%% Module translator \"%s\" not found\n", + translator_family); + goto exit; + } + } + + ret = nb_cli_show_config_compare(vty, config1, config2, format, + translator); +exit: + if (config_transaction1) + nb_config_free(config_transaction1); + if (config_transaction2) + nb_config_free(config_transaction2); + + return ret; +} + +/* + * Stripped down version of the "show configuration compare" command. + * The "candidate" option is not present so the command can be installed in + * the enable node. + */ +ALIAS (show_config_compare, + show_config_compare_without_candidate_cmd, + "show configuration compare\ + <\ + running$c1_running\ + |transaction (1-4294967295)$c1_tid\ + >\ + <\ + running$c2_running\ + |transaction (1-4294967295)$c2_tid\ + >\ + [<json$json|xml$xml> [translate WORD$translator_family]]", + SHOW_STR + "Configuration information\n" + "Compare two different configurations\n" + "Running configuration\n" + "Configuration transaction\n" + "Transaction ID\n" + "Running configuration\n" + "Configuration transaction\n" + "Transaction ID\n" + "Change output format to JSON\n" + "Change output format to XML\n" + "Translate output\n" + "YANG module translator\n") + +DEFPY (clear_config_transactions, + clear_config_transactions_cmd, + "clear configuration transactions oldest (1-100)$n", + CLEAR_STR + "Configuration activity\n" + "Delete transactions from the transactions log\n" + "Delete oldest <n> transactions\n" + "Number of transactions to delete\n") +{ +#ifdef HAVE_CONFIG_ROLLBACKS + if (nb_db_clear_transactions(n) != NB_OK) { + vty_out(vty, "%% Failed to delete transactions.\n\n"); + return CMD_WARNING; + } +#else + vty_out(vty, + "%% FRR was compiled without --enable-config-rollbacks.\n\n"); +#endif /* HAVE_CONFIG_ROLLBACKS */ + + return CMD_SUCCESS; +} + +DEFPY (config_database_max_transactions, + config_database_max_transactions_cmd, + "configuration database max-transactions (1-100)$max", + "Configuration related settings\n" + "Configuration database\n" + "Set the maximum number of transactions to store\n" + "Number of transactions\n") +{ +#ifdef HAVE_CONFIG_ROLLBACKS + if (nb_db_set_max_transactions(max) != NB_OK) { + vty_out(vty, + "%% Failed to update the maximum number of transactions.\n\n"); + return CMD_WARNING; + } + vty_out(vty, + "%% Maximum number of transactions updated successfully.\n\n"); +#else + vty_out(vty, + "%% FRR was compiled without --enable-config-rollbacks.\n\n"); +#endif /* HAVE_CONFIG_ROLLBACKS */ + + return CMD_SUCCESS; +} + +DEFPY (yang_module_translator_load, + yang_module_translator_load_cmd, + "yang module-translator load FILENAME$filename", + "YANG related settings\n" + "YANG module translator\n" + "Load YANG module translator\n" + "File name (full path)\n") +{ + struct yang_translator *translator; + + translator = yang_translator_load(filename); + if (!translator) { + vty_out(vty, "%% Failed to load \"%s\"\n\n", filename); + vty_out(vty, "Please check the logs for more details.\n"); + return CMD_WARNING; + } + + vty_out(vty, "%% Module translator \"%s\" loaded successfully.\n\n", + translator->family); + + return CMD_SUCCESS; +} + +DEFPY (yang_module_translator_unload_family, + yang_module_translator_unload_cmd, + "yang module-translator unload WORD$translator_family", + "YANG related settings\n" + "YANG module translator\n" + "Unload YANG module translator\n" + "Name of the module translator\n") +{ + struct yang_translator *translator; + + translator = yang_translator_find(translator_family); + if (!translator) { + vty_out(vty, "%% Module translator \"%s\" not found\n", + translator_family); + return CMD_WARNING; + } + + yang_translator_unload(translator); + + return CMD_SUCCESS; +} + +#ifdef HAVE_CONFIG_ROLLBACKS +static void nb_cli_show_transactions_cb(void *arg, int transaction_id, + const char *client_name, + const char *date, const char *comment) +{ + struct ttable *tt = arg; + + ttable_add_row(tt, "%d|%s|%s|%s", transaction_id, client_name, date, + comment); +} + +static int nb_cli_show_transactions(struct vty *vty) +{ + struct ttable *tt; + + /* Prepare table. */ + tt = ttable_new(&ttable_styles[TTSTYLE_BLANK]); + ttable_add_row(tt, "Transaction ID|Client|Date|Comment"); + tt->style.cell.rpad = 2; + tt->style.corner = '+'; + ttable_restyle(tt); + ttable_rowseps(tt, 0, BOTTOM, true, '-'); + + /* Fetch transactions from the northbound database. */ + if (nb_db_transactions_iterate(nb_cli_show_transactions_cb, tt) + != NB_OK) { + vty_out(vty, + "%% Failed to fetch configuration transactions.\n"); + return CMD_WARNING; + } + + /* Dump the generated table. */ + if (tt->nrows > 1) { + char *table; + + table = ttable_dump(tt, "\n"); + vty_out(vty, "%s\n", table); + XFREE(MTYPE_TMP, table); + } else + vty_out(vty, "No configuration transactions to display.\n\n"); + + ttable_del(tt); + + return CMD_SUCCESS; +} +#endif /* HAVE_CONFIG_ROLLBACKS */ + +DEFPY (show_config_transaction, + show_config_transaction_cmd, + "show configuration transaction\ + [\ + (1-4294967295)$transaction_id\ + [<json$json|xml$xml> [translate WORD$translator_family]]\ + [<\ + with-defaults$with_defaults\ + |changes$changes\ + >]\ + ]", + SHOW_STR + "Configuration information\n" + "Configuration transaction\n" + "Transaction ID\n" + "Change output format to JSON\n" + "Change output format to XML\n" + "Translate output\n" + "YANG module translator\n" + "Show default values\n" + "Show changes compared to the previous transaction\n") +{ +#ifdef HAVE_CONFIG_ROLLBACKS + if (transaction_id) { + struct nb_config *config; + enum nb_cfg_format format; + struct yang_translator *translator = NULL; + + if (json) + format = NB_CFG_FMT_JSON; + else if (xml) + format = NB_CFG_FMT_XML; + else + format = NB_CFG_FMT_CMDS; + + if (translator_family) { + translator = yang_translator_find(translator_family); + if (!translator) { + vty_out(vty, + "%% Module translator \"%s\" not found\n", + translator_family); + return CMD_WARNING; + } + } + + config = nb_db_transaction_load(transaction_id); + if (!config) { + vty_out(vty, "%% Transaction %u does not exist.\n\n", + (unsigned int)transaction_id); + return CMD_WARNING; + } + + if (changes) { + struct nb_config *prev_config; + int ret; + + /* NOTE: this can be NULL. */ + prev_config = + nb_db_transaction_load(transaction_id - 1); + + ret = nb_cli_show_config_compare( + vty, prev_config, config, format, translator); + if (prev_config) + nb_config_free(prev_config); + nb_config_free(config); + + return ret; + } + + nb_cli_show_config(vty, config, format, translator, + !!with_defaults); + nb_config_free(config); + + return CMD_SUCCESS; + } + + return nb_cli_show_transactions(vty); +#else + vty_out(vty, + "%% FRR was compiled without --enable-config-rollbacks.\n\n"); + return CMD_WARNING; +#endif /* HAVE_CONFIG_ROLLBACKS */ +} + +static int nb_cli_oper_data_cb(const struct lysc_node *snode, + struct yang_translator *translator, + struct yang_data *data, void *arg) +{ + struct lyd_node *dnode = arg; + struct ly_ctx *ly_ctx; + + if (translator) { + int ret; + + ret = yang_translate_xpath(translator, + YANG_TRANSLATE_FROM_NATIVE, + data->xpath, sizeof(data->xpath)); + switch (ret) { + case YANG_TRANSLATE_SUCCESS: + break; + case YANG_TRANSLATE_NOTFOUND: + goto exit; + case YANG_TRANSLATE_FAILURE: + goto error; + } + + ly_ctx = translator->ly_ctx; + } else + ly_ctx = ly_native_ctx; + + LY_ERR err = + lyd_new_path(dnode, ly_ctx, data->xpath, (void *)data->value, + LYD_NEW_PATH_UPDATE, &dnode); + if (err) { + flog_warn(EC_LIB_LIBYANG, "%s: lyd_new_path(%s) failed: %s", + __func__, data->xpath, ly_errmsg(ly_native_ctx)); + goto error; + } + +exit: + yang_data_free(data); + return NB_OK; + +error: + yang_data_free(data); + return NB_ERR; +} + +DEFPY (show_yang_operational_data, + show_yang_operational_data_cmd, + "show yang operational-data XPATH$xpath\ + [{\ + format <json$json|xml$xml>\ + |translate WORD$translator_family\ + |with-config$with_config\ + }]", + SHOW_STR + "YANG information\n" + "Show YANG operational data\n" + "XPath expression specifying the YANG data path\n" + "Set the output format\n" + "JavaScript Object Notation\n" + "Extensible Markup Language\n" + "Translate operational data\n" + "YANG module translator\n" + "Merge configuration data\n") +{ + LYD_FORMAT format; + struct yang_translator *translator = NULL; + struct ly_ctx *ly_ctx; + struct lyd_node *dnode; + char *strp; + uint32_t print_options = LYD_PRINT_WITHSIBLINGS; + int ret; + + if (xml) + format = LYD_XML; + else + format = LYD_JSON; + + if (translator_family) { + translator = yang_translator_find(translator_family); + if (!translator) { + vty_out(vty, "%% Module translator \"%s\" not found\n", + translator_family); + return CMD_WARNING; + } + + ly_ctx = translator->ly_ctx; + } else + ly_ctx = ly_native_ctx; + + /* Obtain data. */ + dnode = yang_dnode_new(ly_ctx, false); + ret = nb_oper_data_iterate(xpath, translator, 0, nb_cli_oper_data_cb, + dnode); + if (ret != NB_OK) { + if (format == LYD_JSON) + vty_out(vty, "{}\n"); + else { + /* embed ly_last_errmsg() when we get newer libyang */ + vty_out(vty, "<!-- Not found -->\n"); + } + yang_dnode_free(dnode); + return CMD_WARNING; + } + + if (with_config && yang_dnode_exists(running_config->dnode, xpath)) { + struct lyd_node *config_dnode = + yang_dnode_get(running_config->dnode, xpath); + if (config_dnode != NULL) { + lyd_merge_tree(&dnode, yang_dnode_dup(config_dnode), + LYD_MERGE_DESTRUCT); + print_options |= LYD_PRINT_WD_ALL; + } + } + + (void)lyd_validate_all(&dnode, ly_ctx, 0, NULL); + + /* Display the data. */ + if (lyd_print_mem(&strp, dnode, format, print_options) != 0 || !strp) { + vty_out(vty, "%% Failed to display operational data.\n"); + yang_dnode_free(dnode); + return CMD_WARNING; + } + vty_out(vty, "%s", strp); + free(strp); + yang_dnode_free(dnode); + + return CMD_SUCCESS; +} + +DEFPY (show_yang_module, + show_yang_module_cmd, + "show yang module [module-translator WORD$translator_family]", + SHOW_STR + "YANG information\n" + "Show loaded modules\n" + "YANG module translator\n" + "YANG module translator\n") +{ + struct ly_ctx *ly_ctx; + struct yang_translator *translator = NULL; + const struct lys_module *module; + struct ttable *tt; + uint32_t idx = 0; + + if (translator_family) { + translator = yang_translator_find(translator_family); + if (!translator) { + vty_out(vty, "%% Module translator \"%s\" not found\n", + translator_family); + return CMD_WARNING; + } + ly_ctx = translator->ly_ctx; + } else + ly_ctx = ly_native_ctx; + + /* Prepare table. */ + tt = ttable_new(&ttable_styles[TTSTYLE_BLANK]); + ttable_add_row(tt, "Module|Version|Revision|Flags|Namespace"); + tt->style.cell.rpad = 2; + tt->style.corner = '+'; + ttable_restyle(tt); + ttable_rowseps(tt, 0, BOTTOM, true, '-'); + + while ((module = ly_ctx_get_module_iter(ly_ctx, &idx))) { + char flags[8]; + + snprintf(flags, sizeof(flags), "%c%c", + module->implemented ? 'I' : ' ', + LY_ARRAY_COUNT(module->deviated_by) ? 'D' : ' '); + + ttable_add_row(tt, "%s|%s|%s|%s|%s", module->name, + (module->parsed->version == 2) ? "1.1" : "1.0", + module->revision ? module->revision : "-", flags, + module->ns); + } + + /* Dump the generated table. */ + if (tt->nrows > 1) { + char *table; + + vty_out(vty, " Flags: I - Implemented, D - Deviated\n\n"); + + table = ttable_dump(tt, "\n"); + vty_out(vty, "%s\n", table); + XFREE(MTYPE_TMP, table); + } else + vty_out(vty, "No YANG modules to display.\n\n"); + + ttable_del(tt); + + return CMD_SUCCESS; +} + +DEFPY(show_yang_module_detail, show_yang_module_detail_cmd, + "show yang module\ + [module-translator WORD$translator_family]\ + WORD$module_name <compiled$compiled|summary|tree$tree|yang$yang|yin$yin>", + SHOW_STR + "YANG information\n" + "Show loaded modules\n" + "YANG module translator\n" + "YANG module translator\n" + "Module name\n" + "Display compiled module in YANG format\n" + "Display summary information about the module\n" + "Display module in the tree (RFC 8340) format\n" + "Display module in the YANG format\n" + "Display module in the YIN format\n") +{ + struct ly_ctx *ly_ctx; + struct yang_translator *translator = NULL; + const struct lys_module *module; + LYS_OUTFORMAT format; + char *strp; + + if (translator_family) { + translator = yang_translator_find(translator_family); + if (!translator) { + vty_out(vty, "%% Module translator \"%s\" not found\n", + translator_family); + return CMD_WARNING; + } + ly_ctx = translator->ly_ctx; + } else + ly_ctx = ly_native_ctx; + + module = ly_ctx_get_module_latest(ly_ctx, module_name); + if (!module) { + vty_out(vty, "%% Module \"%s\" not found\n", module_name); + return CMD_WARNING; + } + + if (yang) + format = LYS_OUT_YANG; + else if (yin) + format = LYS_OUT_YIN; + else if (compiled) + format = LYS_OUT_YANG_COMPILED; + else if (tree) + format = LYS_OUT_TREE; + else { + vty_out(vty, + "%% libyang v2 does not currently support summary\n"); + return CMD_WARNING; + } + + if (lys_print_mem(&strp, module, format, 0) == 0) { + vty_out(vty, "%s\n", strp); + free(strp); + } else { + /* Unexpected. */ + vty_out(vty, "%% Error generating module information\n"); + return CMD_WARNING; + } + + return CMD_SUCCESS; +} + +DEFPY (show_yang_module_translator, + show_yang_module_translator_cmd, + "show yang module-translator", + SHOW_STR + "YANG information\n" + "Show loaded YANG module translators\n") +{ + struct yang_translator *translator; + struct ttable *tt; + + /* Prepare table. */ + tt = ttable_new(&ttable_styles[TTSTYLE_BLANK]); + ttable_add_row(tt, "Family|Module|Deviations|Coverage (%%)"); + tt->style.cell.rpad = 2; + tt->style.corner = '+'; + ttable_restyle(tt); + ttable_rowseps(tt, 0, BOTTOM, true, '-'); + + RB_FOREACH (translator, yang_translators, &yang_translators) { + struct yang_tmodule *tmodule; + struct listnode *ln; + + for (ALL_LIST_ELEMENTS_RO(translator->modules, ln, tmodule)) { + ttable_add_row(tt, "%s|%s|%s|%.2f", translator->family, + tmodule->module->name, + tmodule->deviations->name, + tmodule->coverage); + } + } + + /* Dump the generated table. */ + if (tt->nrows > 1) { + char *table; + + table = ttable_dump(tt, "\n"); + vty_out(vty, "%s\n", table); + XFREE(MTYPE_TMP, table); + } else + vty_out(vty, "No YANG module translators to display.\n\n"); + + ttable_del(tt); + + return CMD_SUCCESS; +} + +#ifdef HAVE_CONFIG_ROLLBACKS +static int nb_cli_rollback_configuration(struct vty *vty, + uint32_t transaction_id) +{ + struct nb_context context = {}; + struct nb_config *candidate; + char comment[80]; + char errmsg[BUFSIZ] = {0}; + int ret; + + candidate = nb_db_transaction_load(transaction_id); + if (!candidate) { + vty_out(vty, "%% Transaction %u does not exist.\n\n", + transaction_id); + return CMD_WARNING; + } + + snprintf(comment, sizeof(comment), "Rollback to transaction %u", + transaction_id); + + context.client = NB_CLIENT_CLI; + context.user = vty; + ret = nb_candidate_commit(context, candidate, true, comment, NULL, + errmsg, sizeof(errmsg)); + nb_config_free(candidate); + switch (ret) { + case NB_OK: + vty_out(vty, + "%% Configuration was successfully rolled back.\n\n"); + /* Print warnings (if any). */ + if (strlen(errmsg) > 0) + vty_out(vty, "%s\n", errmsg); + return CMD_SUCCESS; + case NB_ERR_NO_CHANGES: + vty_out(vty, + "%% Aborting - no configuration changes detected.\n\n"); + return CMD_WARNING; + default: + vty_out(vty, "%% Rollback failed.\n\n"); + vty_show_nb_errors(vty, ret, errmsg); + return CMD_WARNING; + } +} +#endif /* HAVE_CONFIG_ROLLBACKS */ + +DEFPY (rollback_config, + rollback_config_cmd, + "rollback configuration (1-4294967295)$transaction_id", + "Rollback to a previous state\n" + "Running configuration\n" + "Transaction ID\n") +{ +#ifdef HAVE_CONFIG_ROLLBACKS + return nb_cli_rollback_configuration(vty, transaction_id); +#else + vty_out(vty, + "%% FRR was compiled without --enable-config-rollbacks.\n\n"); + return CMD_SUCCESS; +#endif /* HAVE_CONFIG_ROLLBACKS */ +} + +/* Debug CLI commands. */ +static struct debug *nb_debugs[] = { + &nb_dbg_cbs_config, &nb_dbg_cbs_state, &nb_dbg_cbs_rpc, + &nb_dbg_notif, &nb_dbg_events, &nb_dbg_libyang, +}; + +static const char *const nb_debugs_conflines[] = { + "debug northbound callbacks configuration", + "debug northbound callbacks state", + "debug northbound callbacks rpc", + "debug northbound notifications", + "debug northbound events", + "debug northbound libyang", +}; + +DEFINE_HOOK(nb_client_debug_set_all, (uint32_t flags, bool set), (flags, set)); + +static void nb_debug_set_all(uint32_t flags, bool set) +{ + for (unsigned int i = 0; i < array_size(nb_debugs); i++) { + DEBUG_FLAGS_SET(nb_debugs[i], flags, set); + + /* If all modes have been turned off, don't preserve options. */ + if (!DEBUG_MODE_CHECK(nb_debugs[i], DEBUG_MODE_ALL)) + DEBUG_CLEAR(nb_debugs[i]); + } + + hook_call(nb_client_debug_set_all, flags, set); +} + +DEFPY (debug_nb, + debug_nb_cmd, + "[no] debug northbound\ + [<\ + callbacks$cbs [{configuration$cbs_cfg|state$cbs_state|rpc$cbs_rpc}]\ + |notifications$notifications\ + |events$events\ + |libyang$libyang\ + >]", + NO_STR + DEBUG_STR + "Northbound debugging\n" + "Callbacks\n" + "Configuration\n" + "State\n" + "RPC\n" + "Notifications\n" + "Events\n" + "libyang debugging\n") +{ + uint32_t mode = DEBUG_NODE2MODE(vty->node); + + if (cbs) { + bool none = (!cbs_cfg && !cbs_state && !cbs_rpc); + + if (none || cbs_cfg) + DEBUG_MODE_SET(&nb_dbg_cbs_config, mode, !no); + if (none || cbs_state) + DEBUG_MODE_SET(&nb_dbg_cbs_state, mode, !no); + if (none || cbs_rpc) + DEBUG_MODE_SET(&nb_dbg_cbs_rpc, mode, !no); + } + if (notifications) + DEBUG_MODE_SET(&nb_dbg_notif, mode, !no); + if (events) + DEBUG_MODE_SET(&nb_dbg_events, mode, !no); + if (libyang) { + DEBUG_MODE_SET(&nb_dbg_libyang, mode, !no); + yang_debugging_set(!no); + } + + /* no specific debug --> act on all of them */ + if (strmatch(argv[argc - 1]->text, "northbound")) { + nb_debug_set_all(mode, !no); + yang_debugging_set(!no); + } + + return CMD_SUCCESS; +} + +DEFINE_HOOK(nb_client_debug_config_write, (struct vty *vty), (vty)); + +static int nb_debug_config_write(struct vty *vty) +{ + for (unsigned int i = 0; i < array_size(nb_debugs); i++) + if (DEBUG_MODE_CHECK(nb_debugs[i], DEBUG_MODE_CONF)) + vty_out(vty, "%s\n", nb_debugs_conflines[i]); + + hook_call(nb_client_debug_config_write, vty); + + return 1; +} + +static struct debug_callbacks nb_dbg_cbs = {.debug_set_all = nb_debug_set_all}; +static struct cmd_node nb_debug_node = { + .name = "northbound debug", + .node = NORTHBOUND_DEBUG_NODE, + .prompt = "", + .config_write = nb_debug_config_write, +}; + +void nb_cli_install_default(int node) +{ + _install_element(node, &show_config_candidate_section_cmd); + + if (frr_get_cli_mode() != FRR_CLI_TRANSACTIONAL) + return; + + _install_element(node, &config_commit_cmd); + _install_element(node, &config_commit_comment_cmd); + _install_element(node, &config_commit_check_cmd); + _install_element(node, &config_update_cmd); + _install_element(node, &config_discard_cmd); + _install_element(node, &show_config_running_cmd); + _install_element(node, &show_config_candidate_cmd); + _install_element(node, &show_config_compare_cmd); + _install_element(node, &show_config_transaction_cmd); +} + +/* YANG module autocomplete. */ +static void yang_module_autocomplete(vector comps, struct cmd_token *token) +{ + const struct lys_module *module; + struct yang_translator *module_tr; + uint32_t idx; + + idx = 0; + while ((module = ly_ctx_get_module_iter(ly_native_ctx, &idx))) + vector_set(comps, XSTRDUP(MTYPE_COMPLETION, module->name)); + + RB_FOREACH (module_tr, yang_translators, &yang_translators) { + idx = 0; + while ((module = ly_ctx_get_module_iter(module_tr->ly_ctx, + &idx))) + vector_set(comps, + XSTRDUP(MTYPE_COMPLETION, module->name)); + } +} + +/* YANG module translator autocomplete. */ +static void yang_translator_autocomplete(vector comps, struct cmd_token *token) +{ + struct yang_translator *module_tr; + + RB_FOREACH (module_tr, yang_translators, &yang_translators) + vector_set(comps, XSTRDUP(MTYPE_COMPLETION, module_tr->family)); +} + +static const struct cmd_variable_handler yang_var_handlers[] = { + {.varname = "module_name", .completions = yang_module_autocomplete}, + {.varname = "translator_family", + .completions = yang_translator_autocomplete}, + {.completions = NULL}}; + +void nb_cli_init(struct event_loop *tm) +{ + master = tm; + + /* Initialize the shared candidate configuration. */ + vty_shared_candidate_config = nb_config_new(NULL); + + debug_init(&nb_dbg_cbs); + + install_node(&nb_debug_node); + install_element(ENABLE_NODE, &debug_nb_cmd); + install_element(CONFIG_NODE, &debug_nb_cmd); + + /* Install commands specific to the transaction-base mode. */ + if (frr_get_cli_mode() == FRR_CLI_TRANSACTIONAL) { + install_element(ENABLE_NODE, &config_exclusive_cmd); + install_element(ENABLE_NODE, &config_private_cmd); + install_element(ENABLE_NODE, + &show_config_compare_without_candidate_cmd); + install_element(ENABLE_NODE, &show_config_transaction_cmd); + install_element(ENABLE_NODE, &rollback_config_cmd); + install_element(ENABLE_NODE, &clear_config_transactions_cmd); + + install_element(CONFIG_NODE, &config_load_cmd); + install_element(CONFIG_NODE, + &config_database_max_transactions_cmd); + } + + /* Other commands. */ + install_element(ENABLE_NODE, &show_config_running_cmd); + install_element(CONFIG_NODE, &yang_module_translator_load_cmd); + install_element(CONFIG_NODE, &yang_module_translator_unload_cmd); + install_element(ENABLE_NODE, &show_yang_operational_data_cmd); + install_element(ENABLE_NODE, &show_yang_module_cmd); + install_element(ENABLE_NODE, &show_yang_module_detail_cmd); + install_element(ENABLE_NODE, &show_yang_module_translator_cmd); + cmd_variable_handler_register(yang_var_handlers); +} + +void nb_cli_terminate(void) +{ + nb_config_free(vty_shared_candidate_config); +} |