743076b171
Extended cli_auto_show() with with-defaults argument, also changing its signature Example: Added with-defaults argument to clispec C-API: Added with-defaults argument to clicon_rpc_get_config Replaced with-defaults prefix/namespace with constants
148 lines
8.6 KiB
Text
148 lines
8.6 KiB
Text
# ***** BEGIN LICENSE BLOCK *****
|
|
#
|
|
# Copyright (C) 2009-2016 Olof Hagsand and Benny Holmgren
|
|
# Copyright (C) 2017-2019 Olof Hagsand
|
|
# Copyright (C) 2020-2022 Olof Hagsand and Rubicon Communications, LLC(Netgate)
|
|
#
|
|
# This file is part of CLIXON
|
|
#
|
|
# Licensed under the Apache License, Version 2.0 (the "License");
|
|
# you may not use this file except in compliance with the License.
|
|
# You may obtain a copy of the License at
|
|
#
|
|
# http://www.apache.org/licenses/LICENSE-2.0
|
|
#
|
|
# Unless required by applicable law or agreed to in writing, software
|
|
# distributed under the License is distributed on an "AS IS" BASIS,
|
|
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
# See the License for the specific language governing permissions and
|
|
# limitations under the License.
|
|
#
|
|
# Alternatively, the contents of this file may be used under the terms of
|
|
# the GNU General Public License Version 3 or later (the "GPL"),
|
|
# in which case the provisions of the GPL are applicable instead
|
|
# of those above. If you wish to allow use of your version of this file only
|
|
# under the terms of the GPL, and not to allow others to
|
|
# use your version of this file under the terms of Apache License version 2,
|
|
# indicate your decision by deleting the provisions above and replace them with
|
|
# the notice and other provisions required by the GPL. If you do not delete
|
|
# the provisions above, a recipient may use your version of this file under
|
|
# the terms of any one of the Apache License version 2 or the GPL.
|
|
#
|
|
# ***** END LICENSE BLOCK *****
|
|
|
|
# Clixon example specification
|
|
CLICON_MODE="example";
|
|
CLICON_PROMPT="%U@%H %W> ";
|
|
CLICON_PLUGIN="example_cli";
|
|
|
|
# Autocli syntax tree operations
|
|
edit @datamodelmode, cli_auto_edit("basemodel");
|
|
up, cli_auto_up("basemodel");
|
|
top, cli_auto_top("basemodel");
|
|
set @datamodel, cli_auto_set();
|
|
merge @datamodel, cli_auto_merge();
|
|
create @datamodel, cli_auto_create();
|
|
delete("Delete a configuration item") {
|
|
@datamodel, cli_auto_del();
|
|
all("Delete whole candidate configuration"), delete_all("candidate");
|
|
}
|
|
validate("Validate changes"), cli_validate();
|
|
commit("Commit the changes"), cli_commit();
|
|
quit("Quit"), cli_quit();
|
|
|
|
debug("Debugging parts of the system"){
|
|
cli("Set cli debug") <level:int32>("Set debug level (0..n)"), cli_debug_cli();
|
|
backend("Set backend debug") <level:int32>("Set debug level (0..n)"), cli_debug_backend();
|
|
restconf("Set restconf debug") <level:int32>("Set debug level (0..n)"), cli_debug_restconf();
|
|
}
|
|
|
|
shell("System command"), cli_start_shell("bash");{
|
|
<source:rest>("Single shell command"), cli_start_shell("bash");
|
|
}
|
|
copy("Copy and create a new object") {
|
|
running("Copy from running db") startup("Copy to startup config"), db_copy("running", "startup");
|
|
interface("Copy interface"){
|
|
(<name:string>|<name:string expand_dbvar("candidate","/ietf-interfaces:interfaces/interface=%s/name")>("name of interface to copy from")) to("Copy to interface") <toname:string>("Name of interface to copy to"), cli_copy_config("candidate","//interface[%s='%s']","urn:ietf:params:xml:ns:yang:ietf-interfaces","name","name","toname");
|
|
}
|
|
}
|
|
discard("Discard edits (rollback 0)"), discard_changes();
|
|
|
|
show("Show a particular state of the system"){
|
|
auto("Show expand") @datamodelshow, cli_show_auto("candidate", "xml");
|
|
xpath("Show configuration") <xpath:string>("XPATH expression")
|
|
[<ns:string>("Namespace")], show_conf_xpath("candidate");
|
|
version("Show version"), cli_show_version("candidate", "text", "/");
|
|
options("Show clixon options"), cli_show_options();
|
|
compare("Compare candidate and running databases"), compare_dbs((int32)0);{
|
|
xml("Show comparison in xml"), compare_dbs((int32)0);
|
|
text("Show comparison in text"), compare_dbs((int32)1);
|
|
}
|
|
pagination("Show list pagination") xpath("Show configuration") <xpath:string>("XPATH expression"){
|
|
xml, cli_pagination("use xpath var", "es", "http://example.com/ns/example-social", "xml", "10");
|
|
cli, cli_pagination("use xpath var", "es", "http://example.com/ns/example-social", "cli", "10");
|
|
text, cli_pagination("use xpath var", "es", "http://example.com/ns/example-social", "text", "10");
|
|
json, cli_pagination("use xpath var", "es", "http://example.com/ns/example-social", "json", "10");
|
|
}
|
|
configuration("Show configuration"), cli_auto_show("datamodel", "candidate", "text", true, false);{
|
|
xml("Show configuration as XML"), cli_auto_show("datamodel", "candidate", "xml", true, false);{
|
|
default("With-default mode"){
|
|
report-all, cli_auto_show("datamodel", "candidate", "xml", true, false, "report-all");
|
|
trim, cli_auto_show("datamodel", "candidate", "xml", true, false, "trim");
|
|
explicit, cli_auto_show("datamodel", "candidate", "xml", true, false, "explicit");
|
|
report-all-tagged, cli_auto_show("datamodel", "candidate", "xml", true, false, "report-all-tagged");
|
|
report-all-tagged-default, cli_auto_show("datamodel", "candidate", "xml", true, false, "report-all-tagged-default");
|
|
report-all-tagged-strip, cli_auto_show("datamodel", "candidate", "xml", true, false, "report-all-tagged-strip");
|
|
}
|
|
}
|
|
cli("Show configuration as CLI commands"), cli_auto_show("datamodel", "candidate", "cli", true, false, "explicit", "set ");
|
|
netconf("Show configuration as netconf edit-config operation"), cli_auto_show("datamodel", "candidate", "netconf", true, false);
|
|
text("Show configuration as text"), cli_auto_show("datamodel", "candidate", "text", true, false);
|
|
json("Show configuration as JSON"), cli_auto_show("datamodel", "candidate", "json", true, false);
|
|
|
|
}
|
|
state("Show configuration and state"), cli_auto_show("datamodel", "running", "text", true, true); {
|
|
xml("Show configuration and state as XML"), cli_auto_show("datamodel", "running", "xml", true, true);{
|
|
default("With-default mode"){
|
|
report-all, cli_auto_show("datamodel", "running", "xml", true, true, "report-all");
|
|
trim, cli_auto_show("datamodel", "running", "xml", true, true, "trim");
|
|
explicit, cli_auto_show("datamodel", "running", "xml", true, true, "explicit");
|
|
report-all-tagged, cli_auto_show("datamodel", "running", "xml", true, true, "report-all-tagged");
|
|
report-all-tagged-default, cli_auto_show("datamodel", "running", "xml", true, true, "report-all-tagged-default");
|
|
report-all-tagged-strip, cli_auto_show("datamodel", "running", "xml", true, true, "report-all-tagged-strip");
|
|
}
|
|
}
|
|
}
|
|
yang("Show yang specs"), show_yang(); {
|
|
clixon-example("Show clixon-example yang spec"), show_yang("clixon-example");
|
|
}
|
|
}
|
|
|
|
save("Save candidate configuration to XML file") <filename:string>("Filename (local filename)"), save_config_file("candidate","filename", "xml");{
|
|
cli("Save configuration as CLI commands"), save_config_file("candidate","filename", "cli");
|
|
xml("Save configuration as XML"), save_config_file("candidate","filename", "xml");
|
|
json("Save configuration as JSON"), save_config_file("candidate","filename", "json");
|
|
text("Save configuration as TEXT"), save_config_file("candidate","filename", "text");
|
|
netconf("Save configuration as NETCONF"), save_config_file("candidate","filename", "netconf");
|
|
}
|
|
load("Load configuration from XML file") <filename:string>("Filename (local filename)"),load_config_file("filename", "replace");{
|
|
replace("Replace candidate with file contents"), load_config_file("filename", "replace");{
|
|
cli("Replace candidate with file containing CLI commands"), load_config_file("filename", "replace", "cli");
|
|
xml("Replace candidate with file containing XML"), load_config_file("filename", "replace", "xml");
|
|
json("Replace candidate with file containing JSON"), load_config_file("filename", "replace", "json");
|
|
text("Replace candidate with file containing TEXT"), load_config_file("filename", "replace", "text");
|
|
}
|
|
merge("Merge file with existent candidate"), load_config_file("filename", "merge");{
|
|
cli("Merge candidate with file containing CLI commands"), load_config_file("filename", "merge", "cli");
|
|
xml("Merge candidate with file containing XML"), load_config_file("filename", "merge", "xml");
|
|
json("Merge candidate with file containing JSON"), load_config_file("filename", "merge", "json");
|
|
text("Merge candidate with file containing TEXT"), load_config_file("filename", "merge", "text");
|
|
}
|
|
}
|
|
example("This is a comment") <var:int32>("Just a random number"), mycallback("myarg");
|
|
rpc("example rpc") <a:string>("routing instance"), example_client_rpc("");
|
|
notify("Get notifications from backend"), cli_notify("EXAMPLE", "1", "text");
|
|
no("Negate") notify("Get notifications from backend"), cli_notify("EXAMPLE", "0", "xml");
|
|
lock,cli_lock("candidate");
|
|
unlock,cli_unlock("candidate");
|
|
restart <plugin:string>, cli_restart_plugin();
|