main.cc

/*
 * Copyright (C) 2016-2020, 2022-2024 Kernkonzept GmbH.
 * Author(s): Jean Wolter <jean.wolter@kernkonzept.com>
 *            Manuel von Oltersdorff-Kalettka <manuel.kalettka@kernkonzept.com>
 *
 * License: see LICENSE.spdx (in this directory or the directories above)
 */
#include <l4/re/util/meta>
#include <l4/re/util/object_registry>
#include <l4/re/util/br_manager>
 
#include <l4/sys/factory>
#include <l4/sys/task>
 
#include <l4/sys/cxx/ipc_epiface>
#include <l4/sys/cxx/ipc_varg>
#include <l4/cxx/string>
 
#include <vector>
#include <string>
#include <terminate_handler-l4>
 
#include "debug.h"
#include "options.h"
#include "switch.h"
#include "vlan.h"
 
/*
 * Registry for our server, used to register
 * - factory capability
 * - irq object for capability deletion irqs
 * - virtio host kick irqs
 */
static L4Re::Util::Registry_server<L4Re::Util::Br_manager_hooks> server;
 
using Ds_vector = std::vector<L4::Cap<L4Re::Dataspace>>;
static std::shared_ptr<Ds_vector> trusted_dataspaces;
 
static bool
parse_int_param(L4::Ipc::Varg const &param, char const *prefix, int *out)
{
  l4_size_t headlen = strlen(prefix);
 
  if (param.length() < headlen)
    return false;
 
  char const *pstr = param.value<char const *>();
 
  if (strncmp(pstr, prefix, headlen) != 0)
    return false;
 
  std::string tail(pstr + headlen, param.length() - headlen);
 
  if (!parse_int_optstring(tail.c_str(), out))
    {
      Err(Err::Normal).printf("Bad paramter '%s'. Invalid number specified.\n",
                              prefix);
      throw L4::Runtime_error(-L4_EINVAL);
    }
 
  return true;
}
 
class Switch_factory : public L4::Epiface_t<Switch_factory, L4::Factory>
{
  class Port : public Virtio_port
  {
    // Irq used to notify the guest
    L4::Cap<L4::Irq> _device_notify_irq;
 
    L4::Cap<L4::Irq> device_notify_irq() const override
    { return _device_notify_irq; }
 
  public:
    Port(unsigned vq_max, unsigned num_ds, char const *name,
         l4_uint8_t const *mac)
    : Virtio_port(vq_max, num_ds, name, mac) {}
 
    void register_end_points(L4Re::Util::Object_registry* registry,
                             L4::Epiface *kick_irq)
    {
      // register virtio host kick irq
      _device_notify_irq = L4Re::chkcap(registry->register_irq_obj(kick_irq));
 
      // register virtio endpoint
      L4Re::chkcap(registry->register_obj(this));
 
      // decrement ref counter to get a notification when the last
      // external reference vanishes
      obj_cap()->dec_refcnt(1);
    }
 
    virtual ~Port()
    { server.registry()->unregister_obj(this); }
  };
 
  class Switch_port : public Port
  {
    class Kick_irq : public L4::Irqep_t<Kick_irq>
    {
      Virtio_switch *_switch; 
      Virtio_port *_port;     
    public:
      void handle_irq()
      { _switch->handle_port_irq(_port); }
 
      Kick_irq(Virtio_switch *virtio_switch, Virtio_port *port)
      : _switch{virtio_switch}, _port{port} {}
    };
 
    Kick_irq _kick_irq; 
  public:
    Switch_port(L4Re::Util::Object_registry *registry,
                Virtio_switch *virtio_switch, unsigned vq_max, unsigned num_ds,
                char const *name, l4_uint8_t const *mac)
    : Port(vq_max, num_ds, name, mac),
      _kick_irq(virtio_switch, this)
    { register_end_points(registry, &_kick_irq); }
 
