Skip to content

redhat-cne/l2discovery

 
 

Repository files navigation

Host based L2 discovery

The rapid discovery of L2 hosts is realized by probing the network with test Ethernet frames

discovery_workflow

Each openshift node reports L2 connectivity with a JSON log as shown below. The Json represent a map ordered by ethertype -> local interface -> remote mac address. So for each local interface it lists the MAC addresses that are received per ethertype. We are using the "experimental" ethertype to generate the probe packets (0x88b5):

{
  "88b5": {
    "eno5np0": {
      "Local": {
        "IfName": "eno5np0",
        "IfMac": {
          "Data": "F4:03:43:D1:65:D0"
        },
        "IfIndex": 2,
        "IfPci": {
          "Device": "0000:5d:00",
          "Function": "0"
        }
      },
      "Remote": {
        "F4:03:43:D1:40:F0": true,
        "F4:03:43:D1:70:A0": true
      }
    },
    "eno6np1": {
      "Local": {
        "IfName": "eno6np1",
        "IfMac": {
          "Data": "F4:03:43:D1:65:D8"
        },
        "IfIndex": 3,
        "IfPci": {
          "Device": "0000:5d:00",
          "Function": "1"
        }
      },
      "Remote": {
        "48:DF:37:BC:F1:65": true,
        "48:DF:37:BC:F4:41": true,
        "F4:03:43:D1:40:F8": true,
        "F4:03:43:D1:70:A8": true
      }
    },
    "ens3f0": {
      "Local": {
        "IfName": "ens3f0",
        "IfMac": {
          "Data": "48:DF:37:BC:F0:E0"
        },
        "IfIndex": 8,
        "IfPci": {
          "Device": "0000:d8:00",
          "Function": "0"
        }
      },
      "Remote": {
        "48:DF:37:BC:F1:64": true,
        "48:DF:37:BC:F4:40": true
      }
    },
    "ens3f1": {
      "Local": {
        "IfName": "ens3f1",
        "IfMac": {
          "Data": "48:DF:37:BC:F0:E1"
        },
        "IfIndex": 9,
        "IfPci": {
          "Device": "0000:d8:00",
          "Function": "1"
        }
      },
      "Remote": {
        "48:DF:37:BC:F1:65": true,
        "48:DF:37:BC:F4:41": true,
        "F4:03:43:D1:40:F8": true,
        "F4:03:43:D1:70:A8": true
      }
    }
  },
  "88f7": {
    "ens3f0": {
      "Local": {
        "IfName": "ens3f0",
        "IfMac": {
          "Data": "48:DF:37:BC:F0:E0"
        },
        "IfIndex": 8,
        "IfPci": {
          "Device": "0000:d8:00",
          "Function": "0"
        }
      },
      "Remote": {
        "48:DF:37:BC:F4:40": true
      }
    }
  }
}

Frames with the ptp Ethertype are also collected, but not transmitted. This helps identify which port are already receiving PTP protocol frames.

discovery_workflow

About

A simple Host based L2 Discovery protocol

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Go 91.4%
  • Dockerfile 3.2%
  • Makefile 2.8%
  • Shell 2.6%