hard-interface.c 17.1 KB
Newer Older
1
/*
2
 * Copyright (C) 2007-2011 B.A.T.M.A.N. contributors:
3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33
 *
 * Marek Lindner, Simon Wunderlich
 *
 * This program is free software; you can redistribute it and/or
 * modify it under the terms of version 2 of the GNU General Public
 * License as published by the Free Software Foundation.
 *
 * This program is distributed in the hope that it will be useful, but
 * WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
 * General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
 * 02110-1301, USA
 *
 */

#include "main.h"
#include "hard-interface.h"
#include "soft-interface.h"
#include "send.h"
#include "translation-table.h"
#include "routing.h"
#include "bat_sysfs.h"
#include "originator.h"
#include "hash.h"

#include <linux/if_arp.h>

34 35
/* protect update critical side of hardif_list - but not the content */
static DEFINE_SPINLOCK(hardif_list_lock);
36

37 38 39 40 41 42

static int batman_skb_recv(struct sk_buff *skb,
			   struct net_device *dev,
			   struct packet_type *ptype,
			   struct net_device *orig_dev);

43
void hardif_free_rcu(struct rcu_head *rcu)
44
{
45
	struct hard_iface *hard_iface;
46

47 48 49
	hard_iface = container_of(rcu, struct hard_iface, rcu);
	dev_put(hard_iface->net_dev);
	kfree(hard_iface);
50 51
}

52
struct hard_iface *hardif_get_by_netdev(struct net_device *net_dev)
53
{
54
	struct hard_iface *hard_iface;
55 56

	rcu_read_lock();
57 58 59
	list_for_each_entry_rcu(hard_iface, &hardif_list, list) {
		if (hard_iface->net_dev == net_dev &&
		    atomic_inc_not_zero(&hard_iface->refcount))
60 61 62
			goto out;
	}

63
	hard_iface = NULL;
64 65 66

out:
	rcu_read_unlock();
67
	return hard_iface;
68 69 70 71 72 73 74 75 76 77 78 79 80 81
}

static int is_valid_iface(struct net_device *net_dev)
{
	if (net_dev->flags & IFF_LOOPBACK)
		return 0;

	if (net_dev->type != ARPHRD_ETHER)
		return 0;

	if (net_dev->addr_len != ETH_ALEN)
		return 0;

	/* no batman over batman */
82
	if (softif_is_valid(net_dev))
83 84 85 86 87 88 89 90 91
		return 0;

	/* Device is being bridged */
	/* if (net_dev->priv_flags & IFF_BRIDGE_PORT)
		return 0; */

	return 1;
}

92
static struct hard_iface *hardif_get_active(struct net_device *soft_iface)
93
{
94
	struct hard_iface *hard_iface;
95 96

	rcu_read_lock();
97 98
	list_for_each_entry_rcu(hard_iface, &hardif_list, list) {
		if (hard_iface->soft_iface != soft_iface)
99 100
			continue;

101 102
		if (hard_iface->if_status == IF_ACTIVE &&
		    atomic_inc_not_zero(&hard_iface->refcount))
103 104 105
			goto out;
	}

106
	hard_iface = NULL;
107 108 109

out:
	rcu_read_unlock();
110
	return hard_iface;
111 112
}

113
static void primary_if_update_addr(struct bat_priv *bat_priv)
114 115
{
	struct vis_packet *vis_packet;
116 117 118 119 120
	struct hard_iface *primary_if;

	primary_if = primary_if_get_selected(bat_priv);
	if (!primary_if)
		goto out;
121 122 123

	vis_packet = (struct vis_packet *)
				bat_priv->my_vis_info->skb_packet->data;
124
	memcpy(vis_packet->vis_orig, primary_if->net_dev->dev_addr, ETH_ALEN);
125
	memcpy(vis_packet->sender_orig,
126 127 128 129 130
	       primary_if->net_dev->dev_addr, ETH_ALEN);

out:
	if (primary_if)
		hardif_free_ref(primary_if);
131 132
}

133 134
static void primary_if_select(struct bat_priv *bat_priv,
			      struct hard_iface *new_hard_iface)
