blob: 70c6c4df3b34f4c802c4f09be38a2380bedf61a9 [file] [log] [blame]
Ed Warnickecb9cada2015-12-08 15:45:58 -07001/*
2 * gre_interface.c: gre interfaces
3 *
4 * Copyright (c) 2012 Cisco and/or its affiliates.
5 * Licensed under the Apache License, Version 2.0 (the "License");
6 * you may not use this file except in compliance with the License.
7 * You may obtain a copy of the License at:
8 *
9 * http://www.apache.org/licenses/LICENSE-2.0
10 *
11 * Unless required by applicable law or agreed to in writing, software
12 * distributed under the License is distributed on an "AS IS" BASIS,
13 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14 * See the License for the specific language governing permissions and
15 * limitations under the License.
16 */
17
18#include <vnet/vnet.h>
19#include <vnet/pg/pg.h>
20#include <vnet/gre/gre.h>
Chris Luke27fe48f2016-04-28 13:44:38 -040021#include <vnet/ip/format.h>
Neale Ranns0bfe5d82016-08-25 15:29:12 +010022#include <vnet/fib/ip4_fib.h>
Ciara Loftus7eac9162016-09-30 15:47:03 +010023#include <vnet/fib/ip6_fib.h>
Neale Ranns0bfe5d82016-08-25 15:29:12 +010024#include <vnet/adj/adj_midchain.h>
Neale Rannsb80c5362016-10-08 13:03:40 +010025#include <vnet/adj/adj_nbr.h>
Neale Ranns0bfe5d82016-08-25 15:29:12 +010026#include <vnet/mpls/mpls.h>
Ed Warnickecb9cada2015-12-08 15:45:58 -070027
Neale Ranns177bbdc2016-11-15 09:46:51 +000028static const char *gre_tunnel_type_names[] = GRE_TUNNEL_TYPE_NAMES;
29
Neale Ranns0bfe5d82016-08-25 15:29:12 +010030static u8 *
31format_gre_tunnel (u8 * s, va_list * args)
Chris Luke27fe48f2016-04-28 13:44:38 -040032{
Swarup Nayak9ff647a2017-11-27 10:27:43 +053033 gre_tunnel_t *t = va_arg (*args, gre_tunnel_t *);
Chris Luke27fe48f2016-04-28 13:44:38 -040034
John Loa43ccae2018-02-13 17:15:23 -050035 s = format (s, "[%d] instance %d src %U dst %U fib-idx %d sw-if-idx %d ",
36 t->dev_instance, t->user_instance,
John Lo4478d8e2018-01-12 17:15:25 -050037 format_ip46_address, &t->tunnel_src, IP46_TYPE_ANY,
38 format_ip46_address, &t->tunnel_dst.fp_addr, IP46_TYPE_ANY,
39 t->outer_fib_index, t->sw_if_index);
40
John Loa43ccae2018-02-13 17:15:23 -050041 s = format (s, "payload %s ", gre_tunnel_type_names[t->type]);
42
43 if (t->type == GRE_TUNNEL_TYPE_ERSPAN)
44 s = format (s, "session %d ", t->session_id);
45
46 if (t->type != GRE_TUNNEL_TYPE_L3)
47 s = format (s, "l2-adj-idx %d ", t->l2_adj_index);
Neale Ranns0bfe5d82016-08-25 15:29:12 +010048
Chris Luke27fe48f2016-04-28 13:44:38 -040049 return s;
50}
51
Neale Ranns0bfe5d82016-08-25 15:29:12 +010052static gre_tunnel_t *
John Loa43ccae2018-02-13 17:15:23 -050053gre_tunnel_db_find (const vnet_gre_add_del_tunnel_args_t * a,
54 u32 outer_fib_index, gre_tunnel_key_t * key)
Neale Ranns0bfe5d82016-08-25 15:29:12 +010055{
Swarup Nayak9ff647a2017-11-27 10:27:43 +053056 gre_main_t *gm = &gre_main;
57 uword *p;
Neale Ranns0bfe5d82016-08-25 15:29:12 +010058
John Loa43ccae2018-02-13 17:15:23 -050059 if (!a->is_ipv6)
Ciara Loftus7eac9162016-09-30 15:47:03 +010060 {
John Loa43ccae2018-02-13 17:15:23 -050061 gre_mk_key4 (a->src.ip4, a->dst.ip4, outer_fib_index,
62 a->tunnel_type, a->session_id, &key->gtk_v4);
Neale Ranns33ce60d2017-12-14 08:51:32 -080063 p = hash_get_mem (gm->tunnel_by_key4, &key->gtk_v4);
Ciara Loftus7eac9162016-09-30 15:47:03 +010064 }
65 else
66 {
John Loa43ccae2018-02-13 17:15:23 -050067 gre_mk_key6 (&a->src.ip6, &a->dst.ip6, outer_fib_index,
68 a->tunnel_type, a->session_id, &key->gtk_v6);
Neale Ranns33ce60d2017-12-14 08:51:32 -080069 p = hash_get_mem (gm->tunnel_by_key6, &key->gtk_v6);
Ciara Loftus7eac9162016-09-30 15:47:03 +010070 }
Neale Ranns0bfe5d82016-08-25 15:29:12 +010071
72 if (NULL == p)
73 return (NULL);
74
75 return (pool_elt_at_index (gm->tunnels, p[0]));
76}
77
78static void
Neale Ranns33ce60d2017-12-14 08:51:32 -080079gre_tunnel_db_add (gre_tunnel_t * t, gre_tunnel_key_t * key)
Neale Ranns0bfe5d82016-08-25 15:29:12 +010080{
Swarup Nayak9ff647a2017-11-27 10:27:43 +053081 gre_main_t *gm = &gre_main;
Neale Ranns0bfe5d82016-08-25 15:29:12 +010082
Neale Ranns33ce60d2017-12-14 08:51:32 -080083 t->key = clib_mem_alloc (sizeof (*t->key));
84 clib_memcpy (t->key, key, sizeof (*key));
85
86 if (t->tunnel_dst.fp_proto == FIB_PROTOCOL_IP6)
Ciara Loftus7eac9162016-09-30 15:47:03 +010087 {
John Loa43ccae2018-02-13 17:15:23 -050088 hash_set_mem (gm->tunnel_by_key6, &t->key->gtk_v6, t->dev_instance);
Ciara Loftus7eac9162016-09-30 15:47:03 +010089 }
90 else
91 {
John Loa43ccae2018-02-13 17:15:23 -050092 hash_set_mem (gm->tunnel_by_key4, &t->key->gtk_v4, t->dev_instance);
Ciara Loftus7eac9162016-09-30 15:47:03 +010093 }
Neale Ranns0bfe5d82016-08-25 15:29:12 +010094}
95
96static void
Neale Ranns33ce60d2017-12-14 08:51:32 -080097gre_tunnel_db_remove (gre_tunnel_t * t)
Neale Ranns0bfe5d82016-08-25 15:29:12 +010098{
Swarup Nayak9ff647a2017-11-27 10:27:43 +053099 gre_main_t *gm = &gre_main;
Neale Ranns0bfe5d82016-08-25 15:29:12 +0100100
Neale Ranns33ce60d2017-12-14 08:51:32 -0800101 if (t->tunnel_dst.fp_proto == FIB_PROTOCOL_IP6)
Ciara Loftus7eac9162016-09-30 15:47:03 +0100102 {
Neale Ranns33ce60d2017-12-14 08:51:32 -0800103 hash_unset_mem (gm->tunnel_by_key6, &t->key->gtk_v6);
Ciara Loftus7eac9162016-09-30 15:47:03 +0100104 }
105 else
106 {
Neale Ranns33ce60d2017-12-14 08:51:32 -0800107 hash_unset_mem (gm->tunnel_by_key4, &t->key->gtk_v4);
Ciara Loftus7eac9162016-09-30 15:47:03 +0100108 }
109
Neale Ranns33ce60d2017-12-14 08:51:32 -0800110 clib_mem_free (t->key);
111 t->key = NULL;
Neale Ranns0bfe5d82016-08-25 15:29:12 +0100112}
113
114static gre_tunnel_t *
Swarup Nayak9ff647a2017-11-27 10:27:43 +0530115gre_tunnel_from_fib_node (fib_node_t * node)
Neale Ranns0bfe5d82016-08-25 15:29:12 +0100116{
Swarup Nayak9ff647a2017-11-27 10:27:43 +0530117 ASSERT (FIB_NODE_TYPE_GRE_TUNNEL == node->fn_type);
118 return ((gre_tunnel_t *) (((char *) node) -
119 STRUCT_OFFSET_OF (gre_tunnel_t, node)));
Neale Ranns0bfe5d82016-08-25 15:29:12 +0100120}
121
Neale Ranns5e575b12016-10-03 09:40:25 +0100122/**
Neale Ranns0bfe5d82016-08-25 15:29:12 +0100123 * gre_tunnel_stack
124 *
125 * 'stack' (resolve the recursion for) the tunnel's midchain adjacency
126 */
Neale Ranns5e575b12016-10-03 09:40:25 +0100127void
Neale Rannsb80c5362016-10-08 13:03:40 +0100128gre_tunnel_stack (adj_index_t ai)
Neale Ranns0bfe5d82016-08-25 15:29:12 +0100129{
Swarup Nayak9ff647a2017-11-27 10:27:43 +0530130 gre_main_t *gm = &gre_main;
131 ip_adjacency_t *adj;
132 gre_tunnel_t *gt;
133 u32 sw_if_index;
Neale Rannsb80c5362016-10-08 13:03:40 +0100134
Swarup Nayak9ff647a2017-11-27 10:27:43 +0530135 adj = adj_get (ai);
136 sw_if_index = adj->rewrite_header.sw_if_index;
Neale Rannsb80c5362016-10-08 13:03:40 +0100137
Eyal Baricd307742018-07-22 12:45:15 +0300138 if ((vec_len (gm->tunnel_index_by_sw_if_index) <= sw_if_index) ||
Swarup Nayak9ff647a2017-11-27 10:27:43 +0530139 (~0 == gm->tunnel_index_by_sw_if_index[sw_if_index]))
140 return;
Neale Rannsb80c5362016-10-08 13:03:40 +0100141
Swarup Nayak9ff647a2017-11-27 10:27:43 +0530142 gt = pool_elt_at_index (gm->tunnels,
143 gm->tunnel_index_by_sw_if_index[sw_if_index]);
Neale Ranns0bfe5d82016-08-25 15:29:12 +0100144
John Loa43ccae2018-02-13 17:15:23 -0500145 if ((vnet_hw_interface_get_flags (vnet_get_main (), gt->hw_if_index) &
146 VNET_HW_INTERFACE_FLAG_LINK_UP) == 0)
Neale Rannsb80c5362016-10-08 13:03:40 +0100147 {
Swarup Nayak9ff647a2017-11-27 10:27:43 +0530148 adj_nbr_midchain_unstack (ai);
John Loa43ccae2018-02-13 17:15:23 -0500149 return;
Neale Rannsb80c5362016-10-08 13:03:40 +0100150 }
John Loa43ccae2018-02-13 17:15:23 -0500151
152 dpo_id_t tmp = DPO_INVALID;
153 fib_forward_chain_type_t fib_fwd = (FIB_PROTOCOL_IP6 == adj->ia_nh_proto) ?
154 FIB_FORW_CHAIN_TYPE_UNICAST_IP6 : FIB_FORW_CHAIN_TYPE_UNICAST_IP4;
155
156 fib_entry_contribute_forwarding (gt->fib_entry_index, fib_fwd, &tmp);
157 if (DPO_LOAD_BALANCE == tmp.dpoi_type)
158 {
159 /*
160 * post GRE rewrite we will load-balance. However, the GRE encap
161 * is always the same for this adjacency/tunnel and hence the IP/GRE
162 * src,dst hash is always the same result too. So we do that hash now and
163 * stack on the choice.
164 * If the choice is an incomplete adj then we will need a poke when
165 * it becomes complete. This happens since the adj update walk propagates
166 * as far a recursive paths.
167 */
168 const dpo_id_t *choice;
169 load_balance_t *lb;
170 int hash;
171
172 lb = load_balance_get (tmp.dpoi_index);
173
174 if (fib_fwd == FIB_FORW_CHAIN_TYPE_UNICAST_IP4)
175 hash = ip4_compute_flow_hash ((ip4_header_t *) adj_get_rewrite (ai),
176 lb->lb_hash_config);
177 else
178 hash = ip6_compute_flow_hash ((ip6_header_t *) adj_get_rewrite (ai),
179 lb->lb_hash_config);
180 choice =
181 load_balance_get_bucket_i (lb, hash & lb->lb_n_buckets_minus_1);
182 dpo_copy (&tmp, choice);
183 }
184
185 adj_nbr_midchain_stack (ai, &tmp);
186 dpo_reset (&tmp);
Neale Rannsb80c5362016-10-08 13:03:40 +0100187}
188
189/**
190 * @brief Call back when restacking all adjacencies on a GRE interface
191 */
192static adj_walk_rc_t
Swarup Nayak9ff647a2017-11-27 10:27:43 +0530193gre_adj_walk_cb (adj_index_t ai, void *ctx)
Neale Rannsb80c5362016-10-08 13:03:40 +0100194{
Swarup Nayak9ff647a2017-11-27 10:27:43 +0530195 gre_tunnel_stack (ai);
Neale Rannsb80c5362016-10-08 13:03:40 +0100196
Swarup Nayak9ff647a2017-11-27 10:27:43 +0530197 return (ADJ_WALK_RC_CONTINUE);
Neale Rannsb80c5362016-10-08 13:03:40 +0100198}
199
200static void
Swarup Nayak9ff647a2017-11-27 10:27:43 +0530201gre_tunnel_restack (gre_tunnel_t * gt)
Neale Rannsb80c5362016-10-08 13:03:40 +0100202{
Swarup Nayak9ff647a2017-11-27 10:27:43 +0530203 fib_protocol_t proto;
Neale Rannsb80c5362016-10-08 13:03:40 +0100204
Swarup Nayak9ff647a2017-11-27 10:27:43 +0530205 /*
206 * walk all the adjacencies on th GRE interface and restack them
207 */
208 FOR_EACH_FIB_IP_PROTOCOL (proto)
209 {
210 adj_nbr_walk (gt->sw_if_index, proto, gre_adj_walk_cb, NULL);
211 }
Neale Ranns0bfe5d82016-08-25 15:29:12 +0100212}
213
214/**
215 * Function definition to backwalk a FIB node
216 */
217static fib_node_back_walk_rc_t
Swarup Nayak9ff647a2017-11-27 10:27:43 +0530218gre_tunnel_back_walk (fib_node_t * node, fib_node_back_walk_ctx_t * ctx)
Neale Ranns0bfe5d82016-08-25 15:29:12 +0100219{
Swarup Nayak9ff647a2017-11-27 10:27:43 +0530220 gre_tunnel_restack (gre_tunnel_from_fib_node (node));
Neale Ranns0bfe5d82016-08-25 15:29:12 +0100221
Swarup Nayak9ff647a2017-11-27 10:27:43 +0530222 return (FIB_NODE_BACK_WALK_CONTINUE);
Neale Ranns0bfe5d82016-08-25 15:29:12 +0100223}
224
225/**
226 * Function definition to get a FIB node from its index
227 */
Swarup Nayak9ff647a2017-11-27 10:27:43 +0530228static fib_node_t *
Neale Ranns0bfe5d82016-08-25 15:29:12 +0100229gre_tunnel_fib_node_get (fib_node_index_t index)
230{
Swarup Nayak9ff647a2017-11-27 10:27:43 +0530231 gre_tunnel_t *gt;
232 gre_main_t *gm;
Neale Ranns0bfe5d82016-08-25 15:29:12 +0100233
Swarup Nayak9ff647a2017-11-27 10:27:43 +0530234 gm = &gre_main;
235 gt = pool_elt_at_index (gm->tunnels, index);
Neale Ranns0bfe5d82016-08-25 15:29:12 +0100236
Swarup Nayak9ff647a2017-11-27 10:27:43 +0530237 return (&gt->node);
Neale Ranns0bfe5d82016-08-25 15:29:12 +0100238}
239
240/**
241 * Function definition to inform the FIB node that its last lock has gone.
242 */
243static void
Swarup Nayak9ff647a2017-11-27 10:27:43 +0530244gre_tunnel_last_lock_gone (fib_node_t * node)
Neale Ranns0bfe5d82016-08-25 15:29:12 +0100245{
Swarup Nayak9ff647a2017-11-27 10:27:43 +0530246 /*
247 * The MPLS GRE tunnel is a root of the graph. As such
248 * it never has children and thus is never locked.
249 */
250 ASSERT (0);
Neale Ranns0bfe5d82016-08-25 15:29:12 +0100251}
252
253/*
254 * Virtual function table registered by MPLS GRE tunnels
255 * for participation in the FIB object graph.
256 */
257const static fib_node_vft_t gre_vft = {
Swarup Nayak9ff647a2017-11-27 10:27:43 +0530258 .fnv_get = gre_tunnel_fib_node_get,
259 .fnv_last_lock = gre_tunnel_last_lock_gone,
260 .fnv_back_walk = gre_tunnel_back_walk,
Neale Ranns0bfe5d82016-08-25 15:29:12 +0100261};
262
Ciara Loftus7eac9162016-09-30 15:47:03 +0100263static int
John Loa43ccae2018-02-13 17:15:23 -0500264vnet_gre_tunnel_add (vnet_gre_add_del_tunnel_args_t * a,
265 u32 outer_fib_index, u32 * sw_if_indexp)
Ed Warnickecb9cada2015-12-08 15:45:58 -0700266{
Swarup Nayak9ff647a2017-11-27 10:27:43 +0530267 gre_main_t *gm = &gre_main;
268 vnet_main_t *vnm = gm->vnet_main;
269 ip4_main_t *im4 = &ip4_main;
270 ip6_main_t *im6 = &ip6_main;
271 gre_tunnel_t *t;
272 vnet_hw_interface_t *hi;
Chris Luke27fe48f2016-04-28 13:44:38 -0400273 u32 hw_if_index, sw_if_index;
David Hothama8cd3092016-09-19 09:55:07 -0700274 clib_error_t *error;
Ciara Loftus7eac9162016-09-30 15:47:03 +0100275 u8 is_ipv6 = a->is_ipv6;
Neale Ranns33ce60d2017-12-14 08:51:32 -0800276 gre_tunnel_key_t key;
Ed Warnickecb9cada2015-12-08 15:45:58 -0700277
John Loa43ccae2018-02-13 17:15:23 -0500278 t = gre_tunnel_db_find (a, outer_fib_index, &key);
Neale Ranns0bfe5d82016-08-25 15:29:12 +0100279 if (NULL != t)
John Loa43ccae2018-02-13 17:15:23 -0500280 return VNET_API_ERROR_IF_ALREADY_EXISTS;
Ed Warnickecb9cada2015-12-08 15:45:58 -0700281
Neale Ranns0bfe5d82016-08-25 15:29:12 +0100282 pool_get_aligned (gm->tunnels, t, CLIB_CACHE_LINE_BYTES);
283 memset (t, 0, sizeof (*t));
John Loa43ccae2018-02-13 17:15:23 -0500284
285 /* Reconcile the real dev_instance and a possible requested instance */
286 u32 t_idx = t - gm->tunnels; /* tunnel index (or instance) */
287 u32 u_idx = a->instance; /* user specified instance */
288 if (u_idx == ~0)
289 u_idx = t_idx;
290 if (hash_get (gm->instance_used, u_idx))
291 {
292 pool_put (gm->tunnels, t);
293 return VNET_API_ERROR_INSTANCE_IN_USE;
294 }
295 hash_set (gm->instance_used, u_idx, 1);
296
297 t->dev_instance = t_idx; /* actual */
298 t->user_instance = u_idx; /* name */
Swarup Nayak9ff647a2017-11-27 10:27:43 +0530299 fib_node_init (&t->node, FIB_NODE_TYPE_GRE_TUNNEL);
Ed Warnickecb9cada2015-12-08 15:45:58 -0700300
John Loa43ccae2018-02-13 17:15:23 -0500301 t->type = a->tunnel_type;
302 if (t->type == GRE_TUNNEL_TYPE_ERSPAN)
303 t->session_id = a->session_id;
Neale Ranns177bbdc2016-11-15 09:46:51 +0000304
John Loa43ccae2018-02-13 17:15:23 -0500305 if (t->type == GRE_TUNNEL_TYPE_L3)
306 hw_if_index = vnet_register_interface (vnm, gre_device_class.index, t_idx,
307 gre_hw_interface_class.index,
308 t_idx);
Swarup Nayak9ff647a2017-11-27 10:27:43 +0530309 else
310 {
John Loa43ccae2018-02-13 17:15:23 -0500311 /* Default MAC address (d00b:eed0:0000 + sw_if_index) */
John Lo25d417f2018-02-15 15:47:53 -0500312 u8 address[6] =
313 { 0xd0, 0x0b, 0xee, 0xd0, (u8) (t_idx >> 8), (u8) t_idx };
314 error =
315 ethernet_register_interface (vnm, gre_device_class.index, t_idx,
316 address, &hw_if_index, 0);
John Loa43ccae2018-02-13 17:15:23 -0500317 if (error)
Swarup Nayak9ff647a2017-11-27 10:27:43 +0530318 {
John Loa43ccae2018-02-13 17:15:23 -0500319 clib_error_report (error);
320 return VNET_API_ERROR_INVALID_REGISTRATION;
Swarup Nayak9ff647a2017-11-27 10:27:43 +0530321 }
Chris Luke27fe48f2016-04-28 13:44:38 -0400322 }
Ed Warnickecb9cada2015-12-08 15:45:58 -0700323
John Loa43ccae2018-02-13 17:15:23 -0500324 /* Set GRE tunnel interface output node (not used for L3 payload) */
325 vnet_set_interface_output_node (vnm, hw_if_index, gre_encap_node.index);
326
327 hi = vnet_get_hw_interface (vnm, hw_if_index);
328 sw_if_index = hi->sw_if_index;
329
Neale Ranns0bfe5d82016-08-25 15:29:12 +0100330 t->hw_if_index = hw_if_index;
331 t->outer_fib_index = outer_fib_index;
332 t->sw_if_index = sw_if_index;
Neale Rannsad422ed2016-11-02 14:20:04 +0000333 t->l2_adj_index = ADJ_INDEX_INVALID;
Ed Warnickecb9cada2015-12-08 15:45:58 -0700334
Neale Ranns0bfe5d82016-08-25 15:29:12 +0100335 vec_validate_init_empty (gm->tunnel_index_by_sw_if_index, sw_if_index, ~0);
John Loa43ccae2018-02-13 17:15:23 -0500336 gm->tunnel_index_by_sw_if_index[sw_if_index] = t_idx;
Ed Warnickecb9cada2015-12-08 15:45:58 -0700337
Ciara Loftus7eac9162016-09-30 15:47:03 +0100338 if (!is_ipv6)
339 {
340 vec_validate (im4->fib_index_by_sw_if_index, sw_if_index);
Swarup Nayak9ff647a2017-11-27 10:27:43 +0530341 hi->min_packet_bytes =
342 64 + sizeof (gre_header_t) + sizeof (ip4_header_t);
Ciara Loftus7eac9162016-09-30 15:47:03 +0100343 }
344 else
345 {
346 vec_validate (im6->fib_index_by_sw_if_index, sw_if_index);
Swarup Nayak9ff647a2017-11-27 10:27:43 +0530347 hi->min_packet_bytes =
348 64 + sizeof (gre_header_t) + sizeof (ip6_header_t);
Ciara Loftus7eac9162016-09-30 15:47:03 +0100349 }
Chris Luke71649002016-05-06 11:51:54 -0400350
Neale Ranns0bfe5d82016-08-25 15:29:12 +0100351 /* Standard default gre MTU. */
Ole Troand7231612018-06-07 10:17:57 +0200352 vnet_sw_interface_set_mtu (vnm, sw_if_index, 9000);
Damjan Marionfe7d4a22018-04-13 19:43:39 +0200353
Neale Ranns0bfe5d82016-08-25 15:29:12 +0100354 /*
355 * source the FIB entry for the tunnel's destination
356 * and become a child thereof. The tunnel will then get poked
357 * when the forwarding for the entry updates, and the tunnel can
358 * re-stack accordingly
359 */
Ciara Loftus7eac9162016-09-30 15:47:03 +0100360
361 clib_memcpy (&t->tunnel_src, &a->src, sizeof (t->tunnel_src));
362 t->tunnel_dst.fp_len = !is_ipv6 ? 32 : 128;
363 t->tunnel_dst.fp_proto = !is_ipv6 ? FIB_PROTOCOL_IP4 : FIB_PROTOCOL_IP6;
364 t->tunnel_dst.fp_addr = a->dst;
365
Neale Ranns33ce60d2017-12-14 08:51:32 -0800366 gre_tunnel_db_add (t, &key);
John Loa43ccae2018-02-13 17:15:23 -0500367 if (t->type == GRE_TUNNEL_TYPE_ERSPAN)
Swarup Nayak9ff647a2017-11-27 10:27:43 +0530368 {
John Loa43ccae2018-02-13 17:15:23 -0500369 gre_sn_key_t skey;
370 gre_sn_t *gre_sn;
371
372 gre_mk_sn_key (t, &skey);
373 gre_sn = (gre_sn_t *) hash_get_mem (gm->seq_num_by_key, &skey);
374 if (gre_sn != NULL)
375 {
376 gre_sn->ref_count++;
377 t->gre_sn = gre_sn;
378 }
379 else
380 {
381 gre_sn = clib_mem_alloc (sizeof (gre_sn_t));
382 gre_sn->seq_num = 0;
383 gre_sn->ref_count = 1;
384 t->gre_sn = gre_sn;
385 hash_set_mem_alloc (&gm->seq_num_by_key, &skey, (uword) gre_sn);
386 }
387 }
388
389 t->fib_entry_index = fib_table_entry_special_add
390 (outer_fib_index, &t->tunnel_dst, FIB_SOURCE_RR, FIB_ENTRY_FLAG_NONE);
391 t->sibling_index = fib_entry_child_add
392 (t->fib_entry_index, FIB_NODE_TYPE_GRE_TUNNEL, t_idx);
393
394 if (t->type != GRE_TUNNEL_TYPE_L3)
395 {
396 t->l2_adj_index = adj_nbr_add_or_lock
397 (t->tunnel_dst.fp_proto, VNET_LINK_ETHERNET, &zero_addr, sw_if_index);
Swarup Nayak9ff647a2017-11-27 10:27:43 +0530398 gre_update_adj (vnm, t->sw_if_index, t->l2_adj_index);
399 }
Chris Luke27fe48f2016-04-28 13:44:38 -0400400
401 if (sw_if_indexp)
402 *sw_if_indexp = sw_if_index;
Ed Warnickecb9cada2015-12-08 15:45:58 -0700403
404 return 0;
405}
406
Ciara Loftus7eac9162016-09-30 15:47:03 +0100407static int
Swarup Nayak9ff647a2017-11-27 10:27:43 +0530408vnet_gre_tunnel_delete (vnet_gre_add_del_tunnel_args_t * a,
John Loa43ccae2018-02-13 17:15:23 -0500409 u32 outer_fib_index, u32 * sw_if_indexp)
Neale Ranns0bfe5d82016-08-25 15:29:12 +0100410{
Swarup Nayak9ff647a2017-11-27 10:27:43 +0530411 gre_main_t *gm = &gre_main;
412 vnet_main_t *vnm = gm->vnet_main;
413 gre_tunnel_t *t;
Neale Ranns33ce60d2017-12-14 08:51:32 -0800414 gre_tunnel_key_t key;
Neale Ranns0bfe5d82016-08-25 15:29:12 +0100415 u32 sw_if_index;
John Lo101e0052018-01-06 00:22:54 -0500416
John Loa43ccae2018-02-13 17:15:23 -0500417 t = gre_tunnel_db_find (a, outer_fib_index, &key);
Neale Ranns0bfe5d82016-08-25 15:29:12 +0100418 if (NULL == t)
419 return VNET_API_ERROR_NO_SUCH_ENTRY;
420
421 sw_if_index = t->sw_if_index;
Swarup Nayak9ff647a2017-11-27 10:27:43 +0530422 vnet_sw_interface_set_flags (vnm, sw_if_index, 0 /* down */ );
John Loa43ccae2018-02-13 17:15:23 -0500423
Neale Ranns0bfe5d82016-08-25 15:29:12 +0100424 /* make sure tunnel is removed from l2 bd or xconnect */
Swarup Nayak9ff647a2017-11-27 10:27:43 +0530425 set_int_l2_mode (gm->vlib_main, vnm, MODE_L3, sw_if_index, 0, 0, 0, 0);
Neale Ranns0bfe5d82016-08-25 15:29:12 +0100426 gm->tunnel_index_by_sw_if_index[sw_if_index] = ~0;
Neale Ranns177bbdc2016-11-15 09:46:51 +0000427
John Loa43ccae2018-02-13 17:15:23 -0500428 if (t->type == GRE_TUNNEL_TYPE_L3)
429 vnet_delete_hw_interface (vnm, t->hw_if_index);
430 else
431 ethernet_delete_interface (vnm, t->hw_if_index);
Neale Ranns0bfe5d82016-08-25 15:29:12 +0100432
Neale Rannsad422ed2016-11-02 14:20:04 +0000433 if (t->l2_adj_index != ADJ_INDEX_INVALID)
Swarup Nayak9ff647a2017-11-27 10:27:43 +0530434 adj_unlock (t->l2_adj_index);
Neale Rannsad422ed2016-11-02 14:20:04 +0000435
Swarup Nayak9ff647a2017-11-27 10:27:43 +0530436 fib_entry_child_remove (t->fib_entry_index, t->sibling_index);
437 fib_table_entry_delete_index (t->fib_entry_index, FIB_SOURCE_RR);
Neale Ranns0bfe5d82016-08-25 15:29:12 +0100438
John Loa43ccae2018-02-13 17:15:23 -0500439 ASSERT ((t->type != GRE_TUNNEL_TYPE_ERSPAN) || (t->gre_sn != NULL));
440 if ((t->type == GRE_TUNNEL_TYPE_ERSPAN) && (t->gre_sn->ref_count-- == 1))
441 {
442 gre_sn_key_t skey;
443 gre_mk_sn_key (t, &skey);
444 hash_unset_mem_free (&gm->seq_num_by_key, &skey);
445 clib_mem_free (t->gre_sn);
446 }
447
448 hash_unset (gm->instance_used, t->user_instance);
Swarup Nayak9ff647a2017-11-27 10:27:43 +0530449 gre_tunnel_db_remove (t);
450 fib_node_deinit (&t->node);
Neale Ranns0bfe5d82016-08-25 15:29:12 +0100451 pool_put (gm->tunnels, t);
452
453 if (sw_if_indexp)
454 *sw_if_indexp = sw_if_index;
455
456 return 0;
457}
458
459int
Swarup Nayak9ff647a2017-11-27 10:27:43 +0530460vnet_gre_add_del_tunnel (vnet_gre_add_del_tunnel_args_t * a,
461 u32 * sw_if_indexp)
Neale Ranns0bfe5d82016-08-25 15:29:12 +0100462{
John Loa43ccae2018-02-13 17:15:23 -0500463 u32 outer_fib_index;
464
465 if (!a->is_ipv6)
466 outer_fib_index = ip4_fib_index_from_table_id (a->outer_fib_id);
Neale Ranns0bfe5d82016-08-25 15:29:12 +0100467 else
John Loa43ccae2018-02-13 17:15:23 -0500468 outer_fib_index = ip6_fib_index_from_table_id (a->outer_fib_id);
469
470 if (~0 == outer_fib_index)
471 return VNET_API_ERROR_NO_SUCH_FIB;
472
473 if (a->session_id > GTK_SESSION_ID_MAX)
474 return VNET_API_ERROR_INVALID_SESSION_ID;
475
476 if (a->is_add)
477 return (vnet_gre_tunnel_add (a, outer_fib_index, sw_if_indexp));
478 else
479 return (vnet_gre_tunnel_delete (a, outer_fib_index, sw_if_indexp));
Neale Ranns0bfe5d82016-08-25 15:29:12 +0100480}
481
Neale Rannsb80c5362016-10-08 13:03:40 +0100482clib_error_t *
483gre_interface_admin_up_down (vnet_main_t * vnm, u32 hw_if_index, u32 flags)
Neale Ranns0bfe5d82016-08-25 15:29:12 +0100484{
Swarup Nayak9ff647a2017-11-27 10:27:43 +0530485 gre_main_t *gm = &gre_main;
486 vnet_hw_interface_t *hi;
Neale Ranns0bfe5d82016-08-25 15:29:12 +0100487 gre_tunnel_t *t;
Neale Rannsb80c5362016-10-08 13:03:40 +0100488 u32 ti;
Neale Ranns0bfe5d82016-08-25 15:29:12 +0100489
Neale Rannsb80c5362016-10-08 13:03:40 +0100490 hi = vnet_get_hw_interface (vnm, hw_if_index);
Neale Ranns0bfe5d82016-08-25 15:29:12 +0100491
Neale Rannsb80c5362016-10-08 13:03:40 +0100492 if (NULL == gm->tunnel_index_by_sw_if_index ||
Swarup Nayak9ff647a2017-11-27 10:27:43 +0530493 hi->sw_if_index >= vec_len (gm->tunnel_index_by_sw_if_index))
494 return (NULL);
Neale Ranns0bfe5d82016-08-25 15:29:12 +0100495
Neale Rannsb80c5362016-10-08 13:03:40 +0100496 ti = gm->tunnel_index_by_sw_if_index[hi->sw_if_index];
Neale Ranns0bfe5d82016-08-25 15:29:12 +0100497
Neale Rannsb80c5362016-10-08 13:03:40 +0100498 if (~0 == ti)
Swarup Nayak9ff647a2017-11-27 10:27:43 +0530499 /* not one of ours */
500 return (NULL);
Neale Rannsb80c5362016-10-08 13:03:40 +0100501
Swarup Nayak9ff647a2017-11-27 10:27:43 +0530502 t = pool_elt_at_index (gm->tunnels, ti);
Neale Rannsb80c5362016-10-08 13:03:40 +0100503
504 if (flags & VNET_SW_INTERFACE_FLAG_ADMIN_UP)
Swarup Nayak9ff647a2017-11-27 10:27:43 +0530505 vnet_hw_interface_set_flags (vnm, hw_if_index,
506 VNET_HW_INTERFACE_FLAG_LINK_UP);
Neale Ranns0bfe5d82016-08-25 15:29:12 +0100507 else
Swarup Nayak9ff647a2017-11-27 10:27:43 +0530508 vnet_hw_interface_set_flags (vnm, hw_if_index, 0 /* down */ );
Neale Ranns0bfe5d82016-08-25 15:29:12 +0100509
Swarup Nayak9ff647a2017-11-27 10:27:43 +0530510 gre_tunnel_restack (t);
Neale Rannsb80c5362016-10-08 13:03:40 +0100511
512 return /* no error */ 0;
Neale Ranns0bfe5d82016-08-25 15:29:12 +0100513}
Ed Warnickecb9cada2015-12-08 15:45:58 -0700514
515static clib_error_t *
516create_gre_tunnel_command_fn (vlib_main_t * vm,
Swarup Nayak9ff647a2017-11-27 10:27:43 +0530517 unformat_input_t * input,
518 vlib_cli_command_t * cmd)
Ed Warnickecb9cada2015-12-08 15:45:58 -0700519{
Swarup Nayak9ff647a2017-11-27 10:27:43 +0530520 unformat_input_t _line_input, *line_input = &_line_input;
521 vnet_gre_add_del_tunnel_args_t _a, *a = &_a;
Ciara Loftus7eac9162016-09-30 15:47:03 +0100522 ip46_address_t src, dst;
John Loa43ccae2018-02-13 17:15:23 -0500523 u32 instance = ~0;
Ed Warnickecb9cada2015-12-08 15:45:58 -0700524 u32 outer_fib_id = 0;
John Loa43ccae2018-02-13 17:15:23 -0500525 gre_tunnel_type_t t_type = GRE_TUNNEL_TYPE_L3;
526 u32 session_id = 0;
Ed Warnickecb9cada2015-12-08 15:45:58 -0700527 int rv;
Ed Warnickecb9cada2015-12-08 15:45:58 -0700528 u32 num_m_args = 0;
Chris Luke27fe48f2016-04-28 13:44:38 -0400529 u8 is_add = 1;
Pierre Pfister78ea9c22016-05-23 12:51:54 +0100530 u32 sw_if_index;
Billy McFalla9a20e72017-02-15 11:39:12 -0500531 clib_error_t *error = NULL;
Ciara Loftus7eac9162016-09-30 15:47:03 +0100532 u8 ipv4_set = 0;
533 u8 ipv6_set = 0;
Ed Warnickecb9cada2015-12-08 15:45:58 -0700534
535 /* Get a line of input. */
Swarup Nayak9ff647a2017-11-27 10:27:43 +0530536 if (!unformat_user (input, unformat_line_input, line_input))
Ed Warnickecb9cada2015-12-08 15:45:58 -0700537 return 0;
538
Swarup Nayak9ff647a2017-11-27 10:27:43 +0530539 while (unformat_check_input (line_input) != UNFORMAT_END_OF_INPUT)
540 {
541 if (unformat (line_input, "del"))
542 is_add = 0;
John Loa43ccae2018-02-13 17:15:23 -0500543 else if (unformat (line_input, "instance %d", &instance))
544 ;
Swarup Nayak9ff647a2017-11-27 10:27:43 +0530545 else
546 if (unformat (line_input, "src %U", unformat_ip4_address, &src.ip4))
547 {
548 num_m_args++;
549 ipv4_set = 1;
550 }
551 else
552 if (unformat (line_input, "dst %U", unformat_ip4_address, &dst.ip4))
553 {
554 num_m_args++;
555 ipv4_set = 1;
556 }
557 else
558 if (unformat (line_input, "src %U", unformat_ip6_address, &src.ip6))
559 {
560 num_m_args++;
561 ipv6_set = 1;
562 }
563 else
564 if (unformat (line_input, "dst %U", unformat_ip6_address, &dst.ip6))
565 {
566 num_m_args++;
567 ipv6_set = 1;
568 }
569 else if (unformat (line_input, "outer-fib-id %d", &outer_fib_id))
570 ;
571 else if (unformat (line_input, "teb"))
John Loa43ccae2018-02-13 17:15:23 -0500572 t_type = GRE_TUNNEL_TYPE_TEB;
573 else if (unformat (line_input, "erspan %d", &session_id))
574 t_type = GRE_TUNNEL_TYPE_ERSPAN;
Swarup Nayak9ff647a2017-11-27 10:27:43 +0530575 else
576 {
577 error = clib_error_return (0, "unknown input `%U'",
578 format_unformat_error, line_input);
579 goto done;
580 }
581 }
Ed Warnickecb9cada2015-12-08 15:45:58 -0700582
583 if (num_m_args < 2)
Billy McFalla9a20e72017-02-15 11:39:12 -0500584 {
585 error = clib_error_return (0, "mandatory argument(s) missing");
586 goto done;
587 }
Ed Warnickecb9cada2015-12-08 15:45:58 -0700588
Swarup Nayak9ff647a2017-11-27 10:27:43 +0530589 if ((ipv4_set && memcmp (&src.ip4, &dst.ip4, sizeof (src.ip4)) == 0) ||
590 (ipv6_set && memcmp (&src.ip6, &dst.ip6, sizeof (src.ip6)) == 0))
Billy McFalla9a20e72017-02-15 11:39:12 -0500591 {
592 error = clib_error_return (0, "src and dst are identical");
593 goto done;
594 }
Ed Warnickecb9cada2015-12-08 15:45:58 -0700595
Ciara Loftus7eac9162016-09-30 15:47:03 +0100596 if (ipv4_set && ipv6_set)
Swarup Nayak9ff647a2017-11-27 10:27:43 +0530597 return clib_error_return (0, "both IPv4 and IPv6 addresses specified");
Ciara Loftus7eac9162016-09-30 15:47:03 +0100598
Swarup Nayak9ff647a2017-11-27 10:27:43 +0530599 if ((ipv4_set && memcmp (&dst.ip4, &zero_addr.ip4, sizeof (dst.ip4)) == 0)
600 || (ipv6_set
601 && memcmp (&dst.ip6, &zero_addr.ip6, sizeof (dst.ip6)) == 0))
Ciara Loftus7eac9162016-09-30 15:47:03 +0100602 {
603 error = clib_error_return (0, "dst address cannot be zero");
604 goto done;
605 }
606
Chris Luke27fe48f2016-04-28 13:44:38 -0400607 memset (a, 0, sizeof (*a));
John Loa43ccae2018-02-13 17:15:23 -0500608 a->is_add = is_add;
Hongjun Ni11bfc2f2016-07-22 18:19:19 +0800609 a->outer_fib_id = outer_fib_id;
John Loa43ccae2018-02-13 17:15:23 -0500610 a->tunnel_type = t_type;
611 a->session_id = session_id;
Ciara Loftus7eac9162016-09-30 15:47:03 +0100612 a->is_ipv6 = ipv6_set;
John Loa43ccae2018-02-13 17:15:23 -0500613 a->instance = instance;
Ciara Loftus7eac9162016-09-30 15:47:03 +0100614 if (!ipv6_set)
615 {
Swarup Nayak9ff647a2017-11-27 10:27:43 +0530616 clib_memcpy (&a->src.ip4, &src.ip4, sizeof (src.ip4));
617 clib_memcpy (&a->dst.ip4, &dst.ip4, sizeof (dst.ip4));
Ciara Loftus7eac9162016-09-30 15:47:03 +0100618 }
619 else
620 {
Swarup Nayak9ff647a2017-11-27 10:27:43 +0530621 clib_memcpy (&a->src.ip6, &src.ip6, sizeof (src.ip6));
622 clib_memcpy (&a->dst.ip6, &dst.ip6, sizeof (dst.ip6));
Ciara Loftus7eac9162016-09-30 15:47:03 +0100623 }
Chris Luke27fe48f2016-04-28 13:44:38 -0400624
John Loa43ccae2018-02-13 17:15:23 -0500625 rv = vnet_gre_add_del_tunnel (a, &sw_if_index);
Chris Luke27fe48f2016-04-28 13:44:38 -0400626
Swarup Nayak9ff647a2017-11-27 10:27:43 +0530627 switch (rv)
Ed Warnickecb9cada2015-12-08 15:45:58 -0700628 {
629 case 0:
Swarup Nayak9ff647a2017-11-27 10:27:43 +0530630 vlib_cli_output (vm, "%U\n", format_vnet_sw_if_index_name,
631 vnet_get_main (), sw_if_index);
Ed Warnickecb9cada2015-12-08 15:45:58 -0700632 break;
John Loa43ccae2018-02-13 17:15:23 -0500633 case VNET_API_ERROR_IF_ALREADY_EXISTS:
Billy McFalla9a20e72017-02-15 11:39:12 -0500634 error = clib_error_return (0, "GRE tunnel already exists...");
635 goto done;
Ed Warnickecb9cada2015-12-08 15:45:58 -0700636 case VNET_API_ERROR_NO_SUCH_FIB:
Billy McFalla9a20e72017-02-15 11:39:12 -0500637 error = clib_error_return (0, "outer fib ID %d doesn't exist\n",
Swarup Nayak9ff647a2017-11-27 10:27:43 +0530638 outer_fib_id);
Billy McFalla9a20e72017-02-15 11:39:12 -0500639 goto done;
John Loa43ccae2018-02-13 17:15:23 -0500640 case VNET_API_ERROR_NO_SUCH_ENTRY:
641 error = clib_error_return (0, "GRE tunnel doesn't exist");
642 goto done;
643 case VNET_API_ERROR_INVALID_SESSION_ID:
644 error = clib_error_return (0, "session ID %d out of range\n",
645 session_id);
646 goto done;
647 case VNET_API_ERROR_INSTANCE_IN_USE:
648 error = clib_error_return (0, "Instance is in use");
649 goto done;
Ed Warnickecb9cada2015-12-08 15:45:58 -0700650 default:
Swarup Nayak9ff647a2017-11-27 10:27:43 +0530651 error =
652 clib_error_return (0, "vnet_gre_add_del_tunnel returned %d", rv);
Billy McFalla9a20e72017-02-15 11:39:12 -0500653 goto done;
Ed Warnickecb9cada2015-12-08 15:45:58 -0700654 }
655
Billy McFalla9a20e72017-02-15 11:39:12 -0500656done:
657 unformat_free (line_input);
658
659 return error;
Ed Warnickecb9cada2015-12-08 15:45:58 -0700660}
661
Swarup Nayak9ff647a2017-11-27 10:27:43 +0530662/* *INDENT-OFF* */
Ed Warnickecb9cada2015-12-08 15:45:58 -0700663VLIB_CLI_COMMAND (create_gre_tunnel_command, static) = {
664 .path = "create gre tunnel",
John Loa43ccae2018-02-13 17:15:23 -0500665 .short_help = "create gre tunnel src <addr> dst <addr> [instance <n>] "
666 "[outer-fib-id <fib>] [teb | erspan <session-id>] [del]",
Ed Warnickecb9cada2015-12-08 15:45:58 -0700667 .function = create_gre_tunnel_command_fn,
668};
Swarup Nayak9ff647a2017-11-27 10:27:43 +0530669/* *INDENT-ON* */
Ed Warnickecb9cada2015-12-08 15:45:58 -0700670
Chris Luke27fe48f2016-04-28 13:44:38 -0400671static clib_error_t *
672show_gre_tunnel_command_fn (vlib_main_t * vm,
Swarup Nayak9ff647a2017-11-27 10:27:43 +0530673 unformat_input_t * input,
674 vlib_cli_command_t * cmd)
Chris Luke27fe48f2016-04-28 13:44:38 -0400675{
Swarup Nayak9ff647a2017-11-27 10:27:43 +0530676 gre_main_t *gm = &gre_main;
677 gre_tunnel_t *t;
Neale Ranns0bfe5d82016-08-25 15:29:12 +0100678 u32 ti = ~0;
Chris Luke27fe48f2016-04-28 13:44:38 -0400679
680 if (pool_elts (gm->tunnels) == 0)
681 vlib_cli_output (vm, "No GRE tunnels configured...");
682
Neale Ranns0bfe5d82016-08-25 15:29:12 +0100683 while (unformat_check_input (input) != UNFORMAT_END_OF_INPUT)
684 {
685 if (unformat (input, "%d", &ti))
Swarup Nayak9ff647a2017-11-27 10:27:43 +0530686 ;
Neale Ranns0bfe5d82016-08-25 15:29:12 +0100687 else
Swarup Nayak9ff647a2017-11-27 10:27:43 +0530688 break;
Neale Ranns0bfe5d82016-08-25 15:29:12 +0100689 }
690
691 if (~0 == ti)
692 {
Swarup Nayak9ff647a2017-11-27 10:27:43 +0530693 /* *INDENT-OFF* */
Neale Ranns0bfe5d82016-08-25 15:29:12 +0100694 pool_foreach (t, gm->tunnels,
695 ({
Neale Rannsb80c5362016-10-08 13:03:40 +0100696 vlib_cli_output (vm, "%U", format_gre_tunnel, t);
Neale Ranns0bfe5d82016-08-25 15:29:12 +0100697 }));
Swarup Nayak9ff647a2017-11-27 10:27:43 +0530698 /* *INDENT-ON* */
Neale Ranns0bfe5d82016-08-25 15:29:12 +0100699 }
700 else
Swarup Nayak9ff647a2017-11-27 10:27:43 +0530701 {
702 t = pool_elt_at_index (gm->tunnels, ti);
Neale Ranns0bfe5d82016-08-25 15:29:12 +0100703
Neale Rannsb80c5362016-10-08 13:03:40 +0100704 vlib_cli_output (vm, "%U", format_gre_tunnel, t);
Swarup Nayak9ff647a2017-11-27 10:27:43 +0530705 }
Chris Luke27fe48f2016-04-28 13:44:38 -0400706
707 return 0;
708}
709
Swarup Nayak9ff647a2017-11-27 10:27:43 +0530710/* *INDENT-OFF* */
Chris Luke27fe48f2016-04-28 13:44:38 -0400711VLIB_CLI_COMMAND (show_gre_tunnel_command, static) = {
712 .path = "show gre tunnel",
713 .function = show_gre_tunnel_command_fn,
714};
Swarup Nayak9ff647a2017-11-27 10:27:43 +0530715/* *INDENT-ON* */
Chris Luke27fe48f2016-04-28 13:44:38 -0400716
Ed Warnickecb9cada2015-12-08 15:45:58 -0700717/* force inclusion from application's main.c */
Swarup Nayak9ff647a2017-11-27 10:27:43 +0530718clib_error_t *
719gre_interface_init (vlib_main_t * vm)
Ed Warnickecb9cada2015-12-08 15:45:58 -0700720{
Swarup Nayak9ff647a2017-11-27 10:27:43 +0530721 fib_node_register_type (FIB_NODE_TYPE_GRE_TUNNEL, &gre_vft);
Neale Ranns0bfe5d82016-08-25 15:29:12 +0100722
Ed Warnickecb9cada2015-12-08 15:45:58 -0700723 return 0;
724}
Swarup Nayak9ff647a2017-11-27 10:27:43 +0530725
726VLIB_INIT_FUNCTION (gre_interface_init);
727
728/*
729 * fd.io coding-style-patch-verification: ON
730 *
731 * Local Variables:
732 * eval: (c-set-style "gnu")
733 * End:
734 */