poll-loop: Port to Windows.
[sliver-openvswitch.git] / lib / dpif-netdev.c
1 /*
2  * Copyright (c) 2009, 2010, 2011, 2012, 2013, 2014 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 "classifier.h"
35 #include "csum.h"
36 #include "dpif.h"
37 #include "dpif-provider.h"
38 #include "dummy.h"
39 #include "dynamic-string.h"
40 #include "flow.h"
41 #include "hmap.h"
42 #include "latch.h"
43 #include "list.h"
44 #include "meta-flow.h"
45 #include "netdev.h"
46 #include "netdev-vport.h"
47 #include "netlink.h"
48 #include "odp-execute.h"
49 #include "odp-util.h"
50 #include "ofp-print.h"
51 #include "ofpbuf.h"
52 #include "packets.h"
53 #include "poll-loop.h"
54 #include "random.h"
55 #include "seq.h"
56 #include "shash.h"
57 #include "sset.h"
58 #include "timeval.h"
59 #include "unixctl.h"
60 #include "util.h"
61 #include "vlog.h"
62
63 VLOG_DEFINE_THIS_MODULE(dpif_netdev);
64
65 /* By default, choose a priority in the middle. */
66 #define NETDEV_RULE_PRIORITY 0x8000
67
68 /* Configuration parameters. */
69 enum { MAX_FLOWS = 65536 };     /* Maximum number of flows in flow table. */
70
71 /* Enough headroom to add a vlan tag, plus an extra 2 bytes to allow IP
72  * headers to be aligned on a 4-byte boundary.  */
73 enum { DP_NETDEV_HEADROOM = 2 + VLAN_HEADER_LEN };
74
75 /* Queues. */
76 enum { N_QUEUES = 2 };          /* Number of queues for dpif_recv(). */
77 enum { MAX_QUEUE_LEN = 128 };   /* Maximum number of packets per queue. */
78 enum { QUEUE_MASK = MAX_QUEUE_LEN - 1 };
79 BUILD_ASSERT_DECL(IS_POW2(MAX_QUEUE_LEN));
80
81 /* Protects against changes to 'dp_netdevs'. */
82 static struct ovs_mutex dp_netdev_mutex = OVS_MUTEX_INITIALIZER;
83
84 /* Contains all 'struct dp_netdev's. */
85 static struct shash dp_netdevs OVS_GUARDED_BY(dp_netdev_mutex)
86     = SHASH_INITIALIZER(&dp_netdevs);
87
88 struct dp_netdev_upcall {
89     struct dpif_upcall upcall;  /* Queued upcall information. */
90     struct ofpbuf buf;          /* ofpbuf instance for upcall.packet. */
91 };
92
93 /* A queue passing packets from a struct dp_netdev to its clients.
94  *
95  *
96  * Thread-safety
97  * =============
98  *
99  * Any access at all requires the owning 'dp_netdev''s queue_mutex. */
100 struct dp_netdev_queue {
101     struct dp_netdev_upcall upcalls[MAX_QUEUE_LEN] OVS_GUARDED;
102     unsigned int head OVS_GUARDED;
103     unsigned int tail OVS_GUARDED;
104 };
105
106 /* Datapath based on the network device interface from netdev.h.
107  *
108  *
109  * Thread-safety
110  * =============
111  *
112  * Some members, marked 'const', are immutable.  Accessing other members
113  * requires synchronization, as noted in more detail below.
114  *
115  * Acquisition order is, from outermost to innermost:
116  *
117  *    dp_netdev_mutex (global)
118  *    port_rwlock
119  *    flow_mutex
120  *    cls.rwlock
121  *    queue_mutex
122  */
123 struct dp_netdev {
124     const struct dpif_class *const class;
125     const char *const name;
126     struct ovs_refcount ref_cnt;
127     atomic_flag destroyed;
128
129     /* Flows.
130      *
131      * Readers of 'cls' and 'flow_table' must take a 'cls->rwlock' read lock.
132      *
133      * Writers of 'cls' and 'flow_table' must take the 'flow_mutex' and then
134      * the 'cls->rwlock' write lock.  (The outer 'flow_mutex' allows writers to
135      * atomically perform multiple operations on 'cls' and 'flow_table'.)
136      */
137     struct ovs_mutex flow_mutex;
138     struct classifier cls;      /* Classifier.  Protected by cls.rwlock. */
139     struct hmap flow_table OVS_GUARDED; /* Flow table. */
140
141     /* Queues.
142      *
143      * Everything in 'queues' is protected by 'queue_mutex'. */
144     struct ovs_mutex queue_mutex;
145     struct dp_netdev_queue queues[N_QUEUES];
146     struct seq *queue_seq;      /* Incremented whenever a packet is queued. */
147
148     /* Statistics.
149      *
150      * ovsthread_counter is internally synchronized. */
151     struct ovsthread_counter *n_hit;    /* Number of flow table matches. */
152     struct ovsthread_counter *n_missed; /* Number of flow table misses. */
153     struct ovsthread_counter *n_lost;   /* Number of misses not passed up. */
154
155     /* Ports.
156      *
157      * Any lookup into 'ports' or any access to the dp_netdev_ports found
158      * through 'ports' requires taking 'port_rwlock'. */
159     struct ovs_rwlock port_rwlock;
160     struct hmap ports OVS_GUARDED;
161     struct seq *port_seq;       /* Incremented whenever a port changes. */
162
163     /* Forwarding threads. */
164     struct latch exit_latch;
165     struct dp_forwarder *forwarders;
166     size_t n_forwarders;
167 };
168
169 static struct dp_netdev_port *dp_netdev_lookup_port(const struct dp_netdev *dp,
170                                                     odp_port_t)
171     OVS_REQ_RDLOCK(dp->port_rwlock);
172
173 /* A port in a netdev-based datapath. */
174 struct dp_netdev_port {
175     struct hmap_node node;      /* Node in dp_netdev's 'ports'. */
176     odp_port_t port_no;
177     struct netdev *netdev;
178     struct netdev_saved_flags *sf;
179     struct netdev_rx *rx;
180     char *type;                 /* Port type as requested by user. */
181 };
182
183 /* A flow in dp_netdev's 'flow_table'.
184  *
185  *
186  * Thread-safety
187  * =============
188  *
189  * Except near the beginning or ending of its lifespan, rule 'rule' belongs to
190  * its dp_netdev's classifier.  The text below calls this classifier 'cls'.
191  *
192  * Motivation
193  * ----------
194  *
195  * The thread safety rules described here for "struct dp_netdev_flow" are
196  * motivated by two goals:
197  *
198  *    - Prevent threads that read members of "struct dp_netdev_flow" from
199  *      reading bad data due to changes by some thread concurrently modifying
200  *      those members.
201  *
202  *    - Prevent two threads making changes to members of a given "struct
203  *      dp_netdev_flow" from interfering with each other.
204  *
205  *
206  * Rules
207  * -----
208  *
209  * A flow 'flow' may be accessed without a risk of being freed by code that
210  * holds a read-lock or write-lock on 'cls->rwlock' or that owns a reference to
211  * 'flow->ref_cnt' (or both).  Code that needs to hold onto a flow for a while
212  * should take 'cls->rwlock', find the flow it needs, increment 'flow->ref_cnt'
213  * with dpif_netdev_flow_ref(), and drop 'cls->rwlock'.
214  *
215  * 'flow->ref_cnt' protects 'flow' from being freed.  It doesn't protect the
216  * flow from being deleted from 'cls' (that's 'cls->rwlock') and it doesn't
217  * protect members of 'flow' from modification (that's 'flow->mutex').
218  *
219  * 'flow->mutex' protects the members of 'flow' from modification.  It doesn't
220  * protect the flow from being deleted from 'cls' (that's 'cls->rwlock') and it
221  * doesn't prevent the flow from being freed (that's 'flow->ref_cnt').
222  *
223  * Some members, marked 'const', are immutable.  Accessing other members
224  * requires synchronization, as noted in more detail below.
225  */
226 struct dp_netdev_flow {
227     /* Packet classification. */
228     const struct cls_rule cr;   /* In owning dp_netdev's 'cls'. */
229
230     /* Hash table index by unmasked flow. */
231     const struct hmap_node node; /* In owning dp_netdev's 'flow_table'. */
232     const struct flow flow;      /* The flow that created this entry. */
233
234     /* Number of references.
235      * The classifier owns one reference.
236      * Any thread trying to keep a rule from being freed should hold its own
237      * reference. */
238     struct ovs_refcount ref_cnt;
239
240     /* Protects members marked OVS_GUARDED.
241      *
242      * Acquire after datapath's flow_mutex. */
243     struct ovs_mutex mutex OVS_ACQ_AFTER(dp_netdev_mutex);
244
245     /* Statistics.
246      *
247      * Reading or writing these members requires 'mutex'. */
248     long long int used OVS_GUARDED; /* Last used time, in monotonic msecs. */
249     long long int packet_count OVS_GUARDED; /* Number of packets matched. */
250     long long int byte_count OVS_GUARDED;   /* Number of bytes matched. */
251     uint16_t tcp_flags OVS_GUARDED; /* Bitwise-OR of seen tcp_flags values. */
252
253     /* Actions.
254      *
255      * Reading 'actions' requires 'mutex'.
256      * Writing 'actions' requires 'mutex' and (to allow for transactions) the
257      * datapath's flow_mutex. */
258     struct dp_netdev_actions *actions OVS_GUARDED;
259 };
260
261 static struct dp_netdev_flow *dp_netdev_flow_ref(
262     const struct dp_netdev_flow *);
263 static void dp_netdev_flow_unref(struct dp_netdev_flow *);
264
265 /* A set of datapath actions within a "struct dp_netdev_flow".
266  *
267  *
268  * Thread-safety
269  * =============
270  *
271  * A struct dp_netdev_actions 'actions' may be accessed without a risk of being
272  * freed by code that holds a read-lock or write-lock on 'flow->mutex' (where
273  * 'flow' is the dp_netdev_flow for which 'flow->actions == actions') or that
274  * owns a reference to 'actions->ref_cnt' (or both). */
275 struct dp_netdev_actions {
276     struct ovs_refcount ref_cnt;
277
278     /* These members are immutable: they do not change during the struct's
279      * lifetime.  */
280     struct nlattr *actions;     /* Sequence of OVS_ACTION_ATTR_* attributes. */
281     unsigned int size;          /* Size of 'actions', in bytes. */
282 };
283
284 struct dp_netdev_actions *dp_netdev_actions_create(const struct nlattr *,
285                                                    size_t);
286 struct dp_netdev_actions *dp_netdev_actions_ref(
287     const struct dp_netdev_actions *);
288 void dp_netdev_actions_unref(struct dp_netdev_actions *);
289
290 /* A thread that receives packets from some ports, looks them up in the flow
291  * table, and executes the actions it finds. */
292 struct dp_forwarder {
293     struct dp_netdev *dp;
294     pthread_t thread;
295     char *name;
296     uint32_t min_hash, max_hash;
297 };
298
299 /* Interface to netdev-based datapath. */
300 struct dpif_netdev {
301     struct dpif dpif;
302     struct dp_netdev *dp;
303     uint64_t last_port_seq;
304 };
305
306 static int get_port_by_number(struct dp_netdev *dp, odp_port_t port_no,
307                               struct dp_netdev_port **portp)
308     OVS_REQ_RDLOCK(dp->port_rwlock);
309 static int get_port_by_name(struct dp_netdev *dp, const char *devname,
310                             struct dp_netdev_port **portp)
311     OVS_REQ_RDLOCK(dp->port_rwlock);
312 static void dp_netdev_free(struct dp_netdev *)
313     OVS_REQUIRES(dp_netdev_mutex);
314 static void dp_netdev_flow_flush(struct dp_netdev *);
315 static int do_add_port(struct dp_netdev *dp, const char *devname,
316                        const char *type, odp_port_t port_no)
317     OVS_REQ_WRLOCK(dp->port_rwlock);
318 static int do_del_port(struct dp_netdev *dp, odp_port_t port_no)
319     OVS_REQ_WRLOCK(dp->port_rwlock);
320 static int dpif_netdev_open(const struct dpif_class *, const char *name,
321                             bool create, struct dpif **);
322 static int dp_netdev_output_userspace(struct dp_netdev *dp, struct ofpbuf *,
323                                     int queue_no, const struct flow *,
324                                     const struct nlattr *userdata)
325     OVS_EXCLUDED(dp->queue_mutex);
326 static void dp_netdev_execute_actions(struct dp_netdev *dp,
327                                       const struct flow *, struct ofpbuf *,
328                                       struct pkt_metadata *,
329                                       const struct nlattr *actions,
330                                       size_t actions_len)
331     OVS_REQ_RDLOCK(dp->port_rwlock);
332 static void dp_netdev_port_input(struct dp_netdev *dp, struct ofpbuf *packet,
333                                  struct pkt_metadata *)
334     OVS_REQ_RDLOCK(dp->port_rwlock);
335 static void dp_netdev_set_threads(struct dp_netdev *, int n);
336
337 static struct dpif_netdev *
338 dpif_netdev_cast(const struct dpif *dpif)
339 {
340     ovs_assert(dpif->dpif_class->open == dpif_netdev_open);
341     return CONTAINER_OF(dpif, struct dpif_netdev, dpif);
342 }
343
344 static struct dp_netdev *
345 get_dp_netdev(const struct dpif *dpif)
346 {
347     return dpif_netdev_cast(dpif)->dp;
348 }
349
350 static int
351 dpif_netdev_enumerate(struct sset *all_dps)
352 {
353     struct shash_node *node;
354
355     ovs_mutex_lock(&dp_netdev_mutex);
356     SHASH_FOR_EACH(node, &dp_netdevs) {
357         sset_add(all_dps, node->name);
358     }
359     ovs_mutex_unlock(&dp_netdev_mutex);
360
361     return 0;
362 }
363
364 static bool
365 dpif_netdev_class_is_dummy(const struct dpif_class *class)
366 {
367     return class != &dpif_netdev_class;
368 }
369
370 static const char *
371 dpif_netdev_port_open_type(const struct dpif_class *class, const char *type)
372 {
373     return strcmp(type, "internal") ? type
374                   : dpif_netdev_class_is_dummy(class) ? "dummy"
375                   : "tap";
376 }
377
378 static struct dpif *
379 create_dpif_netdev(struct dp_netdev *dp)
380 {
381     uint16_t netflow_id = hash_string(dp->name, 0);
382     struct dpif_netdev *dpif;
383
384     ovs_refcount_ref(&dp->ref_cnt);
385
386     dpif = xmalloc(sizeof *dpif);
387     dpif_init(&dpif->dpif, dp->class, dp->name, netflow_id >> 8, netflow_id);
388     dpif->dp = dp;
389     dpif->last_port_seq = seq_read(dp->port_seq);
390
391     return &dpif->dpif;
392 }
393
394 /* Choose an unused, non-zero port number and return it on success.
395  * Return ODPP_NONE on failure. */
396 static odp_port_t
397 choose_port(struct dp_netdev *dp, const char *name)
398     OVS_REQ_RDLOCK(dp->port_rwlock)
399 {
400     uint32_t port_no;
401
402     if (dp->class != &dpif_netdev_class) {
403         const char *p;
404         int start_no = 0;
405
406         /* If the port name begins with "br", start the number search at
407          * 100 to make writing tests easier. */
408         if (!strncmp(name, "br", 2)) {
409             start_no = 100;
410         }
411
412         /* If the port name contains a number, try to assign that port number.
413          * This can make writing unit tests easier because port numbers are
414          * predictable. */
415         for (p = name; *p != '\0'; p++) {
416             if (isdigit((unsigned char) *p)) {
417                 port_no = start_no + strtol(p, NULL, 10);
418                 if (port_no > 0 && port_no != odp_to_u32(ODPP_NONE)
419                     && !dp_netdev_lookup_port(dp, u32_to_odp(port_no))) {
420                     return u32_to_odp(port_no);
421                 }
422                 break;
423             }
424         }
425     }
426
427     for (port_no = 1; port_no <= UINT16_MAX; port_no++) {
428         if (!dp_netdev_lookup_port(dp, u32_to_odp(port_no))) {
429             return u32_to_odp(port_no);
430         }
431     }
432
433     return ODPP_NONE;
434 }
435
436 static int
437 create_dp_netdev(const char *name, const struct dpif_class *class,
438                  struct dp_netdev **dpp)
439     OVS_REQUIRES(dp_netdev_mutex)
440 {
441     struct dp_netdev *dp;
442     int error;
443     int i;
444
445     dp = xzalloc(sizeof *dp);
446     shash_add(&dp_netdevs, name, dp);
447
448     *CONST_CAST(const struct dpif_class **, &dp->class) = class;
449     *CONST_CAST(const char **, &dp->name) = xstrdup(name);
450     ovs_refcount_init(&dp->ref_cnt);
451     atomic_flag_init(&dp->destroyed);
452
453     ovs_mutex_init(&dp->flow_mutex);
454     classifier_init(&dp->cls, NULL);
455     hmap_init(&dp->flow_table);
456
457     ovs_mutex_init(&dp->queue_mutex);
458     ovs_mutex_lock(&dp->queue_mutex);
459     for (i = 0; i < N_QUEUES; i++) {
460         dp->queues[i].head = dp->queues[i].tail = 0;
461     }
462     ovs_mutex_unlock(&dp->queue_mutex);
463     dp->queue_seq = seq_create();
464
465     dp->n_hit = ovsthread_counter_create();
466     dp->n_missed = ovsthread_counter_create();
467     dp->n_lost = ovsthread_counter_create();
468
469     ovs_rwlock_init(&dp->port_rwlock);
470     hmap_init(&dp->ports);
471     dp->port_seq = seq_create();
472     latch_init(&dp->exit_latch);
473
474     ovs_rwlock_wrlock(&dp->port_rwlock);
475     error = do_add_port(dp, name, "internal", ODPP_LOCAL);
476     ovs_rwlock_unlock(&dp->port_rwlock);
477     if (error) {
478         dp_netdev_free(dp);
479         return error;
480     }
481     dp_netdev_set_threads(dp, 2);
482
483     *dpp = dp;
484     return 0;
485 }
486
487 static int
488 dpif_netdev_open(const struct dpif_class *class, const char *name,
489                  bool create, struct dpif **dpifp)
490 {
491     struct dp_netdev *dp;
492     int error;
493
494     ovs_mutex_lock(&dp_netdev_mutex);
495     dp = shash_find_data(&dp_netdevs, name);
496     if (!dp) {
497         error = create ? create_dp_netdev(name, class, &dp) : ENODEV;
498     } else {
499         error = (dp->class != class ? EINVAL
500                  : create ? EEXIST
501                  : 0);
502     }
503     if (!error) {
504         *dpifp = create_dpif_netdev(dp);
505     }
506     ovs_mutex_unlock(&dp_netdev_mutex);
507
508     return error;
509 }
510
511 static void
512 dp_netdev_purge_queues(struct dp_netdev *dp)
513 {
514     int i;
515
516     ovs_mutex_lock(&dp->queue_mutex);
517     for (i = 0; i < N_QUEUES; i++) {
518         struct dp_netdev_queue *q = &dp->queues[i];
519
520         while (q->tail != q->head) {
521             struct dp_netdev_upcall *u = &q->upcalls[q->tail++ & QUEUE_MASK];
522             ofpbuf_uninit(&u->upcall.packet);
523             ofpbuf_uninit(&u->buf);
524         }
525     }
526     ovs_mutex_unlock(&dp->queue_mutex);
527 }
528
529 /* Requires dp_netdev_mutex so that we can't get a new reference to 'dp'
530  * through the 'dp_netdevs' shash while freeing 'dp'. */
531 static void
532 dp_netdev_free(struct dp_netdev *dp)
533     OVS_REQUIRES(dp_netdev_mutex)
534 {
535     struct dp_netdev_port *port, *next;
536
537     shash_find_and_delete(&dp_netdevs, dp->name);
538
539     dp_netdev_set_threads(dp, 0);
540     free(dp->forwarders);
541
542     dp_netdev_flow_flush(dp);
543     ovs_rwlock_wrlock(&dp->port_rwlock);
544     HMAP_FOR_EACH_SAFE (port, next, node, &dp->ports) {
545         do_del_port(dp, port->port_no);
546     }
547     ovs_rwlock_unlock(&dp->port_rwlock);
548     ovsthread_counter_destroy(dp->n_hit);
549     ovsthread_counter_destroy(dp->n_missed);
550     ovsthread_counter_destroy(dp->n_lost);
551
552     dp_netdev_purge_queues(dp);
553     seq_destroy(dp->queue_seq);
554     ovs_mutex_destroy(&dp->queue_mutex);
555
556     classifier_destroy(&dp->cls);
557     hmap_destroy(&dp->flow_table);
558     ovs_mutex_destroy(&dp->flow_mutex);
559     seq_destroy(dp->port_seq);
560     hmap_destroy(&dp->ports);
561     atomic_flag_destroy(&dp->destroyed);
562     ovs_refcount_destroy(&dp->ref_cnt);
563     latch_destroy(&dp->exit_latch);
564     free(CONST_CAST(char *, dp->name));
565     free(dp);
566 }
567
568 static void
569 dp_netdev_unref(struct dp_netdev *dp)
570 {
571     if (dp) {
572         /* Take dp_netdev_mutex so that, if dp->ref_cnt falls to zero, we can't
573          * get a new reference to 'dp' through the 'dp_netdevs' shash. */
574         ovs_mutex_lock(&dp_netdev_mutex);
575         if (ovs_refcount_unref(&dp->ref_cnt) == 1) {
576             dp_netdev_free(dp);
577         }
578         ovs_mutex_unlock(&dp_netdev_mutex);
579     }
580 }
581
582 static void
583 dpif_netdev_close(struct dpif *dpif)
584 {
585     struct dp_netdev *dp = get_dp_netdev(dpif);
586
587     dp_netdev_unref(dp);
588     free(dpif);
589 }
590
591 static int
592 dpif_netdev_destroy(struct dpif *dpif)
593 {
594     struct dp_netdev *dp = get_dp_netdev(dpif);
595
596     if (!atomic_flag_test_and_set(&dp->destroyed)) {
597         if (ovs_refcount_unref(&dp->ref_cnt) == 1) {
598             /* Can't happen: 'dpif' still owns a reference to 'dp'. */
599             OVS_NOT_REACHED();
600         }
601     }
602
603     return 0;
604 }
605
606 static int
607 dpif_netdev_get_stats(const struct dpif *dpif, struct dpif_dp_stats *stats)
608 {
609     struct dp_netdev *dp = get_dp_netdev(dpif);
610
611     fat_rwlock_rdlock(&dp->cls.rwlock);
612     stats->n_flows = hmap_count(&dp->flow_table);
613     fat_rwlock_unlock(&dp->cls.rwlock);
614
615     stats->n_hit = ovsthread_counter_read(dp->n_hit);
616     stats->n_missed = ovsthread_counter_read(dp->n_missed);
617     stats->n_lost = ovsthread_counter_read(dp->n_lost);
618     stats->n_masks = UINT32_MAX;
619     stats->n_mask_hit = UINT64_MAX;
620
621     return 0;
622 }
623
624 static int
625 do_add_port(struct dp_netdev *dp, const char *devname, const char *type,
626             odp_port_t port_no)
627     OVS_REQ_WRLOCK(dp->port_rwlock)
628 {
629     struct netdev_saved_flags *sf;
630     struct dp_netdev_port *port;
631     struct netdev *netdev;
632     struct netdev_rx *rx;
633     enum netdev_flags flags;
634     const char *open_type;
635     int error;
636
637     /* XXX reject devices already in some dp_netdev. */
638
639     /* Open and validate network device. */
640     open_type = dpif_netdev_port_open_type(dp->class, type);
641     error = netdev_open(devname, open_type, &netdev);
642     if (error) {
643         return error;
644     }
645     /* XXX reject non-Ethernet devices */
646
647     netdev_get_flags(netdev, &flags);
648     if (flags & NETDEV_LOOPBACK) {
649         VLOG_ERR("%s: cannot add a loopback device", devname);
650         netdev_close(netdev);
651         return EINVAL;
652     }
653
654     error = netdev_rx_open(netdev, &rx);
655     if (error
656         && !(error == EOPNOTSUPP && dpif_netdev_class_is_dummy(dp->class))) {
657         VLOG_ERR("%s: cannot receive packets on this network device (%s)",
658                  devname, ovs_strerror(errno));
659         netdev_close(netdev);
660         return error;
661     }
662
663     error = netdev_turn_flags_on(netdev, NETDEV_PROMISC, &sf);
664     if (error) {
665         netdev_rx_close(rx);
666         netdev_close(netdev);
667         return error;
668     }
669
670     port = xmalloc(sizeof *port);
671     port->port_no = port_no;
672     port->netdev = netdev;
673     port->sf = sf;
674     port->rx = rx;
675     port->type = xstrdup(type);
676
677     hmap_insert(&dp->ports, &port->node, hash_int(odp_to_u32(port_no), 0));
678     seq_change(dp->port_seq);
679
680     return 0;
681 }
682
683 static int
684 dpif_netdev_port_add(struct dpif *dpif, struct netdev *netdev,
685                      odp_port_t *port_nop)
686 {
687     struct dp_netdev *dp = get_dp_netdev(dpif);
688     char namebuf[NETDEV_VPORT_NAME_BUFSIZE];
689     const char *dpif_port;
690     odp_port_t port_no;
691     int error;
692
693     ovs_rwlock_wrlock(&dp->port_rwlock);
694     dpif_port = netdev_vport_get_dpif_port(netdev, namebuf, sizeof namebuf);
695     if (*port_nop != ODPP_NONE) {
696         port_no = *port_nop;
697         error = dp_netdev_lookup_port(dp, *port_nop) ? EBUSY : 0;
698     } else {
699         port_no = choose_port(dp, dpif_port);
700         error = port_no == ODPP_NONE ? EFBIG : 0;
701     }
702     if (!error) {
703         *port_nop = port_no;
704         error = do_add_port(dp, dpif_port, netdev_get_type(netdev), port_no);
705     }
706     ovs_rwlock_unlock(&dp->port_rwlock);
707
708     return error;
709 }
710
711 static int
712 dpif_netdev_port_del(struct dpif *dpif, odp_port_t port_no)
713 {
714     struct dp_netdev *dp = get_dp_netdev(dpif);
715     int error;
716
717     ovs_rwlock_wrlock(&dp->port_rwlock);
718     error = port_no == ODPP_LOCAL ? EINVAL : do_del_port(dp, port_no);
719     ovs_rwlock_unlock(&dp->port_rwlock);
720
721     return error;
722 }
723
724 static bool
725 is_valid_port_number(odp_port_t port_no)
726 {
727     return port_no != ODPP_NONE;
728 }
729
730 static struct dp_netdev_port *
731 dp_netdev_lookup_port(const struct dp_netdev *dp, odp_port_t port_no)
732     OVS_REQ_RDLOCK(dp->port_rwlock)
733 {
734     struct dp_netdev_port *port;
735
736     HMAP_FOR_EACH_IN_BUCKET (port, node, hash_int(odp_to_u32(port_no), 0),
737                              &dp->ports) {
738         if (port->port_no == port_no) {
739             return port;
740         }
741     }
742     return NULL;
743 }
744
745 static int
746 get_port_by_number(struct dp_netdev *dp,
747                    odp_port_t port_no, struct dp_netdev_port **portp)
748     OVS_REQ_RDLOCK(dp->port_rwlock)
749 {
750     if (!is_valid_port_number(port_no)) {
751         *portp = NULL;
752         return EINVAL;
753     } else {
754         *portp = dp_netdev_lookup_port(dp, port_no);
755         return *portp ? 0 : ENOENT;
756     }
757 }
758
759 static int
760 get_port_by_name(struct dp_netdev *dp,
761                  const char *devname, struct dp_netdev_port **portp)
762     OVS_REQ_RDLOCK(dp->port_rwlock)
763 {
764     struct dp_netdev_port *port;
765
766     HMAP_FOR_EACH (port, node, &dp->ports) {
767         if (!strcmp(netdev_get_name(port->netdev), devname)) {
768             *portp = port;
769             return 0;
770         }
771     }
772     return ENOENT;
773 }
774
775 static int
776 do_del_port(struct dp_netdev *dp, odp_port_t port_no)
777     OVS_REQ_WRLOCK(dp->port_rwlock)
778 {
779     struct dp_netdev_port *port;
780     int error;
781
782     error = get_port_by_number(dp, port_no, &port);
783     if (error) {
784         return error;
785     }
786
787     hmap_remove(&dp->ports, &port->node);
788     seq_change(dp->port_seq);
789
790     netdev_close(port->netdev);
791     netdev_restore_flags(port->sf);
792     netdev_rx_close(port->rx);
793     free(port->type);
794     free(port);
795
796     return 0;
797 }
798
799 static void
800 answer_port_query(const struct dp_netdev_port *port,
801                   struct dpif_port *dpif_port)
802 {
803     dpif_port->name = xstrdup(netdev_get_name(port->netdev));
804     dpif_port->type = xstrdup(port->type);
805     dpif_port->port_no = port->port_no;
806 }
807
808 static int
809 dpif_netdev_port_query_by_number(const struct dpif *dpif, odp_port_t port_no,
810                                  struct dpif_port *dpif_port)
811 {
812     struct dp_netdev *dp = get_dp_netdev(dpif);
813     struct dp_netdev_port *port;
814     int error;
815
816     ovs_rwlock_rdlock(&dp->port_rwlock);
817     error = get_port_by_number(dp, port_no, &port);
818     if (!error && dpif_port) {
819         answer_port_query(port, dpif_port);
820     }
821     ovs_rwlock_unlock(&dp->port_rwlock);
822
823     return error;
824 }
825
826 static int
827 dpif_netdev_port_query_by_name(const struct dpif *dpif, const char *devname,
828                                struct dpif_port *dpif_port)
829 {
830     struct dp_netdev *dp = get_dp_netdev(dpif);
831     struct dp_netdev_port *port;
832     int error;
833
834     ovs_rwlock_rdlock(&dp->port_rwlock);
835     error = get_port_by_name(dp, devname, &port);
836     if (!error && dpif_port) {
837         answer_port_query(port, dpif_port);
838     }
839     ovs_rwlock_unlock(&dp->port_rwlock);
840
841     return error;
842 }
843
844 static void
845 dp_netdev_remove_flow(struct dp_netdev *dp, struct dp_netdev_flow *flow)
846     OVS_REQ_WRLOCK(dp->cls.rwlock)
847     OVS_REQUIRES(dp->flow_mutex)
848 {
849     struct cls_rule *cr = CONST_CAST(struct cls_rule *, &flow->cr);
850     struct hmap_node *node = CONST_CAST(struct hmap_node *, &flow->node);
851
852     classifier_remove(&dp->cls, cr);
853     hmap_remove(&dp->flow_table, node);
854     dp_netdev_flow_unref(flow);
855 }
856
857 static struct dp_netdev_flow *
858 dp_netdev_flow_ref(const struct dp_netdev_flow *flow_)
859 {
860     struct dp_netdev_flow *flow = CONST_CAST(struct dp_netdev_flow *, flow_);
861     if (flow) {
862         ovs_refcount_ref(&flow->ref_cnt);
863     }
864     return flow;
865 }
866
867 static void
868 dp_netdev_flow_unref(struct dp_netdev_flow *flow)
869 {
870     if (flow && ovs_refcount_unref(&flow->ref_cnt) == 1) {
871         cls_rule_destroy(CONST_CAST(struct cls_rule *, &flow->cr));
872         ovs_mutex_lock(&flow->mutex);
873         dp_netdev_actions_unref(flow->actions);
874         ovs_mutex_unlock(&flow->mutex);
875         ovs_mutex_destroy(&flow->mutex);
876         free(flow);
877     }
878 }
879
880 static void
881 dp_netdev_flow_flush(struct dp_netdev *dp)
882 {
883     struct dp_netdev_flow *netdev_flow, *next;
884
885     ovs_mutex_lock(&dp->flow_mutex);
886     fat_rwlock_wrlock(&dp->cls.rwlock);
887     HMAP_FOR_EACH_SAFE (netdev_flow, next, node, &dp->flow_table) {
888         dp_netdev_remove_flow(dp, netdev_flow);
889     }
890     fat_rwlock_unlock(&dp->cls.rwlock);
891     ovs_mutex_unlock(&dp->flow_mutex);
892 }
893
894 static int
895 dpif_netdev_flow_flush(struct dpif *dpif)
896 {
897     struct dp_netdev *dp = get_dp_netdev(dpif);
898
899     dp_netdev_flow_flush(dp);
900     return 0;
901 }
902
903 struct dp_netdev_port_state {
904     uint32_t bucket;
905     uint32_t offset;
906     char *name;
907 };
908
909 static int
910 dpif_netdev_port_dump_start(const struct dpif *dpif OVS_UNUSED, void **statep)
911 {
912     *statep = xzalloc(sizeof(struct dp_netdev_port_state));
913     return 0;
914 }
915
916 static int
917 dpif_netdev_port_dump_next(const struct dpif *dpif, void *state_,
918                            struct dpif_port *dpif_port)
919 {
920     struct dp_netdev_port_state *state = state_;
921     struct dp_netdev *dp = get_dp_netdev(dpif);
922     struct hmap_node *node;
923     int retval;
924
925     ovs_rwlock_rdlock(&dp->port_rwlock);
926     node = hmap_at_position(&dp->ports, &state->bucket, &state->offset);
927     if (node) {
928         struct dp_netdev_port *port;
929
930         port = CONTAINER_OF(node, struct dp_netdev_port, node);
931
932         free(state->name);
933         state->name = xstrdup(netdev_get_name(port->netdev));
934         dpif_port->name = state->name;
935         dpif_port->type = port->type;
936         dpif_port->port_no = port->port_no;
937
938         retval = 0;
939     } else {
940         retval = EOF;
941     }
942     ovs_rwlock_unlock(&dp->port_rwlock);
943
944     return retval;
945 }
946
947 static int
948 dpif_netdev_port_dump_done(const struct dpif *dpif OVS_UNUSED, void *state_)
949 {
950     struct dp_netdev_port_state *state = state_;
951     free(state->name);
952     free(state);
953     return 0;
954 }
955
956 static int
957 dpif_netdev_port_poll(const struct dpif *dpif_, char **devnamep OVS_UNUSED)
958 {
959     struct dpif_netdev *dpif = dpif_netdev_cast(dpif_);
960     uint64_t new_port_seq;
961     int error;
962
963     new_port_seq = seq_read(dpif->dp->port_seq);
964     if (dpif->last_port_seq != new_port_seq) {
965         dpif->last_port_seq = new_port_seq;
966         error = ENOBUFS;
967     } else {
968         error = EAGAIN;
969     }
970
971     return error;
972 }
973
974 static void
975 dpif_netdev_port_poll_wait(const struct dpif *dpif_)
976 {
977     struct dpif_netdev *dpif = dpif_netdev_cast(dpif_);
978
979     seq_wait(dpif->dp->port_seq, dpif->last_port_seq);
980 }
981
982 static struct dp_netdev_flow *
983 dp_netdev_flow_cast(const struct cls_rule *cr)
984 {
985     return cr ? CONTAINER_OF(cr, struct dp_netdev_flow, cr) : NULL;
986 }
987
988 static struct dp_netdev_flow *
989 dp_netdev_lookup_flow(const struct dp_netdev *dp, const struct flow *flow)
990     OVS_EXCLUDED(dp->cls.rwlock)
991 {
992     struct dp_netdev_flow *netdev_flow;
993
994     fat_rwlock_rdlock(&dp->cls.rwlock);
995     netdev_flow = dp_netdev_flow_cast(classifier_lookup(&dp->cls, flow, NULL));
996     dp_netdev_flow_ref(netdev_flow);
997     fat_rwlock_unlock(&dp->cls.rwlock);
998
999     return netdev_flow;
1000 }
1001
1002 static struct dp_netdev_flow *
1003 dp_netdev_find_flow(const struct dp_netdev *dp, const struct flow *flow)
1004     OVS_REQ_RDLOCK(dp->cls.rwlock)
1005 {
1006     struct dp_netdev_flow *netdev_flow;
1007
1008     HMAP_FOR_EACH_WITH_HASH (netdev_flow, node, flow_hash(flow, 0),
1009                              &dp->flow_table) {
1010         if (flow_equal(&netdev_flow->flow, flow)) {
1011             return dp_netdev_flow_ref(netdev_flow);
1012         }
1013     }
1014
1015     return NULL;
1016 }
1017
1018 static void
1019 get_dpif_flow_stats(struct dp_netdev_flow *netdev_flow,
1020                     struct dpif_flow_stats *stats)
1021     OVS_REQ_RDLOCK(netdev_flow->mutex)
1022 {
1023     stats->n_packets = netdev_flow->packet_count;
1024     stats->n_bytes = netdev_flow->byte_count;
1025     stats->used = netdev_flow->used;
1026     stats->tcp_flags = netdev_flow->tcp_flags;
1027 }
1028
1029 static int
1030 dpif_netdev_mask_from_nlattrs(const struct nlattr *key, uint32_t key_len,
1031                               const struct nlattr *mask_key,
1032                               uint32_t mask_key_len, const struct flow *flow,
1033                               struct flow *mask)
1034 {
1035     if (mask_key_len) {
1036         if (odp_flow_key_to_mask(mask_key, mask_key_len, mask, flow)) {
1037             /* This should not happen: it indicates that
1038              * odp_flow_key_from_mask() and odp_flow_key_to_mask()
1039              * disagree on the acceptable form of a mask.  Log the problem
1040              * as an error, with enough details to enable debugging. */
1041             static struct vlog_rate_limit rl = VLOG_RATE_LIMIT_INIT(1, 5);
1042
1043             if (!VLOG_DROP_ERR(&rl)) {
1044                 struct ds s;
1045
1046                 ds_init(&s);
1047                 odp_flow_format(key, key_len, mask_key, mask_key_len, NULL, &s,
1048                                 true);
1049                 VLOG_ERR("internal error parsing flow mask %s", ds_cstr(&s));
1050                 ds_destroy(&s);
1051             }
1052
1053             return EINVAL;
1054         }
1055         /* Force unwildcard the in_port. */
1056         mask->in_port.odp_port = u32_to_odp(UINT32_MAX);
1057     } else {
1058         enum mf_field_id id;
1059         /* No mask key, unwildcard everything except fields whose
1060          * prerequisities are not met. */
1061         memset(mask, 0x0, sizeof *mask);
1062
1063         for (id = 0; id < MFF_N_IDS; ++id) {
1064             /* Skip registers and metadata. */
1065             if (!(id >= MFF_REG0 && id < MFF_REG0 + FLOW_N_REGS)
1066                 && id != MFF_METADATA) {
1067                 const struct mf_field *mf = mf_from_id(id);
1068                 if (mf_are_prereqs_ok(mf, flow)) {
1069                     mf_mask_field(mf, mask);
1070                 }
1071             }
1072         }
1073     }
1074
1075     return 0;
1076 }
1077
1078 static int
1079 dpif_netdev_flow_from_nlattrs(const struct nlattr *key, uint32_t key_len,
1080                               struct flow *flow)
1081 {
1082     odp_port_t in_port;
1083
1084     if (odp_flow_key_to_flow(key, key_len, flow)) {
1085         /* This should not happen: it indicates that odp_flow_key_from_flow()
1086          * and odp_flow_key_to_flow() disagree on the acceptable form of a
1087          * flow.  Log the problem as an error, with enough details to enable
1088          * debugging. */
1089         static struct vlog_rate_limit rl = VLOG_RATE_LIMIT_INIT(1, 5);
1090
1091         if (!VLOG_DROP_ERR(&rl)) {
1092             struct ds s;
1093
1094             ds_init(&s);
1095             odp_flow_format(key, key_len, NULL, 0, NULL, &s, true);
1096             VLOG_ERR("internal error parsing flow key %s", ds_cstr(&s));
1097             ds_destroy(&s);
1098         }
1099
1100         return EINVAL;
1101     }
1102
1103     in_port = flow->in_port.odp_port;
1104     if (!is_valid_port_number(in_port) && in_port != ODPP_NONE) {
1105         return EINVAL;
1106     }
1107
1108     return 0;
1109 }
1110
1111 static int
1112 dpif_netdev_flow_get(const struct dpif *dpif,
1113                      const struct nlattr *nl_key, size_t nl_key_len,
1114                      struct ofpbuf **actionsp, struct dpif_flow_stats *stats)
1115 {
1116     struct dp_netdev *dp = get_dp_netdev(dpif);
1117     struct dp_netdev_flow *netdev_flow;
1118     struct flow key;
1119     int error;
1120
1121     error = dpif_netdev_flow_from_nlattrs(nl_key, nl_key_len, &key);
1122     if (error) {
1123         return error;
1124     }
1125
1126     fat_rwlock_rdlock(&dp->cls.rwlock);
1127     netdev_flow = dp_netdev_find_flow(dp, &key);
1128     fat_rwlock_unlock(&dp->cls.rwlock);
1129
1130     if (netdev_flow) {
1131         struct dp_netdev_actions *actions = NULL;
1132
1133         ovs_mutex_lock(&netdev_flow->mutex);
1134         if (stats) {
1135             get_dpif_flow_stats(netdev_flow, stats);
1136         }
1137         if (actionsp) {
1138             actions = dp_netdev_actions_ref(netdev_flow->actions);
1139         }
1140         ovs_mutex_unlock(&netdev_flow->mutex);
1141
1142         dp_netdev_flow_unref(netdev_flow);
1143
1144         if (actionsp) {
1145             *actionsp = ofpbuf_clone_data(actions->actions, actions->size);
1146             dp_netdev_actions_unref(actions);
1147         }
1148     } else {
1149         error = ENOENT;
1150     }
1151
1152     return error;
1153 }
1154
1155 static int
1156 dp_netdev_flow_add(struct dp_netdev *dp, const struct flow *flow,
1157                    const struct flow_wildcards *wc,
1158                    const struct nlattr *actions,
1159                    size_t actions_len)
1160     OVS_REQUIRES(dp->flow_mutex)
1161 {
1162     struct dp_netdev_flow *netdev_flow;
1163     struct match match;
1164
1165     netdev_flow = xzalloc(sizeof *netdev_flow);
1166     *CONST_CAST(struct flow *, &netdev_flow->flow) = *flow;
1167     ovs_refcount_init(&netdev_flow->ref_cnt);
1168
1169     ovs_mutex_init(&netdev_flow->mutex);
1170     ovs_mutex_lock(&netdev_flow->mutex);
1171
1172     netdev_flow->actions = dp_netdev_actions_create(actions, actions_len);
1173
1174     match_init(&match, flow, wc);
1175     cls_rule_init(CONST_CAST(struct cls_rule *, &netdev_flow->cr),
1176                   &match, NETDEV_RULE_PRIORITY);
1177     fat_rwlock_wrlock(&dp->cls.rwlock);
1178     classifier_insert(&dp->cls,
1179                       CONST_CAST(struct cls_rule *, &netdev_flow->cr));
1180     hmap_insert(&dp->flow_table,
1181                 CONST_CAST(struct hmap_node *, &netdev_flow->node),
1182                 flow_hash(flow, 0));
1183     fat_rwlock_unlock(&dp->cls.rwlock);
1184
1185     ovs_mutex_unlock(&netdev_flow->mutex);
1186
1187     return 0;
1188 }
1189
1190 static void
1191 clear_stats(struct dp_netdev_flow *netdev_flow)
1192     OVS_REQUIRES(netdev_flow->mutex)
1193 {
1194     netdev_flow->used = 0;
1195     netdev_flow->packet_count = 0;
1196     netdev_flow->byte_count = 0;
1197     netdev_flow->tcp_flags = 0;
1198 }
1199
1200 static int
1201 dpif_netdev_flow_put(struct dpif *dpif, const struct dpif_flow_put *put)
1202 {
1203     struct dp_netdev *dp = get_dp_netdev(dpif);
1204     struct dp_netdev_flow *netdev_flow;
1205     struct flow flow;
1206     struct flow_wildcards wc;
1207     int error;
1208
1209     error = dpif_netdev_flow_from_nlattrs(put->key, put->key_len, &flow);
1210     if (error) {
1211         return error;
1212     }
1213     error = dpif_netdev_mask_from_nlattrs(put->key, put->key_len,
1214                                           put->mask, put->mask_len,
1215                                           &flow, &wc.masks);
1216     if (error) {
1217         return error;
1218     }
1219
1220     ovs_mutex_lock(&dp->flow_mutex);
1221     netdev_flow = dp_netdev_lookup_flow(dp, &flow);
1222     if (!netdev_flow) {
1223         if (put->flags & DPIF_FP_CREATE) {
1224             if (hmap_count(&dp->flow_table) < MAX_FLOWS) {
1225                 if (put->stats) {
1226                     memset(put->stats, 0, sizeof *put->stats);
1227                 }
1228                 error = dp_netdev_flow_add(dp, &flow, &wc, put->actions,
1229                                            put->actions_len);
1230             } else {
1231                 error = EFBIG;
1232             }
1233         } else {
1234             error = ENOENT;
1235         }
1236     } else {
1237         if (put->flags & DPIF_FP_MODIFY
1238             && flow_equal(&flow, &netdev_flow->flow)) {
1239             struct dp_netdev_actions *new_actions;
1240             struct dp_netdev_actions *old_actions;
1241
1242             new_actions = dp_netdev_actions_create(put->actions,
1243                                                    put->actions_len);
1244
1245             ovs_mutex_lock(&netdev_flow->mutex);
1246             old_actions = netdev_flow->actions;
1247             netdev_flow->actions = new_actions;
1248             if (put->stats) {
1249                 get_dpif_flow_stats(netdev_flow, put->stats);
1250             }
1251             if (put->flags & DPIF_FP_ZERO_STATS) {
1252                 clear_stats(netdev_flow);
1253             }
1254             ovs_mutex_unlock(&netdev_flow->mutex);
1255
1256             dp_netdev_actions_unref(old_actions);
1257         } else if (put->flags & DPIF_FP_CREATE) {
1258             error = EEXIST;
1259         } else {
1260             /* Overlapping flow. */
1261             error = EINVAL;
1262         }
1263         dp_netdev_flow_unref(netdev_flow);
1264     }
1265     ovs_mutex_unlock(&dp->flow_mutex);
1266
1267     return error;
1268 }
1269
1270 static int
1271 dpif_netdev_flow_del(struct dpif *dpif, const struct dpif_flow_del *del)
1272 {
1273     struct dp_netdev *dp = get_dp_netdev(dpif);
1274     struct dp_netdev_flow *netdev_flow;
1275     struct flow key;
1276     int error;
1277
1278     error = dpif_netdev_flow_from_nlattrs(del->key, del->key_len, &key);
1279     if (error) {
1280         return error;
1281     }
1282
1283     ovs_mutex_lock(&dp->flow_mutex);
1284     fat_rwlock_wrlock(&dp->cls.rwlock);
1285     netdev_flow = dp_netdev_find_flow(dp, &key);
1286     if (netdev_flow) {
1287         if (del->stats) {
1288             ovs_mutex_lock(&netdev_flow->mutex);
1289             get_dpif_flow_stats(netdev_flow, del->stats);
1290             ovs_mutex_unlock(&netdev_flow->mutex);
1291         }
1292         dp_netdev_remove_flow(dp, netdev_flow);
1293     } else {
1294         error = ENOENT;
1295     }
1296     fat_rwlock_unlock(&dp->cls.rwlock);
1297     ovs_mutex_unlock(&dp->flow_mutex);
1298
1299     return error;
1300 }
1301
1302 struct dp_netdev_flow_state {
1303     uint32_t bucket;
1304     uint32_t offset;
1305     struct dp_netdev_actions *actions;
1306     struct odputil_keybuf keybuf;
1307     struct odputil_keybuf maskbuf;
1308     struct dpif_flow_stats stats;
1309 };
1310
1311 static int
1312 dpif_netdev_flow_dump_start(const struct dpif *dpif OVS_UNUSED, void **statep)
1313 {
1314     struct dp_netdev_flow_state *state;
1315
1316     *statep = state = xmalloc(sizeof *state);
1317     state->bucket = 0;
1318     state->offset = 0;
1319     state->actions = NULL;
1320     return 0;
1321 }
1322
1323 static int
1324 dpif_netdev_flow_dump_next(const struct dpif *dpif, void *state_,
1325                            const struct nlattr **key, size_t *key_len,
1326                            const struct nlattr **mask, size_t *mask_len,
1327                            const struct nlattr **actions, size_t *actions_len,
1328                            const struct dpif_flow_stats **stats)
1329 {
1330     struct dp_netdev_flow_state *state = state_;
1331     struct dp_netdev *dp = get_dp_netdev(dpif);
1332     struct dp_netdev_flow *netdev_flow;
1333     struct hmap_node *node;
1334
1335     fat_rwlock_rdlock(&dp->cls.rwlock);
1336     node = hmap_at_position(&dp->flow_table, &state->bucket, &state->offset);
1337     if (node) {
1338         netdev_flow = CONTAINER_OF(node, struct dp_netdev_flow, node);
1339         dp_netdev_flow_ref(netdev_flow);
1340     }
1341     fat_rwlock_unlock(&dp->cls.rwlock);
1342     if (!node) {
1343         return EOF;
1344     }
1345
1346     if (key) {
1347         struct ofpbuf buf;
1348
1349         ofpbuf_use_stack(&buf, &state->keybuf, sizeof state->keybuf);
1350         odp_flow_key_from_flow(&buf, &netdev_flow->flow,
1351                                netdev_flow->flow.in_port.odp_port);
1352
1353         *key = buf.data;
1354         *key_len = buf.size;
1355     }
1356
1357     if (key && mask) {
1358         struct ofpbuf buf;
1359         struct flow_wildcards wc;
1360
1361         ofpbuf_use_stack(&buf, &state->maskbuf, sizeof state->maskbuf);
1362         minimask_expand(&netdev_flow->cr.match.mask, &wc);
1363         odp_flow_key_from_mask(&buf, &wc.masks, &netdev_flow->flow,
1364                                odp_to_u32(wc.masks.in_port.odp_port));
1365
1366         *mask = buf.data;
1367         *mask_len = buf.size;
1368     }
1369
1370     if (actions || stats) {
1371         dp_netdev_actions_unref(state->actions);
1372         state->actions = NULL;
1373
1374         ovs_mutex_lock(&netdev_flow->mutex);
1375         if (actions) {
1376             state->actions = dp_netdev_actions_ref(netdev_flow->actions);
1377             *actions = state->actions->actions;
1378             *actions_len = state->actions->size;
1379         }
1380         if (stats) {
1381             get_dpif_flow_stats(netdev_flow, &state->stats);
1382             *stats = &state->stats;
1383         }
1384         ovs_mutex_unlock(&netdev_flow->mutex);
1385     }
1386
1387     dp_netdev_flow_unref(netdev_flow);
1388
1389     return 0;
1390 }
1391
1392 static int
1393 dpif_netdev_flow_dump_done(const struct dpif *dpif OVS_UNUSED, void *state_)
1394 {
1395     struct dp_netdev_flow_state *state = state_;
1396
1397     dp_netdev_actions_unref(state->actions);
1398     free(state);
1399     return 0;
1400 }
1401
1402 static int
1403 dpif_netdev_execute(struct dpif *dpif, struct dpif_execute *execute)
1404 {
1405     struct dp_netdev *dp = get_dp_netdev(dpif);
1406     struct pkt_metadata *md = &execute->md;
1407     struct flow key;
1408
1409     if (execute->packet->size < ETH_HEADER_LEN ||
1410         execute->packet->size > UINT16_MAX) {
1411         return EINVAL;
1412     }
1413
1414     /* Extract flow key. */
1415     flow_extract(execute->packet, md->skb_priority, md->pkt_mark, &md->tunnel,
1416                  (union flow_in_port *)&md->in_port, &key);
1417
1418     ovs_rwlock_rdlock(&dp->port_rwlock);
1419     dp_netdev_execute_actions(dp, &key, execute->packet, md, execute->actions,
1420                               execute->actions_len);
1421     ovs_rwlock_unlock(&dp->port_rwlock);
1422
1423     return 0;
1424 }
1425
1426 static int
1427 dpif_netdev_recv_set(struct dpif *dpif OVS_UNUSED, bool enable OVS_UNUSED)
1428 {
1429     return 0;
1430 }
1431
1432 static int
1433 dpif_netdev_queue_to_priority(const struct dpif *dpif OVS_UNUSED,
1434                               uint32_t queue_id, uint32_t *priority)
1435 {
1436     *priority = queue_id;
1437     return 0;
1438 }
1439
1440 static struct dp_netdev_queue *
1441 find_nonempty_queue(struct dp_netdev *dp)
1442     OVS_REQUIRES(dp->queue_mutex)
1443 {
1444     int i;
1445
1446     for (i = 0; i < N_QUEUES; i++) {
1447         struct dp_netdev_queue *q = &dp->queues[i];
1448         if (q->head != q->tail) {
1449             return q;
1450         }
1451     }
1452     return NULL;
1453 }
1454
1455 static int
1456 dpif_netdev_recv(struct dpif *dpif, struct dpif_upcall *upcall,
1457                  struct ofpbuf *buf)
1458 {
1459     struct dp_netdev *dp = get_dp_netdev(dpif);
1460     struct dp_netdev_queue *q;
1461     int error;
1462
1463     ovs_mutex_lock(&dp->queue_mutex);
1464     q = find_nonempty_queue(dp);
1465     if (q) {
1466         struct dp_netdev_upcall *u = &q->upcalls[q->tail++ & QUEUE_MASK];
1467
1468         *upcall = u->upcall;
1469
1470         ofpbuf_uninit(buf);
1471         *buf = u->buf;
1472
1473         error = 0;
1474     } else {
1475         error = EAGAIN;
1476     }
1477     ovs_mutex_unlock(&dp->queue_mutex);
1478
1479     return error;
1480 }
1481
1482 static void
1483 dpif_netdev_recv_wait(struct dpif *dpif)
1484 {
1485     struct dp_netdev *dp = get_dp_netdev(dpif);
1486     uint64_t seq;
1487
1488     ovs_mutex_lock(&dp->queue_mutex);
1489     seq = seq_read(dp->queue_seq);
1490     if (find_nonempty_queue(dp)) {
1491         poll_immediate_wake();
1492     } else {
1493         seq_wait(dp->queue_seq, seq);
1494     }
1495     ovs_mutex_unlock(&dp->queue_mutex);
1496 }
1497
1498 static void
1499 dpif_netdev_recv_purge(struct dpif *dpif)
1500 {
1501     struct dpif_netdev *dpif_netdev = dpif_netdev_cast(dpif);
1502
1503     dp_netdev_purge_queues(dpif_netdev->dp);
1504 }
1505 \f
1506 /* Creates and returns a new 'struct dp_netdev_actions', with a reference count
1507  * of 1, whose actions are a copy of from the 'ofpacts_len' bytes of
1508  * 'ofpacts'. */
1509 struct dp_netdev_actions *
1510 dp_netdev_actions_create(const struct nlattr *actions, size_t size)
1511 {
1512     struct dp_netdev_actions *netdev_actions;
1513
1514     netdev_actions = xmalloc(sizeof *netdev_actions);
1515     ovs_refcount_init(&netdev_actions->ref_cnt);
1516     netdev_actions->actions = xmemdup(actions, size);
1517     netdev_actions->size = size;
1518
1519     return netdev_actions;
1520 }
1521
1522 /* Increments 'actions''s refcount. */
1523 struct dp_netdev_actions *
1524 dp_netdev_actions_ref(const struct dp_netdev_actions *actions_)
1525 {
1526     struct dp_netdev_actions *actions;
1527
1528     actions = CONST_CAST(struct dp_netdev_actions *, actions_);
1529     if (actions) {
1530         ovs_refcount_ref(&actions->ref_cnt);
1531     }
1532     return actions;
1533 }
1534
1535 /* Decrements 'actions''s refcount and frees 'actions' if the refcount reaches
1536  * 0. */
1537 void
1538 dp_netdev_actions_unref(struct dp_netdev_actions *actions)
1539 {
1540     if (actions && ovs_refcount_unref(&actions->ref_cnt) == 1) {
1541         free(actions->actions);
1542         free(actions);
1543     }
1544 }
1545 \f
1546 static void *
1547 dp_forwarder_main(void *f_)
1548 {
1549     struct dp_forwarder *f = f_;
1550     struct dp_netdev *dp = f->dp;
1551     struct ofpbuf packet;
1552
1553     f->name = xasprintf("forwarder_%u", ovsthread_id_self());
1554     set_subprogram_name("%s", f->name);
1555
1556     ofpbuf_init(&packet, 0);
1557     while (!latch_is_set(&dp->exit_latch)) {
1558         bool received_anything;
1559         int i;
1560
1561         ovs_rwlock_rdlock(&dp->port_rwlock);
1562         for (i = 0; i < 50; i++) {
1563             struct dp_netdev_port *port;
1564
1565             received_anything = false;
1566             HMAP_FOR_EACH (port, node, &f->dp->ports) {
1567                 if (port->rx
1568                     && port->node.hash >= f->min_hash
1569                     && port->node.hash <= f->max_hash) {
1570                     int buf_size;
1571                     int error;
1572                     int mtu;
1573
1574                     if (netdev_get_mtu(port->netdev, &mtu)) {
1575                         mtu = ETH_PAYLOAD_MAX;
1576                     }
1577                     buf_size = DP_NETDEV_HEADROOM + VLAN_ETH_HEADER_LEN + mtu;
1578
1579                     ofpbuf_clear(&packet);
1580                     ofpbuf_reserve_with_tailroom(&packet, DP_NETDEV_HEADROOM,
1581                                                  buf_size);
1582
1583                     error = netdev_rx_recv(port->rx, &packet);
1584                     if (!error) {
1585                         struct pkt_metadata md
1586                             = PKT_METADATA_INITIALIZER(port->port_no);
1587                         dp_netdev_port_input(dp, &packet, &md);
1588
1589                         received_anything = true;
1590                     } else if (error != EAGAIN && error != EOPNOTSUPP) {
1591                         static struct vlog_rate_limit rl
1592                             = VLOG_RATE_LIMIT_INIT(1, 5);
1593
1594                         VLOG_ERR_RL(&rl, "error receiving data from %s: %s",
1595                                     netdev_get_name(port->netdev),
1596                                     ovs_strerror(error));
1597                     }
1598                 }
1599             }
1600
1601             if (!received_anything) {
1602                 break;
1603             }
1604         }
1605
1606         if (received_anything) {
1607             poll_immediate_wake();
1608         } else {
1609             struct dp_netdev_port *port;
1610
1611             HMAP_FOR_EACH (port, node, &f->dp->ports)
1612                 if (port->rx
1613                     && port->node.hash >= f->min_hash
1614                     && port->node.hash <= f->max_hash) {
1615                     netdev_rx_wait(port->rx);
1616                 }
1617             seq_wait(dp->port_seq, seq_read(dp->port_seq));
1618             latch_wait(&dp->exit_latch);
1619         }
1620         ovs_rwlock_unlock(&dp->port_rwlock);
1621
1622         poll_block();
1623     }
1624     ofpbuf_uninit(&packet);
1625
1626     free(f->name);
1627
1628     return NULL;
1629 }
1630
1631 static void
1632 dp_netdev_set_threads(struct dp_netdev *dp, int n)
1633 {
1634     int i;
1635
1636     if (n == dp->n_forwarders) {
1637         return;
1638     }
1639
1640     /* Stop existing threads. */
1641     latch_set(&dp->exit_latch);
1642     for (i = 0; i < dp->n_forwarders; i++) {
1643         struct dp_forwarder *f = &dp->forwarders[i];
1644
1645         xpthread_join(f->thread, NULL);
1646     }
1647     latch_poll(&dp->exit_latch);
1648     free(dp->forwarders);
1649
1650     /* Start new threads. */
1651     dp->forwarders = xmalloc(n * sizeof *dp->forwarders);
1652     dp->n_forwarders = n;
1653     for (i = 0; i < n; i++) {
1654         struct dp_forwarder *f = &dp->forwarders[i];
1655
1656         f->dp = dp;
1657         f->min_hash = UINT32_MAX / n * i;
1658         f->max_hash = UINT32_MAX / n * (i + 1) - 1;
1659         if (i == n - 1) {
1660             f->max_hash = UINT32_MAX;
1661         }
1662         xpthread_create(&f->thread, NULL, dp_forwarder_main, f);
1663     }
1664 }
1665 \f
1666 static void
1667 dp_netdev_flow_used(struct dp_netdev_flow *netdev_flow,
1668                     const struct ofpbuf *packet)
1669     OVS_REQUIRES(netdev_flow->mutex)
1670 {
1671     netdev_flow->used = time_msec();
1672     netdev_flow->packet_count++;
1673     netdev_flow->byte_count += packet->size;
1674     netdev_flow->tcp_flags |= packet_get_tcp_flags(packet, &netdev_flow->flow);
1675 }
1676
1677 static void
1678 dp_netdev_port_input(struct dp_netdev *dp, struct ofpbuf *packet,
1679                      struct pkt_metadata *md)
1680     OVS_REQ_RDLOCK(dp->port_rwlock)
1681 {
1682     struct dp_netdev_flow *netdev_flow;
1683     struct flow key;
1684
1685     if (packet->size < ETH_HEADER_LEN) {
1686         return;
1687     }
1688     flow_extract(packet, md->skb_priority, md->pkt_mark, &md->tunnel,
1689                  (union flow_in_port *)&md->in_port, &key);
1690     netdev_flow = dp_netdev_lookup_flow(dp, &key);
1691     if (netdev_flow) {
1692         struct dp_netdev_actions *actions;
1693
1694         ovs_mutex_lock(&netdev_flow->mutex);
1695         dp_netdev_flow_used(netdev_flow, packet);
1696         actions = dp_netdev_actions_ref(netdev_flow->actions);
1697         ovs_mutex_unlock(&netdev_flow->mutex);
1698
1699         dp_netdev_execute_actions(dp, &key, packet, md,
1700                                   actions->actions, actions->size);
1701         dp_netdev_actions_unref(actions);
1702         ovsthread_counter_inc(dp->n_hit, 1);
1703     } else {
1704         ovsthread_counter_inc(dp->n_missed, 1);
1705         dp_netdev_output_userspace(dp, packet, DPIF_UC_MISS, &key, NULL);
1706     }
1707 }
1708
1709 static int
1710 dp_netdev_output_userspace(struct dp_netdev *dp, struct ofpbuf *packet,
1711                            int queue_no, const struct flow *flow,
1712                            const struct nlattr *userdata)
1713     OVS_EXCLUDED(dp->queue_mutex)
1714 {
1715     struct dp_netdev_queue *q = &dp->queues[queue_no];
1716     int error;
1717
1718     ovs_mutex_lock(&dp->queue_mutex);
1719     if (q->head - q->tail < MAX_QUEUE_LEN) {
1720         struct dp_netdev_upcall *u = &q->upcalls[q->head++ & QUEUE_MASK];
1721         struct dpif_upcall *upcall = &u->upcall;
1722         struct ofpbuf *buf = &u->buf;
1723         size_t buf_size;
1724
1725         upcall->type = queue_no;
1726
1727         /* Allocate buffer big enough for everything. */
1728         buf_size = ODPUTIL_FLOW_KEY_BYTES;
1729         if (userdata) {
1730             buf_size += NLA_ALIGN(userdata->nla_len);
1731         }
1732         ofpbuf_init(buf, buf_size);
1733
1734         /* Put ODP flow. */
1735         odp_flow_key_from_flow(buf, flow, flow->in_port.odp_port);
1736         upcall->key = buf->data;
1737         upcall->key_len = buf->size;
1738
1739         /* Put userdata. */
1740         if (userdata) {
1741             upcall->userdata = ofpbuf_put(buf, userdata,
1742                                           NLA_ALIGN(userdata->nla_len));
1743         }
1744
1745         /* Steal packet data. */
1746         ovs_assert(packet->source == OFPBUF_MALLOC);
1747         upcall->packet = *packet;
1748         ofpbuf_use(packet, NULL, 0);
1749
1750         seq_change(dp->queue_seq);
1751
1752         error = 0;
1753     } else {
1754         ovsthread_counter_inc(dp->n_lost, 1);
1755         error = ENOBUFS;
1756     }
1757     ovs_mutex_unlock(&dp->queue_mutex);
1758
1759     return error;
1760 }
1761
1762 struct dp_netdev_execute_aux {
1763     struct dp_netdev *dp;
1764     const struct flow *key;
1765 };
1766
1767 static void
1768 dp_execute_cb(void *aux_, struct ofpbuf *packet,
1769               const struct pkt_metadata *md OVS_UNUSED,
1770               const struct nlattr *a, bool may_steal)
1771     OVS_NO_THREAD_SAFETY_ANALYSIS
1772 {
1773     struct dp_netdev_execute_aux *aux = aux_;
1774     int type = nl_attr_type(a);
1775     struct dp_netdev_port *p;
1776
1777     switch ((enum ovs_action_attr)type) {
1778     case OVS_ACTION_ATTR_OUTPUT:
1779         p = dp_netdev_lookup_port(aux->dp, u32_to_odp(nl_attr_get_u32(a)));
1780         if (p) {
1781             netdev_send(p->netdev, packet);
1782         }
1783         break;
1784
1785     case OVS_ACTION_ATTR_USERSPACE: {
1786         const struct nlattr *userdata;
1787
1788         userdata = nl_attr_find_nested(a, OVS_USERSPACE_ATTR_USERDATA);
1789
1790         /* Make a copy if we are not allowed to steal the packet's data. */
1791         if (!may_steal) {
1792             packet = ofpbuf_clone_with_headroom(packet, DP_NETDEV_HEADROOM);
1793         }
1794         dp_netdev_output_userspace(aux->dp, packet, DPIF_UC_ACTION, aux->key,
1795                                    userdata);
1796         if (!may_steal) {
1797             ofpbuf_uninit(packet);
1798         }
1799         break;
1800     }
1801     case OVS_ACTION_ATTR_PUSH_VLAN:
1802     case OVS_ACTION_ATTR_POP_VLAN:
1803     case OVS_ACTION_ATTR_PUSH_MPLS:
1804     case OVS_ACTION_ATTR_POP_MPLS:
1805     case OVS_ACTION_ATTR_SET:
1806     case OVS_ACTION_ATTR_SAMPLE:
1807     case OVS_ACTION_ATTR_UNSPEC:
1808     case __OVS_ACTION_ATTR_MAX:
1809         OVS_NOT_REACHED();
1810     }
1811 }
1812
1813 static void
1814 dp_netdev_execute_actions(struct dp_netdev *dp, const struct flow *key,
1815                           struct ofpbuf *packet, struct pkt_metadata *md,
1816                           const struct nlattr *actions, size_t actions_len)
1817     OVS_REQ_RDLOCK(dp->port_rwlock)
1818 {
1819     struct dp_netdev_execute_aux aux = {dp, key};
1820
1821     odp_execute_actions(&aux, packet, md, actions, actions_len, dp_execute_cb);
1822 }
1823
1824 const struct dpif_class dpif_netdev_class = {
1825     "netdev",
1826     dpif_netdev_enumerate,
1827     dpif_netdev_port_open_type,
1828     dpif_netdev_open,
1829     dpif_netdev_close,
1830     dpif_netdev_destroy,
1831     NULL,                       /* run */
1832     NULL,                       /* wait */
1833     dpif_netdev_get_stats,
1834     dpif_netdev_port_add,
1835     dpif_netdev_port_del,
1836     dpif_netdev_port_query_by_number,
1837     dpif_netdev_port_query_by_name,
1838     NULL,                       /* port_get_pid */
1839     dpif_netdev_port_dump_start,
1840     dpif_netdev_port_dump_next,
1841     dpif_netdev_port_dump_done,
1842     dpif_netdev_port_poll,
1843     dpif_netdev_port_poll_wait,
1844     dpif_netdev_flow_get,
1845     dpif_netdev_flow_put,
1846     dpif_netdev_flow_del,
1847     dpif_netdev_flow_flush,
1848     dpif_netdev_flow_dump_start,
1849     dpif_netdev_flow_dump_next,
1850     dpif_netdev_flow_dump_done,
1851     dpif_netdev_execute,
1852     NULL,                       /* operate */
1853     dpif_netdev_recv_set,
1854     dpif_netdev_queue_to_priority,
1855     dpif_netdev_recv,
1856     dpif_netdev_recv_wait,
1857     dpif_netdev_recv_purge,
1858 };
1859
1860 static void
1861 dpif_dummy_change_port_number(struct unixctl_conn *conn, int argc OVS_UNUSED,
1862                               const char *argv[], void *aux OVS_UNUSED)
1863 {
1864     struct dp_netdev_port *port;
1865     struct dp_netdev *dp;
1866     odp_port_t port_no;
1867
1868     ovs_mutex_lock(&dp_netdev_mutex);
1869     dp = shash_find_data(&dp_netdevs, argv[1]);
1870     if (!dp || !dpif_netdev_class_is_dummy(dp->class)) {
1871         ovs_mutex_unlock(&dp_netdev_mutex);
1872         unixctl_command_reply_error(conn, "unknown datapath or not a dummy");
1873         return;
1874     }
1875     ovs_refcount_ref(&dp->ref_cnt);
1876     ovs_mutex_unlock(&dp_netdev_mutex);
1877
1878     ovs_rwlock_wrlock(&dp->port_rwlock);
1879     if (get_port_by_name(dp, argv[2], &port)) {
1880         unixctl_command_reply_error(conn, "unknown port");
1881         goto exit;
1882     }
1883
1884     port_no = u32_to_odp(atoi(argv[3]));
1885     if (!port_no || port_no == ODPP_NONE) {
1886         unixctl_command_reply_error(conn, "bad port number");
1887         goto exit;
1888     }
1889     if (dp_netdev_lookup_port(dp, port_no)) {
1890         unixctl_command_reply_error(conn, "port number already in use");
1891         goto exit;
1892     }
1893     hmap_remove(&dp->ports, &port->node);
1894     port->port_no = port_no;
1895     hmap_insert(&dp->ports, &port->node, hash_int(odp_to_u32(port_no), 0));
1896     seq_change(dp->port_seq);
1897     unixctl_command_reply(conn, NULL);
1898
1899 exit:
1900     ovs_rwlock_unlock(&dp->port_rwlock);
1901     dp_netdev_unref(dp);
1902 }
1903
1904 static void
1905 dpif_dummy_register__(const char *type)
1906 {
1907     struct dpif_class *class;
1908
1909     class = xmalloc(sizeof *class);
1910     *class = dpif_netdev_class;
1911     class->type = xstrdup(type);
1912     dp_register_provider(class);
1913 }
1914
1915 void
1916 dpif_dummy_register(bool override)
1917 {
1918     if (override) {
1919         struct sset types;
1920         const char *type;
1921
1922         sset_init(&types);
1923         dp_enumerate_types(&types);
1924         SSET_FOR_EACH (type, &types) {
1925             if (!dp_unregister_provider(type)) {
1926                 dpif_dummy_register__(type);
1927             }
1928         }
1929         sset_destroy(&types);
1930     }
1931
1932     dpif_dummy_register__("dummy");
1933
1934     unixctl_command_register("dpif-dummy/change-port-number",
1935                              "DP PORT NEW-NUMBER",
1936                              3, 3, dpif_dummy_change_port_number, NULL);
1937 }