mirror of
https://github.com/zerotier/ZeroTierOne.git
synced 2025-04-26 08:57:26 +02:00
568 lines
20 KiB
C++
568 lines
20 KiB
C++
/*
|
|
* Copyright (c)2013-2020 ZeroTier, Inc.
|
|
*
|
|
* Use of this software is governed by the Business Source License included
|
|
* in the LICENSE.TXT file in the project's root directory.
|
|
*
|
|
* Change Date: 2024-01-01
|
|
*
|
|
* On the date above, in accordance with the Business Source License, use
|
|
* of this software will be governed by version 2.0 of the Apache License.
|
|
*/
|
|
/****/
|
|
|
|
#ifndef ZT_INETADDRESS_HPP
|
|
#define ZT_INETADDRESS_HPP
|
|
|
|
#include <cstdlib>
|
|
#include <cstring>
|
|
#include <cstdint>
|
|
|
|
#include "Constants.hpp"
|
|
#include "Utils.hpp"
|
|
#include "MAC.hpp"
|
|
#include "TriviallyCopyable.hpp"
|
|
|
|
namespace ZeroTier {
|
|
|
|
#define ZT_INETADDRESS_MARSHAL_SIZE_MAX 19
|
|
|
|
/**
|
|
* Extends sockaddr_storage with friendly C++ methods
|
|
*
|
|
* This is basically a "mixin" for sockaddr_storage. It adds methods and
|
|
* operators, but does not modify the structure. This can be cast to/from
|
|
* sockaddr_storage and used interchangeably. DO NOT change this by e.g.
|
|
* adding non-static fields, since much code depends on this identity.
|
|
*/
|
|
struct InetAddress : public sockaddr_storage,public TriviallyCopyable
|
|
{
|
|
private:
|
|
// Internal function to copy any sockaddr_X structure to this one even if it's smaller and unpadded.
|
|
template<typename SA>
|
|
ZT_ALWAYS_INLINE void copySockaddrToThis(const SA *sa)
|
|
{
|
|
memcpy(reinterpret_cast<void *>(this),sa,sizeof(SA));
|
|
if (sizeof(SA) < sizeof(InetAddress))
|
|
memset(reinterpret_cast<uint8_t *>(this) + sizeof(SA),0,sizeof(InetAddress) - sizeof(SA));
|
|
}
|
|
|
|
public:
|
|
/**
|
|
* Loopback IPv4 address (no port)
|
|
*/
|
|
static const InetAddress LO4;
|
|
|
|
/**
|
|
* Loopback IPV6 address (no port)
|
|
*/
|
|
static const InetAddress LO6;
|
|
|
|
/**
|
|
* Null address
|
|
*/
|
|
static const InetAddress NIL;
|
|
|
|
/**
|
|
* IP address scope
|
|
*
|
|
* Note that these values are in ascending order of path preference and
|
|
* MUST remain that way or Path must be changed to reflect. Also be sure
|
|
* to change ZT_INETADDRESS_MAX_SCOPE if the max changes.
|
|
*/
|
|
enum IpScope
|
|
{
|
|
IP_SCOPE_NONE = 0, // NULL or not an IP address
|
|
IP_SCOPE_MULTICAST = 1, // 224.0.0.0 and other V4/V6 multicast IPs
|
|
IP_SCOPE_LOOPBACK = 2, // 127.0.0.1, ::1, etc.
|
|
IP_SCOPE_PSEUDOPRIVATE = 3, // 28.x.x.x, etc. -- unofficially unrouted IPv4 blocks often "bogarted"
|
|
IP_SCOPE_GLOBAL = 4, // globally routable IP address (all others)
|
|
IP_SCOPE_LINK_LOCAL = 5, // 169.254.x.x, IPv6 LL
|
|
IP_SCOPE_SHARED = 6, // currently unused, formerly used for carrier-grade NAT ranges
|
|
IP_SCOPE_PRIVATE = 7 // 10.x.x.x, 192.168.x.x, etc.
|
|
};
|
|
|
|
// Hasher for unordered sets and maps in C++11
|
|
struct Hasher { ZT_ALWAYS_INLINE std::size_t operator()(const InetAddress &a) const { return (std::size_t)a.hashCode(); } };
|
|
|
|
ZT_ALWAYS_INLINE InetAddress() { memoryZero(this); }
|
|
ZT_ALWAYS_INLINE InetAddress(const InetAddress &a) { memoryCopy(this,&a); }
|
|
explicit ZT_ALWAYS_INLINE InetAddress(const sockaddr_storage &ss) { *this = ss; }
|
|
explicit ZT_ALWAYS_INLINE InetAddress(const sockaddr_storage *ss) { *this = ss; }
|
|
explicit ZT_ALWAYS_INLINE InetAddress(const sockaddr &sa) { *this = sa; }
|
|
explicit ZT_ALWAYS_INLINE InetAddress(const sockaddr *sa) { *this = sa; }
|
|
explicit ZT_ALWAYS_INLINE InetAddress(const sockaddr_in &sa) { *this = sa; }
|
|
explicit ZT_ALWAYS_INLINE InetAddress(const sockaddr_in *sa) { *this = sa; }
|
|
explicit ZT_ALWAYS_INLINE InetAddress(const sockaddr_in6 &sa) { *this = sa; }
|
|
explicit ZT_ALWAYS_INLINE InetAddress(const sockaddr_in6 *sa) { *this = sa; }
|
|
ZT_ALWAYS_INLINE InetAddress(const void *ipBytes,unsigned int ipLen,unsigned int port) { this->set(ipBytes,ipLen,port); }
|
|
ZT_ALWAYS_INLINE InetAddress(const uint32_t ipv4,unsigned int port) { this->set(&ipv4,4,port); }
|
|
explicit ZT_ALWAYS_INLINE InetAddress(const char *ipSlashPort) { this->fromString(ipSlashPort); }
|
|
|
|
ZT_ALWAYS_INLINE void clear() { memoryZero(this); }
|
|
|
|
ZT_ALWAYS_INLINE InetAddress &operator=(const sockaddr_storage &ss)
|
|
{
|
|
memoryCopyUnsafe(this,&ss);
|
|
return *this;
|
|
}
|
|
ZT_ALWAYS_INLINE InetAddress &operator=(const sockaddr_storage *ss)
|
|
{
|
|
if (ss)
|
|
memoryCopyUnsafe(this,ss);
|
|
else memoryZero(this);
|
|
return *this;
|
|
}
|
|
ZT_ALWAYS_INLINE InetAddress &operator=(const sockaddr_in &sa)
|
|
{
|
|
copySockaddrToThis(&sa);
|
|
return *this;
|
|
}
|
|
ZT_ALWAYS_INLINE InetAddress &operator=(const sockaddr_in *sa)
|
|
{
|
|
if (sa)
|
|
copySockaddrToThis(sa);
|
|
else memset(reinterpret_cast<void *>(this),0,sizeof(InetAddress));
|
|
return *this;
|
|
}
|
|
ZT_ALWAYS_INLINE InetAddress &operator=(const sockaddr_in6 &sa)
|
|
{
|
|
copySockaddrToThis(&sa);
|
|
return *this;
|
|
}
|
|
ZT_ALWAYS_INLINE InetAddress &operator=(const sockaddr_in6 *sa)
|
|
{
|
|
if (sa)
|
|
copySockaddrToThis(sa);
|
|
else memset(reinterpret_cast<void *>(this),0,sizeof(InetAddress));
|
|
return *this;
|
|
}
|
|
ZT_ALWAYS_INLINE InetAddress &operator=(const sockaddr &sa)
|
|
{
|
|
if (sa.sa_family == AF_INET)
|
|
copySockaddrToThis(reinterpret_cast<const sockaddr_in *>(&sa));
|
|
else if (sa.sa_family == AF_INET6)
|
|
copySockaddrToThis(reinterpret_cast<const sockaddr_in6 *>(&sa));
|
|
else memset(reinterpret_cast<void *>(this),0,sizeof(InetAddress));
|
|
return *this;
|
|
}
|
|
ZT_ALWAYS_INLINE InetAddress &operator=(const sockaddr *sa)
|
|
{
|
|
if (sa) {
|
|
if (sa->sa_family == AF_INET)
|
|
copySockaddrToThis(reinterpret_cast<const sockaddr_in *>(sa));
|
|
else if (sa->sa_family == AF_INET6)
|
|
copySockaddrToThis(reinterpret_cast<const sockaddr_in6 *>(sa));
|
|
else memoryZero(this);
|
|
} else {
|
|
memoryZero(this);
|
|
}
|
|
return *this;
|
|
}
|
|
|
|
/**
|
|
* @return IP scope classification (e.g. loopback, link-local, private, global)
|
|
*/
|
|
IpScope ipScope() const;
|
|
|
|
/**
|
|
* Set from a raw IP and port number
|
|
*
|
|
* @param ipBytes Bytes of IP address in network byte order
|
|
* @param ipLen Length of IP address: 4 or 16
|
|
* @param port Port number or 0 for none
|
|
*/
|
|
void set(const void *ipBytes,unsigned int ipLen,unsigned int port);
|
|
|
|
/**
|
|
* Set the port component
|
|
*
|
|
* @param port Port, 0 to 65535
|
|
*/
|
|
ZT_ALWAYS_INLINE void setPort(unsigned int port)
|
|
{
|
|
switch(ss_family) {
|
|
case AF_INET:
|
|
reinterpret_cast<struct sockaddr_in *>(this)->sin_port = Utils::hton((uint16_t)port);
|
|
break;
|
|
case AF_INET6:
|
|
reinterpret_cast<struct sockaddr_in6 *>(this)->sin6_port = Utils::hton((uint16_t)port);
|
|
break;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @return True if this network/netmask route describes a default route (e.g. 0.0.0.0/0)
|
|
*/
|
|
ZT_ALWAYS_INLINE bool isDefaultRoute() const
|
|
{
|
|
switch(ss_family) {
|
|
case AF_INET:
|
|
return ( (reinterpret_cast<const struct sockaddr_in *>(this)->sin_addr.s_addr == 0) && (reinterpret_cast<const struct sockaddr_in *>(this)->sin_port == 0) );
|
|
case AF_INET6:
|
|
const uint8_t *ipb = reinterpret_cast<const uint8_t *>(reinterpret_cast<const struct sockaddr_in6 *>(this)->sin6_addr.s6_addr);
|
|
for(int i=0;i<16;++i) {
|
|
if (ipb[i])
|
|
return false;
|
|
}
|
|
return (reinterpret_cast<const struct sockaddr_in6 *>(this)->sin6_port == 0);
|
|
}
|
|
return false;
|
|
}
|
|
|
|
/**
|
|
* @return ASCII IP/port format representation
|
|
*/
|
|
char *toString(char buf[64]) const;
|
|
|
|
/**
|
|
* @return IP portion only, in ASCII string format
|
|
*/
|
|
char *toIpString(char buf[64]) const;
|
|
|
|
/**
|
|
* @param ipSlashPort IP/port (port is optional, will be 0 if not included)
|
|
* @return True if address appeared to be valid
|
|
*/
|
|
bool fromString(const char *ipSlashPort);
|
|
|
|
/**
|
|
* @return Port or 0 if no port component defined
|
|
*/
|
|
ZT_ALWAYS_INLINE unsigned int port() const
|
|
{
|
|
switch(ss_family) {
|
|
case AF_INET: return Utils::ntoh((uint16_t)(reinterpret_cast<const struct sockaddr_in *>(this)->sin_port));
|
|
case AF_INET6: return Utils::ntoh((uint16_t)(reinterpret_cast<const struct sockaddr_in6 *>(this)->sin6_port));
|
|
default: return 0;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Alias for port()
|
|
*
|
|
* This just aliases port() to make code more readable when netmask bits
|
|
* are stuffed there, as they are in Network, EthernetTap, and a few other
|
|
* spots.
|
|
*
|
|
* @return Netmask bits
|
|
*/
|
|
ZT_ALWAYS_INLINE unsigned int netmaskBits() const { return port(); }
|
|
|
|
/**
|
|
* @return True if netmask bits is valid for the address type
|
|
*/
|
|
ZT_ALWAYS_INLINE bool netmaskBitsValid() const
|
|
{
|
|
const unsigned int n = port();
|
|
switch(ss_family) {
|
|
case AF_INET: return (n <= 32);
|
|
case AF_INET6: return (n <= 128);
|
|
}
|
|
return false;
|
|
}
|
|
|
|
/**
|
|
* Alias for port()
|
|
*
|
|
* This just aliases port() because for gateways we use this field to
|
|
* store the gateway metric.
|
|
*
|
|
* @return Gateway metric
|
|
*/
|
|
ZT_ALWAYS_INLINE unsigned int metric() const { return port(); }
|
|
|
|
/**
|
|
* Construct a full netmask as an InetAddress
|
|
*
|
|
* @return Netmask such as 255.255.255.0 if this address is /24 (port field will be unchanged)
|
|
*/
|
|
InetAddress netmask() const;
|
|
|
|
/**
|
|
* Constructs a broadcast address from a network/netmask address
|
|
*
|
|
* This is only valid for IPv4 and will return a NULL InetAddress for other
|
|
* address families.
|
|
*
|
|
* @return Broadcast address (only IP portion is meaningful)
|
|
*/
|
|
InetAddress broadcast() const;
|
|
|
|
/**
|
|
* Return the network -- a.k.a. the IP ANDed with the netmask
|
|
*
|
|
* @return Network e.g. 10.0.1.0/24 from 10.0.1.200/24
|
|
*/
|
|
InetAddress network() const;
|
|
|
|
/**
|
|
* Test whether this IPv6 prefix matches the prefix of a given IPv6 address
|
|
*
|
|
* @param addr Address to check
|
|
* @return True if this IPv6 prefix matches the prefix of a given IPv6 address
|
|
*/
|
|
bool isEqualPrefix(const InetAddress &addr) const;
|
|
|
|
/**
|
|
* Test whether this IP/netmask contains this address
|
|
*
|
|
* @param addr Address to check
|
|
* @return True if this IP/netmask (route) contains this address
|
|
*/
|
|
bool containsAddress(const InetAddress &addr) const;
|
|
|
|
/**
|
|
* @return True if this is an IPv4 address
|
|
*/
|
|
ZT_ALWAYS_INLINE bool isV4() const { return (ss_family == AF_INET); }
|
|
|
|
/**
|
|
* @return True if this is an IPv6 address
|
|
*/
|
|
ZT_ALWAYS_INLINE bool isV6() const { return (ss_family == AF_INET6); }
|
|
|
|
/**
|
|
* @return pointer to raw address bytes or NULL if not available
|
|
*/
|
|
ZT_ALWAYS_INLINE const void *rawIpData() const
|
|
{
|
|
switch(ss_family) {
|
|
case AF_INET: return (const void *)&(reinterpret_cast<const struct sockaddr_in *>(this)->sin_addr.s_addr);
|
|
case AF_INET6: return (const void *)(reinterpret_cast<const struct sockaddr_in6 *>(this)->sin6_addr.s6_addr);
|
|
default: return nullptr;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @return InetAddress containing only the IP portion of this address and a zero port, or NULL if not IPv4 or IPv6
|
|
*/
|
|
ZT_ALWAYS_INLINE InetAddress ipOnly() const
|
|
{
|
|
InetAddress r;
|
|
switch(ss_family) {
|
|
case AF_INET:
|
|
r.ss_family = AF_INET;
|
|
reinterpret_cast<struct sockaddr_in *>(&r)->sin_addr.s_addr = reinterpret_cast<const struct sockaddr_in *>(this)->sin_addr.s_addr;
|
|
break;
|
|
case AF_INET6:
|
|
r.ss_family = AF_INET6;
|
|
memcpy(reinterpret_cast<struct sockaddr_in6 *>(&r)->sin6_addr.s6_addr,reinterpret_cast<const struct sockaddr_in6 *>(this)->sin6_addr.s6_addr,16);
|
|
break;
|
|
}
|
|
return r;
|
|
}
|
|
|
|
/**
|
|
* Performs an IP-only comparison or, if that is impossible, a memcmp()
|
|
*
|
|
* @param a InetAddress to compare again
|
|
* @return True if only IP portions are equal (false for non-IP or null addresses)
|
|
*/
|
|
ZT_ALWAYS_INLINE bool ipsEqual(const InetAddress &a) const
|
|
{
|
|
if (ss_family == a.ss_family) {
|
|
if (ss_family == AF_INET)
|
|
return (reinterpret_cast<const struct sockaddr_in *>(this)->sin_addr.s_addr == reinterpret_cast<const struct sockaddr_in *>(&a)->sin_addr.s_addr);
|
|
if (ss_family == AF_INET6)
|
|
return (memcmp(reinterpret_cast<const struct sockaddr_in6 *>(this)->sin6_addr.s6_addr,reinterpret_cast<const struct sockaddr_in6 *>(&a)->sin6_addr.s6_addr,16) == 0);
|
|
return (memcmp(this,&a,sizeof(InetAddress)) == 0);
|
|
}
|
|
return false;
|
|
}
|
|
|
|
/**
|
|
* Performs an IP-only comparison or, if that is impossible, a memcmp()
|
|
*
|
|
* This version compares only the first 64 bits of IPv6 addresses.
|
|
*
|
|
* @param a InetAddress to compare again
|
|
* @return True if only IP portions are equal (false for non-IP or null addresses)
|
|
*/
|
|
ZT_ALWAYS_INLINE bool ipsEqual2(const InetAddress &a) const
|
|
{
|
|
if (ss_family == a.ss_family) {
|
|
if (ss_family == AF_INET)
|
|
return (reinterpret_cast<const struct sockaddr_in *>(this)->sin_addr.s_addr == reinterpret_cast<const struct sockaddr_in *>(&a)->sin_addr.s_addr);
|
|
if (ss_family == AF_INET6)
|
|
return (memcmp(reinterpret_cast<const struct sockaddr_in6 *>(this)->sin6_addr.s6_addr,reinterpret_cast<const struct sockaddr_in6 *>(&a)->sin6_addr.s6_addr,8) == 0);
|
|
return (memcmp(this,&a,sizeof(InetAddress)) == 0);
|
|
}
|
|
return false;
|
|
}
|
|
|
|
ZT_ALWAYS_INLINE unsigned long hashCode() const
|
|
{
|
|
if (ss_family == AF_INET) {
|
|
return ((unsigned long)reinterpret_cast<const struct sockaddr_in *>(this)->sin_addr.s_addr + (unsigned long)reinterpret_cast<const struct sockaddr_in *>(this)->sin_port);
|
|
} else if (ss_family == AF_INET6) {
|
|
unsigned long tmp = reinterpret_cast<const struct sockaddr_in6 *>(this)->sin6_port;
|
|
const uint8_t *a = reinterpret_cast<const uint8_t *>(reinterpret_cast<const struct sockaddr_in6 *>(this)->sin6_addr.s6_addr);
|
|
for(long i=0;i<16;++i)
|
|
reinterpret_cast<uint8_t *>(&tmp)[i % sizeof(tmp)] ^= a[i];
|
|
return tmp;
|
|
} else {
|
|
unsigned long tmp = reinterpret_cast<const struct sockaddr_in6 *>(this)->sin6_port;
|
|
const uint8_t *a = reinterpret_cast<const uint8_t *>(this);
|
|
for(long i=0;i<(long)sizeof(InetAddress);++i)
|
|
reinterpret_cast<uint8_t *>(&tmp)[i % sizeof(tmp)] ^= a[i];
|
|
return tmp;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Fill out a ZT_TraceEventPathAddress from this InetAddress
|
|
*
|
|
* @param ta ZT_TraceEventPathAddress to fill
|
|
*/
|
|
ZT_ALWAYS_INLINE void forTrace(ZT_TraceEventPathAddress &ta) const
|
|
{
|
|
uint32_t tmp;
|
|
switch(ss_family) {
|
|
default:
|
|
memset(&ta,0,sizeof(ZT_TraceEventPathAddress));
|
|
break;
|
|
case AF_INET:
|
|
ta.type = ZT_TRACE_EVENT_PATH_TYPE_INETADDR_V4;
|
|
tmp = (uint32_t)(reinterpret_cast<const struct sockaddr_in *>(this)->sin_addr.s_addr);
|
|
ta.address[0] = reinterpret_cast<const uint8_t *>(&tmp)[0];
|
|
ta.address[1] = reinterpret_cast<const uint8_t *>(&tmp)[1];
|
|
ta.address[2] = reinterpret_cast<const uint8_t *>(&tmp)[2];
|
|
ta.address[3] = reinterpret_cast<const uint8_t *>(&tmp)[3];
|
|
memset(ta.address + 4,0,sizeof(ta.address) - 4);
|
|
ta.port = reinterpret_cast<const struct sockaddr_in *>(this)->sin_port;
|
|
break;
|
|
case AF_INET6:
|
|
ta.type = ZT_TRACE_EVENT_PATH_TYPE_INETADDR_V6;
|
|
memcpy(ta.address,reinterpret_cast<const struct sockaddr_in6 *>(this)->sin6_addr.s6_addr,16);
|
|
memset(ta.address + 16,0,sizeof(ta.address) - 16);
|
|
ta.port = reinterpret_cast<const struct sockaddr_in6 *>(this)->sin6_port;
|
|
break;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Check whether this is a network/route rather than an IP assignment
|
|
*
|
|
* A network is an IP/netmask where everything after the netmask is
|
|
* zero e.g. 10.0.0.0/8.
|
|
*
|
|
* @return True if everything after netmask bits is zero
|
|
*/
|
|
bool isNetwork() const;
|
|
|
|
/**
|
|
* @return 14-bit (0-16383) hash of this IP's first 24 or 48 bits (for V4 or V6) for rate limiting code, or 0 if non-IP
|
|
*/
|
|
ZT_ALWAYS_INLINE unsigned long rateGateHash() const
|
|
{
|
|
unsigned long h = 0;
|
|
switch(ss_family) {
|
|
case AF_INET:
|
|
h = (Utils::ntoh((uint32_t)reinterpret_cast<const struct sockaddr_in *>(this)->sin_addr.s_addr) & 0xffffff00U) >> 8U;
|
|
h ^= (h >> 14U);
|
|
break;
|
|
case AF_INET6: {
|
|
const uint8_t *ip = reinterpret_cast<const uint8_t *>(reinterpret_cast<const struct sockaddr_in6 *>(this)->sin6_addr.s6_addr);
|
|
h = ((unsigned long)ip[0]); h <<= 1U;
|
|
h += ((unsigned long)ip[1]); h <<= 1U;
|
|
h += ((unsigned long)ip[2]); h <<= 1U;
|
|
h += ((unsigned long)ip[3]); h <<= 1U;
|
|
h += ((unsigned long)ip[4]); h <<= 1U;
|
|
h += ((unsigned long)ip[5]);
|
|
} break;
|
|
}
|
|
return (h & 0x3fff);
|
|
}
|
|
|
|
/**
|
|
* @return True if address family is non-zero
|
|
*/
|
|
explicit ZT_ALWAYS_INLINE operator bool() const { return (ss_family != 0); }
|
|
|
|
static ZT_ALWAYS_INLINE int marshalSizeMax() { return ZT_INETADDRESS_MARSHAL_SIZE_MAX; }
|
|
int marshal(uint8_t data[ZT_INETADDRESS_MARSHAL_SIZE_MAX]) const;
|
|
int unmarshal(const uint8_t *restrict data,int len);
|
|
|
|
bool operator==(const InetAddress &a) const;
|
|
bool operator<(const InetAddress &a) const;
|
|
ZT_ALWAYS_INLINE bool operator!=(const InetAddress &a) const { return !(*this == a); }
|
|
ZT_ALWAYS_INLINE bool operator>(const InetAddress &a) const { return (a < *this); }
|
|
ZT_ALWAYS_INLINE bool operator<=(const InetAddress &a) const { return !(a < *this); }
|
|
ZT_ALWAYS_INLINE bool operator>=(const InetAddress &a) const { return !(*this < a); }
|
|
|
|
/**
|
|
* @param mac MAC address seed
|
|
* @return IPv6 link-local address
|
|
*/
|
|
static InetAddress makeIpv6LinkLocal(const MAC &mac);
|
|
|
|
/**
|
|
* Compute private IPv6 unicast address from network ID and ZeroTier address
|
|
*
|
|
* This generates a private unicast IPv6 address that is mostly compliant
|
|
* with the letter of RFC4193 and certainly compliant in spirit.
|
|
*
|
|
* RFC4193 specifies a format of:
|
|
*
|
|
* | 7 bits |1| 40 bits | 16 bits | 64 bits |
|
|
* | Prefix |L| Global ID | Subnet ID | Interface ID |
|
|
*
|
|
* The 'L' bit is set to 1, yielding an address beginning with 0xfd. Then
|
|
* the network ID is filled into the global ID, subnet ID, and first byte
|
|
* of the "interface ID" field. Since the first 40 bits of the network ID
|
|
* is the unique ZeroTier address of its controller, this makes a very
|
|
* good random global ID. Since network IDs have 24 more bits, we let it
|
|
* overflow into the interface ID.
|
|
*
|
|
* After that we pad with two bytes: 0x99, 0x93, namely the default ZeroTier
|
|
* port in hex.
|
|
*
|
|
* Finally we fill the remaining 40 bits of the interface ID field with
|
|
* the 40-bit unique ZeroTier device ID of the network member.
|
|
*
|
|
* This yields a valid RFC4193 address with a random global ID, a
|
|
* meaningful subnet ID, and a unique interface ID, all mappable back onto
|
|
* ZeroTier space.
|
|
*
|
|
* This in turn could allow us, on networks numbered this way, to emulate
|
|
* IPv6 NDP and eliminate all multicast. This could be beneficial for
|
|
* small devices and huge networks, e.g. IoT applications.
|
|
*
|
|
* The returned address is given an odd prefix length of /88, since within
|
|
* a given network only the last 40 bits (device ID) are variable. This
|
|
* is a bit unusual but as far as we know should not cause any problems with
|
|
* any non-braindead IPv6 stack.
|
|
*
|
|
* @param nwid 64-bit network ID
|
|
* @param zeroTierAddress 40-bit device address (in least significant 40 bits, highest 24 bits ignored)
|
|
* @return IPv6 private unicast address with /88 netmask
|
|
*/
|
|
static InetAddress makeIpv6rfc4193(uint64_t nwid,uint64_t zeroTierAddress);
|
|
|
|
/**
|
|
* Compute a private IPv6 "6plane" unicast address from network ID and ZeroTier address
|
|
*/
|
|
static InetAddress makeIpv66plane(uint64_t nwid,uint64_t zeroTierAddress);
|
|
};
|
|
|
|
static ZT_ALWAYS_INLINE InetAddress *asInetAddress(sockaddr_in *p) { return reinterpret_cast<InetAddress *>(p); }
|
|
static ZT_ALWAYS_INLINE InetAddress *asInetAddress(sockaddr_in6 *p) { return reinterpret_cast<InetAddress *>(p); }
|
|
static ZT_ALWAYS_INLINE InetAddress *asInetAddress(sockaddr *p) { return reinterpret_cast<InetAddress *>(p); }
|
|
static ZT_ALWAYS_INLINE InetAddress *asInetAddress(sockaddr_storage *p) { return reinterpret_cast<InetAddress *>(p); }
|
|
static ZT_ALWAYS_INLINE const InetAddress *asInetAddress(const sockaddr_in *p) { return reinterpret_cast<const InetAddress *>(p); }
|
|
static ZT_ALWAYS_INLINE const InetAddress *asInetAddress(const sockaddr_in6 *p) { return reinterpret_cast<const InetAddress *>(p); }
|
|
static ZT_ALWAYS_INLINE const InetAddress *asInetAddress(const sockaddr *p) { return reinterpret_cast<const InetAddress *>(p); }
|
|
static ZT_ALWAYS_INLINE const InetAddress *asInetAddress(const sockaddr_storage *p) { return reinterpret_cast<const InetAddress *>(p); }
|
|
static ZT_ALWAYS_INLINE InetAddress &asInetAddress(sockaddr_in &p) { return *reinterpret_cast<InetAddress *>(&p); }
|
|
static ZT_ALWAYS_INLINE InetAddress &asInetAddress(sockaddr_in6 &p) { return *reinterpret_cast<InetAddress *>(&p); }
|
|
static ZT_ALWAYS_INLINE InetAddress &asInetAddress(sockaddr &p) { return *reinterpret_cast<InetAddress *>(&p); }
|
|
static ZT_ALWAYS_INLINE InetAddress &asInetAddress(sockaddr_storage &p) { return *reinterpret_cast<InetAddress *>(&p); }
|
|
static ZT_ALWAYS_INLINE const InetAddress &asInetAddress(const sockaddr_in &p) { return *reinterpret_cast<const InetAddress *>(&p); }
|
|
static ZT_ALWAYS_INLINE const InetAddress &asInetAddress(const sockaddr_in6 &p) { return *reinterpret_cast<const InetAddress *>(&p); }
|
|
static ZT_ALWAYS_INLINE const InetAddress &asInetAddress(const sockaddr &p) { return *reinterpret_cast<const InetAddress *>(&p); }
|
|
static ZT_ALWAYS_INLINE const InetAddress &asInetAddress(const sockaddr_storage &p) { return *reinterpret_cast<const InetAddress *>(&p); }
|
|
|
|
} // namespace ZeroTier
|
|
|
|
#endif
|