FD.io VPP  v21.01.1
Vector Packet Processing
cli.h
Go to the documentation of this file.
1 /*
2  * Copyright (c) 2015 Cisco and/or its affiliates.
3  * Licensed under the Apache License, Version 2.0 (the "License");
4  * you may not use this file except in compliance with the License.
5  * You may obtain a copy of the License at:
6  *
7  * http://www.apache.org/licenses/LICENSE-2.0
8  *
9  * Unless required by applicable law or agreed to in writing, software
10  * distributed under the License is distributed on an "AS IS" BASIS,
11  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12  * See the License for the specific language governing permissions and
13  * limitations under the License.
14  */
15 /*
16  * cli.h: command line interface
17  *
18  * Copyright (c) 2008 Eliot Dresselhaus
19  *
20  * Permission is hereby granted, free of charge, to any person obtaining
21  * a copy of this software and associated documentation files (the
22  * "Software"), to deal in the Software without restriction, including
23  * without limitation the rights to use, copy, modify, merge, publish,
24  * distribute, sublicense, and/or sell copies of the Software, and to
25  * permit persons to whom the Software is furnished to do so, subject to
26  * the following conditions:
27  *
28  * The above copyright notice and this permission notice shall be
29  * included in all copies or substantial portions of the Software.
30  *
31  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
32  * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
33  * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
34  * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
35  * LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
36  * OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
37  * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
38  */
39 
40 #ifndef included_vlib_cli_h
41 #define included_vlib_cli_h
42 
43 #include <vppinfra/format.h>
44 
45 struct vlib_cli_command_t;
46 
47 typedef struct
48 {
50 
51  /* Indexed by name[position] - min_char. */
54 
55 typedef struct
56 {
57  u8 *name;
58 
61 
62 typedef struct
63 {
64  u8 *name;
65 
67 
70 
71 typedef struct
72 {
73  char *name;
74  char *short_help;
75  char *long_help;
76 
77  /* Number of bytes in parsed data. Zero for vector. */
79 
81 
82  /* Opaque for unformat function. */
83  uword unformat_function_arg[2];
85 
86 /* CLI command callback function. */
88  (struct vlib_main_t * vm,
89  unformat_input_t * input, struct vlib_cli_command_t * cmd);
90 
91 typedef struct vlib_cli_command_t
92 {
93  /* Command path (e.g. "show something").
94  Spaces delimit elements of path. */
95  char *path;
96 
97  /* Short/long help strings. */
98  char *short_help;
99  char *long_help;
100 
101  /* Callback function. */
103 
104  /* Opaque. */
106 
107  /* Known MP-safe? */
109 
110  /* Sub commands for this command. */
112 
113  /* Hash table mapping name (e.g. last path element) to sub command index. */
115 
116  /* bitmap[p][c][i] says whether sub-command i has character
117  c in position p. */
119 
120  /* Hash table mapping name (e.g. last path element) to sub rule index. */
122 
123  /* Vector of possible parse rules for this path. */
125 
126  /* List of CLI commands, built by constructors */
128 
129  /* Hit counter */
132 
133 typedef void (vlib_cli_output_function_t) (uword arg,
134  u8 * buffer, uword buffer_bytes);
135 typedef struct vlib_cli_main_t
136 {
137  /* Vector of all known commands. */
139 
140  /* Hash table mapping normalized path to index into all_commands. */
142 
143  /* registration list added by constructors */
145 
146  /* index vector, to sort commands, etc. */
148 
149 
150  /* performance counter callback */
151  void (**perf_counter_cbs)
152  (struct vlib_cli_main_t *, u32 id, int before_or_after);
153  void (**perf_counter_cbs_tmp)
154  (struct vlib_cli_main_t *, u32 id, int before_or_after);
156 
157 #ifndef CLIB_MARCH_VARIANT
158 #define VLIB_CLI_COMMAND(x,...) \
159  __VA_ARGS__ vlib_cli_command_t x; \
160 static void __vlib_cli_command_registration_##x (void) \
161  __attribute__((__constructor__)) ; \
162 static void __vlib_cli_command_registration_##x (void) \
163 { \
164  vlib_main_t * vm = vlib_get_main(); \
165  vlib_cli_main_t *cm = &vm->cli_main; \
166  x.next_cli_command = cm->cli_command_registrations; \
167  cm->cli_command_registrations = &x; \
168 } \
169 static void __vlib_cli_command_unregistration_##x (void) \
170  __attribute__((__destructor__)) ; \
171 static void __vlib_cli_command_unregistration_##x (void) \
172 { \
173  vlib_main_t * vm = vlib_get_main(); \
174  vlib_cli_main_t *cm = &vm->cli_main; \
175  VLIB_REMOVE_FROM_LINKED_LIST (cm->cli_command_registrations, &x, \
176  next_cli_command); \
177 } \
178 __VA_ARGS__ vlib_cli_command_t x
179 #else
180 /* create unused pointer to silence compiler warnings and get whole
181  function optimized out */
182 #define VLIB_CLI_COMMAND(x,...) \
183 static __clib_unused vlib_cli_command_t __clib_unused_##x
184 #endif
185 
186 #define VLIB_CLI_PARSE_RULE(x) \
187  vlib_cli_parse_rule_t x
188 /* Output to current CLI connection. */
189 void vlib_cli_output (struct vlib_main_t *vm, char *fmt, ...);
190 
191 /* Process CLI input. */
192 int vlib_cli_input (struct vlib_main_t *vm,
193  unformat_input_t * input,
194  vlib_cli_output_function_t * function,
196 
201 
203 
204 /* Return an vector of strings consisting of possible auto-completions
205  * for a given input string */
206 u8 **vlib_cli_get_possible_completions (u8 * input_str);
207 
208 #endif /* included_vlib_cli_h */
209 
210 /*
211  * fd.io coding-style-patch-verification: ON
212  *
213  * Local Variables:
214  * eval: (c-set-style "gnu")
215  * End:
216  */
unformat_function_t * unformat_function
Definition: cli.h:80
uword data_size
Definition: cli.h:78
vlib_cli_command_t * commands
Definition: cli.h:138
uword * sub_rule_index_by_name
Definition: cli.h:121
unsigned char u8
Definition: types.h:56
u8 id[64]
Definition: dhcp.api:160
clib_error_t * vlib_cli_register_parse_rule(struct vlib_main_t *vm, vlib_cli_parse_rule_t *c)
u8 ** vlib_cli_get_possible_completions(u8 *input_str)
Definition: cli.c:237
uword * command_index_by_path
Definition: cli.h:141
u32 command_index
Definition: cli.h:68
unsigned int u32
Definition: types.h:88
struct vlib_cli_main_t vlib_cli_main_t
vlib_cli_sub_rule_t * sub_rules
Definition: cli.h:124
struct _unformat_input_t unformat_input_t
clib_error_t *() vlib_cli_command_function_t(struct vlib_main_t *vm, unformat_input_t *input, struct vlib_cli_command_t *cmd)
Definition: cli.h:88
uword() unformat_function_t(unformat_input_t *input, va_list *args)
Definition: format.h:232
char * long_help
Definition: cli.h:75
int cJSON_bool fmt
Definition: cJSON.h:160
uword function_arg
Definition: cli.h:105
vlib_cli_sub_command_t * sub_commands
Definition: cli.h:111
void(** perf_counter_cbs_tmp)(struct vlib_cli_main_t *, u32 id, int before_or_after)
Definition: cli.h:154
svmdb_client_t * c
sll srl srl sll sra u16x4 i
Definition: vector_sse42.h:317
clib_error_t * vlib_cli_register(struct vlib_main_t *vm, vlib_cli_command_t *c)
Definition: cli.c:1336
char * buffer
Definition: cJSON.h:163
uword ** bitmaps
Definition: cli.h:52
uword unformat_vlib_cli_sub_input(unformat_input_t *i, va_list *args)
Definition: cli.c:163
u32 hit_counter
Definition: cli.h:130
char * long_help
Definition: cli.h:99
uword is_mp_safe
Definition: cli.h:108
char * path
Definition: cli.h:95
uword * sub_command_index_by_name
Definition: cli.h:114
int vlib_cli_input(struct vlib_main_t *vm, unformat_input_t *input, vlib_cli_output_function_t *function, uword function_arg)
Definition: cli.c:656
void vlib_cli_output(struct vlib_main_t *vm, char *fmt,...)
Definition: cli.c:696
struct vlib_cli_command_t * next_cli_command
Definition: cli.h:127
u64 uword
Definition: types.h:112
vlib_cli_command_t * cli_command_registrations
Definition: cli.h:144
struct vlib_cli_command_t vlib_cli_command_t
char * short_help
Definition: cli.h:74
vlib_cli_parse_position_t * sub_command_positions
Definition: cli.h:118
void() vlib_cli_output_function_t(uword arg, u8 *buffer, uword buffer_bytes)
Definition: cli.h:133
u32 * sort_vector
Definition: cli.h:147
char * short_help
Definition: cli.h:98
u32 rule_index
Definition: cli.h:66