2 * mactime.c - time-based src mac address filtration
4 * Copyright (c) 2018 Cisco and/or its affiliates.
5 * Licensed under the Apache License, Version 2.0 (the "License");
6 * you may not use this file except in compliance with the License.
7 * You may obtain a copy of the License at:
9 * http://www.apache.org/licenses/LICENSE-2.0
11 * Unless required by applicable law or agreed to in writing, software
12 * distributed under the License is distributed on an "AS IS" BASIS,
13 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14 * See the License for the specific language governing permissions and
15 * limitations under the License.
18 #include <vnet/vnet.h>
19 #include <vnet/plugin/plugin.h>
20 #include <mactime/mactime.h>
22 #include <vlibapi/api.h>
23 #include <vlibmemory/api.h>
24 #include <vpp/app/version.h>
26 /* define message IDs */
27 #include <mactime/mactime_msg_enum.h>
29 /* define message structures */
31 #include <mactime/mactime_all_api_h.h>
34 /* define generated endian-swappers */
36 #include <mactime/mactime_all_api_h.h>
39 /* instantiate all the print functions we know about */
40 #define vl_print(handle, ...) vlib_cli_output (handle, __VA_ARGS__)
42 #include <mactime/mactime_all_api_h.h>
45 /* Get the API version number */
46 #define vl_api_version(n,v) static u32 api_version=(v);
47 #include <mactime/mactime_all_api_h.h>
50 #define REPLY_MSG_ID_BASE mm->msg_id_base
51 #include <vlibapi/api_helper_macros.h>
53 mactime_main_t mactime_main;
55 /** \file time-base src-mac filter device-input feature arc implementation
58 /* List of message types that this plugin understands */
60 #define foreach_mactime_plugin_api_msg \
61 _(MACTIME_ENABLE_DISABLE, mactime_enable_disable) \
62 _(MACTIME_ADD_DEL_RANGE, mactime_add_del_range)
65 feature_init (mactime_main_t * mm)
67 if (mm->feature_initialized == 0)
69 /* Create the lookup table */
70 clib_bihash_init_8_8 (&mm->lookup_table, "mactime lookup table",
71 mm->lookup_table_num_buckets,
72 mm->lookup_table_memory_size);
73 clib_timebase_init (&mm->timebase, mm->timezone_offset,
74 CLIB_TIMEBASE_DAYLIGHT_USA);
75 mm->allow_counters.name = "allow";
76 mm->allow_counters.stat_segment_name = "/mactime/allow";
77 mm->drop_counters.name = "drop";
78 mm->drop_counters.stat_segment_name = "/mactime/drop";
79 mm->feature_initialized = 1;
83 /** Action function shared between message handler and debug CLI
86 mactime_enable_disable (mactime_main_t * mm, u32 sw_if_index,
89 vnet_sw_interface_t *sw;
95 if (pool_is_free_index (mm->vnet_main->interface_main.sw_interfaces,
97 return VNET_API_ERROR_INVALID_SW_IF_INDEX;
99 /* Not a physical port? */
100 sw = vnet_get_sw_interface (mm->vnet_main, sw_if_index);
101 if (sw->type != VNET_SW_INTERFACE_TYPE_HARDWARE)
102 return VNET_API_ERROR_INVALID_SW_IF_INDEX;
104 vnet_feature_enable_disable ("device-input", "mactime",
105 sw_if_index, enable_disable, 0, 0);
106 vnet_feature_enable_disable ("interface-output", "mactime-tx",
107 sw_if_index, enable_disable, 0, 0);
111 static clib_error_t *
112 mactime_enable_disable_command_fn (vlib_main_t * vm,
113 unformat_input_t * input,
114 vlib_cli_command_t * cmd)
116 mactime_main_t *mm = &mactime_main;
117 u32 sw_if_index = ~0;
118 int enable_disable = 1;
122 while (unformat_check_input (input) != UNFORMAT_END_OF_INPUT)
124 if (unformat (input, "disable"))
126 else if (unformat (input, "%U", unformat_vnet_sw_interface,
127 mm->vnet_main, &sw_if_index))
129 else if (unformat (input, "sw_if_index %d", &sw_if_index))
135 if (sw_if_index == ~0)
136 return clib_error_return (0, "Please specify an interface...");
138 rv = mactime_enable_disable (mm, sw_if_index, enable_disable);
145 case VNET_API_ERROR_INVALID_SW_IF_INDEX:
146 return clib_error_return
147 (0, "Invalid interface, only works on physical ports");
151 return clib_error_return (0, "mactime_enable_disable returned %d", rv);
157 VLIB_CLI_COMMAND (mactime_enable_disable_command, static) =
159 .path = "mactime enable-disable",
161 "mactime enable-disable <interface-name> [disable]",
162 .function = mactime_enable_disable_command_fn,
167 /** Enable / disable time-base src mac filtration on an interface
170 static void vl_api_mactime_enable_disable_t_handler
171 (vl_api_mactime_enable_disable_t * mp)
173 vl_api_mactime_enable_disable_reply_t *rmp;
174 mactime_main_t *mm = &mactime_main;
177 VALIDATE_SW_IF_INDEX (mp);
179 rv = mactime_enable_disable (mm, ntohl (mp->sw_if_index),
180 (int) (mp->enable_disable));
181 BAD_SW_IF_INDEX_LABEL;
182 REPLY_MACRO (VL_API_MACTIME_ENABLE_DISABLE_REPLY);
185 /** Create a lookup table entry for the indicated mac address
188 mactime_send_create_entry_message (u8 * mac_address)
190 mactime_main_t *mm = &mactime_main;
192 vl_shmem_hdr_t *shmem_hdr;
194 vl_api_mactime_add_del_range_t *mp;
197 shmem_hdr = am->shmem_hdr;
198 mp = vl_msg_api_alloc_as_if_client (sizeof (*mp));
199 clib_memset (mp, 0, sizeof (*mp));
200 mp->_vl_msg_id = ntohs (VL_API_MACTIME_ADD_DEL_RANGE + mm->msg_id_base);
201 name = format (0, "mac-%U", format_mac_address, mac_address);
203 memcpy (mp->device_name, name, vec_len (name));
204 memcpy (mp->mac_address, mac_address, sizeof (mp->mac_address));
205 /* $$$ config: create allow / drop / range */
208 vl_msg_api_send_shmem (shmem_hdr->vl_input_queue, (u8 *) & mp);
211 /** Add or delete static / dynamic accept/drop configuration for a src mac
214 static void vl_api_mactime_add_del_range_t_handler
215 (vl_api_mactime_add_del_range_t * mp)
217 mactime_main_t *mm = &mactime_main;
218 vl_api_mactime_add_del_range_reply_t *rmp;
219 mactime_device_t *dp;
220 clib_bihash_kv_8_8_t kv;
222 clib_bihash_8_8_t *lut = &mm->lookup_table;
227 clib_memset (&kv, 0, sizeof (kv));
228 memcpy (&kv.key, mp->mac_address, sizeof (mp->mac_address));
230 /* See if we have a lookup table entry for this src mac address */
231 if (clib_bihash_search_8_8 (lut, &kv, &kv) < 0)
237 /* Create the device entry? */
240 pool_get (mm->devices, dp);
241 clib_memset (dp, 0, sizeof (*dp));
242 vlib_validate_combined_counter (&mm->allow_counters,
244 vlib_zero_combined_counter (&mm->allow_counters, dp - mm->devices);
245 vlib_validate_combined_counter (&mm->drop_counters,
247 vlib_zero_combined_counter (&mm->drop_counters, dp - mm->devices);
248 mp->device_name[ARRAY_LEN (mp->device_name) - 1] = 0;
249 dp->device_name = format (0, "%s%c", mp->device_name, 0);
250 memcpy (dp->mac_address, mp->mac_address, sizeof (mp->mac_address));
251 for (i = 0; i < clib_net_to_host_u32 (mp->count); i++)
253 clib_timebase_range_t _r, *r = &_r;
254 r->start = mp->ranges[i].start;
255 r->end = mp->ranges[i].end;
256 vec_add1 (dp->ranges, r[0]);
258 /* If we found some time ranges */
261 /* Set allow/drop based on msg flags */
263 dp->flags = MACTIME_DEVICE_FLAG_DYNAMIC_DROP;
265 dp->flags = MACTIME_DEVICE_FLAG_DYNAMIC_ALLOW;
269 /* no ranges, it's a static allow/drop */
271 dp->flags = MACTIME_DEVICE_FLAG_STATIC_DROP;
273 dp->flags = MACTIME_DEVICE_FLAG_STATIC_ALLOW;
276 /* Add the hash table entry */
277 kv.value = dp - mm->devices;
278 clib_bihash_add_del_8_8 (lut, &kv, 1 /* is_add */ );
280 else /* add more ranges */
282 dp = pool_elt_at_index (mm->devices, kv.value);
283 for (i = 0; i < clib_net_to_host_u32 (mp->count); i++)
285 clib_timebase_range_t _r, *r = &_r;
286 r->start = mp->ranges[i].start;
287 r->end = mp->ranges[i].end;
288 vec_add1 (dp->ranges, r[0]);
292 else /* delete case */
296 rv = VNET_API_ERROR_NO_SUCH_ENTRY;
300 /* find the device entry */
301 dp = pool_elt_at_index (mm->devices, kv.value);
303 /* Remove it from the lookup table */
304 clib_bihash_add_del_8_8 (lut, &kv, 0 /* is_add */ );
305 vec_free (dp->ranges);
306 pool_put (mm->devices, dp);
310 REPLY_MACRO (VL_API_MACTIME_ADD_DEL_RANGE_REPLY);
313 /* Set up the API message handling tables */
314 static clib_error_t *
315 mactime_plugin_api_hookup (vlib_main_t * vm)
317 mactime_main_t *mm = &mactime_main;
319 vl_msg_api_set_handlers((VL_API_##N + mm->msg_id_base), \
321 vl_api_##n##_t_handler, \
323 vl_api_##n##_t_endian, \
324 vl_api_##n##_t_print, \
325 sizeof(vl_api_##n##_t), 1);
326 foreach_mactime_plugin_api_msg;
332 #define vl_msg_name_crc_list
333 #include <mactime/mactime_all_api_h.h>
334 #undef vl_msg_name_crc_list
337 setup_message_id_table (mactime_main_t * mm, api_main_t * am)
339 #define _(id,n,crc) vl_msg_api_add_msg_name_crc (am, #n "_" #crc, id + mm->msg_id_base);
340 foreach_vl_msg_name_crc_mactime;
344 static clib_error_t *
345 mactime_init (vlib_main_t * vm)
347 mactime_main_t *mm = &mactime_main;
348 clib_error_t *error = 0;
352 mm->vnet_main = vnet_get_main ();
354 name = format (0, "mactime_%08x%c", api_version, 0);
356 /* Ask for a correctly-sized block of API message decode slots */
357 mm->msg_id_base = vl_msg_api_get_msg_ids
358 ((char *) name, VL_MSG_FIRST_AVAILABLE);
360 error = mactime_plugin_api_hookup (vm);
362 /* Add our API messages to the global name_crc hash table */
363 setup_message_id_table (mm, &api_main);
367 mm->lookup_table_num_buckets = MACTIME_NUM_BUCKETS;
368 mm->lookup_table_memory_size = MACTIME_MEMORY_SIZE;
369 mm->timezone_offset = -5; /* US EST / EDT */
373 VLIB_INIT_FUNCTION (mactime_init);
375 static clib_error_t *
376 mactime_config (vlib_main_t * vm, unformat_input_t * input)
378 mactime_main_t *mm = &mactime_main;
380 while (unformat_check_input (input) != UNFORMAT_END_OF_INPUT)
382 if (unformat (input, "lookup-table-buckets %u",
383 &mm->lookup_table_num_buckets))
385 else if (unformat (input, "lookup-table-memory %U",
386 unformat_memory_size, &mm->lookup_table_memory_size))
388 else if (unformat (input, "timezone_offset %d", &mm->timezone_offset))
392 return clib_error_return (0, "unknown input '%U'",
393 format_unformat_error, input);
399 VLIB_CONFIG_FUNCTION (mactime_config, "mactime");
402 VNET_FEATURE_INIT (mactime, static) =
404 .arc_name = "device-input",
405 .node_name = "mactime",
406 .runs_before = VNET_FEATURES ("ethernet-input"),
411 VNET_FEATURE_INIT (mactime_tx, static) =
413 .arc_name = "interface-output",
414 .node_name = "mactime-tx",
415 .runs_before = VNET_FEATURES ("interface-tx"),
420 VLIB_PLUGIN_REGISTER () =
422 .version = VPP_BUILD_VER,
423 .description = "Time-based MAC Source Address Filter",
427 static clib_error_t *
428 show_mactime_command_fn (vlib_main_t * vm,
429 unformat_input_t * input, vlib_cli_command_t * cmd)
431 mactime_main_t *mm = &mactime_main;
432 mactime_device_t *dp;
435 u32 *pool_indices = 0;
437 int current_status = 99;
440 vlib_counter_t allow, drop;
441 ethernet_arp_ip4_entry_t *n, *pool;
443 vec_reset_length (mm->arp_cache_copy);
444 pool = ip4_neighbors_pool ();
447 pool_foreach (n, pool,
449 vec_add1 (mm->arp_cache_copy, n[0]);
453 now = clib_timebase_now (&mm->timebase);
455 if (PREDICT_FALSE ((now - mm->sunday_midnight) > 86400.0 * 7.0))
456 mm->sunday_midnight = clib_timebase_find_sunday_midnight (now);
458 if (unformat (input, "verbose %d", &verbose))
461 if (unformat (input, "verbose"))
465 vlib_cli_output (vm, "Time now: %U", format_clib_timebase_time, now);
468 pool_foreach (dp, mm->devices,
470 vec_add1 (pool_indices, dp - mm->devices);
474 vlib_cli_output (vm, "%-15s %18s %14s %10s %10s %10s",
475 "Device Name", "Addresses", "Status",
476 "AllowPkt", "AllowByte", "DropPkt");
478 for (i = 0; i < vec_len (pool_indices); i++)
480 dp = pool_elt_at_index (mm->devices, pool_indices[i]);
482 /* Check dynamic ranges */
483 for (j = 0; j < vec_len (dp->ranges); j++)
485 clib_timebase_range_t *r = dp->ranges + j;
488 start0 = r->start + mm->sunday_midnight;
489 end0 = r->end + mm->sunday_midnight;
491 vlib_cli_output (vm, " Range %d: %U - %U", j,
492 format_clib_timebase_time, start0,
493 format_clib_timebase_time, end0);
495 if (now >= start0 && now <= end0)
497 if (dp->flags & MACTIME_DEVICE_FLAG_DYNAMIC_ALLOW)
503 vlib_cli_output (vm, " Time in range %d:", j);
504 vlib_cli_output (vm, " %U - %U",
505 format_clib_timebase_time, start0,
506 format_clib_timebase_time, end0);
512 vlib_cli_output (vm, " No range match.");
513 if (dp->flags & MACTIME_DEVICE_FLAG_STATIC_DROP)
515 if (dp->flags & MACTIME_DEVICE_FLAG_STATIC_ALLOW)
517 if (dp->flags & MACTIME_DEVICE_FLAG_DYNAMIC_ALLOW)
519 if (dp->flags & MACTIME_DEVICE_FLAG_DYNAMIC_DROP)
523 vec_reset_length (macstring);
524 macstring = format (0, "%U", format_mac_address, dp->mac_address);
525 switch (current_status)
528 status_string = "static drop";
531 status_string = "static allow";
534 status_string = "dynamic drop";
537 status_string = "dynamic allow";
540 status_string = "code bug!";
543 vlib_get_combined_counter (&mm->allow_counters, dp - mm->devices,
545 vlib_get_combined_counter (&mm->drop_counters, dp - mm->devices, &drop);
546 vlib_cli_output (vm, "%-15s %18s %14s %10lld %10lld %10lld",
547 dp->device_name, macstring, status_string,
548 allow.packets, allow.bytes, drop.packets);
549 /* This is really only good for small N... */
550 for (j = 0; j < vec_len (mm->arp_cache_copy); j++)
552 n = mm->arp_cache_copy + j;
553 if (!memcmp (dp->mac_address, n->mac.bytes, sizeof (n->mac)))
555 vlib_cli_output (vm, "%17s%U", " ", format_ip4_address,
560 vec_free (macstring);
561 vec_free (pool_indices);
567 VLIB_CLI_COMMAND (show_mactime_command, static) =
569 .path = "show mactime",
570 .short_help = "show mactime [verbose]",
571 .function = show_mactime_command_fn,
575 static clib_error_t *
576 clear_mactime_command_fn (vlib_main_t * vm,
577 unformat_input_t * input, vlib_cli_command_t * cmd)
579 mactime_main_t *mm = &mactime_main;
581 if (mm->feature_initialized == 0)
582 return clib_error_return (0, "feature not enabled");
584 vlib_clear_combined_counters (&mm->allow_counters);
585 vlib_clear_combined_counters (&mm->drop_counters);
586 vlib_cli_output (vm, "Mactime counters cleared...");
591 VLIB_CLI_COMMAND (clear_mactime_command, static) =
593 .path = "clear mactime",
594 .short_help = "clear mactime counters",
595 .function = clear_mactime_command_fn,
602 * fd.io coding-style-patch-verification: ON
605 * eval: (c-set-style "gnu")