135
{
136
	struct hard_iface *curr_hard_iface;
137 138
	struct batman_packet *batman_packet;

139
	spin_lock_bh(&hardif_list_lock);
140

141 142
	if (new_hard_iface && !atomic_inc_not_zero(&new_hard_iface->refcount))
		new_hard_iface = NULL;
143

144 145
	curr_hard_iface = bat_priv->primary_if;
	rcu_assign_pointer(bat_priv->primary_if, new_hard_iface);
146

147 148
	if (curr_hard_iface)
		hardif_free_ref(curr_hard_iface);
149

150 151 152 153
	if (!new_hard_iface)
		goto out;

	batman_packet = (struct batman_packet *)(new_hard_iface->packet_buff);
154 155 156
	batman_packet->flags = PRIMARIES_FIRST_HOP;
	batman_packet->ttl = TTL;

157
	primary_if_update_addr(bat_priv);
158 159 160 161 162 163

	/***
	 * hacky trick to make sure that we send the HNA information via
	 * our new primary interface
	 */
	atomic_set(&bat_priv->hna_local_changed, 1);
164 165 166

out:
	spin_unlock_bh(&hardif_list_lock);
167 168
}

169
static bool hardif_is_iface_up(struct hard_iface *hard_iface)
170
{
171
	if (hard_iface->net_dev->flags & IFF_UP)
172 173 174 175 176
		return true;

	return false;
}

177
static void update_mac_addresses(struct hard_iface *hard_iface)
178
{
179 180 181 182
	memcpy(((struct batman_packet *)(hard_iface->packet_buff))->orig,
	       hard_iface->net_dev->dev_addr, ETH_ALEN);
	memcpy(((struct batman_packet *)(hard_iface->packet_buff))->prev_sender,
	       hard_iface->net_dev->dev_addr, ETH_ALEN);
183 184 185 186
}

static void check_known_mac_addr(struct net_device *net_dev)
{
187
	struct hard_iface *hard_iface;
188 189

	rcu_read_lock();
190 191 192
	list_for_each_entry_rcu(hard_iface, &hardif_list, list) {
		if ((hard_iface->if_status != IF_ACTIVE) &&
		    (hard_iface->if_status != IF_TO_BE_ACTIVATED))
193 194
			continue;

195
		if (hard_iface->net_dev == net_dev)
196 197
			continue;

198 199
		if (!compare_eth(hard_iface->net_dev->dev_addr,
				 net_dev->dev_addr))
200 201 202 203
			continue;

		pr_warning("The newly added mac address (%pM) already exists "
			   "on: %s\n", net_dev->dev_addr,
204
			   hard_iface->net_dev->name);
205 206 207 208 209 210 211 212 213
		pr_warning("It is strongly recommended to keep mac addresses "
			   "unique to avoid problems!\n");
	}
	rcu_read_unlock();
}

int hardif_min_mtu(struct net_device *soft_iface)
{
	struct bat_priv *bat_priv = netdev_priv(soft_iface);
214
	struct hard_iface *hard_iface;
215 216 217 218 219 220 221 222
	/* allow big frames if all devices are capable to do so
	 * (have MTU > 1500 + BAT_HEADER_LEN) */
	int min_mtu = ETH_DATA_LEN;

	if (atomic_read(&bat_priv->fragmentation))
		goto out;

	rcu_read_lock();
223 224 225
	list_for_each_entry_rcu(hard_iface, &hardif_list, list) {
		if ((hard_iface->if_status != IF_ACTIVE) &&
		    (hard_iface->if_status != IF_TO_BE_ACTIVATED))
226 227
			continue;

228
		if (hard_iface->soft_iface != soft_iface)
229 230
			continue;

231
		min_mtu = min_t(int, hard_iface->net_dev->mtu - BAT_HEADER_LEN,
232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248
				min_mtu);
	}
	rcu_read_unlock();
out:
	return min_mtu;
}

/* adjusts the MTU if a new interface with a smaller MTU appeared. */
void update_min_mtu(struct net_device *soft_iface)
{
	int min_mtu;

	min_mtu = hardif_min_mtu(soft_iface);
	if (soft_iface->mtu != min_mtu)
		soft_iface->mtu = min_mtu;
}