    virtual ~Switch_port()
    {
      // We need to delete the IRQ object created in register_irq_obj() ourselves
      L4::Cap<L4::Task>(L4Re::This_task)
        ->unmap(_kick_irq.obj_cap().fpage(),
                L4_FP_ALL_SPACES | L4_FP_DELETE_OBJ);
      server.registry()->unregister_obj(&_kick_irq);
    }
  };
 
  class Monitor_port : public Port
  {
    class Kick_irq : public L4::Irqep_t<Kick_irq>
    {
      Virtio_port *_port;
 
    public:
      void handle_irq()
      {
        do
          {
            _port->tx_q()->disable_notify();
            _port->rx_q()->disable_notify();
 
            _port->drop_requests();
 
            _port->tx_q()->enable_notify();
            _port->rx_q()->enable_notify();
 
            L4virtio::wmb();
            L4virtio::rmb();
        }
        while (_port->tx_work_pending());
      }
 
      Kick_irq(Virtio_port *port) : _port{port} {}
    };
 
    Kick_irq _kick_irq;
 
  public:
    Monitor_port(L4Re::Util::Object_registry* registry,
                 unsigned vq_max, unsigned num_ds, char const *name,
                 l4_uint8_t const *mac)
    : Port(vq_max, num_ds, name, mac), _kick_irq(this)
    { register_end_points(registry, &_kick_irq); }
 
    virtual ~Monitor_port()
    {
      // We need to delete the IRQ object created in register_irq_obj() ourselves
      L4::Cap<L4::Task>(L4Re::This_task)
        ->unmap(_kick_irq.obj_cap().fpage(),
                L4_FP_ALL_SPACES | L4_FP_DELETE_OBJ);
      server.registry()->unregister_obj(&_kick_irq);
    }
  };
 
  /*
   * Handle vanishing caps by telling the switch that a port might have gone
   */
  struct Del_cap_irq : public L4::Irqep_t<Del_cap_irq>
  {
  public:
    void handle_irq()
    { _switch->check_ports(); }
 
    Del_cap_irq(Virtio_switch *virtio_switch) : _switch{virtio_switch} {}
 
  private:
    Virtio_switch *_switch;
  };
 
  Virtio_switch *_virtio_switch; 
  unsigned _vq_max_num;
  Del_cap_irq _del_cap_irq;
 
