2 * Copyright (c) 2007, 2008, 2009, 2010 Nicira Networks.
3 * Distributed under the terms of the GNU GPL version 2.
5 * Significant portions of this file may be copied from parts of the Linux
6 * kernel, by Linus Torvalds and others.
9 /* Functions for managing the dp interface/device. */
11 #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
13 #include <linux/init.h>
14 #include <linux/module.h>
16 #include <linux/if_arp.h>
17 #include <linux/if_vlan.h>
20 #include <linux/delay.h>
21 #include <linux/time.h>
22 #include <linux/etherdevice.h>
23 #include <linux/kernel.h>
24 #include <linux/kthread.h>
25 #include <linux/mutex.h>
26 #include <linux/percpu.h>
27 #include <linux/rcupdate.h>
28 #include <linux/tcp.h>
29 #include <linux/udp.h>
30 #include <linux/version.h>
31 #include <linux/ethtool.h>
32 #include <linux/wait.h>
33 #include <asm/system.h>
34 #include <asm/div64.h>
36 #include <linux/highmem.h>
37 #include <linux/netfilter_bridge.h>
38 #include <linux/netfilter_ipv4.h>
39 #include <linux/inetdevice.h>
40 #include <linux/list.h>
41 #include <linux/rculist.h>
42 #include <linux/dmi.h>
43 #include <net/inet_ecn.h>
44 #include <linux/compat.h>
46 #include "openvswitch/datapath-protocol.h"
51 #include "loop_counter.h"
52 #include "odp-compat.h"
54 #include "vport-internal_dev.h"
58 int (*dp_ioctl_hook)(struct net_device *dev, struct ifreq *rq, int cmd);
59 EXPORT_SYMBOL(dp_ioctl_hook);
61 /* Datapaths. Protected on the read side by rcu_read_lock, on the write side
64 * dp_mutex nests inside the RTNL lock: if you need both you must take the RTNL
67 * It is safe to access the datapath and vport structures with just
70 static struct datapath __rcu *dps[ODP_MAX];
71 static DEFINE_MUTEX(dp_mutex);
73 static int new_vport(struct datapath *, struct odp_port *, int port_no);
75 /* Must be called with rcu_read_lock or dp_mutex. */
76 struct datapath *get_dp(int dp_idx)
78 if (dp_idx < 0 || dp_idx >= ODP_MAX)
80 return rcu_dereference_check(dps[dp_idx], rcu_read_lock_held() ||
81 lockdep_is_held(&dp_mutex));
83 EXPORT_SYMBOL_GPL(get_dp);
85 static struct datapath *get_dp_locked(int dp_idx)
89 mutex_lock(&dp_mutex);
92 mutex_lock(&dp->mutex);
93 mutex_unlock(&dp_mutex);
97 static struct tbl *get_table_protected(struct datapath *dp)
99 return rcu_dereference_protected(dp->table, lockdep_is_held(&dp->mutex));
102 /* Must be called with rcu_read_lock or RTNL lock. */
103 const char *dp_name(const struct datapath *dp)
105 return vport_get_name(rcu_dereference_rtnl(dp->ports[ODPP_LOCAL]));
108 static inline size_t br_nlmsg_size(void)
110 return NLMSG_ALIGN(sizeof(struct ifinfomsg))
111 + nla_total_size(IFNAMSIZ) /* IFLA_IFNAME */
112 + nla_total_size(MAX_ADDR_LEN) /* IFLA_ADDRESS */
113 + nla_total_size(4) /* IFLA_MASTER */
114 + nla_total_size(4) /* IFLA_MTU */
115 + nla_total_size(4) /* IFLA_LINK */
116 + nla_total_size(1); /* IFLA_OPERSTATE */
119 static int dp_fill_ifinfo(struct sk_buff *skb,
120 const struct vport *port,
121 int event, unsigned int flags)
123 const struct datapath *dp = port->dp;
124 int ifindex = vport_get_ifindex(port);
125 int iflink = vport_get_iflink(port);
126 struct ifinfomsg *hdr;
127 struct nlmsghdr *nlh;
135 nlh = nlmsg_put(skb, 0, 0, event, sizeof(*hdr), flags);
139 hdr = nlmsg_data(nlh);
140 hdr->ifi_family = AF_BRIDGE;
142 hdr->ifi_type = ARPHRD_ETHER;
143 hdr->ifi_index = ifindex;
144 hdr->ifi_flags = vport_get_flags(port);
147 NLA_PUT_STRING(skb, IFLA_IFNAME, vport_get_name(port));
148 NLA_PUT_U32(skb, IFLA_MASTER,
149 vport_get_ifindex(rtnl_dereference(dp->ports[ODPP_LOCAL])));
150 NLA_PUT_U32(skb, IFLA_MTU, vport_get_mtu(port));
151 #ifdef IFLA_OPERSTATE
152 NLA_PUT_U8(skb, IFLA_OPERSTATE,
153 vport_is_running(port)
154 ? vport_get_operstate(port)
158 NLA_PUT(skb, IFLA_ADDRESS, ETH_ALEN, vport_get_addr(port));
160 if (ifindex != iflink)
161 NLA_PUT_U32(skb, IFLA_LINK,iflink);
163 return nlmsg_end(skb, nlh);
166 nlmsg_cancel(skb, nlh);
170 static void dp_ifinfo_notify(int event, struct vport *port)
175 skb = nlmsg_new(br_nlmsg_size(), GFP_KERNEL);
179 err = dp_fill_ifinfo(skb, port, event, 0);
181 /* -EMSGSIZE implies BUG in br_nlmsg_size() */
182 WARN_ON(err == -EMSGSIZE);
186 rtnl_notify(skb, &init_net, 0, RTNLGRP_LINK, NULL, GFP_KERNEL);
190 rtnl_set_sk_err(&init_net, RTNLGRP_LINK, err);
193 static void release_dp(struct kobject *kobj)
195 struct datapath *dp = container_of(kobj, struct datapath, ifobj);
199 static struct kobj_type dp_ktype = {
200 .release = release_dp
203 static int create_dp(int dp_idx, const char __user *devnamep)
205 struct odp_port internal_dev_port;
206 char devname[IFNAMSIZ];
212 int retval = strncpy_from_user(devname, devnamep, IFNAMSIZ);
216 } else if (retval >= IFNAMSIZ) {
221 snprintf(devname, sizeof devname, "of%d", dp_idx);
225 mutex_lock(&dp_mutex);
227 if (!try_module_get(THIS_MODULE))
230 /* Exit early if a datapath with that number already exists.
231 * (We don't use -EEXIST because that's ambiguous with 'devname'
232 * conflicting with an existing network device name.) */
238 dp = kzalloc(sizeof *dp, GFP_KERNEL);
241 INIT_LIST_HEAD(&dp->port_list);
242 mutex_init(&dp->mutex);
244 for (i = 0; i < DP_N_QUEUES; i++)
245 skb_queue_head_init(&dp->queues[i]);
246 init_waitqueue_head(&dp->waitqueue);
248 /* Initialize kobject for bridge. This will be added as
249 * /sys/class/net/<devname>/brif later, if sysfs is enabled. */
250 dp->ifobj.kset = NULL;
251 kobject_init(&dp->ifobj, &dp_ktype);
253 /* Allocate table. */
255 rcu_assign_pointer(dp->table, tbl_create(TBL_MIN_BUCKETS));
259 /* Set up our datapath device. */
260 BUILD_BUG_ON(sizeof(internal_dev_port.devname) != sizeof(devname));
261 strcpy(internal_dev_port.devname, devname);
262 strcpy(internal_dev_port.type, "internal");
263 err = new_vport(dp, &internal_dev_port, ODPP_LOCAL);
268 goto err_destroy_table;
272 dp->stats_percpu = alloc_percpu(struct dp_stats_percpu);
273 if (!dp->stats_percpu) {
275 goto err_destroy_local_port;
278 rcu_assign_pointer(dps[dp_idx], dp);
281 mutex_unlock(&dp_mutex);
286 err_destroy_local_port:
287 dp_detach_port(dp->ports[ODPP_LOCAL]);
289 tbl_destroy(get_table_protected(dp), NULL);
293 module_put(THIS_MODULE);
295 mutex_unlock(&dp_mutex);
301 static void do_destroy_dp(struct datapath *dp)
306 list_for_each_entry_safe (p, n, &dp->port_list, node)
307 if (p->port_no != ODPP_LOCAL)
312 rcu_assign_pointer(dps[dp->dp_idx], NULL);
314 dp_detach_port(dp->ports[ODPP_LOCAL]);
315 tbl_destroy(get_table_protected(dp), flow_free_tbl);
317 for (i = 0; i < DP_N_QUEUES; i++)
318 skb_queue_purge(&dp->queues[i]);
319 free_percpu(dp->stats_percpu);
320 kobject_put(&dp->ifobj);
321 module_put(THIS_MODULE);
324 static int destroy_dp(int dp_idx)
330 mutex_lock(&dp_mutex);
340 mutex_unlock(&dp_mutex);
345 /* Called with RTNL lock and dp_mutex. */
346 static int new_vport(struct datapath *dp, struct odp_port *odp_port, int port_no)
348 struct vport_parms parms;
351 parms.name = odp_port->devname;
352 parms.type = odp_port->type;
353 parms.config = odp_port->config;
355 parms.port_no = port_no;
358 vport = vport_add(&parms);
362 return PTR_ERR(vport);
364 rcu_assign_pointer(dp->ports[port_no], vport);
365 list_add_rcu(&vport->node, &dp->port_list);
368 dp_ifinfo_notify(RTM_NEWLINK, vport);
373 static int attach_port(int dp_idx, struct odp_port __user *portp)
376 struct odp_port port;
381 if (copy_from_user(&port, portp, sizeof port))
383 port.devname[IFNAMSIZ - 1] = '\0';
384 port.type[VPORT_TYPE_SIZE - 1] = '\0';
387 dp = get_dp_locked(dp_idx);
390 goto out_unlock_rtnl;
392 for (port_no = 1; port_no < DP_MAX_PORTS; port_no++)
393 if (!dp->ports[port_no])
399 err = new_vport(dp, &port, port_no);
403 set_internal_devs_mtu(dp);
404 dp_sysfs_add_if(dp->ports[port_no]);
406 err = put_user(port_no, &portp->port);
409 mutex_unlock(&dp->mutex);
416 int dp_detach_port(struct vport *p)
422 if (p->port_no != ODPP_LOCAL)
424 dp_ifinfo_notify(RTM_DELLINK, p);
426 /* First drop references to device. */
428 list_del_rcu(&p->node);
429 rcu_assign_pointer(p->dp->ports[p->port_no], NULL);
431 /* Then destroy it. */
439 static int detach_port(int dp_idx, int port_no)
446 if (port_no < 0 || port_no >= DP_MAX_PORTS || port_no == ODPP_LOCAL)
450 dp = get_dp_locked(dp_idx);
453 goto out_unlock_rtnl;
455 p = dp->ports[port_no];
460 err = dp_detach_port(p);
463 mutex_unlock(&dp->mutex);
470 /* Must be called with rcu_read_lock. */
471 void dp_process_received_packet(struct vport *p, struct sk_buff *skb)
473 struct datapath *dp = p->dp;
474 struct dp_stats_percpu *stats;
475 int stats_counter_off;
476 struct sw_flow_actions *acts;
477 struct loop_counter *loop;
480 OVS_CB(skb)->vport = p;
482 if (!OVS_CB(skb)->flow) {
483 struct odp_flow_key key;
484 struct tbl_node *flow_node;
487 /* Extract flow from 'skb' into 'key'. */
488 error = flow_extract(skb, p ? p->port_no : ODPP_NONE, &key, &is_frag);
489 if (unlikely(error)) {
494 if (is_frag && dp->drop_frags) {
496 stats_counter_off = offsetof(struct dp_stats_percpu, n_frags);
501 flow_node = tbl_lookup(rcu_dereference(dp->table), &key,
502 flow_hash(&key), flow_cmp);
503 if (unlikely(!flow_node)) {
504 dp_output_control(dp, skb, _ODPL_MISS_NR,
505 (__force u64)OVS_CB(skb)->tun_id);
506 stats_counter_off = offsetof(struct dp_stats_percpu, n_missed);
510 OVS_CB(skb)->flow = flow_cast(flow_node);
513 stats_counter_off = offsetof(struct dp_stats_percpu, n_hit);
514 flow_used(OVS_CB(skb)->flow, skb);
516 acts = rcu_dereference(OVS_CB(skb)->flow->sf_acts);
518 /* Check whether we've looped too much. */
519 loop = loop_get_counter();
520 if (unlikely(++loop->count > MAX_LOOPS))
521 loop->looping = true;
522 if (unlikely(loop->looping)) {
523 loop_suppress(dp, acts);
528 /* Execute actions. */
529 execute_actions(dp, skb, &OVS_CB(skb)->flow->key, acts->actions,
532 /* Check whether sub-actions looped too much. */
533 if (unlikely(loop->looping))
534 loop_suppress(dp, acts);
537 /* Decrement loop counter. */
539 loop->looping = false;
543 /* Update datapath statistics. */
545 stats = per_cpu_ptr(dp->stats_percpu, smp_processor_id());
547 write_seqcount_begin(&stats->seqlock);
548 (*(u64 *)((u8 *)stats + stats_counter_off))++;
549 write_seqcount_end(&stats->seqlock);
554 /* Append each packet in 'skb' list to 'queue'. There will be only one packet
555 * unless we broke up a GSO packet. */
556 static int queue_control_packets(struct sk_buff *skb, struct sk_buff_head *queue,
557 int queue_no, u64 arg)
559 struct sk_buff *nskb;
563 if (OVS_CB(skb)->vport)
564 port_no = OVS_CB(skb)->vport->port_no;
566 port_no = ODPP_LOCAL;
569 struct odp_msg *header;
574 err = skb_cow(skb, sizeof *header);
578 header = (struct odp_msg*)__skb_push(skb, sizeof *header);
579 header->type = queue_no;
580 header->length = skb->len;
581 header->port = port_no;
583 skb_queue_tail(queue, skb);
591 while ((skb = nskb) != NULL) {
598 int dp_output_control(struct datapath *dp, struct sk_buff *skb, int queue_no,
601 struct dp_stats_percpu *stats;
602 struct sk_buff_head *queue;
605 WARN_ON_ONCE(skb_shared(skb));
606 BUG_ON(queue_no != _ODPL_MISS_NR && queue_no != _ODPL_ACTION_NR && queue_no != _ODPL_SFLOW_NR);
607 queue = &dp->queues[queue_no];
609 if (skb_queue_len(queue) >= DP_MAX_QUEUE_LEN)
612 forward_ip_summed(skb);
614 err = vswitch_skb_checksum_setup(skb);
618 /* Break apart GSO packets into their component pieces. Otherwise
619 * userspace may try to stuff a 64kB packet into a 1500-byte MTU. */
620 if (skb_is_gso(skb)) {
621 struct sk_buff *nskb = skb_gso_segment(skb, NETIF_F_SG | NETIF_F_HW_CSUM);
631 err = queue_control_packets(skb, queue, queue_no, arg);
632 wake_up_interruptible(&dp->waitqueue);
639 stats = per_cpu_ptr(dp->stats_percpu, smp_processor_id());
641 write_seqcount_begin(&stats->seqlock);
643 write_seqcount_end(&stats->seqlock);
650 static int flush_flows(struct datapath *dp)
652 struct tbl *old_table = get_table_protected(dp);
653 struct tbl *new_table;
655 new_table = tbl_create(TBL_MIN_BUCKETS);
659 rcu_assign_pointer(dp->table, new_table);
661 tbl_deferred_destroy(old_table, flow_free_tbl);
666 static int validate_actions(const struct nlattr *actions, u32 actions_len)
668 const struct nlattr *a;
671 nla_for_each_attr(a, actions, actions_len, rem) {
672 static const u32 action_lens[ODPAT_MAX + 1] = {
674 [ODPAT_CONTROLLER] = 8,
675 [ODPAT_SET_DL_TCI] = 2,
676 [ODPAT_STRIP_VLAN] = 0,
677 [ODPAT_SET_DL_SRC] = ETH_ALEN,
678 [ODPAT_SET_DL_DST] = ETH_ALEN,
679 [ODPAT_SET_NW_SRC] = 4,
680 [ODPAT_SET_NW_DST] = 4,
681 [ODPAT_SET_NW_TOS] = 1,
682 [ODPAT_SET_TP_SRC] = 2,
683 [ODPAT_SET_TP_DST] = 2,
684 [ODPAT_SET_TUNNEL] = 8,
685 [ODPAT_SET_PRIORITY] = 4,
686 [ODPAT_POP_PRIORITY] = 0,
687 [ODPAT_DROP_SPOOFED_ARP] = 0,
689 int type = nla_type(a);
691 if (type > ODPAT_MAX || nla_len(a) != action_lens[type])
698 case ODPAT_CONTROLLER:
699 case ODPAT_STRIP_VLAN:
700 case ODPAT_SET_DL_SRC:
701 case ODPAT_SET_DL_DST:
702 case ODPAT_SET_NW_SRC:
703 case ODPAT_SET_NW_DST:
704 case ODPAT_SET_TP_SRC:
705 case ODPAT_SET_TP_DST:
706 case ODPAT_SET_TUNNEL:
707 case ODPAT_SET_PRIORITY:
708 case ODPAT_POP_PRIORITY:
709 case ODPAT_DROP_SPOOFED_ARP:
710 /* No validation needed. */
714 if (nla_get_u32(a) >= DP_MAX_PORTS)
717 case ODPAT_SET_DL_TCI:
718 if (nla_get_be16(a) & htons(VLAN_CFI_MASK))
722 case ODPAT_SET_NW_TOS:
723 if (nla_get_u8(a) & INET_ECN_MASK)
738 static struct sw_flow_actions *get_actions(const struct odp_flow *flow)
740 struct sw_flow_actions *actions;
743 actions = flow_actions_alloc(flow->actions_len);
744 error = PTR_ERR(actions);
749 if (copy_from_user(actions->actions,
750 (struct nlattr __user __force *)flow->actions,
752 goto error_free_actions;
753 error = validate_actions(actions->actions, actions->actions_len);
755 goto error_free_actions;
762 return ERR_PTR(error);
765 static void get_stats(struct sw_flow *flow, struct odp_flow_stats *stats)
768 struct timespec offset_ts, used, now_mono;
770 ktime_get_ts(&now_mono);
771 jiffies_to_timespec(jiffies - flow->used, &offset_ts);
772 set_normalized_timespec(&used, now_mono.tv_sec - offset_ts.tv_sec,
773 now_mono.tv_nsec - offset_ts.tv_nsec);
775 stats->used_sec = used.tv_sec;
776 stats->used_nsec = used.tv_nsec;
779 stats->used_nsec = 0;
782 stats->n_packets = flow->packet_count;
783 stats->n_bytes = flow->byte_count;
785 stats->tcp_flags = flow->tcp_flags;
789 static void clear_stats(struct sw_flow *flow)
793 flow->packet_count = 0;
794 flow->byte_count = 0;
797 static int expand_table(struct datapath *dp)
799 struct tbl *old_table = get_table_protected(dp);
800 struct tbl *new_table;
802 new_table = tbl_expand(old_table);
803 if (IS_ERR(new_table))
804 return PTR_ERR(new_table);
806 rcu_assign_pointer(dp->table, new_table);
807 tbl_deferred_destroy(old_table, NULL);
812 static int do_put_flow(struct datapath *dp, struct odp_flow_put *uf,
813 struct odp_flow_stats *stats)
815 struct tbl_node *flow_node;
816 struct sw_flow *flow;
821 hash = flow_hash(&uf->flow.key);
822 table = get_table_protected(dp);
823 flow_node = tbl_lookup(table, &uf->flow.key, hash, flow_cmp);
826 struct sw_flow_actions *acts;
829 if (!(uf->flags & ODPPF_CREATE))
832 /* Expand table, if necessary, to make room. */
833 if (tbl_count(table) >= tbl_n_buckets(table)) {
834 error = expand_table(dp);
837 table = get_table_protected(dp);
843 error = PTR_ERR(flow);
846 flow->key = uf->flow.key;
849 /* Obtain actions. */
850 acts = get_actions(&uf->flow);
851 error = PTR_ERR(acts);
853 goto error_free_flow;
854 rcu_assign_pointer(flow->sf_acts, acts);
856 /* Put flow in bucket. */
857 error = tbl_insert(table, &flow->tbl_node, hash);
859 goto error_free_flow_acts;
861 memset(stats, 0, sizeof(struct odp_flow_stats));
863 /* We found a matching flow. */
864 struct sw_flow_actions *old_acts, *new_acts;
866 flow = flow_cast(flow_node);
868 /* Bail out if we're not allowed to modify an existing flow. */
870 if (!(uf->flags & ODPPF_MODIFY))
874 new_acts = get_actions(&uf->flow);
875 error = PTR_ERR(new_acts);
876 if (IS_ERR(new_acts))
879 old_acts = rcu_dereference_protected(flow->sf_acts,
880 lockdep_is_held(&dp->mutex));
881 if (old_acts->actions_len != new_acts->actions_len ||
882 memcmp(old_acts->actions, new_acts->actions,
883 old_acts->actions_len)) {
884 rcu_assign_pointer(flow->sf_acts, new_acts);
885 flow_deferred_free_acts(old_acts);
890 /* Fetch stats, then clear them if necessary. */
891 spin_lock_bh(&flow->lock);
892 get_stats(flow, stats);
893 if (uf->flags & ODPPF_ZERO_STATS)
895 spin_unlock_bh(&flow->lock);
900 error_free_flow_acts:
901 kfree(flow->sf_acts);
903 flow->sf_acts = NULL;
909 static int put_flow(struct datapath *dp, struct odp_flow_put __user *ufp)
911 struct odp_flow_stats stats;
912 struct odp_flow_put uf;
915 if (copy_from_user(&uf, ufp, sizeof(struct odp_flow_put)))
918 error = do_put_flow(dp, &uf, &stats);
922 if (copy_to_user(&ufp->flow.stats, &stats,
923 sizeof(struct odp_flow_stats)))
929 static int do_answer_query(struct datapath *dp, struct sw_flow *flow,
931 struct odp_flow_stats __user *ustats,
932 struct nlattr __user *actions,
933 u32 __user *actions_lenp)
935 struct sw_flow_actions *sf_acts;
936 struct odp_flow_stats stats;
939 spin_lock_bh(&flow->lock);
940 get_stats(flow, &stats);
941 if (query_flags & ODPFF_ZERO_TCP_FLAGS)
944 spin_unlock_bh(&flow->lock);
946 if (copy_to_user(ustats, &stats, sizeof(struct odp_flow_stats)) ||
947 get_user(actions_len, actions_lenp))
953 sf_acts = rcu_dereference_protected(flow->sf_acts,
954 lockdep_is_held(&dp->mutex));
955 if (put_user(sf_acts->actions_len, actions_lenp) ||
956 (actions && copy_to_user(actions, sf_acts->actions,
957 min(sf_acts->actions_len, actions_len))))
963 static int answer_query(struct datapath *dp, struct sw_flow *flow,
964 u32 query_flags, struct odp_flow __user *ufp)
966 struct nlattr __user *actions;
968 if (get_user(actions, (struct nlattr __user * __user *)&ufp->actions))
971 return do_answer_query(dp, flow, query_flags,
972 &ufp->stats, actions, &ufp->actions_len);
975 static struct sw_flow *do_del_flow(struct datapath *dp, struct odp_flow_key *key)
977 struct tbl *table = get_table_protected(dp);
978 struct tbl_node *flow_node;
981 flow_node = tbl_lookup(table, key, flow_hash(key), flow_cmp);
983 return ERR_PTR(-ENOENT);
985 error = tbl_remove(table, flow_node);
987 return ERR_PTR(error);
989 /* XXX Returned flow_node's statistics might lose a few packets, since
990 * other CPUs can be using this flow. We used to synchronize_rcu() to
991 * make sure that we get completely accurate stats, but that blows our
992 * performance, badly. */
993 return flow_cast(flow_node);
996 static int del_flow(struct datapath *dp, struct odp_flow __user *ufp)
998 struct sw_flow *flow;
1002 if (copy_from_user(&uf, ufp, sizeof uf))
1005 flow = do_del_flow(dp, &uf.key);
1007 return PTR_ERR(flow);
1009 error = answer_query(dp, flow, 0, ufp);
1010 flow_deferred_free(flow);
1014 static int do_query_flows(struct datapath *dp, const struct odp_flowvec *flowvec)
1016 struct tbl *table = get_table_protected(dp);
1019 for (i = 0; i < flowvec->n_flows; i++) {
1020 struct odp_flow __user *ufp = (struct odp_flow __user __force *)&flowvec->flows[i];
1022 struct tbl_node *flow_node;
1025 if (copy_from_user(&uf, ufp, sizeof uf))
1028 flow_node = tbl_lookup(table, &uf.key, flow_hash(&uf.key), flow_cmp);
1030 error = put_user(ENOENT, &ufp->stats.error);
1032 error = answer_query(dp, flow_cast(flow_node), uf.flags, ufp);
1036 return flowvec->n_flows;
1039 struct list_flows_cbdata {
1040 struct datapath *dp;
1041 struct odp_flow __user *uflows;
1046 static int list_flow(struct tbl_node *node, void *cbdata_)
1048 struct sw_flow *flow = flow_cast(node);
1049 struct list_flows_cbdata *cbdata = cbdata_;
1050 struct odp_flow __user *ufp = &cbdata->uflows[cbdata->listed_flows++];
1053 if (copy_to_user(&ufp->key, &flow->key, sizeof flow->key))
1055 error = answer_query(cbdata->dp, flow, 0, ufp);
1059 if (cbdata->listed_flows >= cbdata->n_flows)
1060 return cbdata->listed_flows;
1064 static int do_list_flows(struct datapath *dp, const struct odp_flowvec *flowvec)
1066 struct list_flows_cbdata cbdata;
1069 if (!flowvec->n_flows)
1073 cbdata.uflows = (struct odp_flow __user __force*)flowvec->flows;
1074 cbdata.n_flows = flowvec->n_flows;
1075 cbdata.listed_flows = 0;
1077 error = tbl_foreach(get_table_protected(dp), list_flow, &cbdata);
1078 return error ? error : cbdata.listed_flows;
1081 static int do_flowvec_ioctl(struct datapath *dp, unsigned long argp,
1082 int (*function)(struct datapath *,
1083 const struct odp_flowvec *))
1085 struct odp_flowvec __user *uflowvec;
1086 struct odp_flowvec flowvec;
1089 uflowvec = (struct odp_flowvec __user *)argp;
1090 if (copy_from_user(&flowvec, uflowvec, sizeof flowvec))
1093 if (flowvec.n_flows > INT_MAX / sizeof(struct odp_flow))
1096 retval = function(dp, &flowvec);
1097 return (retval < 0 ? retval
1098 : retval == flowvec.n_flows ? 0
1099 : put_user(retval, &uflowvec->n_flows));
1102 static int do_execute(struct datapath *dp, const struct odp_execute *execute)
1104 struct odp_flow_key key;
1105 struct sk_buff *skb;
1106 struct sw_flow_actions *actions;
1112 if (execute->length < ETH_HLEN || execute->length > 65535)
1115 actions = flow_actions_alloc(execute->actions_len);
1116 if (IS_ERR(actions)) {
1117 err = PTR_ERR(actions);
1122 if (copy_from_user(actions->actions,
1123 (struct nlattr __user __force *)execute->actions, execute->actions_len))
1124 goto error_free_actions;
1126 err = validate_actions(actions->actions, execute->actions_len);
1128 goto error_free_actions;
1131 skb = alloc_skb(execute->length, GFP_KERNEL);
1133 goto error_free_actions;
1136 if (copy_from_user(skb_put(skb, execute->length),
1137 (const void __user __force *)execute->data,
1139 goto error_free_skb;
1141 skb_reset_mac_header(skb);
1144 /* Normally, setting the skb 'protocol' field would be handled by a
1145 * call to eth_type_trans(), but it assumes there's a sending
1146 * device, which we may not have. */
1147 if (ntohs(eth->h_proto) >= 1536)
1148 skb->protocol = eth->h_proto;
1150 skb->protocol = htons(ETH_P_802_2);
1152 err = flow_extract(skb, -1, &key, &is_frag);
1154 goto error_free_skb;
1157 err = execute_actions(dp, skb, &key, actions->actions, actions->actions_len);
1171 static int execute_packet(struct datapath *dp, const struct odp_execute __user *executep)
1173 struct odp_execute execute;
1175 if (copy_from_user(&execute, executep, sizeof execute))
1178 return do_execute(dp, &execute);
1181 static int get_dp_stats(struct datapath *dp, struct odp_stats __user *statsp)
1183 struct tbl *table = get_table_protected(dp);
1184 struct odp_stats stats;
1187 stats.n_flows = tbl_count(table);
1188 stats.cur_capacity = tbl_n_buckets(table);
1189 stats.max_capacity = TBL_MAX_BUCKETS;
1190 stats.n_ports = dp->n_ports;
1191 stats.max_ports = DP_MAX_PORTS;
1192 stats.n_frags = stats.n_hit = stats.n_missed = stats.n_lost = 0;
1193 for_each_possible_cpu(i) {
1194 const struct dp_stats_percpu *percpu_stats;
1195 struct dp_stats_percpu local_stats;
1198 percpu_stats = per_cpu_ptr(dp->stats_percpu, i);
1201 seqcount = read_seqcount_begin(&percpu_stats->seqlock);
1202 local_stats = *percpu_stats;
1203 } while (read_seqcount_retry(&percpu_stats->seqlock, seqcount));
1205 stats.n_frags += local_stats.n_frags;
1206 stats.n_hit += local_stats.n_hit;
1207 stats.n_missed += local_stats.n_missed;
1208 stats.n_lost += local_stats.n_lost;
1210 stats.max_miss_queue = DP_MAX_QUEUE_LEN;
1211 stats.max_action_queue = DP_MAX_QUEUE_LEN;
1212 return copy_to_user(statsp, &stats, sizeof stats) ? -EFAULT : 0;
1215 /* MTU of the dp pseudo-device: ETH_DATA_LEN or the minimum of the ports */
1216 int dp_min_mtu(const struct datapath *dp)
1223 list_for_each_entry_rcu (p, &dp->port_list, node) {
1226 /* Skip any internal ports, since that's what we're trying to
1228 if (is_internal_vport(p))
1231 dev_mtu = vport_get_mtu(p);
1232 if (!mtu || dev_mtu < mtu)
1236 return mtu ? mtu : ETH_DATA_LEN;
1239 /* Sets the MTU of all datapath devices to the minimum of the ports. Must
1240 * be called with RTNL lock. */
1241 void set_internal_devs_mtu(const struct datapath *dp)
1248 mtu = dp_min_mtu(dp);
1250 list_for_each_entry_rcu (p, &dp->port_list, node) {
1251 if (is_internal_vport(p))
1252 vport_set_mtu(p, mtu);
1256 static int put_port(const struct vport *p, struct odp_port __user *uop)
1260 memset(&op, 0, sizeof op);
1263 strncpy(op.devname, vport_get_name(p), sizeof op.devname);
1264 strncpy(op.type, vport_get_type(p), sizeof op.type);
1265 vport_get_config(p, op.config);
1268 op.port = p->port_no;
1270 return copy_to_user(uop, &op, sizeof op) ? -EFAULT : 0;
1273 static int query_port(struct datapath *dp, struct odp_port __user *uport)
1275 struct odp_port port;
1277 if (copy_from_user(&port, uport, sizeof port))
1280 if (port.devname[0]) {
1281 struct vport *vport;
1284 port.devname[IFNAMSIZ - 1] = '\0';
1289 vport = vport_locate(port.devname);
1294 if (vport->dp != dp) {
1299 port.port = vport->port_no;
1308 if (port.port >= DP_MAX_PORTS)
1310 if (!dp->ports[port.port])
1314 return put_port(dp->ports[port.port], uport);
1317 static int do_list_ports(struct datapath *dp, struct odp_port __user *uports,
1324 list_for_each_entry_rcu (p, &dp->port_list, node) {
1325 if (put_port(p, &uports[idx]))
1327 if (idx++ >= n_ports)
1334 static int list_ports(struct datapath *dp, struct odp_portvec __user *upv)
1336 struct odp_portvec pv;
1339 if (copy_from_user(&pv, upv, sizeof pv))
1342 retval = do_list_ports(dp, (struct odp_port __user __force *)pv.ports,
1347 return put_user(retval, &upv->n_ports);
1350 static int get_listen_mask(const struct file *f)
1352 return (long)f->private_data;
1355 static void set_listen_mask(struct file *f, int listen_mask)
1357 f->private_data = (void*)(long)listen_mask;
1360 static long openvswitch_ioctl(struct file *f, unsigned int cmd,
1363 int dp_idx = iminor(f->f_dentry->d_inode);
1364 struct datapath *dp;
1365 int drop_frags, listeners, port_no;
1366 unsigned int sflow_probability;
1369 /* Handle commands with special locking requirements up front. */
1372 err = create_dp(dp_idx, (char __user *)argp);
1375 case ODP_DP_DESTROY:
1376 err = destroy_dp(dp_idx);
1379 case ODP_VPORT_ATTACH:
1380 err = attach_port(dp_idx, (struct odp_port __user *)argp);
1383 case ODP_VPORT_DETACH:
1384 err = get_user(port_no, (int __user *)argp);
1386 err = detach_port(dp_idx, port_no);
1390 err = vport_user_mod((struct odp_port __user *)argp);
1393 case ODP_VPORT_STATS_GET:
1394 err = vport_user_stats_get((struct odp_vport_stats_req __user *)argp);
1397 case ODP_VPORT_STATS_SET:
1398 err = vport_user_stats_set((struct odp_vport_stats_req __user *)argp);
1401 case ODP_VPORT_ETHER_GET:
1402 err = vport_user_ether_get((struct odp_vport_ether __user *)argp);
1405 case ODP_VPORT_ETHER_SET:
1406 err = vport_user_ether_set((struct odp_vport_ether __user *)argp);
1409 case ODP_VPORT_MTU_GET:
1410 err = vport_user_mtu_get((struct odp_vport_mtu __user *)argp);
1413 case ODP_VPORT_MTU_SET:
1414 err = vport_user_mtu_set((struct odp_vport_mtu __user *)argp);
1418 dp = get_dp_locked(dp_idx);
1425 err = get_dp_stats(dp, (struct odp_stats __user *)argp);
1428 case ODP_GET_DROP_FRAGS:
1429 err = put_user(dp->drop_frags, (int __user *)argp);
1432 case ODP_SET_DROP_FRAGS:
1433 err = get_user(drop_frags, (int __user *)argp);
1437 if (drop_frags != 0 && drop_frags != 1)
1439 dp->drop_frags = drop_frags;
1443 case ODP_GET_LISTEN_MASK:
1444 err = put_user(get_listen_mask(f), (int __user *)argp);
1447 case ODP_SET_LISTEN_MASK:
1448 err = get_user(listeners, (int __user *)argp);
1452 if (listeners & ~ODPL_ALL)
1455 set_listen_mask(f, listeners);
1458 case ODP_GET_SFLOW_PROBABILITY:
1459 err = put_user(dp->sflow_probability, (unsigned int __user *)argp);
1462 case ODP_SET_SFLOW_PROBABILITY:
1463 err = get_user(sflow_probability, (unsigned int __user *)argp);
1465 dp->sflow_probability = sflow_probability;
1468 case ODP_VPORT_QUERY:
1469 err = query_port(dp, (struct odp_port __user *)argp);
1472 case ODP_VPORT_LIST:
1473 err = list_ports(dp, (struct odp_portvec __user *)argp);
1476 case ODP_FLOW_FLUSH:
1477 err = flush_flows(dp);
1481 err = put_flow(dp, (struct odp_flow_put __user *)argp);
1485 err = del_flow(dp, (struct odp_flow __user *)argp);
1489 err = do_flowvec_ioctl(dp, argp, do_query_flows);
1493 err = do_flowvec_ioctl(dp, argp, do_list_flows);
1497 err = execute_packet(dp, (struct odp_execute __user *)argp);
1504 mutex_unlock(&dp->mutex);
1509 static int dp_has_packet_of_interest(struct datapath *dp, int listeners)
1512 for (i = 0; i < DP_N_QUEUES; i++) {
1513 if (listeners & (1 << i) && !skb_queue_empty(&dp->queues[i]))
1519 #ifdef CONFIG_COMPAT
1520 static int compat_list_ports(struct datapath *dp, struct compat_odp_portvec __user *upv)
1522 struct compat_odp_portvec pv;
1525 if (copy_from_user(&pv, upv, sizeof pv))
1528 retval = do_list_ports(dp, compat_ptr(pv.ports), pv.n_ports);
1532 return put_user(retval, &upv->n_ports);
1535 static int compat_get_flow(struct odp_flow *flow, const struct compat_odp_flow __user *compat)
1537 compat_uptr_t actions;
1539 if (!access_ok(VERIFY_READ, compat, sizeof(struct compat_odp_flow)) ||
1540 __copy_from_user(&flow->stats, &compat->stats, sizeof(struct odp_flow_stats)) ||
1541 __copy_from_user(&flow->key, &compat->key, sizeof(struct odp_flow_key)) ||
1542 __get_user(actions, &compat->actions) ||
1543 __get_user(flow->actions_len, &compat->actions_len) ||
1544 __get_user(flow->flags, &compat->flags))
1547 flow->actions = (struct nlattr __force *)compat_ptr(actions);
1551 static int compat_put_flow(struct datapath *dp, struct compat_odp_flow_put __user *ufp)
1553 struct odp_flow_stats stats;
1554 struct odp_flow_put fp;
1557 if (compat_get_flow(&fp.flow, &ufp->flow) ||
1558 get_user(fp.flags, &ufp->flags))
1561 error = do_put_flow(dp, &fp, &stats);
1565 if (copy_to_user(&ufp->flow.stats, &stats,
1566 sizeof(struct odp_flow_stats)))
1572 static int compat_answer_query(struct datapath *dp, struct sw_flow *flow,
1574 struct compat_odp_flow __user *ufp)
1576 compat_uptr_t actions;
1578 if (get_user(actions, &ufp->actions))
1581 return do_answer_query(dp, flow, query_flags, &ufp->stats,
1582 compat_ptr(actions), &ufp->actions_len);
1585 static int compat_del_flow(struct datapath *dp, struct compat_odp_flow __user *ufp)
1587 struct sw_flow *flow;
1591 if (compat_get_flow(&uf, ufp))
1594 flow = do_del_flow(dp, &uf.key);
1596 return PTR_ERR(flow);
1598 error = compat_answer_query(dp, flow, 0, ufp);
1599 flow_deferred_free(flow);
1603 static int compat_query_flows(struct datapath *dp,
1604 struct compat_odp_flow __user *flows,
1607 struct tbl *table = get_table_protected(dp);
1610 for (i = 0; i < n_flows; i++) {
1611 struct compat_odp_flow __user *ufp = &flows[i];
1613 struct tbl_node *flow_node;
1616 if (compat_get_flow(&uf, ufp))
1619 flow_node = tbl_lookup(table, &uf.key, flow_hash(&uf.key), flow_cmp);
1621 error = put_user(ENOENT, &ufp->stats.error);
1623 error = compat_answer_query(dp, flow_cast(flow_node),
1631 struct compat_list_flows_cbdata {
1632 struct datapath *dp;
1633 struct compat_odp_flow __user *uflows;
1638 static int compat_list_flow(struct tbl_node *node, void *cbdata_)
1640 struct sw_flow *flow = flow_cast(node);
1641 struct compat_list_flows_cbdata *cbdata = cbdata_;
1642 struct compat_odp_flow __user *ufp = &cbdata->uflows[cbdata->listed_flows++];
1645 if (copy_to_user(&ufp->key, &flow->key, sizeof flow->key))
1647 error = compat_answer_query(cbdata->dp, flow, 0, ufp);
1651 if (cbdata->listed_flows >= cbdata->n_flows)
1652 return cbdata->listed_flows;
1656 static int compat_list_flows(struct datapath *dp,
1657 struct compat_odp_flow __user *flows, u32 n_flows)
1659 struct compat_list_flows_cbdata cbdata;
1666 cbdata.uflows = flows;
1667 cbdata.n_flows = n_flows;
1668 cbdata.listed_flows = 0;
1670 error = tbl_foreach(get_table_protected(dp), compat_list_flow, &cbdata);
1671 return error ? error : cbdata.listed_flows;
1674 static int compat_flowvec_ioctl(struct datapath *dp, unsigned long argp,
1675 int (*function)(struct datapath *,
1676 struct compat_odp_flow __user *,
1679 struct compat_odp_flowvec __user *uflowvec;
1680 struct compat_odp_flow __user *flows;
1681 struct compat_odp_flowvec flowvec;
1684 uflowvec = compat_ptr(argp);
1685 if (!access_ok(VERIFY_WRITE, uflowvec, sizeof *uflowvec) ||
1686 copy_from_user(&flowvec, uflowvec, sizeof flowvec))
1689 if (flowvec.n_flows > INT_MAX / sizeof(struct compat_odp_flow))
1692 flows = compat_ptr(flowvec.flows);
1693 if (!access_ok(VERIFY_WRITE, flows,
1694 flowvec.n_flows * sizeof(struct compat_odp_flow)))
1697 retval = function(dp, flows, flowvec.n_flows);
1698 return (retval < 0 ? retval
1699 : retval == flowvec.n_flows ? 0
1700 : put_user(retval, &uflowvec->n_flows));
1703 static int compat_execute(struct datapath *dp, const struct compat_odp_execute __user *uexecute)
1705 struct odp_execute execute;
1706 compat_uptr_t actions;
1709 if (!access_ok(VERIFY_READ, uexecute, sizeof(struct compat_odp_execute)) ||
1710 __get_user(actions, &uexecute->actions) ||
1711 __get_user(execute.actions_len, &uexecute->actions_len) ||
1712 __get_user(data, &uexecute->data) ||
1713 __get_user(execute.length, &uexecute->length))
1716 execute.actions = (struct nlattr __force *)compat_ptr(actions);
1717 execute.data = (const void __force *)compat_ptr(data);
1719 return do_execute(dp, &execute);
1722 static long openvswitch_compat_ioctl(struct file *f, unsigned int cmd, unsigned long argp)
1724 int dp_idx = iminor(f->f_dentry->d_inode);
1725 struct datapath *dp;
1729 case ODP_DP_DESTROY:
1730 case ODP_FLOW_FLUSH:
1731 /* Ioctls that don't need any translation at all. */
1732 return openvswitch_ioctl(f, cmd, argp);
1735 case ODP_VPORT_ATTACH:
1736 case ODP_VPORT_DETACH:
1738 case ODP_VPORT_MTU_SET:
1739 case ODP_VPORT_MTU_GET:
1740 case ODP_VPORT_ETHER_SET:
1741 case ODP_VPORT_ETHER_GET:
1742 case ODP_VPORT_STATS_SET:
1743 case ODP_VPORT_STATS_GET:
1745 case ODP_GET_DROP_FRAGS:
1746 case ODP_SET_DROP_FRAGS:
1747 case ODP_SET_LISTEN_MASK:
1748 case ODP_GET_LISTEN_MASK:
1749 case ODP_SET_SFLOW_PROBABILITY:
1750 case ODP_GET_SFLOW_PROBABILITY:
1751 case ODP_VPORT_QUERY:
1752 /* Ioctls that just need their pointer argument extended. */
1753 return openvswitch_ioctl(f, cmd, (unsigned long)compat_ptr(argp));
1756 dp = get_dp_locked(dp_idx);
1762 case ODP_VPORT_LIST32:
1763 err = compat_list_ports(dp, compat_ptr(argp));
1766 case ODP_FLOW_PUT32:
1767 err = compat_put_flow(dp, compat_ptr(argp));
1770 case ODP_FLOW_DEL32:
1771 err = compat_del_flow(dp, compat_ptr(argp));
1774 case ODP_FLOW_GET32:
1775 err = compat_flowvec_ioctl(dp, argp, compat_query_flows);
1778 case ODP_FLOW_LIST32:
1779 err = compat_flowvec_ioctl(dp, argp, compat_list_flows);
1783 err = compat_execute(dp, compat_ptr(argp));
1790 mutex_unlock(&dp->mutex);
1796 /* Unfortunately this function is not exported so this is a verbatim copy
1797 * from net/core/datagram.c in 2.6.30. */
1798 static int skb_copy_and_csum_datagram(const struct sk_buff *skb, int offset,
1799 u8 __user *to, int len,
1802 int start = skb_headlen(skb);
1804 int i, copy = start - offset;
1811 *csump = csum_and_copy_to_user(skb->data + offset, to, copy,
1815 if ((len -= copy) == 0)
1822 for (i = 0; i < skb_shinfo(skb)->nr_frags; i++) {
1825 WARN_ON(start > offset + len);
1827 end = start + skb_shinfo(skb)->frags[i].size;
1828 if ((copy = end - offset) > 0) {
1832 skb_frag_t *frag = &skb_shinfo(skb)->frags[i];
1833 struct page *page = frag->page;
1838 csum2 = csum_and_copy_to_user(vaddr +
1845 *csump = csum_block_add(*csump, csum2, pos);
1855 if (skb_shinfo(skb)->frag_list) {
1856 struct sk_buff *list = skb_shinfo(skb)->frag_list;
1858 for (; list; list=list->next) {
1861 WARN_ON(start > offset + len);
1863 end = start + list->len;
1864 if ((copy = end - offset) > 0) {
1868 if (skb_copy_and_csum_datagram(list,
1873 *csump = csum_block_add(*csump, csum2, pos);
1874 if ((len -= copy) == 0)
1890 static ssize_t openvswitch_read(struct file *f, char __user *buf,
1891 size_t nbytes, loff_t *ppos)
1893 int listeners = get_listen_mask(f);
1894 int dp_idx = iminor(f->f_dentry->d_inode);
1895 struct datapath *dp = get_dp_locked(dp_idx);
1896 struct sk_buff *skb;
1897 size_t copy_bytes, tot_copy_bytes;
1903 if (nbytes == 0 || !listeners)
1909 for (i = 0; i < DP_N_QUEUES; i++) {
1910 if (listeners & (1 << i)) {
1911 skb = skb_dequeue(&dp->queues[i]);
1917 if (f->f_flags & O_NONBLOCK) {
1922 wait_event_interruptible(dp->waitqueue,
1923 dp_has_packet_of_interest(dp,
1926 if (signal_pending(current)) {
1927 retval = -ERESTARTSYS;
1932 mutex_unlock(&dp->mutex);
1934 copy_bytes = tot_copy_bytes = min_t(size_t, skb->len, nbytes);
1937 if (skb->ip_summed == CHECKSUM_PARTIAL) {
1938 if (copy_bytes == skb->len) {
1940 u16 csum_start, csum_offset;
1942 get_skb_csum_pointers(skb, &csum_start, &csum_offset);
1943 csum_start -= skb_headroom(skb);
1945 BUG_ON(csum_start >= skb_headlen(skb));
1946 retval = skb_copy_and_csum_datagram(skb, csum_start, buf + csum_start,
1947 copy_bytes - csum_start, &csum);
1949 __sum16 __user *csump;
1951 copy_bytes = csum_start;
1952 csump = (__sum16 __user *)(buf + csum_start + csum_offset);
1954 BUG_ON((char __user *)csump + sizeof(__sum16) >
1956 put_user(csum_fold(csum), csump);
1959 retval = skb_checksum_help(skb);
1966 iov.iov_len = copy_bytes;
1967 retval = skb_copy_datagram_iovec(skb, 0, &iov, iov.iov_len);
1971 retval = tot_copy_bytes;
1977 mutex_unlock(&dp->mutex);
1981 static unsigned int openvswitch_poll(struct file *file, poll_table *wait)
1983 int dp_idx = iminor(file->f_dentry->d_inode);
1984 struct datapath *dp = get_dp_locked(dp_idx);
1989 poll_wait(file, &dp->waitqueue, wait);
1990 if (dp_has_packet_of_interest(dp, get_listen_mask(file)))
1991 mask |= POLLIN | POLLRDNORM;
1992 mutex_unlock(&dp->mutex);
1994 mask = POLLIN | POLLRDNORM | POLLHUP;
1999 static struct file_operations openvswitch_fops = {
2000 .read = openvswitch_read,
2001 .poll = openvswitch_poll,
2002 .unlocked_ioctl = openvswitch_ioctl,
2003 #ifdef CONFIG_COMPAT
2004 .compat_ioctl = openvswitch_compat_ioctl,
2010 static int __init dp_init(void)
2012 struct sk_buff *dummy_skb;
2015 BUILD_BUG_ON(sizeof(struct ovs_skb_cb) > sizeof(dummy_skb->cb));
2017 printk("Open vSwitch %s, built "__DATE__" "__TIME__"\n", VERSION BUILDNR);
2025 goto error_flow_exit;
2027 err = register_netdevice_notifier(&dp_device_notifier);
2029 goto error_vport_exit;
2031 major = register_chrdev(0, "openvswitch", &openvswitch_fops);
2033 goto error_unreg_notifier;
2037 error_unreg_notifier:
2038 unregister_netdevice_notifier(&dp_device_notifier);
2047 static void dp_cleanup(void)
2050 unregister_chrdev(major, "openvswitch");
2051 unregister_netdevice_notifier(&dp_device_notifier);
2056 module_init(dp_init);
2057 module_exit(dp_cleanup);
2059 MODULE_DESCRIPTION("Open vSwitch switching datapath");
2060 MODULE_LICENSE("GPL");