249
static void hardif_activate_interface(struct hard_iface *hard_iface)
250 251
{
	struct bat_priv *bat_priv;
252
	struct hard_iface *primary_if = NULL;
253

254
	if (hard_iface->if_status != IF_INACTIVE)
255
		goto out;
256

257
	bat_priv = netdev_priv(hard_iface->soft_iface);
258

259 260
	update_mac_addresses(hard_iface);
	hard_iface->if_status = IF_TO_BE_ACTIVATED;
261 262 263 264 265

	/**
	 * the first active interface becomes our primary interface or
	 * the next active interface after the old primay interface was removed
	 */
266 267 268
	primary_if = primary_if_get_selected(bat_priv);
	if (!primary_if)
		primary_if_select(bat_priv, hard_iface);
269

270 271
	bat_info(hard_iface->soft_iface, "Interface activated: %s\n",
		 hard_iface->net_dev->name);
272

273
	update_min_mtu(hard_iface->soft_iface);
274 275 276 277

out:
	if (primary_if)
		hardif_free_ref(primary_if);
278 279
}

280
static void hardif_deactivate_interface(struct hard_iface *hard_iface)
281
{
282 283
	if ((hard_iface->if_status != IF_ACTIVE) &&
	    (hard_iface->if_status != IF_TO_BE_ACTIVATED))
284 285
		return;

286
	hard_iface->if_status = IF_INACTIVE;
287

288 289
	bat_info(hard_iface->soft_iface, "Interface deactivated: %s\n",
		 hard_iface->net_dev->name);
290

291
	update_min_mtu(hard_iface->soft_iface);
292 293
}

294
int hardif_enable_interface(struct hard_iface *hard_iface, char *iface_name)
295 296 297
{
	struct bat_priv *bat_priv;
	struct batman_packet *batman_packet;
298 299
	struct net_device *soft_iface;
	int ret;
300

301
	if (hard_iface->if_status != IF_NOT_IN_USE)
302 303
		goto out;

304
	if (!atomic_inc_not_zero(&hard_iface->refcount))
305 306
		goto out;

307
	soft_iface = dev_get_by_name(&init_net, iface_name);
308

309 310
	if (!soft_iface) {
		soft_iface = softif_create(iface_name);
311

312 313
		if (!soft_iface) {
			ret = -ENOMEM;
314
			goto err;
315
		}
316 317

		/* dev_get_by_name() increases the reference counter for us */
318 319 320 321 322 323 324 325 326 327
		dev_hold(soft_iface);
	}

	if (!softif_is_valid(soft_iface)) {
		pr_err("Can't create batman mesh interface %s: "
		       "already exists as regular interface\n",
		       soft_iface->name);
		dev_put(soft_iface);
		ret = -EINVAL;
		goto err;
328 329
	}

330
	hard_iface->soft_iface = soft_iface;
331 332 333
	bat_priv = netdev_priv(hard_iface->soft_iface);
	hard_iface->packet_len = BAT_PACKET_LEN;
	hard_iface->packet_buff = kmalloc(hard_iface->packet_len, GFP_ATOMIC);
334

335 336 337
	if (!hard_iface->packet_buff) {
		bat_err(hard_iface->soft_iface, "Can't add interface packet "
			"(%s): out of memory\n", hard_iface->net_dev->name);
338
		ret = -ENOMEM;
339 340 341
		goto err;
	}

342
	batman_packet = (struct batman_packet *)(hard_iface->packet_buff);
343 344 345 346 347 348 349
	batman_packet->packet_type = BAT_PACKET;
	batman_packet->version = COMPAT_VERSION;
	batman_packet->flags = 0;
	batman_packet->ttl = 2;
	batman_packet->tq = TQ_MAX_VALUE;
	batman_packet->num_hna = 0;

350
	hard_iface->if_num = bat_priv->num_ifaces;
351
	bat_priv->num_ifaces++;
352 353
	hard_iface->if_status = IF_INACTIVE;
	orig_hash_add_if(hard_iface, bat_priv->num_ifaces);
354

355 356 357 358
	hard_iface->batman_adv_ptype.type = __constant_htons(ETH_P_BATMAN);
	hard_iface->batman_adv_ptype.func = batman_skb_recv;
	hard_iface->batman_adv_ptype.dev = hard_iface->net_dev;
	dev_add_pack(&hard_iface->batman_adv_ptype);
359

360 361 362 363
	atomic_set(&hard_iface->seqno, 1);
	atomic_set(&hard_iface->frag_seqno, 1);
	bat_info(hard_iface->soft_iface, "Adding interface: %s\n",
		 hard_iface->net_dev->name);
364

365
	if (atomic_read(&bat_priv->fragmentation) && hard_iface->net_dev->mtu <
366
		ETH_DATA_LEN + BAT_HEADER_LEN)
367
		bat_info(hard_iface->soft_iface,
368 369 370 371 372
			"The MTU of interface %s is too small (%i) to handle "
			"the transport of batman-adv packets. Packets going "
			"over this interface will be fragmented on layer2 "
			"which could impact the performance. Setting the MTU "
			"to %zi would solve the problem.\n",
373
			hard_iface->net_dev->name, hard_iface->net_dev->mtu,
374 375
			ETH_DATA_LEN + BAT_HEADER_LEN);

376
	if (!atomic_read(&bat_priv->fragmentation) && hard_iface->net_dev->mtu <
377
		ETH_DATA_LEN + BAT_HEADER_LEN)
378
		bat_info(hard_iface->soft_iface,
379 380 381 382
			"The MTU of interface %s is too small (%i) to handle "
			"the transport of batman-adv packets. If you experience"
			" problems getting traffic through try increasing the "
			"MTU to %zi.\n",
383
			hard_iface->net_dev->name, hard_iface->net_dev->mtu,
384 385
			ETH_DATA_LEN + BAT_HEADER_LEN);

386 387
	if (hardif_is_iface_up(hard_iface))
		hardif_activate_interface(hard_iface);
388
	else
389
		bat_err(hard_iface->soft_iface, "Not using interface %s "
390
			"(retrying later): interface not active\n",
391
			hard_iface->net_dev->name);
392 393

	/* begin scheduling originator messages on that interface */
394
	schedule_own_packet(hard_iface);
395 396 397 398 399

out:
	return 0;

err:
400
	hardif_free_ref(hard_iface);
401
	return ret;
402 403
}

