]>
Commit | Line | Data |
---|---|---|
1 | /* | |
2 | * Zebra configuration command interface routine | |
3 | * Copyright (C) 1997, 98 Kunihiro Ishiguro | |
4 | * | |
5 | * This file is part of GNU Zebra. | |
6 | * | |
7 | * GNU Zebra is free software; you can redistribute it and/or modify | |
8 | * it under the terms of the GNU General Public License as published | |
9 | * by the Free Software Foundation; either version 2, or (at your | |
10 | * option) any later version. | |
11 | * | |
12 | * GNU Zebra is distributed in the hope that it will be useful, but | |
13 | * WITHOUT ANY WARRANTY; without even the implied warranty of | |
14 | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU | |
15 | * General Public License for more details. | |
16 | * | |
17 | * You should have received a copy of the GNU General Public License along | |
18 | * with this program; see the file COPYING; if not, write to the Free Software | |
19 | * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA | |
20 | */ | |
21 | ||
22 | #ifndef _ZEBRA_COMMAND_H | |
23 | #define _ZEBRA_COMMAND_H | |
24 | ||
25 | #include "vector.h" | |
26 | #include "vty.h" | |
27 | #include "lib/route_types.h" | |
28 | #include "graph.h" | |
29 | #include "memory.h" | |
30 | #include "hash.h" | |
31 | #include "command_graph.h" | |
32 | ||
33 | #ifdef __cplusplus | |
34 | extern "C" { | |
35 | #endif | |
36 | ||
37 | DECLARE_MTYPE(COMPLETION); | |
38 | ||
39 | /* | |
40 | * From RFC 1123 (Requirements for Internet Hosts), Section 2.1 on hostnames: | |
41 | * One aspect of host name syntax is hereby changed: the restriction on | |
42 | * the first character is relaxed to allow either a letter or a digit. | |
43 | * Host software MUST support this more liberal syntax. | |
44 | * | |
45 | * Host software MUST handle host names of up to 63 characters and | |
46 | * SHOULD handle host names of up to 255 characters. | |
47 | */ | |
48 | #define HOSTNAME_LEN 255 | |
49 | ||
50 | /* Host configuration variable */ | |
51 | struct host { | |
52 | /* Host name of this router. */ | |
53 | char *name; | |
54 | ||
55 | /* Domainname of this router */ | |
56 | char *domainname; | |
57 | ||
58 | /* | |
59 | * Some extra system data that is useful | |
60 | */ | |
61 | char *system; | |
62 | char *release; | |
63 | char *version; | |
64 | ||
65 | /* Password for vty interface. */ | |
66 | char *password; | |
67 | char *password_encrypt; | |
68 | ||
69 | /* Enable password */ | |
70 | char *enable; | |
71 | char *enable_encrypt; | |
72 | ||
73 | /* System wide terminal lines. */ | |
74 | int lines; | |
75 | ||
76 | /* config file name of this host */ | |
77 | char *config; | |
78 | int noconfig; | |
79 | ||
80 | /* Flags for services */ | |
81 | int advanced; | |
82 | int encrypt; | |
83 | ||
84 | /* Banner configuration. */ | |
85 | char *motd; | |
86 | char *motdfile; | |
87 | ||
88 | /* Allow using IPv4 (Class E) reserved IP space */ | |
89 | bool allow_reserved_ranges; | |
90 | }; | |
91 | ||
92 | /* List of CLI nodes. Please remember to update the name array in command.c. */ | |
93 | enum node_type { | |
94 | AUTH_NODE, /* Authentication mode of vty interface. */ | |
95 | VIEW_NODE, /* View node. Default mode of vty interface. */ | |
96 | AUTH_ENABLE_NODE, /* Authentication mode for change enable. */ | |
97 | ENABLE_NODE, /* Enable node. */ | |
98 | CONFIG_NODE, /* Config node. Default mode of config file. */ | |
99 | DEBUG_NODE, /* Debug node. */ | |
100 | VRF_DEBUG_NODE, /* Vrf Debug node. */ | |
101 | NORTHBOUND_DEBUG_NODE, /* Northbound Debug node. */ | |
102 | DEBUG_VNC_NODE, /* Debug VNC node. */ | |
103 | RMAP_DEBUG_NODE, /* Route-map debug node */ | |
104 | RESOLVER_DEBUG_NODE, /* Resolver debug node */ | |
105 | AAA_NODE, /* AAA node. */ | |
106 | EXTLOG_NODE, /* RFC5424 & co. extended syslog */ | |
107 | KEYCHAIN_NODE, /* Key-chain node. */ | |
108 | KEYCHAIN_KEY_NODE, /* Key-chain key node. */ | |
109 | IP_NODE, /* Static ip route node. */ | |
110 | VRF_NODE, /* VRF mode node. */ | |
111 | INTERFACE_NODE, /* Interface mode node. */ | |
112 | NH_GROUP_NODE, /* Nexthop-Group mode node. */ | |
113 | ZEBRA_NODE, /* zebra connection node. */ | |
114 | TABLE_NODE, /* rtm_table selection node. */ | |
115 | RIP_NODE, /* RIP protocol mode node. */ | |
116 | RIPNG_NODE, /* RIPng protocol mode node. */ | |
117 | BABEL_NODE, /* BABEL protocol mode node. */ | |
118 | EIGRP_NODE, /* EIGRP protocol mode node. */ | |
119 | BGP_NODE, /* BGP protocol mode which includes BGP4+ */ | |
120 | BGP_VPNV4_NODE, /* BGP MPLS-VPN PE exchange. */ | |
121 | BGP_VPNV6_NODE, /* BGP MPLS-VPN PE exchange. */ | |
122 | BGP_IPV4_NODE, /* BGP IPv4 unicast address family. */ | |
123 | BGP_IPV4M_NODE, /* BGP IPv4 multicast address family. */ | |
124 | BGP_IPV4L_NODE, /* BGP IPv4 labeled unicast address family. */ | |
125 | BGP_IPV6_NODE, /* BGP IPv6 address family */ | |
126 | BGP_IPV6M_NODE, /* BGP IPv6 multicast address family. */ | |
127 | BGP_IPV6L_NODE, /* BGP IPv6 labeled unicast address family. */ | |
128 | BGP_VRF_POLICY_NODE, /* BGP VRF policy */ | |
129 | BGP_VNC_DEFAULTS_NODE, /* BGP VNC nve defaults */ | |
130 | BGP_VNC_NVE_GROUP_NODE, /* BGP VNC nve group */ | |
131 | BGP_VNC_L2_GROUP_NODE, /* BGP VNC L2 group */ | |
132 | RFP_DEFAULTS_NODE, /* RFP defaults node */ | |
133 | BGP_EVPN_NODE, /* BGP EVPN node. */ | |
134 | BGP_SRV6_NODE, /* BGP SRv6 node. */ | |
135 | OSPF_NODE, /* OSPF protocol mode */ | |
136 | OSPF6_NODE, /* OSPF protocol for IPv6 mode */ | |
137 | LDP_NODE, /* LDP protocol mode */ | |
138 | LDP_IPV4_NODE, /* LDP IPv4 address family */ | |
139 | LDP_IPV6_NODE, /* LDP IPv6 address family */ | |
140 | LDP_IPV4_IFACE_NODE, /* LDP IPv4 Interface */ | |
141 | LDP_IPV6_IFACE_NODE, /* LDP IPv6 Interface */ | |
142 | LDP_L2VPN_NODE, /* LDP L2VPN node */ | |
143 | LDP_PSEUDOWIRE_NODE, /* LDP Pseudowire node */ | |
144 | ISIS_NODE, /* ISIS protocol mode */ | |
145 | ACCESS_NODE, /* Access list node. */ | |
146 | PREFIX_NODE, /* Prefix list node. */ | |
147 | ACCESS_IPV6_NODE, /* Access list node. */ | |
148 | ACCESS_MAC_NODE, /* MAC access list node*/ | |
149 | PREFIX_IPV6_NODE, /* Prefix list node. */ | |
150 | AS_LIST_NODE, /* AS list node. */ | |
151 | COMMUNITY_LIST_NODE, /* Community list node. */ | |
152 | COMMUNITY_ALIAS_NODE, /* Community alias node. */ | |
153 | RMAP_NODE, /* Route map node. */ | |
154 | PBRMAP_NODE, /* PBR map node. */ | |
155 | SMUX_NODE, /* SNMP configuration node. */ | |
156 | DUMP_NODE, /* Packet dump node. */ | |
157 | FORWARDING_NODE, /* IP forwarding node. */ | |
158 | PROTOCOL_NODE, /* protocol filtering node */ | |
159 | MPLS_NODE, /* MPLS config node */ | |
160 | PW_NODE, /* Pseudowire config node */ | |
161 | SEGMENT_ROUTING_NODE, /* Segment routing root node */ | |
162 | SR_TRAFFIC_ENG_NODE, /* SR Traffic Engineering node */ | |
163 | SR_SEGMENT_LIST_NODE, /* SR segment list config node */ | |
164 | SR_POLICY_NODE, /* SR policy config node */ | |
165 | SR_CANDIDATE_DYN_NODE, /* SR dynamic candidate path config node */ | |
166 | PCEP_NODE, /* PCEP node */ | |
167 | PCEP_PCE_CONFIG_NODE, /* PCE shared configuration node */ | |
168 | PCEP_PCE_NODE, /* PCE configuration node */ | |
169 | PCEP_PCC_NODE, /* PCC configuration node */ | |
170 | SRV6_NODE, /* SRv6 node */ | |
171 | SRV6_LOCS_NODE, /* SRv6 locators node */ | |
172 | SRV6_LOC_NODE, /* SRv6 locator node */ | |
173 | VTY_NODE, /* Vty node. */ | |
174 | FPM_NODE, /* Dataplane FPM node. */ | |
175 | LINK_PARAMS_NODE, /* Link-parameters node */ | |
176 | BGP_EVPN_VNI_NODE, /* BGP EVPN VNI */ | |
177 | RPKI_NODE, /* RPKI node for configuration of RPKI cache server | |
178 | connections.*/ | |
179 | BGP_FLOWSPECV4_NODE, /* BGP IPv4 FLOWSPEC Address-Family */ | |
180 | BGP_FLOWSPECV6_NODE, /* BGP IPv6 FLOWSPEC Address-Family */ | |
181 | BFD_NODE, /* BFD protocol mode. */ | |
182 | BFD_PEER_NODE, /* BFD peer configuration mode. */ | |
183 | BFD_PROFILE_NODE, /* BFD profile configuration mode. */ | |
184 | OPENFABRIC_NODE, /* OpenFabric router configuration node */ | |
185 | VRRP_NODE, /* VRRP node */ | |
186 | BMP_NODE, /* BMP config under router bgp */ | |
187 | NODE_TYPE_MAX, /* maximum */ | |
188 | }; | |
189 | ||
190 | extern vector cmdvec; | |
191 | extern const struct message tokennames[]; | |
192 | ||
193 | /* for external users depending on struct layout */ | |
194 | #define FRR_CMD_NODE_20200416 | |
195 | ||
196 | /* Node which has some commands and prompt string and configuration | |
197 | function pointer . */ | |
198 | struct cmd_node { | |
199 | const char *name; | |
200 | ||
201 | /* Node index. */ | |
202 | enum node_type node; | |
203 | enum node_type parent_node; | |
204 | ||
205 | /* Prompt character at vty interface. */ | |
206 | const char *prompt; | |
207 | ||
208 | /* Node's configuration write function */ | |
209 | int (*config_write)(struct vty *); | |
210 | ||
211 | /* called when leaving the node on a VTY session. | |
212 | * return 1 if normal exit processing should happen, 0 to suppress | |
213 | */ | |
214 | int (*node_exit)(struct vty *); | |
215 | ||
216 | /* Node's command graph */ | |
217 | struct graph *cmdgraph; | |
218 | ||
219 | /* Vector of this node's command list. */ | |
220 | vector cmd_vector; | |
221 | ||
222 | /* Hashed index of command node list, for de-dupping primarily */ | |
223 | struct hash *cmd_hash; | |
224 | ||
225 | /* set as soon as any command is in cmdgraph */ | |
226 | bool graph_built; | |
227 | ||
228 | /* don't decrement vty->xpath_index on leaving this node */ | |
229 | bool no_xpath; | |
230 | }; | |
231 | ||
232 | /* Return value of the commands. */ | |
233 | #define CMD_SUCCESS 0 | |
234 | #define CMD_WARNING 1 | |
235 | #define CMD_ERR_NO_MATCH 2 | |
236 | #define CMD_ERR_AMBIGUOUS 3 | |
237 | #define CMD_ERR_INCOMPLETE 4 | |
238 | #define CMD_ERR_EXEED_ARGC_MAX 5 | |
239 | #define CMD_ERR_NOTHING_TODO 6 | |
240 | #define CMD_COMPLETE_FULL_MATCH 7 | |
241 | #define CMD_COMPLETE_MATCH 8 | |
242 | #define CMD_COMPLETE_LIST_MATCH 9 | |
243 | #define CMD_SUCCESS_DAEMON 10 | |
244 | #define CMD_ERR_NO_FILE 11 | |
245 | #define CMD_SUSPEND 12 | |
246 | #define CMD_WARNING_CONFIG_FAILED 13 | |
247 | #define CMD_NOT_MY_INSTANCE 14 | |
248 | #define CMD_NO_LEVEL_UP 15 | |
249 | #define CMD_ERR_NO_DAEMON 16 | |
250 | ||
251 | /* Argc max counts. */ | |
252 | #define CMD_ARGC_MAX 256 | |
253 | ||
254 | /* helper defines for end-user DEFUN* macros */ | |
255 | #define DEFUN_CMD_ELEMENT(funcname, cmdname, cmdstr, helpstr, attrs, dnum) \ | |
256 | static const struct cmd_element cmdname = { \ | |
257 | .string = cmdstr, \ | |
258 | .func = funcname, \ | |
259 | .doc = helpstr, \ | |
260 | .attr = attrs, \ | |
261 | .daemon = dnum, \ | |
262 | .name = #cmdname, \ | |
263 | .xref = XREF_INIT(XREFT_DEFUN, NULL, #funcname), \ | |
264 | }; \ | |
265 | XREF_LINK(cmdname.xref); \ | |
266 | /* end */ | |
267 | ||
268 | ||
269 | #define DEFUN_CMD_FUNC_DECL(funcname) \ | |
270 | static int funcname(const struct cmd_element *, struct vty *, int, \ | |
271 | struct cmd_token *[]); | |
272 | ||
273 | #define DEFUN_CMD_FUNC_TEXT(funcname) \ | |
274 | static int funcname(const struct cmd_element *self \ | |
275 | __attribute__((unused)), \ | |
276 | struct vty *vty __attribute__((unused)), \ | |
277 | int argc __attribute__((unused)), \ | |
278 | struct cmd_token *argv[] __attribute__((unused))) | |
279 | ||
280 | /* DEFPY variants */ | |
281 | ||
282 | #define DEFPY_ATTR(funcname, cmdname, cmdstr, helpstr, attr) \ | |
283 | DEFUN_CMD_ELEMENT(funcname, cmdname, cmdstr, helpstr, attr, 0) \ | |
284 | funcdecl_##funcname | |
285 | ||
286 | #define DEFPY(funcname, cmdname, cmdstr, helpstr) \ | |
287 | DEFPY_ATTR(funcname, cmdname, cmdstr, helpstr, 0) | |
288 | ||
289 | #define DEFPY_NOSH(funcname, cmdname, cmdstr, helpstr) \ | |
290 | DEFPY_ATTR(funcname, cmdname, cmdstr, helpstr, CMD_ATTR_NOSH) | |
291 | ||
292 | #define DEFPY_HIDDEN(funcname, cmdname, cmdstr, helpstr) \ | |
293 | DEFPY_ATTR(funcname, cmdname, cmdstr, helpstr, CMD_ATTR_HIDDEN) | |
294 | ||
295 | #define DEFPY_YANG(funcname, cmdname, cmdstr, helpstr) \ | |
296 | DEFPY_ATTR(funcname, cmdname, cmdstr, helpstr, CMD_ATTR_YANG) | |
297 | ||
298 | #define DEFPY_YANG_NOSH(funcname, cmdname, cmdstr, helpstr) \ | |
299 | DEFPY_ATTR(funcname, cmdname, cmdstr, helpstr, \ | |
300 | CMD_ATTR_YANG | CMD_ATTR_NOSH) | |
301 | ||
302 | /* DEFUN variants */ | |
303 | ||
304 | #define DEFUN_ATTR(funcname, cmdname, cmdstr, helpstr, attr) \ | |
305 | DEFUN_CMD_FUNC_DECL(funcname) \ | |
306 | DEFUN_CMD_ELEMENT(funcname, cmdname, cmdstr, helpstr, attr, 0) \ | |
307 | DEFUN_CMD_FUNC_TEXT(funcname) | |
308 | ||
309 | #define DEFUN(funcname, cmdname, cmdstr, helpstr) \ | |
310 | DEFUN_ATTR(funcname, cmdname, cmdstr, helpstr, 0) | |
311 | ||
312 | #define DEFUN_HIDDEN(funcname, cmdname, cmdstr, helpstr) \ | |
313 | DEFUN_ATTR(funcname, cmdname, cmdstr, helpstr, CMD_ATTR_HIDDEN) | |
314 | ||
315 | #define DEFUN_YANG(funcname, cmdname, cmdstr, helpstr) \ | |
316 | DEFUN_ATTR(funcname, cmdname, cmdstr, helpstr, CMD_ATTR_YANG) | |
317 | ||
318 | /* DEFUN_NOSH for commands that vtysh should ignore */ | |
319 | #define DEFUN_NOSH(funcname, cmdname, cmdstr, helpstr) \ | |
320 | DEFUN_ATTR(funcname, cmdname, cmdstr, helpstr, CMD_ATTR_NOSH) | |
321 | ||
322 | #define DEFUN_YANG_NOSH(funcname, cmdname, cmdstr, helpstr) \ | |
323 | DEFUN_ATTR(funcname, cmdname, cmdstr, helpstr, \ | |
324 | CMD_ATTR_YANG | CMD_ATTR_NOSH) | |
325 | ||
326 | /* DEFSH for vtysh. */ | |
327 | #define DEFSH_ATTR(daemon, cmdname, cmdstr, helpstr, attr) \ | |
328 | DEFUN_CMD_ELEMENT(NULL, cmdname, cmdstr, helpstr, attr, daemon) | |
329 | ||
330 | #define DEFSH(daemon, cmdname, cmdstr, helpstr) \ | |
331 | DEFSH_ATTR(daemon, cmdname, cmdstr, helpstr, 0) | |
332 | ||
333 | #define DEFSH_HIDDEN(daemon, cmdname, cmdstr, helpstr) \ | |
334 | DEFSH_ATTR(daemon, cmdname, cmdstr, helpstr, CMD_ATTR_HIDDEN) | |
335 | ||
336 | /* DEFUN + DEFSH */ | |
337 | #define DEFUNSH_ATTR(daemon, funcname, cmdname, cmdstr, helpstr, attr) \ | |
338 | DEFUN_CMD_FUNC_DECL(funcname) \ | |
339 | DEFUN_CMD_ELEMENT(funcname, cmdname, cmdstr, helpstr, attr, daemon) \ | |
340 | DEFUN_CMD_FUNC_TEXT(funcname) | |
341 | ||
342 | #define DEFUNSH(daemon, funcname, cmdname, cmdstr, helpstr) \ | |
343 | DEFUNSH_ATTR(daemon, funcname, cmdname, cmdstr, helpstr, 0) | |
344 | ||
345 | #define DEFUNSH_HIDDEN(daemon, funcname, cmdname, cmdstr, helpstr) \ | |
346 | DEFUNSH_ATTR(daemon, funcname, cmdname, cmdstr, helpstr, \ | |
347 | CMD_ATTR_HIDDEN) | |
348 | ||
349 | /* ALIAS macro which define existing command's alias. */ | |
350 | #define ALIAS_ATTR(funcname, cmdname, cmdstr, helpstr, attr) \ | |
351 | DEFUN_CMD_ELEMENT(funcname, cmdname, cmdstr, helpstr, attr, 0) | |
352 | ||
353 | #define ALIAS(funcname, cmdname, cmdstr, helpstr) \ | |
354 | ALIAS_ATTR(funcname, cmdname, cmdstr, helpstr, 0) | |
355 | ||
356 | #define ALIAS_HIDDEN(funcname, cmdname, cmdstr, helpstr) \ | |
357 | ALIAS_ATTR(funcname, cmdname, cmdstr, helpstr, CMD_ATTR_HIDDEN) | |
358 | ||
359 | /* note: DEPRECATED implies HIDDEN, and other than that there is currently no | |
360 | * difference. It's purely for expressing intent in the source code - a | |
361 | * DEPRECATED command is supposed to go away, a HIDDEN one is likely to stay. | |
362 | */ | |
363 | #define ALIAS_DEPRECATED(funcname, cmdname, cmdstr, helpstr) \ | |
364 | ALIAS_ATTR(funcname, cmdname, cmdstr, helpstr, \ | |
365 | CMD_ATTR_DEPRECATED | CMD_ATTR_HIDDEN) | |
366 | ||
367 | #define ALIAS_YANG(funcname, cmdname, cmdstr, helpstr) \ | |
368 | ALIAS_ATTR(funcname, cmdname, cmdstr, helpstr, CMD_ATTR_YANG) | |
369 | ||
370 | /* Some macroes */ | |
371 | ||
372 | /* | |
373 | * Sometimes #defines create maximum values that | |
374 | * need to have strings created from them that | |
375 | * allow the parser to match against them. | |
376 | * These macros allow that. | |
377 | */ | |
378 | #define CMD_CREATE_STR(s) CMD_CREATE_STR_HELPER(s) | |
379 | #define CMD_CREATE_STR_HELPER(s) #s | |
380 | #define CMD_RANGE_STR(a,s) "(" CMD_CREATE_STR(a) "-" CMD_CREATE_STR(s) ")" | |
381 | ||
382 | /* Common descriptions. */ | |
383 | #define SHOW_STR "Show running system information\n" | |
384 | #define IP_STR "IP information\n" | |
385 | #define IPV6_STR "IPv6 information\n" | |
386 | #define IP_ADDR_STR "IPv4 Address\n" | |
387 | #define IP6_ADDR_STR "IPv6 Address\n" | |
388 | #define SRTE_STR "SR-TE information\n" | |
389 | #define SRTE_COLOR_STR "SR-TE Color information\n" | |
390 | #define NO_STR "Negate a command or set its defaults\n" | |
391 | #define IGNORED_IN_NO_STR "Ignored value in no form\n" | |
392 | #define REDIST_STR "Redistribute information from another routing protocol\n" | |
393 | #define CLEAR_STR "Reset functions\n" | |
394 | #define RIP_STR "RIP information\n" | |
395 | #define EIGRP_STR "EIGRP information\n" | |
396 | #define BGP_STR "BGP information\n" | |
397 | #define BGP_SOFT_STR "Soft reconfig inbound and outbound updates\n" | |
398 | #define BGP_SOFT_IN_STR "Send route-refresh unless using 'soft-reconfiguration inbound'\n" | |
399 | #define BGP_SOFT_OUT_STR "Resend all outbound updates\n" | |
400 | #define BGP_SOFT_RSCLIENT_RIB_STR "Soft reconfig for rsclient RIB\n" | |
401 | #define OSPF_STR "OSPF information\n" | |
402 | #define NEIGHBOR_STR "Specify neighbor router\n" | |
403 | #define DEBUG_STR "Debugging functions\n" | |
404 | #define UNDEBUG_STR "Disable debugging functions (see also 'debug')\n" | |
405 | #define ROUTER_STR "Enable a routing process\n" | |
406 | #define AS_STR "AS number\n" | |
407 | #define MAC_STR "MAC address\n" | |
408 | #define MBGP_STR "MBGP information\n" | |
409 | #define MATCH_STR "Match values from routing table\n" | |
410 | #define SET_STR "Set values in destination routing protocol\n" | |
411 | #define OUT_STR "Filter outgoing routing updates\n" | |
412 | #define IN_STR "Filter incoming routing updates\n" | |
413 | #define V4NOTATION_STR "specify by IPv4 address notation(e.g. 0.0.0.0)\n" | |
414 | #define OSPF6_NUMBER_STR "Specify by number\n" | |
415 | #define INTERFACE_STR "Interface information\n" | |
416 | #define IFNAME_STR "Interface name(e.g. ep0)\n" | |
417 | #define IP6_STR "IPv6 Information\n" | |
418 | #define OSPF6_STR "Open Shortest Path First (OSPF) for IPv6\n" | |
419 | #define OSPF6_INSTANCE_STR "(1-65535) Instance ID\n" | |
420 | #define SECONDS_STR "Seconds\n" | |
421 | #define ROUTE_STR "Routing Table\n" | |
422 | #define PREFIX_LIST_STR "Build a prefix list\n" | |
423 | #define OSPF6_DUMP_TYPE_LIST \ | |
424 | "<neighbor|interface|area|lsa|zebra|config|dbex|spf|route|lsdb|redistribute|hook|asbr|prefix|abr>" | |
425 | #define AREA_TAG_STR "[area tag]\n" | |
426 | #define COMMUNITY_AANN_STR "Community number where AA and NN are (0-65535)\n" | |
427 | #define COMMUNITY_VAL_STR \ | |
428 | "Community number in AA:NN format (where AA and NN are (0-65535)) or local-AS|no-advertise|no-export|internet|graceful-shutdown|accept-own-nexthop|accept-own|route-filter-translated-v4|route-filter-v4|route-filter-translated-v6|route-filter-v6|llgr-stale|no-llgr|blackhole|no-peer or additive\n" | |
429 | #define MPLS_TE_STR "MPLS-TE specific commands\n" | |
430 | #define LINK_PARAMS_STR "Configure interface link parameters\n" | |
431 | #define OSPF_RI_STR "OSPF Router Information specific commands\n" | |
432 | #define PCE_STR "PCE Router Information specific commands\n" | |
433 | #define MPLS_STR "MPLS information\n" | |
434 | #define SR_STR "Segment-Routing specific commands\n" | |
435 | #define WATCHFRR_STR "watchfrr information\n" | |
436 | #define ZEBRA_STR "Zebra information\n" | |
437 | #define FILTER_LOG_STR "Filter Logs\n" | |
438 | #define BFD_PROFILE_STR "BFD profile.\n" | |
439 | #define BFD_PROFILE_NAME_STR "BFD profile name.\n" | |
440 | #define SHARP_STR "Sharp Routing Protocol\n" | |
441 | #define OSPF_GR_STR \ | |
442 | "OSPF non-stop forwarding (NSF) also known as OSPF Graceful Restart\n" | |
443 | ||
444 | #define CMD_VNI_RANGE "(1-16777215)" | |
445 | #define CONF_BACKUP_EXT ".sav" | |
446 | #define MPLS_LDP_SYNC_STR "Enable MPLS LDP-SYNC\n" | |
447 | #define NO_MPLS_LDP_SYNC_STR "Disable MPLS LDP-SYNC\n" | |
448 | #define MPLS_LDP_SYNC_HOLDDOWN_STR \ | |
449 | "Time to wait for LDP-SYNC to occur before restoring if cost\n" | |
450 | #define NO_MPLS_LDP_SYNC_HOLDDOWN_STR "holddown timer disable\n" | |
451 | ||
452 | /* Command warnings. */ | |
453 | #define NO_PASSWD_CMD_WARNING \ | |
454 | "Please be aware that removing the password is a security risk and you should think twice about this command.\n" | |
455 | ||
456 | /* IPv4 only machine should not accept IPv6 address for peer's IP | |
457 | address. So we replace VTY command string like below. */ | |
458 | #define NEIGHBOR_ADDR_STR "Neighbor address\nIPv6 address\n" | |
459 | #define NEIGHBOR_ADDR_STR2 "Neighbor address\nNeighbor IPv6 address\nInterface name or neighbor tag\n" | |
460 | #define NEIGHBOR_ADDR_STR3 "Neighbor address\nIPv6 address\nInterface name\n" | |
461 | ||
462 | /* Graceful Restart cli help strings */ | |
463 | #define GR_CMD "Global Graceful Restart command\n" | |
464 | #define NO_GR_CMD "Undo Global Graceful Restart command\n" | |
465 | #define GR "Global Graceful Restart - GR Mode\n" | |
466 | #define GR_DISABLE "Global Graceful Restart - Disable Mode\n" | |
467 | #define NO_GR_DISABLE "Undo Global Graceful Restart - Disable Mode\n" | |
468 | #define GR_DEBUG "Graceful Restart - Enable Debug Logs\n" | |
469 | #define GR_SHOW "Graceful Restart - Show command for Global and all neighbor mode\n" | |
470 | #define GR_NEIGHBOR_CMD "Graceful Restart command for a neighbor\n" | |
471 | #define NO_GR_NEIGHBOR_CMD "Undo Graceful Restart command for a neighbor\n" | |
472 | #define GR_NEIGHBOR_DISABLE_CMD "Graceful Restart Disable command for a neighbor\n" | |
473 | #define NO_GR_NEIGHBOR_DISABLE_CMD "Undo Graceful Restart Disable command for a neighbor\n" | |
474 | #define GR_NEIGHBOR_HELPER_CMD "Graceful Restart Helper command for a neighbor\n" | |
475 | #define NO_GR_NEIGHBOR_HELPER_CMD "Undo Graceful Restart Helper command for a neighbor\n" | |
476 | ||
477 | /* EVPN help Strings */ | |
478 | #define EVPN_RT_HELP_STR "EVPN route information\n" | |
479 | #define EVPN_RT_DIST_HELP_STR "Route Distinguisher\n" | |
480 | #define EVPN_ASN_IP_HELP_STR "ASN:XX or A.B.C.D:XX\n" | |
481 | #define EVPN_TYPE_HELP_STR "Specify Route type\n" | |
482 | #define EVPN_TYPE_1_HELP_STR "EAD (Type-1) route\n" | |
483 | #define EVPN_TYPE_2_HELP_STR "MAC-IP (Type-2) route\n" | |
484 | #define EVPN_TYPE_3_HELP_STR "Multicast (Type-3) route\n" | |
485 | #define EVPN_TYPE_4_HELP_STR "Ethernet Segment (Type-4) route\n" | |
486 | #define EVPN_TYPE_5_HELP_STR "Prefix (Type-5) route\n" | |
487 | #define EVPN_TYPE_ALL_LIST "<ead|1|macip|2|multicast|3|es|4|prefix|5>" | |
488 | #define EVPN_TYPE_ALL_LIST_HELP_STR \ | |
489 | EVPN_TYPE_1_HELP_STR EVPN_TYPE_1_HELP_STR \ | |
490 | EVPN_TYPE_2_HELP_STR EVPN_TYPE_2_HELP_STR \ | |
491 | EVPN_TYPE_3_HELP_STR EVPN_TYPE_3_HELP_STR \ | |
492 | EVPN_TYPE_4_HELP_STR EVPN_TYPE_4_HELP_STR \ | |
493 | EVPN_TYPE_5_HELP_STR EVPN_TYPE_5_HELP_STR | |
494 | ||
495 | /* Describing roles */ | |
496 | #define ROLE_STR \ | |
497 | "Providing transit\nRoute server\nRS client\nUsing transit\nPublic/private peering\n" | |
498 | ||
499 | /* BFD protocol integration strings. */ | |
500 | #define BFD_INTEGRATION_STR "BFD monitoring\n" | |
501 | #define BFD_INTEGRATION_MULTI_HOP_STR "Use BFD multi hop session\n" | |
502 | #define BFD_INTEGRATION_SOURCE_STR "Use source for BFD session\n" | |
503 | #define BFD_INTEGRATION_SOURCEV4_STR "Use IPv4 source for BFD session\n" | |
504 | #define BFD_INTEGRATION_SOURCEV6_STR "Use IPv4 source for BFD session\n" | |
505 | ||
506 | /* Prototypes. */ | |
507 | extern void install_node(struct cmd_node *node); | |
508 | extern void install_default(enum node_type); | |
509 | ||
510 | struct xref_install_element { | |
511 | struct xref xref; | |
512 | ||
513 | const struct cmd_element *cmd_element; | |
514 | enum node_type node_type; | |
515 | }; | |
516 | ||
517 | #define install_element(node_type_, cmd_element_) do { \ | |
518 | static const struct xref_install_element _xref \ | |
519 | __attribute__((used)) = { \ | |
520 | .xref = XREF_INIT(XREFT_INSTALL_ELEMENT, NULL, \ | |
521 | __func__), \ | |
522 | .cmd_element = cmd_element_, \ | |
523 | .node_type = node_type_, \ | |
524 | }; \ | |
525 | XREF_LINK(_xref.xref); \ | |
526 | _install_element(node_type_, cmd_element_); \ | |
527 | } while (0) | |
528 | ||
529 | extern void _install_element(enum node_type, const struct cmd_element *); | |
530 | ||
531 | /* known issue with uninstall_element: changes to cmd_token->attr (i.e. | |
532 | * deprecated/hidden) are not reversed. */ | |
533 | extern void uninstall_element(enum node_type, const struct cmd_element *); | |
534 | ||
535 | /* construct CLI tree only when entering nodes */ | |
536 | extern void cmd_defer_tree(bool val); | |
537 | ||
538 | /* finish CLI tree for node when above is true (noop otherwise) */ | |
539 | extern void cmd_finalize_node(struct cmd_node *node); | |
540 | ||
541 | /* Concatenates argv[shift] through argv[argc-1] into a single NUL-terminated | |
542 | string with a space between each element (allocated using | |
543 | XMALLOC(MTYPE_TMP)). Returns NULL if shift >= argc. */ | |
544 | extern char *argv_concat(struct cmd_token **argv, int argc, int shift); | |
545 | ||
546 | /* | |
547 | * It is preferred that you set the index initial value | |
548 | * to a 0. This way in the future if you modify the | |
549 | * cli then there is no need to modify the initial | |
550 | * value of the index | |
551 | */ | |
552 | extern int argv_find(struct cmd_token **argv, int argc, const char *text, | |
553 | int *index); | |
554 | ||
555 | extern vector cmd_make_strvec(const char *); | |
556 | extern void cmd_free_strvec(vector); | |
557 | extern vector cmd_describe_command(vector, struct vty *, int *status); | |
558 | extern char **cmd_complete_command(vector, struct vty *, int *status); | |
559 | extern const char *cmd_prompt(enum node_type); | |
560 | extern int command_config_read_one_line(struct vty *vty, | |
561 | const struct cmd_element **, | |
562 | uint32_t line_num, int use_config_node); | |
563 | extern int config_from_file(struct vty *, FILE *, unsigned int *line_num); | |
564 | extern enum node_type node_parent(enum node_type); | |
565 | /* | |
566 | * Execute command under the given vty context. | |
567 | * | |
568 | * vty | |
569 | * The vty context to execute under. | |
570 | * | |
571 | * cmd | |
572 | * The command string to execute. | |
573 | * | |
574 | * matched | |
575 | * If non-null and a match was found, the address of the matched command is | |
576 | * stored here. No action otherwise. | |
577 | * | |
578 | * vtysh | |
579 | * Whether or not this is being called from vtysh. If this is nonzero, | |
580 | * XXX: then what? | |
581 | * | |
582 | * Returns: | |
583 | * XXX: what does it return | |
584 | */ | |
585 | extern int cmd_execute(struct vty *vty, const char *cmd, | |
586 | const struct cmd_element **matched, int vtysh); | |
587 | extern int cmd_execute_command(vector, struct vty *, | |
588 | const struct cmd_element **, int); | |
589 | extern int cmd_execute_command_strict(vector, struct vty *, | |
590 | const struct cmd_element **); | |
591 | extern void cmd_init(int terminal); | |
592 | extern void cmd_init_config_callbacks(void (*start_config_cb)(void), | |
593 | void (*end_config_cb)(void)); | |
594 | extern void cmd_terminate(void); | |
595 | extern void cmd_exit(struct vty *vty); | |
596 | extern int cmd_list_cmds(struct vty *vty, int do_permute); | |
597 | extern int cmd_find_cmds(struct vty *vty, struct cmd_token **argv, int argc); | |
598 | ||
599 | extern int cmd_domainname_set(const char *domainname); | |
600 | extern int cmd_hostname_set(const char *hostname); | |
601 | extern const char *cmd_hostname_get(void); | |
602 | extern const char *cmd_domainname_get(void); | |
603 | extern const char *cmd_system_get(void); | |
604 | extern const char *cmd_release_get(void); | |
605 | extern const char *cmd_version_get(void); | |
606 | extern bool cmd_allow_reserved_ranges_get(void); | |
607 | ||
608 | /* NOT safe for general use; call this only if DEV_BUILD! */ | |
609 | extern void grammar_sandbox_init(void); | |
610 | ||
611 | extern vector completions_to_vec(struct list *completions); | |
612 | ||
613 | /* Export typical functions. */ | |
614 | extern const char *host_config_get(void); | |
615 | extern void host_config_set(const char *); | |
616 | ||
617 | extern void print_version(const char *); | |
618 | ||
619 | extern int cmd_banner_motd_file(const char *); | |
620 | extern void cmd_banner_motd_line(const char *line); | |
621 | ||
622 | struct cmd_variable_handler { | |
623 | const char *tokenname, *varname; | |
624 | void (*completions)(vector out, struct cmd_token *token); | |
625 | }; | |
626 | ||
627 | extern void cmd_variable_complete(struct cmd_token *token, const char *arg, | |
628 | vector comps); | |
629 | extern void | |
630 | cmd_variable_handler_register(const struct cmd_variable_handler *cvh); | |
631 | extern char *cmd_variable_comp2str(vector comps, unsigned short cols); | |
632 | ||
633 | extern void command_setup_early_logging(const char *dest, const char *level); | |
634 | ||
635 | /* | |
636 | * Allow a mechanism for `debug XXX` commands that live | |
637 | * under the lib directory to output their debug status | |
638 | */ | |
639 | extern void cmd_show_lib_debugs(struct vty *vty); | |
640 | ||
641 | #ifdef __cplusplus | |
642 | } | |
643 | #endif | |
644 | ||
645 | #endif /* _ZEBRA_COMMAND_H */ |