2 * GENEVE: Generic Network Virtualization Encapsulation
4 * Copyright (c) 2015 Red Hat, Inc.
6 * This program is free software; you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License version 2 as
8 * published by the Free Software Foundation.
11 #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
13 #include <linux/kernel.h>
14 #include <linux/module.h>
15 #include <linux/netdevice.h>
16 #include <linux/etherdevice.h>
17 #include <linux/hash.h>
18 #include <net/dst_metadata.h>
19 #include <net/gro_cells.h>
20 #include <net/rtnetlink.h>
21 #include <net/geneve.h>
22 #include <net/protocol.h>
24 #define GENEVE_NETDEV_VER "0.6"
26 #define GENEVE_UDP_PORT 6081
28 #define GENEVE_N_VID (1u << 24)
29 #define GENEVE_VID_MASK (GENEVE_N_VID - 1)
31 #define VNI_HASH_BITS 10
32 #define VNI_HASH_SIZE (1<<VNI_HASH_BITS)
34 static bool log_ecn_error = true;
35 module_param(log_ecn_error, bool, 0644);
36 MODULE_PARM_DESC(log_ecn_error, "Log packets received with corrupted ECN");
39 #define GENEVE_BASE_HLEN (sizeof(struct udphdr) + sizeof(struct genevehdr))
41 /* per-network namespace private data for this module */
43 struct list_head geneve_list;
44 struct list_head sock_list;
47 static int geneve_net_id;
50 struct sockaddr_in sin;
51 struct sockaddr_in6 sin6;
55 static union geneve_addr geneve_remote_unspec = { .sa.sa_family = AF_UNSPEC, };
57 /* Pseudo network device */
59 struct hlist_node hlist; /* vni hash table */
60 struct net *net; /* netns for packet i/o */
61 struct net_device *dev; /* netdev for geneve tunnel */
62 struct geneve_sock *sock4; /* IPv4 socket used for geneve tunnel */
63 #if IS_ENABLED(CONFIG_IPV6)
64 struct geneve_sock *sock6; /* IPv6 socket used for geneve tunnel */
66 u8 vni[3]; /* virtual network ID for tunnel */
67 u8 ttl; /* TTL override */
68 u8 tos; /* TOS override */
69 union geneve_addr remote; /* IP address for link partner */
70 struct list_head next; /* geneve's per namespace list */
71 __be32 label; /* IPv6 flowlabel override */
74 struct gro_cells gro_cells;
76 struct dst_cache dst_cache;
79 /* Geneve device flags */
80 #define GENEVE_F_UDP_ZERO_CSUM_TX BIT(0)
81 #define GENEVE_F_UDP_ZERO_CSUM6_TX BIT(1)
82 #define GENEVE_F_UDP_ZERO_CSUM6_RX BIT(2)
86 struct list_head list;
90 struct hlist_head vni_list[VNI_HASH_SIZE];
94 static inline __u32 geneve_net_vni_hash(u8 vni[3])
98 vnid = (vni[0] << 16) | (vni[1] << 8) | vni[2];
99 return hash_32(vnid, VNI_HASH_BITS);
102 static __be64 vni_to_tunnel_id(const __u8 *vni)
105 return (vni[0] << 16) | (vni[1] << 8) | vni[2];
107 return (__force __be64)(((__force u64)vni[0] << 40) |
108 ((__force u64)vni[1] << 48) |
109 ((__force u64)vni[2] << 56));
113 static sa_family_t geneve_get_sk_family(struct geneve_sock *gs)
115 return gs->sock->sk->sk_family;
118 static struct geneve_dev *geneve_lookup(struct geneve_sock *gs,
119 __be32 addr, u8 vni[])
121 struct hlist_head *vni_list_head;
122 struct geneve_dev *geneve;
125 /* Find the device for this VNI */
126 hash = geneve_net_vni_hash(vni);
127 vni_list_head = &gs->vni_list[hash];
128 hlist_for_each_entry_rcu(geneve, vni_list_head, hlist) {
129 if (!memcmp(vni, geneve->vni, sizeof(geneve->vni)) &&
130 addr == geneve->remote.sin.sin_addr.s_addr)
136 #if IS_ENABLED(CONFIG_IPV6)
137 static struct geneve_dev *geneve6_lookup(struct geneve_sock *gs,
138 struct in6_addr addr6, u8 vni[])
140 struct hlist_head *vni_list_head;
141 struct geneve_dev *geneve;
144 /* Find the device for this VNI */
145 hash = geneve_net_vni_hash(vni);
146 vni_list_head = &gs->vni_list[hash];
147 hlist_for_each_entry_rcu(geneve, vni_list_head, hlist) {
148 if (!memcmp(vni, geneve->vni, sizeof(geneve->vni)) &&
149 ipv6_addr_equal(&addr6, &geneve->remote.sin6.sin6_addr))
156 static inline struct genevehdr *geneve_hdr(const struct sk_buff *skb)
158 return (struct genevehdr *)(udp_hdr(skb) + 1);
161 static struct geneve_dev *geneve_lookup_skb(struct geneve_sock *gs,
166 static u8 zero_vni[3];
167 #if IS_ENABLED(CONFIG_IPV6)
168 static struct in6_addr zero_addr6;
171 if (geneve_get_sk_family(gs) == AF_INET) {
174 iph = ip_hdr(skb); /* outer IP header... */
176 if (gs->collect_md) {
180 vni = geneve_hdr(skb)->vni;
184 return geneve_lookup(gs, addr, vni);
185 #if IS_ENABLED(CONFIG_IPV6)
186 } else if (geneve_get_sk_family(gs) == AF_INET6) {
187 struct ipv6hdr *ip6h;
188 struct in6_addr addr6;
190 ip6h = ipv6_hdr(skb); /* outer IPv6 header... */
192 if (gs->collect_md) {
196 vni = geneve_hdr(skb)->vni;
200 return geneve6_lookup(gs, addr6, vni);
206 /* geneve receive/decap routine */
207 static void geneve_rx(struct geneve_dev *geneve, struct geneve_sock *gs,
210 struct genevehdr *gnvh = geneve_hdr(skb);
211 struct metadata_dst *tun_dst = NULL;
212 struct pcpu_sw_netstats *stats;
216 if (ip_tunnel_collect_metadata() || gs->collect_md) {
219 flags = TUNNEL_KEY | TUNNEL_GENEVE_OPT |
220 (gnvh->oam ? TUNNEL_OAM : 0) |
221 (gnvh->critical ? TUNNEL_CRIT_OPT : 0);
223 tun_dst = udp_tun_rx_dst(skb, geneve_get_sk_family(gs), flags,
224 vni_to_tunnel_id(gnvh->vni),
228 /* Update tunnel dst according to Geneve options. */
229 ip_tunnel_info_opts_set(&tun_dst->u.tun_info,
230 gnvh->options, gnvh->opt_len * 4);
232 /* Drop packets w/ critical options,
233 * since we don't support any...
239 skb_reset_mac_header(skb);
240 skb->protocol = eth_type_trans(skb, geneve->dev);
241 skb_postpull_rcsum(skb, eth_hdr(skb), ETH_HLEN);
244 skb_dst_set(skb, &tun_dst->dst);
246 /* Ignore packet loops (and multicast echo) */
247 if (ether_addr_equal(eth_hdr(skb)->h_source, geneve->dev->dev_addr))
250 oiph = skb_network_header(skb);
251 skb_reset_network_header(skb);
253 if (geneve_get_sk_family(gs) == AF_INET)
254 err = IP_ECN_decapsulate(oiph, skb);
255 #if IS_ENABLED(CONFIG_IPV6)
257 err = IP6_ECN_decapsulate(oiph, skb);
262 if (geneve_get_sk_family(gs) == AF_INET)
263 net_info_ratelimited("non-ECT from %pI4 "
265 &((struct iphdr *)oiph)->saddr,
266 ((struct iphdr *)oiph)->tos);
267 #if IS_ENABLED(CONFIG_IPV6)
269 net_info_ratelimited("non-ECT from %pI6\n",
270 &((struct ipv6hdr *)oiph)->saddr);
274 ++geneve->dev->stats.rx_frame_errors;
275 ++geneve->dev->stats.rx_errors;
280 stats = this_cpu_ptr(geneve->dev->tstats);
281 u64_stats_update_begin(&stats->syncp);
283 stats->rx_bytes += skb->len;
284 u64_stats_update_end(&stats->syncp);
286 gro_cells_receive(&geneve->gro_cells, skb);
289 /* Consume bad packet */
293 /* Setup stats when device is created */
294 static int geneve_init(struct net_device *dev)
296 struct geneve_dev *geneve = netdev_priv(dev);
299 dev->tstats = netdev_alloc_pcpu_stats(struct pcpu_sw_netstats);
303 err = gro_cells_init(&geneve->gro_cells, dev);
305 free_percpu(dev->tstats);
309 err = dst_cache_init(&geneve->dst_cache, GFP_KERNEL);
311 free_percpu(dev->tstats);
312 gro_cells_destroy(&geneve->gro_cells);
319 static void geneve_uninit(struct net_device *dev)
321 struct geneve_dev *geneve = netdev_priv(dev);
323 dst_cache_destroy(&geneve->dst_cache);
324 gro_cells_destroy(&geneve->gro_cells);
325 free_percpu(dev->tstats);
328 /* Callback from net/ipv4/udp.c to receive packets */
329 static int geneve_udp_encap_recv(struct sock *sk, struct sk_buff *skb)
331 struct genevehdr *geneveh;
332 struct geneve_dev *geneve;
333 struct geneve_sock *gs;
336 /* Need Geneve and inner Ethernet header to be present */
337 if (unlikely(!pskb_may_pull(skb, GENEVE_BASE_HLEN)))
340 /* Return packets with reserved bits set */
341 geneveh = geneve_hdr(skb);
342 if (unlikely(geneveh->ver != GENEVE_VER))
345 if (unlikely(geneveh->proto_type != htons(ETH_P_TEB)))
348 gs = rcu_dereference_sk_user_data(sk);
352 geneve = geneve_lookup_skb(gs, skb);
356 opts_len = geneveh->opt_len * 4;
357 if (iptunnel_pull_header(skb, GENEVE_BASE_HLEN + opts_len,
359 !net_eq(geneve->net, dev_net(geneve->dev))))
362 geneve_rx(geneve, gs, skb);
366 /* Consume bad packet */
371 /* Let the UDP layer deal with the skb */
375 static struct socket *geneve_create_sock(struct net *net, bool ipv6,
376 __be16 port, u32 flags)
379 struct udp_port_cfg udp_conf;
382 memset(&udp_conf, 0, sizeof(udp_conf));
385 udp_conf.family = AF_INET6;
386 udp_conf.ipv6_v6only = 1;
387 udp_conf.use_udp6_rx_checksums =
388 !(flags & GENEVE_F_UDP_ZERO_CSUM6_RX);
390 udp_conf.family = AF_INET;
391 udp_conf.local_ip.s_addr = htonl(INADDR_ANY);
394 udp_conf.local_udp_port = port;
396 /* Open UDP socket */
397 err = udp_sock_create(net, &udp_conf, &sock);
404 static void geneve_notify_add_rx_port(struct geneve_sock *gs)
406 struct net_device *dev;
407 struct sock *sk = gs->sock->sk;
408 struct net *net = sock_net(sk);
409 sa_family_t sa_family = geneve_get_sk_family(gs);
410 __be16 port = inet_sk(sk)->inet_sport;
413 for_each_netdev_rcu(net, dev) {
414 if (dev->netdev_ops->ndo_add_geneve_port)
415 dev->netdev_ops->ndo_add_geneve_port(dev, sa_family,
421 static int geneve_hlen(struct genevehdr *gh)
423 return sizeof(*gh) + gh->opt_len * 4;
426 static struct sk_buff **geneve_gro_receive(struct sock *sk,
427 struct sk_buff **head,
430 struct sk_buff *p, **pp = NULL;
431 struct genevehdr *gh, *gh2;
432 unsigned int hlen, gh_len, off_gnv;
433 const struct packet_offload *ptype;
437 off_gnv = skb_gro_offset(skb);
438 hlen = off_gnv + sizeof(*gh);
439 gh = skb_gro_header_fast(skb, off_gnv);
440 if (skb_gro_header_hard(skb, hlen)) {
441 gh = skb_gro_header_slow(skb, hlen, off_gnv);
446 if (gh->ver != GENEVE_VER || gh->oam)
448 gh_len = geneve_hlen(gh);
450 hlen = off_gnv + gh_len;
451 if (skb_gro_header_hard(skb, hlen)) {
452 gh = skb_gro_header_slow(skb, hlen, off_gnv);
457 for (p = *head; p; p = p->next) {
458 if (!NAPI_GRO_CB(p)->same_flow)
461 gh2 = (struct genevehdr *)(p->data + off_gnv);
462 if (gh->opt_len != gh2->opt_len ||
463 memcmp(gh, gh2, gh_len)) {
464 NAPI_GRO_CB(p)->same_flow = 0;
469 type = gh->proto_type;
472 ptype = gro_find_receive_by_type(type);
476 skb_gro_pull(skb, gh_len);
477 skb_gro_postpull_rcsum(skb, gh, gh_len);
478 pp = ptype->callbacks.gro_receive(head, skb);
484 NAPI_GRO_CB(skb)->flush |= flush;
489 static int geneve_gro_complete(struct sock *sk, struct sk_buff *skb,
492 struct genevehdr *gh;
493 struct packet_offload *ptype;
498 udp_tunnel_gro_complete(skb, nhoff);
500 gh = (struct genevehdr *)(skb->data + nhoff);
501 gh_len = geneve_hlen(gh);
502 type = gh->proto_type;
505 ptype = gro_find_complete_by_type(type);
507 err = ptype->callbacks.gro_complete(skb, nhoff + gh_len);
513 /* Create new listen socket if needed */
514 static struct geneve_sock *geneve_socket_create(struct net *net, __be16 port,
515 bool ipv6, u32 flags)
517 struct geneve_net *gn = net_generic(net, geneve_net_id);
518 struct geneve_sock *gs;
520 struct udp_tunnel_sock_cfg tunnel_cfg;
523 gs = kzalloc(sizeof(*gs), GFP_KERNEL);
525 return ERR_PTR(-ENOMEM);
527 sock = geneve_create_sock(net, ipv6, port, flags);
530 return ERR_CAST(sock);
535 for (h = 0; h < VNI_HASH_SIZE; ++h)
536 INIT_HLIST_HEAD(&gs->vni_list[h]);
538 /* Initialize the geneve udp offloads structure */
539 geneve_notify_add_rx_port(gs);
541 /* Mark socket as an encapsulation socket */
542 memset(&tunnel_cfg, 0, sizeof(tunnel_cfg));
543 tunnel_cfg.sk_user_data = gs;
544 tunnel_cfg.encap_type = 1;
545 tunnel_cfg.gro_receive = geneve_gro_receive;
546 tunnel_cfg.gro_complete = geneve_gro_complete;
547 tunnel_cfg.encap_rcv = geneve_udp_encap_recv;
548 tunnel_cfg.encap_destroy = NULL;
549 setup_udp_tunnel_sock(net, sock, &tunnel_cfg);
550 list_add(&gs->list, &gn->sock_list);
554 static void geneve_notify_del_rx_port(struct geneve_sock *gs)
556 struct net_device *dev;
557 struct sock *sk = gs->sock->sk;
558 struct net *net = sock_net(sk);
559 sa_family_t sa_family = geneve_get_sk_family(gs);
560 __be16 port = inet_sk(sk)->inet_sport;
563 for_each_netdev_rcu(net, dev) {
564 if (dev->netdev_ops->ndo_del_geneve_port)
565 dev->netdev_ops->ndo_del_geneve_port(dev, sa_family,
572 static void __geneve_sock_release(struct geneve_sock *gs)
574 if (!gs || --gs->refcnt)
578 geneve_notify_del_rx_port(gs);
579 udp_tunnel_sock_release(gs->sock);
583 static void geneve_sock_release(struct geneve_dev *geneve)
585 __geneve_sock_release(geneve->sock4);
586 #if IS_ENABLED(CONFIG_IPV6)
587 __geneve_sock_release(geneve->sock6);
591 static struct geneve_sock *geneve_find_sock(struct geneve_net *gn,
595 struct geneve_sock *gs;
597 list_for_each_entry(gs, &gn->sock_list, list) {
598 if (inet_sk(gs->sock->sk)->inet_sport == dst_port &&
599 geneve_get_sk_family(gs) == family) {
606 static int geneve_sock_add(struct geneve_dev *geneve, bool ipv6)
608 struct net *net = geneve->net;
609 struct geneve_net *gn = net_generic(net, geneve_net_id);
610 struct geneve_sock *gs;
613 gs = geneve_find_sock(gn, ipv6 ? AF_INET6 : AF_INET, geneve->dst_port);
619 gs = geneve_socket_create(net, geneve->dst_port, ipv6, geneve->flags);
624 gs->collect_md = geneve->collect_md;
625 gs->flags = geneve->flags;
626 #if IS_ENABLED(CONFIG_IPV6)
633 hash = geneve_net_vni_hash(geneve->vni);
634 hlist_add_head_rcu(&geneve->hlist, &gs->vni_list[hash]);
638 static int geneve_open(struct net_device *dev)
640 struct geneve_dev *geneve = netdev_priv(dev);
641 bool ipv6 = geneve->remote.sa.sa_family == AF_INET6;
642 bool metadata = geneve->collect_md;
645 geneve->sock4 = NULL;
646 #if IS_ENABLED(CONFIG_IPV6)
647 geneve->sock6 = NULL;
648 if (ipv6 || metadata)
649 ret = geneve_sock_add(geneve, true);
651 if (!ret && (!ipv6 || metadata))
652 ret = geneve_sock_add(geneve, false);
654 geneve_sock_release(geneve);
659 static int geneve_stop(struct net_device *dev)
661 struct geneve_dev *geneve = netdev_priv(dev);
663 if (!hlist_unhashed(&geneve->hlist))
664 hlist_del_rcu(&geneve->hlist);
665 geneve_sock_release(geneve);
669 static void geneve_build_header(struct genevehdr *geneveh,
670 __be16 tun_flags, u8 vni[3],
671 u8 options_len, u8 *options)
673 geneveh->ver = GENEVE_VER;
674 geneveh->opt_len = options_len / 4;
675 geneveh->oam = !!(tun_flags & TUNNEL_OAM);
676 geneveh->critical = !!(tun_flags & TUNNEL_CRIT_OPT);
678 memcpy(geneveh->vni, vni, 3);
679 geneveh->proto_type = htons(ETH_P_TEB);
682 memcpy(geneveh->options, options, options_len);
685 static int geneve_build_skb(struct rtable *rt, struct sk_buff *skb,
686 __be16 tun_flags, u8 vni[3], u8 opt_len, u8 *opt,
687 u32 flags, bool xnet)
689 struct genevehdr *gnvh;
692 bool udp_sum = !(flags & GENEVE_F_UDP_ZERO_CSUM_TX);
694 skb_scrub_packet(skb, xnet);
696 min_headroom = LL_RESERVED_SPACE(rt->dst.dev) + rt->dst.header_len
697 + GENEVE_BASE_HLEN + opt_len + sizeof(struct iphdr);
698 err = skb_cow_head(skb, min_headroom);
702 err = udp_tunnel_handle_offloads(skb, udp_sum);
706 gnvh = (struct genevehdr *)__skb_push(skb, sizeof(*gnvh) + opt_len);
707 geneve_build_header(gnvh, tun_flags, vni, opt_len, opt);
709 skb_set_inner_protocol(skb, htons(ETH_P_TEB));
717 #if IS_ENABLED(CONFIG_IPV6)
718 static int geneve6_build_skb(struct dst_entry *dst, struct sk_buff *skb,
719 __be16 tun_flags, u8 vni[3], u8 opt_len, u8 *opt,
720 u32 flags, bool xnet)
722 struct genevehdr *gnvh;
725 bool udp_sum = !(flags & GENEVE_F_UDP_ZERO_CSUM6_TX);
727 skb_scrub_packet(skb, xnet);
729 min_headroom = LL_RESERVED_SPACE(dst->dev) + dst->header_len
730 + GENEVE_BASE_HLEN + opt_len + sizeof(struct ipv6hdr);
731 err = skb_cow_head(skb, min_headroom);
735 err = udp_tunnel_handle_offloads(skb, udp_sum);
739 gnvh = (struct genevehdr *)__skb_push(skb, sizeof(*gnvh) + opt_len);
740 geneve_build_header(gnvh, tun_flags, vni, opt_len, opt);
742 skb_set_inner_protocol(skb, htons(ETH_P_TEB));
751 static struct rtable *geneve_get_v4_rt(struct sk_buff *skb,
752 struct net_device *dev,
754 struct ip_tunnel_info *info)
756 bool use_cache = ip_tunnel_dst_cache_usable(skb, info);
757 struct geneve_dev *geneve = netdev_priv(dev);
758 struct dst_cache *dst_cache;
759 struct rtable *rt = NULL;
762 memset(fl4, 0, sizeof(*fl4));
763 fl4->flowi4_mark = skb->mark;
764 fl4->flowi4_proto = IPPROTO_UDP;
767 fl4->daddr = info->key.u.ipv4.dst;
768 fl4->saddr = info->key.u.ipv4.src;
769 fl4->flowi4_tos = RT_TOS(info->key.tos);
770 dst_cache = &info->dst_cache;
774 const struct iphdr *iip = ip_hdr(skb);
776 tos = ip_tunnel_get_dsfield(iip, skb);
780 fl4->flowi4_tos = RT_TOS(tos);
781 fl4->daddr = geneve->remote.sin.sin_addr.s_addr;
782 dst_cache = &geneve->dst_cache;
786 rt = dst_cache_get_ip4(dst_cache, &fl4->saddr);
791 rt = ip_route_output_key(geneve->net, fl4);
793 netdev_dbg(dev, "no route to %pI4\n", &fl4->daddr);
794 return ERR_PTR(-ENETUNREACH);
796 if (rt->dst.dev == dev) { /* is this necessary? */
797 netdev_dbg(dev, "circular route to %pI4\n", &fl4->daddr);
799 return ERR_PTR(-ELOOP);
802 dst_cache_set_ip4(dst_cache, &rt->dst, fl4->saddr);
806 #if IS_ENABLED(CONFIG_IPV6)
807 static struct dst_entry *geneve_get_v6_dst(struct sk_buff *skb,
808 struct net_device *dev,
810 struct ip_tunnel_info *info)
812 bool use_cache = ip_tunnel_dst_cache_usable(skb, info);
813 struct geneve_dev *geneve = netdev_priv(dev);
814 struct geneve_sock *gs6 = geneve->sock6;
815 struct dst_entry *dst = NULL;
816 struct dst_cache *dst_cache;
819 memset(fl6, 0, sizeof(*fl6));
820 fl6->flowi6_mark = skb->mark;
821 fl6->flowi6_proto = IPPROTO_UDP;
824 fl6->daddr = info->key.u.ipv6.dst;
825 fl6->saddr = info->key.u.ipv6.src;
826 fl6->flowlabel = ip6_make_flowinfo(RT_TOS(info->key.tos),
828 dst_cache = &info->dst_cache;
832 const struct iphdr *iip = ip_hdr(skb);
834 prio = ip_tunnel_get_dsfield(iip, skb);
838 fl6->flowlabel = ip6_make_flowinfo(RT_TOS(prio),
840 fl6->daddr = geneve->remote.sin6.sin6_addr;
841 dst_cache = &geneve->dst_cache;
845 dst = dst_cache_get_ip6(dst_cache, &fl6->saddr);
850 if (ipv6_stub->ipv6_dst_lookup(geneve->net, gs6->sock->sk, &dst, fl6)) {
851 netdev_dbg(dev, "no route to %pI6\n", &fl6->daddr);
852 return ERR_PTR(-ENETUNREACH);
854 if (dst->dev == dev) { /* is this necessary? */
855 netdev_dbg(dev, "circular route to %pI6\n", &fl6->daddr);
857 return ERR_PTR(-ELOOP);
861 dst_cache_set_ip6(dst_cache, dst, &fl6->saddr);
866 /* Convert 64 bit tunnel ID to 24 bit VNI. */
867 static void tunnel_id_to_vni(__be64 tun_id, __u8 *vni)
870 vni[0] = (__force __u8)(tun_id >> 16);
871 vni[1] = (__force __u8)(tun_id >> 8);
872 vni[2] = (__force __u8)tun_id;
874 vni[0] = (__force __u8)((__force u64)tun_id >> 40);
875 vni[1] = (__force __u8)((__force u64)tun_id >> 48);
876 vni[2] = (__force __u8)((__force u64)tun_id >> 56);
880 static netdev_tx_t geneve_xmit_skb(struct sk_buff *skb, struct net_device *dev,
881 struct ip_tunnel_info *info)
883 struct geneve_dev *geneve = netdev_priv(dev);
884 struct geneve_sock *gs4 = geneve->sock4;
885 struct rtable *rt = NULL;
886 const struct iphdr *iip; /* interior IP header */
892 bool xnet = !net_eq(geneve->net, dev_net(geneve->dev));
893 u32 flags = geneve->flags;
895 if (geneve->collect_md) {
896 if (unlikely(!info || !(info->mode & IP_TUNNEL_INFO_TX))) {
897 netdev_dbg(dev, "no tunnel metadata\n");
900 if (info && ip_tunnel_info_af(info) != AF_INET)
904 rt = geneve_get_v4_rt(skb, dev, &fl4, info);
910 sport = udp_flow_src_port(geneve->net, skb, 1, USHRT_MAX, true);
911 skb_reset_mac_header(skb);
916 const struct ip_tunnel_key *key = &info->key;
920 tunnel_id_to_vni(key->tun_id, vni);
921 if (info->options_len)
922 opts = ip_tunnel_info_opts(info);
924 if (key->tun_flags & TUNNEL_CSUM)
925 flags &= ~GENEVE_F_UDP_ZERO_CSUM_TX;
927 flags |= GENEVE_F_UDP_ZERO_CSUM_TX;
929 err = geneve_build_skb(rt, skb, key->tun_flags, vni,
930 info->options_len, opts, flags, xnet);
934 tos = ip_tunnel_ecn_encap(key->tos, iip, skb);
936 df = key->tun_flags & TUNNEL_DONT_FRAGMENT ? htons(IP_DF) : 0;
938 err = geneve_build_skb(rt, skb, 0, geneve->vni,
939 0, NULL, flags, xnet);
943 tos = ip_tunnel_ecn_encap(fl4.flowi4_tos, iip, skb);
945 if (!ttl && IN_MULTICAST(ntohl(fl4.daddr)))
947 ttl = ttl ? : ip4_dst_hoplimit(&rt->dst);
950 udp_tunnel_xmit_skb(rt, gs4->sock->sk, skb, fl4.saddr, fl4.daddr,
951 tos, ttl, df, sport, geneve->dst_port,
952 !net_eq(geneve->net, dev_net(geneve->dev)),
953 !!(flags & GENEVE_F_UDP_ZERO_CSUM_TX));
961 dev->stats.collisions++;
962 else if (err == -ENETUNREACH)
963 dev->stats.tx_carrier_errors++;
965 dev->stats.tx_errors++;
969 #if IS_ENABLED(CONFIG_IPV6)
970 static netdev_tx_t geneve6_xmit_skb(struct sk_buff *skb, struct net_device *dev,
971 struct ip_tunnel_info *info)
973 struct geneve_dev *geneve = netdev_priv(dev);
974 struct geneve_sock *gs6 = geneve->sock6;
975 struct dst_entry *dst = NULL;
976 const struct iphdr *iip; /* interior IP header */
982 bool xnet = !net_eq(geneve->net, dev_net(geneve->dev));
983 u32 flags = geneve->flags;
985 if (geneve->collect_md) {
986 if (unlikely(!info || !(info->mode & IP_TUNNEL_INFO_TX))) {
987 netdev_dbg(dev, "no tunnel metadata\n");
992 dst = geneve_get_v6_dst(skb, dev, &fl6, info);
998 sport = udp_flow_src_port(geneve->net, skb, 1, USHRT_MAX, true);
999 skb_reset_mac_header(skb);
1004 const struct ip_tunnel_key *key = &info->key;
1008 tunnel_id_to_vni(key->tun_id, vni);
1009 if (info->options_len)
1010 opts = ip_tunnel_info_opts(info);
1012 if (key->tun_flags & TUNNEL_CSUM)
1013 flags &= ~GENEVE_F_UDP_ZERO_CSUM6_TX;
1015 flags |= GENEVE_F_UDP_ZERO_CSUM6_TX;
1017 err = geneve6_build_skb(dst, skb, key->tun_flags, vni,
1018 info->options_len, opts,
1023 prio = ip_tunnel_ecn_encap(key->tos, iip, skb);
1025 label = info->key.label;
1027 err = geneve6_build_skb(dst, skb, 0, geneve->vni,
1028 0, NULL, flags, xnet);
1032 prio = ip_tunnel_ecn_encap(ip6_tclass(fl6.flowlabel),
1035 if (!ttl && ipv6_addr_is_multicast(&fl6.daddr))
1037 ttl = ttl ? : ip6_dst_hoplimit(dst);
1038 label = geneve->label;
1041 udp_tunnel6_xmit_skb(dst, gs6->sock->sk, skb, dev,
1042 &fl6.saddr, &fl6.daddr, prio, ttl, label,
1043 sport, geneve->dst_port,
1044 !!(flags & GENEVE_F_UDP_ZERO_CSUM6_TX));
1045 return NETDEV_TX_OK;
1051 dev->stats.collisions++;
1052 else if (err == -ENETUNREACH)
1053 dev->stats.tx_carrier_errors++;
1055 dev->stats.tx_errors++;
1056 return NETDEV_TX_OK;
1060 static netdev_tx_t geneve_xmit(struct sk_buff *skb, struct net_device *dev)
1062 struct geneve_dev *geneve = netdev_priv(dev);
1063 struct ip_tunnel_info *info = NULL;
1065 if (geneve->collect_md)
1066 info = skb_tunnel_info(skb);
1068 #if IS_ENABLED(CONFIG_IPV6)
1069 if ((info && ip_tunnel_info_af(info) == AF_INET6) ||
1070 (!info && geneve->remote.sa.sa_family == AF_INET6))
1071 return geneve6_xmit_skb(skb, dev, info);
1073 return geneve_xmit_skb(skb, dev, info);
1076 static int __geneve_change_mtu(struct net_device *dev, int new_mtu, bool strict)
1078 /* The max_mtu calculation does not take account of GENEVE
1079 * options, to avoid excluding potentially valid
1082 int max_mtu = IP_MAX_MTU - GENEVE_BASE_HLEN - sizeof(struct iphdr)
1083 - dev->hard_header_len;
1088 if (new_mtu > max_mtu) {
1099 static int geneve_change_mtu(struct net_device *dev, int new_mtu)
1101 return __geneve_change_mtu(dev, new_mtu, true);
1104 static int geneve_fill_metadata_dst(struct net_device *dev, struct sk_buff *skb)
1106 struct ip_tunnel_info *info = skb_tunnel_info(skb);
1107 struct geneve_dev *geneve = netdev_priv(dev);
1110 #if IS_ENABLED(CONFIG_IPV6)
1111 struct dst_entry *dst;
1115 if (ip_tunnel_info_af(info) == AF_INET) {
1116 rt = geneve_get_v4_rt(skb, dev, &fl4, info);
1121 info->key.u.ipv4.src = fl4.saddr;
1122 #if IS_ENABLED(CONFIG_IPV6)
1123 } else if (ip_tunnel_info_af(info) == AF_INET6) {
1124 dst = geneve_get_v6_dst(skb, dev, &fl6, info);
1126 return PTR_ERR(dst);
1129 info->key.u.ipv6.src = fl6.saddr;
1135 info->key.tp_src = udp_flow_src_port(geneve->net, skb,
1136 1, USHRT_MAX, true);
1137 info->key.tp_dst = geneve->dst_port;
1141 static const struct net_device_ops geneve_netdev_ops = {
1142 .ndo_init = geneve_init,
1143 .ndo_uninit = geneve_uninit,
1144 .ndo_open = geneve_open,
1145 .ndo_stop = geneve_stop,
1146 .ndo_start_xmit = geneve_xmit,
1147 .ndo_get_stats64 = ip_tunnel_get_stats64,
1148 .ndo_change_mtu = geneve_change_mtu,
1149 .ndo_validate_addr = eth_validate_addr,
1150 .ndo_set_mac_address = eth_mac_addr,
1151 .ndo_fill_metadata_dst = geneve_fill_metadata_dst,
1154 static void geneve_get_drvinfo(struct net_device *dev,
1155 struct ethtool_drvinfo *drvinfo)
1157 strlcpy(drvinfo->version, GENEVE_NETDEV_VER, sizeof(drvinfo->version));
1158 strlcpy(drvinfo->driver, "geneve", sizeof(drvinfo->driver));
1161 static const struct ethtool_ops geneve_ethtool_ops = {
1162 .get_drvinfo = geneve_get_drvinfo,
1163 .get_link = ethtool_op_get_link,
1166 /* Info for udev, that this is a virtual tunnel endpoint */
1167 static struct device_type geneve_type = {
1171 /* Calls the ndo_add_geneve_port of the caller in order to
1172 * supply the listening GENEVE udp ports. Callers are expected
1173 * to implement the ndo_add_geneve_port.
1175 void geneve_get_rx_port(struct net_device *dev)
1177 struct net *net = dev_net(dev);
1178 struct geneve_net *gn = net_generic(net, geneve_net_id);
1179 struct geneve_sock *gs;
1180 sa_family_t sa_family;
1185 list_for_each_entry_rcu(gs, &gn->sock_list, list) {
1187 sa_family = sk->sk_family;
1188 port = inet_sk(sk)->inet_sport;
1189 dev->netdev_ops->ndo_add_geneve_port(dev, sa_family, port);
1193 EXPORT_SYMBOL_GPL(geneve_get_rx_port);
1195 /* Initialize the device structure. */
1196 static void geneve_setup(struct net_device *dev)
1200 dev->netdev_ops = &geneve_netdev_ops;
1201 dev->ethtool_ops = &geneve_ethtool_ops;
1202 dev->destructor = free_netdev;
1204 SET_NETDEV_DEVTYPE(dev, &geneve_type);
1206 dev->features |= NETIF_F_LLTX;
1207 dev->features |= NETIF_F_SG | NETIF_F_HW_CSUM;
1208 dev->features |= NETIF_F_RXCSUM;
1209 dev->features |= NETIF_F_GSO_SOFTWARE;
1211 dev->hw_features |= NETIF_F_SG | NETIF_F_HW_CSUM | NETIF_F_RXCSUM;
1212 dev->hw_features |= NETIF_F_GSO_SOFTWARE;
1214 netif_keep_dst(dev);
1215 dev->priv_flags &= ~IFF_TX_SKB_SHARING;
1216 dev->priv_flags |= IFF_LIVE_ADDR_CHANGE | IFF_NO_QUEUE;
1217 eth_hw_addr_random(dev);
1220 static const struct nla_policy geneve_policy[IFLA_GENEVE_MAX + 1] = {
1221 [IFLA_GENEVE_ID] = { .type = NLA_U32 },
1222 [IFLA_GENEVE_REMOTE] = { .len = FIELD_SIZEOF(struct iphdr, daddr) },
1223 [IFLA_GENEVE_REMOTE6] = { .len = sizeof(struct in6_addr) },
1224 [IFLA_GENEVE_TTL] = { .type = NLA_U8 },
1225 [IFLA_GENEVE_TOS] = { .type = NLA_U8 },
1226 [IFLA_GENEVE_LABEL] = { .type = NLA_U32 },
1227 [IFLA_GENEVE_PORT] = { .type = NLA_U16 },
1228 [IFLA_GENEVE_COLLECT_METADATA] = { .type = NLA_FLAG },
1229 [IFLA_GENEVE_UDP_CSUM] = { .type = NLA_U8 },
1230 [IFLA_GENEVE_UDP_ZERO_CSUM6_TX] = { .type = NLA_U8 },
1231 [IFLA_GENEVE_UDP_ZERO_CSUM6_RX] = { .type = NLA_U8 },
1234 static int geneve_validate(struct nlattr *tb[], struct nlattr *data[])
1236 if (tb[IFLA_ADDRESS]) {
1237 if (nla_len(tb[IFLA_ADDRESS]) != ETH_ALEN)
1240 if (!is_valid_ether_addr(nla_data(tb[IFLA_ADDRESS])))
1241 return -EADDRNOTAVAIL;
1247 if (data[IFLA_GENEVE_ID]) {
1248 __u32 vni = nla_get_u32(data[IFLA_GENEVE_ID]);
1250 if (vni >= GENEVE_VID_MASK)
1257 static struct geneve_dev *geneve_find_dev(struct geneve_net *gn,
1259 union geneve_addr *remote,
1261 bool *tun_on_same_port,
1262 bool *tun_collect_md)
1264 struct geneve_dev *geneve, *t;
1266 *tun_on_same_port = false;
1267 *tun_collect_md = false;
1269 list_for_each_entry(geneve, &gn->geneve_list, next) {
1270 if (geneve->dst_port == dst_port) {
1271 *tun_collect_md = geneve->collect_md;
1272 *tun_on_same_port = true;
1274 if (!memcmp(vni, geneve->vni, sizeof(geneve->vni)) &&
1275 !memcmp(remote, &geneve->remote, sizeof(geneve->remote)) &&
1276 dst_port == geneve->dst_port)
1282 static int geneve_configure(struct net *net, struct net_device *dev,
1283 union geneve_addr *remote,
1284 __u32 vni, __u8 ttl, __u8 tos, __be32 label,
1285 __be16 dst_port, bool metadata, u32 flags)
1287 struct geneve_net *gn = net_generic(net, geneve_net_id);
1288 struct geneve_dev *t, *geneve = netdev_priv(dev);
1289 bool tun_collect_md, tun_on_same_port;
1295 (remote->sa.sa_family != AF_UNSPEC || vni || tos || ttl || label))
1301 geneve->vni[0] = (vni & 0x00ff0000) >> 16;
1302 geneve->vni[1] = (vni & 0x0000ff00) >> 8;
1303 geneve->vni[2] = vni & 0x000000ff;
1305 if ((remote->sa.sa_family == AF_INET &&
1306 IN_MULTICAST(ntohl(remote->sin.sin_addr.s_addr))) ||
1307 (remote->sa.sa_family == AF_INET6 &&
1308 ipv6_addr_is_multicast(&remote->sin6.sin6_addr)))
1310 if (label && remote->sa.sa_family != AF_INET6)
1313 geneve->remote = *remote;
1317 geneve->label = label;
1318 geneve->dst_port = dst_port;
1319 geneve->collect_md = metadata;
1320 geneve->flags = flags;
1322 t = geneve_find_dev(gn, dst_port, remote, geneve->vni,
1323 &tun_on_same_port, &tun_collect_md);
1327 /* make enough headroom for basic scenario */
1328 encap_len = GENEVE_BASE_HLEN + ETH_HLEN;
1329 if (remote->sa.sa_family == AF_INET)
1330 encap_len += sizeof(struct iphdr);
1332 encap_len += sizeof(struct ipv6hdr);
1333 dev->needed_headroom = encap_len + ETH_HLEN;
1336 if (tun_on_same_port)
1343 dst_cache_reset(&geneve->dst_cache);
1345 err = register_netdevice(dev);
1349 list_add(&geneve->next, &gn->geneve_list);
1353 static int geneve_newlink(struct net *net, struct net_device *dev,
1354 struct nlattr *tb[], struct nlattr *data[])
1356 __be16 dst_port = htons(GENEVE_UDP_PORT);
1357 __u8 ttl = 0, tos = 0;
1358 bool metadata = false;
1359 union geneve_addr remote = geneve_remote_unspec;
1364 if (data[IFLA_GENEVE_REMOTE] && data[IFLA_GENEVE_REMOTE6])
1367 if (data[IFLA_GENEVE_REMOTE]) {
1368 remote.sa.sa_family = AF_INET;
1369 remote.sin.sin_addr.s_addr =
1370 nla_get_in_addr(data[IFLA_GENEVE_REMOTE]);
1373 if (data[IFLA_GENEVE_REMOTE6]) {
1374 if (!IS_ENABLED(CONFIG_IPV6))
1375 return -EPFNOSUPPORT;
1377 remote.sa.sa_family = AF_INET6;
1378 remote.sin6.sin6_addr =
1379 nla_get_in6_addr(data[IFLA_GENEVE_REMOTE6]);
1381 if (ipv6_addr_type(&remote.sin6.sin6_addr) &
1382 IPV6_ADDR_LINKLOCAL) {
1383 netdev_dbg(dev, "link-local remote is unsupported\n");
1388 if (data[IFLA_GENEVE_ID])
1389 vni = nla_get_u32(data[IFLA_GENEVE_ID]);
1391 if (data[IFLA_GENEVE_TTL])
1392 ttl = nla_get_u8(data[IFLA_GENEVE_TTL]);
1394 if (data[IFLA_GENEVE_TOS])
1395 tos = nla_get_u8(data[IFLA_GENEVE_TOS]);
1397 if (data[IFLA_GENEVE_LABEL])
1398 label = nla_get_be32(data[IFLA_GENEVE_LABEL]) &
1399 IPV6_FLOWLABEL_MASK;
1401 if (data[IFLA_GENEVE_PORT])
1402 dst_port = nla_get_be16(data[IFLA_GENEVE_PORT]);
1404 if (data[IFLA_GENEVE_COLLECT_METADATA])
1407 if (data[IFLA_GENEVE_UDP_CSUM] &&
1408 !nla_get_u8(data[IFLA_GENEVE_UDP_CSUM]))
1409 flags |= GENEVE_F_UDP_ZERO_CSUM_TX;
1411 if (data[IFLA_GENEVE_UDP_ZERO_CSUM6_TX] &&
1412 nla_get_u8(data[IFLA_GENEVE_UDP_ZERO_CSUM6_TX]))
1413 flags |= GENEVE_F_UDP_ZERO_CSUM6_TX;
1415 if (data[IFLA_GENEVE_UDP_ZERO_CSUM6_RX] &&
1416 nla_get_u8(data[IFLA_GENEVE_UDP_ZERO_CSUM6_RX]))
1417 flags |= GENEVE_F_UDP_ZERO_CSUM6_RX;
1419 return geneve_configure(net, dev, &remote, vni, ttl, tos, label,
1420 dst_port, metadata, flags);
1423 static void geneve_dellink(struct net_device *dev, struct list_head *head)
1425 struct geneve_dev *geneve = netdev_priv(dev);
1427 list_del(&geneve->next);
1428 unregister_netdevice_queue(dev, head);
1431 static size_t geneve_get_size(const struct net_device *dev)
1433 return nla_total_size(sizeof(__u32)) + /* IFLA_GENEVE_ID */
1434 nla_total_size(sizeof(struct in6_addr)) + /* IFLA_GENEVE_REMOTE{6} */
1435 nla_total_size(sizeof(__u8)) + /* IFLA_GENEVE_TTL */
1436 nla_total_size(sizeof(__u8)) + /* IFLA_GENEVE_TOS */
1437 nla_total_size(sizeof(__be32)) + /* IFLA_GENEVE_LABEL */
1438 nla_total_size(sizeof(__be16)) + /* IFLA_GENEVE_PORT */
1439 nla_total_size(0) + /* IFLA_GENEVE_COLLECT_METADATA */
1440 nla_total_size(sizeof(__u8)) + /* IFLA_GENEVE_UDP_CSUM */
1441 nla_total_size(sizeof(__u8)) + /* IFLA_GENEVE_UDP_ZERO_CSUM6_TX */
1442 nla_total_size(sizeof(__u8)) + /* IFLA_GENEVE_UDP_ZERO_CSUM6_RX */
1446 static int geneve_fill_info(struct sk_buff *skb, const struct net_device *dev)
1448 struct geneve_dev *geneve = netdev_priv(dev);
1451 vni = (geneve->vni[0] << 16) | (geneve->vni[1] << 8) | geneve->vni[2];
1452 if (nla_put_u32(skb, IFLA_GENEVE_ID, vni))
1453 goto nla_put_failure;
1455 if (geneve->remote.sa.sa_family == AF_INET) {
1456 if (nla_put_in_addr(skb, IFLA_GENEVE_REMOTE,
1457 geneve->remote.sin.sin_addr.s_addr))
1458 goto nla_put_failure;
1459 #if IS_ENABLED(CONFIG_IPV6)
1461 if (nla_put_in6_addr(skb, IFLA_GENEVE_REMOTE6,
1462 &geneve->remote.sin6.sin6_addr))
1463 goto nla_put_failure;
1467 if (nla_put_u8(skb, IFLA_GENEVE_TTL, geneve->ttl) ||
1468 nla_put_u8(skb, IFLA_GENEVE_TOS, geneve->tos) ||
1469 nla_put_be32(skb, IFLA_GENEVE_LABEL, geneve->label))
1470 goto nla_put_failure;
1472 if (nla_put_be16(skb, IFLA_GENEVE_PORT, geneve->dst_port))
1473 goto nla_put_failure;
1475 if (geneve->collect_md) {
1476 if (nla_put_flag(skb, IFLA_GENEVE_COLLECT_METADATA))
1477 goto nla_put_failure;
1480 if (nla_put_u8(skb, IFLA_GENEVE_UDP_CSUM,
1481 !(geneve->flags & GENEVE_F_UDP_ZERO_CSUM_TX)) ||
1482 nla_put_u8(skb, IFLA_GENEVE_UDP_ZERO_CSUM6_TX,
1483 !!(geneve->flags & GENEVE_F_UDP_ZERO_CSUM6_TX)) ||
1484 nla_put_u8(skb, IFLA_GENEVE_UDP_ZERO_CSUM6_RX,
1485 !!(geneve->flags & GENEVE_F_UDP_ZERO_CSUM6_RX)))
1486 goto nla_put_failure;
1494 static struct rtnl_link_ops geneve_link_ops __read_mostly = {
1496 .maxtype = IFLA_GENEVE_MAX,
1497 .policy = geneve_policy,
1498 .priv_size = sizeof(struct geneve_dev),
1499 .setup = geneve_setup,
1500 .validate = geneve_validate,
1501 .newlink = geneve_newlink,
1502 .dellink = geneve_dellink,
1503 .get_size = geneve_get_size,
1504 .fill_info = geneve_fill_info,
1507 struct net_device *geneve_dev_create_fb(struct net *net, const char *name,
1508 u8 name_assign_type, u16 dst_port)
1510 struct nlattr *tb[IFLA_MAX + 1];
1511 struct net_device *dev;
1514 memset(tb, 0, sizeof(tb));
1515 dev = rtnl_create_link(net, name, name_assign_type,
1516 &geneve_link_ops, tb);
1520 err = geneve_configure(net, dev, &geneve_remote_unspec,
1521 0, 0, 0, 0, htons(dst_port), true,
1522 GENEVE_F_UDP_ZERO_CSUM6_RX);
1526 /* openvswitch users expect packet sizes to be unrestricted,
1527 * so set the largest MTU we can.
1529 err = __geneve_change_mtu(dev, IP_MAX_MTU, false);
1537 return ERR_PTR(err);
1539 EXPORT_SYMBOL_GPL(geneve_dev_create_fb);
1541 static __net_init int geneve_init_net(struct net *net)
1543 struct geneve_net *gn = net_generic(net, geneve_net_id);
1545 INIT_LIST_HEAD(&gn->geneve_list);
1546 INIT_LIST_HEAD(&gn->sock_list);
1550 static void __net_exit geneve_exit_net(struct net *net)
1552 struct geneve_net *gn = net_generic(net, geneve_net_id);
1553 struct geneve_dev *geneve, *next;
1554 struct net_device *dev, *aux;
1559 /* gather any geneve devices that were moved into this ns */
1560 for_each_netdev_safe(net, dev, aux)
1561 if (dev->rtnl_link_ops == &geneve_link_ops)
1562 unregister_netdevice_queue(dev, &list);
1564 /* now gather any other geneve devices that were created in this ns */
1565 list_for_each_entry_safe(geneve, next, &gn->geneve_list, next) {
1566 /* If geneve->dev is in the same netns, it was already added
1567 * to the list by the previous loop.
1569 if (!net_eq(dev_net(geneve->dev), net))
1570 unregister_netdevice_queue(geneve->dev, &list);
1573 /* unregister the devices gathered above */
1574 unregister_netdevice_many(&list);
1578 static struct pernet_operations geneve_net_ops = {
1579 .init = geneve_init_net,
1580 .exit = geneve_exit_net,
1581 .id = &geneve_net_id,
1582 .size = sizeof(struct geneve_net),
1585 static int __init geneve_init_module(void)
1589 rc = register_pernet_subsys(&geneve_net_ops);
1593 rc = rtnl_link_register(&geneve_link_ops);
1599 unregister_pernet_subsys(&geneve_net_ops);
1603 late_initcall(geneve_init_module);
1605 static void __exit geneve_cleanup_module(void)
1607 rtnl_link_unregister(&geneve_link_ops);
1608 unregister_pernet_subsys(&geneve_net_ops);
1610 module_exit(geneve_cleanup_module);
1612 MODULE_LICENSE("GPL");
1613 MODULE_VERSION(GENEVE_NETDEV_VER);
1614 MODULE_AUTHOR("John W. Linville <linville@tuxdriver.com>");
1615 MODULE_DESCRIPTION("Interface driver for GENEVE encapsulated traffic");
1616 MODULE_ALIAS_RTNL_LINK("geneve");