1 ;;; plugin-test-skel.el - vpp-api-test plug-in skeleton
3 ;;; Copyright (c) 2016 Cisco and/or its affiliates.
4 ;;; Licensed under the Apache License, Version 2.0 (the "License");
5 ;;; you may not use this file except in compliance with the License.
6 ;;; You may obtain a copy of the License at:
8 ;;; http://www.apache.org/licenses/LICENSE-2.0
10 ;;; Unless required by applicable law or agreed to in writing, software
11 ;;; distributed under the License is distributed on an "AS IS" BASIS,
12 ;;; WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 ;;; See the License for the specific language governing permissions and
14 ;;; limitations under the License.
18 (define-skeleton skel-plugin-test
19 "Insert a plug-in vpp-api-test skeleton "
21 '(if (not (boundp 'plugin-name))
22 (setq plugin-name (read-string "Plugin name: ")))
23 '(setq PLUGIN-NAME (upcase plugin-name))
26 * " plugin-name ".c - skeleton vpp-api-test plug-in
28 * Copyright (c) <current-year> <your-organization>
29 * Licensed under the Apache License, Version 2.0 (the \"License\");
30 * you may not use this file except in compliance with the License.
31 * You may obtain a copy of the License at:
33 * http://www.apache.org/licenses/LICENSE-2.0
35 * Unless required by applicable law or agreed to in writing, software
36 * distributed under the License is distributed on an \"AS IS\" BASIS,
37 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
38 * See the License for the specific language governing permissions and
39 * limitations under the License.
42 #include <vlibapi/api.h>
43 #include <vlibmemory/api.h>
44 #include <vlibsocket/api.h>
45 #include <vppinfra/error.h>
47 uword unformat_sw_if_index (unformat_input_t * input, va_list * args);
49 /* Declare message IDs */
50 #include <" plugin-name "/" plugin-name "_msg_enum.h>
52 /* define message structures */
54 #include <" plugin-name "/" plugin-name "_all_api_h.h>
57 /* declare message handlers for each api */
59 #define vl_endianfun /* define message structures */
60 #include <" plugin-name "/" plugin-name "_all_api_h.h>
63 /* instantiate all the print functions we know about */
64 #define vl_print(handle, ...)
66 #include <" plugin-name "/" plugin-name "_all_api_h.h>
69 /* Get the API version number. */
70 #define vl_api_version(n,v) static u32 api_version=(v);
71 #include <" plugin-name "/" plugin-name "_all_api_h.h>
76 /* API message ID base */
79 } " plugin-name "_test_main_t;
81 " plugin-name "_test_main_t " plugin-name "_test_main;
83 #define foreach_standard_reply_retval_handler \\
84 _(" plugin-name "_enable_disable_reply)
87 static void vl_api_##n##_t_handler \\
88 (vl_api_##n##_t * mp) \\
90 vat_main_t * vam = " plugin-name "_test_main.vat_main; \\
91 i32 retval = ntohl(mp->retval); \\
92 if (vam->async_mode) { \\
93 vam->async_errors += (retval < 0); \\
95 vam->retval = retval; \\
96 vam->result_ready = 1; \\
99 foreach_standard_reply_retval_handler;
103 * Table of message reply handlers, must include boilerplate handlers
106 #define foreach_vpe_api_reply_msg \\
107 _(" PLUGIN-NAME "_ENABLE_DISABLE_REPLY, " plugin-name "_enable_disable_reply)
110 /* M: construct, but don't yet send a message */
114 vam->result_ready = 0; \\
115 mp = vl_msg_api_alloc(sizeof(*mp)); \\
116 memset (mp, 0, sizeof (*mp)); \\
117 mp->_vl_msg_id = ntohs (VL_API_##T + sm->msg_id_base); \\
118 mp->client_index = vam->my_client_index; \\
121 #define M2(T, mp, n) \\
123 vam->result_ready = 0; \\
124 mp = vl_msg_api_alloc(sizeof(*mp)+(n)); \\
125 memset (mp, 0, sizeof (*mp)); \\
126 mp->_vl_msg_id = ntohs (VL_API_##T + sm->msg_id_base); \\
127 mp->client_index = vam->my_client_index; \\
130 /* S: send a message */
131 #define S(mp) (vl_msg_api_send_shmem (vam->vl_input_queue, (u8 *)&mp))
133 /* W: wait for results, with timeout */
136 f64 timeout = vat_time_now (vam) + 1.0; \\
138 while (vat_time_now (vam) < timeout) { \\
139 if (vam->result_ready == 1) { \\
140 return (vam->retval); \\
146 static int api_" plugin-name "_enable_disable (vat_main_t * vam)
148 " plugin-name "_test_main_t * sm = &" plugin-name "_test_main;
149 unformat_input_t * i = vam->input;
150 int enable_disable = 1;
151 u32 sw_if_index = ~0;
152 vl_api_" plugin-name "_enable_disable_t * mp;
155 /* Parse args required to build the message */
156 while (unformat_check_input (i) != UNFORMAT_END_OF_INPUT) {
157 if (unformat (i, \"%U\", unformat_sw_if_index, vam, &sw_if_index))
159 else if (unformat (i, \"sw_if_index %d\", &sw_if_index))
161 else if (unformat (i, \"disable\"))
167 if (sw_if_index == ~0) {
168 errmsg (\"missing interface name / explicit sw_if_index number \\n\");
172 /* Construct the API message */
173 M(" PLUGIN-NAME "_ENABLE_DISABLE, mp);
174 mp->sw_if_index = ntohl (sw_if_index);
175 mp->enable_disable = enable_disable;
180 /* Wait for a reply... */
186 * List of messages that the api test plugin sends,
187 * and that the data plane plugin processes
189 #define foreach_vpe_api_msg \\
190 _(" plugin-name "_enable_disable, \"<intfc> [disable]\")
192 void vat_api_hookup (vat_main_t *vam)
194 " plugin-name "_test_main_t * sm = &" plugin-name "_test_main;
195 /* Hook up handlers for replies from the data plane plug-in */
197 vl_msg_api_set_handlers((VL_API_##N + sm->msg_id_base), \\
199 vl_api_##n##_t_handler, \\
201 vl_api_##n##_t_endian, \\
202 vl_api_##n##_t_print, \\
203 sizeof(vl_api_##n##_t), 1);
204 foreach_vpe_api_reply_msg;
207 /* API messages we can send */
208 #define _(n,h) hash_set_mem (vam->function_by_name, #n, api_##n);
213 #define _(n,h) hash_set_mem (vam->help_by_name, #n, h);
218 clib_error_t * vat_plugin_register (vat_main_t *vam)
220 " plugin-name "_test_main_t * sm = &" plugin-name "_test_main;
225 /* Ask the vpp engine for the first assigned message-id */
226 name = format (0, \"" plugin-name "_%08x%c\", api_version, 0);
227 sm->msg_id_base = vl_client_get_first_plugin_msg_id ((char *) name);
229 if (sm->msg_id_base != (u16) ~0)
230 vat_api_hookup (vam);