1 // SPDX-License-Identifier: GPL-2.0-only
3 * Copyright (c) 2007-2014 Nicira, Inc.
6 #include <linux/etherdevice.h>
8 #include <linux/if_vlan.h>
9 #include <linux/jhash.h>
10 #include <linux/kernel.h>
11 #include <linux/list.h>
12 #include <linux/mutex.h>
13 #include <linux/percpu.h>
14 #include <linux/rcupdate.h>
15 #include <linux/rtnetlink.h>
16 #include <linux/compat.h>
17 #include <net/net_namespace.h>
18 #include <linux/module.h>
22 #include "vport-internal_dev.h"
24 static LIST_HEAD(vport_ops_list
);
26 /* Protected by RCU read lock for reading, ovs_mutex for writing. */
27 static struct hlist_head
*dev_table
;
28 #define VPORT_HASH_BUCKETS 1024
31 * ovs_vport_init - initialize vport subsystem
33 * Called at module load time to initialize the vport subsystem.
35 int ovs_vport_init(void)
37 dev_table
= kcalloc(VPORT_HASH_BUCKETS
, sizeof(struct hlist_head
),
46 * ovs_vport_exit - shutdown vport subsystem
48 * Called at module exit time to shutdown the vport subsystem.
50 void ovs_vport_exit(void)
55 static struct hlist_head
*hash_bucket(const struct net
*net
, const char *name
)
57 unsigned int hash
= jhash(name
, strlen(name
), (unsigned long) net
);
58 return &dev_table
[hash
& (VPORT_HASH_BUCKETS
- 1)];
61 int __ovs_vport_ops_register(struct vport_ops
*ops
)
67 list_for_each_entry(o
, &vport_ops_list
, list
)
68 if (ops
->type
== o
->type
)
71 list_add_tail(&ops
->list
, &vport_ops_list
);
77 EXPORT_SYMBOL_GPL(__ovs_vport_ops_register
);
79 void ovs_vport_ops_unregister(struct vport_ops
*ops
)
85 EXPORT_SYMBOL_GPL(ovs_vport_ops_unregister
);
88 * ovs_vport_locate - find a port that has already been created
90 * @net: network namespace
91 * @name: name of port to find
93 * Must be called with ovs or RCU read lock.
95 struct vport
*ovs_vport_locate(const struct net
*net
, const char *name
)
97 struct hlist_head
*bucket
= hash_bucket(net
, name
);
100 hlist_for_each_entry_rcu(vport
, bucket
, hash_node
,
101 lockdep_ovsl_is_held())
102 if (!strcmp(name
, ovs_vport_name(vport
)) &&
103 net_eq(ovs_dp_get_net(vport
->dp
), net
))
110 * ovs_vport_alloc - allocate and initialize new vport
112 * @priv_size: Size of private data area to allocate.
113 * @ops: vport device ops
114 * @parms: information about new vport.
116 * Allocate and initialize a new vport defined by @ops. The vport will contain
117 * a private data area of size @priv_size that can be accessed using
118 * vport_priv(). Some parameters of the vport will be initialized from @parms.
119 * @vports that are no longer needed should be released with
122 struct vport
*ovs_vport_alloc(int priv_size
, const struct vport_ops
*ops
,
123 const struct vport_parms
*parms
)
129 alloc_size
= sizeof(struct vport
);
131 alloc_size
= ALIGN(alloc_size
, VPORT_ALIGN
);
132 alloc_size
+= priv_size
;
135 vport
= kzalloc(alloc_size
, GFP_KERNEL
);
137 return ERR_PTR(-ENOMEM
);
139 vport
->upcall_stats
= netdev_alloc_pcpu_stats(struct vport_upcall_stats_percpu
);
140 if (!vport
->upcall_stats
) {
142 goto err_kfree_vport
;
145 vport
->dp
= parms
->dp
;
146 vport
->port_no
= parms
->port_no
;
148 INIT_HLIST_NODE(&vport
->dp_hash_node
);
150 if (ovs_vport_set_upcall_portids(vport
, parms
->upcall_portids
)) {
152 goto err_free_percpu
;
158 free_percpu(vport
->upcall_stats
);
163 EXPORT_SYMBOL_GPL(ovs_vport_alloc
);
166 * ovs_vport_free - uninitialize and free vport
168 * @vport: vport to free
170 * Frees a vport allocated with vport_alloc() when it is no longer needed.
172 * The caller must ensure that an RCU grace period has passed since the last
173 * time @vport was in a datapath.
175 void ovs_vport_free(struct vport
*vport
)
177 /* vport is freed from RCU callback or error path, Therefore
178 * it is safe to use raw dereference.
180 kfree(rcu_dereference_raw(vport
->upcall_portids
));
181 free_percpu(vport
->upcall_stats
);
184 EXPORT_SYMBOL_GPL(ovs_vport_free
);
186 static struct vport_ops
*ovs_vport_lookup(const struct vport_parms
*parms
)
188 struct vport_ops
*ops
;
190 list_for_each_entry(ops
, &vport_ops_list
, list
)
191 if (ops
->type
== parms
->type
)
198 * ovs_vport_add - add vport device (for kernel callers)
200 * @parms: Information about new vport.
202 * Creates a new vport with the specified configuration (which is dependent on
203 * device type). ovs_mutex must be held.
205 struct vport
*ovs_vport_add(const struct vport_parms
*parms
)
207 struct vport_ops
*ops
;
210 ops
= ovs_vport_lookup(parms
);
212 struct hlist_head
*bucket
;
214 if (!try_module_get(ops
->owner
))
215 return ERR_PTR(-EAFNOSUPPORT
);
217 vport
= ops
->create(parms
);
219 module_put(ops
->owner
);
223 bucket
= hash_bucket(ovs_dp_get_net(vport
->dp
),
224 ovs_vport_name(vport
));
225 hlist_add_head_rcu(&vport
->hash_node
, bucket
);
229 /* Unlock to attempt module load and return -EAGAIN if load
230 * was successful as we need to restart the port addition
234 request_module("vport-type-%d", parms
->type
);
237 if (!ovs_vport_lookup(parms
))
238 return ERR_PTR(-EAFNOSUPPORT
);
240 return ERR_PTR(-EAGAIN
);
244 * ovs_vport_set_options - modify existing vport device (for kernel callers)
246 * @vport: vport to modify.
247 * @options: New configuration.
249 * Modifies an existing device with the specified configuration (which is
250 * dependent on device type). ovs_mutex must be held.
252 int ovs_vport_set_options(struct vport
*vport
, struct nlattr
*options
)
254 if (!vport
->ops
->set_options
)
256 return vport
->ops
->set_options(vport
, options
);
260 * ovs_vport_del - delete existing vport device
262 * @vport: vport to delete.
264 * Detaches @vport from its datapath and destroys it. ovs_mutex must
267 void ovs_vport_del(struct vport
*vport
)
269 hlist_del_rcu(&vport
->hash_node
);
270 module_put(vport
->ops
->owner
);
271 vport
->ops
->destroy(vport
);
275 * ovs_vport_get_stats - retrieve device stats
277 * @vport: vport from which to retrieve the stats
278 * @stats: location to store stats
280 * Retrieves transmit, receive, and error stats for the given device.
282 * Must be called with ovs_mutex or rcu_read_lock.
284 void ovs_vport_get_stats(struct vport
*vport
, struct ovs_vport_stats
*stats
)
286 const struct rtnl_link_stats64
*dev_stats
;
287 struct rtnl_link_stats64 temp
;
289 dev_stats
= dev_get_stats(vport
->dev
, &temp
);
290 stats
->rx_errors
= dev_stats
->rx_errors
;
291 stats
->tx_errors
= dev_stats
->tx_errors
;
292 stats
->tx_dropped
= dev_stats
->tx_dropped
;
293 stats
->rx_dropped
= dev_stats
->rx_dropped
;
295 stats
->rx_bytes
= dev_stats
->rx_bytes
;
296 stats
->rx_packets
= dev_stats
->rx_packets
;
297 stats
->tx_bytes
= dev_stats
->tx_bytes
;
298 stats
->tx_packets
= dev_stats
->tx_packets
;
302 * ovs_vport_get_upcall_stats - retrieve upcall stats
304 * @vport: vport from which to retrieve the stats.
305 * @skb: sk_buff where upcall stats should be appended.
307 * Retrieves upcall stats for the given device.
309 * Must be called with ovs_mutex or rcu_read_lock.
311 int ovs_vport_get_upcall_stats(struct vport
*vport
, struct sk_buff
*skb
)
316 __u64 tx_success
= 0;
319 for_each_possible_cpu(i
) {
320 const struct vport_upcall_stats_percpu
*stats
;
323 stats
= per_cpu_ptr(vport
->upcall_stats
, i
);
325 start
= u64_stats_fetch_begin(&stats
->syncp
);
326 tx_success
+= u64_stats_read(&stats
->n_success
);
327 tx_fail
+= u64_stats_read(&stats
->n_fail
);
328 } while (u64_stats_fetch_retry(&stats
->syncp
, start
));
331 nla
= nla_nest_start_noflag(skb
, OVS_VPORT_ATTR_UPCALL_STATS
);
335 if (nla_put_u64_64bit(skb
, OVS_VPORT_UPCALL_ATTR_SUCCESS
, tx_success
,
336 OVS_VPORT_ATTR_PAD
)) {
337 nla_nest_cancel(skb
, nla
);
341 if (nla_put_u64_64bit(skb
, OVS_VPORT_UPCALL_ATTR_FAIL
, tx_fail
,
342 OVS_VPORT_ATTR_PAD
)) {
343 nla_nest_cancel(skb
, nla
);
346 nla_nest_end(skb
, nla
);
352 * ovs_vport_get_options - retrieve device options
354 * @vport: vport from which to retrieve the options.
355 * @skb: sk_buff where options should be appended.
357 * Retrieves the configuration of the given device, appending an
358 * %OVS_VPORT_ATTR_OPTIONS attribute that in turn contains nested
359 * vport-specific attributes to @skb.
361 * Returns 0 if successful, -EMSGSIZE if @skb has insufficient room, or another
362 * negative error code if a real error occurred. If an error occurs, @skb is
365 * Must be called with ovs_mutex or rcu_read_lock.
367 int ovs_vport_get_options(const struct vport
*vport
, struct sk_buff
*skb
)
372 if (!vport
->ops
->get_options
)
375 nla
= nla_nest_start_noflag(skb
, OVS_VPORT_ATTR_OPTIONS
);
379 err
= vport
->ops
->get_options(vport
, skb
);
381 nla_nest_cancel(skb
, nla
);
385 nla_nest_end(skb
, nla
);
390 * ovs_vport_set_upcall_portids - set upcall portids of @vport.
392 * @vport: vport to modify.
393 * @ids: new configuration, an array of port ids.
395 * Sets the vport's upcall_portids to @ids.
397 * Returns 0 if successful, -EINVAL if @ids is zero length or cannot be parsed
398 * as an array of U32.
400 * Must be called with ovs_mutex.
402 int ovs_vport_set_upcall_portids(struct vport
*vport
, const struct nlattr
*ids
)
404 struct vport_portids
*old
, *vport_portids
;
406 if (!nla_len(ids
) || nla_len(ids
) % sizeof(u32
))
409 old
= ovsl_dereference(vport
->upcall_portids
);
411 vport_portids
= kmalloc(sizeof(*vport_portids
) + nla_len(ids
),
416 vport_portids
->n_ids
= nla_len(ids
) / sizeof(u32
);
417 vport_portids
->rn_ids
= reciprocal_value(vport_portids
->n_ids
);
418 nla_memcpy(vport_portids
->ids
, ids
, nla_len(ids
));
420 rcu_assign_pointer(vport
->upcall_portids
, vport_portids
);
428 * ovs_vport_get_upcall_portids - get the upcall_portids of @vport.
430 * @vport: vport from which to retrieve the portids.
431 * @skb: sk_buff where portids should be appended.
433 * Retrieves the configuration of the given vport, appending the
434 * %OVS_VPORT_ATTR_UPCALL_PID attribute which is the array of upcall
437 * Returns 0 if successful, -EMSGSIZE if @skb has insufficient room.
438 * If an error occurs, @skb is left unmodified. Must be called with
439 * ovs_mutex or rcu_read_lock.
441 int ovs_vport_get_upcall_portids(const struct vport
*vport
,
444 struct vport_portids
*ids
;
446 ids
= rcu_dereference_ovsl(vport
->upcall_portids
);
448 if (vport
->dp
->user_features
& OVS_DP_F_VPORT_PIDS
)
449 return nla_put(skb
, OVS_VPORT_ATTR_UPCALL_PID
,
450 ids
->n_ids
* sizeof(u32
), (void *)ids
->ids
);
452 return nla_put_u32(skb
, OVS_VPORT_ATTR_UPCALL_PID
, ids
->ids
[0]);
456 * ovs_vport_find_upcall_portid - find the upcall portid to send upcall.
458 * @vport: vport from which the missed packet is received.
459 * @skb: skb that the missed packet was received.
461 * Uses the skb_get_hash() to select the upcall portid to send the
464 * Returns the portid of the target socket. Must be called with rcu_read_lock.
466 u32
ovs_vport_find_upcall_portid(const struct vport
*vport
,
469 struct vport_portids
*ids
;
473 ids
= rcu_dereference(vport
->upcall_portids
);
475 /* If there is only one portid, select it in the fast-path. */
479 hash
= skb_get_hash(skb
);
480 ids_index
= hash
- ids
->n_ids
* reciprocal_divide(hash
, ids
->rn_ids
);
481 return ids
->ids
[ids_index
];
485 * ovs_vport_receive - pass up received packet to the datapath for processing
487 * @vport: vport that received the packet
488 * @skb: skb that was received
489 * @tun_info: tunnel (if any) that carried packet
491 * Must be called with rcu_read_lock. The packet cannot be shared and
492 * skb->data should point to the Ethernet header.
494 int ovs_vport_receive(struct vport
*vport
, struct sk_buff
*skb
,
495 const struct ip_tunnel_info
*tun_info
)
497 struct sw_flow_key key
;
500 OVS_CB(skb
)->input_vport
= vport
;
501 OVS_CB(skb
)->mru
= 0;
502 OVS_CB(skb
)->cutlen
= 0;
503 OVS_CB(skb
)->probability
= 0;
504 if (unlikely(dev_net(skb
->dev
) != ovs_dp_get_net(vport
->dp
))) {
508 skb_scrub_packet(skb
, true);
513 /* Extract flow from 'skb' into 'key'. */
514 error
= ovs_flow_key_extract(tun_info
, skb
, &key
);
515 if (unlikely(error
)) {
519 ovs_dp_process_packet(skb
, &key
);
523 static int packet_length(const struct sk_buff
*skb
,
524 struct net_device
*dev
)
526 int length
= skb
->len
- dev
->hard_header_len
;
528 if (!skb_vlan_tag_present(skb
) &&
529 eth_type_vlan(skb
->protocol
))
532 /* Don't subtract for multiple VLAN tags. Most (all?) drivers allow
533 * (ETH_LEN + VLAN_HLEN) in addition to the mtu value, but almost none
534 * account for 802.1ad. e.g. is_skb_forwardable().
537 return length
> 0 ? length
: 0;
540 void ovs_vport_send(struct vport
*vport
, struct sk_buff
*skb
, u8 mac_proto
)
542 int mtu
= vport
->dev
->mtu
;
544 switch (vport
->dev
->type
) {
546 if (mac_proto
== MAC_PROTO_ETHERNET
) {
547 skb_reset_network_header(skb
);
548 skb_reset_mac_len(skb
);
549 skb
->protocol
= htons(ETH_P_TEB
);
550 } else if (mac_proto
!= MAC_PROTO_NONE
) {
556 if (mac_proto
!= MAC_PROTO_ETHERNET
)
563 if (unlikely(packet_length(skb
, vport
->dev
) > mtu
&&
565 vport
->dev
->stats
.tx_errors
++;
566 if (vport
->dev
->flags
& IFF_UP
)
567 net_warn_ratelimited("%s: dropped over-mtu packet: "
568 "%d > %d\n", vport
->dev
->name
,
569 packet_length(skb
, vport
->dev
),
574 skb
->dev
= vport
->dev
;
575 skb_clear_tstamp(skb
);
576 vport
->ops
->send(skb
);