Neels Hofmeyr | 17518fe | 2017-06-20 04:35:06 +0200 | [diff] [blame] | 1 | /*! \file command.h |
| 2 | * Zebra configuration command interface routine. */ |
Harald Welte | 3fb0b6f | 2010-05-19 19:02:52 +0200 | [diff] [blame] | 3 | /* |
Harald Welte | 3fb0b6f | 2010-05-19 19:02:52 +0200 | [diff] [blame] | 4 | * Copyright (C) 1997, 98 Kunihiro Ishiguro |
| 5 | * |
| 6 | * This file is part of GNU Zebra. |
| 7 | * |
| 8 | * GNU Zebra is free software; you can redistribute it and/or modify |
| 9 | * it under the terms of the GNU General Public License as published |
| 10 | * by the Free Software Foundation; either version 2, or (at your |
| 11 | * option) any later version. |
| 12 | * |
| 13 | * GNU Zebra is distributed in the hope that it will be useful, but |
| 14 | * WITHOUT ANY WARRANTY; without even the implied warranty of |
| 15 | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU |
| 16 | * General Public License for more details. |
| 17 | * |
| 18 | * You should have received a copy of the GNU General Public License |
| 19 | * along with GNU Zebra; see the file COPYING. If not, write to the |
Jaroslav Škarvada | 2b82c1c | 2015-11-11 16:02:54 +0100 | [diff] [blame] | 20 | * Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, |
| 21 | * Boston, MA 02110-1301, USA. |
Harald Welte | 3fb0b6f | 2010-05-19 19:02:52 +0200 | [diff] [blame] | 22 | */ |
| 23 | |
Sylvain Munaut | 12ba778 | 2014-06-16 10:13:40 +0200 | [diff] [blame] | 24 | #pragma once |
Harald Welte | 3fb0b6f | 2010-05-19 19:02:52 +0200 | [diff] [blame] | 25 | |
| 26 | #include <stdio.h> |
| 27 | #include <sys/types.h> |
| 28 | #include "vector.h" |
Harald Welte | 3fb0b6f | 2010-05-19 19:02:52 +0200 | [diff] [blame] | 29 | |
Neels Hofmeyr | f4f23bd | 2017-09-20 15:39:37 +0200 | [diff] [blame] | 30 | #include <osmocom/core/defs.h> |
| 31 | |
Harald Welte | e881b1b | 2011-08-17 18:52:30 +0200 | [diff] [blame] | 32 | /*! \defgroup command VTY Command |
Harald Welte | 7acb30c | 2011-08-17 17:13:48 +0200 | [diff] [blame] | 33 | * @{ |
Neels Hofmeyr | 17518fe | 2017-06-20 04:35:06 +0200 | [diff] [blame] | 34 | * \file command.h */ |
Harald Welte | 7acb30c | 2011-08-17 17:13:48 +0200 | [diff] [blame] | 35 | |
Neels Hofmeyr | 87e4550 | 2017-06-20 00:17:59 +0200 | [diff] [blame] | 36 | /*! Host configuration variable */ |
Harald Welte | 3fb0b6f | 2010-05-19 19:02:52 +0200 | [diff] [blame] | 37 | struct host { |
Neels Hofmeyr | 87e4550 | 2017-06-20 00:17:59 +0200 | [diff] [blame] | 38 | /*! Host name of this router. */ |
Harald Welte | 3fb0b6f | 2010-05-19 19:02:52 +0200 | [diff] [blame] | 39 | char *name; |
| 40 | |
Neels Hofmeyr | 87e4550 | 2017-06-20 00:17:59 +0200 | [diff] [blame] | 41 | /*! Password for vty interface. */ |
Harald Welte | 3fb0b6f | 2010-05-19 19:02:52 +0200 | [diff] [blame] | 42 | char *password; |
| 43 | char *password_encrypt; |
| 44 | |
Neels Hofmeyr | 87e4550 | 2017-06-20 00:17:59 +0200 | [diff] [blame] | 45 | /*! Enable password */ |
Harald Welte | 3fb0b6f | 2010-05-19 19:02:52 +0200 | [diff] [blame] | 46 | char *enable; |
| 47 | char *enable_encrypt; |
| 48 | |
Neels Hofmeyr | 87e4550 | 2017-06-20 00:17:59 +0200 | [diff] [blame] | 49 | /*! System wide terminal lines. */ |
Harald Welte | 3fb0b6f | 2010-05-19 19:02:52 +0200 | [diff] [blame] | 50 | int lines; |
| 51 | |
Neels Hofmeyr | 87e4550 | 2017-06-20 00:17:59 +0200 | [diff] [blame] | 52 | /*! Log filename. */ |
Harald Welte | 3fb0b6f | 2010-05-19 19:02:52 +0200 | [diff] [blame] | 53 | char *logfile; |
| 54 | |
Neels Hofmeyr | 87e4550 | 2017-06-20 00:17:59 +0200 | [diff] [blame] | 55 | /*! config file name of this host */ |
Harald Welte | 3fb0b6f | 2010-05-19 19:02:52 +0200 | [diff] [blame] | 56 | char *config; |
| 57 | |
Neels Hofmeyr | 87e4550 | 2017-06-20 00:17:59 +0200 | [diff] [blame] | 58 | /*! Flags for services */ |
Harald Welte | 3fb0b6f | 2010-05-19 19:02:52 +0200 | [diff] [blame] | 59 | int advanced; |
| 60 | int encrypt; |
| 61 | |
Neels Hofmeyr | 87e4550 | 2017-06-20 00:17:59 +0200 | [diff] [blame] | 62 | /*! Banner configuration. */ |
Harald Welte | 3fb0b6f | 2010-05-19 19:02:52 +0200 | [diff] [blame] | 63 | const char *motd; |
| 64 | char *motdfile; |
| 65 | |
Neels Hofmeyr | 87e4550 | 2017-06-20 00:17:59 +0200 | [diff] [blame] | 66 | /*! VTY application information */ |
Harald Welte | 237f624 | 2010-05-25 23:00:45 +0200 | [diff] [blame] | 67 | const struct vty_app_info *app_info; |
Harald Welte | 3fb0b6f | 2010-05-19 19:02:52 +0200 | [diff] [blame] | 68 | }; |
| 69 | |
Neels Hofmeyr | 87e4550 | 2017-06-20 00:17:59 +0200 | [diff] [blame] | 70 | /*! There are some command levels which called from command node. */ |
Harald Welte | 3fb0b6f | 2010-05-19 19:02:52 +0200 | [diff] [blame] | 71 | enum node_type { |
Neels Hofmeyr | 87e4550 | 2017-06-20 00:17:59 +0200 | [diff] [blame] | 72 | AUTH_NODE, /*!< Authentication mode of vty interface. */ |
| 73 | VIEW_NODE, /*!< View node. Default mode of vty interface. */ |
| 74 | AUTH_ENABLE_NODE, /*!< Authentication mode for change enable. */ |
| 75 | ENABLE_NODE, /*!< Enable node. */ |
| 76 | CONFIG_NODE, /*!< Config node. Default mode of config file. */ |
| 77 | SERVICE_NODE, /*!< Service node. */ |
| 78 | DEBUG_NODE, /*!< Debug node. */ |
| 79 | CFG_LOG_NODE, /*!< Configure the logging */ |
| 80 | CFG_STATS_NODE, /*!< Configure the statistics */ |
Harald Welte | 4c05301 | 2010-05-31 16:01:59 +0200 | [diff] [blame] | 81 | |
Neels Hofmeyr | 87e4550 | 2017-06-20 00:17:59 +0200 | [diff] [blame] | 82 | VTY_NODE, /*!< Vty node. */ |
Harald Welte | 3fb0b6f | 2010-05-19 19:02:52 +0200 | [diff] [blame] | 83 | |
Neels Hofmeyr | 87e4550 | 2017-06-20 00:17:59 +0200 | [diff] [blame] | 84 | L_E1INP_NODE, /*!< E1 line in libosmo-abis. */ |
| 85 | L_IPA_NODE, /*!< IPA proxying commands in libosmo-abis. */ |
| 86 | L_NS_NODE, /*!< NS node in libosmo-gb. */ |
| 87 | L_BSSGP_NODE, /*!< BSSGP node in libosmo-gb. */ |
| 88 | L_CTRL_NODE, /*!< Control interface node. */ |
Pablo Neira Ayuso | 2ade3a0 | 2011-07-07 19:46:50 +0200 | [diff] [blame] | 89 | |
Neels Hofmeyr | 87e4550 | 2017-06-20 00:17:59 +0200 | [diff] [blame] | 90 | L_CS7_NODE, /*!< SS7 root node */ |
| 91 | L_CS7_AS_NODE, /*!< SS7 Application Server */ |
| 92 | L_CS7_ASP_NODE, /*!< SS7 Application Server Process */ |
| 93 | L_CS7_XUA_NODE, /*!< SS7 xUA Listener */ |
| 94 | L_CS7_RTABLE_NODE, /*!< SS7 Routing Table */ |
| 95 | L_CS7_LINK_NODE, /*!< SS7 Link */ |
| 96 | L_CS7_LINKSET_NODE, /*!< SS7 Linkset */ |
| 97 | L_CS7_SCCPADDR_NODE, /*!< SS7 SCCP Address */ |
| 98 | L_CS7_SCCPADDR_GT_NODE, /*!< SS7 SCCP Global Title */ |
Harald Welte | b522740 | 2017-04-14 14:01:56 +0200 | [diff] [blame] | 99 | |
Pau Espin Pedrol | eb6882f | 2020-07-28 11:57:51 +0200 | [diff] [blame] | 100 | L_CPU_SCHED_NODE, /*!< CPU Sched related options node */ |
Jacob Erlbeck | 34eec7d | 2015-11-02 10:50:50 +0100 | [diff] [blame] | 101 | /* |
| 102 | * When adding new nodes to the libosmocore project, these nodes can be |
| 103 | * used to avoid ABI changes for unrelated projects. |
| 104 | */ |
Neels Hofmeyr | 87e4550 | 2017-06-20 00:17:59 +0200 | [diff] [blame] | 105 | RESERVED3_NODE, /*!< Reserved for later extensions */ |
Jacob Erlbeck | 34eec7d | 2015-11-02 10:50:50 +0100 | [diff] [blame] | 106 | |
Harald Welte | 4c05301 | 2010-05-31 16:01:59 +0200 | [diff] [blame] | 107 | _LAST_OSMOVTY_NODE |
Harald Welte | 3fb0b6f | 2010-05-19 19:02:52 +0200 | [diff] [blame] | 108 | }; |
| 109 | |
Andreas Eversberg | 3c6a2ce | 2012-07-12 09:22:56 +0200 | [diff] [blame] | 110 | #include "vty.h" |
| 111 | |
Neels Hofmeyr | 87e4550 | 2017-06-20 00:17:59 +0200 | [diff] [blame] | 112 | /*! Node which has some commands and prompt string and |
Harald Welte | 7acb30c | 2011-08-17 17:13:48 +0200 | [diff] [blame] | 113 | * configuration function pointer . */ |
Harald Welte | 3fb0b6f | 2010-05-19 19:02:52 +0200 | [diff] [blame] | 114 | struct cmd_node { |
Neels Hofmeyr | 87e4550 | 2017-06-20 00:17:59 +0200 | [diff] [blame] | 115 | /*! Node index */ |
Holger Hans Peter Freyther | a9e5252 | 2015-08-02 02:14:07 +0000 | [diff] [blame] | 116 | int node; |
Harald Welte | 3fb0b6f | 2010-05-19 19:02:52 +0200 | [diff] [blame] | 117 | |
Neels Hofmeyr | 87e4550 | 2017-06-20 00:17:59 +0200 | [diff] [blame] | 118 | /*! Prompt character at vty interface. */ |
Harald Welte | 3fb0b6f | 2010-05-19 19:02:52 +0200 | [diff] [blame] | 119 | const char *prompt; |
| 120 | |
Neels Hofmeyr | 87e4550 | 2017-06-20 00:17:59 +0200 | [diff] [blame] | 121 | /*! Is this node's configuration goes to vtysh ? */ |
Harald Welte | 3fb0b6f | 2010-05-19 19:02:52 +0200 | [diff] [blame] | 122 | int vtysh; |
| 123 | |
Neels Hofmeyr | 87e4550 | 2017-06-20 00:17:59 +0200 | [diff] [blame] | 124 | /*! Node's configuration write function */ |
Harald Welte | 3fb0b6f | 2010-05-19 19:02:52 +0200 | [diff] [blame] | 125 | int (*func) (struct vty *); |
| 126 | |
Neels Hofmeyr | 87e4550 | 2017-06-20 00:17:59 +0200 | [diff] [blame] | 127 | /*! Vector of this node's command list. */ |
Harald Welte | 3fb0b6f | 2010-05-19 19:02:52 +0200 | [diff] [blame] | 128 | vector cmd_vector; |
Neels Hofmeyr | 657c5b6 | 2017-09-18 16:42:06 +0200 | [diff] [blame] | 129 | |
| 130 | /*! Human-readable ID of this node. Should only contain alphanumeric |
| 131 | * plus '-' and '_' characters (is used as XML ID for 'show |
| 132 | * online-help'). If left NUL, this is derived from the prompt.*/ |
| 133 | char name[64]; |
Harald Welte | 3fb0b6f | 2010-05-19 19:02:52 +0200 | [diff] [blame] | 134 | }; |
| 135 | |
Vadim Yanitskiy | e65c8ba | 2018-09-24 12:56:31 +0700 | [diff] [blame] | 136 | /*! Attributes (flags) for \ref cmd_element */ |
Harald Welte | 3fb0b6f | 2010-05-19 19:02:52 +0200 | [diff] [blame] | 137 | enum { |
Vadim Yanitskiy | e65c8ba | 2018-09-24 12:56:31 +0700 | [diff] [blame] | 138 | CMD_ATTR_DEPRECATED = (1 << 0), |
| 139 | CMD_ATTR_HIDDEN = (1 << 1), |
Vadim Yanitskiy | 4a96b7c | 2020-09-28 12:42:27 +0700 | [diff] [blame] | 140 | CMD_ATTR_IMMEDIATE = (1 << 2), |
Vadim Yanitskiy | ceb3b39 | 2020-10-06 00:20:24 +0700 | [diff] [blame] | 141 | CMD_ATTR_NODE_EXIT = (1 << 3), |
Vadim Yanitskiy | 99d5c2d | 2020-10-06 00:22:06 +0700 | [diff] [blame] | 142 | CMD_ATTR_LIB_COMMAND = (1 << 4), |
Harald Welte | 3fb0b6f | 2010-05-19 19:02:52 +0200 | [diff] [blame] | 143 | }; |
| 144 | |
Vadim Yanitskiy | c0745eb | 2020-10-04 18:37:13 +0700 | [diff] [blame] | 145 | /*! Attributes shared between libraries (up to 32 entries). */ |
| 146 | enum { |
| 147 | /* The entries of this enum shall conform the following requirements: |
| 148 | * 1. Naming format: 'OSMO_' + <LIBNAME> + '_LIB_ATTR_' + <ATTRNAME>, |
| 149 | * where LIBNAME is a short name of the library, e.g. 'ABIS', 'MGCP', |
| 150 | * and ATTRNAME is a brief name of the attribute, e.g. RTP_CONN_EST; |
| 151 | * for example: 'OSMO_ABIS_LIB_ATTR_RSL_LINK_UP'. |
| 152 | * 2. Brevity: shortenings and abbreviations are welcome! |
| 153 | * 3. Values are not flags but indexes, unlike CMD_ATTR_*. |
| 154 | * 4. Ordering: new entries added before _OSMO_CORE_LIB_ATTR_COUNT. */ |
Philipp Maier | 608b1a4 | 2020-10-05 20:54:51 +0200 | [diff] [blame] | 155 | OSMO_SCCP_LIB_ATTR_RSTRT_ASP, |
Philipp Maier | a5218ea | 2020-10-08 17:30:42 +0200 | [diff] [blame] | 156 | OSMO_ABIS_LIB_ATTR_IPA_NEW_LNK, |
| 157 | OSMO_ABIS_LIB_ATTR_LINE_UPD, |
Vadim Yanitskiy | c0745eb | 2020-10-04 18:37:13 +0700 | [diff] [blame] | 158 | |
| 159 | /* Keep this floating entry last, it's needed for count check. */ |
| 160 | _OSMO_CORE_LIB_ATTR_COUNT |
| 161 | }; |
| 162 | |
Neels Hofmeyr | 87e4550 | 2017-06-20 00:17:59 +0200 | [diff] [blame] | 163 | /*! Structure of a command element */ |
Harald Welte | 3fb0b6f | 2010-05-19 19:02:52 +0200 | [diff] [blame] | 164 | struct cmd_element { |
Neels Hofmeyr | 87e4550 | 2017-06-20 00:17:59 +0200 | [diff] [blame] | 165 | const char *string; /*!< Command specification by string. */ |
Harald Welte | 3fb0b6f | 2010-05-19 19:02:52 +0200 | [diff] [blame] | 166 | int (*func) (struct cmd_element *, struct vty *, int, const char *[]); |
Neels Hofmeyr | 87e4550 | 2017-06-20 00:17:59 +0200 | [diff] [blame] | 167 | const char *doc; /*!< Documentation of this command. */ |
| 168 | int daemon; /*!< Daemon to which this command belong. */ |
| 169 | vector strvec; /*!< Pointing out each description vector. */ |
| 170 | unsigned int cmdsize; /*!< Command index count. */ |
| 171 | char *config; /*!< Configuration string */ |
| 172 | vector subconfig; /*!< Sub configuration string */ |
Vadim Yanitskiy | 7f1ecd9 | 2020-08-15 22:16:30 +0700 | [diff] [blame] | 173 | unsigned char attr; /*!< Command attributes (global) */ |
| 174 | unsigned int usrattr; /*!< Command attributes (program specific) */ |
Harald Welte | 3fb0b6f | 2010-05-19 19:02:52 +0200 | [diff] [blame] | 175 | }; |
| 176 | |
Neels Hofmeyr | 87e4550 | 2017-06-20 00:17:59 +0200 | [diff] [blame] | 177 | /*! Command description structure. */ |
Harald Welte | 3fb0b6f | 2010-05-19 19:02:52 +0200 | [diff] [blame] | 178 | struct desc { |
Neels Hofmeyr | 87e4550 | 2017-06-20 00:17:59 +0200 | [diff] [blame] | 179 | const char *cmd; /*!< Command string. */ |
| 180 | const char *str; /*!< Command's description. */ |
Harald Welte | 3fb0b6f | 2010-05-19 19:02:52 +0200 | [diff] [blame] | 181 | }; |
| 182 | |
Neels Hofmeyr | 87e4550 | 2017-06-20 00:17:59 +0200 | [diff] [blame] | 183 | /*! Return value of the commands. */ |
Harald Welte | 3fb0b6f | 2010-05-19 19:02:52 +0200 | [diff] [blame] | 184 | #define CMD_SUCCESS 0 |
| 185 | #define CMD_WARNING 1 |
| 186 | #define CMD_ERR_NO_MATCH 2 |
| 187 | #define CMD_ERR_AMBIGUOUS 3 |
| 188 | #define CMD_ERR_INCOMPLETE 4 |
| 189 | #define CMD_ERR_EXEED_ARGC_MAX 5 |
| 190 | #define CMD_ERR_NOTHING_TODO 6 |
| 191 | #define CMD_COMPLETE_FULL_MATCH 7 |
| 192 | #define CMD_COMPLETE_MATCH 8 |
| 193 | #define CMD_COMPLETE_LIST_MATCH 9 |
| 194 | #define CMD_SUCCESS_DAEMON 10 |
Neels Hofmeyr | 4a31ffa | 2017-09-07 03:08:06 +0200 | [diff] [blame] | 195 | #define CMD_ERR_INVALID_INDENT 11 |
Harald Welte | 3fb0b6f | 2010-05-19 19:02:52 +0200 | [diff] [blame] | 196 | |
| 197 | /* Argc max counts. */ |
Holger Hans Peter Freyther | c0dbe0b | 2011-07-24 19:58:06 +0200 | [diff] [blame] | 198 | #define CMD_ARGC_MAX 256 |
Harald Welte | 3fb0b6f | 2010-05-19 19:02:52 +0200 | [diff] [blame] | 199 | |
| 200 | /* Turn off these macros when uisng cpp with extract.pl */ |
| 201 | #ifndef VTYSH_EXTRACT_PL |
| 202 | |
| 203 | /* helper defines for end-user DEFUN* macros */ |
| 204 | #define DEFUN_CMD_ELEMENT(funcname, cmdname, cmdstr, helpstr, attrs, dnum) \ |
| 205 | static struct cmd_element cmdname = \ |
| 206 | { \ |
| 207 | .string = cmdstr, \ |
| 208 | .func = funcname, \ |
| 209 | .doc = helpstr, \ |
| 210 | .attr = attrs, \ |
| 211 | .daemon = dnum, \ |
| 212 | }; |
| 213 | |
| 214 | /* global (non static) cmd_element */ |
| 215 | #define gDEFUN_CMD_ELEMENT(funcname, cmdname, cmdstr, helpstr, attrs, dnum) \ |
| 216 | struct cmd_element cmdname = \ |
| 217 | { \ |
| 218 | .string = cmdstr, \ |
| 219 | .func = funcname, \ |
| 220 | .doc = helpstr, \ |
| 221 | .attr = attrs, \ |
| 222 | .daemon = dnum, \ |
| 223 | }; |
| 224 | |
Vadim Yanitskiy | 7f1ecd9 | 2020-08-15 22:16:30 +0700 | [diff] [blame] | 225 | #define DEFUN_CMD_ELEMENT_ATTR_USRATTR(funcname, cmdname, cmdstr, helpstr, attrs, usrattrs) \ |
| 226 | static struct cmd_element cmdname = \ |
| 227 | { \ |
| 228 | .string = cmdstr, \ |
| 229 | .func = funcname, \ |
| 230 | .doc = helpstr, \ |
| 231 | .attr = attrs, \ |
| 232 | .usrattr = usrattrs, \ |
| 233 | }; |
| 234 | |
Harald Welte | 3fb0b6f | 2010-05-19 19:02:52 +0200 | [diff] [blame] | 235 | #define DEFUN_CMD_FUNC_DECL(funcname) \ |
| 236 | static int funcname (struct cmd_element *, struct vty *, int, const char *[]); \ |
| 237 | |
| 238 | #define DEFUN_CMD_FUNC_TEXT(funcname) \ |
| 239 | static int funcname \ |
| 240 | (struct cmd_element *self, struct vty *vty, int argc, const char *argv[]) |
| 241 | |
Neels Hofmeyr | 87e4550 | 2017-06-20 00:17:59 +0200 | [diff] [blame] | 242 | /*! Macro for defining a VTY node and function |
Harald Welte | 7acb30c | 2011-08-17 17:13:48 +0200 | [diff] [blame] | 243 | * \param[in] funcname Name of the function implementing the node |
| 244 | * \param[in] cmdname Name of the command node |
| 245 | * \param[in] cmdstr String with syntax of node |
| 246 | * \param[in] helpstr String with help message of node |
| 247 | */ |
Harald Welte | 3fb0b6f | 2010-05-19 19:02:52 +0200 | [diff] [blame] | 248 | #define DEFUN(funcname, cmdname, cmdstr, helpstr) \ |
| 249 | DEFUN_CMD_FUNC_DECL(funcname) \ |
| 250 | DEFUN_CMD_ELEMENT(funcname, cmdname, cmdstr, helpstr, 0, 0) \ |
| 251 | DEFUN_CMD_FUNC_TEXT(funcname) |
| 252 | |
Neels Hofmeyr | 87e4550 | 2017-06-20 00:17:59 +0200 | [diff] [blame] | 253 | /*! Macro for defining a non-static (global) VTY node and function |
Harald Welte | 7acb30c | 2011-08-17 17:13:48 +0200 | [diff] [blame] | 254 | * \param[in] funcname Name of the function implementing the node |
| 255 | * \param[in] cmdname Name of the command node |
| 256 | * \param[in] cmdstr String with syntax of node |
| 257 | * \param[in] helpstr String with help message of node |
| 258 | */ |
Harald Welte | 3fb0b6f | 2010-05-19 19:02:52 +0200 | [diff] [blame] | 259 | #define gDEFUN(funcname, cmdname, cmdstr, helpstr) \ |
| 260 | DEFUN_CMD_FUNC_DECL(funcname) \ |
| 261 | gDEFUN_CMD_ELEMENT(funcname, cmdname, cmdstr, helpstr, 0, 0) \ |
| 262 | DEFUN_CMD_FUNC_TEXT(funcname) |
| 263 | |
| 264 | #define DEFUN_ATTR(funcname, cmdname, cmdstr, helpstr, attr) \ |
| 265 | DEFUN_CMD_FUNC_DECL(funcname) \ |
| 266 | DEFUN_CMD_ELEMENT(funcname, cmdname, cmdstr, helpstr, attr, 0) \ |
| 267 | DEFUN_CMD_FUNC_TEXT(funcname) |
| 268 | |
| 269 | #define DEFUN_HIDDEN(funcname, cmdname, cmdstr, helpstr) \ |
| 270 | DEFUN_ATTR (funcname, cmdname, cmdstr, helpstr, CMD_ATTR_HIDDEN) |
| 271 | |
| 272 | #define DEFUN_DEPRECATED(funcname, cmdname, cmdstr, helpstr) \ |
Vadim Yanitskiy | 523c4e0 | 2020-08-12 16:41:34 +0700 | [diff] [blame] | 273 | DEFUN_ATTR (funcname, cmdname, cmdstr, helpstr, CMD_ATTR_DEPRECATED) |
Harald Welte | 3fb0b6f | 2010-05-19 19:02:52 +0200 | [diff] [blame] | 274 | |
Vadim Yanitskiy | 7f1ecd9 | 2020-08-15 22:16:30 +0700 | [diff] [blame] | 275 | /*! Macro for defining a VTY node and function with global & program specific attributes. |
| 276 | * \param[in] funcname Name of the function implementing the node. |
| 277 | * \param[in] cmdname Name of the command node. |
| 278 | * \param[in] attr Global attributes (see CMD_ATTR_*). |
| 279 | * \param[in] usrattr Program specific attributes. |
| 280 | * \param[in] cmdstr String with syntax of node. |
| 281 | * \param[in] helpstr String with help message of node. |
| 282 | */ |
| 283 | #define DEFUN_ATTR_USRATTR(funcname, cmdname, attr, usrattr, cmdstr, helpstr) \ |
| 284 | DEFUN_CMD_FUNC_DECL(funcname) \ |
| 285 | DEFUN_CMD_ELEMENT_ATTR_USRATTR(funcname, cmdname, cmdstr, helpstr, attr, usrattr) \ |
| 286 | DEFUN_CMD_FUNC_TEXT(funcname) |
| 287 | |
| 288 | #define DEFUN_USRATTR(funcname, cmdname, usrattr, cmdstr, helpstr) \ |
| 289 | DEFUN_ATTR_USRATTR(funcname, cmdname, 0, usrattr, cmdstr, helpstr) |
| 290 | |
Harald Welte | 3fb0b6f | 2010-05-19 19:02:52 +0200 | [diff] [blame] | 291 | /* DEFUN_NOSH for commands that vtysh should ignore */ |
| 292 | #define DEFUN_NOSH(funcname, cmdname, cmdstr, helpstr) \ |
| 293 | DEFUN(funcname, cmdname, cmdstr, helpstr) |
| 294 | |
| 295 | /* DEFSH for vtysh. */ |
| 296 | #define DEFSH(daemon, cmdname, cmdstr, helpstr) \ |
| 297 | DEFUN_CMD_ELEMENT(NULL, cmdname, cmdstr, helpstr, 0, daemon) \ |
| 298 | |
| 299 | /* DEFUN + DEFSH */ |
| 300 | #define DEFUNSH(daemon, funcname, cmdname, cmdstr, helpstr) \ |
| 301 | DEFUN_CMD_FUNC_DECL(funcname) \ |
| 302 | DEFUN_CMD_ELEMENT(funcname, cmdname, cmdstr, helpstr, 0, daemon) \ |
| 303 | DEFUN_CMD_FUNC_TEXT(funcname) |
| 304 | |
| 305 | /* DEFUN + DEFSH with attributes */ |
| 306 | #define DEFUNSH_ATTR(daemon, funcname, cmdname, cmdstr, helpstr, attr) \ |
| 307 | DEFUN_CMD_FUNC_DECL(funcname) \ |
| 308 | DEFUN_CMD_ELEMENT(funcname, cmdname, cmdstr, helpstr, attr, daemon) \ |
| 309 | DEFUN_CMD_FUNC_TEXT(funcname) |
| 310 | |
| 311 | #define DEFUNSH_HIDDEN(daemon, funcname, cmdname, cmdstr, helpstr) \ |
| 312 | DEFUNSH_ATTR (daemon, funcname, cmdname, cmdstr, helpstr, CMD_ATTR_HIDDEN) |
| 313 | |
| 314 | #define DEFUNSH_DEPRECATED(daemon, funcname, cmdname, cmdstr, helpstr) \ |
| 315 | DEFUNSH_ATTR (daemon, funcname, cmdname, cmdstr, helpstr, CMD_ATTR_DEPRECATED) |
| 316 | |
| 317 | /* ALIAS macro which define existing command's alias. */ |
| 318 | #define ALIAS(funcname, cmdname, cmdstr, helpstr) \ |
| 319 | DEFUN_CMD_ELEMENT(funcname, cmdname, cmdstr, helpstr, 0, 0) |
| 320 | |
| 321 | /* global (non static) cmd_element */ |
| 322 | #define gALIAS(funcname, cmdname, cmdstr, helpstr) \ |
| 323 | gDEFUN_CMD_ELEMENT(funcname, cmdname, cmdstr, helpstr, 0, 0) |
| 324 | |
| 325 | #define ALIAS_ATTR(funcname, cmdname, cmdstr, helpstr, attr) \ |
| 326 | DEFUN_CMD_ELEMENT(funcname, cmdname, cmdstr, helpstr, attr, 0) |
| 327 | |
| 328 | #define ALIAS_HIDDEN(funcname, cmdname, cmdstr, helpstr) \ |
| 329 | DEFUN_CMD_ELEMENT(funcname, cmdname, cmdstr, helpstr, CMD_ATTR_HIDDEN, 0) |
| 330 | |
| 331 | #define ALIAS_DEPRECATED(funcname, cmdname, cmdstr, helpstr) \ |
| 332 | DEFUN_CMD_ELEMENT(funcname, cmdname, cmdstr, helpstr, CMD_ATTR_DEPRECATED, 0) |
| 333 | |
| 334 | #define ALIAS_SH(daemon, funcname, cmdname, cmdstr, helpstr) \ |
| 335 | DEFUN_CMD_ELEMENT(funcname, cmdname, cmdstr, helpstr, 0, daemon) |
| 336 | |
| 337 | #define ALIAS_SH_HIDDEN(daemon, funcname, cmdname, cmdstr, helpstr) \ |
| 338 | DEFUN_CMD_ELEMENT(funcname, cmdname, cmdstr, helpstr, CMD_ATTR_HIDDEN, daemon) |
| 339 | |
| 340 | #define ALIAS_SH_DEPRECATED(daemon, funcname, cmdname, cmdstr, helpstr) \ |
| 341 | DEFUN_CMD_ELEMENT(funcname, cmdname, cmdstr, helpstr, CMD_ATTR_DEPRECATED, daemon) |
| 342 | |
| 343 | #endif /* VTYSH_EXTRACT_PL */ |
| 344 | |
| 345 | /* Some macroes */ |
| 346 | #define CMD_OPTION(S) ((S[0]) == '[') |
| 347 | #define CMD_VARIABLE(S) (((S[0]) >= 'A' && (S[0]) <= 'Z') || ((S[0]) == '<')) |
| 348 | #define CMD_VARARG(S) ((S[0]) == '.') |
| 349 | #define CMD_RANGE(S) ((S[0] == '<')) |
| 350 | |
| 351 | #define CMD_IPV4(S) ((strcmp ((S), "A.B.C.D") == 0)) |
| 352 | #define CMD_IPV4_PREFIX(S) ((strcmp ((S), "A.B.C.D/M") == 0)) |
| 353 | #define CMD_IPV6(S) ((strcmp ((S), "X:X::X:X") == 0)) |
| 354 | #define CMD_IPV6_PREFIX(S) ((strcmp ((S), "X:X::X:X/M") == 0)) |
| 355 | |
Alexander Couzens | 99c538e | 2020-06-08 00:28:36 +0200 | [diff] [blame] | 356 | #define VTY_IPV4_CMD "A.B.C.D" |
| 357 | #define VTY_IPV6_CMD "X:X::X:X" |
| 358 | #define VTY_IPV46_CMD "(" VTY_IPV4_CMD "|" VTY_IPV6_CMD ")" |
| 359 | |
Harald Welte | 3fb0b6f | 2010-05-19 19:02:52 +0200 | [diff] [blame] | 360 | /* Common descriptions. */ |
| 361 | #define SHOW_STR "Show running system information\n" |
| 362 | #define IP_STR "IP information\n" |
| 363 | #define IPV6_STR "IPv6 information\n" |
| 364 | #define NO_STR "Negate a command or set its defaults\n" |
| 365 | #define CLEAR_STR "Reset functions\n" |
| 366 | #define RIP_STR "RIP information\n" |
| 367 | #define BGP_STR "BGP information\n" |
| 368 | #define OSPF_STR "OSPF information\n" |
| 369 | #define NEIGHBOR_STR "Specify neighbor router\n" |
| 370 | #define DEBUG_STR "Debugging functions (see also 'undebug')\n" |
| 371 | #define UNDEBUG_STR "Disable debugging functions (see also 'debug')\n" |
| 372 | #define ROUTER_STR "Enable a routing process\n" |
| 373 | #define AS_STR "AS number\n" |
| 374 | #define MBGP_STR "MBGP information\n" |
| 375 | #define MATCH_STR "Match values from routing table\n" |
| 376 | #define SET_STR "Set values in destination routing protocol\n" |
| 377 | #define OUT_STR "Filter outgoing routing updates\n" |
| 378 | #define IN_STR "Filter incoming routing updates\n" |
| 379 | #define V4NOTATION_STR "specify by IPv4 address notation(e.g. 0.0.0.0)\n" |
| 380 | #define OSPF6_NUMBER_STR "Specify by number\n" |
| 381 | #define INTERFACE_STR "Interface infomation\n" |
| 382 | #define IFNAME_STR "Interface name(e.g. ep0)\n" |
| 383 | #define IP6_STR "IPv6 Information\n" |
| 384 | #define OSPF6_STR "Open Shortest Path First (OSPF) for IPv6\n" |
| 385 | #define OSPF6_ROUTER_STR "Enable a routing process\n" |
| 386 | #define OSPF6_INSTANCE_STR "<1-65535> Instance ID\n" |
| 387 | #define SECONDS_STR "<1-65535> Seconds\n" |
| 388 | #define ROUTE_STR "Routing Table\n" |
| 389 | #define PREFIX_LIST_STR "Build a prefix list\n" |
| 390 | #define OSPF6_DUMP_TYPE_LIST \ |
| 391 | "(neighbor|interface|area|lsa|zebra|config|dbex|spf|route|lsdb|redistribute|hook|asbr|prefix|abr)" |
| 392 | #define ISIS_STR "IS-IS information\n" |
| 393 | #define AREA_TAG_STR "[area tag]\n" |
| 394 | |
| 395 | #define CONF_BACKUP_EXT ".sav" |
| 396 | |
| 397 | /* IPv4 only machine should not accept IPv6 address for peer's IP |
| 398 | address. So we replace VTY command string like below. */ |
| 399 | #ifdef HAVE_IPV6 |
| 400 | #define NEIGHBOR_CMD "neighbor (A.B.C.D|X:X::X:X) " |
| 401 | #define NO_NEIGHBOR_CMD "no neighbor (A.B.C.D|X:X::X:X) " |
| 402 | #define NEIGHBOR_ADDR_STR "Neighbor address\nIPv6 address\n" |
| 403 | #define NEIGHBOR_CMD2 "neighbor (A.B.C.D|X:X::X:X|WORD) " |
| 404 | #define NO_NEIGHBOR_CMD2 "no neighbor (A.B.C.D|X:X::X:X|WORD) " |
| 405 | #define NEIGHBOR_ADDR_STR2 "Neighbor address\nNeighbor IPv6 address\nNeighbor tag\n" |
| 406 | #else |
| 407 | #define NEIGHBOR_CMD "neighbor A.B.C.D " |
| 408 | #define NO_NEIGHBOR_CMD "no neighbor A.B.C.D " |
| 409 | #define NEIGHBOR_ADDR_STR "Neighbor address\n" |
| 410 | #define NEIGHBOR_CMD2 "neighbor (A.B.C.D|WORD) " |
| 411 | #define NO_NEIGHBOR_CMD2 "no neighbor (A.B.C.D|WORD) " |
| 412 | #define NEIGHBOR_ADDR_STR2 "Neighbor address\nNeighbor tag\n" |
| 413 | #endif /* HAVE_IPV6 */ |
| 414 | |
| 415 | /* Prototypes. */ |
| 416 | void install_node(struct cmd_node *, int (*)(struct vty *)); |
Neels Hofmeyr | 4a73d5e | 2017-09-24 18:39:41 +0200 | [diff] [blame] | 417 | void install_default(int node_type) OSMO_DEPRECATED("Now happens implicitly with install_node()"); |
Holger Hans Peter Freyther | a9e5252 | 2015-08-02 02:14:07 +0000 | [diff] [blame] | 418 | void install_element(int node_type, struct cmd_element *); |
Vadim Yanitskiy | 99d5c2d | 2020-10-06 00:22:06 +0700 | [diff] [blame] | 419 | void install_lib_element(int node_type, struct cmd_element *); |
Harald Welte | 3fb0b6f | 2010-05-19 19:02:52 +0200 | [diff] [blame] | 420 | void install_element_ve(struct cmd_element *cmd); |
Vadim Yanitskiy | 99d5c2d | 2020-10-06 00:22:06 +0700 | [diff] [blame] | 421 | void install_lib_element_ve(struct cmd_element *cmd); |
Harald Welte | 95b2b47 | 2011-07-16 11:58:09 +0200 | [diff] [blame] | 422 | void sort_node(void); |
Harald Welte | 3fb0b6f | 2010-05-19 19:02:52 +0200 | [diff] [blame] | 423 | |
Neels Hofmeyr | 4a73d5e | 2017-09-24 18:39:41 +0200 | [diff] [blame] | 424 | void vty_install_default(int node_type) OSMO_DEPRECATED("Now happens implicitly with install_node()"); |
Jacob Erlbeck | 0c987bd | 2013-09-06 16:52:00 +0200 | [diff] [blame] | 425 | |
Harald Welte | 3fb0b6f | 2010-05-19 19:02:52 +0200 | [diff] [blame] | 426 | /* Concatenates argv[shift] through argv[argc-1] into a single NUL-terminated |
| 427 | string with a space between each element (allocated using |
| 428 | XMALLOC(MTYPE_TMP)). Returns NULL if shift >= argc. */ |
| 429 | char *argv_concat(const char **argv, int argc, int shift); |
| 430 | |
| 431 | vector cmd_make_strvec(const char *); |
Neels Hofmeyr | 4a31ffa | 2017-09-07 03:08:06 +0200 | [diff] [blame] | 432 | int cmd_make_strvec2(const char *string, char **indent, vector *strvec_p); |
Harald Welte | 3fb0b6f | 2010-05-19 19:02:52 +0200 | [diff] [blame] | 433 | void cmd_free_strvec(vector); |
| 434 | vector cmd_describe_command(); |
| 435 | char **cmd_complete_command(); |
| 436 | const char *cmd_prompt(enum node_type); |
| 437 | int config_from_file(struct vty *, FILE *); |
| 438 | enum node_type node_parent(enum node_type); |
| 439 | int cmd_execute_command(vector, struct vty *, struct cmd_element **, int); |
| 440 | int cmd_execute_command_strict(vector, struct vty *, struct cmd_element **); |
| 441 | void config_replace_string(struct cmd_element *, char *, ...); |
| 442 | void cmd_init(int); |
| 443 | |
| 444 | /* Export typical functions. */ |
| 445 | extern struct cmd_element config_exit_cmd; |
| 446 | extern struct cmd_element config_help_cmd; |
| 447 | extern struct cmd_element config_list_cmd; |
Harald Welte | 8ec7f90 | 2012-10-22 19:43:26 +0200 | [diff] [blame] | 448 | extern struct cmd_element config_end_cmd; |
Harald Welte | 3fb0b6f | 2010-05-19 19:02:52 +0200 | [diff] [blame] | 449 | char *host_config_file(); |
| 450 | void host_config_set(const char *); |
| 451 | |
Alexander Couzens | ad580ba | 2016-05-16 16:01:45 +0200 | [diff] [blame] | 452 | char *osmo_asciidoc_escape(const char *inp); |
| 453 | |
Harald Welte | 3fb0b6f | 2010-05-19 19:02:52 +0200 | [diff] [blame] | 454 | /* This is called from main when a daemon is invoked with -v or --version. */ |
| 455 | void print_version(int print_copyright); |
| 456 | |
| 457 | extern void *tall_vty_cmd_ctx; |
| 458 | |
Neels Hofmeyr | cf70aa0 | 2020-05-14 16:51:26 +0200 | [diff] [blame] | 459 | int vty_dump_xml_ref(FILE *stream); |
| 460 | |
Sylvain Munaut | dca7d2c | 2012-04-18 21:53:23 +0200 | [diff] [blame] | 461 | /*! @} */ |