net/hsr/hsr_framereg.c

   1 // SPDX-License-Identifier: GPL-2.0
   2 /* Copyright 2011-2014 Autronica Fire and Security AS
   3  *
   4  * Author(s):
   5  *      2011-2014 Arvid Brodin, arvid.brodin@alten.se
   6  *
   7  * The HSR spec says never to forward the same frame twice on the same
   8  * interface. A frame is identified by its source MAC address and its HSR
   9  * sequence number. This code keeps track of senders and their sequence numbers
  10  * to allow filtering of duplicate frames, and to detect HSR ring errors.
  11  * Same code handles filtering of duplicates for PRP as well.
  12  */
  13
  14 #include <linux/if_ether.h>
  15 #include <linux/etherdevice.h>
  16 #include <linux/slab.h>
  17 #include <linux/rculist.h>
  18 #include "hsr_main.h"
  19 #include "hsr_framereg.h"
  20 #include "hsr_netlink.h"
  21
  22 /*      TODO: use hash lists for mac addresses (linux/jhash.h)?    */
  23
  24 /* seq_nr_after(a, b) - return true if a is after (higher in sequence than) b,
  25  * false otherwise.
  26  */
  27 static bool seq_nr_after(u16 a, u16 b)
  28 {
  29         /* Remove inconsistency where
  30          * seq_nr_after(a, b) == seq_nr_before(a, b)
  31          */
  32         if ((int)b - a == 32768)
  33                 return false;
  34
  35         return (((s16)(b - a)) < 0);
  36 }
  37
  38 #define seq_nr_before(a, b)             seq_nr_after((b), (a))
  39 #define seq_nr_before_or_eq(a, b)       (!seq_nr_after((a), (b)))
  40
  41 bool hsr_addr_is_self(struct hsr_priv *hsr, unsigned char *addr)
  42 {
  43         struct hsr_node *node;
  44
  45         node = list_first_or_null_rcu(&hsr->self_node_db, struct hsr_node,
  46                                       mac_list);
  47         if (!node) {
  48                 WARN_ONCE(1, "HSR: No self node\n");
  49                 return false;
  50         }
  51
  52         if (ether_addr_equal(addr, node->macaddress_A))
  53                 return true;
  54         if (ether_addr_equal(addr, node->macaddress_B))
  55                 return true;
  56
  57         return false;
  58 }
  59
  60 /* Search for mac entry. Caller must hold rcu read lock.
  61  */
  62 static struct hsr_node *find_node_by_addr_A(struct list_head *node_db,
  63                                             const unsigned char addr[ETH_ALEN])
  64 {
  65         struct hsr_node *node;
  66
  67         list_for_each_entry_rcu(node, node_db, mac_list) {
  68                 if (ether_addr_equal(node->macaddress_A, addr))
  69                         return node;
  70         }
  71
  72         return NULL;
  73 }
  74
  75 /* Helper for device init; the self_node_db is used in hsr_rcv() to recognize
  76  * frames from self that's been looped over the HSR ring.
  77  */
  78 int hsr_create_self_node(struct hsr_priv *hsr,
  79                          unsigned char addr_a[ETH_ALEN],
  80                          unsigned char addr_b[ETH_ALEN])
  81 {
  82         struct list_head *self_node_db = &hsr->self_node_db;
  83         struct hsr_node *node, *oldnode;
  84
  85         node = kmalloc(sizeof(*node), GFP_KERNEL);
  86         if (!node)
  87                 return -ENOMEM;
  88
  89         ether_addr_copy(node->macaddress_A, addr_a);
  90         ether_addr_copy(node->macaddress_B, addr_b);
  91
  92         spin_lock_bh(&hsr->list_lock);
  93         oldnode = list_first_or_null_rcu(self_node_db,
  94                                          struct hsr_node, mac_list);
  95         if (oldnode) {
  96                 list_replace_rcu(&oldnode->mac_list, &node->mac_list);
  97                 spin_unlock_bh(&hsr->list_lock);
  98                 kfree_rcu(oldnode, rcu_head);
  99         } else {
 100                 list_add_tail_rcu(&node->mac_list, self_node_db);
 101                 spin_unlock_bh(&hsr->list_lock);
 102         }
 103
 104         return 0;
 105 }
 106
 107 void hsr_del_self_node(struct hsr_priv *hsr)
 108 {
 109         struct list_head *self_node_db = &hsr->self_node_db;
 110         struct hsr_node *node;
 111
 112         spin_lock_bh(&hsr->list_lock);
 113         node = list_first_or_null_rcu(self_node_db, struct hsr_node, mac_list);
 114         if (node) {
 115                 list_del_rcu(&node->mac_list);
 116                 kfree_rcu(node, rcu_head);
 117         }
 118         spin_unlock_bh(&hsr->list_lock);
 119 }
 120
 121 void hsr_del_nodes(struct list_head *node_db)
 122 {
 123         struct hsr_node *node;
 124         struct hsr_node *tmp;
 125
 126         list_for_each_entry_safe(node, tmp, node_db, mac_list)
 127                 kfree(node);
 128 }
 129
 130 void prp_handle_san_frame(bool san, enum hsr_port_type port,
 131                           struct hsr_node *node)
 132 {
 133         /* Mark if the SAN node is over LAN_A or LAN_B */
 134         if (port == HSR_PT_SLAVE_A) {
 135                 node->san_a = true;
 136                 return;
 137         }
 138
 139         if (port == HSR_PT_SLAVE_B)
 140                 node->san_b = true;
 141 }
 142
 143 /* Allocate an hsr_node and add it to node_db. 'addr' is the node's address_A;
 144  * seq_out is used to initialize filtering of outgoing duplicate frames
 145  * originating from the newly added node.
 146  */
 147 static struct hsr_node *hsr_add_node(struct hsr_priv *hsr,
 148                                      struct list_head *node_db,
 149                                      unsigned char addr[],
 150                                      u16 seq_out, bool san,
 151                                      enum hsr_port_type rx_port)
 152 {
 153         struct hsr_node *new_node, *node;
 154         unsigned long now;
 155         int i;
 156
 157         new_node = kzalloc(sizeof(*new_node), GFP_ATOMIC);
 158         if (!new_node)
 159                 return NULL;
 160
 161         ether_addr_copy(new_node->macaddress_A, addr);
 162
 163         /* We are only interested in time diffs here, so use current jiffies
 164          * as initialization. (0 could trigger an spurious ring error warning).
 165          */
 166         now = jiffies;
 167         for (i = 0; i < HSR_PT_PORTS; i++) {
 168                 new_node->time_in[i] = now;
 169                 new_node->time_out[i] = now;
 170         }
 171         for (i = 0; i < HSR_PT_PORTS; i++)
 172                 new_node->seq_out[i] = seq_out;
 173
 174         if (san && hsr->proto_ops->handle_san_frame)
 175                 hsr->proto_ops->handle_san_frame(san, rx_port, new_node);
 176
 177         spin_lock_bh(&hsr->list_lock);
 178         list_for_each_entry_rcu(node, node_db, mac_list,
 179                                 lockdep_is_held(&hsr->list_lock)) {
 180                 if (ether_addr_equal(node->macaddress_A, addr))
 181                         goto out;
 182                 if (ether_addr_equal(node->macaddress_B, addr))
 183                         goto out;
 184         }
 185         list_add_tail_rcu(&new_node->mac_list, node_db);
 186         spin_unlock_bh(&hsr->list_lock);
 187         return new_node;
 188 out:
 189         spin_unlock_bh(&hsr->list_lock);
 190         kfree(new_node);
 191         return node;
 192 }
 193
 194 void prp_update_san_info(struct hsr_node *node, bool is_sup)
 195 {
 196         if (!is_sup)
 197                 return;
 198
 199         node->san_a = false;
 200         node->san_b = false;
 201 }
 202
 203 /* Get the hsr_node from which 'skb' was sent.
 204  */
 205 struct hsr_node *hsr_get_node(struct hsr_port *port, struct list_head *node_db,
 206                               struct sk_buff *skb, bool is_sup,
 207                               enum hsr_port_type rx_port)
 208 {
 209         struct hsr_priv *hsr = port->hsr;
 210         struct hsr_node *node;
 211         struct ethhdr *ethhdr;
 212         struct prp_rct *rct;
 213         bool san = false;
 214         u16 seq_out;
 215
 216         if (!skb_mac_header_was_set(skb))
 217                 return NULL;
 218
 219         ethhdr = (struct ethhdr *)skb_mac_header(skb);
 220
 221         list_for_each_entry_rcu(node, node_db, mac_list) {
 222                 if (ether_addr_equal(node->macaddress_A, ethhdr->h_source)) {
 223                         if (hsr->proto_ops->update_san_info)
 224                                 hsr->proto_ops->update_san_info(node, is_sup);
 225                         return node;
 226                 }
 227                 if (ether_addr_equal(node->macaddress_B, ethhdr->h_source)) {
 228                         if (hsr->proto_ops->update_san_info)
 229                                 hsr->proto_ops->update_san_info(node, is_sup);
 230                         return node;
 231                 }
 232         }
 233
 234         /* Everyone may create a node entry, connected node to a HSR/PRP
 235          * device.
 236          */
 237         if (ethhdr->h_proto == htons(ETH_P_PRP) ||
 238             ethhdr->h_proto == htons(ETH_P_HSR)) {
 239                 /* Use the existing sequence_nr from the tag as starting point
 240                  * for filtering duplicate frames.
 241                  */
 242                 seq_out = hsr_get_skb_sequence_nr(skb) - 1;
 243         } else {
 244                 rct = skb_get_PRP_rct(skb);
 245                 if (rct && prp_check_lsdu_size(skb, rct, is_sup)) {
 246                         seq_out = prp_get_skb_sequence_nr(rct);
 247                 } else {
 248                         if (rx_port != HSR_PT_MASTER)
 249                                 san = true;
 250                         seq_out = HSR_SEQNR_START;
 251                 }
 252         }
 253
 254         return hsr_add_node(hsr, node_db, ethhdr->h_source, seq_out,
 255                             san, rx_port);
 256 }
 257
 258 /* Use the Supervision frame's info about an eventual macaddress_B for merging
 259  * nodes that has previously had their macaddress_B registered as a separate
 260  * node.
 261  */
 262 void hsr_handle_sup_frame(struct hsr_frame_info *frame)
 263 {
 264         struct hsr_node *node_curr = frame->node_src;
 265         struct hsr_port *port_rcv = frame->port_rcv;
 266         struct hsr_priv *hsr = port_rcv->hsr;
 267         struct hsr_sup_payload *hsr_sp;
 268         struct hsr_node *node_real;
 269         struct sk_buff *skb = NULL;
 270         struct list_head *node_db;
 271         struct ethhdr *ethhdr;
 272         int i;
 273
 274         /* Here either frame->skb_hsr or frame->skb_prp should be
 275          * valid as supervision frame always will have protocol
 276          * header info.
 277          */
 278         if (frame->skb_hsr)
 279                 skb = frame->skb_hsr;
 280         else if (frame->skb_prp)
 281                 skb = frame->skb_prp;
 282         else if (frame->skb_std)
 283                 skb = frame->skb_std;
 284         if (!skb)
 285                 return;
 286
 287         ethhdr = (struct ethhdr *)skb_mac_header(skb);
 288
 289         /* Leave the ethernet header. */
 290         skb_pull(skb, sizeof(struct ethhdr));
 291
 292         /* And leave the HSR tag. */
 293         if (ethhdr->h_proto == htons(ETH_P_HSR))
 294                 skb_pull(skb, sizeof(struct hsr_tag));
 295
 296         /* And leave the HSR sup tag. */
 297         skb_pull(skb, sizeof(struct hsr_sup_tag));
 298
 299         hsr_sp = (struct hsr_sup_payload *)skb->data;
 300
 301         /* Merge node_curr (registered on macaddress_B) into node_real */
 302         node_db = &port_rcv->hsr->node_db;
 303         node_real = find_node_by_addr_A(node_db, hsr_sp->macaddress_A);
 304         if (!node_real)
 305                 /* No frame received from AddrA of this node yet */
 306                 node_real = hsr_add_node(hsr, node_db, hsr_sp->macaddress_A,
 307                                          HSR_SEQNR_START - 1, true,
 308                                          port_rcv->type);
 309         if (!node_real)
 310                 goto done; /* No mem */
 311         if (node_real == node_curr)
 312                 /* Node has already been merged */
 313                 goto done;
 314
 315         ether_addr_copy(node_real->macaddress_B, ethhdr->h_source);
 316         for (i = 0; i < HSR_PT_PORTS; i++) {
 317                 if (!node_curr->time_in_stale[i] &&
 318                     time_after(node_curr->time_in[i], node_real->time_in[i])) {
 319                         node_real->time_in[i] = node_curr->time_in[i];
 320                         node_real->time_in_stale[i] =
 321                                                 node_curr->time_in_stale[i];
 322                 }
 323                 if (seq_nr_after(node_curr->seq_out[i], node_real->seq_out[i]))
 324                         node_real->seq_out[i] = node_curr->seq_out[i];
 325         }
 326         node_real->addr_B_port = port_rcv->type;
 327
 328         spin_lock_bh(&hsr->list_lock);
 329         list_del_rcu(&node_curr->mac_list);
 330         spin_unlock_bh(&hsr->list_lock);
 331         kfree_rcu(node_curr, rcu_head);
 332
 333 done:
 334         /* PRP uses v0 header */
 335         if (ethhdr->h_proto == htons(ETH_P_HSR))
 336                 skb_push(skb, sizeof(struct hsrv1_ethhdr_sp));
 337         else
 338                 skb_push(skb, sizeof(struct hsrv0_ethhdr_sp));
 339 }
 340
 341 /* 'skb' is a frame meant for this host, that is to be passed to upper layers.
 342  *
 343  * If the frame was sent by a node's B interface, replace the source
 344  * address with that node's "official" address (macaddress_A) so that upper
 345  * layers recognize where it came from.
 346  */
 347 void hsr_addr_subst_source(struct hsr_node *node, struct sk_buff *skb)
 348 {
 349         if (!skb_mac_header_was_set(skb)) {
 350                 WARN_ONCE(1, "%s: Mac header not set\n", __func__);
 351                 return;
 352         }
 353
 354         memcpy(&eth_hdr(skb)->h_source, node->macaddress_A, ETH_ALEN);
 355 }
 356
 357 /* 'skb' is a frame meant for another host.
 358  * 'port' is the outgoing interface
 359  *
 360  * Substitute the target (dest) MAC address if necessary, so the it matches the
 361  * recipient interface MAC address, regardless of whether that is the
 362  * recipient's A or B interface.
 363  * This is needed to keep the packets flowing through switches that learn on
 364  * which "side" the different interfaces are.
 365  */
 366 void hsr_addr_subst_dest(struct hsr_node *node_src, struct sk_buff *skb,
 367                          struct hsr_port *port)
 368 {
 369         struct hsr_node *node_dst;
 370
 371         if (!skb_mac_header_was_set(skb)) {
 372                 WARN_ONCE(1, "%s: Mac header not set\n", __func__);
 373                 return;
 374         }
 375
 376         if (!is_unicast_ether_addr(eth_hdr(skb)->h_dest))
 377                 return;
 378
 379         node_dst = find_node_by_addr_A(&port->hsr->node_db,
 380                                        eth_hdr(skb)->h_dest);
 381         if (!node_dst) {
 382                 if (net_ratelimit())
 383                         netdev_err(skb->dev, "%s: Unknown node\n", __func__);
 384                 return;
 385         }
 386         if (port->type != node_dst->addr_B_port)
 387                 return;
 388
 389         if (is_valid_ether_addr(node_dst->macaddress_B))
 390                 ether_addr_copy(eth_hdr(skb)->h_dest, node_dst->macaddress_B);
 391 }
 392
 393 void hsr_register_frame_in(struct hsr_node *node, struct hsr_port *port,
 394                            u16 sequence_nr)
 395 {
 396         /* Don't register incoming frames without a valid sequence number. This
 397          * ensures entries of restarted nodes gets pruned so that they can
 398          * re-register and resume communications.
 399          */
 400         if (seq_nr_before(sequence_nr, node->seq_out[port->type]))
 401                 return;
 402
 403         node->time_in[port->type] = jiffies;
 404         node->time_in_stale[port->type] = false;
 405 }
 406
 407 /* 'skb' is a HSR Ethernet frame (with a HSR tag inserted), with a valid
 408  * ethhdr->h_source address and skb->mac_header set.
 409  *
 410  * Return:
 411  *       1 if frame can be shown to have been sent recently on this interface,
 412  *       0 otherwise, or
 413  *       negative error code on error
 414  */
 415 int hsr_register_frame_out(struct hsr_port *port, struct hsr_node *node,
 416                            u16 sequence_nr)
 417 {
 418         if (seq_nr_before_or_eq(sequence_nr, node->seq_out[port->type]) &&
 419             time_is_after_jiffies(node->time_out[port->type] +
 420             msecs_to_jiffies(HSR_ENTRY_FORGET_TIME)))
 421                 return 1;
 422
 423         node->time_out[port->type] = jiffies;
 424         node->seq_out[port->type] = sequence_nr;
 425         return 0;
 426 }
 427
 428 static struct hsr_port *get_late_port(struct hsr_priv *hsr,
 429                                       struct hsr_node *node)
 430 {
 431         if (node->time_in_stale[HSR_PT_SLAVE_A])
 432                 return hsr_port_get_hsr(hsr, HSR_PT_SLAVE_A);
 433         if (node->time_in_stale[HSR_PT_SLAVE_B])
 434                 return hsr_port_get_hsr(hsr, HSR_PT_SLAVE_B);
 435
 436         if (time_after(node->time_in[HSR_PT_SLAVE_B],
 437                        node->time_in[HSR_PT_SLAVE_A] +
 438                                         msecs_to_jiffies(MAX_SLAVE_DIFF)))
 439                 return hsr_port_get_hsr(hsr, HSR_PT_SLAVE_A);
 440         if (time_after(node->time_in[HSR_PT_SLAVE_A],
 441                        node->time_in[HSR_PT_SLAVE_B] +
 442                                         msecs_to_jiffies(MAX_SLAVE_DIFF)))
 443                 return hsr_port_get_hsr(hsr, HSR_PT_SLAVE_B);
 444
 445         return NULL;
 446 }
 447
 448 /* Remove stale sequence_nr records. Called by timer every
 449  * HSR_LIFE_CHECK_INTERVAL (two seconds or so).
 450  */
 451 void hsr_prune_nodes(struct timer_list *t)
 452 {
 453         struct hsr_priv *hsr = from_timer(hsr, t, prune_timer);
 454         struct hsr_node *node;
 455         struct hsr_node *tmp;
 456         struct hsr_port *port;
 457         unsigned long timestamp;
 458         unsigned long time_a, time_b;
 459
 460         spin_lock_bh(&hsr->list_lock);
 461         list_for_each_entry_safe(node, tmp, &hsr->node_db, mac_list) {
 462                 /* Don't prune own node. Neither time_in[HSR_PT_SLAVE_A]
 463                  * nor time_in[HSR_PT_SLAVE_B], will ever be updated for
 464                  * the master port. Thus the master node will be repeatedly
 465                  * pruned leading to packet loss.
 466                  */
 467                 if (hsr_addr_is_self(hsr, node->macaddress_A))
 468                         continue;
 469
 470                 /* Shorthand */
 471                 time_a = node->time_in[HSR_PT_SLAVE_A];
 472                 time_b = node->time_in[HSR_PT_SLAVE_B];
 473
 474                 /* Check for timestamps old enough to risk wrap-around */
 475                 if (time_after(jiffies, time_a + MAX_JIFFY_OFFSET / 2))
 476                         node->time_in_stale[HSR_PT_SLAVE_A] = true;
 477                 if (time_after(jiffies, time_b + MAX_JIFFY_OFFSET / 2))
 478                         node->time_in_stale[HSR_PT_SLAVE_B] = true;
 479
 480                 /* Get age of newest frame from node.
 481                  * At least one time_in is OK here; nodes get pruned long
 482                  * before both time_ins can get stale
 483                  */
 484                 timestamp = time_a;
 485                 if (node->time_in_stale[HSR_PT_SLAVE_A] ||
 486                     (!node->time_in_stale[HSR_PT_SLAVE_B] &&
 487                     time_after(time_b, time_a)))
 488                         timestamp = time_b;
 489
 490                 /* Warn of ring error only as long as we get frames at all */
 491                 if (time_is_after_jiffies(timestamp +
 492                                 msecs_to_jiffies(1.5 * MAX_SLAVE_DIFF))) {
 493                         rcu_read_lock();
 494                         port = get_late_port(hsr, node);
 495                         if (port)
 496                                 hsr_nl_ringerror(hsr, node->macaddress_A, port);
 497                         rcu_read_unlock();
 498                 }
 499
 500                 /* Prune old entries */
 501                 if (time_is_before_jiffies(timestamp +
 502                                 msecs_to_jiffies(HSR_NODE_FORGET_TIME))) {
 503                         hsr_nl_nodedown(hsr, node->macaddress_A);
 504                         list_del_rcu(&node->mac_list);
 505                         /* Note that we need to free this entry later: */
 506                         kfree_rcu(node, rcu_head);
 507                 }
 508         }
 509         spin_unlock_bh(&hsr->list_lock);
 510
 511         /* Restart timer */
 512         mod_timer(&hsr->prune_timer,
 513                   jiffies + msecs_to_jiffies(PRUNE_PERIOD));
 514 }
 515
 516 void *hsr_get_next_node(struct hsr_priv *hsr, void *_pos,
 517                         unsigned char addr[ETH_ALEN])
 518 {
 519         struct hsr_node *node;
 520
 521         if (!_pos) {
 522                 node = list_first_or_null_rcu(&hsr->node_db,
 523                                               struct hsr_node, mac_list);
 524                 if (node)
 525                         ether_addr_copy(addr, node->macaddress_A);
 526                 return node;
 527         }
 528
 529         node = _pos;
 530         list_for_each_entry_continue_rcu(node, &hsr->node_db, mac_list) {
 531                 ether_addr_copy(addr, node->macaddress_A);
 532                 return node;
 533         }
 534
 535         return NULL;
 536 }
 537
 538 int hsr_get_node_data(struct hsr_priv *hsr,
 539                       const unsigned char *addr,
 540                       unsigned char addr_b[ETH_ALEN],
 541                       unsigned int *addr_b_ifindex,
 542                       int *if1_age,
 543                       u16 *if1_seq,
 544                       int *if2_age,
 545                       u16 *if2_seq)
 546 {
 547         struct hsr_node *node;
 548         struct hsr_port *port;
 549         unsigned long tdiff;
 550
 551         node = find_node_by_addr_A(&hsr->node_db, addr);
 552         if (!node)
 553                 return -ENOENT;
 554
 555         ether_addr_copy(addr_b, node->macaddress_B);
 556
 557         tdiff = jiffies - node->time_in[HSR_PT_SLAVE_A];
 558         if (node->time_in_stale[HSR_PT_SLAVE_A])
 559                 *if1_age = INT_MAX;
 560 #if HZ <= MSEC_PER_SEC
 561         else if (tdiff > msecs_to_jiffies(INT_MAX))
 562                 *if1_age = INT_MAX;
 563 #endif
 564         else
 565                 *if1_age = jiffies_to_msecs(tdiff);
 566
 567         tdiff = jiffies - node->time_in[HSR_PT_SLAVE_B];
 568         if (node->time_in_stale[HSR_PT_SLAVE_B])
 569                 *if2_age = INT_MAX;
 570 #if HZ <= MSEC_PER_SEC
 571         else if (tdiff > msecs_to_jiffies(INT_MAX))
 572                 *if2_age = INT_MAX;
 573 #endif
 574         else
 575                 *if2_age = jiffies_to_msecs(tdiff);
 576
 577         /* Present sequence numbers as if they were incoming on interface */
 578         *if1_seq = node->seq_out[HSR_PT_SLAVE_B];
 579         *if2_seq = node->seq_out[HSR_PT_SLAVE_A];
 580
 581         if (node->addr_B_port != HSR_PT_NONE) {
 582                 port = hsr_port_get_hsr(hsr, node->addr_B_port);
 583                 *addr_b_ifindex = port->dev->ifindex;
 584         } else {
 585                 *addr_b_ifindex = -1;
 586         }
 587
 588         return 0;
 589 }