  bool handle_opt_arg(L4::Ipc::Varg const &opt, bool &monitor,
                      char *name, size_t size,
                      l4_uint16_t &vlan_access,
                      std::vector<l4_uint16_t> &vlan_trunk,
                      l4_uint8_t mac[6], bool &mac_set)
  {
    assert(opt.is_of<char const *>());
    unsigned len = opt.length();
    const char *opt_str = opt.data();
    Err err(Err::Normal);
 
 
    if (len > 5)
      {
        if (!strncmp("type=", opt_str, 5))
          {
            if (!strncmp("type=monitor", opt_str, len))
              {
                monitor = true;
                return true;
              }
            else if (!strncmp("type=none", opt_str, len))
              return true;
 
            err.printf("Unknown type '%.*s'\n", opt.length() - 5, opt.data() + 5);
            return false;
          }
        else if (!strncmp("name=", opt_str, 5))
          {
            snprintf(name, size, "%.*s", opt.length() - 5, opt.data() + 5);
            return true;
          }
        else if (!strncmp("vlan=", opt_str, 5))
          {
            cxx::String str(opt_str + 5, strnlen(opt_str + 5, len - 5));
            cxx::String::Index idx;
 
            if ((idx = str.starts_with("access=")))
              {
                str = str.substr(idx);
                l4_uint16_t vid;
                int next = str.from_dec(&vid);
                if (next && next == str.len() && vlan_valid_id(vid))
                  vlan_access = vid;
                else
                  {
                    err.printf("Invalid VLAN access port id '%.*s'\n",
                               opt.length(), opt.data());
                    return false;
                  }
              }
            else if ((idx = str.starts_with("trunk=")))
              {
                int next;
                l4_uint16_t vid;
                str = str.substr(idx);
                while ((next = str.from_dec(&vid)))
                  {
                    if (!vlan_valid_id(vid))
                      break;
                    vlan_trunk.push_back(vid);
                    if (next < str.len() && str[next] != ',')
                      break;
                    str = str.substr(next+1);
                  }
 
                if (!str.empty())
                  {
                    err.printf("Invalid VLAN trunk port spec '%.*s'\n",
                               opt.length(), opt.data());
                    return false;
                  }
              }
            else
              {
                err.printf("Invalid VLAN specification..\n");
                return false;
              }
 
            return true;
          }
        else if (!strncmp("mac=", opt_str, 4))
          {
            size_t const OPT_LEN = 4 /* mac= */ + 6*2 /* digits */ + 5 /* : */;
            // expect NUL terminated string for simplicity
            if (len > OPT_LEN && opt_str[OPT_LEN] == '\0' &&
                sscanf(opt_str+4, "%hhx:%hhx:%hhx:%hhx:%hhx:%hhx", &mac[0],
                       &mac[1], &mac[2], &mac[3], &mac[4], &mac[5]) == 6)
              {
                mac_set = true;
                return true;
              }
 
            err.printf("Invalid mac address '%.*s'\n", len - 4, opt_str + 4);
            return false;
          }
      }
 
    err.printf("Unknown option '%.*s'\n", opt.length(), opt.data());
    return false;
  }
 
public:
  Switch_factory(Virtio_switch *virtio_switch, unsigned vq_max_num)
  : _virtio_switch{virtio_switch}, _vq_max_num{vq_max_num},
    _del_cap_irq{virtio_switch}
  {
    auto c = L4Re::chkcap(server.registry()->register_irq_obj(&_del_cap_irq));
    L4Re::chksys(L4Re::Env::env()->main_thread()->register_del_irq(c));
  };
 
