lib/dpif-netdev.c

   1 /*
   2  * Copyright (c) 2009, 2010, 2011, 2012, 2013 Nicira, Inc.
   3  *
   4  * Licensed under the Apache License, Version 2.0 (the "License");
   5  * you may not use this file except in compliance with the License.
   6  * You may obtain a copy of the License at:
   7  *
   8  *     http://www.apache.org/licenses/LICENSE-2.0
   9  *
  10  * Unless required by applicable law or agreed to in writing, software
  11  * distributed under the License is distributed on an "AS IS" BASIS,
  12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  13  * See the License for the specific language governing permissions and
  14  * limitations under the License.
  15  */
  16
  17 #include <config.h>
  18 #include "dpif.h"
  19
  20 #include <ctype.h>
  21 #include <errno.h>
  22 #include <fcntl.h>
  23 #include <inttypes.h>
  24 #include <netinet/in.h>
  25 #include <sys/socket.h>
  26 #include <net/if.h>
  27 #include <stdint.h>
  28 #include <stdlib.h>
  29 #include <string.h>
  30 #include <sys/ioctl.h>
  31 #include <sys/stat.h>
  32 #include <unistd.h>
  33
  34 #include "csum.h"
  35 #include "dpif.h"
  36 #include "dpif-provider.h"
  37 #include "dummy.h"
  38 #include "dynamic-string.h"
  39 #include "flow.h"
  40 #include "hmap.h"
  41 #include "list.h"
  42 #include "netdev.h"
  43 #include "netdev-vport.h"
  44 #include "netlink.h"
  45 #include "odp-execute.h"
  46 #include "odp-util.h"
  47 #include "ofp-print.h"
  48 #include "ofpbuf.h"
  49 #include "packets.h"
  50 #include "poll-loop.h"
  51 #include "random.h"
  52 #include "seq.h"
  53 #include "shash.h"
  54 #include "sset.h"
  55 #include "timeval.h"
  56 #include "unixctl.h"
  57 #include "util.h"
  58 #include "vlog.h"
  59
  60 VLOG_DEFINE_THIS_MODULE(dpif_netdev);
  61
  62 /* Configuration parameters. */
  63 enum { MAX_PORTS = 256 };       /* Maximum number of ports. */
  64 enum { MAX_FLOWS = 65536 };     /* Maximum number of flows in flow table. */
  65
  66 /* Enough headroom to add a vlan tag, plus an extra 2 bytes to allow IP
  67  * headers to be aligned on a 4-byte boundary.  */
  68 enum { DP_NETDEV_HEADROOM = 2 + VLAN_HEADER_LEN };
  69
  70 /* Queues. */
  71 enum { N_QUEUES = 2 };          /* Number of queues for dpif_recv(). */
  72 enum { MAX_QUEUE_LEN = 128 };   /* Maximum number of packets per queue. */
  73 enum { QUEUE_MASK = MAX_QUEUE_LEN - 1 };
  74 BUILD_ASSERT_DECL(IS_POW2(MAX_QUEUE_LEN));
  75
  76 struct dp_netdev_upcall {
  77     struct dpif_upcall upcall;  /* Queued upcall information. */
  78     struct ofpbuf buf;          /* ofpbuf instance for upcall.packet. */
  79 };
  80
  81 struct dp_netdev_queue {
  82     struct dp_netdev_upcall upcalls[MAX_QUEUE_LEN];
  83     unsigned int head, tail;
  84 };
  85
  86 /* Datapath based on the network device interface from netdev.h. */
  87 struct dp_netdev {
  88     const struct dpif_class *class;
  89     char *name;
  90     int open_cnt;
  91     bool destroyed;
  92     int max_mtu;                /* Maximum MTU of any port added so far. */
  93
  94     struct dp_netdev_queue queues[N_QUEUES];
  95     struct hmap flow_table;     /* Flow table. */
  96     struct seq *queue_seq;      /* Incremented whenever a packet is queued. */
  97
  98     /* Statistics. */
  99     long long int n_hit;        /* Number of flow table matches. */
 100     long long int n_missed;     /* Number of flow table misses. */
 101     long long int n_lost;       /* Number of misses not passed to client. */
 102
 103     /* Ports. */
 104     struct dp_netdev_port *ports[MAX_PORTS];
 105     struct list port_list;
 106     struct seq *port_seq;       /* Incremented whenever a port changes. */
 107 };
 108
 109 /* A port in a netdev-based datapath. */
 110 struct dp_netdev_port {
 111     odp_port_t port_no;         /* Index into dp_netdev's 'ports'. */
 112     struct list node;           /* Element in dp_netdev's 'port_list'. */
 113     struct netdev *netdev;
 114     struct netdev_saved_flags *sf;
 115     struct netdev_rx *rx;
 116     char *type;                 /* Port type as requested by user. */
 117 };
 118
 119 /* A flow in dp_netdev's 'flow_table'. */
 120 struct dp_netdev_flow {
 121     struct hmap_node node;      /* Element in dp_netdev's 'flow_table'. */
 122     struct flow key;
 123
 124     /* Statistics. */
 125     long long int used;         /* Last used time, in monotonic msecs. */
 126     long long int packet_count; /* Number of packets matched. */
 127     long long int byte_count;   /* Number of bytes matched. */
 128     uint8_t tcp_flags;          /* Bitwise-OR of seen tcp_flags values. */
 129
 130     /* Actions. */
 131     struct nlattr *actions;
 132     size_t actions_len;
 133 };
 134
 135 /* Interface to netdev-based datapath. */
 136 struct dpif_netdev {
 137     struct dpif dpif;
 138     struct dp_netdev *dp;
 139     uint64_t last_port_seq;
 140 };
 141
 142 /* All netdev-based datapaths. */
 143 static struct shash dp_netdevs = SHASH_INITIALIZER(&dp_netdevs);
 144
 145 /* Global lock for all data. */
 146 static struct ovs_mutex dp_netdev_mutex = OVS_MUTEX_INITIALIZER;
 147
 148 static int get_port_by_number(struct dp_netdev *, odp_port_t port_no,
 149                               struct dp_netdev_port **portp);
 150 static int get_port_by_name(struct dp_netdev *, const char *devname,
 151                             struct dp_netdev_port **portp);
 152 static void dp_netdev_free(struct dp_netdev *);
 153 static void dp_netdev_flow_flush(struct dp_netdev *);
 154 static int do_add_port(struct dp_netdev *, const char *devname,
 155                        const char *type, odp_port_t port_no);
 156 static int do_del_port(struct dp_netdev *, odp_port_t port_no);
 157 static int dpif_netdev_open(const struct dpif_class *, const char *name,
 158                             bool create, struct dpif **);
 159 static int dp_netdev_output_userspace(struct dp_netdev *, const struct ofpbuf *,
 160                                     int queue_no, const struct flow *,
 161                                     const struct nlattr *userdata);
 162 static void dp_netdev_execute_actions(struct dp_netdev *,
 163                                       struct ofpbuf *, struct flow *,
 164                                       const struct nlattr *actions,
 165                                       size_t actions_len);
 166 static void dp_netdev_port_input(struct dp_netdev *dp,
 167                                  struct dp_netdev_port *port,
 168                                  struct ofpbuf *packet, uint32_t skb_priority,
 169                                  uint32_t pkt_mark, const struct flow_tnl *tnl);
 170
 171 static struct dpif_netdev *
 172 dpif_netdev_cast(const struct dpif *dpif)
 173 {
 174     ovs_assert(dpif->dpif_class->open == dpif_netdev_open);
 175     return CONTAINER_OF(dpif, struct dpif_netdev, dpif);
 176 }
 177
 178 static struct dp_netdev *
 179 get_dp_netdev(const struct dpif *dpif)
 180 {
 181     return dpif_netdev_cast(dpif)->dp;
 182 }
 183
 184 static int
 185 dpif_netdev_enumerate(struct sset *all_dps)
 186 {
 187     struct shash_node *node;
 188
 189     ovs_mutex_lock(&dp_netdev_mutex);
 190     SHASH_FOR_EACH(node, &dp_netdevs) {
 191         sset_add(all_dps, node->name);
 192     }
 193     ovs_mutex_unlock(&dp_netdev_mutex);
 194
 195     return 0;
 196 }
 197
 198 static bool
 199 dpif_netdev_class_is_dummy(const struct dpif_class *class)
 200 {
 201     return class != &dpif_netdev_class;
 202 }
 203
 204 static bool
 205 dpif_netdev_class_is_planetlab(const struct dpif_class *class)
 206 {
 207     return class == &dpif_planetlab_class;
 208 }
 209
 210 static const char *
 211 dpif_netdev_port_open_type(const struct dpif_class *class, const char *type)
 212 {
 213     return strcmp(type, "internal") ? type
 214                   : dpif_netdev_class_is_planetlab(class) ? "pltap"
 215                   : dpif_netdev_class_is_dummy(class) ? "dummy"
 216                   : "tap";
 217 }
 218
 219 static struct dpif *
 220 create_dpif_netdev(struct dp_netdev *dp)
 221 {
 222     uint16_t netflow_id = hash_string(dp->name, 0);
 223     struct dpif_netdev *dpif;
 224
 225     dp->open_cnt++;
 226
 227     dpif = xmalloc(sizeof *dpif);
 228     dpif_init(&dpif->dpif, dp->class, dp->name, netflow_id >> 8, netflow_id);
 229     dpif->dp = dp;
 230     dpif->last_port_seq = seq_read(dp->port_seq);
 231
 232     return &dpif->dpif;
 233 }
 234
 235 /* Choose an unused, non-zero port number and return it on success.
 236  * Return ODPP_NONE on failure. */
 237 static odp_port_t
 238 choose_port(struct dp_netdev *dp, const char *name)
 239 {
 240     uint32_t port_no;
 241
 242     if (dp->class != &dpif_netdev_class &&
 243         dp->class != &dpif_planetlab_class) {
 244         const char *p;
 245         int start_no = 0;
 246
 247         /* If the port name begins with "br", start the number search at
 248          * 100 to make writing tests easier. */
 249         if (!strncmp(name, "br", 2)) {
 250             start_no = 100;
 251         }
 252
 253         /* If the port name contains a number, try to assign that port number.
 254          * This can make writing unit tests easier because port numbers are
 255          * predictable. */
 256         for (p = name; *p != '\0'; p++) {
 257             if (isdigit((unsigned char) *p)) {
 258                 port_no = start_no + strtol(p, NULL, 10);
 259                 if (port_no > 0 && port_no < MAX_PORTS
 260                     && !dp->ports[port_no]) {
 261                     return u32_to_odp(port_no);
 262                 }
 263                 break;
 264             }
 265         }
 266     }
 267
 268     for (port_no = 1; port_no < MAX_PORTS; port_no++) {
 269         if (!dp->ports[port_no]) {
 270             return u32_to_odp(port_no);
 271         }
 272     }
 273
 274     return ODPP_NONE;
 275 }
 276
 277 static int
 278 create_dp_netdev(const char *name, const struct dpif_class *class,
 279                  struct dp_netdev **dpp)
 280 {
 281     struct dp_netdev *dp;
 282     int error;
 283     int i;
 284
 285     dp = xzalloc(sizeof *dp);
 286     dp->class = class;
 287     dp->name = xstrdup(name);
 288     dp->open_cnt = 0;
 289     dp->max_mtu = ETH_PAYLOAD_MAX;
 290     for (i = 0; i < N_QUEUES; i++) {
 291         dp->queues[i].head = dp->queues[i].tail = 0;
 292     }
 293     dp->queue_seq = seq_create();
 294     hmap_init(&dp->flow_table);
 295     list_init(&dp->port_list);
 296     dp->port_seq = seq_create();
 297
 298     error = do_add_port(dp, name, "internal", ODPP_LOCAL);
 299     if (error) {
 300         dp_netdev_free(dp);
 301         return error;
 302     }
 303
 304     shash_add(&dp_netdevs, name, dp);
 305
 306     *dpp = dp;
 307     return 0;
 308 }
 309
 310 static int
 311 dpif_netdev_open(const struct dpif_class *class, const char *name,
 312                  bool create, struct dpif **dpifp)
 313 {
 314     struct dp_netdev *dp;
 315     int error;
 316
 317     ovs_mutex_lock(&dp_netdev_mutex);
 318     dp = shash_find_data(&dp_netdevs, name);
 319     if (!dp) {
 320         error = create ? create_dp_netdev(name, class, &dp) : ENODEV;
 321     } else {
 322         error = (dp->class != class ? EINVAL
 323                  : create ? EEXIST
 324                  : 0);
 325     }
 326     if (!error) {
 327         *dpifp = create_dpif_netdev(dp);
 328     }
 329     ovs_mutex_unlock(&dp_netdev_mutex);
 330
 331     return error;
 332 }
 333
 334 static void
 335 dp_netdev_purge_queues(struct dp_netdev *dp)
 336 {
 337     int i;
 338
 339     for (i = 0; i < N_QUEUES; i++) {
 340         struct dp_netdev_queue *q = &dp->queues[i];
 341
 342         while (q->tail != q->head) {
 343             struct dp_netdev_upcall *u = &q->upcalls[q->tail++ & QUEUE_MASK];
 344             ofpbuf_uninit(&u->buf);
 345         }
 346     }
 347 }
 348
 349 static void
 350 dp_netdev_free(struct dp_netdev *dp)
 351 {
 352     struct dp_netdev_port *port, *next;
 353
 354     dp_netdev_flow_flush(dp);
 355     LIST_FOR_EACH_SAFE (port, next, node, &dp->port_list) {
 356         do_del_port(dp, port->port_no);
 357     }
 358     dp_netdev_purge_queues(dp);
 359     seq_destroy(dp->queue_seq);
 360     hmap_destroy(&dp->flow_table);
 361     seq_destroy(dp->port_seq);
 362     free(dp->name);
 363     free(dp);
 364 }
 365
 366 static void
 367 dpif_netdev_close(struct dpif *dpif)
 368 {
 369     struct dp_netdev *dp = get_dp_netdev(dpif);
 370
 371     ovs_mutex_lock(&dp_netdev_mutex);
 372
 373     ovs_assert(dp->open_cnt > 0);
 374     if (--dp->open_cnt == 0 && dp->destroyed) {
 375         shash_find_and_delete(&dp_netdevs, dp->name);
 376         dp_netdev_free(dp);
 377     }
 378     free(dpif);
 379
 380     ovs_mutex_unlock(&dp_netdev_mutex);
 381 }
 382
 383 static int
 384 dpif_netdev_destroy(struct dpif *dpif)
 385 {
 386     struct dp_netdev *dp = get_dp_netdev(dpif);
 387
 388     ovs_mutex_lock(&dp_netdev_mutex);
 389     dp->destroyed = true;
 390     ovs_mutex_unlock(&dp_netdev_mutex);
 391
 392     return 0;
 393 }
 394
 395 static int
 396 dpif_netdev_get_stats(const struct dpif *dpif, struct dpif_dp_stats *stats)
 397 {
 398     struct dp_netdev *dp = get_dp_netdev(dpif);
 399
 400     ovs_mutex_lock(&dp_netdev_mutex);
 401     stats->n_flows = hmap_count(&dp->flow_table);
 402     stats->n_hit = dp->n_hit;
 403     stats->n_missed = dp->n_missed;
 404     stats->n_lost = dp->n_lost;
 405     stats->n_masks = UINT64_MAX;
 406     stats->n_mask_hit = UINT64_MAX;
 407     ovs_mutex_unlock(&dp_netdev_mutex);
 408
 409     return 0;
 410 }
 411
 412 static int
 413 do_add_port(struct dp_netdev *dp, const char *devname, const char *type,
 414             odp_port_t port_no)
 415 {
 416     struct netdev_saved_flags *sf;
 417     struct dp_netdev_port *port;
 418     struct netdev *netdev;
 419     struct netdev_rx *rx;
 420     enum netdev_flags flags;
 421     const char *open_type;
 422     int mtu;
 423     int error;
 424
 425     /* XXX reject devices already in some dp_netdev. */
 426
 427     /* Open and validate network device. */
 428     open_type = dpif_netdev_port_open_type(dp->class, type);
 429     error = netdev_open(devname, open_type, &netdev);
 430     if (error) {
 431         return error;
 432     }
 433     /* XXX reject non-Ethernet devices */
 434
 435     netdev_get_flags(netdev, &flags);
 436     if (flags & NETDEV_LOOPBACK) {
 437         VLOG_ERR("%s: cannot add a loopback device", devname);
 438         netdev_close(netdev);
 439         return EINVAL;
 440     }
 441
 442     error = netdev_rx_open(netdev, &rx);
 443     if (error
 444         && !(error == EOPNOTSUPP && dpif_netdev_class_is_dummy(dp->class))) {
 445         VLOG_ERR("%s: cannot receive packets on this network device (%s)",
 446                  devname, ovs_strerror(errno));
 447         netdev_close(netdev);
 448         return error;
 449     }
 450
 451     error = netdev_turn_flags_on(netdev, NETDEV_PROMISC, &sf);
 452     if (error) {
 453         netdev_rx_close(rx);
 454         netdev_close(netdev);
 455         return error;
 456     }
 457
 458     port = xmalloc(sizeof *port);
 459     port->port_no = port_no;
 460     port->netdev = netdev;
 461     port->sf = sf;
 462     port->rx = rx;
 463     port->type = xstrdup(type);
 464
 465     error = netdev_get_mtu(netdev, &mtu);
 466     if (!error && mtu > dp->max_mtu) {
 467         dp->max_mtu = mtu;
 468     }
 469
 470     list_push_back(&dp->port_list, &port->node);
 471     dp->ports[odp_to_u32(port_no)] = port;
 472     seq_change(dp->port_seq);
 473
 474     return 0;
 475 }
 476
 477 static int
 478 dpif_netdev_port_add(struct dpif *dpif, struct netdev *netdev,
 479                      odp_port_t *port_nop)
 480 {
 481     struct dp_netdev *dp = get_dp_netdev(dpif);
 482     char namebuf[NETDEV_VPORT_NAME_BUFSIZE];
 483     const char *dpif_port;
 484     odp_port_t port_no;
 485     int error;
 486
 487     ovs_mutex_lock(&dp_netdev_mutex);
 488     dpif_port = netdev_vport_get_dpif_port(netdev, namebuf, sizeof namebuf);
 489     if (*port_nop != ODPP_NONE) {
 490         uint32_t port_idx = odp_to_u32(*port_nop);
 491         if (port_idx >= MAX_PORTS) {
 492             error = EFBIG;
 493         } else if (dp->ports[port_idx]) {
 494             error = EBUSY;
 495         } else {
 496             error = 0;
 497             port_no = *port_nop;
 498         }
 499     } else {
 500         port_no = choose_port(dp, dpif_port);
 501         error = port_no == ODPP_NONE ? EFBIG : 0;
 502     }
 503     if (!error) {
 504         *port_nop = port_no;
 505         error = do_add_port(dp, dpif_port, netdev_get_type(netdev), port_no);
 506     }
 507     ovs_mutex_unlock(&dp_netdev_mutex);
 508
 509     return error;
 510 }
 511
 512 static int
 513 dpif_netdev_port_del(struct dpif *dpif, odp_port_t port_no)
 514 {
 515     struct dp_netdev *dp = get_dp_netdev(dpif);
 516     int error;
 517
 518     ovs_mutex_lock(&dp_netdev_mutex);
 519     error = port_no == ODPP_LOCAL ? EINVAL : do_del_port(dp, port_no);
 520     ovs_mutex_unlock(&dp_netdev_mutex);
 521
 522     return error;
 523 }
 524
 525 static bool
 526 is_valid_port_number(odp_port_t port_no)
 527 {
 528     return odp_to_u32(port_no) < MAX_PORTS;
 529 }
 530
 531 static int
 532 get_port_by_number(struct dp_netdev *dp,
 533                    odp_port_t port_no, struct dp_netdev_port **portp)
 534 {
 535     if (!is_valid_port_number(port_no)) {
 536         *portp = NULL;
 537         return EINVAL;
 538     } else {
 539         *portp = dp->ports[odp_to_u32(port_no)];
 540         return *portp ? 0 : ENOENT;
 541     }
 542 }
 543
 544 static int
 545 get_port_by_name(struct dp_netdev *dp,
 546                  const char *devname, struct dp_netdev_port **portp)
 547 {
 548     struct dp_netdev_port *port;
 549
 550     LIST_FOR_EACH (port, node, &dp->port_list) {
 551         if (!strcmp(netdev_get_name(port->netdev), devname)) {
 552             *portp = port;
 553             return 0;
 554         }
 555     }
 556     return ENOENT;
 557 }
 558
 559 static int
 560 do_del_port(struct dp_netdev *dp, odp_port_t port_no)
 561 {
 562     struct dp_netdev_port *port;
 563     int error;
 564
 565     error = get_port_by_number(dp, port_no, &port);
 566     if (error) {
 567         return error;
 568     }
 569
 570     list_remove(&port->node);
 571     dp->ports[odp_to_u32(port_no)] = NULL;
 572     seq_change(dp->port_seq);
 573
 574     netdev_close(port->netdev);
 575     netdev_restore_flags(port->sf);
 576     netdev_rx_close(port->rx);
 577     free(port->type);
 578     free(port);
 579
 580     return 0;
 581 }
 582
 583 static void
 584 answer_port_query(const struct dp_netdev_port *port,
 585                   struct dpif_port *dpif_port)
 586 {
 587     dpif_port->name = xstrdup(netdev_get_name(port->netdev));
 588     dpif_port->type = xstrdup(port->type);
 589     dpif_port->port_no = port->port_no;
 590 }
 591
 592 static int
 593 dpif_netdev_port_query_by_number(const struct dpif *dpif, odp_port_t port_no,
 594                                  struct dpif_port *dpif_port)
 595 {
 596     struct dp_netdev *dp = get_dp_netdev(dpif);
 597     struct dp_netdev_port *port;
 598     int error;
 599
 600     ovs_mutex_lock(&dp_netdev_mutex);
 601     error = get_port_by_number(dp, port_no, &port);
 602     if (!error && dpif_port) {
 603         answer_port_query(port, dpif_port);
 604     }
 605     ovs_mutex_unlock(&dp_netdev_mutex);
 606
 607     return error;
 608 }
 609
 610 static int
 611 dpif_netdev_port_query_by_name(const struct dpif *dpif, const char *devname,
 612                                struct dpif_port *dpif_port)
 613 {
 614     struct dp_netdev *dp = get_dp_netdev(dpif);
 615     struct dp_netdev_port *port;
 616     int error;
 617
 618     ovs_mutex_lock(&dp_netdev_mutex);
 619     error = get_port_by_name(dp, devname, &port);
 620     if (!error && dpif_port) {
 621         answer_port_query(port, dpif_port);
 622     }
 623     ovs_mutex_unlock(&dp_netdev_mutex);
 624
 625     return error;
 626 }
 627
 628 static uint32_t
 629 dpif_netdev_get_max_ports(const struct dpif *dpif OVS_UNUSED)
 630 {
 631     return MAX_PORTS;
 632 }
 633
 634 static void
 635 dp_netdev_free_flow(struct dp_netdev *dp, struct dp_netdev_flow *flow)
 636 {
 637     hmap_remove(&dp->flow_table, &flow->node);
 638     free(flow->actions);
 639     free(flow);
 640 }
 641
 642 static void
 643 dp_netdev_flow_flush(struct dp_netdev *dp)
 644 {
 645     struct dp_netdev_flow *flow, *next;
 646
 647     HMAP_FOR_EACH_SAFE (flow, next, node, &dp->flow_table) {
 648         dp_netdev_free_flow(dp, flow);
 649     }
 650 }
 651
 652 static int
 653 dpif_netdev_flow_flush(struct dpif *dpif)
 654 {
 655     struct dp_netdev *dp = get_dp_netdev(dpif);
 656
 657     ovs_mutex_lock(&dp_netdev_mutex);
 658     dp_netdev_flow_flush(dp);
 659     ovs_mutex_unlock(&dp_netdev_mutex);
 660
 661     return 0;
 662 }
 663
 664 struct dp_netdev_port_state {
 665     odp_port_t port_no;
 666     char *name;
 667 };
 668
 669 static int
 670 dpif_netdev_port_dump_start(const struct dpif *dpif OVS_UNUSED, void **statep)
 671 {
 672     *statep = xzalloc(sizeof(struct dp_netdev_port_state));
 673     return 0;
 674 }
 675
 676 static int
 677 dpif_netdev_port_dump_next(const struct dpif *dpif, void *state_,
 678                            struct dpif_port *dpif_port)
 679 {
 680     struct dp_netdev_port_state *state = state_;
 681     struct dp_netdev *dp = get_dp_netdev(dpif);
 682     uint32_t port_idx;
 683
 684     ovs_mutex_lock(&dp_netdev_mutex);
 685     for (port_idx = odp_to_u32(state->port_no);
 686          port_idx < MAX_PORTS; port_idx++) {
 687         struct dp_netdev_port *port = dp->ports[port_idx];
 688         if (port) {
 689             free(state->name);
 690             state->name = xstrdup(netdev_get_name(port->netdev));
 691             dpif_port->name = state->name;
 692             dpif_port->type = port->type;
 693             dpif_port->port_no = port->port_no;
 694             state->port_no = u32_to_odp(port_idx + 1);
 695             ovs_mutex_unlock(&dp_netdev_mutex);
 696
 697             return 0;
 698         }
 699     }
 700     ovs_mutex_unlock(&dp_netdev_mutex);
 701
 702     return EOF;
 703 }
 704
 705 static int
 706 dpif_netdev_port_dump_done(const struct dpif *dpif OVS_UNUSED, void *state_)
 707 {
 708     struct dp_netdev_port_state *state = state_;
 709     free(state->name);
 710     free(state);
 711     return 0;
 712 }
 713
 714 static int
 715 dpif_netdev_port_poll(const struct dpif *dpif_, char **devnamep OVS_UNUSED)
 716 {
 717     struct dpif_netdev *dpif = dpif_netdev_cast(dpif_);
 718     uint64_t new_port_seq;
 719     int error;
 720
 721     ovs_mutex_lock(&dp_netdev_mutex);
 722     new_port_seq = seq_read(dpif->dp->port_seq);
 723     if (dpif->last_port_seq != new_port_seq) {
 724         dpif->last_port_seq = new_port_seq;
 725         error = ENOBUFS;
 726     } else {
 727         error = EAGAIN;
 728     }
 729     ovs_mutex_unlock(&dp_netdev_mutex);
 730
 731     return error;
 732 }
 733
 734 static void
 735 dpif_netdev_port_poll_wait(const struct dpif *dpif_)
 736 {
 737     struct dpif_netdev *dpif = dpif_netdev_cast(dpif_);
 738
 739     ovs_mutex_lock(&dp_netdev_mutex);
 740     seq_wait(dpif->dp->port_seq, dpif->last_port_seq);
 741     ovs_mutex_unlock(&dp_netdev_mutex);
 742 }
 743
 744 static struct dp_netdev_flow *
 745 dp_netdev_lookup_flow(const struct dp_netdev *dp, const struct flow *key)
 746 {
 747     struct dp_netdev_flow *flow;
 748
 749     HMAP_FOR_EACH_WITH_HASH (flow, node, flow_hash(key, 0), &dp->flow_table) {
 750         if (flow_equal(&flow->key, key)) {
 751             return flow;
 752         }
 753     }
 754     return NULL;
 755 }
 756
 757 static void
 758 get_dpif_flow_stats(struct dp_netdev_flow *flow, struct dpif_flow_stats *stats)
 759 {
 760     stats->n_packets = flow->packet_count;
 761     stats->n_bytes = flow->byte_count;
 762     stats->used = flow->used;
 763     stats->tcp_flags = flow->tcp_flags;
 764 }
 765
 766 static int
 767 dpif_netdev_flow_from_nlattrs(const struct nlattr *key, uint32_t key_len,
 768                               struct flow *flow)
 769 {
 770     odp_port_t in_port;
 771
 772     if (odp_flow_key_to_flow(key, key_len, flow) != ODP_FIT_PERFECT) {
 773         /* This should not happen: it indicates that odp_flow_key_from_flow()
 774          * and odp_flow_key_to_flow() disagree on the acceptable form of a
 775          * flow.  Log the problem as an error, with enough details to enable
 776          * debugging. */
 777         static struct vlog_rate_limit rl = VLOG_RATE_LIMIT_INIT(1, 5);
 778
 779         if (!VLOG_DROP_ERR(&rl)) {
 780             struct ds s;
 781
 782             ds_init(&s);
 783             odp_flow_key_format(key, key_len, &s);
 784             VLOG_ERR("internal error parsing flow key %s", ds_cstr(&s));
 785             ds_destroy(&s);
 786         }
 787
 788         return EINVAL;
 789     }
 790
 791     in_port = flow->in_port.odp_port;
 792     if (!is_valid_port_number(in_port) && in_port != ODPP_NONE) {
 793         return EINVAL;
 794     }
 795
 796     return 0;
 797 }
 798
 799 static int
 800 dpif_netdev_flow_get(const struct dpif *dpif,
 801                      const struct nlattr *nl_key, size_t nl_key_len,
 802                      struct ofpbuf **actionsp, struct dpif_flow_stats *stats)
 803 {
 804     struct dp_netdev *dp = get_dp_netdev(dpif);
 805     struct dp_netdev_flow *flow;
 806     struct flow key;
 807     int error;
 808
 809     error = dpif_netdev_flow_from_nlattrs(nl_key, nl_key_len, &key);
 810     if (error) {
 811         return error;
 812     }
 813
 814     ovs_mutex_lock(&dp_netdev_mutex);
 815     flow = dp_netdev_lookup_flow(dp, &key);
 816     if (flow) {
 817         if (stats) {
 818             get_dpif_flow_stats(flow, stats);
 819         }
 820         if (actionsp) {
 821             *actionsp = ofpbuf_clone_data(flow->actions, flow->actions_len);
 822         }
 823     } else {
 824         error = ENOENT;
 825     }
 826     ovs_mutex_unlock(&dp_netdev_mutex);
 827
 828     return error;
 829 }
 830
 831 static int
 832 set_flow_actions(struct dp_netdev_flow *flow,
 833                  const struct nlattr *actions, size_t actions_len)
 834 {
 835     flow->actions = xrealloc(flow->actions, actions_len);
 836     flow->actions_len = actions_len;
 837     memcpy(flow->actions, actions, actions_len);
 838     return 0;
 839 }
 840
 841 static int
 842 dp_netdev_flow_add(struct dp_netdev *dp, const struct flow *key,
 843                    const struct nlattr *actions, size_t actions_len)
 844 {
 845     struct dp_netdev_flow *flow;
 846     int error;
 847
 848     flow = xzalloc(sizeof *flow);
 849     flow->key = *key;
 850
 851     error = set_flow_actions(flow, actions, actions_len);
 852     if (error) {
 853         free(flow);
 854         return error;
 855     }
 856
 857     hmap_insert(&dp->flow_table, &flow->node, flow_hash(&flow->key, 0));
 858     return 0;
 859 }
 860
 861 static void
 862 clear_stats(struct dp_netdev_flow *flow)
 863 {
 864     flow->used = 0;
 865     flow->packet_count = 0;
 866     flow->byte_count = 0;
 867     flow->tcp_flags = 0;
 868 }
 869
 870 static int
 871 dpif_netdev_flow_put(struct dpif *dpif, const struct dpif_flow_put *put)
 872 {
 873     struct dp_netdev *dp = get_dp_netdev(dpif);
 874     struct dp_netdev_flow *flow;
 875     struct flow key;
 876     int error;
 877
 878     error = dpif_netdev_flow_from_nlattrs(put->key, put->key_len, &key);
 879     if (error) {
 880         return error;
 881     }
 882
 883     ovs_mutex_lock(&dp_netdev_mutex);
 884     flow = dp_netdev_lookup_flow(dp, &key);
 885     if (!flow) {
 886         if (put->flags & DPIF_FP_CREATE) {
 887             if (hmap_count(&dp->flow_table) < MAX_FLOWS) {
 888                 if (put->stats) {
 889                     memset(put->stats, 0, sizeof *put->stats);
 890                 }
 891                 error = dp_netdev_flow_add(dp, &key, put->actions,
 892                                            put->actions_len);
 893             } else {
 894                 error = EFBIG;
 895             }
 896         } else {
 897             error = ENOENT;
 898         }
 899     } else {
 900         if (put->flags & DPIF_FP_MODIFY) {
 901             error = set_flow_actions(flow, put->actions, put->actions_len);
 902             if (!error) {
 903                 if (put->stats) {
 904                     get_dpif_flow_stats(flow, put->stats);
 905                 }
 906                 if (put->flags & DPIF_FP_ZERO_STATS) {
 907                     clear_stats(flow);
 908                 }
 909             }
 910         } else {
 911             error = EEXIST;
 912         }
 913     }
 914     ovs_mutex_unlock(&dp_netdev_mutex);
 915
 916     return error;
 917 }
 918
 919 static int
 920 dpif_netdev_flow_del(struct dpif *dpif, const struct dpif_flow_del *del)
 921 {
 922     struct dp_netdev *dp = get_dp_netdev(dpif);
 923     struct dp_netdev_flow *flow;
 924     struct flow key;
 925     int error;
 926
 927     error = dpif_netdev_flow_from_nlattrs(del->key, del->key_len, &key);
 928     if (error) {
 929         return error;
 930     }
 931
 932     ovs_mutex_lock(&dp_netdev_mutex);
 933     flow = dp_netdev_lookup_flow(dp, &key);
 934     if (flow) {
 935         if (del->stats) {
 936             get_dpif_flow_stats(flow, del->stats);
 937         }
 938         dp_netdev_free_flow(dp, flow);
 939     } else {
 940         error = ENOENT;
 941     }
 942     ovs_mutex_unlock(&dp_netdev_mutex);
 943
 944     return error;
 945 }
 946
 947 struct dp_netdev_flow_state {
 948     uint32_t bucket;
 949     uint32_t offset;
 950     struct nlattr *actions;
 951     struct odputil_keybuf keybuf;
 952     struct dpif_flow_stats stats;
 953 };
 954
 955 static int
 956 dpif_netdev_flow_dump_start(const struct dpif *dpif OVS_UNUSED, void **statep)
 957 {
 958     struct dp_netdev_flow_state *state;
 959
 960     *statep = state = xmalloc(sizeof *state);
 961     state->bucket = 0;
 962     state->offset = 0;
 963     state->actions = NULL;
 964     return 0;
 965 }
 966
 967 static int
 968 dpif_netdev_flow_dump_next(const struct dpif *dpif, void *state_,
 969                            const struct nlattr **key, size_t *key_len,
 970                            const struct nlattr **mask, size_t *mask_len,
 971                            const struct nlattr **actions, size_t *actions_len,
 972                            const struct dpif_flow_stats **stats)
 973 {
 974     struct dp_netdev_flow_state *state = state_;
 975     struct dp_netdev *dp = get_dp_netdev(dpif);
 976     struct dp_netdev_flow *flow;
 977     struct hmap_node *node;
 978
 979     ovs_mutex_lock(&dp_netdev_mutex);
 980     node = hmap_at_position(&dp->flow_table, &state->bucket, &state->offset);
 981     if (!node) {
 982         ovs_mutex_unlock(&dp_netdev_mutex);
 983         return EOF;
 984     }
 985
 986     flow = CONTAINER_OF(node, struct dp_netdev_flow, node);
 987
 988     if (key) {
 989         struct ofpbuf buf;
 990
 991         ofpbuf_use_stack(&buf, &state->keybuf, sizeof state->keybuf);
 992         odp_flow_key_from_flow(&buf, &flow->key, flow->key.in_port.odp_port);
 993
 994         *key = buf.data;
 995         *key_len = buf.size;
 996     }
 997
 998     if (mask) {
 999         *mask = NULL;
1000         *mask_len = 0;
1001     }
1002
1003     if (actions) {
1004         free(state->actions);
1005         state->actions = xmemdup(flow->actions, flow->actions_len);
1006
1007         *actions = state->actions;
1008         *actions_len = flow->actions_len;
1009     }
1010
1011     if (stats) {
1012         get_dpif_flow_stats(flow, &state->stats);
1013         *stats = &state->stats;
1014     }
1015
1016     ovs_mutex_unlock(&dp_netdev_mutex);
1017     return 0;
1018 }
1019
1020 static int
1021 dpif_netdev_flow_dump_done(const struct dpif *dpif OVS_UNUSED, void *state_)
1022 {
1023     struct dp_netdev_flow_state *state = state_;
1024
1025     free(state->actions);
1026     free(state);
1027     return 0;
1028 }
1029
1030 static int
1031 dpif_netdev_execute(struct dpif *dpif, const struct dpif_execute *execute)
1032 {
1033     struct dp_netdev *dp = get_dp_netdev(dpif);
1034     struct ofpbuf copy;
1035     struct flow key;
1036     int error;
1037
1038     if (execute->packet->size < ETH_HEADER_LEN ||
1039         execute->packet->size > UINT16_MAX) {
1040         return EINVAL;
1041     }
1042
1043     /* Make a deep copy of 'packet', because we might modify its data. */
1044     ofpbuf_init(&copy, DP_NETDEV_HEADROOM + execute->packet->size);
1045     ofpbuf_reserve(&copy, DP_NETDEV_HEADROOM);
1046     ofpbuf_put(&copy, execute->packet->data, execute->packet->size);
1047
1048     flow_extract(&copy, 0, 0, NULL, NULL, &key);
1049     error = dpif_netdev_flow_from_nlattrs(execute->key, execute->key_len,
1050                                           &key);
1051     if (!error) {
1052         ovs_mutex_lock(&dp_netdev_mutex);
1053         dp_netdev_execute_actions(dp, &copy, &key,
1054                                   execute->actions, execute->actions_len);
1055         ovs_mutex_unlock(&dp_netdev_mutex);
1056     }
1057
1058     ofpbuf_uninit(&copy);
1059     return error;
1060 }
1061
1062 static int
1063 dpif_netdev_recv_set(struct dpif *dpif OVS_UNUSED, bool enable OVS_UNUSED)
1064 {
1065     return 0;
1066 }
1067
1068 static int
1069 dpif_netdev_queue_to_priority(const struct dpif *dpif OVS_UNUSED,
1070                               uint32_t queue_id, uint32_t *priority)
1071 {
1072     *priority = queue_id;
1073     return 0;
1074 }
1075
1076 static struct dp_netdev_queue *
1077 find_nonempty_queue(struct dpif *dpif)
1078 {
1079     struct dp_netdev *dp = get_dp_netdev(dpif);
1080     int i;
1081
1082     for (i = 0; i < N_QUEUES; i++) {
1083         struct dp_netdev_queue *q = &dp->queues[i];
1084         if (q->head != q->tail) {
1085             return q;
1086         }
1087     }
1088     return NULL;
1089 }
1090
1091 static int
1092 dpif_netdev_recv(struct dpif *dpif, struct dpif_upcall *upcall,
1093                  struct ofpbuf *buf)
1094 {
1095     struct dp_netdev_queue *q;
1096     int error;
1097
1098     ovs_mutex_lock(&dp_netdev_mutex);
1099     q = find_nonempty_queue(dpif);
1100     if (q) {
1101         struct dp_netdev_upcall *u = &q->upcalls[q->tail++ & QUEUE_MASK];
1102
1103         *upcall = u->upcall;
1104         upcall->packet = buf;
1105
1106         ofpbuf_uninit(buf);
1107         *buf = u->buf;
1108
1109         error = 0;
1110     } else {
1111         error = EAGAIN;
1112     }
1113     ovs_mutex_unlock(&dp_netdev_mutex);
1114
1115     return error;
1116 }
1117
1118 static void
1119 dpif_netdev_recv_wait(struct dpif *dpif)
1120 {
1121     struct dp_netdev *dp = get_dp_netdev(dpif);
1122     uint64_t seq;
1123
1124     ovs_mutex_lock(&dp_netdev_mutex);
1125     seq = seq_read(dp->queue_seq);
1126     if (find_nonempty_queue(dpif)) {
1127         poll_immediate_wake();
1128     } else {
1129         seq_wait(dp->queue_seq, seq);
1130     }
1131     ovs_mutex_unlock(&dp_netdev_mutex);
1132 }
1133
1134 static void
1135 dpif_netdev_recv_purge(struct dpif *dpif)
1136 {
1137     struct dpif_netdev *dpif_netdev = dpif_netdev_cast(dpif);
1138     ovs_mutex_lock(&dp_netdev_mutex);
1139     dp_netdev_purge_queues(dpif_netdev->dp);
1140     ovs_mutex_unlock(&dp_netdev_mutex);
1141 }
1142 \f
1143 static void
1144 dp_netdev_flow_used(struct dp_netdev_flow *flow, const struct ofpbuf *packet)
1145 {
1146     flow->used = time_msec();
1147     flow->packet_count++;
1148     flow->byte_count += packet->size;
1149     flow->tcp_flags |= packet_get_tcp_flags(packet, &flow->key);
1150 }
1151
1152 static void
1153 dp_netdev_port_input(struct dp_netdev *dp, struct dp_netdev_port *port,
1154                      struct ofpbuf *packet, uint32_t skb_priority,
1155                      uint32_t pkt_mark, const struct flow_tnl *tnl)
1156 {
1157     struct dp_netdev_flow *flow;
1158     struct flow key;
1159     union flow_in_port in_port_;
1160
1161     if (packet->size < ETH_HEADER_LEN) {
1162         return;
1163     }
1164     in_port_.odp_port = port->port_no;
1165     flow_extract(packet, skb_priority, pkt_mark, tnl, &in_port_, &key);
1166     flow = dp_netdev_lookup_flow(dp, &key);
1167     if (flow) {
1168         dp_netdev_flow_used(flow, packet);
1169         dp_netdev_execute_actions(dp, packet, &key,
1170                                   flow->actions, flow->actions_len);
1171         dp->n_hit++;
1172     } else {
1173         dp->n_missed++;
1174         dp_netdev_output_userspace(dp, packet, DPIF_UC_MISS, &key, NULL);
1175     }
1176 }
1177
1178 static void
1179 dpif_netdev_run(struct dpif *dpif)
1180 {
1181     struct dp_netdev_port *port;
1182     struct dp_netdev *dp;
1183     struct ofpbuf packet;
1184
1185     ovs_mutex_lock(&dp_netdev_mutex);
1186     dp = get_dp_netdev(dpif);
1187     ofpbuf_init(&packet,
1188                 DP_NETDEV_HEADROOM + VLAN_ETH_HEADER_LEN + dp->max_mtu);
1189
1190     LIST_FOR_EACH (port, node, &dp->port_list) {
1191         int error;
1192
1193         /* Reset packet contents. */
1194         ofpbuf_clear(&packet);
1195         ofpbuf_reserve(&packet, DP_NETDEV_HEADROOM);
1196
1197         error = port->rx ? netdev_rx_recv(port->rx, &packet) : EOPNOTSUPP;
1198         if (!error) {
1199             dp_netdev_port_input(dp, port, &packet, 0, 0, NULL);
1200         } else if (error != EAGAIN && error != EOPNOTSUPP) {
1201             static struct vlog_rate_limit rl = VLOG_RATE_LIMIT_INIT(1, 5);
1202
1203             VLOG_ERR_RL(&rl, "error receiving data from %s: %s",
1204                         netdev_get_name(port->netdev), ovs_strerror(error));
1205         }
1206     }
1207     ofpbuf_uninit(&packet);
1208     ovs_mutex_unlock(&dp_netdev_mutex);
1209 }
1210
1211 static void
1212 dpif_netdev_wait(struct dpif *dpif)
1213 {
1214     struct dp_netdev_port *port;
1215
1216     /* There is a race here, if thread A calls dpif_netdev_wait(dpif) and
1217      * thread B calls dpif_port_add(dpif) or dpif_port_remove(dpif) before
1218      * A makes it to poll_block().
1219      *
1220      * But I think it doesn't matter:
1221      *
1222      *     - In the dpif_port_add() case, A will not wake up when a packet
1223      *       arrives on the new port, but this would also happen if the
1224      *       ordering were reversed.
1225      *
1226      *     - In the dpif_port_remove() case, A might wake up spuriously, but
1227      *       that is harmless. */
1228
1229     ovs_mutex_lock(&dp_netdev_mutex);
1230     LIST_FOR_EACH (port, node, &get_dp_netdev(dpif)->port_list) {
1231         if (port->rx) {
1232             netdev_rx_wait(port->rx);
1233         }
1234     }
1235     ovs_mutex_unlock(&dp_netdev_mutex);
1236 }
1237
1238 static void
1239 dp_netdev_output_port(void *dp_, struct ofpbuf *packet,
1240                       const struct flow *flow OVS_UNUSED, odp_port_t out_port)
1241 {
1242     struct dp_netdev *dp = dp_;
1243     struct dp_netdev_port *p = dp->ports[odp_to_u32(out_port)];
1244     if (p) {
1245         netdev_send(p->netdev, packet);
1246     }
1247 }
1248
1249 static int
1250 dp_netdev_output_userspace(struct dp_netdev *dp, const struct ofpbuf *packet,
1251                            int queue_no, const struct flow *flow,
1252                            const struct nlattr *userdata)
1253 {
1254     struct dp_netdev_queue *q = &dp->queues[queue_no];
1255     if (q->head - q->tail < MAX_QUEUE_LEN) {
1256         struct dp_netdev_upcall *u = &q->upcalls[q->head++ & QUEUE_MASK];
1257         struct dpif_upcall *upcall = &u->upcall;
1258         struct ofpbuf *buf = &u->buf;
1259         size_t buf_size;
1260
1261         upcall->type = queue_no;
1262
1263         /* Allocate buffer big enough for everything. */
1264         buf_size = ODPUTIL_FLOW_KEY_BYTES + 2 + packet->size;
1265         if (userdata) {
1266             buf_size += NLA_ALIGN(userdata->nla_len);
1267         }
1268         ofpbuf_init(buf, buf_size);
1269
1270         /* Put ODP flow. */
1271         odp_flow_key_from_flow(buf, flow, flow->in_port.odp_port);
1272         upcall->key = buf->data;
1273         upcall->key_len = buf->size;
1274
1275         /* Put userdata. */
1276         if (userdata) {
1277             upcall->userdata = ofpbuf_put(buf, userdata,
1278                                           NLA_ALIGN(userdata->nla_len));
1279         }
1280
1281         /* Put packet.
1282          *
1283          * We adjust 'data' and 'size' in 'buf' so that only the packet itself
1284          * is visible in 'upcall->packet'.  The ODP flow and (if present)
1285          * userdata become part of the headroom. */
1286         ofpbuf_put_zeros(buf, 2);
1287         buf->data = ofpbuf_put(buf, packet->data, packet->size);
1288         buf->size = packet->size;
1289         upcall->packet = buf;
1290
1291         seq_change(dp->queue_seq);
1292
1293         return 0;
1294     } else {
1295         dp->n_lost++;
1296         return ENOBUFS;
1297     }
1298 }
1299
1300 static void
1301 dp_netdev_action_userspace(void *dp, struct ofpbuf *packet,
1302                            const struct flow *key,
1303                            const struct nlattr *a)
1304 {
1305     const struct nlattr *userdata;
1306
1307     userdata = nl_attr_find_nested(a, OVS_USERSPACE_ATTR_USERDATA);
1308     dp_netdev_output_userspace(dp, packet, DPIF_UC_ACTION, key, userdata);
1309 }
1310
1311 static void
1312 dp_netdev_execute_actions(struct dp_netdev *dp,
1313                           struct ofpbuf *packet, struct flow *key,
1314                           const struct nlattr *actions,
1315                           size_t actions_len)
1316 {
1317     odp_execute_actions(dp, packet, key, actions, actions_len,
1318                         dp_netdev_output_port, dp_netdev_action_userspace);
1319 }
1320
1321 #define DPIF_NETDEV_CLASS_FUNCTIONS                     \
1322     dpif_netdev_enumerate,                              \
1323     dpif_netdev_port_open_type,                         \
1324     dpif_netdev_open,                                   \
1325     dpif_netdev_close,                                  \
1326     dpif_netdev_destroy,                                \
1327     dpif_netdev_run,                                    \
1328     dpif_netdev_wait,                                   \
1329     dpif_netdev_get_stats,                              \
1330     dpif_netdev_port_add,                               \
1331     dpif_netdev_port_del,                               \
1332     dpif_netdev_port_query_by_number,                   \
1333     dpif_netdev_port_query_by_name,                     \
1334     dpif_netdev_get_max_ports,                          \
1335     NULL,                       /* port_get_pid */      \
1336     dpif_netdev_port_dump_start,                        \
1337     dpif_netdev_port_dump_next,                         \
1338     dpif_netdev_port_dump_done,                         \
1339     dpif_netdev_port_poll,                              \
1340     dpif_netdev_port_poll_wait,                         \
1341     dpif_netdev_flow_get,                               \
1342     dpif_netdev_flow_put,                               \
1343     dpif_netdev_flow_del,                               \
1344     dpif_netdev_flow_flush,                             \
1345     dpif_netdev_flow_dump_start,                        \
1346     dpif_netdev_flow_dump_next,                         \
1347     dpif_netdev_flow_dump_done,                         \
1348     dpif_netdev_execute,                                \
1349     NULL,                       /* operate */           \
1350     dpif_netdev_recv_set,                               \
1351     dpif_netdev_queue_to_priority,                      \
1352     dpif_netdev_recv,                                   \
1353     dpif_netdev_recv_wait,                              \
1354     dpif_netdev_recv_purge,                             \
1355
1356 const struct dpif_class dpif_netdev_class = {
1357     "netdev",
1358     DPIF_NETDEV_CLASS_FUNCTIONS
1359 };
1360
1361 const struct dpif_class dpif_planetlab_class = {
1362     "planetlab",
1363     DPIF_NETDEV_CLASS_FUNCTIONS
1364 };
1365
1366 static void
1367 dpif_dummy_change_port_number(struct unixctl_conn *conn, int argc OVS_UNUSED,
1368                               const char *argv[], void *aux OVS_UNUSED)
1369 {
1370     struct dp_netdev_port *port;
1371     struct dp_netdev *dp;
1372     int port_no;
1373
1374     dp = shash_find_data(&dp_netdevs, argv[1]);
1375     if (!dp || !dpif_netdev_class_is_dummy(dp->class)) {
1376         unixctl_command_reply_error(conn, "unknown datapath or not a dummy");
1377         return;
1378     }
1379
1380     if (get_port_by_name(dp, argv[2], &port)) {
1381         unixctl_command_reply_error(conn, "unknown port");
1382         return;
1383     }
1384
1385     port_no = atoi(argv[3]);
1386     if (port_no <= 0 || port_no >= MAX_PORTS) {
1387         unixctl_command_reply_error(conn, "bad port number");
1388         return;
1389     }
1390     if (dp->ports[port_no]) {
1391         unixctl_command_reply_error(conn, "port number already in use");
1392         return;
1393     }
1394     dp->ports[odp_to_u32(port->port_no)] = NULL;
1395     dp->ports[port_no] = port;
1396     port->port_no = u32_to_odp(port_no);
1397     seq_change(dp->port_seq);
1398     unixctl_command_reply(conn, NULL);
1399 }
1400
1401 static void
1402 dpif_dummy_register__(const char *type)
1403 {
1404     struct dpif_class *class;
1405
1406     class = xmalloc(sizeof *class);
1407     *class = dpif_netdev_class;
1408     class->type = xstrdup(type);
1409     dp_register_provider(class);
1410 }
1411
1412 void
1413 dpif_dummy_register(bool override)
1414 {
1415     if (override) {
1416         struct sset types;
1417         const char *type;
1418
1419         sset_init(&types);
1420         dp_enumerate_types(&types);
1421         SSET_FOR_EACH (type, &types) {
1422             if (!dp_unregister_provider(type)) {
1423                 dpif_dummy_register__(type);
1424             }
1425         }
1426         sset_destroy(&types);
1427     }
1428
1429     dpif_dummy_register__("dummy");
1430
1431     unixctl_command_register("dpif-dummy/change-port-number",
1432                              "DP PORT NEW-NUMBER",
1433                              3, 3, dpif_dummy_change_port_number, NULL);
1434 }
1435