404
void hardif_disable_interface(struct hard_iface *hard_iface)
405
{
406
	struct bat_priv *bat_priv = netdev_priv(hard_iface->soft_iface);
407
	struct hard_iface *primary_if = NULL;
408

409 410
	if (hard_iface->if_status == IF_ACTIVE)
		hardif_deactivate_interface(hard_iface);
411

412
	if (hard_iface->if_status != IF_INACTIVE)
413
		goto out;
414

415 416 417
	bat_info(hard_iface->soft_iface, "Removing interface: %s\n",
		 hard_iface->net_dev->name);
	dev_remove_pack(&hard_iface->batman_adv_ptype);
418 419

	bat_priv->num_ifaces--;
420
	orig_hash_del_if(hard_iface, bat_priv->num_ifaces);
421

422 423
	primary_if = primary_if_get_selected(bat_priv);
	if (hard_iface == primary_if) {
424
		struct hard_iface *new_if;
425

426
		new_if = hardif_get_active(hard_iface->soft_iface);
427
		primary_if_select(bat_priv, new_if);
428 429

		if (new_if)
430
			hardif_free_ref(new_if);
431 432
	}

433 434 435
	kfree(hard_iface->packet_buff);
	hard_iface->packet_buff = NULL;
	hard_iface->if_status = IF_NOT_IN_USE;
436

437
	/* delete all references to this hard_iface */
438
	purge_orig_ref(bat_priv);
439 440
	purge_outstanding_packets(bat_priv, hard_iface);
	dev_put(hard_iface->soft_iface);
441 442 443

	/* nobody uses this interface anymore */
	if (!bat_priv->num_ifaces)
444
		softif_destroy(hard_iface->soft_iface);
445

446 447
	hard_iface->soft_iface = NULL;
	hardif_free_ref(hard_iface);
448 449 450 451

out:
	if (primary_if)
		hardif_free_ref(primary_if);
452 453
}

