2 * Copyright (c) 2020 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:
7 * http://www.apache.org/licenses/LICENSE-2.0
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.
22 #include <vlib/vlib.h>
23 #include <vlibapi/api_types.h>
24 #include <vppinfra/hash.h>
25 #include <vppinfra/cJSON.h>
27 /* VPP API client includes */
28 #include <vpp-api/client/vppapiclient.h>
34 * Filter these messages as they are used to manage the API connection to VPP
36 char *filter_messages_strings[] = { "memclnt_create",
40 "memclnt_rx_thread_suspend",
41 "memclnt_read_timeout",
43 "trace_plugin_msg_ids",
47 filter_message (char *msgname)
49 char **p = filter_messages_strings;
53 if (strcmp (*p, msgname) == 0)
60 uword *function_by_name;
63 char *vat2_plugin_path;
65 vat2_find_plugin_path ()
67 char *p, path[PATH_MAX];
71 /* find executable path */
72 if ((rv = readlink ("/proc/self/exe", path, PATH_MAX - 1)) == -1)
75 /* readlink doesn't provide null termination */
79 if ((p = strrchr (path, '/')) == 0)
84 if ((p = strrchr (path, '/')) == 0)
88 s = format (0, "%s/lib/" CLIB_TARGET_TRIPLET "/vat2_plugins:"
89 "%s/lib/vat2_plugins", path, path);
91 vat2_plugin_path = (char *) s;
95 vac_callback (unsigned char *data, int len)
97 u16 result_msg_id = ntohs(*((u16 *)data));
98 DBG("Received something async: %d\n", result_msg_id);
101 int vat2_load_plugins (char *path, char *filter, int *loaded);
104 register_function (void)
108 vat2_find_plugin_path();
109 DBG("Plugin Path %s\n", vat2_plugin_path);
110 int rv = vat2_load_plugins(vat2_plugin_path, 0, &loaded);
111 DBG("Loaded %u plugins\n", loaded);
117 cJSON (*f) (cJSON *);
118 cJSON (*tojson) (void *);
122 struct apifuncs_s *apifuncs = 0;
125 vat2_register_function (char *name, cJSON (*f) (cJSON *),
126 cJSON (*tojson) (void *), u32 crc)
128 struct apifuncs_s funcs = { .f = f, .tojson = tojson, .crc = crc };
129 vec_add1 (apifuncs, funcs);
130 hash_set_mem (function_by_name, name, vec_len (apifuncs) - 1);
134 vat2_exec_command_by_name (char *msgname, cJSON *o)
137 if (filter_message (msgname))
140 cJSON *crc_obj = cJSON_GetObjectItem (o, "_crc");
143 char *crc_str = cJSON_GetStringValue (crc_obj);
144 crc = (u32) strtol (crc_str, NULL, 16);
147 uword *p = hash_get_mem (function_by_name, msgname);
150 fprintf (stderr, "No such command %s\n", msgname);
153 if (crc && crc != apifuncs[p[0]].crc)
155 fprintf (stderr, "API CRC does not match: %s!\n", msgname);
158 cJSON *(*fp) (cJSON *);
159 fp = (void *) apifuncs[p[0]].f;
160 cJSON *r = (*fp) (o);
164 char *output = cJSON_Print (r);
166 printf ("%s\n", output);
171 fprintf (stderr, "Call failed: %s\n", msgname);
178 vat2_exec_command (cJSON *o)
181 cJSON *msg_id_obj = cJSON_GetObjectItem (o, "_msgname");
184 fprintf (stderr, "Missing '_msgname' element!\n");
188 char *name = cJSON_GetStringValue (msg_id_obj);
190 return vat2_exec_command_by_name (name, o);
194 print_template (char *msgname)
196 uword *p = hash_get_mem (function_by_name, msgname);
200 cJSON *(*fp) (void *);
201 fp = (void *) apifuncs[p[0]].tojson;
205 void *scratch = malloc (2048);
209 memset (scratch, 0, 2048);
210 cJSON *t = fp (scratch);
214 char *output = cJSON_Print (t);
219 printf ("%s\n", output);
225 fprintf (stderr, "error printing template for: %s\n", msgname);
233 hash_foreach_mem (name, i, function_by_name, ({ printf ("%s\n", name); }));
240 "Usage: vat2 [OPTION] <message-name> <JSON object>\n"
241 "Send API message to VPP and print reply\n"
243 "-d, --debug Print additional information\n"
244 "-p, --prefix Specify shared memory prefix to connect to a given VPP "
246 "-f, --file File containing a JSON object with the arguments for "
247 "the message to send\n"
248 "--dump-apis List all APIs available in VAT2 (might not reflect "
250 "-t, --template Print a template JSON object for given API message\n"
252 printf ("%s", help_string);
255 int main (int argc, char **argv)
257 /* Create a heap of 64MB */
258 clib_mem_init (0, 64 << 20);
259 char *filename = 0, *prefix = 0;
264 int option_index = 0;
265 bool dump_api = false;
266 bool template = false;
268 static int debug_flag;
269 static struct option long_options[] = {
270 { "debug", no_argument, &debug_flag, 1 },
271 { "prefix", optional_argument, 0, 'p' },
272 { "file", required_argument, 0, 'f' },
273 { "dump-apis", no_argument, 0, 0 },
274 { "template", no_argument, 0, 't' },
278 while ((c = getopt_long (argc, argv, "hdp:f:", long_options,
279 &option_index)) != -1)
284 if (option_index == 3)
306 debug = debug_flag == 1 ? true : false;
307 DBG ("debug = %d, filename = %s shared memory prefix: %s\n", debug, filename,
310 for (index = optind; index < argc; index++)
311 DBG ("Non-option argument %s\n", argv[index]);
315 if (argc > index + 2)
317 fprintf (stderr, "%s: Too many arguments\n", argv[0]);
322 function_by_name = hash_create_string (0, sizeof (uword));
323 int res = register_function();
325 fprintf(stderr, "%s: loading plugins failed\n", argv[0]);
331 print_template (argv[index]);
341 /* Read message arguments from command line */
342 if (argc >= (index + 1))
344 msgname = argv[index];
346 if (argc == (index + 2)) {
347 o = cJSON_Parse(argv[index+1]);
349 fprintf(stderr, "%s: Failed parsing JSON input: %s\n", argv[0], cJSON_GetErrorPtr());
354 if (!msgname && !filename)
360 /* Read message from file */
364 fprintf (stderr, "%s: Superfluous arguments when filename given\n",
369 FILE *f = fopen(filename, "r");
370 size_t chunksize, bufsize;
375 fprintf(stderr, "%s: can't open file: %s\n", argv[0], filename);
379 chunksize = bufsize = 1024;
380 char *buf = malloc(bufsize);
381 while ((n = fread (buf + n_read, 1, chunksize, f)))
386 bufsize += chunksize;
387 buf = realloc (buf, bufsize);
392 o = cJSON_Parse(buf);
394 fprintf(stderr, "%s: Failed parsing JSON input: %s\n", argv[0], cJSON_GetErrorPtr());
403 fprintf (stderr, "%s: Failed parsing JSON input\n", argv[0]);
407 if (vac_connect ("vat2", prefix, 0, 1024))
409 fprintf (stderr, "Failed connecting to VPP\n");
415 vat2_exec_command_by_name (msgname, o);
419 if (cJSON_IsArray (o))
421 size_t size = cJSON_GetArraySize (o);
422 for (int i = 0; i < size; i++)
423 vat2_exec_command (cJSON_GetArrayItem (o, i));