  long op_create(L4::Factory::Rights, L4::Ipc::Cap<void> &res,
                 l4_umword_t type, L4::Ipc::Varg_list_ref va)
  {
    Dbg warn(Dbg::Port, Dbg::Warn, "Port");
    Dbg info(Dbg::Port, Dbg::Info, "Port");
 
    info.printf("Incoming port request\n");
 
    // test for supported object types
    if (type != 0)
      {
        warn.printf("Invalid object type\n");
        return -L4_EINVAL;
      }
 
    bool monitor = false;
    char name[20] = "";
    unsigned arg_n = 2;
    l4_uint16_t vlan_access = 0;
    std::vector<l4_uint16_t> vlan_trunk;
 
    // Default MAC address. Might be overridden by a "mac=..." option.
    // First octet: 0x02
    // * bit 0: Individual/Group address bit
    // * bit 1: Universally/Locally Administered address bit
    // Last two octets are filled with port number.
    l4_uint8_t mac[6] = { 0x02, 0x08, 0x0f, 0x2a, 0x00, 0x00 };
    bool mac_set = false;
    int num_ds = 2;
 
    for (L4::Ipc::Varg opt: va)
      {
        if (!opt.is_of<char const *>())
          {
            warn.printf("Unexpected type for argument %d\n", arg_n);
            return -L4_EINVAL;
          }
 
        if (parse_int_param(opt, "ds-max=", &num_ds))
          {
            if (num_ds <= 0 || num_ds > 80)
              {
                Err(Err::Normal).printf("warning: client requested invalid number"
                                        " of data spaces: 0 < %d <= 80\n", num_ds);
                return -L4_EINVAL;
              }
          }
        else if (!handle_opt_arg(opt, monitor, name, sizeof(name), vlan_access,
                                 vlan_trunk, mac, mac_set))
          return -L4_EINVAL;
 
        ++arg_n;
      }
 
    int port_num = _virtio_switch->port_available(monitor);
    if (port_num < 0)
      {
        warn.printf("No port available\n");
        return -L4_ENOMEM;
      }
 
    if (vlan_access && !vlan_trunk.empty())
      {
        warn.printf("Port cannot be access and trunk VLAN port simultaneously.\n");
        return -L4_EINVAL;
      }
 
    if (name[0])
      {
        // append port number
        unsigned len = strlen(name);
        snprintf(name + len, sizeof(name) - len, "[%d]", port_num);
      }
    else
      snprintf(name, sizeof(name), "%s[%d]", monitor ? "monitor" : "",
               port_num);
 
    info.printf("    Creating port %s%s\n", name,
                monitor ? " as monitor port" : "");
 
    if (!mac_set)
      {
        // assign a dedicated MAC address to the monitor interface
        // assuming we will never have more than 57000 (0xdea8) normal
        // ports
        if (monitor)
          {
            mac[4] = 0xde;
            mac[5] = 0xad;
          }
        else
          {
            mac[4] = (l4_uint8_t)(port_num >> 8);
            mac[5] = (l4_uint8_t)port_num;
          }
      }
    l4_uint8_t *mac_ptr = (mac_set || Options::get_options()->assign_mac())
                          ? mac : nullptr;
 
    // create port
    Port *port;
    if (monitor)
      {
        port = new Monitor_port(server.registry(), _vq_max_num, num_ds, name,
                                mac_ptr);
        port->set_monitor();
 
        if (vlan_access)
          warn.printf("vlan=access=<id> ignored on monitor ports!\n");
        if (!vlan_trunk.empty())
          warn.printf("vlan=trunk=... ignored on monitor ports!\n");
      }
    else
      {
        port = new Switch_port(server.registry(), _virtio_switch, _vq_max_num,
                               num_ds, name, mac_ptr);
 
        if (vlan_access)
          port->set_vlan_access(vlan_access);
        else if (!vlan_trunk.empty())
          port->set_vlan_trunk(vlan_trunk);
      }
 
    port->add_trusted_dataspaces(trusted_dataspaces);
    if (!trusted_dataspaces->empty())
      port->enable_trusted_ds_validation();
 
    // hand port over to the switch
    bool added = monitor ? _virtio_switch->add_monitor_port(port)
                         : _virtio_switch->add_port(port);
    if (!added)
      {
        delete port;
        return -L4_ENOMEM;
      }
    res = L4::Ipc::make_cap(port->obj_cap(), L4_CAP_FPAGE_RWSD);
 
    info.printf("    Created port %s\n", name);
    return L4_EOK;
  };
  long op_create(L4::Factory::Rights, L4::Ipc::Cap<void> &res, {…}
};
class Switch_factory : public L4::Epiface_t<Switch_factory, L4::Factory> {…};
 
 
int main(int argc, char *argv[])
{
  trusted_dataspaces = std::make_shared<Ds_vector>();
  auto *opts = Options::parse_options(argc, argv, trusted_dataspaces);
  if (!opts)
    {
      Err().printf("Error during command line parsing.\n");
      return 1;
    }
 
  // Show welcome message if debug level is not set to quiet
  if (Dbg(Dbg::Core, Dbg::Warn).is_active())
    printf("Hello from l4virtio switch\n");
 
  Virtio_switch *virtio_switch = new Virtio_switch(opts->get_max_ports());
  Switch_factory *factory = new Switch_factory(virtio_switch,
                                               opts->get_virtq_max_num());
  L4::Cap<void> cap = server.registry()->register_obj(factory, "svr");
  if (!cap.is_valid())
    {
      Err().printf("error registering switch\n");
      return 2;
    }
 
  /*
   * server loop will handle 4 types of events
   * - Switch_factory
   *   - factory protocol
   *   - capability deletion
   *     - delegated to  Virtio_switch::check_ports()
   * - Switch_factory::Switch_port
   *   - irqs triggered by clients
   *     - delegated to Virtio_switch::handle_port_irq()
   * - Virtio_net_transfer
   *   - timeouts for pending transfer requests added by
   *     Virtio_port::handle_request() via registered via
   *     L4::Epiface::server_iface()->add_timeout()
   */
  server.loop();
  return 0;
}