Subversion Repositories uuid_mac_utils

Rev

Rev 17 | Rev 19 | Go to most recent revision | Blame | Compare with Previous | Last modification | View Log | RSS feed

  1. <?php
  2.  
  3. /*
  4.  * MAC (EUI-48 and EUI-64) utils for PHP
  5.  * Copyright 2017 - 2023 Daniel Marschall, ViaThinkSoft
  6.  * Version 2023-05-01
  7.  *
  8.  * Licensed under the Apache License, Version 2.0 (the "License");
  9.  * you may not use this file except in compliance with the License.
  10.  * You may obtain a copy of the License at
  11.  *
  12.  *     http://www.apache.org/licenses/LICENSE-2.0
  13.  *
  14.  * Unless required by applicable law or agreed to in writing, software
  15.  * distributed under the License is distributed on an "AS IS" BASIS,
  16.  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  17.  * See the License for the specific language governing permissions and
  18.  * limitations under the License.
  19.  */
  20.  
  21. // Very good resources for information about OUI, EUI, MAC, ...
  22. // - https://mac-address.alldatafeeds.com/faq#how-to-recognise-mac-address-application
  23. // - https://standards.ieee.org/wp-content/uploads/import/documents/tutorials/eui.pdf
  24. // - https://en.m.wikipedia.org/wiki/Organizationally_unique_identifier
  25.  
  26. const IEEE_MAC_REGISTRY = __DIR__ . '/../web-data';
  27.  
  28. /**
  29.  * Checks if a MAC, EUI, ELI, or IPv6-LinkLocal address is valid
  30.  * @param string $mac MAC, EUI, or IPv6-LinkLocal Address
  31.  * @return bool True if it is valid
  32.  */
  33. function mac_valid(string $mac): bool {
  34.         $tmp = ipv6linklocal_to_mac48($mac);
  35.         if ($tmp !== false) $mac = $tmp;
  36.  
  37.         $mac = str_replace(array('-', ':'), '', $mac);
  38.         $mac = strtoupper($mac);
  39.  
  40.         if ((strlen($mac) != 12) && (strlen($mac) != 16)) return false;
  41.  
  42.         $mac = preg_replace('@[0-9A-F]@', '', $mac);
  43.  
  44.         return ($mac === '');
  45. }
  46.  
  47. /**
  48.  * Returns the amount of bits of a MAC, EUI, or ELI
  49.  * @param string $mac
  50.  * @return false|int
  51.  */
  52. function eui_bits(string $mac) {
  53.         if (!mac_valid($mac)) return false;
  54.         $mac = mac_canonize($mac, '');
  55.         return (int)(strlen($mac)*4);
  56. }
  57.  
  58. /**
  59.  * Canonizes a MAC, EUI, ELI, or IPv6-LinkLocal address
  60.  * @param string $mac MAC, EUI, ELI, or IPv6-LinkLocal Address
  61.  * @param string $delimiter Desired delimiter for inserting between each octet
  62.  * @return string|false The canonized address (Note: IPv6-Linklocal becomes EUI-64)
  63.  */
  64. function mac_canonize(string $mac, string $delimiter="-") {
  65.         if (!mac_valid($mac)) return false;
  66.  
  67.         $tmp = ipv6linklocal_to_mac48($mac);
  68.         if ($tmp !== false) $mac = $tmp;
  69.  
  70.         $mac = strtoupper($mac);
  71.         $mac = preg_replace('@[^0-9A-F]@', '', $mac);
  72.         if ((strlen($mac) != 12) && (strlen($mac) != 16)) return false;
  73.         $mac = preg_replace('@^(..)(..)(..)(..)(..)(..)(..)(..)$@', '\\1'.$delimiter.'\\2'.$delimiter.'\\3'.$delimiter.'\\4'.$delimiter.'\\5'.$delimiter.'\\6'.$delimiter.'\\7'.$delimiter.'\\8', $mac);
  74.         return preg_replace('@^(..)(..)(..)(..)(..)(..)$@', '\\1'.$delimiter.'\\2'.$delimiter.'\\3'.$delimiter.'\\4'.$delimiter.'\\5'.$delimiter.'\\6', $mac);
  75. }
  76.  
  77. /**
  78.  * @param string $file
  79.  * @param string $oui_name
  80.  * @param string $mac
  81.  * @return false|string
  82.  */
  83. function _lookup_ieee_registry(string $file, string $oui_name, string $mac) {
  84.         $mac = mac_canonize($mac, '');
  85.         if ($mac === false) return false;
  86.         $begin = substr($mac, 0, 2).'-'.substr($mac, 2, 2).'-'.substr($mac, 4, 2);
  87.         $f = file_get_contents($file);
  88.  
  89.         $f = str_replace("\r", '', $f);
  90.  
  91.         # We are using a positive-lookahead because entries like the MA-M references have a blank line between organization and address
  92.         preg_match_all('@^\s*'.preg_quote($begin, '@').'\s+\(hex\)\s+(\S+)\s+(.*)\n\n\s*(?=[0-9A-F])@ismU', "$f\n\nA", $m, PREG_SET_ORDER);
  93.         foreach ($m as $n) {
  94.                 preg_match('@(\S+)\s+\(base 16\)(.*)$@ism', $n[2], $m);
  95.  
  96.                 if (preg_match('@(.+)-(.+)@ism', $m[1], $o)) {
  97.                         $z = hexdec(substr($mac, 6, 6));
  98.                         $beg = hexdec($o[1]);
  99.                         $end = hexdec($o[2]);
  100.                         if (($z < $beg) || ($z > $end)) continue;
  101.                 } else {
  102.                         $beg = 0x000000;
  103.                         $end = 0xFFFFFF;
  104.                 }
  105.  
  106.                 $x = trim(preg_replace('@^\s+@im', '', $m[2]));
  107.  
  108.                 # "PRIVATE" entries are only marked at the "(hex)" line, but not at the "(base16)" line
  109.                 if ($x == '') $x = trim($n[1]);
  110.  
  111.                 $x = explode("\n", $x);
  112.  
  113.                 $ra_len = strlen(dechex($end-$beg));
  114.  
  115.                 $out = sprintf("%-32s 0x%s\n", "IEEE $oui_name part:", substr($mac, 0, 12-$ra_len));
  116.                 $out .= sprintf("%-32s 0x%s\n", "NIC specific part:", substr($mac, 12-$ra_len));
  117.                 $out .= sprintf("%-32s %s\n", "Registrant:", $x[0]);
  118.                 foreach ($x as $n => $y) {
  119.                         if ($n == 0) continue;
  120.                         else if ($n == 1) $out .= sprintf("%-32s %s\n", "Address of registrant:", $y);
  121.                         else if ($n >= 2) $out .= sprintf("%-32s %s\n", "", $y);
  122.                 }
  123.  
  124.                 // TODO: also print the date of last update of the OUI files
  125.  
  126.                 return $out;
  127.         }
  128.  
  129.         return false;
  130. }
  131.  
  132. /**
  133.  * Try to Decapsulate EUI-64 into MAC-48 or EUI-48
  134.  * @param string $eui64
  135.  * @return false|string If EUI-64 can be converted into EUI-48, returns EUI-48, otherwise returns EUI-64. On invalid input, return false.
  136.  */
  137. function eui64_to_eui48(string $eui64) {
  138.         if (!mac_valid($eui64)) return false;
  139.         $eui64 = mac_canonize($eui64, '');
  140.         if (eui_bits($eui64) == 48) return mac_canonize($eui64);
  141.         if ($eui64[1] == 'A') return false; // do not allow ELI-64
  142.  
  143.         if (substr($eui64, 6, 4) == 'FFFF') {
  144.                 // EUI-64 to MAC-48
  145.                 return mac_canonize(substr($eui64, 0, 6).substr($eui64, 10, 6));
  146.         } else if (substr($eui64, 6, 4) == 'FFFE') {
  147.                 if ((hexdec($eui64[1])&2) == 2) {
  148.                         // Modified EUI-64 to MAC/EUI-48
  149.                         $eui64[1] = dechex(hexdec($eui64[1])&253); // remove bit
  150.                         return mac_canonize(substr($eui64, 0, 6).substr($eui64, 10, 6));
  151.                 } else {
  152.                         // EUI-64 to EUI-48
  153.                         return mac_canonize(substr($eui64, 0, 6).substr($eui64, 10, 6));
  154.                 }
  155.         } else {
  156.                 return mac_canonize($eui64);
  157.         }
  158. }
  159.  
  160. /**
  161.  * MAC-48 to EUI-64 Encapsulation
  162.  * @param string $mac48 MAC-48 address
  163.  * @return false|string EUI-64 address
  164.  */
  165. function mac48_to_eui64(string $mac48) {
  166.         // Note: MAC-48 is used for network hardware; EUI-48 is used to identify other devices and software.
  167.         //       MAC48-to-EUI64 Encapsulation uses 0xFFFF middle part
  168.         if (!mac_valid($mac48)) return false;
  169.         $mac48 = mac_canonize($mac48, '');
  170.         if (eui_bits($mac48) == 64) return mac_canonize($mac48);
  171.         if ($mac48[1] == 'A') return false; // do not allow ELI-48
  172.  
  173.         $eui64 = substr($mac48, 0, 6).'FFFF'.substr($mac48, 6, 6);
  174.         return mac_canonize($eui64);
  175. }
  176.  
  177. /**
  178.  * EUI-48 to EUI-64 Encapsulation
  179.  * @param string $eui48 EUI-48 address
  180.  * @return false|string EUI-64 address
  181.  */
  182. function eui48_to_eui64(string $eui48) {
  183.         // Note: MAC-48 is used for network hardware; EUI-48 is used to identify other devices and software.
  184.         //       EUI48-to-EUI64 Encapsulation uses 0xFFFF middle part
  185.         if (!mac_valid($eui48)) return false;
  186.         $eui48 = mac_canonize($eui48, '');
  187.         if (eui_bits($eui48) == 64) return mac_canonize($eui48);
  188.         if ($eui48[1] == 'A') return false; // do not allow ELI-48
  189.  
  190.         $eui64 = substr($eui48, 0, 6).'FFFE'.substr($eui48, 6, 6);
  191.         return mac_canonize($eui64);
  192. }
  193.  
  194. /**
  195.  * MAC/EUI-48 to Modified EUI-64 Encapsulation
  196.  * @param string $eui48 MAC-48 or EUI-48 address
  197.  * @return false|string Modified EUI-64 address
  198.  */
  199. function maceui48_to_modeui64(string $eui48) {
  200.         // Note: MAC-48 is used for network hardware; EUI-48 is used to identify other devices and software.
  201.         //       EUI48-to-ModifiedEUI64 Encapsulation uses 0xFFFE middle part (SIC! This was a mistake by IETF, since it should actually be 0xFFFF!)
  202.         if (!mac_valid($eui48)) return false;
  203.         $eui48 = mac_canonize($eui48, '');
  204.         if (eui_bits($eui48) == 64) return mac_canonize($eui48);
  205.         if ($eui48[1] == 'A') return false; // do not allow ELI-48
  206.  
  207.         $eui64 = substr($eui48, 0, 6).'FFFE'.substr($eui48, 6, 6);
  208.  
  209.         $eui64[1] = dechex(hexdec($eui64[1]) | 2); // flip seventh bit
  210.  
  211.         return mac_canonize($eui64);
  212. }
  213.  
  214. /**
  215.  * Try to convert IPv6-LinkLocal address to MAC-48
  216.  * @param string $ipv6 IPv6-LinkLocal address
  217.  * @return false|string MAC-48 (or IPv6 if it was no LinkLocal address, or Modified EUI-64 if it decapsulation failed)
  218.  */
  219. function ipv6linklocal_to_mac48(string $ipv6) {
  220.         // https://stackoverflow.com/questions/12095835/quick-way-of-expanding-ipv6-addresses-with-php (modified)
  221.         $tmp = inet_pton($ipv6);
  222.         if ($tmp === false) return false;
  223.         $hex = unpack("H*hex", $tmp);
  224.         $ipv6 = substr(preg_replace("/([A-f0-9]{4})/", "$1:", $hex['hex']), 0, -1);
  225.  
  226.         // Remove "fe80::" to convert IPv6 Link Local address back to EUI-64
  227.         // see https://support.lenovo.com/de/de/solutions/ht509925-how-to-convert-a-mac-address-into-an-ipv6-link-local-address-eui-64
  228.         $cnt = 0;
  229.         $mac = preg_replace('@^fe80:0000:0000:0000:@i', '', $ipv6, -1, $cnt);
  230.         if ($cnt == 0) return false;
  231.  
  232.         // Set LAA to UAA again
  233.         $mac_uaa_64 = $mac;
  234.         $mac_uaa_64[1] = dechex(hexdec($mac_uaa_64[1]) & 253);
  235.  
  236.         $mac_uaa_48 = eui64_to_eui48($mac_uaa_64);
  237.         if (eui_bits($mac_uaa_48) == 48) {
  238.                 return $mac_uaa_48; // Output MAC-48 (UAA)
  239.         } else {
  240.                 return $mac; // Failed decapsulation; output Modified EUI-64 instead
  241.         }
  242. }
  243.  
  244. /**
  245.  * Converts MAC-48 or EUI-48 to IPv6-LinkLocal (based on Modified EUI-64)
  246.  * @param string $mac
  247.  * @return false|string
  248.  */
  249. function maceui_to_ipv6linklocal(string $mac) {
  250.         if (!mac_valid($mac)) return false;
  251.         if (eui_bits($mac) == 48) {
  252.                 $mac = maceui48_to_modeui64($mac);
  253.         }
  254.         $mac = mac_canonize($mac, '');
  255.         $mac = str_pad($mac, 16, '0', STR_PAD_LEFT);
  256.         return strtolower('fe80::'.substr($mac,0, 4).':'.substr($mac,4, 4).':'.substr($mac,8, 4).':'.substr($mac,12, 4));
  257. }
  258.  
  259. /**
  260.  * Prints information about an IPv6-LinkLocal address, MAC, EUI, or ELI.
  261.  * @param string $mac IPv6-LinkLocal address, MAC, EUI, or ELI
  262.  * @return void
  263.  * @throws Exception
  264.  */
  265. function decode_mac(string $mac) {
  266.         echo sprintf("%-32s %s\n", "Input:", $mac);
  267.  
  268.         // Format MAC for machine readability
  269.         $mac = mac_canonize($mac, '');
  270.  
  271.         $type = '';
  272.         if ($mac[1] == 'A') {
  273.                 // An ELI is based on a CID-24
  274.                 // A CID has ZYXM bits set to 1010 (0b1010 = 0xA)
  275.                 // Since X=1 (U/L=1), the CID cannot be used to form a universal UAA MAC (only a local LAA MAC)
  276.                 $type = 'ELI-'.eui_bits($mac);;
  277.         } else {
  278.                 $tmp = ipv6linklocal_to_mac48($mac);
  279.                 if ($tmp !== false) {
  280.                         $mac = $tmp;
  281.                         $type = 'IPv6-Link-Local';
  282.                 }
  283.                 if (!mac_valid($mac)) throw new Exception("Invalid MAC address");
  284.                 if ($tmp === false) {
  285.                         if (eui_bits($mac) == 48) {
  286.                                 $type = 'MAC-48 (network hardware) or EUI-48 (other devices and software)';
  287.                         } else if (eui_bits($mac) == 64) {
  288.                                 if (substr($mac,6,4) == 'FFFE') {
  289.                                         if ((hexdec($mac[1])&2) == 2) {
  290.                                                 $type = 'EUI-64 (MAC/EUI-48 to Modified EUI-64 Encapsulation)';
  291.                                         } else {
  292.                                                 $type = 'EUI-64 (EUI-48 to EUI-64 Encapsulation)';
  293.                                         }
  294.                                 } else if (substr($mac,6,4) == 'FFFF') {
  295.                                         $type = 'EUI-64 (MAC-48 to EUI-64 Encapsulation)';
  296.                                 } else {
  297.                                         $type = 'EUI-64 (Regular)';
  298.                                 }
  299.                         } else {
  300.                                 assert(false); /** @phpstan-ignore-line */
  301.                         }
  302.                 }
  303.         }
  304.         echo sprintf("%-32s %s\n", "Type:", $type);
  305.  
  306.         echo "\n";
  307.  
  308.         // Show various representations
  309.         if ($mac[1] == 'A') {
  310.                 // Note: There does not seem to exist an algorithm for converting ELI-48 <=> ELI-64
  311.                 echo sprintf("%-32s %s\n", "ELI-".eui_bits($mac).":", mac_canonize($mac));
  312.         } else {
  313.                 $eui48 = eui64_to_eui48($mac);
  314.                 echo sprintf("%-32s %s\n", "EUI-48:", (eui_bits($eui48) != 48) ? 'Not available' : $eui48);
  315.                 if (eui_bits($mac) == 48) {
  316.                         $eui64 = mac48_to_eui64($mac);
  317.                         echo sprintf("%-32s %s\n", "EUI-64:", ((eui_bits($eui64) != 64) ? 'Not available' : $eui64).' (MAC-48 to EUI-64 Encapsulation)');
  318.                         $eui64 = eui48_to_eui64($mac);
  319.                         echo sprintf("%-32s %s\n", "", ((eui_bits($eui64) != 64) ? 'Not available' : $eui64).' (EUI-48 to EUI-64 Encapsulation)');
  320.                         $eui64 = maceui48_to_modeui64($mac);
  321.                         echo sprintf("%-32s %s\n", "", ((eui_bits($eui64) != 64) ? 'Not available' : $eui64).' (MAC/EUI-48 to Modified EUI-64 Encapsulation)');
  322.                         $ipv6 = maceui_to_ipv6linklocal($mac);
  323.                         echo sprintf("%-32s %s\n", "IPv6 link local address:", $ipv6);
  324.                 } else {
  325.                         $eui64 = mac_canonize($mac);
  326.                         echo sprintf("%-32s %s\n", "EUI-64:", $eui64);
  327.                 }
  328.         }
  329.  
  330.         // Vergabestelle
  331.         $ul = hexdec($mac[1]) & 2; // Bit #LSB+1 of Byte 1
  332.         $ul_ = ($ul == 0) ? '[0] Universally Administered Address (UAA)' : '[1] Locally Administered Address (LAA)';
  333.         echo sprintf("%-32s %s\n", "Administration type (U/L flag):", $ul_);
  334.  
  335.         // Empfaengergruppe
  336.         $ig = hexdec($mac[1]) & 1; // Bit #LSB+0 of Byte 1
  337.         $ig_ = ($ig == 0) ? '[0] Unicast (Individual)' : '[1] Multicast (Group)';
  338.         echo sprintf("%-32s %s\n", "Transmission type (I/G flag):", $ig_);
  339.  
  340.         // Query IEEE registries
  341.         if (count(glob(IEEE_MAC_REGISTRY.DIRECTORY_SEPARATOR.'*.txt')) > 0) {
  342.                 if ($mac[1] == 'A') {
  343.                         // Query the CID registry
  344.                         if (
  345.                                 ($x = _lookup_ieee_registry(IEEE_MAC_REGISTRY . DIRECTORY_SEPARATOR . 'cid.txt', 'CID', $mac))
  346.                         ) {
  347.                                 echo $x;
  348.                         }
  349.                 } else {
  350.                         // Query the OUI registries
  351.                         // TODO: Should we try to convert Unicast<=>Multicast if one of them can't be found?
  352.                         if (
  353.                                 # The IEEE Registration Authority distinguishes between IABs and OUI-36 values. Both are 36-bit values which may be used to generate EUI-48 values, but IABs may not be used to generate EUI-64 values.[6]
  354.                                 # Note: The Individual Address Block (IAB) is an inactive registry activity, which has been replaced by the MA-S registry product as of January 1, 2014.
  355.                                 ($x = _lookup_ieee_registry(IEEE_MAC_REGISTRY . DIRECTORY_SEPARATOR . 'iab.txt', 'IAB', $mac)) ||
  356.                                 ($x = _lookup_ieee_registry(IEEE_MAC_REGISTRY . DIRECTORY_SEPARATOR . 'oui36.txt', 'OUI-36 (MA-S)', $mac)) ||
  357.                                 ($x = _lookup_ieee_registry(IEEE_MAC_REGISTRY . DIRECTORY_SEPARATOR . 'mam.txt', 'OUI-28 (MA-M)', $mac)) ||
  358.                                 ($x = _lookup_ieee_registry(IEEE_MAC_REGISTRY . DIRECTORY_SEPARATOR . 'oui.txt', 'OUI-24 (MA-L)', $mac))
  359.                         ) {
  360.                                 echo $x;
  361.                         }
  362.                 }
  363.         }
  364.  
  365.         $vm = '';
  366.         // === FAQ "Detection rules which don't have their dedicated page yet" ===
  367.         // https://wiki.xenproject.org/wiki/Xen_Networking
  368.         // https://mcpmag.com/articles/2007/11/27/hey-vm-whats-your-hypervisor.aspx
  369.         // https://www.techrepublic.com/blog/data-center/mac-address-scorecard-for-common-virtual-machine-platforms
  370.         if (mac_between($mac, '00:16:3E:00:00:00', '00:16:3E:FF:FF:FF')) $vm = "Red Hat Xen, XenSource, Novell Xen";
  371.         // http://techgenix.com/mac-address-pool-duplication-hyper-v/
  372.         // https://docs.microsoft.com/en-us/system-center/vmm/network-mac?view=sc-vmm-1807
  373.         // https://blogs.technet.microsoft.com/gbanin/2014/08/27/how-to-solve-mac-address-conflict-on-hyper-v/
  374.         if (mac_between($mac, '00:1D:D8:B7:1C:00', '00:1D:D8:F4:1F:FF')) $vm = "Microsoft SCVMM (System Center Virtual Machine Manager)";
  375.         // https://mcpmag.com/articles/2007/11/27/hey-vm-whats-your-hypervisor.aspx
  376.         // https://www.techrepublic.com/blog/data-center/mac-address-scorecard-for-common-virtual-machine-platforms/
  377.         // https://blogs.technet.microsoft.com/medv/2011/01/24/how-to-manage-vm-mac-addresses-with-the-globalimagedata-xml-file-in-med-v-v1/
  378.         if (mac_between($mac, '00:03:FF:00:00:00', '00:03:FF:FF:FF:FF')) $vm = "Microsoft Virtual PC / Virtual Server";
  379.         // https://mcpmag.com/articles/2007/11/27/hey-vm-whats-your-hypervisor.aspx
  380.         if (mac_between($mac, '00:18:51:00:00:00', '00:18:51:FF:FF:FF')) $vm = "SWsoft";
  381.         // https://macaddress.io/statistics/company/17619
  382.         if (mac_between($mac, '58:9C:FC:00:00:00', '58:9C:FC:FF:FF:FF')) $vm = "bhyve by FreebsdF";
  383.         // https://macaddress.io/statistics/company/17388
  384.         if (mac_between($mac, '50:6B:8D:00:00:00', '50:6B:8D:FF:FF:FF')) $vm = "Nutanix AHV";
  385.         // https://www.centos.org/forums/viewtopic.php?t=26739
  386.         if (mac_between($mac, '54:52:00:00:00:00', '54:52:FF:FF:FF:FF')) $vm = "KVM (proxmox)";
  387.         // Self tested (alldatafeeds.com)
  388.         if (mac_between($mac, '96:00:00:00:00:00', '96:00:FF:FF:FF:FF')) $vm = "Hetzner vServer (based on KVM and libvirt)";
  389.         // === FAQ "How to recognise a VMware's virtual machine by its MAC address?" ===
  390.         if (mac_between($mac, '00:50:56:00:00:00', '00:50:56:FF:FF:FF')) $vm = "VMware vSphere, VMware Workstation, VMware ESX Server";
  391.         if (mac_between($mac, '00:50:56:80:00:00', '00:50:56:BF:FF:FF')) $vm = "VMware vSphere managed by vCenter Server";
  392.         if (mac_between($mac, '00:0C:29:00:00:00', '00:0C:29:FF:FF:FF')) $vm = "VMWare Standalone VMware vSphere, VMware Workstation, VMware Horizon";
  393.         if (mac_between($mac, '00:05:69:00:00:00', '00:05:69:FF:FF:FF')) $vm = "VMware ESX, VMware GSX Server";
  394.         if (mac_between($mac, '00:1C:14:00:00:00', '00:1C:14:FF:FF:FF')) $vm = "VMWare";
  395.         // === FAQ "machine by its MAC address?" ===
  396.         if (mac_between($mac, '00:1C:42:00:00:00', '00:1C:42:FF:FF:FF')) $vm = "Parallels Virtual Machine";
  397.         // === FAQ "How to recognise a Docker container by its MAC address?" ===
  398.         if (mac_between($mac, '02:42:00:00:00:00', '02:42:FF:FF:FF:FF')) $vm = "Docker container";
  399.         // === FAQ =How to recognise a Microsoft Hyper-V's virtual machine by its MAC address?" ===
  400.         if (mac_between($mac, '00:15:5D:00:00:00', '00:15:5D:FF:FF:FF')) $vm = "Microsoft Hyper-V";
  401.         // === FAQ "How to recognise an Oracle Virtual machine by its MAC address?" ===
  402.         if (mac_between($mac, '08:00:27:00:00:00', '08:00:27:FF:FF:FF')) $vm = "Oracle VirtualBox 5.2"; // Pcs Systemtechnik GmbH
  403.         if (mac_between($mac, '52:54:00:00:00:00', '52:54:00:FF:FF:FF')) $vm = "Oracle VirtualBox 5.2 + Vagrant"; // 52:54:00 (Exact MAC: 52:54:00:C9:C7:04)
  404.         if (mac_between($mac, '00:21:F6:00:00:00', '00:21:F6:FF:FF:FF')) $vm = "Oracle VirtualBox 3.3";
  405.         if (mac_between($mac, '00:14:4F:00:00:00', '00:14:4F:FF:FF:FF')) $vm = "Oracle VM Server for SPARC";
  406.         if (mac_between($mac, '00:0F:4B:00:00:00', '00:0F:4B:FF:FF:FF')) $vm = "Oracle Virtual Iron 4";
  407.  
  408.         if ($vm) {
  409.                 echo sprintf("%-32s %s\n", "Special use:", "Virtual machine $vm");
  410.         }
  411.  
  412.         $app = '';
  413.  
  414.         // === FAQ "Other MAC address applications"
  415.         // http://www.cavebear.com/archive/cavebear/Ethernet/Ethernet.txt
  416.         // https://tools.ietf.org/html/rfc1060
  417.         if (mac_between($mac, '03:00:00:01:00:00', '03:00:40:00:00:00')) $app = 'User-defined (per 802 spec), EtherType is 0x0802';
  418.         if (mac_equals($mac, '01:00:1D:00:00:00')) $app = 'Cabletron PC-OV PC discover (on demand), EtherType is 0x0802';
  419.         if (mac_equals($mac, '01:00:1D:42:00:00')) $app = 'Cabletron PC-OV Bridge discover (on demand), EtherType is 0x0802';
  420.         if (mac_equals($mac, '01:00:1D:52:00:00')) $app = 'Cabletron PC-OV MMAC discover (on demand), EtherType is 0x0802';
  421.         if (mac_between($mac, '01:00:3C:00:00:00' , '01:00:3C:FF:FF:FF')) $app = 'Auspex Systems (Serverguard)';
  422.         if (mac_equals($mac, '01:00:10:00:00:20')) $app = 'Hughes Lan Systems Terminal Server S/W download, EtherType is 0x0802';
  423.         if (mac_equals($mac, '01:00:10:FF:FF:20')) $app = 'Hughes Lan Systems Terminal Server S/W request, EtherType is 0x0802';
  424.         if (mac_equals($mac, '01:00:81:00:00:00')) $app = 'Synoptics Network Management';
  425.         if (mac_equals($mac, '01:00:81:00:00:02')) $app = 'Synoptics Network Management';
  426.         if (mac_equals($mac, '01:00:81:00:01:00')) $app = 'Bay Networks (Synoptics) autodiscovery, EtherType is 0x0802 SNAP type is 0x01A2';
  427.         if (mac_equals($mac, '01:00:81:00:01:01')) $app = 'Bay Networks (Synoptics) autodiscovery, EtherType is 0x0802 SNAP type is 0x01A1';
  428.         if (mac_between($mac, '01:20:25:00:00:00', '01:20:25:7F:FF:FF')) $app = 'Control Technology Inc\'s Industrial Ctrl Proto., EtherType is 0x873A';
  429.         if (mac_equals($mac, '01:80:24:00:00:00')) $app = 'Kalpana Etherswitch every 60 seconds, EtherType is 0x0802';
  430.         if (mac_equals($mac, '01:DD:00:FF:FF:FF')) $app = 'Ungermann-Bass boot-me requests, EtherType is 0x7002';
  431.         if (mac_equals($mac, '01:DD:01:00:00:00')) $app = 'Ungermann-Bass Spanning Tree, EtherType is 0x7005';
  432.         if (mac_equals($mac, '03:00:00:00:00:10')) $app = 'OS/2 1.3 EE + Communications Manager, EtherType is 0x80D5';
  433.         if (mac_equals($mac, '03:00:00:00:00:40')) $app = 'OS/2 1.3 EE + Communications Manager, EtherType is 0x80D5';
  434.         if (mac_equals($mac, '03:00:00:00:01:00')) $app = 'OSI All-IS Multicast, EtherType is 0x0802';
  435.         if (mac_equals($mac, '03:00:00:00:02:00')) $app = 'OSI All-ES Multicast, EtherType is 0x0802';
  436.         if (mac_equals($mac, '03:00:00:80:00:00')) $app = 'Discovery Client, EtherType is 0x0802';
  437.         if (mac_equals($mac, '03:00:FF:FF:FF:FF')) $app = 'All Stations address, EtherType is 0x0802';
  438.         if (mac_between($mac, '09:00:0D:00:00:00', '09:00:0D:FF:FF:FF')) $app = 'ICL Oslan Multicast, EtherType is 0x0802';
  439.         if (mac_equals($mac, '09:00:0D:02:00:00')) $app = 'ICL Oslan Service discover only on boot';
  440.         if (mac_equals($mac, '09:00:0D:02:0A:3C')) $app = 'ICL Oslan Service discover only on boot';
  441.         if (mac_equals($mac, '09:00:0D:02:0A:38')) $app = 'ICL Oslan Service discover only on boot';
  442.         if (mac_equals($mac, '09:00:0D:02:0A:39')) $app = 'ICL Oslan Service discover only on boot';
  443.         if (mac_equals($mac, '09:00:0D:02:FF:FF')) $app = 'ICL Oslan Service discover only on boot';
  444.         if (mac_equals($mac, '09:00:0D:09:00:00')) $app = 'ICL Oslan Service discover as required';
  445.         if (mac_equals($mac, '09:00:1E:00:00:00')) $app = 'Apollo DOMAIN, EtherType is 0x8019';
  446.         if (mac_equals($mac, '09:00:02:04:00:01')) $app = 'Vitalink printer messages, EtherType is 0x8080';
  447.         if (mac_equals($mac, '09:00:02:04:00:02')) $app = 'Vitalink bridge management, EtherType is 0x8080';
  448.         if (mac_equals($mac, '09:00:4C:00:00:0F')) $app = 'BICC Remote bridge adaptive routing (e.g. to Retix), EtherType is 0x0802';
  449.         if (mac_equals($mac, '09:00:4E:00:00:02')) $app = 'Novell IPX, EtherType is 0x8137';
  450.         if (mac_equals($mac, '09:00:6A:00:01:00')) $app = 'TOP NetBIOS';
  451.         if (mac_equals($mac, '09:00:7C:01:00:01')) $app = 'Vitalink DLS Multicast';
  452.         if (mac_equals($mac, '09:00:7C:01:00:03')) $app = 'Vitalink DLS Inlink';
  453.         if (mac_equals($mac, '09:00:7C:01:00:04')) $app = 'Vitalink DLS and non DLS Multicast';
  454.         if (mac_equals($mac, '09:00:7C:02:00:05')) $app = 'Vitalink diagnostics, EtherType is 0x8080';
  455.         if (mac_equals($mac, '09:00:7C:05:00:01')) $app = 'Vitalink gateway, EtherType is 0x8080';
  456.         if (mac_equals($mac, '09:00:7C:05:00:02')) $app = 'Vitalink Network Validation Message';
  457.         if (mac_equals($mac, '09:00:09:00:00:01')) $app = 'HP Probe, EtherType is 0x8005 or 0x0802';
  458.         if (mac_equals($mac, '09:00:09:00:00:04')) $app = 'HP DTC, EtherType is 0x8005';
  459.         if (mac_equals($mac, '09:00:26:01:00:01')) $app = 'Vitalink TransLAN bridge management, EtherType is 0x8038';
  460.         if (mac_equals($mac, '09:00:39:00:70:00')) $app = 'Spider Systems Bridge';
  461.         if (mac_between($mac, '09:00:56:00:00:00', '09:00:56:FE:FF:FF')) $app = 'Stanford reserved';
  462.         if (mac_between($mac, '09:00:56:FF:00:00', '09:00:56:FF:FF:FF')) $app = 'Stanford V Kernel, version 6.0, EtherType is 0x805C';
  463.         if (mac_equals($mac, '09:00:77:00:00:00')) $app = 'Retix Bridge Local Management System, EtherType is 0x0802';
  464.         if (mac_equals($mac, '09:00:77:00:00:01')) $app = 'Retix spanning tree bridges, EtherType is 0x0802';
  465.         if (mac_equals($mac, '09:00:77:00:00:02')) $app = 'Retix Bridge Adaptive routing, EtherType is 0x0802';
  466.         if (mac_equals($mac, '09:00:87:80:FF:FF')) $app = 'Xyplex Terminal Servers, EtherType is 0x0889';
  467.         if (mac_equals($mac, '09:00:87:90:FF:FF')) $app = 'Xyplex Terminal Servers, EtherType is 0x0889';
  468.         if (mac_between($mac, '44:38:39:FF:00:00', '44:38:39:FF:FF:FF')) $app = 'Multi-Chassis Link Aggregation (Cumulus Linux)';
  469.         if (mac_equals($mac, 'FF:FF:00:40:00:01')) $app = 'LANtastic, EtherType is 0x81D6';
  470.         if (mac_equals($mac, 'FF:FF:00:60:00:04')) $app = 'LANtastic, EtherType is 0x81D6';
  471.         if (mac_equals($mac, 'FF:FF:01:E0:00:04')) $app = 'LANtastic';
  472.  
  473.         // === FAQ "The "CF" series MAC addresses" ===
  474.         // https://www.iana.org/assignments/ppp-numbers/ppp-numbers.xhtml
  475.         // https://tools.ietf.org/html/rfc2153
  476.         // https://tools.ietf.org/html/rfc7042#section-2.3.2
  477.         if (mac_between($mac, 'CF:00:00:00:00:00', 'CF:00:00:FF:FF:FF')) $app = 'Reserved';
  478.         if (mac_equals($mac, 'CF:00:00:00:00:00')) $app = 'Used for Ethernet loopback tests';
  479.  
  480.         // === FAQ "How to recognise a Broadcast MAC address application?" ===
  481.         if (mac_equals($mac, 'FF:FF:FF:FF:FF:FF')) echo sprintf("%-32s %s\n", "Special use:", "Broadcast messaging");
  482.  
  483.         // === FAQ "How to recognise a Virtual Router ID by MAC address?" ===
  484.         // https://tools.ietf.org/html/rfc7042#section-5.1
  485.         // https://tools.ietf.org/html/rfc5798
  486.         if (mac_between($mac, '00:00:5E:00:01:00', '00:00:5E:00:01:FF')) $app = 'IPv4 Virtual Router Redundancy Protocol  (VRRP)';
  487.         if (mac_between($mac, '00:00:5E:00:02:00', '00:00:5E:00:02:FF')) $app = 'IPv6 Virtual Router Redundancy Protocol';
  488.  
  489.         // === FAQ "How to recognise an IP frame by MAC address?" ===
  490.         // https://tools.ietf.org/html/rfc1060
  491.         // https://en.wikipedia.org/wiki/Multicast_address#cite_note-15
  492.         // https://tools.ietf.org/html/rfc2464
  493.         // https://www.iana.org/go/rfc1112
  494.         // http://www.cavebear.com/archive/cavebear/Ethernet/Ethernet.txt
  495.         if (mac_between($mac, '01:00:5E:00:00:00', '01:00:5E:7F:FF:FF')) $app = 'IPv4 Multicast (EtherType is 0x0800)';
  496.         if (mac_between($mac, '33:33:00:00:00:00', '33:33:FF:FF:FF:FF')) $app = 'IPv6 Multicast. IPv6 neighbor discovery (EtherType is 0x86DD)'; // TODO: Dabei werden die untersten 32 Bit der IPv6-Multicast-Adresse in die MAC-Adresse eingebettet.
  497.         if (mac_between($mac, '00:00:5E:00:52:13', '00:00:5E:00:52:13')) $app = 'Proxy Mobile IPv6';
  498.         if (mac_between($mac, '00:00:5E:FE:C0:00:02:00', '00:00:5E:FE:C0:00:02:FF')) $app = 'IPv4 derived documentation';
  499.         if (mac_between($mac, '00:00:5E:FE:C6:33:64:00', '00:00:5E:FE:C6:33:64:FF')) $app = 'IPv4 derived documentation';
  500.         if (mac_between($mac, '00:00:5E:FE:CB:00:71:00', '00:00:5E:FE:CB:00:71:FF')) $app = 'IPv4 derived documentation';
  501.         if (mac_equals($mac, '00:00:5E:FE:EA:C0:00:02')) $app = 'IPv4 multicast derived documentation';
  502.         if (mac_equals($mac, '00:00:5E:FE:EA:C6:33:64')) $app = 'IPv4 multicast derived documentation';
  503.         if (mac_equals($mac, '00:00:5E:FE:EA:CB:00:71')) $app = 'IPv4 multicast derived documentation';
  504.         if (mac_between($mac, '01:00:5E:FE:C0:00:02:00', '01:00:5E:FE:C0:00:02:FF')) $app = 'IPv4 derived documentation';
  505.         if (mac_between($mac, '01:00:5E:FE:C6:33:64:00', '01:00:5E:FE:C6:33:64:FF')) $app = 'IPv4 derived documentation';
  506.         if (mac_between($mac, '01:00:5E:FE:CB:00:71:00', '01:00:5E:FE:CB:00:71:FF')) $app = 'IPv4 derived documentation';
  507.         if (mac_equals($mac, '01:00:5E:FE:EA:C0:00:02')) $app = 'IPv4 multicast derived documentation';
  508.         if (mac_equals($mac, '01:00:5E:FE:EA:C6:33:64')) $app = 'IPv4 multicast derived documentation';
  509.         if (mac_equals($mac, '01:00:5E:FE:EA:CB:00:71')) $app = 'IPv4 multicast derived documentation';
  510.         if (mac_between($mac, '01:80:C2:00:00:20', '01:80:C2:00:00:2F')) $app = 'Reserved for use by Multiple Registration Protocol (MRP) applications';
  511.         if (mac_between($mac, '02:00:5E:FE:00:00:00:00', '02:00:5E:FE:FF:FF:FF:FF')) $app = 'IPv4 Addr Holders';
  512.         if (mac_equals($mac, '03:00:00:20:00:00')) $app = 'IP multicast address';
  513.         if (mac_equals($mac, 'C0:00:00:04:00:00')) $app = 'IP multicast address';
  514.         if (mac_between($mac, '03:00:5E:FE:00:00:00:00', '03:00:5E:FE:FF:FF:FF:FF')) $app = 'IPv4 Addr Holders';
  515.  
  516.         // === FAQ "How to recognise a MPLS multicast frame by MAC address?" ===
  517.         // http://www.iana.org/go/rfc5332
  518.         // http://www.iana.org/go/rfc7213
  519.         if (mac_between($mac, '01:00:5E:80:00:00', '01:00:5E:8F:FF:FF')) $app = 'MPLS multicast (EtherType is 0x8847 or 0x8848)';
  520.         if (mac_equals($mac, '01:00:5E:90:00:00')) $app = 'MPLS-TP p2p';
  521.  
  522.         // === FAQ "How to recognise a Bidirectional Forwarding Detection (BFD) on Link Aggregation Group (LAG) interfaces by MAC address?" ===
  523.         // http://www.iana.org/go/rfc7130
  524.         if (mac_equals($mac, '01:00:5E:90:00:01')) $app = 'Bidirectional Forwarding Detection (BFD) on Link Aggregation Group (LAG) interfaces';
  525.  
  526.         // === FAQ "How to recognise Token Ring specific functions by MAC address?" ===
  527.         // https://tools.ietf.org/html/rfc1060
  528.         // https://tools.ietf.org/html/rfc1469
  529.         // https://standards.ieee.org/products-services/regauth/grpmac/public.html
  530.         // https://tools.ietf.org/html/rfc2470
  531.         // http://www.cavebear.com/archive/cavebear/Ethernet/Ethernet.txt
  532.         if (mac_equals($mac, '03:00:00:00:00:01')) $app = 'NetBIOS (Token Ring)';
  533.         if (mac_equals($mac, '03:00:00:00:00:02')) $app = 'Locate - Directory Server (Token Ring)';
  534.         if (mac_equals($mac, '03:00:00:00:00:04')) $app = 'Synchronous Bandwidth Manager (Token Ring)';
  535.         if (mac_equals($mac, '03:00:00:00:00:08')) $app = 'Configuration Report Server (Token Ring)';
  536.         if (mac_equals($mac, '03:00:00:00:00:10')) $app = 'Ring Error Monitor (Token Ring)';
  537.         if (mac_equals($mac, '03:00:00:00:00:20')) $app = 'Network Server Heartbeat (Token Ring)';
  538.         if (mac_equals($mac, '03:00:00:00:00:40')) $app = 'Ring Parameter Monitor (Token Ring)';
  539.         if (mac_equals($mac, '03:00:00:00:00:80')) $app = 'Active Monitor (Token Ring)';
  540.         if (mac_equals($mac, '03:00:00:00:04:00')) $app = 'LAN Manager (Token Ring)';
  541.         if (mac_equals($mac, '03:00:00:00:08:00')) $app = 'Ring Wiring Concentrator (Token Ring)';
  542.         if (mac_equals($mac, '03:00:00:00:10:00')) $app = 'LAN Gateway (Token Ring)';
  543.         if (mac_equals($mac, '03:00:00:00:20:00')) $app = 'Ring Authorization Server (Token Ring)';
  544.         if (mac_equals($mac, '03:00:00:00:40:00')) $app = 'IMPL Server (Token Ring)';
  545.         if (mac_equals($mac, '03:00:00:00:80:00')) $app = 'Bridge (Token Ring)';
  546.         if (mac_equals($mac, '03:00:00:20:00:00')) $app = 'Single Token-Ring functional address';
  547.         if (mac_equals($mac, '03:00:00:00:00:08')) $app = 'Configuration Report Server (CRS) MAC Group address';
  548.         if (mac_equals($mac, '03:00:00:00:00:10')) $app = 'Ring Error Monitor (REM) MAC Group address';
  549.         if (mac_equals($mac, '03:00:00:00:00:40')) $app = 'Ring Parameter Server (RPS) MAC group address';
  550.         if (mac_equals($mac, '03:00:00:00:01:00')) $app = 'All Intermediate System Network Entities address';
  551.         if (mac_equals($mac, '03:00:00:00:02:00')) $app = 'All End System Network Entities address, and Lobe Media Test (LMT) MAC group address';
  552.         if (mac_equals($mac, '03:00:00:00:04:00')) $app = 'Generic address for all Manager Stations';
  553.         if (mac_equals($mac, '03:00:00:00:08:00')) $app = 'All CONs SNARES address';
  554.         if (mac_equals($mac, '03:00:00:00:10:00')) $app = 'All CONs End System address';
  555.         if (mac_equals($mac, '03:00:00:00:20:00')) $app = 'Loadable Device Generic address';
  556.         if (mac_equals($mac, '03:00:00:00:40:00')) $app = 'Load Server Generic address';
  557.         if (mac_equals($mac, '03:00:00:40:00:00')) $app = 'Generic address for all Agent Stations';
  558.         if (mac_equals($mac, 'C0:00:00:04:00:00')) $app = 'Single Token-Ring functional address';
  559.         if (mac_equals($mac, '03:00:80:00:00:00')) $app = 'IPv6 multicast over Token Ring: all-Nodes (FF01::1 and FF02::1) and solicited node (FF02:0:0:0:0:1:FFXX:XXXX) addresses';
  560.         if (mac_equals($mac, '03:00:40:00:00:00')) $app = 'IPv6 multicast over Token Ring: all-Routers addresses (FF0X::2)';
  561.         if (mac_equals($mac, '03:00:00:80:00:00')) $app = 'IPv6 multicast over Token Ring: any other multicast address with three least significant bits = 000';
  562.         if (mac_equals($mac, '03:00:00:40:00:00')) $app = 'IPv6 multicast over Token Ring: any other multicast address with three least significant bits = 001';
  563.         if (mac_equals($mac, '03:00:00:20:00:00')) $app = 'IPv6 multicast over Token Ring: any other multicast address with three least significant bits = 010';
  564.         if (mac_equals($mac, '03:00:00:10:00:00')) $app = 'IPv6 multicast over Token Ring: any other multicast address with three least significant bits = 011';
  565.         if (mac_equals($mac, '03:00:00:08:00:00')) $app = 'IPv6 multicast over Token Ring: any other multicast address with three least significant bits = 100';
  566.         if (mac_equals($mac, '03:00:00:04:00:00')) $app = 'IPv6 multicast over Token Ring: any other multicast address with three least significant bits = 101';
  567.         if (mac_equals($mac, '03:00:00:02:00:00')) $app = 'IPv6 multicast over Token Ring: any other multicast address with three least significant bits = 110';
  568.         if (mac_equals($mac, '03:00:00:01:00:00')) $app = 'IPv6 multicast over Token Ring: any other multicast address with three least significant bits = 111';
  569.  
  570.         // === FAQ "How to recognise an AppleTalk protocols by MAC address?" ===
  571.         // https://tools.ietf.org/html/rfc1060
  572.         // http://www.cavebear.com/archive/cavebear/Ethernet/Ethernet.txt
  573.         if (mac_between($mac, '09:00:07:00:00:00', '09:00:07:00:00:FC')) $app = 'AppleTalk zone multicast addresses (EtherType is 0x0802)';
  574.         if (mac_equals($mac, '09:00:07:FF:FF:FF')) $app = 'AppleTalk broadcast address (EtherType is 0x0802)';
  575.  
  576.         // === FAQ "How to recognise a TRILL protocols by MAC address?" ===
  577.         // http://www.iana.org/go/rfc7455
  578.         // https://tools.ietf.org/html/draft-ietf-trill-oam-framework-04
  579.         // https://standards.ieee.org/products-services/regauth/grpmac/public.html
  580.         // https://tools.ietf.org/html/rfc7455#appendix-C
  581.         if (mac_between($mac, '00:00:5E:90:01:00', '00:00:5E:90:01:00')) $app = 'TRILL OAM';
  582.         if (mac_equals($mac, '01:00:5E:90:01:00')) $app = 'TRILL OAM';
  583.         if (mac_between($mac, '01:80:C2:00:00:40', '01:80:C2:00:00:4F')) $app = 'Group MAC addresses used by the TRILL protocols';
  584.  
  585.         // === FAQ "How to recognise an IEEE 802.1X MAC address application?" ===
  586.         if (mac_between($mac, '01:0C:CD:01:00:00', '01:0C:CD:01:01:FF')) $app = 'IEC 61850-8-1 GOOSE Type 1/1A, EtherType is 0x88B8';
  587.         if (mac_between($mac, '01:0C:CD:02:00:00', '01:0C:CD:02:01:FF')) $app = 'GSSE (IEC 61850 8-1), EtherType is 0x88B9';
  588.         if (mac_between($mac, '01:0C:CD:04:00:00', '01:0C:CD:04:01:FF')) $app = 'Multicast sampled values (IEC 61850 8-1), EtherType is 0x88BA';
  589.         if (mac_equals($mac, '01:1B:19:00:00:00')) $app = 'General group address - An 802.1Q VLAN Bridge would forward the frame unchanged.';
  590.         if (mac_equals($mac, '01:1B:19:00:00:00')) $app = 'Precision Time Protocol (PTP) version 2 over Ethernet, EtherType is 0x88F7';
  591.         if (mac_equals($mac, '01:80:C2:00:00:00')) $app = 'Bridge Group address Nearest Customer Bridge group address';
  592.         if (mac_equals($mac, '01:80:C2:00:00:00')) $app = 'Spanning Tree Protocol (for bridges) IEEE 802.1D, EtherType is 0x0802';
  593.         if (mac_equals($mac, '01:80:C2:00:00:00')) $app = 'Link Layer Discovery Protocol, EtherType is 0x88CC';
  594.         if (mac_between($mac, '01:80:C2:00:00:00', '01:80:C2:00:00:0F')) $app = 'The initial bridging/link protocols block';
  595.         if (mac_between($mac, '01:80:C2:00:00:00', '01:80:C2:00:00:0F')) $app = 'IEEE 802.1D MAC Bridge Filtered MAC Group Addresses';
  596.         if (mac_between($mac, '01:80:C2:00:00:00', '01:80:C2:00:00:0F')) $app = 'IEEE Pause, 802.3x';
  597.         if (mac_equals($mac, '01:80:C2:00:00:0A')) $app = 'Reserved for future standardization';
  598.         if (mac_equals($mac, '01:80:C2:00:00:0B')) $app = 'EDE-SS PEP Address';
  599.         if (mac_equals($mac, '01:80:C2:00:00:0C')) $app = 'Reserved for future standardization';
  600.         if (mac_equals($mac, '01:80:C2:00:00:0D')) $app = 'Provider Bridge MVRP address';
  601.         if (mac_equals($mac, '01:80:C2:00:00:0E')) $app = 'Individual LAN Scope group address, It is intended that no IEEE 802.1 relay device will be defined that will forward frames that carry this destination address';
  602.         if (mac_equals($mac, '01:80:C2:00:00:0E')) $app = 'Nearest Bridge group address';
  603.         if (mac_equals($mac, '01:80:C2:00:00:0E')) $app = 'Link Layer Discovery Protocol, EtherType is 0x88CC';
  604.         if (mac_equals($mac, '01:80:C2:00:00:0E')) $app = 'Precision Time Protocol (PTP) version 2 over Ethernet, EtherType is 0x88F7';
  605.         if (mac_equals($mac, '01:80:C2:00:00:01')) $app = 'IEEE MAC-specific Control Protocols group address';
  606.         if (mac_equals($mac, '01:80:C2:00:00:01')) $app = 'Ethernet flow control (Pause frame) IEEE 802.3x, EtherType is 0x8808';
  607.         if (mac_equals($mac, '01:80:C2:00:00:1A')) $app = 'Generic Address for All Agent Stations';
  608.         if (mac_equals($mac, '01:80:C2:00:00:1B')) $app = 'All Multicast Capable End Systems address';
  609.         if (mac_equals($mac, '01:80:C2:00:00:1C')) $app = 'All Multicast Announcements address';
  610.         if (mac_equals($mac, '01:80:C2:00:00:1D')) $app = 'All Multicast Capable Intermediate Systems address';
  611.         if (mac_equals($mac, '01:80:C2:00:00:1E')) $app = 'All DTR Concentrators MAC group address';
  612.         if (mac_equals($mac, '01:80:C2:00:00:1F')) $app = 'EDE-CC PEP Address';
  613.         if (mac_between($mac, '01:80:C2:00:00:01', '01:80:C2:00:00:0F')) $app = '802.1 alternate Spanning multicast, EtherType is 0x0802';
  614.         if (mac_equals($mac, '01:80:C2:00:00:02')) $app = 'Ethernet OAM Protocol IEEE 802.3ah (also known as "slow protocols"), EtherType is 0x8809';
  615.         if (mac_equals($mac, '01:80:C2:00:00:03')) $app = 'Nearest non-TPMR Bridge group address IEEE Std 802.1X PAE address';
  616.         if (mac_equals($mac, '01:80:C2:00:00:03')) $app = 'Link Layer Discovery Protocol, EtherType is 0x88CC';
  617.         if (mac_equals($mac, '01:80:C2:00:00:04')) $app = 'IEEE MAC-specific Control Protocols group address';
  618.         if (mac_equals($mac, '01:80:C2:00:00:05')) $app = 'Reserved for future standardization';
  619.         if (mac_equals($mac, '01:80:C2:00:00:06')) $app = 'Reserved for future standardization';
  620.         if (mac_equals($mac, '01:80:C2:00:00:07')) $app = 'MEF Forum ELMI protocol group address';
  621.         if (mac_equals($mac, '01:80:C2:00:00:08')) $app = 'Provider Bridge group address';
  622.         if (mac_equals($mac, '01:80:C2:00:00:08')) $app = 'Spanning Tree Protocol (for provider bridges) IEEE 802.1ad, EtherType is 0x0802';
  623.         if (mac_equals($mac, '01:80:C2:00:00:09')) $app = 'Reserved for future standardization';
  624.         if (mac_equals($mac, '01:80:C2:00:00:10')) $app = 'All LANs Bridge Management group address (deprecated)';
  625.         if (mac_equals($mac, '01:80:C2:00:00:10')) $app = 'Bridge Management, EtherType is 0x0802';
  626.         if (mac_equals($mac, '01:80:C2:00:00:11')) $app = 'Load Server generic address';
  627.         if (mac_equals($mac, '01:80:C2:00:00:11')) $app = 'Load Server, EtherType is 0x0802';
  628.         if (mac_equals($mac, '01:80:C2:00:00:12')) $app = 'Loadable Device generic address';
  629.         if (mac_equals($mac, '01:80:C2:00:00:12')) $app = 'Loadable Device, EtherType is 0x0802';
  630.         if (mac_equals($mac, '01:80:C2:00:00:13')) $app = 'Transmission of IEEE 1905.1 control packets';
  631.         if (mac_equals($mac, '01:80:C2:00:00:14')) $app = 'All Level 1 Intermediate Systems address';
  632.         if (mac_equals($mac, '01:80:C2:00:00:14')) $app = 'OSI Route level 1 (within area), EtherType is 0x0802';
  633.         if (mac_equals($mac, '01:80:C2:00:00:15')) $app = 'All Level 2 Intermediate Systems address';
  634.         if (mac_equals($mac, '01:80:C2:00:00:15')) $app = 'OSI Route level 2 (between area), EtherType is 0x0802';
  635.         if (mac_equals($mac, '01:80:C2:00:00:16')) $app = 'All CONS End Systems address';
  636.         if (mac_equals($mac, '01:80:C2:00:00:17')) $app = 'All CONS SNARES address';
  637.         if (mac_equals($mac, '01:80:C2:00:00:18')) $app = 'Generic address for All Manager Stations';
  638.         if (mac_equals($mac, '01:80:C2:00:00:19')) $app = 'Groupcast with retries (GCR) MAC group address';
  639.         if (mac_between($mac, '01:80:C2:00:00:20', '01:80:C2:00:00:2F')) $app = 'Reserved for use by Multiple Registration Protocol (MRP) applications';
  640.         if (mac_equals($mac, '01:80:C2:00:00:21')) $app = 'GARP VLAN Registration Protocol (also known as IEEE 802.1q GVRP), EtherType is 0x88f5';
  641.         if (mac_between($mac, '01:80:C2:00:00:30', '01:80:C2:00:00:3F')) $app = 'Destination group MAC addresses for CCM and Linktrace messages';
  642.         if (mac_between($mac, '01:80:C2:00:00:30', '01:80:C2:00:00:3F')) $app = 'Ethernet CFM Protocol IEEE 802.1ag, EtherType is 0x8902';
  643.         if (mac_between($mac, '01:80:C2:00:00:50', '01:80:C2:00:00:FF')) $app = 'Unassigned standard group MAC address';
  644.         if (mac_equals($mac, '01:80:C2:00:01:00')) $app = 'Ring Management Directed Beacon multicast address';
  645.         if (mac_equals($mac, '01:80:C2:00:01:00')) $app = 'FDDI RMT Directed Beacon, EtherType is 0x0802';
  646.         if (mac_between($mac, '01:80:C2:00:01:01', '01:80:C2:00:01:0F')) $app = 'Assigned to ISO/IEC JTC1/SC25 for future use';
  647.         if (mac_equals($mac, '01:80:C2:00:01:10')) $app = 'Status Report Frame Status Report Protocol multicast address';
  648.         if (mac_equals($mac, '01:80:C2:00:01:10')) $app = 'FDDI status report frame, EtherType is 0x0802';
  649.         if (mac_between($mac, '01:80:C2:00:01:11', '01:80:C2:00:01:1F')) $app = 'Assigned to ISO/IEC JTC1/SC25 for future use';
  650.         if (mac_equals($mac, '01:80:C2:00:01:20')) $app = 'All FDDI Concentrator MACs';
  651.         if (mac_between($mac, '01:80:C2:00:01:21', '01:80:C2:00:01:2F')) $app = 'Assigned to ISO/IEC JTC1/SC25 for future use';
  652.         if (mac_equals($mac, '01:80:C2:00:01:30')) $app = 'Synchronous Bandwidth Allocation address';
  653.         if (mac_between($mac, '01:80:C2:00:01:31', '01:80:C2:00:01:FF')) $app = 'Assigned to ISO/IEC JTC1/SC25 for future use';
  654.         if (mac_between($mac, '01:80:C2:00:02:00', '01:80:C2:00:02:FF')) $app = 'Assigned to ETSI for future use';
  655.         if (mac_between($mac, '01:80:C2:00:03:00', '01:80:C2:FF-FF-FF')) $app = 'Unassigned standard group MAC address';
  656.         if (mac_equals($mac, '09:00:4C:00:00:00')) $app = 'BICC 802.1 management, EtherType is 0x0802';
  657.         if (mac_equals($mac, '09:00:4C:00:00:0C')) $app = 'BICC Remote bridge STA 802.1(D) Rev8, EtherType is 0x0802';
  658.         if (mac_equals($mac, '09:00:4C:00:00:02')) $app = 'BICC 802.1 management, EtherType is 0x0802';
  659.         if (mac_equals($mac, '09:00:4C:00:00:06')) $app = 'BICC Local bridge STA 802.1(D) Rev6, EtherType is 0x0802';
  660.         if (mac_between($mac, '33:33:00:00:00:00', '33:33:FF:FF:FF:FF')) $app = 'IPv6 multicast, EtherType is 0x86DD';
  661.  
  662.         // === FAQ "How to recognise an ISO 9542 ES-IS protocol's MAC address application?" ===
  663.         // https://standards.ieee.org/products-services/regauth/grpmac/public.html
  664.         if (mac_equals($mac, '09:00:2B:00:00:04')) $app = 'All End System Network Entities address';
  665.         if (mac_equals($mac, '09:00:2B:00:00:05')) $app = 'All Intermediate System Network Entities address';
  666.  
  667.         // === FAQ "How to recognise an IANA MAC address application?" ===
  668.         // https://www.iana.org/assignments/ethernet-numbers/ethernet-numbers.xhtml
  669.         // http://www.iana.org/go/rfc7042
  670.         // https://tools.ietf.org/html/rfc1060
  671.         if (mac_between($mac, '00:00:5E:00-52:14', '00:00:5E:00:52:FF')) $app = 'Unassigned (small allocations)';
  672.         if (mac_between($mac, '00:00:5E:00:00:00', '00:00:5E:00:00:FF')) $app = 'Reserved and require IESG Ratification for assignment';
  673.         if (mac_between($mac, '00:00:5E:00:03:00', '00:00:5E:00:51:FF')) $app = 'Unassigned';
  674.         if (mac_between($mac, '00:00:5E:00:52:00', '00:00:5E:00:52:FF')) $app = 'Is used for very small assignments. Currently, 3 out of these 256 values have been assigned.';
  675.         if (mac_between($mac, '00:00:5E:00:52:00', '00:00:5E:00:52:00')) $app = 'PacketPWEthA';
  676.         if (mac_between($mac, '00:00:5E:00:52:01', '00:00:5E:00:52:01')) $app = 'PacketPWEthB';
  677.         if (mac_between($mac, '00:00:5E:00:52:02', '00:00:5E:00:52:12')) $app = 'Unassigned (small allocations)';
  678.         if (mac_between($mac, '00:00:5E:00:53:00', '00:00:5E:00:53:FF')) $app = 'Assigned for use in documentation';
  679.         if (mac_between($mac, '00:00:5E:00:54:00', '00:00:5E:90:00:FF')) $app = 'Unassigned';
  680.         if (mac_between($mac, '00:00:5E:90:01:01', '00:00:5E:90:01:FF')) $app = 'Unassigned (small allocations requiring both unicast and multicast)';
  681.         if (mac_between($mac, '00:00:5E:EF:10:00:00:00', '00:00:5E:EF:10:00:00:FF')) $app = 'General documentation';
  682.         if (mac_between($mac, '00:00:5E:FF:FE:00:53:00', '00:00:5E:FF:FE:00:53:FF')) $app = 'EUI-48 derived documentation';
  683.         if (mac_between($mac, '01:00:5E:00:00:00', '01:00:5E:7F:FF:FF')) $app = 'DoD Internet Multicast (EtherType is 0x0800)'; // TODO: IPv4-Multicast  (Dabei werden dann die unteren 23 Bit der IP-Multicast-Adresse direkt auf die untersten 23 Bit der MAC-Adresse abgebildet. Der IP-Multicast-Adresse 224.0.0.1 ist somit die Multicast-MAC-Adresse 01-00-5e-00-00-01 fest zugeordnet.)
  684.         if (mac_between($mac, '01:00:5E:80:00:00', '01:00:5E:FF:FF:FF')) $app = 'DoD Internet';
  685.         if (mac_equals($mac, '01:00:5E:90:00:02')) $app = 'AllL1MI-ISs';
  686.         if (mac_equals($mac, '01:00:5E:90:00:03')) $app = 'AllL2MI-ISs';
  687.         if (mac_between($mac, '01:00:5E:90:00:04', '01:00:5E:90:00:FF')) $app = 'Unassigned (small allocations)';
  688.         if (mac_between($mac, '01:00:5E:90:01:01', '01:00:5E:90:01:FF')) $app = 'Unassigned (small allocations requiring both unicast and multicast)';
  689.         if (mac_between($mac, '01:00:5E:90:02:00', '01:00:5E:90:0F:FF')) $app = 'Unassigned';
  690.         if (mac_between($mac, '01:00:5E:90:02:00', '00:00:5E:FF:FF:FF')) $app = 'Unassigned';
  691.         if (mac_between($mac, '01:00:5E:90:10:00', '01:00:5E:90:10:FF')) $app = 'Documentation';
  692.         if (mac_between($mac, '01:00:5E:90:11:00', '01:00:5E:FF:FF:FF')) $app = 'Unassigned';
  693.         if (mac_between($mac, '01:00:5E:EF:10:00:00:00', '01:00:5E:EF:10:00:00:FF')) $app = 'General documentation';
  694.         if (mac_between($mac, '02:00:5E:00:00:00:00:00', '02:00:5E:0F:FF:FF:FF:FF')) $app = 'Reserved';
  695.         if (mac_between($mac, '02:00:5E:10:00:00:00:00', '02:00:5E:10:00:00:00:FF')) $app = 'Documentation';
  696.         if (mac_between($mac, '02:00:5E:10:00:00:01:00', '02:00:5E:EF:FF:FF:FF:FF')) $app = 'Unassigned';
  697.         if (mac_between($mac, '02:00:5E:F0:00:00:00:00', '02:00:5E:FD:FF:FF:FF:FF')) $app = 'Reserved';
  698.         if (mac_between($mac, '02:00:5E:FE:00:00:00:00', '02:00:5E:FE:FF:FF:FF:FF')) $app = 'IPv4 Addr Holders';
  699.         if (mac_between($mac, '02:00:5E:FF:00:00:00:00', '02:00:5E:FF:FD:FF:FF:FF')) $app = 'Reserved';
  700.         if (mac_between($mac, '02:00:5E:FF:FE:00:00:00', '02:00:5E:FF:FE:FF:FF:FF')) $app = 'IANA EUI-48 Holders';
  701.         if (mac_between($mac, '02:00:5E:FF:FF:00:00:00', '02:00:5E:FF:FF:FF:FF:FF')) $app = 'Reserved';
  702.         if (mac_between($mac, '03:00:5E:00:00:00:00:00', '03:00:5E:0F:FF:FF:FF:FF')) $app = 'Reserved';
  703.         if (mac_between($mac, '03:00:5E:10:00:00:00:00', '03:00:5E:10:00:00:00:FF')) $app = 'Documentation';
  704.         if (mac_between($mac, '03:00:5E:10:00:00:01:00', '03:00:5E:EF:FF:FF:FF:FF')) $app = 'Unassigned';
  705.         if (mac_between($mac, '03:00:5E:F0:00:00:00:00', '03:00:5E:FD:FF:FF:FF:FF')) $app = 'Reserved';
  706.         if (mac_between($mac, '03:00:5E:FF:00:00:00:00', '03:00:5E:FF:FD:FF:FF:FF')) $app = 'Reserved';
  707.         if (mac_between($mac, '03:00:5E:FF:FE:00:00:00', '03:00:5E:FF:FE:FF:FF:FF')) $app = 'IANA EUI-48 Holders';
  708.         if (mac_between($mac, '03:00:5E:FF:FF:00:00:00', '03:00:5E:FF:FF:FF:FF:FF')) $app = 'Reserved';
  709.  
  710.         // === FAQ "How to recognise a Cisco's MAC address application?" ===
  711.         // https://www.cisco.com/c/en/us/support/docs/switches/catalyst-4500-series-switches/13414-103.html
  712.         // https://tools.ietf.org/html/rfc1060
  713.         // https://en.wikipedia.org/wiki/Multicast_address#cite_note-15
  714.         // http://www.cavebear.com/archive/cavebear/Ethernet/Ethernet.txt
  715.         if (mac_equals($mac, '01:00:0C:00:00:00')) $app = 'Inter Switch Link (ISL)';
  716.         if (mac_equals($mac, '01:00:0C:CC:CC:CC')) $app = 'CDP (Cisco Discovery Protocol), VTP (VLAN Trunking Protocol), EtherType is 0x0802';
  717.         if (mac_equals($mac, '01:00:0C:CC:CC:CC')) $app = 'Port Aggregation Protocol (PAgP), SNAP HDLC Protocol Type is 0x0104';
  718.         if (mac_equals($mac, '01:00:0C:CC:CC:CC')) $app = 'Unidirectional Link Detection (UDLD), SNAP HDLC Protocol Type is 0x0111';
  719.         if (mac_equals($mac, '01:00:0C:CC:CC:CC')) $app = 'Dynamic Trunking (DTP), SNAP HDLC Protocol Type is 0x2004';
  720.         if (mac_equals($mac, '01:00:0C:CC:CC:CC')) $app = 'VLAN Trunking (VTP), SNAP HDLC Protocol Type is 0x2003';
  721.         if (mac_equals($mac, '01:00:0C:CC:CC:CD')) $app = 'Cisco Shared Spanning Tree Protocol address, EtherType is 0x0802';
  722.         if (mac_equals($mac, '01:00:0C:CC:CC:CD')) $app = 'Spanning Tree PVSTP+, SNAP HDLC Protocol Type is 0x010B';
  723.         if (mac_equals($mac, '01:00:0C:CD:CD:CD')) $app = 'STP Uplink Fast, SNAP HDLC Protocol Type is 0x200A';
  724.         if (mac_equals($mac, '01:00:0C:CD:CD:CE')) $app = 'VLAN Bridge, SNAP HDLC Protocol Type is 0x010C';
  725.         if (mac_equals($mac, '01:00:0C:DD:DD:DD')) $app = 'CGMP (Cisco Group Management Protocol)';
  726.  
  727.         // === FAQ "How to recognise an ITU-T's MAC address application?" ===
  728.         // https://www.itu.int/en/ITU-T/studygroups/2017-2020/15/Documents/IEEE-assigned_OUIs-30-06-2017.docx
  729.         if (mac_between($mac, '01:19:A7:00:00:00', '01:19:A7:00:00:FF')) $app = 'R-APS per G.8032';
  730.         if (mac_between($mac, '01:19:A7:52:76:90', '01:19:A7:52:76:9F')) $app = 'Multicast per G.9961';
  731.  
  732.         // === FAQ "How to recognise Digital Equipment Corporation's MAC address application?" ===
  733.         if (mac_equals($mac, '09:00:2B:00:00:00')) $app = 'DEC MUMPS, EtherType is 0x6009';
  734.         if (mac_equals($mac, '09:00:2B:00:00:0F')) $app = 'DEC Local Area Transport (LAT), EtherType is 0x6004';
  735.         if (mac_equals($mac, '09:00:2B:00:00:01')) $app = 'DEC DSM/DDP, EtherType is 0x8039';
  736.         if (mac_between($mac, '09:00:2B:00:00:10', '09:00:2B:00:00:1F')) $app = 'DEC Experimental';
  737.         if (mac_equals($mac, '09:00:2B:00:00:02')) $app = 'DEC VAXELN, EtherType is 0x803B';
  738.         if (mac_equals($mac, '09:00:2B:00:00:03')) $app = 'DEC Lanbridge Traffic Monitor (LTM), EtherType is 0x8038';
  739.         if (mac_equals($mac, '09:00:2B:00:00:04')) $app = 'DEC MAP End System';
  740.         if (mac_equals($mac, '09:00:2B:00:00:05')) $app = 'DEC MAP Intermediate System';
  741.         if (mac_equals($mac, '09:00:2B:00:00:06')) $app = 'DEC CSMA/CD Encryption, EtherType is 0x803D';
  742.         if (mac_equals($mac, '09:00:2B:00:00:07')) $app = 'DEC NetBios Emulator, EtherType is 0x8040';
  743.         if (mac_equals($mac, '09:00:2B:01:00:00')) $app = 'DEC LanBridge, EtherType is 0x8038';
  744.         if (mac_equals($mac, '09:00:2B:01:00:01')) $app = 'DEC LanBridge, EtherType is 0x8038';
  745.         if (mac_equals($mac, '09:00:2B:02:00:00')) $app = 'DEC DNA Level 2 Routing';
  746.         if (mac_equals($mac, '09:00:2B:02:01:00')) $app = 'DEC DNA Naming Service Advertisement, EtherType is 0x803C';
  747.         if (mac_equals($mac, '09:00:2B:02:01:01')) $app = 'DEC DNA Naming Service Solicitation, EtherType is 0x803C';
  748.         if (mac_equals($mac, '09:00:2B:02:01:02')) $app = 'DEC Distributed Time Service, EtherType is 0x803E';
  749.         if (mac_equals($mac, '09:00:2B:02:01:09')) $app = 'DEC Availability Manager for Distributed Systems DECamds, EtherType is 0x8048';
  750.         if (mac_between($mac, '09:00:2B:03:00:00', '09:00:2B:03:FF:FF')) $app = 'DEC default filtering by bridges';
  751.         if (mac_equals($mac, '09:00:2B:04:00:00')) $app = 'DEC Local Area System Transport (LAST), EtherType is 0x8041';
  752.         if (mac_equals($mac, '09:00:2B:23:00:00')) $app = 'DEC Argonaut Console, EtherType is 0x803A';
  753.         if (mac_equals($mac, 'AB:00:00:01:00:00')) $app = 'DEC Maintenance Operation Protocol (MOP) Dump/Load Assistance, EtherType is 0x6001';
  754.         if (mac_equals($mac, 'AB:00:00:02:00:00')) $app = 'DEC Maintenance Operation Protocol (MOP), EtherType is 0x6002';
  755.         if (mac_equals($mac, 'AB:00:00:03:00:00')) $app = 'DECNET Phase IV end node, EtherType is 0x6003';
  756.         if (mac_equals($mac, 'AB:00:00:04:00:00')) $app = 'DECNET Phase IV Router, EtherType is 0x6003';
  757.         if (mac_between($mac, 'AB:00:00:05:00:00', 'AB:00:03:FF:FF:FF')) $app = 'Reserved DEC';
  758.         if (mac_equals($mac, 'AB:00:03:00:00:00')) $app = 'DEC Local Area Transport (LAT) - old, EtherType is 0x6004';
  759.         if (mac_between($mac, 'AB:00:04:00:00:00', 'AB:00:04:00:FF:FF')) $app = 'Reserved DEC customer private use';
  760.         if (mac_between($mac, 'AB:00:04:01:00:00', 'AB:00:04:01:FF:FF')) $app = 'DEC Local Area VAX Cluster groups System Communication Architecture (SCA), EtherType is 0x6007';
  761.  
  762.         if ($app) {
  763.                 echo sprintf("%-32s %s\n", "Special use:", $app);
  764.         }
  765.  
  766. }
  767.  
  768. /**
  769.  * @param string $mac1
  770.  * @param string $mac2
  771.  * @return bool
  772.  */
  773. function mac_equals(string $mac1, string $mac2): bool {
  774.         $mac1test = eui64_to_eui48($mac1);
  775.         if ($mac1test === false) return false;
  776.         $mac2test = eui64_to_eui48($mac2);
  777.         if ($mac2test === false) return false;
  778.  
  779.         if (eui_bits($mac1test) != eui_bits($mac2test)) {
  780.                 $mac1test = eui48_to_eui64($mac1);
  781.                 $mac2test = eui48_to_eui64($mac2);
  782.         }
  783.  
  784.         return mac_canonize($mac1test) == mac_canonize($mac2test);
  785. }
  786.  
  787. /**
  788.  * @param string $mac
  789.  * @param string $low
  790.  * @param string $high
  791.  * @return bool
  792.  */
  793. function mac_between(string $mac, string $low, string $high): bool {
  794.         $mactest = eui64_to_eui48($mac);
  795.         if ($mactest === false) return false;
  796.         $lowtest = eui64_to_eui48($low);
  797.         if ($lowtest === false) return false;
  798.         $hightest = eui64_to_eui48($high);
  799.         if ($hightest === false) return false;
  800.  
  801.         if ((eui_bits($mactest) != eui_bits($lowtest)) || (eui_bits($lowtest) != eui_bits($hightest))) {
  802.                 $mactest = eui48_to_eui64($mac);
  803.                 if ($mactest === false) return false; // e.g. trying ELI-48 to ELI-64
  804.                 $lowtest = eui48_to_eui64($low);
  805.                 if ($lowtest === false) return false; // e.g. trying ELI-48 to ELI-64
  806.                 $hightest = eui48_to_eui64($high);
  807.                 if ($hightest === false) return false; // e.g. trying ELI-48 to ELI-64
  808.         }
  809.  
  810.         $mactest = strtoupper(preg_replace('@[^0-9A-F]@', '', $mactest));
  811.         $lowtest = strtoupper(preg_replace('@[^0-9A-F]@', '', $lowtest));
  812.         $hightest = strtoupper(preg_replace('@[^0-9A-F]@', '', $hightest));
  813.  
  814.         $mactest = gmp_init($mactest, 16);
  815.         $lowtest = gmp_init($lowtest, 16);
  816.         $hightest = gmp_init($hightest, 16);
  817.  
  818.         return (gmp_cmp($mactest, $lowtest) >= 0) && (gmp_cmp($mactest, $hightest) <= 0);
  819. }
  820.