feat: boostrap hicn 22.02

The current patch provides several new features, improvements,
bug fixes and also complete rewrite of entire components.

- lib
The hicn packet parser has been improved with a new packet
format fully based on UDP. The TCP header is still temporarily
supported but the UDP header will replace completely the new hicn
packet format. Improvements have been made to make sure every
packet parsing operation is made via this library. The current
new header can be used as header between the payload and the
UDP header or as trailer in the UDP surplus area to be tested
when UDP options will start to be used.

- hicn-light
The portable packet forwarder has been completely rewritten from
scratch with the twofold objective to improve performance and
code size but  also to drop dependencies such as libparc which is
now removed by the current implementation.

- hicn control
the control library is the agent that is used to program the
packet forwarders via their binary API. This component has
benefited from significant improvements in terms of interaction
model which is now event driven and more robust to failures.

- VPP plugin has been updated to support VPP 22.02

- transport
Major improvement have been made to the RTC protocol, to the
support of IO modules and to the security sub system. Signed
manifests are the default data authenticity and integrity framework.
Confidentiality can be enabled by sharing the encryption key to the
prod/cons layer. The library has been tested with group key based
applications such as broadcast/multicast and real-time on-line
meetings with trusted server keys or MLS.

- testing
Unit testing has been introduced using GoogleTest. One third of
the code base is covered by unit testing with priority on
critical features. Functional testing has also been introduce
using Docker, linux bridging and Robot Framework to define
test with Less Code techniques to facilitate the extension
of the coverage.

Co-authored-by: Mauro Sardara <msardara@cisco.com>
Co-authored-by: Jordan Augé <jordan.auge+fdio@cisco.com>
Co-authored-by: Michele Papalini <micpapal@cisco.com>
Co-authored-by: Angelo Mantellini <manangel@cisco.com>
Co-authored-by: Jacques Samain <jsamain@cisco.com>
Co-authored-by: Olivier Roques <oroques+fdio@cisco.com>
Co-authored-by: Enrico Loparco <eloparco@cisco.com>
Co-authored-by: Giulio Grassi <gigrassi@cisco.com>

Change-Id: I75d0ef70f86d921e3ef503c99271216ff583c215
Signed-off-by: Luca Muscariello <muscariello@ieee.org>
Signed-off-by: Mauro Sardara <msardara@cisco.com>

1 files changed, 0 insertions, 450 deletions