454
static struct hard_iface *hardif_add_interface(struct net_device *net_dev)
455
{
456
	struct hard_iface *hard_iface;
457 458 459 460 461 462 463 464
	int ret;

	ret = is_valid_iface(net_dev);
	if (ret != 1)
		goto out;

	dev_hold(net_dev);

465 466
	hard_iface = kmalloc(sizeof(struct hard_iface), GFP_ATOMIC);
	if (!hard_iface) {
467 468 469 470 471
		pr_err("Can't add interface (%s): out of memory\n",
		       net_dev->name);
		goto release_dev;
	}

472
	ret = sysfs_add_hardif(&hard_iface->hardif_obj, net_dev);
473 474 475
	if (ret)
		goto free_if;

476 477 478 479 480
	hard_iface->if_num = -1;
	hard_iface->net_dev = net_dev;
	hard_iface->soft_iface = NULL;
	hard_iface->if_status = IF_NOT_IN_USE;
	INIT_LIST_HEAD(&hard_iface->list);
481
	/* extra reference for return */
482
	atomic_set(&hard_iface->refcount, 2);
483

484
	check_known_mac_addr(hard_iface->net_dev);
485

486
	spin_lock(&hardif_list_lock);
487
	list_add_tail_rcu(&hard_iface->list, &hardif_list);
488
	spin_unlock(&hardif_list_lock);
489

490
	return hard_iface;
491 492

free_if:
493
	kfree(hard_iface);
494 495 496 497 498 499
release_dev:
	dev_put(net_dev);
out:
	return NULL;
}

500
static void hardif_remove_interface(struct hard_iface *hard_iface)
501 502
{
	/* first deactivate interface */
503 504
	if (hard_iface->if_status != IF_NOT_IN_USE)
		hardif_disable_interface(hard_iface);
505

506
	if (hard_iface->if_status != IF_NOT_IN_USE)
507 508
		return;

509 510 511
	hard_iface->if_status = IF_TO_BE_REMOVED;
	sysfs_del_hardif(&hard_iface->hardif_obj);
	hardif_free_ref(hard_iface);
512 513 514 515
}

void hardif_remove_interfaces(void)
{
516
	struct hard_iface *hard_iface, *hard_iface_tmp;
517 518 519 520
	struct list_head if_queue;

	INIT_LIST_HEAD(&if_queue);

521
	spin_lock(&hardif_list_lock);
522 523 524 525
	list_for_each_entry_safe(hard_iface, hard_iface_tmp,
				 &hardif_list, list) {
		list_del_rcu(&hard_iface->list);
		list_add_tail(&hard_iface->list, &if_queue);
526
	}
527
	spin_unlock(&hardif_list_lock);
528 529

	rtnl_lock();
530 531
	list_for_each_entry_safe(hard_iface, hard_iface_tmp, &if_queue, list) {
		hardif_remove_interface(hard_iface);
532 533 534 535 536 537 538 539
	}
	rtnl_unlock();
}

static int hard_if_event(struct notifier_block *this,
			 unsigned long event, void *ptr)
{
	struct net_device *net_dev = (struct net_device *)ptr;
540
	struct hard_iface *hard_iface = hardif_get_by_netdev(net_dev);
541
	struct hard_iface *primary_if = NULL;
542 543
	struct bat_priv *bat_priv;

544 545
	if (!hard_iface && event == NETDEV_REGISTER)
		hard_iface = hardif_add_interface(net_dev);
546

547
	if (!hard_iface)
548 549 550 551
		goto out;

	switch (event) {
	case NETDEV_UP:
552
		hardif_activate_interface(hard_iface);
553 554 555
		break;
	case NETDEV_GOING_DOWN:
	case NETDEV_DOWN:
556
		hardif_deactivate_interface(hard_iface);
557 558
		break;
	case NETDEV_UNREGISTER:
559
		spin_lock(&hardif_list_lock);
560
		list_del_rcu(&hard_iface->list);
561
		spin_unlock(&hardif_list_lock);
562

563
		hardif_remove_interface(hard_iface);
564 565
		break;
	case NETDEV_CHANGEMTU:
566 567
		if (hard_iface->soft_iface)
			update_min_mtu(hard_iface->soft_iface);
568 569
		break;
	case NETDEV_CHANGEADDR:
570
		if (hard_iface->if_status == IF_NOT_IN_USE)
571 572
			goto hardif_put;

573 574
		check_known_mac_addr(hard_iface->net_dev);
		update_mac_addresses(hard_iface);
575

576
		bat_priv = netdev_priv(hard_iface->soft_iface);
577 578 579 580 581 582
		primary_if = primary_if_get_selected(bat_priv);
		if (!primary_if)
			goto hardif_put;

		if (hard_iface == primary_if)
			primary_if_update_addr(bat_priv);
583 584 585 586 587 588
		break;
	default:
		break;
	};

hardif_put:
589
	hardif_free_ref(hard_iface);
590
out:
591 592
	if (primary_if)
		hardif_free_ref(primary_if);
593 594 595 596 597
	return NOTIFY_DONE;
}

