src/plugins/dpdk/device/init.c

   1 /*
   2  * Copyright (c) 2015 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:
   6  *
   7  *     http://www.apache.org/licenses/LICENSE-2.0
   8  *
   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.
  14  */
  15 #include <vnet/vnet.h>
  16 #include <vppinfra/vec.h>
  17 #include <vppinfra/error.h>
  18 #include <vppinfra/format.h>
  19 #include <vppinfra/bitmap.h>
  20 #include <vppinfra/linux/sysfs.h>
  21 #include <vlib/unix/unix.h>
  22 #include <vlib/log.h>
  23
  24 #include <vnet/ethernet/ethernet.h>
  25 #include <dpdk/buffer.h>
  26 #include <dpdk/device/dpdk.h>
  27 #include <dpdk/cryptodev/cryptodev.h>
  28 #include <vlib/pci/pci.h>
  29 #include <vlib/vmbus/vmbus.h>
  30
  31 #include <rte_ring.h>
  32
  33 #include <stdio.h>
  34 #include <stdlib.h>
  35 #include <unistd.h>
  36 #include <sys/stat.h>
  37 #include <sys/mount.h>
  38 #include <string.h>
  39 #include <fcntl.h>
  40 #include <dirent.h>
  41
  42 #include <dpdk/device/dpdk_priv.h>
  43
  44 #define ETHER_MAX_LEN   1518  /**< Maximum frame len, including CRC. */
  45
  46 dpdk_main_t dpdk_main;
  47 dpdk_config_main_t dpdk_config_main;
  48
  49 #define LINK_STATE_ELOGS        0
  50
  51 /* Port configuration, mildly modified Intel app values */
  52
  53 static dpdk_port_type_t
  54 port_type_from_speed_capa (struct rte_eth_dev_info *dev_info)
  55 {
  56
  57   if (dev_info->speed_capa & ETH_LINK_SPEED_100G)
  58     return VNET_DPDK_PORT_TYPE_ETH_100G;
  59   else if (dev_info->speed_capa & ETH_LINK_SPEED_56G)
  60     return VNET_DPDK_PORT_TYPE_ETH_56G;
  61   else if (dev_info->speed_capa & ETH_LINK_SPEED_50G)
  62     return VNET_DPDK_PORT_TYPE_ETH_50G;
  63   else if (dev_info->speed_capa & ETH_LINK_SPEED_40G)
  64     return VNET_DPDK_PORT_TYPE_ETH_40G;
  65   else if (dev_info->speed_capa & ETH_LINK_SPEED_25G)
  66     return VNET_DPDK_PORT_TYPE_ETH_25G;
  67   else if (dev_info->speed_capa & ETH_LINK_SPEED_20G)
  68     return VNET_DPDK_PORT_TYPE_ETH_20G;
  69   else if (dev_info->speed_capa & ETH_LINK_SPEED_10G)
  70     return VNET_DPDK_PORT_TYPE_ETH_10G;
  71   else if (dev_info->speed_capa & ETH_LINK_SPEED_5G)
  72     return VNET_DPDK_PORT_TYPE_ETH_5G;
  73   else if (dev_info->speed_capa & ETH_LINK_SPEED_2_5G)
  74     return VNET_DPDK_PORT_TYPE_ETH_2_5G;
  75   else if (dev_info->speed_capa & ETH_LINK_SPEED_1G)
  76     return VNET_DPDK_PORT_TYPE_ETH_1G;
  77
  78   return VNET_DPDK_PORT_TYPE_UNKNOWN;
  79 }
  80
  81 static dpdk_port_type_t
  82 port_type_from_link_speed (u32 link_speed)
  83 {
  84   switch (link_speed)
  85     {
  86     case ETH_SPEED_NUM_1G:
  87       return VNET_DPDK_PORT_TYPE_ETH_1G;
  88     case ETH_SPEED_NUM_2_5G:
  89       return VNET_DPDK_PORT_TYPE_ETH_2_5G;
  90     case ETH_SPEED_NUM_5G:
  91       return VNET_DPDK_PORT_TYPE_ETH_5G;
  92     case ETH_SPEED_NUM_10G:
  93       return VNET_DPDK_PORT_TYPE_ETH_10G;
  94     case ETH_SPEED_NUM_20G:
  95       return VNET_DPDK_PORT_TYPE_ETH_20G;
  96     case ETH_SPEED_NUM_25G:
  97       return VNET_DPDK_PORT_TYPE_ETH_25G;
  98     case ETH_SPEED_NUM_40G:
  99       return VNET_DPDK_PORT_TYPE_ETH_40G;
 100     case ETH_SPEED_NUM_50G:
 101       return VNET_DPDK_PORT_TYPE_ETH_50G;
 102     case ETH_SPEED_NUM_56G:
 103       return VNET_DPDK_PORT_TYPE_ETH_56G;
 104     case ETH_SPEED_NUM_100G:
 105       return VNET_DPDK_PORT_TYPE_ETH_100G;
 106     default:
 107       return VNET_DPDK_PORT_TYPE_UNKNOWN;
 108     }
 109 }
 110
 111 static u32
 112 dpdk_flag_change (vnet_main_t * vnm, vnet_hw_interface_t * hi, u32 flags)
 113 {
 114   dpdk_main_t *dm = &dpdk_main;
 115   dpdk_device_t *xd = vec_elt_at_index (dm->devices, hi->dev_instance);
 116   u32 old = (xd->flags & DPDK_DEVICE_FLAG_PROMISC) != 0;
 117
 118   switch (flags)
 119     {
 120     case ETHERNET_INTERFACE_FLAG_DEFAULT_L3:
 121       /* set to L3/non-promisc mode */
 122       xd->flags &= ~DPDK_DEVICE_FLAG_PROMISC;
 123       break;
 124     case ETHERNET_INTERFACE_FLAG_ACCEPT_ALL:
 125       xd->flags |= DPDK_DEVICE_FLAG_PROMISC;
 126       break;
 127     case ETHERNET_INTERFACE_FLAG_MTU:
 128       xd->port_conf.rxmode.max_rx_pkt_len = hi->max_packet_bytes;
 129       dpdk_device_setup (xd);
 130       return 0;
 131     default:
 132       return ~0;
 133     }
 134
 135   if (xd->flags & DPDK_DEVICE_FLAG_ADMIN_UP)
 136     {
 137       if (xd->flags & DPDK_DEVICE_FLAG_PROMISC)
 138         rte_eth_promiscuous_enable (xd->port_id);
 139       else
 140         rte_eth_promiscuous_disable (xd->port_id);
 141     }
 142
 143   return old;
 144 }
 145
 146 static int
 147 dpdk_port_crc_strip_enabled (dpdk_device_t * xd)
 148 {
 149   return !(xd->port_conf.rxmode.offloads & DEV_RX_OFFLOAD_KEEP_CRC);
 150 }
 151
 152 /* The function check_l3cache helps check if Level 3 cache exists or not on current CPUs
 153   return value 1: exist.
 154   return value 0: not exist.
 155 */
 156 static int
 157 check_l3cache ()
 158 {
 159
 160   struct dirent *dp;
 161   clib_error_t *err;
 162   const char *sys_cache_dir = "/sys/devices/system/cpu/cpu0/cache";
 163   DIR *dir_cache = opendir (sys_cache_dir);
 164
 165   if (dir_cache == NULL)
 166     return -1;
 167
 168   while ((dp = readdir (dir_cache)) != NULL)
 169     {
 170       if (dp->d_type == DT_DIR)
 171         {
 172           u8 *p = NULL;
 173           int level_cache = -1;
 174
 175           p = format (p, "%s/%s/%s%c", sys_cache_dir, dp->d_name, "level", 0);
 176           if ((err = clib_sysfs_read ((char *) p, "%d", &level_cache)))
 177             clib_error_free (err);
 178
 179           if (level_cache == 3)
 180             {
 181               closedir (dir_cache);
 182               return 1;
 183             }
 184         }
 185     }
 186
 187   if (dir_cache != NULL)
 188     closedir (dir_cache);
 189
 190   return 0;
 191 }
 192
 193 static void
 194 dpdk_enable_l4_csum_offload (dpdk_device_t * xd)
 195 {
 196   xd->port_conf.txmode.offloads |= DEV_TX_OFFLOAD_TCP_CKSUM;
 197   xd->port_conf.txmode.offloads |= DEV_TX_OFFLOAD_UDP_CKSUM;
 198   xd->flags |= DPDK_DEVICE_FLAG_TX_OFFLOAD |
 199     DPDK_DEVICE_FLAG_INTEL_PHDR_CKSUM;
 200 }
 201
 202 static clib_error_t *
 203 dpdk_lib_init (dpdk_main_t * dm)
 204 {
 205   u32 nports;
 206   u32 mtu, max_rx_frame;
 207   int i;
 208   clib_error_t *error;
 209   vlib_main_t *vm = vlib_get_main ();
 210   vlib_thread_main_t *tm = vlib_get_thread_main ();
 211   vnet_device_main_t *vdm = &vnet_device_main;
 212   vnet_sw_interface_t *sw;
 213   vnet_hw_interface_t *hi;
 214   dpdk_device_t *xd;
 215   vlib_pci_addr_t last_pci_addr;
 216   u32 last_pci_addr_port = 0;
 217   u8 af_packet_instance_num = 0;
 218   last_pci_addr.as_u32 = ~0;
 219
 220   nports = rte_eth_dev_count_avail ();
 221
 222   if (nports < 1)
 223     {
 224       dpdk_log_notice ("DPDK drivers found no Ethernet devices...");
 225     }
 226
 227   if (CLIB_DEBUG > 0)
 228     dpdk_log_notice ("DPDK drivers found %d ports...", nports);
 229
 230   if (dm->conf->enable_tcp_udp_checksum)
 231     dm->buffer_flags_template &= ~(VNET_BUFFER_F_L4_CHECKSUM_CORRECT
 232                                    | VNET_BUFFER_F_L4_CHECKSUM_COMPUTED);
 233
 234   /* vlib_buffer_t template */
 235   vec_validate_aligned (dm->per_thread_data, tm->n_vlib_mains - 1,
 236                         CLIB_CACHE_LINE_BYTES);
 237   for (i = 0; i < tm->n_vlib_mains; i++)
 238     {
 239       dpdk_per_thread_data_t *ptd = vec_elt_at_index (dm->per_thread_data, i);
 240       clib_memset (&ptd->buffer_template, 0, sizeof (vlib_buffer_t));
 241       ptd->buffer_template.flags = dm->buffer_flags_template;
 242       vnet_buffer (&ptd->buffer_template)->sw_if_index[VLIB_TX] = (u32) ~ 0;
 243     }
 244
 245   /* *INDENT-OFF* */
 246   RTE_ETH_FOREACH_DEV(i)
 247     {
 248       u8 addr[6];
 249       int vlan_off;
 250       struct rte_eth_dev_info dev_info;
 251       struct rte_pci_device *pci_dev;
 252       dpdk_portid_t next_port_id;
 253       dpdk_device_config_t *devconf = 0;
 254       vlib_pci_addr_t pci_addr;
 255       uword *p = 0;
 256
 257       if (!rte_eth_dev_is_valid_port(i))
 258         continue;
 259
 260       rte_eth_dev_info_get (i, &dev_info);
 261
 262       if (dev_info.device == 0)
 263         {
 264           dpdk_log_notice ("DPDK bug: missing device info. Skipping %s device",
 265                         dev_info.driver_name);
 266           continue;
 267         }
 268
 269       pci_dev = dpdk_get_pci_device (&dev_info);
 270
 271       if (pci_dev)
 272         {
 273           pci_addr.domain = pci_dev->addr.domain;
 274           pci_addr.bus = pci_dev->addr.bus;
 275           pci_addr.slot = pci_dev->addr.devid;
 276           pci_addr.function = pci_dev->addr.function;
 277           p = hash_get (dm->conf->device_config_index_by_pci_addr,
 278                         pci_addr.as_u32);
 279         }
 280
 281
 282       /* Create vnet interface */
 283       vec_add2_aligned (dm->devices, xd, 1, CLIB_CACHE_LINE_BYTES);
 284       xd->nb_rx_desc = DPDK_NB_RX_DESC_DEFAULT;
 285       xd->nb_tx_desc = DPDK_NB_TX_DESC_DEFAULT;
 286       xd->cpu_socket = (i8) rte_eth_dev_socket_id (i);
 287
 288       if (p)
 289         {
 290           devconf = pool_elt_at_index (dm->conf->dev_confs, p[0]);
 291           xd->name = devconf->name;
 292         }
 293       else
 294         devconf = &dm->conf->default_devconf;
 295
 296       /* Handle representor devices that share the same PCI ID */
 297       if (dev_info.switch_info.domain_id != RTE_ETH_DEV_SWITCH_DOMAIN_ID_INVALID)
 298         {
 299           if (dev_info.switch_info.port_id != (uint16_t)-1)
 300             xd->interface_name_suffix = format (0, "%d", dev_info.switch_info.port_id);
 301         }
 302       /* Handle interface naming for devices with multiple ports sharing same PCI ID */
 303       else if (pci_dev &&
 304           ((next_port_id = rte_eth_find_next (i + 1)) != RTE_MAX_ETHPORTS))
 305         {
 306           struct rte_eth_dev_info di = { 0 };
 307           struct rte_pci_device *next_pci_dev;
 308           rte_eth_dev_info_get (next_port_id, &di);
 309           next_pci_dev = di.device ? RTE_DEV_TO_PCI (di.device) : 0;
 310           if (next_pci_dev &&
 311               pci_addr.as_u32 != last_pci_addr.as_u32 &&
 312               memcmp (&pci_dev->addr, &next_pci_dev->addr,
 313                       sizeof (struct rte_pci_addr)) == 0)
 314             {
 315               xd->interface_name_suffix = format (0, "0");
 316               last_pci_addr.as_u32 = pci_addr.as_u32;
 317               last_pci_addr_port = i;
 318             }
 319           else if (pci_addr.as_u32 == last_pci_addr.as_u32)
 320             {
 321               xd->interface_name_suffix =
 322                 format (0, "%u", i - last_pci_addr_port);
 323             }
 324           else
 325             {
 326               last_pci_addr.as_u32 = ~0;
 327             }
 328         }
 329       else
 330         last_pci_addr.as_u32 = ~0;
 331
 332       clib_memcpy (&xd->tx_conf, &dev_info.default_txconf,
 333                    sizeof (struct rte_eth_txconf));
 334
 335       if (dev_info.rx_offload_capa & DEV_RX_OFFLOAD_IPV4_CKSUM)
 336         {
 337           xd->port_conf.rxmode.offloads |= DEV_RX_OFFLOAD_IPV4_CKSUM;
 338           xd->flags |= DPDK_DEVICE_FLAG_RX_IP4_CKSUM;
 339         }
 340
 341       if (dm->conf->enable_tcp_udp_checksum)
 342         {
 343           if (dev_info.rx_offload_capa & DEV_RX_OFFLOAD_UDP_CKSUM)
 344             xd->port_conf.rxmode.offloads |= DEV_RX_OFFLOAD_UDP_CKSUM;
 345           if (dev_info.rx_offload_capa & DEV_RX_OFFLOAD_TCP_CKSUM)
 346             xd->port_conf.rxmode.offloads |= DEV_RX_OFFLOAD_TCP_CKSUM;
 347         }
 348
 349       if (dm->conf->no_multi_seg)
 350         {
 351           xd->port_conf.txmode.offloads &= ~DEV_TX_OFFLOAD_MULTI_SEGS;
 352           xd->port_conf.rxmode.offloads &= ~DEV_RX_OFFLOAD_JUMBO_FRAME;
 353           xd->port_conf.rxmode.offloads &= ~DEV_RX_OFFLOAD_SCATTER;
 354         }
 355       else
 356         {
 357           xd->port_conf.txmode.offloads |= DEV_TX_OFFLOAD_MULTI_SEGS;
 358           xd->port_conf.rxmode.offloads |= DEV_RX_OFFLOAD_JUMBO_FRAME;
 359           xd->port_conf.rxmode.offloads |= DEV_RX_OFFLOAD_SCATTER;
 360           xd->flags |= DPDK_DEVICE_FLAG_MAYBE_MULTISEG;
 361         }
 362
 363       xd->tx_q_used = clib_min (dev_info.max_tx_queues, tm->n_vlib_mains);
 364
 365       if (devconf->num_tx_queues > 0
 366           && devconf->num_tx_queues < xd->tx_q_used)
 367         xd->tx_q_used = clib_min (xd->tx_q_used, devconf->num_tx_queues);
 368
 369       if (devconf->num_rx_queues > 1
 370           && dev_info.max_rx_queues >= devconf->num_rx_queues)
 371         {
 372           xd->rx_q_used = devconf->num_rx_queues;
 373           xd->port_conf.rxmode.mq_mode = ETH_MQ_RX_RSS;
 374           if (devconf->rss_fn == 0)
 375             xd->port_conf.rx_adv_conf.rss_conf.rss_hf =
 376               ETH_RSS_IP | ETH_RSS_UDP | ETH_RSS_TCP;
 377           else
 378             {
 379               u64 unsupported_bits;
 380               xd->port_conf.rx_adv_conf.rss_conf.rss_hf = devconf->rss_fn;
 381               unsupported_bits = xd->port_conf.rx_adv_conf.rss_conf.rss_hf;
 382               unsupported_bits &= ~dev_info.flow_type_rss_offloads;
 383               if (unsupported_bits)
 384                 dpdk_log_warn ("Unsupported RSS hash functions: %U",
 385                                format_dpdk_rss_hf_name, unsupported_bits);
 386             }
 387           xd->port_conf.rx_adv_conf.rss_conf.rss_hf &=
 388             dev_info.flow_type_rss_offloads;
 389         }
 390       else
 391         xd->rx_q_used = 1;
 392
 393       xd->flags |= DPDK_DEVICE_FLAG_PMD;
 394
 395       /* workaround for drivers not setting driver_name */
 396       if ((!dev_info.driver_name) && (pci_dev))
 397         dev_info.driver_name = pci_dev->driver->driver.name;
 398
 399       ASSERT (dev_info.driver_name);
 400
 401       if (!xd->pmd)
 402         {
 403
 404
 405 #define _(s,f) else if (dev_info.driver_name &&                 \
 406                         !strcmp(dev_info.driver_name, s))       \
 407                  xd->pmd = VNET_DPDK_PMD_##f;
 408           if (0)
 409             ;
 410           foreach_dpdk_pmd
 411 #undef _
 412             else
 413             xd->pmd = VNET_DPDK_PMD_UNKNOWN;
 414
 415           xd->port_type = VNET_DPDK_PORT_TYPE_UNKNOWN;
 416           xd->nb_rx_desc = DPDK_NB_RX_DESC_DEFAULT;
 417           xd->nb_tx_desc = DPDK_NB_TX_DESC_DEFAULT;
 418
 419           switch (xd->pmd)
 420             {
 421               /* Drivers with valid speed_capa set */
 422             case VNET_DPDK_PMD_E1000EM:
 423             case VNET_DPDK_PMD_IGB:
 424             case VNET_DPDK_PMD_IXGBE:
 425             case VNET_DPDK_PMD_I40E:
 426             case VNET_DPDK_PMD_ICE:
 427               xd->port_type = port_type_from_speed_capa (&dev_info);
 428               xd->supported_flow_actions = VNET_FLOW_ACTION_MARK |
 429                 VNET_FLOW_ACTION_REDIRECT_TO_NODE |
 430                 VNET_FLOW_ACTION_REDIRECT_TO_QUEUE |
 431                 VNET_FLOW_ACTION_BUFFER_ADVANCE |
 432                 VNET_FLOW_ACTION_COUNT | VNET_FLOW_ACTION_DROP |
 433                 VNET_FLOW_ACTION_RSS;
 434
 435               if (dm->conf->no_tx_checksum_offload == 0)
 436                 {
 437                   xd->port_conf.txmode.offloads |= DEV_TX_OFFLOAD_TCP_CKSUM;
 438                   xd->port_conf.txmode.offloads |= DEV_TX_OFFLOAD_UDP_CKSUM;
 439                   xd->flags |=
 440                     DPDK_DEVICE_FLAG_TX_OFFLOAD |
 441                     DPDK_DEVICE_FLAG_INTEL_PHDR_CKSUM;
 442                 }
 443
 444
 445               break;
 446             case VNET_DPDK_PMD_CXGBE:
 447             case VNET_DPDK_PMD_MLX4:
 448             case VNET_DPDK_PMD_MLX5:
 449             case VNET_DPDK_PMD_QEDE:
 450             case VNET_DPDK_PMD_BNXT:
 451               xd->port_type = port_type_from_speed_capa (&dev_info);
 452               break;
 453
 454               /* SR-IOV VFs */
 455             case VNET_DPDK_PMD_IGBVF:
 456             case VNET_DPDK_PMD_IXGBEVF:
 457             case VNET_DPDK_PMD_I40EVF:
 458               xd->port_type = VNET_DPDK_PORT_TYPE_ETH_VF;
 459               if (dm->conf->no_tx_checksum_offload == 0)
 460                 {
 461                   xd->port_conf.txmode.offloads |= DEV_TX_OFFLOAD_TCP_CKSUM;
 462                   xd->port_conf.txmode.offloads |= DEV_TX_OFFLOAD_UDP_CKSUM;
 463                   xd->flags |=
 464                     DPDK_DEVICE_FLAG_TX_OFFLOAD |
 465                     DPDK_DEVICE_FLAG_INTEL_PHDR_CKSUM;
 466                 }
 467               break;
 468
 469               /* iAVF */
 470             case VNET_DPDK_PMD_IAVF:
 471         xd->port_type = VNET_DPDK_PORT_TYPE_ETH_VF;
 472               xd->supported_flow_actions = VNET_FLOW_ACTION_MARK |
 473                 VNET_FLOW_ACTION_REDIRECT_TO_NODE |
 474                 VNET_FLOW_ACTION_REDIRECT_TO_QUEUE |
 475                 VNET_FLOW_ACTION_BUFFER_ADVANCE |
 476                 VNET_FLOW_ACTION_COUNT | VNET_FLOW_ACTION_DROP;
 477
 478               if (dm->conf->no_tx_checksum_offload == 0)
 479                 {
 480                   xd->port_conf.txmode.offloads |= DEV_TX_OFFLOAD_TCP_CKSUM;
 481                   xd->port_conf.txmode.offloads |= DEV_TX_OFFLOAD_UDP_CKSUM;
 482                   xd->flags |=
 483                     DPDK_DEVICE_FLAG_TX_OFFLOAD |
 484                     DPDK_DEVICE_FLAG_INTEL_PHDR_CKSUM;
 485                 }
 486               break;
 487
 488             case VNET_DPDK_PMD_THUNDERX:
 489               xd->port_type = VNET_DPDK_PORT_TYPE_ETH_VF;
 490
 491               if (dm->conf->no_tx_checksum_offload == 0)
 492                 {
 493                   xd->port_conf.txmode.offloads |= DEV_TX_OFFLOAD_TCP_CKSUM;
 494                   xd->port_conf.txmode.offloads |= DEV_TX_OFFLOAD_UDP_CKSUM;
 495                   xd->flags |= DPDK_DEVICE_FLAG_TX_OFFLOAD;
 496                 }
 497               break;
 498
 499             case VNET_DPDK_PMD_ENA:
 500               xd->port_type = VNET_DPDK_PORT_TYPE_ETH_VF;
 501               xd->port_conf.rxmode.offloads &= ~DEV_RX_OFFLOAD_SCATTER;
 502               break;
 503
 504             case VNET_DPDK_PMD_DPAA2:
 505               xd->port_type = VNET_DPDK_PORT_TYPE_ETH_10G;
 506               break;
 507
 508               /* Cisco VIC */
 509             case VNET_DPDK_PMD_ENIC:
 510                 {
 511                   struct rte_eth_link l;
 512                   rte_eth_link_get_nowait (i, &l);
 513                   xd->port_type = port_type_from_link_speed (l.link_speed);
 514                   if (dm->conf->enable_tcp_udp_checksum)
 515                     dpdk_enable_l4_csum_offload (xd);
 516                 }
 517               break;
 518
 519               /* Intel Red Rock Canyon */
 520             case VNET_DPDK_PMD_FM10K:
 521               xd->port_type = VNET_DPDK_PORT_TYPE_ETH_SWITCH;
 522               break;
 523
 524               /* virtio */
 525             case VNET_DPDK_PMD_VIRTIO:
 526               xd->port_conf.rxmode.mq_mode = ETH_MQ_RX_NONE;
 527               xd->port_type = VNET_DPDK_PORT_TYPE_ETH_1G;
 528               xd->nb_rx_desc = DPDK_NB_RX_DESC_VIRTIO;
 529               xd->nb_tx_desc = DPDK_NB_TX_DESC_VIRTIO;
 530               break;
 531
 532               /* vmxnet3 */
 533             case VNET_DPDK_PMD_VMXNET3:
 534               xd->port_type = VNET_DPDK_PORT_TYPE_ETH_1G;
 535               xd->port_conf.txmode.offloads |= DEV_TX_OFFLOAD_MULTI_SEGS;
 536               break;
 537
 538             case VNET_DPDK_PMD_AF_PACKET:
 539               xd->port_type = VNET_DPDK_PORT_TYPE_AF_PACKET;
 540               xd->af_packet_instance_num = af_packet_instance_num++;
 541               break;
 542
 543             case VNET_DPDK_PMD_VIRTIO_USER:
 544               xd->port_type = VNET_DPDK_PORT_TYPE_VIRTIO_USER;
 545               break;
 546
 547             case VNET_DPDK_PMD_VHOST_ETHER:
 548               xd->port_type = VNET_DPDK_PORT_TYPE_VHOST_ETHER;
 549               break;
 550
 551             case VNET_DPDK_PMD_LIOVF_ETHER:
 552               xd->port_type = VNET_DPDK_PORT_TYPE_ETH_VF;
 553               break;
 554
 555             case VNET_DPDK_PMD_FAILSAFE:
 556               xd->port_type = VNET_DPDK_PORT_TYPE_FAILSAFE;
 557               xd->port_conf.intr_conf.lsc = 1;
 558               break;
 559
 560             case VNET_DPDK_PMD_NETVSC:
 561                 {
 562                   struct rte_eth_link l;
 563                   rte_eth_link_get_nowait (i, &l);
 564                   xd->port_type = VNET_DPDK_PORT_TYPE_ETH_VF;
 565                 }
 566               break;
 567
 568             default:
 569               xd->port_type = VNET_DPDK_PORT_TYPE_UNKNOWN;
 570             }
 571
 572           if (devconf->num_rx_desc)
 573             xd->nb_rx_desc = devconf->num_rx_desc;
 574           else {
 575
 576             /* If num_rx_desc is not specified by VPP user, the current CPU is working
 577             with 2M page and has no L3 cache, default num_rx_desc is changed to 512
 578             from original 1024 to help reduce TLB misses.
 579             */
 580             if ((clib_mem_get_default_hugepage_size () == 2 << 20)
 581               && check_l3cache() == 0)
 582               xd->nb_rx_desc = 512;
 583           }
 584
 585           if (devconf->num_tx_desc)
 586             xd->nb_tx_desc = devconf->num_tx_desc;
 587           else {
 588
 589             /* If num_tx_desc is not specified by VPP user, the current CPU is working
 590             with 2M page and has no L3 cache, default num_tx_desc is changed to 512
 591             from original 1024 to help reduce TLB misses.
 592             */
 593             if ((clib_mem_get_default_hugepage_size () == 2 << 20)
 594               && check_l3cache() == 0)
 595               xd->nb_tx_desc = 512;
 596           }
 597        }
 598
 599       if (xd->pmd == VNET_DPDK_PMD_AF_PACKET)
 600         {
 601           f64 now = vlib_time_now (vm);
 602           u32 rnd;
 603           rnd = (u32) (now * 1e6);
 604           rnd = random_u32 (&rnd);
 605           clib_memcpy (addr + 2, &rnd, sizeof (rnd));
 606           addr[0] = 2;
 607           addr[1] = 0xfe;
 608         }
 609       else
 610         rte_eth_macaddr_get (i, (void *) addr);
 611
 612       xd->port_id = i;
 613       xd->device_index = xd - dm->devices;
 614       xd->per_interface_next_index = ~0;
 615
 616       /* assign interface to input thread */
 617       int q;
 618
 619       error = ethernet_register_interface
 620         (dm->vnet_main, dpdk_device_class.index, xd->device_index,
 621          /* ethernet address */ addr,
 622          &xd->hw_if_index, dpdk_flag_change);
 623       if (error)
 624         return error;
 625
 626       /*
 627        * Ensure default mtu is not > the mtu read from the hardware.
 628        * Otherwise rte_eth_dev_configure() will fail and the port will
 629        * not be available.
 630        * Calculate max_frame_size and mtu supported by NIC
 631        */
 632       if (ETHERNET_MAX_PACKET_BYTES > dev_info.max_rx_pktlen)
 633         {
 634           /*
 635            * This device does not support the platforms's max frame
 636            * size. Use it's advertised mru instead.
 637            */
 638           max_rx_frame = dev_info.max_rx_pktlen;
 639           mtu = dev_info.max_rx_pktlen - sizeof (ethernet_header_t);
 640         }
 641       else
 642         {
 643           /* VPP treats MTU and max_rx_pktlen both equal to
 644            * ETHERNET_MAX_PACKET_BYTES, if dev_info.max_rx_pktlen >=
 645            * ETHERNET_MAX_PACKET_BYTES + sizeof(ethernet_header_t)
 646            */
 647           if (dev_info.max_rx_pktlen >= (ETHERNET_MAX_PACKET_BYTES +
 648                                          sizeof (ethernet_header_t)))
 649             {
 650               mtu = ETHERNET_MAX_PACKET_BYTES;
 651               max_rx_frame = ETHERNET_MAX_PACKET_BYTES;
 652
 653               /*
 654                * Some platforms do not account for Ethernet FCS (4 bytes) in
 655                * MTU calculations. To interop with them increase mru but only
 656                * if the device's settings can support it.
 657                */
 658               if (dpdk_port_crc_strip_enabled (xd) &&
 659                   (dev_info.max_rx_pktlen >= (ETHERNET_MAX_PACKET_BYTES +
 660                                               sizeof (ethernet_header_t) +
 661                                               4)))
 662                 {
 663                   max_rx_frame += 4;
 664                 }
 665             }
 666           else
 667             {
 668               max_rx_frame = ETHERNET_MAX_PACKET_BYTES;
 669               mtu = ETHERNET_MAX_PACKET_BYTES - sizeof (ethernet_header_t);
 670
 671               if (dpdk_port_crc_strip_enabled (xd) &&
 672                   (dev_info.max_rx_pktlen >= (ETHERNET_MAX_PACKET_BYTES + 4)))
 673                 {
 674                   max_rx_frame += 4;
 675                 }
 676             }
 677         }
 678
 679       if (xd->pmd == VNET_DPDK_PMD_FAILSAFE)
 680         {
 681           /* failsafe device numerables are reported with active device only,
 682            * need to query the mtu for current device setup to overwrite
 683            * reported value.
 684            */
 685           uint16_t dev_mtu;
 686           if (!rte_eth_dev_get_mtu (i, &dev_mtu))
 687             {
 688               mtu = dev_mtu;
 689               max_rx_frame = mtu + sizeof (ethernet_header_t);
 690
 691               if (dpdk_port_crc_strip_enabled (xd))
 692                 {
 693                   max_rx_frame += 4;
 694                 }
 695             }
 696         }
 697
 698       /*Set port rxmode config */
 699       xd->port_conf.rxmode.max_rx_pkt_len = max_rx_frame;
 700
 701       sw = vnet_get_hw_sw_interface (dm->vnet_main, xd->hw_if_index);
 702       xd->sw_if_index = sw->sw_if_index;
 703       vnet_hw_interface_set_input_node (dm->vnet_main, xd->hw_if_index,
 704                                         dpdk_input_node.index);
 705
 706       if (devconf->workers)
 707         {
 708           int i;
 709           q = 0;
 710           clib_bitmap_foreach (i, devconf->workers, ({
 711             vnet_hw_interface_assign_rx_thread (dm->vnet_main, xd->hw_if_index, q++,
 712                                              vdm->first_worker_thread_index + i);
 713           }));
 714         }
 715       else
 716         for (q = 0; q < xd->rx_q_used; q++)
 717           {
 718             vnet_hw_interface_assign_rx_thread (dm->vnet_main, xd->hw_if_index, q,      /* any */
 719                                                 ~1);
 720           }
 721
 722       /*Get vnet hardware interface */
 723       hi = vnet_get_hw_interface (dm->vnet_main, xd->hw_if_index);
 724
 725       /*Override default max_packet_bytes and max_supported_bytes set in
 726        * ethernet_register_interface() above*/
 727       if (hi)
 728         {
 729           hi->max_packet_bytes = mtu;
 730           hi->max_supported_packet_bytes = max_rx_frame;
 731           hi->numa_node = xd->cpu_socket;
 732
 733           /* Indicate ability to support L3 DMAC filtering and
 734            * initialize interface to L3 non-promisc mode */
 735           hi->flags |= VNET_HW_INTERFACE_FLAG_SUPPORTS_MAC_FILTER;
 736           ethernet_set_flags (dm->vnet_main, xd->hw_if_index,
 737                              ETHERNET_INTERFACE_FLAG_DEFAULT_L3);
 738         }
 739
 740       if (dm->conf->no_tx_checksum_offload == 0)
 741         if (xd->flags & DPDK_DEVICE_FLAG_TX_OFFLOAD && hi != NULL)
 742           hi->flags |= VNET_HW_INTERFACE_FLAG_SUPPORTS_TX_L4_CKSUM_OFFLOAD;
 743
 744       if (devconf->tso == DPDK_DEVICE_TSO_ON && hi != NULL)
 745         {
 746           /*tcp_udp checksum must be enabled*/
 747           if ((dm->conf->enable_tcp_udp_checksum) &&
 748               (hi->flags & VNET_HW_INTERFACE_FLAG_SUPPORTS_TX_L4_CKSUM_OFFLOAD))
 749             {
 750                 hi->flags |= VNET_HW_INTERFACE_FLAG_SUPPORTS_GSO;
 751                 xd->port_conf.txmode.offloads |= DEV_TX_OFFLOAD_TCP_TSO |
 752                   DEV_TX_OFFLOAD_UDP_TSO;
 753             }
 754           else
 755             clib_warning ("%s: TCP/UDP checksum offload must be enabled",
 756               hi->name);
 757         }
 758
 759       dpdk_device_setup (xd);
 760
 761       /* rss queues should be configured after dpdk_device_setup() */
 762       if ((hi != NULL) && (devconf->rss_queues != NULL))
 763         {
 764           if (vnet_hw_interface_set_rss_queues
 765               (vnet_get_main (), hi, devconf->rss_queues))
 766           {
 767             clib_warning ("%s: Failed to set rss queues", hi->name);
 768           }
 769         }
 770
 771       if (vec_len (xd->errors))
 772         dpdk_log_err ("setup failed for device %U. Errors:\n  %U",
 773                       format_dpdk_device_name, i,
 774                       format_dpdk_device_errors, xd);
 775
 776       /*
 777        * A note on Cisco VIC (PMD_ENIC) and VLAN:
 778        *
 779        * With Cisco VIC vNIC, every ingress packet is tagged. On a
 780        * trunk vNIC (C series "standalone" server), packets on no VLAN
 781        * are tagged with vlan 0. On an access vNIC (standalone or B
 782        * series "blade" server), packets on the default/native VLAN
 783        * are tagged with that vNIC's VLAN. VPP expects these packets
 784        * to be untagged, and previously enabled VLAN strip on VIC by
 785        * default. But it also broke vlan sub-interfaces.
 786        *
 787        * The VIC adapter has "untag default vlan" ingress VLAN rewrite
 788        * mode, which removes tags from these packets. VPP now includes
 789        * a local patch for the enic driver to use this untag mode, so
 790        * enabling vlan stripping is no longer needed. In future, the
 791        * driver + dpdk will have an API to set the mode after
 792        * rte_eal_init. Then, this note and local patch will be
 793        * removed.
 794        */
 795
 796       /*
 797        * VLAN stripping: default to VLAN strip disabled, unless specified
 798        * otherwise in the startup config.
 799        */
 800
 801         vlan_off = rte_eth_dev_get_vlan_offload (xd->port_id);
 802         if (devconf->vlan_strip_offload == DPDK_DEVICE_VLAN_STRIP_ON)
 803           {
 804             vlan_off |= ETH_VLAN_STRIP_OFFLOAD;
 805             if (rte_eth_dev_set_vlan_offload (xd->port_id, vlan_off) >= 0)
 806               dpdk_log_info ("VLAN strip enabled for interface\n");
 807             else
 808               dpdk_log_warn ("VLAN strip cannot be supported by interface\n");
 809             xd->port_conf.rxmode.offloads |= DEV_RX_OFFLOAD_VLAN_STRIP;
 810           }
 811         else
 812           {
 813             if (vlan_off & ETH_VLAN_STRIP_OFFLOAD)
 814               {
 815                 vlan_off &= ~ETH_VLAN_STRIP_OFFLOAD;
 816                 if (rte_eth_dev_set_vlan_offload (xd->port_id, vlan_off) >= 0)
 817                   dpdk_log_warn ("set VLAN offload failed\n");
 818               }
 819             xd->port_conf.rxmode.offloads &= ~DEV_RX_OFFLOAD_VLAN_STRIP;
 820           }
 821
 822         if (hi)
 823           hi->max_packet_bytes = xd->port_conf.rxmode.max_rx_pkt_len
 824             - sizeof (ethernet_header_t);
 825         else
 826           dpdk_log_warn ("hi NULL");
 827
 828         if (dm->conf->no_multi_seg)
 829           mtu = mtu > ETHER_MAX_LEN ? ETHER_MAX_LEN : mtu;
 830
 831         rte_eth_dev_set_mtu (xd->port_id, mtu);
 832 }
 833
 834   /* *INDENT-ON* */
 835
 836   return 0;
 837 }
 838
 839 static void
 840 dpdk_bind_devices_to_uio (dpdk_config_main_t * conf)
 841 {
 842   vlib_main_t *vm = vlib_get_main ();
 843   clib_error_t *error;
 844   u8 *pci_addr = 0;
 845   int num_whitelisted = vec_len (conf->dev_confs);
 846   vlib_pci_device_info_t *d = 0;
 847   vlib_pci_addr_t *addr = 0, *addrs;
 848   int i;
 849
 850   addrs = vlib_pci_get_all_dev_addrs ();
 851   /* *INDENT-OFF* */
 852   vec_foreach (addr, addrs)
 853     {
 854     dpdk_device_config_t * devconf = 0;
 855     vec_reset_length (pci_addr);
 856     pci_addr = format (pci_addr, "%U%c", format_vlib_pci_addr, addr, 0);
 857     if (d)
 858     {
 859       vlib_pci_free_device_info (d);
 860       d = 0;
 861       }
 862     d = vlib_pci_get_device_info (vm, addr, &error);
 863     if (error)
 864     {
 865       vlib_log_warn (dpdk_main.log_default, "%U", format_clib_error, error);
 866       clib_error_free (error);
 867       continue;
 868     }
 869
 870     if (d->device_class != PCI_CLASS_NETWORK_ETHERNET && d->device_class != PCI_CLASS_PROCESSOR_CO)
 871       continue;
 872
 873     if (num_whitelisted)
 874       {
 875         uword * p = hash_get (conf->device_config_index_by_pci_addr, addr->as_u32);
 876
 877         if (!p)
 878           {
 879           skipped:
 880             continue;
 881           }
 882
 883         devconf = pool_elt_at_index (conf->dev_confs, p[0]);
 884       }
 885
 886     /* Enforce Device blacklist by vendor and device */
 887     for (i = 0; i < vec_len (conf->blacklist_by_pci_vendor_and_device); i++)
 888       {
 889         u16 vendor, device;
 890         vendor = (u16)(conf->blacklist_by_pci_vendor_and_device[i] >> 16);
 891         device = (u16)(conf->blacklist_by_pci_vendor_and_device[i] & 0xFFFF);
 892         if (d->vendor_id == vendor && d->device_id == device)
 893           {
 894             /*
 895              * Expected case: device isn't whitelisted,
 896              * so blacklist it...
 897              */
 898             if (devconf == 0)
 899               {
 900                 /* Device is blacklisted */
 901                 pool_get (conf->dev_confs, devconf);
 902                 hash_set (conf->device_config_index_by_pci_addr, addr->as_u32,
 903                           devconf - conf->dev_confs);
 904                 devconf->pci_addr.as_u32 = addr->as_u32;
 905                 devconf->is_blacklisted = 1;
 906                 goto skipped;
 907               }
 908             else /* explicitly whitelisted, ignore the device blacklist  */
 909               break;
 910           }
 911       }
 912
 913     /* virtio */
 914     if (d->vendor_id == 0x1af4 &&
 915             (d->device_id == VIRTIO_PCI_LEGACY_DEVICEID_NET ||
 916              d->device_id == VIRTIO_PCI_MODERN_DEVICEID_NET))
 917       ;
 918     /* vmxnet3 */
 919     else if (d->vendor_id == 0x15ad && d->device_id == 0x07b0)
 920       {
 921         /*
 922          * For vmxnet3 PCI, unless it is explicitly specified in the whitelist,
 923          * the default is to put it in the blacklist.
 924          */
 925         if (devconf == 0)
 926           {
 927             pool_get (conf->dev_confs, devconf);
 928             hash_set (conf->device_config_index_by_pci_addr, addr->as_u32,
 929                       devconf - conf->dev_confs);
 930             devconf->pci_addr.as_u32 = addr->as_u32;
 931             devconf->is_blacklisted = 1;
 932           }
 933       }
 934     /* all Intel network devices */
 935     else if (d->vendor_id == 0x8086 && d->device_class == PCI_CLASS_NETWORK_ETHERNET)
 936       ;
 937     /* all Intel QAT devices VFs */
 938     else if (d->vendor_id == 0x8086 && d->device_class == PCI_CLASS_PROCESSOR_CO &&
 939         (d->device_id == 0x0443 || d->device_id == 0x18a1 || d->device_id == 0x19e3 ||
 940         d->device_id == 0x37c9 || d->device_id == 0x6f55))
 941       ;
 942     /* Cisco VIC */
 943     else if (d->vendor_id == 0x1137 &&
 944         (d->device_id == 0x0043 || d->device_id == 0x0071))
 945       ;
 946     /* Chelsio T4/T5 */
 947     else if (d->vendor_id == 0x1425 && (d->device_id & 0xe000) == 0x4000)
 948       ;
 949     /* Amazon Elastic Network Adapter */
 950     else if (d->vendor_id == 0x1d0f && d->device_id >= 0xec20 && d->device_id <= 0xec21)
 951       ;
 952     /* Cavium Network Adapter */
 953     else if (d->vendor_id == 0x177d && d->device_id == 0x9712)
 954       ;
 955     /* Cavium FastlinQ QL41000 Series */
 956     else if (d->vendor_id == 0x1077 && d->device_id >= 0x8070 && d->device_id <= 0x8090)
 957       ;
 958     /* Mellanox CX3, CX3VF */
 959     else if (d->vendor_id == 0x15b3 && d->device_id >= 0x1003 && d->device_id <= 0x1004)
 960       {
 961         continue;
 962       }
 963     /* Mellanox CX4, CX4VF, CX4LX, CX4LXVF, CX5, CX5VF, CX5EX, CX5EXVF */
 964     else if (d->vendor_id == 0x15b3 && d->device_id >= 0x1013 && d->device_id <= 0x101a)
 965       {
 966         continue;
 967       }
 968     /* Mellanox CX6, CX6VF, CX6DX, CX6DXVF */
 969     else if (d->vendor_id == 0x15b3 && d->device_id >= 0x101b && d->device_id <= 0x101e)
 970       {
 971         continue;
 972       }
 973     /* Broadcom NetXtreme S, and E series only */
 974     else if (d->vendor_id == 0x14e4 &&
 975         ((d->device_id >= 0x16c0 &&
 976                 d->device_id != 0x16c6 && d->device_id != 0x16c7 &&
 977                 d->device_id != 0x16dd && d->device_id != 0x16f7 &&
 978                 d->device_id != 0x16fd && d->device_id != 0x16fe &&
 979                 d->device_id != 0x170d && d->device_id != 0x170c &&
 980                 d->device_id != 0x170e && d->device_id != 0x1712 &&
 981                 d->device_id != 0x1713) ||
 982         (d->device_id == 0x1604 || d->device_id == 0x1605 ||
 983          d->device_id == 0x1614 || d->device_id == 0x1606 ||
 984          d->device_id == 0x1609 || d->device_id == 0x1614)))
 985       ;
 986     else
 987       {
 988         dpdk_log_warn ("Unsupported PCI device 0x%04x:0x%04x found "
 989                       "at PCI address %s\n", (u16) d->vendor_id, (u16) d->device_id,
 990                       pci_addr);
 991         continue;
 992       }
 993
 994     error = vlib_pci_bind_to_uio (vm, addr, (char *) conf->uio_driver_name);
 995
 996     if (error)
 997       {
 998         if (devconf == 0)
 999           {
1000             pool_get (conf->dev_confs, devconf);
1001             hash_set (conf->device_config_index_by_pci_addr, addr->as_u32,
1002                       devconf - conf->dev_confs);
1003             devconf->pci_addr.as_u32 = addr->as_u32;
1004           }
1005         devconf->is_blacklisted = 1;
1006         clib_error_report (error);
1007       }
1008   }
1009   /* *INDENT-ON* */
1010   vec_free (pci_addr);
1011   vlib_pci_free_device_info (d);
1012 }
1013
1014 static void
1015 dpdk_bind_vmbus_devices_to_uio (dpdk_config_main_t * conf)
1016 {
1017   clib_error_t *error;
1018   vlib_vmbus_addr_t *addrs, *addr = 0;
1019
1020   addrs = vlib_vmbus_get_all_dev_addrs ();
1021
1022   /* *INDENT-OFF* */
1023   vec_foreach (addr, addrs)
1024     {
1025       error = vlib_vmbus_bind_to_uio (addr);
1026
1027       if (error)
1028         {
1029           clib_error_report (error);
1030         }
1031     }
1032   /* *INDENT-ON* */
1033 }
1034
1035 static clib_error_t *
1036 dpdk_device_config (dpdk_config_main_t * conf, vlib_pci_addr_t pci_addr,
1037                     unformat_input_t * input, u8 is_default)
1038 {
1039   clib_error_t *error = 0;
1040   uword *p;
1041   dpdk_device_config_t *devconf;
1042   unformat_input_t sub_input;
1043
1044   if (is_default)
1045     {
1046       devconf = &conf->default_devconf;
1047     }
1048   else
1049     {
1050       p = hash_get (conf->device_config_index_by_pci_addr, pci_addr.as_u32);
1051
1052       if (!p)
1053         {
1054           pool_get (conf->dev_confs, devconf);
1055           hash_set (conf->device_config_index_by_pci_addr, pci_addr.as_u32,
1056                     devconf - conf->dev_confs);
1057         }
1058       else
1059         return clib_error_return (0,
1060                                   "duplicate configuration for PCI address %U",
1061                                   format_vlib_pci_addr, &pci_addr);
1062     }
1063
1064   devconf->pci_addr.as_u32 = pci_addr.as_u32;
1065   devconf->tso = DPDK_DEVICE_TSO_DEFAULT;
1066
1067   if (!input)
1068     return 0;
1069
1070   unformat_skip_white_space (input);
1071   while (unformat_check_input (input) != UNFORMAT_END_OF_INPUT)
1072     {
1073       if (unformat (input, "num-rx-queues %u", &devconf->num_rx_queues))
1074         ;
1075       else if (unformat (input, "num-tx-queues %u", &devconf->num_tx_queues))
1076         ;
1077       else if (unformat (input, "num-rx-desc %u", &devconf->num_rx_desc))
1078         ;
1079       else if (unformat (input, "num-tx-desc %u", &devconf->num_tx_desc))
1080         ;
1081       else if (unformat (input, "name %s", &devconf->name))
1082         ;
1083       else if (unformat (input, "workers %U", unformat_bitmap_list,
1084                          &devconf->workers))
1085         ;
1086       else
1087         if (unformat
1088             (input, "rss %U", unformat_vlib_cli_sub_input, &sub_input))
1089         {
1090           error = unformat_rss_fn (&sub_input, &devconf->rss_fn);
1091           if (error)
1092             break;
1093         }
1094       else if (unformat (input, "vlan-strip-offload off"))
1095         devconf->vlan_strip_offload = DPDK_DEVICE_VLAN_STRIP_OFF;
1096       else if (unformat (input, "vlan-strip-offload on"))
1097         devconf->vlan_strip_offload = DPDK_DEVICE_VLAN_STRIP_ON;
1098       else if (unformat (input, "tso on"))
1099         {
1100           devconf->tso = DPDK_DEVICE_TSO_ON;
1101         }
1102       else if (unformat (input, "tso off"))
1103         {
1104           devconf->tso = DPDK_DEVICE_TSO_OFF;
1105         }
1106       else if (unformat (input, "devargs %s", &devconf->devargs))
1107         ;
1108       else if (unformat (input, "rss-queues %U",
1109                          unformat_bitmap_list, &devconf->rss_queues))
1110         ;
1111       else
1112         {
1113           error = clib_error_return (0, "unknown input `%U'",
1114                                      format_unformat_error, input);
1115           break;
1116         }
1117     }
1118
1119   if (error)
1120     return error;
1121
1122   if (devconf->workers && devconf->num_rx_queues == 0)
1123     devconf->num_rx_queues = clib_bitmap_count_set_bits (devconf->workers);
1124   else if (devconf->workers &&
1125            clib_bitmap_count_set_bits (devconf->workers) !=
1126            devconf->num_rx_queues)
1127     error =
1128       clib_error_return (0,
1129                          "%U: number of worker threads must be "
1130                          "equal to number of rx queues", format_vlib_pci_addr,
1131                          &pci_addr);
1132
1133   return error;
1134 }
1135
1136 static clib_error_t *
1137 dpdk_log_read_ready (clib_file_t * uf)
1138 {
1139   unformat_input_t input;
1140   u8 *line, *s = 0;
1141   int n, n_try;
1142
1143   n = n_try = 4096;
1144   while (n == n_try)
1145     {
1146       uword len = vec_len (s);
1147       vec_resize (s, len + n_try);
1148
1149       n = read (uf->file_descriptor, s + len, n_try);
1150       if (n < 0 && errno != EAGAIN)
1151         return clib_error_return_unix (0, "read");
1152       _vec_len (s) = len + (n < 0 ? 0 : n);
1153     }
1154
1155   unformat_init_vector (&input, s);
1156
1157   while (unformat_user (&input, unformat_line, &line))
1158     {
1159       dpdk_log_notice ("%v", line);
1160       vec_free (line);
1161     }
1162
1163   unformat_free (&input);
1164   return 0;
1165 }
1166
1167 static clib_error_t *
1168 dpdk_config (vlib_main_t * vm, unformat_input_t * input)
1169 {
1170   clib_error_t *error = 0;
1171   dpdk_config_main_t *conf = &dpdk_config_main;
1172   vlib_thread_main_t *tm = vlib_get_thread_main ();
1173   dpdk_device_config_t *devconf;
1174   vlib_pci_addr_t pci_addr;
1175   unformat_input_t sub_input;
1176   uword default_hugepage_sz, x;
1177   u8 *s, *tmp = 0;
1178   int ret, i;
1179   int num_whitelisted = 0;
1180   u8 no_pci = 0;
1181   u8 no_vmbus = 0;
1182   u8 file_prefix = 0;
1183   u8 *socket_mem = 0;
1184   u8 *huge_dir_path = 0;
1185   u32 vendor, device, domain, bus, func;
1186
1187   huge_dir_path =
1188     format (0, "%s/hugepages%c", vlib_unix_get_runtime_dir (), 0);
1189
1190   conf->device_config_index_by_pci_addr = hash_create (0, sizeof (uword));
1191
1192   while (unformat_check_input (input) != UNFORMAT_END_OF_INPUT)
1193     {
1194       /* Prime the pump */
1195       if (unformat (input, "no-hugetlb"))
1196         {
1197           vec_add1 (conf->eal_init_args, (u8 *) "--no-huge");
1198         }
1199       else if (unformat (input, "telemetry"))
1200         conf->enable_telemetry = 1;
1201
1202       else if (unformat (input, "enable-tcp-udp-checksum"))
1203         conf->enable_tcp_udp_checksum = 1;
1204
1205       else if (unformat (input, "no-tx-checksum-offload"))
1206         conf->no_tx_checksum_offload = 1;
1207
1208       else if (unformat (input, "decimal-interface-names"))
1209         conf->interface_name_format_decimal = 1;
1210
1211       else if (unformat (input, "no-multi-seg"))
1212         conf->no_multi_seg = 1;
1213
1214       else if (unformat (input, "dev default %U", unformat_vlib_cli_sub_input,
1215                          &sub_input))
1216         {
1217           error =
1218             dpdk_device_config (conf, (vlib_pci_addr_t) (u32) ~ 1, &sub_input,
1219                                 1);
1220
1221           if (error)
1222             return error;
1223         }
1224       else
1225         if (unformat
1226             (input, "dev %U %U", unformat_vlib_pci_addr, &pci_addr,
1227              unformat_vlib_cli_sub_input, &sub_input))
1228         {
1229           error = dpdk_device_config (conf, pci_addr, &sub_input, 0);
1230
1231           if (error)
1232             return error;
1233
1234           num_whitelisted++;
1235         }
1236       else if (unformat (input, "dev %U", unformat_vlib_pci_addr, &pci_addr))
1237         {
1238           error = dpdk_device_config (conf, pci_addr, 0, 0);
1239
1240           if (error)
1241             return error;
1242
1243           num_whitelisted++;
1244         }
1245       else if (unformat (input, "num-mem-channels %d", &conf->nchannels))
1246         conf->nchannels_set_manually = 0;
1247       else if (unformat (input, "num-crypto-mbufs %d",
1248                          &conf->num_crypto_mbufs))
1249         ;
1250       else if (unformat (input, "uio-driver %s", &conf->uio_driver_name))
1251         ;
1252       else if (unformat (input, "socket-mem %s", &socket_mem))
1253         ;
1254       else if (unformat (input, "no-pci"))
1255         {
1256           no_pci = 1;
1257           tmp = format (0, "--no-pci%c", 0);
1258           vec_add1 (conf->eal_init_args, tmp);
1259         }
1260       else
1261         if (unformat
1262             (input, "blacklist %x:%x:%x.%x", &domain, &bus, &device, &func))
1263         {
1264           tmp = format (0, "-b%c", 0);
1265           vec_add1 (conf->eal_init_args, tmp);
1266           tmp =
1267             format (0, "%04x:%02x:%02x.%x%c", domain, bus, device, func, 0);
1268           vec_add1 (conf->eal_init_args, tmp);
1269         }
1270       else if (unformat (input, "blacklist %x:%x", &vendor, &device))
1271         {
1272           u32 blacklist_entry;
1273           if (vendor > 0xFFFF)
1274             return clib_error_return (0, "blacklist PCI vendor out of range");
1275           if (device > 0xFFFF)
1276             return clib_error_return (0, "blacklist PCI device out of range");
1277           blacklist_entry = (vendor << 16) | (device & 0xffff);
1278           vec_add1 (conf->blacklist_by_pci_vendor_and_device,
1279                     blacklist_entry);
1280         }
1281       else if (unformat (input, "no-vmbus"))
1282         {
1283           no_vmbus = 1;
1284           tmp = format (0, "--no-vmbus%c", 0);
1285           vec_add1 (conf->eal_init_args, tmp);
1286         }
1287
1288 #define _(a)                                    \
1289       else if (unformat(input, #a))             \
1290         {                                       \
1291           tmp = format (0, "--%s%c", #a, 0);    \
1292           vec_add1 (conf->eal_init_args, tmp);    \
1293         }
1294       foreach_eal_double_hyphen_predicate_arg
1295 #undef _
1296 #define _(a)                                          \
1297         else if (unformat(input, #a " %s", &s))       \
1298           {                                           \
1299             if (!strncmp(#a, "file-prefix", 11)) \
1300               file_prefix = 1;                        \
1301             tmp = format (0, "--%s%c", #a, 0);        \
1302             vec_add1 (conf->eal_init_args, tmp);      \
1303             vec_add1 (s, 0);                          \
1304             if (!strncmp(#a, "vdev", 4))              \
1305               if (strstr((char*)s, "af_packet"))      \
1306                 clib_warning ("af_packet obsoleted. Use CLI 'create host-interface'."); \
1307             vec_add1 (conf->eal_init_args, s);        \
1308           }
1309         foreach_eal_double_hyphen_arg
1310 #undef _
1311 #define _(a,b)                                          \
1312           else if (unformat(input, #a " %s", &s))       \
1313             {                                           \
1314               tmp = format (0, "-%s%c", #b, 0);         \
1315               vec_add1 (conf->eal_init_args, tmp);      \
1316               vec_add1 (s, 0);                          \
1317               vec_add1 (conf->eal_init_args, s);        \
1318             }
1319         foreach_eal_single_hyphen_arg
1320 #undef _
1321 #define _(a,b)                                          \
1322             else if (unformat(input, #a " %s", &s))     \
1323               {                                         \
1324                 tmp = format (0, "-%s%c", #b, 0);       \
1325                 vec_add1 (conf->eal_init_args, tmp);    \
1326                 vec_add1 (s, 0);                        \
1327                 vec_add1 (conf->eal_init_args, s);      \
1328                 conf->a##_set_manually = 1;             \
1329               }
1330         foreach_eal_single_hyphen_mandatory_arg
1331 #undef _
1332         else if (unformat (input, "default"))
1333         ;
1334
1335       else if (unformat_skip_white_space (input))
1336         ;
1337       else
1338         {
1339           error = clib_error_return (0, "unknown input `%U'",
1340                                      format_unformat_error, input);
1341           goto done;
1342         }
1343     }
1344
1345   if (!conf->uio_driver_name)
1346     conf->uio_driver_name = format (0, "auto%c", 0);
1347
1348   default_hugepage_sz = clib_mem_get_default_hugepage_size ();
1349
1350   /* *INDENT-OFF* */
1351   clib_bitmap_foreach (x, tm->cpu_socket_bitmap, (
1352     {
1353       clib_error_t *e;
1354       uword n_pages;
1355       /* preallocate at least 16MB of hugepages per socket,
1356          if more is needed it is up to consumer to preallocate more */
1357       n_pages = round_pow2 ((uword) 16 << 20, default_hugepage_sz);
1358       n_pages /= default_hugepage_sz;
1359
1360       if ((e = clib_sysfs_prealloc_hugepages(x, 0, n_pages)))
1361         clib_error_report (e);
1362   }));
1363   /* *INDENT-ON* */
1364
1365   /* on/off dpdk's telemetry thread */
1366   if (conf->enable_telemetry == 0)
1367     {
1368       vec_add1 (conf->eal_init_args, (u8 *) "--no-telemetry");
1369     }
1370
1371   if (!file_prefix)
1372     {
1373       tmp = format (0, "--file-prefix%c", 0);
1374       vec_add1 (conf->eal_init_args, tmp);
1375       tmp = format (0, "vpp%c", 0);
1376       vec_add1 (conf->eal_init_args, tmp);
1377     }
1378
1379   if (error)
1380     return error;
1381
1382   /* I'll bet that -c and -n must be the first and second args... */
1383   if (!conf->coremask_set_manually)
1384     {
1385       vlib_thread_registration_t *tr;
1386       uword *coremask = 0;
1387       int i;
1388
1389       /* main thread core */
1390       coremask = clib_bitmap_set (coremask, tm->main_lcore, 1);
1391
1392       for (i = 0; i < vec_len (tm->registrations); i++)
1393         {
1394           tr = tm->registrations[i];
1395           coremask = clib_bitmap_or (coremask, tr->coremask);
1396         }
1397
1398       vec_insert (conf->eal_init_args, 2, 1);
1399       conf->eal_init_args[1] = (u8 *) "-c";
1400       tmp = format (0, "%U%c", format_bitmap_hex, coremask, 0);
1401       conf->eal_init_args[2] = tmp;
1402       clib_bitmap_free (coremask);
1403     }
1404
1405   if (!conf->nchannels_set_manually)
1406     {
1407       vec_insert (conf->eal_init_args, 2, 3);
1408       conf->eal_init_args[3] = (u8 *) "-n";
1409       tmp = format (0, "%d", conf->nchannels);
1410       vec_terminate_c_string (tmp);
1411       conf->eal_init_args[4] = tmp;
1412     }
1413
1414   if (no_pci == 0 && geteuid () == 0)
1415     dpdk_bind_devices_to_uio (conf);
1416
1417   if (no_vmbus == 0 && geteuid () == 0)
1418     dpdk_bind_vmbus_devices_to_uio (conf);
1419
1420 #define _(x) \
1421     if (devconf->x == 0 && conf->default_devconf.x > 0) \
1422       devconf->x = conf->default_devconf.x ;
1423
1424   /* *INDENT-OFF* */
1425   pool_foreach (devconf, conf->dev_confs, ({
1426
1427     /* default per-device config items */
1428     foreach_dpdk_device_config_item
1429
1430     /* copy vlan_strip config from default device */
1431         if (devconf->vlan_strip_offload == 0 &&
1432                 conf->default_devconf.vlan_strip_offload > 0)
1433                 devconf->vlan_strip_offload =
1434                         conf->default_devconf.vlan_strip_offload;
1435
1436         /* copy tso config from default device */
1437         _(tso)
1438
1439         /* copy tso config from default device */
1440         _(devargs)
1441
1442         /* copy rss_queues config from default device */
1443         _(rss_queues)
1444
1445     /* add DPDK EAL whitelist/blacklist entry */
1446     if (num_whitelisted > 0 && devconf->is_blacklisted == 0)
1447     {
1448           tmp = format (0, "-w%c", 0);
1449           vec_add1 (conf->eal_init_args, tmp);
1450           if (devconf->devargs)
1451           {
1452             tmp = format (0, "%U,%s", format_vlib_pci_addr, &devconf->pci_addr, devconf->devargs, 0);
1453           }
1454           else
1455           {
1456             tmp = format (0, "%U%c", format_vlib_pci_addr, &devconf->pci_addr, 0);
1457           }
1458           vec_add1 (conf->eal_init_args, tmp);
1459     }
1460     else if (num_whitelisted == 0 && devconf->is_blacklisted != 0)
1461     {
1462           tmp = format (0, "-b%c", 0);
1463           vec_add1 (conf->eal_init_args, tmp);
1464           tmp = format (0, "%U%c", format_vlib_pci_addr, &devconf->pci_addr, 0);
1465           vec_add1 (conf->eal_init_args, tmp);
1466     }
1467   }));
1468   /* *INDENT-ON* */
1469
1470 #undef _
1471
1472   /* set master-lcore */
1473   tmp = format (0, "--master-lcore%c", 0);
1474   vec_add1 (conf->eal_init_args, tmp);
1475   tmp = format (0, "%u%c", tm->main_lcore, 0);
1476   vec_add1 (conf->eal_init_args, tmp);
1477
1478
1479   if (socket_mem)
1480     clib_warning ("socket-mem argument is deprecated");
1481
1482   /* NULL terminate the "argv" vector, in case of stupidity */
1483   vec_add1 (conf->eal_init_args, 0);
1484   _vec_len (conf->eal_init_args) -= 1;
1485
1486   /* Set up DPDK eal and packet mbuf pool early. */
1487
1488   int log_fds[2] = { 0 };
1489   if (pipe (log_fds) == 0)
1490     {
1491       if (fcntl (log_fds[1], F_SETFL, O_NONBLOCK) == 0)
1492         {
1493           FILE *f = fdopen (log_fds[1], "a");
1494           if (f && rte_openlog_stream (f) == 0)
1495             {
1496               clib_file_t t = { 0 };
1497               t.read_function = dpdk_log_read_ready;
1498               t.file_descriptor = log_fds[0];
1499               t.description = format (0, "DPDK logging pipe");
1500               clib_file_add (&file_main, &t);
1501             }
1502         }
1503       else
1504         {
1505           close (log_fds[0]);
1506           close (log_fds[1]);
1507         }
1508     }
1509
1510   vm = vlib_get_main ();
1511
1512   /* make copy of args as rte_eal_init tends to mess up with arg array */
1513   for (i = 1; i < vec_len (conf->eal_init_args); i++)
1514     conf->eal_init_args_str = format (conf->eal_init_args_str, "%s ",
1515                                       conf->eal_init_args[i]);
1516
1517   vec_terminate_c_string (conf->eal_init_args_str);
1518
1519   dpdk_log_notice ("EAL init args: %s", conf->eal_init_args_str);
1520   ret = rte_eal_init (vec_len (conf->eal_init_args),
1521                       (char **) conf->eal_init_args);
1522
1523   /* lazy umount hugepages */
1524   umount2 ((char *) huge_dir_path, MNT_DETACH);
1525   rmdir ((char *) huge_dir_path);
1526   vec_free (huge_dir_path);
1527
1528   if (ret < 0)
1529     return clib_error_return (0, "rte_eal_init returned %d", ret);
1530
1531   /* main thread 1st */
1532   if ((error = dpdk_buffer_pools_create (vm)))
1533     return error;
1534
1535 done:
1536   return error;
1537 }
1538
1539 VLIB_CONFIG_FUNCTION (dpdk_config, "dpdk");
1540
1541 void
1542 dpdk_update_link_state (dpdk_device_t * xd, f64 now)
1543 {
1544   vnet_main_t *vnm = vnet_get_main ();
1545   struct rte_eth_link prev_link = xd->link;
1546   u32 hw_flags = 0;
1547   u8 hw_flags_chg = 0;
1548
1549   /* only update link state for PMD interfaces */
1550   if ((xd->flags & DPDK_DEVICE_FLAG_PMD) == 0)
1551     return;
1552
1553   xd->time_last_link_update = now ? now : xd->time_last_link_update;
1554   clib_memset (&xd->link, 0, sizeof (xd->link));
1555   rte_eth_link_get_nowait (xd->port_id, &xd->link);
1556
1557   if (LINK_STATE_ELOGS)
1558     {
1559       vlib_main_t *vm = vlib_get_main ();
1560       ELOG_TYPE_DECLARE (e) =
1561       {
1562       .format =
1563           "update-link-state: sw_if_index %d, admin_up %d,"
1564           "old link_state %d new link_state %d",.format_args = "i4i1i1i1",};
1565
1566       struct
1567       {
1568         u32 sw_if_index;
1569         u8 admin_up;
1570         u8 old_link_state;
1571         u8 new_link_state;
1572       } *ed;
1573       ed = ELOG_DATA (&vm->elog_main, e);
1574       ed->sw_if_index = xd->sw_if_index;
1575       ed->admin_up = (xd->flags & DPDK_DEVICE_FLAG_ADMIN_UP) != 0;
1576       ed->old_link_state = (u8)
1577         vnet_hw_interface_is_link_up (vnm, xd->hw_if_index);
1578       ed->new_link_state = (u8) xd->link.link_status;
1579     }
1580
1581   if ((xd->link.link_duplex != prev_link.link_duplex))
1582     {
1583       hw_flags_chg = 1;
1584       switch (xd->link.link_duplex)
1585         {
1586         case ETH_LINK_HALF_DUPLEX:
1587           hw_flags |= VNET_HW_INTERFACE_FLAG_HALF_DUPLEX;
1588           break;
1589         case ETH_LINK_FULL_DUPLEX:
1590           hw_flags |= VNET_HW_INTERFACE_FLAG_FULL_DUPLEX;
1591           break;
1592         default:
1593           break;
1594         }
1595     }
1596   if (xd->link.link_speed != prev_link.link_speed)
1597     vnet_hw_interface_set_link_speed (vnm, xd->hw_if_index,
1598                                       xd->link.link_speed * 1000);
1599
1600   if (xd->link.link_status != prev_link.link_status)
1601     {
1602       hw_flags_chg = 1;
1603
1604       if (xd->link.link_status)
1605         hw_flags |= VNET_HW_INTERFACE_FLAG_LINK_UP;
1606     }
1607
1608   if (hw_flags_chg)
1609     {
1610       if (LINK_STATE_ELOGS)
1611         {
1612           vlib_main_t *vm = vlib_get_main ();
1613
1614           ELOG_TYPE_DECLARE (e) =
1615           {
1616           .format =
1617               "update-link-state: sw_if_index %d, new flags %d",.format_args
1618               = "i4i4",};
1619
1620           struct
1621           {
1622             u32 sw_if_index;
1623             u32 flags;
1624           } *ed;
1625           ed = ELOG_DATA (&vm->elog_main, e);
1626           ed->sw_if_index = xd->sw_if_index;
1627           ed->flags = hw_flags;
1628         }
1629       vnet_hw_interface_set_flags (vnm, xd->hw_if_index, hw_flags);
1630     }
1631 }
1632
1633 static uword
1634 dpdk_process (vlib_main_t * vm, vlib_node_runtime_t * rt, vlib_frame_t * f)
1635 {
1636   clib_error_t *error;
1637   dpdk_main_t *dm = &dpdk_main;
1638   dpdk_device_t *xd;
1639   vlib_thread_main_t *tm = vlib_get_thread_main ();
1640
1641   error = dpdk_lib_init (dm);
1642
1643   if (error)
1644     clib_error_report (error);
1645
1646   error = dpdk_cryptodev_init (vm);
1647   if (error)
1648     {
1649       vlib_log_warn (dpdk_main.log_cryptodev, "%U", format_clib_error, error);
1650       clib_error_free (error);
1651     }
1652
1653   tm->worker_thread_release = 1;
1654
1655   f64 now = vlib_time_now (vm);
1656   vec_foreach (xd, dm->devices)
1657   {
1658     dpdk_update_link_state (xd, now);
1659   }
1660
1661   while (1)
1662     {
1663       /*
1664        * check each time through the loop in case intervals are changed
1665        */
1666       f64 min_wait = dm->link_state_poll_interval < dm->stat_poll_interval ?
1667         dm->link_state_poll_interval : dm->stat_poll_interval;
1668
1669       vlib_process_wait_for_event_or_clock (vm, min_wait);
1670
1671       if (dm->admin_up_down_in_progress)
1672         /* skip the poll if an admin up down is in progress (on any interface) */
1673         continue;
1674
1675       vec_foreach (xd, dm->devices)
1676       {
1677         f64 now = vlib_time_now (vm);
1678         if ((now - xd->time_last_stats_update) >= dm->stat_poll_interval)
1679           dpdk_update_counters (xd, now);
1680         if ((now - xd->time_last_link_update) >= dm->link_state_poll_interval)
1681           dpdk_update_link_state (xd, now);
1682
1683       }
1684     }
1685
1686   return 0;
1687 }
1688
1689 /* *INDENT-OFF* */
1690 VLIB_REGISTER_NODE (dpdk_process_node,static) = {
1691     .function = dpdk_process,
1692     .type = VLIB_NODE_TYPE_PROCESS,
1693     .name = "dpdk-process",
1694     .process_log2_n_stack_bytes = 17,
1695 };
1696 /* *INDENT-ON* */
1697
1698 static clib_error_t *
1699 dpdk_init (vlib_main_t * vm)
1700 {
1701   dpdk_main_t *dm = &dpdk_main;
1702   clib_error_t *error = 0;
1703
1704   /* verify that structs are cacheline aligned */
1705   STATIC_ASSERT (offsetof (dpdk_device_t, cacheline0) == 0,
1706                  "Cache line marker must be 1st element in dpdk_device_t");
1707   STATIC_ASSERT (offsetof (dpdk_device_t, cacheline1) ==
1708                  CLIB_CACHE_LINE_BYTES,
1709                  "Data in cache line 0 is bigger than cache line size");
1710   STATIC_ASSERT (offsetof (frame_queue_trace_t, cacheline0) == 0,
1711                  "Cache line marker must be 1st element in frame_queue_trace_t");
1712   STATIC_ASSERT (RTE_CACHE_LINE_SIZE == 1 << CLIB_LOG2_CACHE_LINE_BYTES,
1713                  "DPDK RTE CACHE LINE SIZE does not match with 1<<CLIB_LOG2_CACHE_LINE_BYTES");
1714
1715   dpdk_cli_reference ();
1716
1717   dm->vlib_main = vm;
1718   dm->vnet_main = vnet_get_main ();
1719   dm->conf = &dpdk_config_main;
1720
1721   dm->conf->nchannels = 4;
1722   vec_add1 (dm->conf->eal_init_args, (u8 *) "vnet");
1723   vec_add1 (dm->conf->eal_init_args, (u8 *) "--in-memory");
1724
1725   /* Default vlib_buffer_t flags, DISABLES tcp/udp checksumming... */
1726   dm->buffer_flags_template = (VLIB_BUFFER_TOTAL_LENGTH_VALID |
1727                                VLIB_BUFFER_EXT_HDR_VALID |
1728                                VNET_BUFFER_F_L4_CHECKSUM_COMPUTED |
1729                                VNET_BUFFER_F_L4_CHECKSUM_CORRECT);
1730
1731   dm->stat_poll_interval = DPDK_STATS_POLL_INTERVAL;
1732   dm->link_state_poll_interval = DPDK_LINK_POLL_INTERVAL;
1733
1734   dm->log_default = vlib_log_register_class ("dpdk", 0);
1735   dm->log_cryptodev = vlib_log_register_class ("dpdk", "cryptodev");
1736   dm->log_ipsec = vlib_log_register_class ("dpdk", "ipsec");
1737
1738   return error;
1739 }
1740
1741 VLIB_INIT_FUNCTION (dpdk_init);
1742
1743 /*
1744  * fd.io coding-style-patch-verification: ON
1745  *
1746  * Local Variables:
1747  * eval: (c-set-style "gnu")
1748  * End:
1749  */