diff --git a/hicn-light/src/hicn/config/controlAddConnection.c b/hicn-light/src/hicn/config/controlAddConnection.c
deleted file mode 100644
index eed37f3ad..000000000
--- a/hicn-light/src/hicn/config/controlAddConnection.c
+++ /dev/null
@@ -1,450 +0,0 @@
-/*
- * Copyright (c) 2017-2019 Cisco and/or its affiliates.
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at:
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-#include <hicn/hicn-light/config.h>
-
-#include <ctype.h>
-#include <parc/assert/parc_Assert.h>
-#include <stdbool.h>
-#include <stdint.h>
-#include <stdio.h>
-#include <stdlib.h>
-
-#include <parc/algol/parc_Memory.h>
-#include <parc/algol/parc_Network.h>
-
-#include <hicn/config/controlAddConnection.h>
-
-#include <hicn/utils/commands.h>
-#include <hicn/utils/utils.h>
-
-// ===================================================
-
-static void _controlAddConnection_Init(CommandParser *parser, CommandOps *ops);
-static CommandReturn _controlAddConnection_HelpExecute(CommandParser *parser,
-                                                       CommandOps *ops,
-                                                       PARCList *args,
-                                                       char *output,
-                                                       size_t output_size);
-static CommandReturn _controlAddConnection_Execute(CommandParser *parser,
-                                                   CommandOps *ops,
-                                                   PARCList *args,
-                                                   char *output,
-                                                   size_t output_size);
-
-// ===================================================
-
-#ifdef __linux__
-static CommandReturn _controlAddConnection_HicnHelpExecute(CommandParser *parser,
-                                                           CommandOps *ops,
-                                                           PARCList *args,
-                                                           char *output,
-                                                           size_t output_size);
-static CommandReturn _controlAddConnection_HicnExecute(CommandParser *parser,
-                                                       CommandOps *ops,
-                                                       PARCList *args,
-                                                       char *output,
-                                                       size_t output_size);
-#endif
-
-static CommandReturn _controlAddConnection_UdpHelpExecute(CommandParser *parser,
-                                                          CommandOps *ops,
-                                                          PARCList *args,
-                                                          char *output,
-                                                          size_t output_size);
-static CommandReturn _controlAddConnection_UdpExecute(CommandParser *parser,
-                                                      CommandOps *ops,
-                                                      PARCList *args,
-                                                      char *output,
-                                                      size_t output_size);
-
-static CommandReturn _controlAddConnection_TcpHelpExecute(CommandParser *parser,
-                                                          CommandOps *ops,
-                                                          PARCList *args,
-                                                          char *output,
-                                                          size_t output_size);
-static CommandReturn _controlAddConnection_TcpExecute(CommandParser *parser,
-                                                      CommandOps *ops,
-                                                      PARCList *args,
-                                                      char *output,
-                                                      size_t output_size);
-
-// ===================================================
-
-static const char *_commandAddConnection = "add connection";
-#ifdef __linux__
-static const char *_commandAddConnectionHicn = "add connection hicn";
-#endif
-static const char *_commandAddConnectionUdp = "add connection udp";
-static const char *_commandAddConnectionTcp = "add connection tcp";
-static const char *_commandAddConnectionHelp = "help add connection";
-#ifdef __linux__
-static const char *_commandAddConnectionHicnHelp = "help add connection hicn";
-#endif
-static const char *_commandAddConnectionUdpHelp = "help add connection udp";
-static const char *_commandAddConnectionTcpHelp = "help add connection tcp";
-
-// ===================================================
-
-CommandOps *controlAddConnection_Create(ControlState *state) {
-  return commandOps_Create(state, _commandAddConnection,
-                           _controlAddConnection_Init,
-                           _controlAddConnection_Execute, commandOps_Destroy);
-}
-
-CommandOps *controlAddConnection_HelpCreate(ControlState *state) {
-  return commandOps_Create(state, _commandAddConnectionHelp, NULL,
-                           _controlAddConnection_HelpExecute,
-                           commandOps_Destroy);
-}
-
-// ===================================================
-
-#ifdef __linux__
-static CommandOps *_controlAddConnection_HicnCreate(ControlState *state) {
-  return commandOps_Create(state, _commandAddConnectionHicn, NULL,
-                           _controlAddConnection_HicnExecute,
-                           commandOps_Destroy);
-}
-#endif
-
-static CommandOps *_controlAddConnection_UdpCreate(ControlState *state) {
-  return commandOps_Create(state, _commandAddConnectionUdp, NULL,
-                           _controlAddConnection_UdpExecute,
-                           commandOps_Destroy);
-}
-
-static CommandOps *_controlAddConnection_TcpCreate(ControlState *state) {
-  return commandOps_Create(state, _commandAddConnectionTcp, NULL,
-                           _controlAddConnection_TcpExecute,
-                           commandOps_Destroy);
-}
-
-// ===================================================
-#ifdef __linux__
-static CommandOps *_controlAddConnection_HicnHelpCreate(ControlState *state) {
-  return commandOps_Create(state, _commandAddConnectionHicnHelp, NULL,
-                           _controlAddConnection_HicnHelpExecute,
-                           commandOps_Destroy);
-}
-#endif
-
-static CommandOps *_controlAddConnection_UdpHelpCreate(ControlState *state) {
-  return commandOps_Create(state, _commandAddConnectionUdpHelp, NULL,
-                           _controlAddConnection_UdpHelpExecute,
-                           commandOps_Destroy);
-}
-
-static CommandOps *_controlAddConnection_TcpHelpCreate(ControlState *state) {
-  return commandOps_Create(state, _commandAddConnectionTcpHelp, NULL,
-                           _controlAddConnection_TcpHelpExecute,
-                           commandOps_Destroy);
-}
-
-// ===================================================
-
-static CommandReturn _controlAddConnection_HelpExecute(CommandParser *parser,
-                                                       CommandOps *ops,
-                                                       PARCList *args,
-                                                       char *output,
-                                                       size_t output_size) {
-#ifdef __linux__
-  snprintf(output, output_size, "Available commands:\n   %s\n   %s\n   %s\n\n",
-                                  _commandAddConnectionHicn,
-                                  _commandAddConnectionUdp,
-                                  _commandAddConnectionTcp);
-#else
-  snprintf(output, output_size, "Available commands:\n   %s\n   %s\n\n",
-                                  _commandAddConnectionUdp,
-                                  _commandAddConnectionTcp);
-#endif
-  return CommandReturn_Success;
-}
-
-static void _controlAddConnection_Init(CommandParser *parser, CommandOps *ops) {
-  ControlState *state = ops->closure;
-#ifdef __linux__
-  controlState_RegisterCommand(state,
-                               _controlAddConnection_HicnHelpCreate(state));
-#endif
-  controlState_RegisterCommand(state,
-                               _controlAddConnection_UdpHelpCreate(state));
-  controlState_RegisterCommand(state,
-                               _controlAddConnection_TcpHelpCreate(state));
-#ifdef __linux__
-  controlState_RegisterCommand(state, _controlAddConnection_HicnCreate(state));
-#endif
-  controlState_RegisterCommand(state, _controlAddConnection_UdpCreate(state));
-  controlState_RegisterCommand(state, _controlAddConnection_TcpCreate(state));
-}
-
-static CommandReturn _controlAddConnection_Execute(CommandParser *parser,
-                                                   CommandOps *ops,
-                                                   PARCList *args,
-                                                   char *output,
-                                                   size_t output_size) {
-  return _controlAddConnection_HelpExecute(parser, ops, args, output, output_size);
-}
-
-// ===================================================
-// functions general to all connection types
-
-/**
- * Create a tunnel in the forwarder based on the addresses
- *
- * Caller retains ownership of memory.
- * The symbolic name will be used to refer to this connection. It must be unqiue
- * otherwise the forwarder will reject this commend.
- *
- * @param [in] parser An allocated CommandParser
- * @param [in] ops Allocated CommandOps (needed to extract ControlState)
- * @param [in] localAddress the local IP and port.  The port may be the wildcard
- * value.
- * @param [in] remoteAddress The remote IP and port (both must be specified)
- * @param [in] tunnelType The tunneling protocol
- * @param [in] symbolic The symbolic name for the connection (must be unique)
- * @param [in] output Output buffer
- * @param [in] output_size Output buffer size
- *
- * @return <#value#> <#explanation#>
- *
- * Example:
- * @code
- * {
- *      struct sockaddr_in *anyAddress = parcNetwork_SockInet4AddressAny();
- *      struct sockaddr_in *remote     =
- * parcNetwork_SockInet4Address("192.168.1.2", 9695);
- *
- *      Address *localAddress = addressCreateFromInet(anyAddress);
- *      Address *remoteAddress = addressCreateFromInet(remote);
- *
- *      control_CreateTunnel(state, localAddress, remoteAddress, IPTUN_TCP,
- * "conn7");
- *
- *      addressDestroy(&localAddress);
- *      addressDestroy(&remoteAddress);
- *      parcMemory_Deallocate((void **)&remote);
- *      parcMemory_Deallocate((void **)&anyAddress);
- * }
- * @endcode
- */
-
-static CommandReturn _controlAddConnection_CreateTunnel(CommandParser *parser,
-                                                        CommandOps *ops, const char *local_ip,
-                                                        const char *local_port,
-                                                        const char *remote_ip,
-                                                        const char *remote_port,
-                                                        connection_type tunnelType,
-                                                        const char *symbolic,
-                                                        char *output,
-                                                        size_t output_size) {
-  ControlState *state = ops->closure;
-  // a request like this always has an interface index of 0 [FIELD REMOVED]
-  // unsigned int interfaceIndex = 0;
-
-  // allocate command payload
-  add_connection_command *addConnectionCommand =
-      parcMemory_AllocateAndClear(sizeof(add_connection_command));
-
-  // check and set IP addresses
-  if (inet_pton(AF_INET, remote_ip, &addConnectionCommand->remoteIp.v4.as_u32) ==
-          1 &&
-      inet_pton(AF_INET, local_ip, &addConnectionCommand->localIp.v4.as_u32) == 1) {
-    addConnectionCommand->ipType = ADDR_INET;
-
-  } else if (inet_pton(AF_INET6, remote_ip,
-                       &addConnectionCommand->remoteIp.v6.as_in6addr) == 1 &&
-             inet_pton(AF_INET6, local_ip,
-                       &addConnectionCommand->localIp.v6.as_in6addr) == 1) {
-    addConnectionCommand->ipType = ADDR_INET6;
-
-  } else {
-    snprintf(output, output_size, "Error: local address %s not same type as remote address %s\n",
-           local_ip, remote_ip);
-    parcMemory_Deallocate(&addConnectionCommand);
-    return CommandReturn_Failure;
-  }
-
-  // Fill remaining payload fields
-  addConnectionCommand->connectionType = tunnelType;
-  strcpy(addConnectionCommand->symbolic, symbolic);
-  addConnectionCommand->remotePort = htons((uint16_t)atoi(remote_port));
-  addConnectionCommand->localPort = htons((uint16_t)atoi(local_port));
-
-  // send message and receive response
-  struct iovec *response =
-      utils_SendRequest(state, ADD_CONNECTION, addConnectionCommand,
-                        sizeof(add_connection_command));
-
-  if (!response) {  // get NULL pointer
-    return CommandReturn_Failure;
-  }
-
-  parcMemory_Deallocate(&response);  // free iovec pointer
-  return CommandReturn_Success;
-}
-
-static CommandReturn _controlAddConnection_IpHelp(CommandParser *parser,
-                                                  CommandOps *ops,
-                                                  PARCList *args,
-                                                  const char *protocol,
-                                                  char *output,
-                                                  size_t output_size) {
-  snprintf(output, output_size,
-  #ifdef __linux__
-        "add connection hicn <symbolic> <remote_ip> <local_ip>\n"
-  #endif
-        "add connection udp <symbolic> <remote_ip> <port> <local_ip> <port>\n"
-        "  <symbolic>              : symbolic name, e.g. 'conn1' (must be "
-        "unique, start with alpha)\n"
-        "  <remote_ip>  : the IPv4 or IPv6 or hostname of the remote system\n"
-        "  <local_ip>              : optional local IP address to bind to\n"
-        "\n");
-  return CommandReturn_Success;
-}
-
-#ifdef __linux__
-static CommandReturn _controlAddConnection_HicnHelpExecute(CommandParser *parser,
-                                                          CommandOps *ops,
-                                                          PARCList *args,
-                                                          char *output,
-                                                          size_t output_size) {
-  _controlAddConnection_IpHelp(parser, ops, args, "hicn", output, output_size);
-
-  return CommandReturn_Success;
-}
-
-static CommandReturn _controlAddConnection_HicnExecute(CommandParser *parser,
-                                                       CommandOps *ops,
-                                                       PARCList *args,
-                                                       char *output,
-                                                       size_t output_size) {
-  static const int _indexSymbolic = 3;
-  static const int _indexRemAddr = 4;
-  static const int _indexLocAddr = 5;
-
-  if (parcList_Size(args) != 6) {
-    _controlAddConnection_HicnHelpExecute(parser, ops, args, output, output_size);
-    return CommandReturn_Failure;
-  }
-
-  char *symbolic = parcList_GetAtIndex(args, _indexSymbolic);
-
-  if (!utils_ValidateSymbolicName(symbolic)) {
-    snprintf(output, output_size, "Invalid symbolic name.  Must begin with alpha and contain only "
-        "alphanum.\n");
-    return CommandReturn_Failure;
-  }
-
-  char *remote_ip = parcList_GetAtIndex(args, _indexRemAddr);
-  char *local_ip = parcList_GetAtIndex(args, _indexLocAddr);
-  char *port = "1234";  // this is a random port number that will be ignored
-
-  return _controlAddConnection_CreateTunnel(
-      parser, ops, local_ip, port, remote_ip, port, HICN_CONN, symbolic, output, output_size);
-}
-#endif
-
-static CommandReturn _controlAddConnection_UdpHelpExecute(CommandParser *parser,
-                                                          CommandOps *ops,
-                                                          PARCList *args,
-                                                          char *output,
-                                                          size_t output_size) {
-  _controlAddConnection_IpHelp(parser, ops, args, "udp", output, output_size);
-
-  return CommandReturn_Success;
-}
-
-static CommandReturn _controlAddConnection_UdpExecute(CommandParser *parser,
-                                                      CommandOps *ops,
-                                                      PARCList *args,
-                                                      char *output,
-                                                      size_t output_size) {
-  static const int _indexSymbolic = 3;
-  static const int _indexRemAddr = 4;
-  static const int _indexRemPort = 5;
-  static const int _indexLocAddr = 6;
-  static const int _indexLocPort = 7;
-
-  if (parcList_Size(args) != 8) {
-    _controlAddConnection_UdpHelpExecute(parser, ops, args, output, output_size);
-    return CommandReturn_Failure;
-  }
-
-  char *symbolic = parcList_GetAtIndex(args, _indexSymbolic);
-  size_t offset = 0;
-  if (!utils_ValidateSymbolicName(symbolic)) {
-    snprintf(output, output_size,
-        "Invalid symbolic name.  Must begin with alpha and contain only "
-        "alphanum.\n");
-    return CommandReturn_Failure;
-  }
-
-  char *remote_ip = parcList_GetAtIndex(args, _indexRemAddr);
-  char *local_ip = parcList_GetAtIndex(args, _indexLocAddr);
-
-  char *remote_port = parcList_GetAtIndex(args, _indexRemPort);
-  char *local_port = parcList_GetAtIndex(args, _indexLocPort);
-
-  return _controlAddConnection_CreateTunnel(parser, ops, local_ip, local_port,
-                                            remote_ip, remote_port, UDP_CONN,
-                                            symbolic,
-                                            output + offset, output_size - offset);
-}
-
-static CommandReturn _controlAddConnection_TcpHelpExecute(CommandParser *parser,
-                                                          CommandOps *ops,
-                                                          PARCList *args,
-                                                          char *output,
-                                                          size_t output_size) {
-  _controlAddConnection_IpHelp(parser, ops, args, "tcp", output, output_size);
-
-  return CommandReturn_Success;
-}
-
-static CommandReturn _controlAddConnection_TcpExecute(CommandParser *parser,
-                                                      CommandOps *ops,
-                                                      PARCList *args,
-                                                      char *output,
-                                                      size_t output_size) {
-  static const int _indexSymbolic = 3;
-  static const int _indexRemAddr = 4;
-  static const int _indexRemPort = 5;
-  static const int _indexLocAddr = 6;
-  static const int _indexLocPort = 7;
-
-  if (parcList_Size(args) != 8) {
-    _controlAddConnection_UdpHelpExecute(parser, ops, args, output, output_size);
-    return CommandReturn_Failure;
-  }
-
-  char *symbolic = parcList_GetAtIndex(args, _indexSymbolic);
-  if (!utils_ValidateSymbolicName(symbolic)) {
-    snprintf(output, output_size, "Invalid symbolic name.  Must begin with alpha and contain only "
-        "alphanum.\n");
-    return CommandReturn_Failure;
-  }
-
-  char *remote_ip = parcList_GetAtIndex(args, _indexRemAddr);
-  char *local_ip = parcList_GetAtIndex(args, _indexLocAddr);
-
-  char *remote_port = parcList_GetAtIndex(args, _indexRemPort);
-  char *local_port = parcList_GetAtIndex(args, _indexLocPort);
-
-  return _controlAddConnection_CreateTunnel(parser, ops, local_ip, local_port,
-                                            remote_ip, remote_port, TCP_CONN,
-                                            symbolic,
-                                            output, output_size);
-}