/* receive a packet with the batman ethertype coming on a hard
 * interface */
598 599 600
static int batman_skb_recv(struct sk_buff *skb, struct net_device *dev,
			   struct packet_type *ptype,
			   struct net_device *orig_dev)
601 602 603
{
	struct bat_priv *bat_priv;
	struct batman_packet *batman_packet;
604
	struct hard_iface *hard_iface;
605 606
	int ret;

607
	hard_iface = container_of(ptype, struct hard_iface, batman_adv_ptype);
608 609 610 611 612 613 614 615 616 617 618 619 620 621 622
	skb = skb_share_check(skb, GFP_ATOMIC);

	/* skb was released by skb_share_check() */
	if (!skb)
		goto err_out;

	/* packet should hold at least type and version */
	if (unlikely(!pskb_may_pull(skb, 2)))
		goto err_free;

	/* expect a valid ethernet header here. */
	if (unlikely(skb->mac_len != sizeof(struct ethhdr)
				|| !skb_mac_header(skb)))
		goto err_free;

623
	if (!hard_iface->soft_iface)
624 625
		goto err_free;

626
	bat_priv = netdev_priv(hard_iface->soft_iface);
627 628 629 630 631

	if (atomic_read(&bat_priv->mesh_state) != MESH_ACTIVE)
		goto err_free;

	/* discard frames on not active interfaces */
632
	if (hard_iface->if_status != IF_ACTIVE)
633 634 635 636 637 638 639 640 641 642 643 644 645 646 647 648 649
		goto err_free;

	batman_packet = (struct batman_packet *)skb->data;

	if (batman_packet->version != COMPAT_VERSION) {
		bat_dbg(DBG_BATMAN, bat_priv,
			"Drop packet: incompatible batman version (%i)\n",
			batman_packet->version);
		goto err_free;
	}

	/* all receive handlers return whether they received or reused
	 * the supplied skb. if not, we have to free the skb. */

	switch (batman_packet->packet_type) {
		/* batman originator packet */
	case BAT_PACKET:
650
		ret = recv_bat_packet(skb, hard_iface);
651 652 653 654
		break;

		/* batman icmp packet */
	case BAT_ICMP:
655
		ret = recv_icmp_packet(skb, hard_iface);
656 657 658 659
		break;

		/* unicast packet */
	case BAT_UNICAST:
660
		ret = recv_unicast_packet(skb, hard_iface);
661 662 663 664
		break;

		/* fragmented unicast packet */
	case BAT_UNICAST_FRAG:
665
		ret = recv_ucast_frag_packet(skb, hard_iface);
666 667 668 669
		break;

		/* broadcast packet */
	case BAT_BCAST:
670
		ret = recv_bcast_packet(skb, hard_iface);
671 672 673 674
		break;

		/* vis packet */
	case BAT_VIS:
675
		ret = recv_vis_packet(skb, hard_iface);
676 677 678 679 680 681 682 683 684 685 686 687 688 689 690 691 692 693 694 695 696 697 698
		break;
	default:
		ret = NET_RX_DROP;
	}

	if (ret == NET_RX_DROP)
		kfree_skb(skb);

	/* return NET_RX_SUCCESS in any case as we
	 * most probably dropped the packet for
	 * routing-logical reasons. */

	return NET_RX_SUCCESS;

err_free:
	kfree_skb(skb);
err_out:
	return NET_RX_DROP;
}

struct notifier_block hard_if_notifier = {
	.notifier_call = hard_if_event,
};