quicsilver 0.4.0 → 0.5.0

data/ext/quicsilver/include/msquic_posix.h

@@ -0,0 +1,696 @@
+/*++
+
+    Copyright (c) Microsoft Corporation.
+    Licensed under the MIT License.
+
+Abstract:
+
+    This file contains the platform specific definitions for MsQuic structures
+    and error codes.
+
+Environment:
+
+    POSIX (Linux and macOS)
+
+--*/
+
+#ifdef _WIN32
+#pragma once
+#endif
+
+#ifndef _MSQUIC_POSIX_
+#define _MSQUIC_POSIX_
+
+#include <stdlib.h>
+#include <stdio.h>
+#include <stdint.h>
+#include <sys/types.h>
+#include <string.h>
+#include <assert.h>
+#include <inttypes.h>
+#include <stddef.h>
+#include <netdb.h>
+#include <netinet/ip.h>
+#include <unistd.h>
+#include <sys/socket.h>
+#include <arpa/inet.h>
+#include <netdb.h>
+#include <errno.h>
+#include "quic_sal_stub.h"
+
+#define QUIC_INLINE static inline
+
+#ifdef __cplusplus
+extern "C++" {
+template <size_t S> struct _ENUM_FLAG_INTEGER_FOR_SIZE;
+template <> struct _ENUM_FLAG_INTEGER_FOR_SIZE<1> {
+    typedef uint8_t type;
+};
+template <> struct _ENUM_FLAG_INTEGER_FOR_SIZE<2> {
+    typedef uint16_t type;
+};
+template <> struct _ENUM_FLAG_INTEGER_FOR_SIZE<4> {
+    typedef uint32_t type;
+};
+template <> struct _ENUM_FLAG_INTEGER_FOR_SIZE<8> {
+    typedef uint64_t type;
+};
+
+// used as an approximation of std::underlying_type<T>
+template <class T> struct _ENUM_FLAG_SIZED_INTEGER
+{
+    typedef typename _ENUM_FLAG_INTEGER_FOR_SIZE<sizeof(T)>::type type;
+};
+}
+
+#define DEFINE_ENUM_FLAG_OPERATORS(ENUMTYPE) \
+extern "C++" { \
+QUIC_INLINE ENUMTYPE operator | (ENUMTYPE a, ENUMTYPE b) throw() { return ENUMTYPE(((_ENUM_FLAG_SIZED_INTEGER<ENUMTYPE>::type)a) | ((_ENUM_FLAG_SIZED_INTEGER<ENUMTYPE>::type)b)); } \
+QUIC_INLINE ENUMTYPE &operator |= (ENUMTYPE &a, ENUMTYPE b) throw() { return (ENUMTYPE &)(((_ENUM_FLAG_SIZED_INTEGER<ENUMTYPE>::type &)a) |= ((_ENUM_FLAG_SIZED_INTEGER<ENUMTYPE>::type)b)); } \
+QUIC_INLINE ENUMTYPE operator & (ENUMTYPE a, ENUMTYPE b) throw() { return ENUMTYPE(((_ENUM_FLAG_SIZED_INTEGER<ENUMTYPE>::type)a) & ((_ENUM_FLAG_SIZED_INTEGER<ENUMTYPE>::type)b)); } \
+QUIC_INLINE ENUMTYPE &operator &= (ENUMTYPE &a, ENUMTYPE b) throw() { return (ENUMTYPE &)(((_ENUM_FLAG_SIZED_INTEGER<ENUMTYPE>::type &)a) &= ((_ENUM_FLAG_SIZED_INTEGER<ENUMTYPE>::type)b)); } \
+QUIC_INLINE ENUMTYPE operator ~ (ENUMTYPE a) throw() { return ENUMTYPE(~((_ENUM_FLAG_SIZED_INTEGER<ENUMTYPE>::type)a)); } \
+QUIC_INLINE ENUMTYPE operator ^ (ENUMTYPE a, ENUMTYPE b) throw() { return ENUMTYPE(((_ENUM_FLAG_SIZED_INTEGER<ENUMTYPE>::type)a) ^ ((_ENUM_FLAG_SIZED_INTEGER<ENUMTYPE>::type)b)); } \
+QUIC_INLINE ENUMTYPE &operator ^= (ENUMTYPE &a, ENUMTYPE b) throw() { return (ENUMTYPE &)(((_ENUM_FLAG_SIZED_INTEGER<ENUMTYPE>::type &)a) ^= ((_ENUM_FLAG_SIZED_INTEGER<ENUMTYPE>::type)b)); } \
+}
+#else
+#define DEFINE_ENUM_FLAG_OPERATORS(ENUMTYPE) // NOP, C allows these operators.
+#endif
+
+#define QUIC_API
+#define QUIC_MAIN_EXPORT
+#define QUIC_STATUS                     unsigned int
+#ifdef __cplusplus
+#define QUIC_FAILED(X)                  (static_cast<int>(X) > 0)
+#define QUIC_SUCCEEDED(X)               (static_cast<int>(X) <= 0)
+#else
+#define QUIC_FAILED(X)                  ((int)(X) > 0)
+#define QUIC_SUCCEEDED(X)               ((int)(X) <= 0)
+#endif // __cplusplus
+
+//
+// The type of an error code generated by the system is mostly 'int'. In most
+// situations, we use the value of a system-generated error code as the value
+// of QUIC_STATUS. In some situations, we use a custom value for QUIC_STATUS.
+// In order to ensure that custom values don't conflict with system-generated
+// values, the custom values are all kept outside the range of any possible
+// 'int' value. There are static asserts to ensure that QUIC_STATUS type is
+// large enough for this purpose.
+//
+
+#ifndef ESTRPIPE // undefined on macOS
+#define ESTRPIPE 86
+#endif // ESTRPIPE
+
+#ifndef ENOKEY // undefined om macOS
+#define ENOKEY 126
+#endif // ENOKEY
+
+#define ERROR_BASE                          200000000                       // 0xBEBC200
+#define TLS_ERROR_BASE                      256 + ERROR_BASE                // 0xBEBC300
+#define CERT_ERROR_BASE                     512 + ERROR_BASE                // 0xBEBC400
+
+#ifdef __cplusplus
+#define QUIC_STATUS_DEF(x) (static_cast<QUIC_STATUS>(x))
+#else
+#define QUIC_STATUS_DEF(x) ((QUIC_STATUS)(x))
+#endif
+
+#define QUIC_STATUS_SUCCESS                 QUIC_STATUS_DEF(0)               // 0
+#define QUIC_STATUS_PENDING                 QUIC_STATUS_DEF(-2)              // -2
+#define QUIC_STATUS_CONTINUE                QUIC_STATUS_DEF(-1)              // -1
+#define QUIC_STATUS_OUT_OF_MEMORY           QUIC_STATUS_DEF(ENOMEM)          // 12
+#define QUIC_STATUS_INVALID_PARAMETER       QUIC_STATUS_DEF(EINVAL)          // 22
+#define QUIC_STATUS_INVALID_STATE           QUIC_STATUS_DEF(EPERM)           // 1
+#define QUIC_STATUS_NOT_SUPPORTED           QUIC_STATUS_DEF(EOPNOTSUPP)      // 95   (102 on macOS)
+#define QUIC_STATUS_NOT_FOUND               QUIC_STATUS_DEF(ENOENT)          // 2
+#define QUIC_STATUS_FILE_NOT_FOUND          QUIC_STATUS_NOT_FOUND            // 2
+#define QUIC_STATUS_BUFFER_TOO_SMALL        QUIC_STATUS_DEF(EOVERFLOW)       // 75   (84 on macOS)
+#define QUIC_STATUS_HANDSHAKE_FAILURE       QUIC_STATUS_DEF(ECONNABORTED)    // 103  (53 on macOS)
+#define QUIC_STATUS_ABORTED                 QUIC_STATUS_DEF(ECANCELED)       // 125  (89 on macOS)
+#define QUIC_STATUS_ADDRESS_IN_USE          QUIC_STATUS_DEF(EADDRINUSE)      // 98   (48 on macOS)
+#define QUIC_STATUS_INVALID_ADDRESS         QUIC_STATUS_DEF(EAFNOSUPPORT)    // 97   (47 on macOS)
+#define QUIC_STATUS_CONNECTION_TIMEOUT      QUIC_STATUS_DEF(ETIMEDOUT)       // 110  (60 on macOS)
+#define QUIC_STATUS_CONNECTION_IDLE         QUIC_STATUS_DEF(ETIME)           // 62   (101 on macOS)
+#define QUIC_STATUS_INTERNAL_ERROR          QUIC_STATUS_DEF(EIO)             // 5
+#define QUIC_STATUS_CONNECTION_REFUSED      QUIC_STATUS_DEF(ECONNREFUSED)    // 111  (61 on macOS)
+#define QUIC_STATUS_PROTOCOL_ERROR          QUIC_STATUS_DEF(EPROTO)          // 71   (100 on macOS)
+#define QUIC_STATUS_VER_NEG_ERROR           QUIC_STATUS_DEF(EPROTONOSUPPORT) // 93   (43 on macOS)
+#define QUIC_STATUS_UNREACHABLE             QUIC_STATUS_DEF(EHOSTUNREACH)    // 113  (65 on macOS)
+#define QUIC_STATUS_TLS_ERROR               QUIC_STATUS_DEF(ENOKEY)          // 126
+#define QUIC_STATUS_USER_CANCELED           QUIC_STATUS_DEF(EOWNERDEAD)      // 130  (105 on macOS)
+#define QUIC_STATUS_ALPN_NEG_FAILURE        QUIC_STATUS_DEF(ENOPROTOOPT)     // 92   (42 on macOS)
+#define QUIC_STATUS_STREAM_LIMIT_REACHED    QUIC_STATUS_DEF(ESTRPIPE)        // 86
+#define QUIC_STATUS_ALPN_IN_USE             QUIC_STATUS_DEF(EPROTOTYPE)      // 91   (41 on macOS)
+#define QUIC_STATUS_ADDRESS_NOT_AVAILABLE   QUIC_STATUS_DEF(EADDRNOTAVAIL)   // 99   (47 on macOS)
+
+#define QUIC_STATUS_TLS_ALERT(Alert)        QUIC_STATUS_DEF((0xff & Alert)+ TLS_ERROR_BASE)
+
+#define QUIC_STATUS_CLOSE_NOTIFY            QUIC_STATUS_TLS_ALERT(0)        // 0xBEBC300 - Close notify
+#define QUIC_STATUS_BAD_CERTIFICATE         QUIC_STATUS_TLS_ALERT(42)       // 0xBEBC32A - Bad Certificate
+#define QUIC_STATUS_UNSUPPORTED_CERTIFICATE QUIC_STATUS_TLS_ALERT(43)       // 0xBEBC32B - Unsupported Certficiate
+#define QUIC_STATUS_REVOKED_CERTIFICATE     QUIC_STATUS_TLS_ALERT(44)       // 0xBEBC32C - Revoked Certificate
+#define QUIC_STATUS_EXPIRED_CERTIFICATE     QUIC_STATUS_TLS_ALERT(45)       // 0xBEBC32D - Expired Certificate
+#define QUIC_STATUS_UNKNOWN_CERTIFICATE     QUIC_STATUS_TLS_ALERT(46)       // 0xBEBC32E - Unknown Certificate
+#define QUIC_STATUS_REQUIRED_CERTIFICATE    QUIC_STATUS_TLS_ALERT(116)      // 0xBEBC374 - Required Certificate
+
+#define QUIC_STATUS_CERT_ERROR(Val)         QUIC_STATUS_DEF(Val + CERT_ERROR_BASE)
+
+#define QUIC_STATUS_CERT_EXPIRED            QUIC_STATUS_CERT_ERROR(1)       // 0xBEBC401
+#define QUIC_STATUS_CERT_UNTRUSTED_ROOT     QUIC_STATUS_CERT_ERROR(2)       // 0xBEBC402
+#define QUIC_STATUS_CERT_NO_CERT            QUIC_STATUS_CERT_ERROR(3)       // 0xBEBC403
+
+typedef unsigned char BOOLEAN;
+typedef struct in_addr IN_ADDR;
+typedef struct in6_addr IN6_ADDR;
+typedef struct addrinfo ADDRINFO;
+typedef sa_family_t QUIC_ADDRESS_FAMILY;
+
+#define QUIC_ADDRESS_FAMILY_UNSPEC AF_UNSPEC
+#define QUIC_ADDRESS_FAMILY_INET AF_INET
+#define QUIC_ADDRESS_FAMILY_INET6 AF_INET6
+
+typedef union QUIC_ADDR {
+    struct sockaddr Ip;
+    struct sockaddr_in Ipv4;
+    struct sockaddr_in6 Ipv6;
+} QUIC_ADDR;
+
+#ifndef RTL_FIELD_SIZE
+#define RTL_FIELD_SIZE(type, field)     (sizeof(((type *)0)->field))
+#endif
+
+#define FIELD_OFFSET(type, field)       offsetof(type, field)
+
+#define QUIC_ADDR_V4_PORT_OFFSET        FIELD_OFFSET(struct sockaddr_in, sin_port)
+#define QUIC_ADDR_V4_IP_OFFSET          FIELD_OFFSET(struct sockaddr_in, sin_addr)
+
+#define QUIC_ADDR_V6_PORT_OFFSET        FIELD_OFFSET(struct sockaddr_in6, sin6_port)
+#define QUIC_ADDR_V6_IP_OFFSET          FIELD_OFFSET(struct sockaddr_in6, sin6_addr)
+
+#ifndef FALSE
+#define FALSE 0
+#define TRUE 1
+#endif
+
+#define INITCODE
+#define PAGEDX
+#define QUIC_CACHEALIGN
+
+#if defined(__cplusplus)
+extern "C" {
+#endif
+
+#if defined(CX_PLATFORM_DARWIN)
+#define QUIC_LOCALHOST_FOR_AF(Af) ("localhost")
+#else
+#define QUIC_LOCALHOST_FOR_AF(Af) ((Af == QUIC_ADDRESS_FAMILY_INET) ? "localhost" : "ip6-localhost")
+#endif
+
+#define QUIC_CERTIFICATE_FLAG_IGNORE_REVOCATION                 0x00000080
+#define QUIC_CERTIFICATE_FLAG_IGNORE_UNKNOWN_CA                 0x00000100
+#define QUIC_CERTIFICATE_FLAG_IGNORE_WRONG_USAGE                0x00000200
+#define QUIC_CERTIFICATE_FLAG_IGNORE_CERTIFICATE_CN_INVALID     0x00001000 // bad common name in X509 Cert.
+#define QUIC_CERTIFICATE_FLAG_IGNORE_CERTIFICATE_DATE_INVALID   0x00002000 // expired X509 Cert.
+#define QUIC_CERTIFICATE_FLAG_IGNORE_WEAK_SIGNATURE             0x00010000
+
+#if defined(__clang__)
+#define QUIC_NO_SANITIZE(X) __attribute__((no_sanitize(X)))
+#else
+#define QUIC_NO_SANITIZE(X)
+#endif
+
+//
+// Helpers for Windows string functions.
+//
+
+#define _strnicmp strncasecmp
+#define sprintf_s(dst, dst_len, format, ...) snprintf(dst, dst_len, format, __VA_ARGS__)
+#define _vsnprintf_s(dst, dst_len, flag, format, ...) vsnprintf(dst, dst_len, format, __VA_ARGS__)
+
+//
+// IP Address Abstraction Helpers
+//
+
+QUIC_INLINE
+BOOLEAN
+QuicAddrFamilyIsValid(
+    _In_ QUIC_ADDRESS_FAMILY Family
+    )
+{
+    return
+        Family == QUIC_ADDRESS_FAMILY_UNSPEC ||
+        Family == QUIC_ADDRESS_FAMILY_INET ||
+        Family == QUIC_ADDRESS_FAMILY_INET6;
+}
+
+QUIC_INLINE
+BOOLEAN
+QuicAddrIsValid(
+    _In_ const QUIC_ADDR* const Addr
+    )
+{
+    return QuicAddrFamilyIsValid(Addr->Ip.sa_family);
+}
+
+QUIC_INLINE
+BOOLEAN
+QuicAddrCompareIp(
+    _In_ const QUIC_ADDR* const Addr1,
+    _In_ const QUIC_ADDR* const Addr2
+    )
+{
+    if (QUIC_ADDRESS_FAMILY_INET == Addr1->Ip.sa_family) {
+        return memcmp(&Addr1->Ipv4.sin_addr, &Addr2->Ipv4.sin_addr, sizeof(IN_ADDR)) == 0;
+    } else {
+        return memcmp(&Addr1->Ipv6.sin6_addr, &Addr2->Ipv6.sin6_addr, sizeof(IN6_ADDR)) == 0;
+    }
+}
+
+QUIC_INLINE
+BOOLEAN
+QuicAddrCompare(
+    _In_ const QUIC_ADDR* const Addr1,
+    _In_ const QUIC_ADDR* const Addr2
+    )
+{
+    if (Addr1->Ip.sa_family != Addr2->Ip.sa_family ||
+        Addr1->Ipv4.sin_port != Addr2->Ipv4.sin_port) {
+        return FALSE;
+    }
+
+    if (QUIC_ADDRESS_FAMILY_INET == Addr1->Ip.sa_family) {
+        return memcmp(&Addr1->Ipv4.sin_addr, &Addr2->Ipv4.sin_addr, sizeof(IN_ADDR)) == 0;
+    } else {
+        return memcmp(&Addr1->Ipv6.sin6_addr, &Addr2->Ipv6.sin6_addr, sizeof(IN6_ADDR)) == 0;
+    }
+}
+
+QUIC_INLINE
+QUIC_ADDRESS_FAMILY
+QuicAddrGetFamily(
+    _In_ const QUIC_ADDR* const Addr
+    )
+{
+    return Addr->Ip.sa_family;
+}
+
+QUIC_INLINE
+void
+QuicAddrSetFamily(
+    _In_ QUIC_ADDR* Addr,
+    _In_ QUIC_ADDRESS_FAMILY Family
+    )
+{
+    Addr->Ip.sa_family = Family;
+}
+
+QUIC_INLINE
+uint16_t
+QuicAddrGetPort(
+    _In_ const QUIC_ADDR* const Addr
+    )
+{
+    if (QUIC_ADDRESS_FAMILY_INET == Addr->Ip.sa_family) {
+        return ntohs(Addr->Ipv4.sin_port);
+    } else {
+        return ntohs(Addr->Ipv6.sin6_port);
+    }
+}
+
+QUIC_INLINE
+void
+QuicAddrSetPort(
+    _Out_ QUIC_ADDR* Addr,
+    _In_ uint16_t Port
+    )
+{
+    if (QUIC_ADDRESS_FAMILY_INET == Addr->Ip.sa_family) {
+        Addr->Ipv4.sin_port = htons(Port);
+    } else {
+        Addr->Ipv6.sin6_port = htons(Port);
+    }
+}
+
+//
+// Test only API to increment the IP address value.
+//
+QUIC_INLINE
+void
+QuicAddrIncrement(
+    _Inout_ QUIC_ADDR* Addr
+    )
+{
+    if (Addr->Ip.sa_family == QUIC_ADDRESS_FAMILY_INET) {
+        ((uint8_t*)&Addr->Ipv4.sin_addr)[3]++;
+    } else {
+        ((uint8_t*)&Addr->Ipv6.sin6_addr)[15]++;
+    }
+}
+
+QUIC_INLINE
+void
+QuicAddrSetToLoopback(
+    _Inout_ QUIC_ADDR* Addr
+    )
+{
+    if (Addr->Ip.sa_family == QUIC_ADDRESS_FAMILY_INET) {
+        Addr->Ipv4.sin_addr.s_addr = htonl(INADDR_LOOPBACK);
+    } else {
+        Addr->Ipv6.sin6_addr = in6addr_loopback;
+    }
+}
+
+QUIC_INLINE
+uint32_t
+QUIC_NO_SANITIZE("unsigned-integer-overflow")
+QuicAddrHash(
+    _In_ const QUIC_ADDR* Addr
+    )
+{
+    uint32_t Hash = 5387; // A random prime number.
+#define UPDATE_HASH(byte) Hash = ((Hash << 5) - Hash) + (byte)
+    if (Addr->Ip.sa_family == QUIC_ADDRESS_FAMILY_INET) {
+        UPDATE_HASH(Addr->Ipv4.sin_port & 0xFF);
+        UPDATE_HASH(Addr->Ipv4.sin_port >> 8);
+        for (uint8_t i = 0; i < sizeof(Addr->Ipv4.sin_addr); ++i) {
+            UPDATE_HASH(((uint8_t*)&Addr->Ipv4.sin_addr)[i]);
+        }
+    } else {
+        UPDATE_HASH(Addr->Ipv6.sin6_port & 0xFF);
+        UPDATE_HASH(Addr->Ipv6.sin6_port >> 8);
+        for (uint8_t i = 0; i < sizeof(Addr->Ipv6.sin6_addr); ++i) {
+            UPDATE_HASH(((uint8_t*)&Addr->Ipv6.sin6_addr)[i]);
+        }
+    }
+    return Hash;
+}
+
+QUIC_INLINE
+BOOLEAN
+QuicAddrIsWildCard(
+    _In_ const QUIC_ADDR* const Addr
+    )
+{
+    if (Addr->Ip.sa_family == QUIC_ADDRESS_FAMILY_UNSPEC) {
+        return TRUE;
+    } else if (Addr->Ip.sa_family == QUIC_ADDRESS_FAMILY_INET) {
+        const IN_ADDR ZeroAddr = {0};
+        return memcmp(&Addr->Ipv4.sin_addr.s_addr, &ZeroAddr, sizeof(IN_ADDR)) == 0;
+    } else {
+        const IN6_ADDR ZeroAddr = {0};
+        return memcmp(&Addr->Ipv6.sin6_addr, &ZeroAddr, sizeof(IN6_ADDR)) == 0;
+    }
+}
+
+QUIC_INLINE
+BOOLEAN
+QuicAddr4FromString(
+    _In_z_ const char* AddrStr,
+    _Out_ QUIC_ADDR* Addr
+    )
+{
+    if (AddrStr[0] == '[') {
+        return FALSE;
+    }
+
+    const char* PortStart = strchr(AddrStr, ':');
+    if (PortStart != NULL) {
+        if (strchr(PortStart+1, ':') != NULL) {
+            return FALSE;
+        }
+
+        char TmpAddrStr[16];
+        size_t AddrLength = PortStart - AddrStr;
+        if (AddrLength >= sizeof(TmpAddrStr)) {
+            return FALSE;
+        }
+        memcpy(TmpAddrStr, AddrStr, AddrLength);
+        TmpAddrStr[AddrLength] = '\0';
+
+        if (inet_pton(AF_INET, TmpAddrStr, &Addr->Ipv4.sin_addr) != 1) {
+            return FALSE;
+        }
+        Addr->Ipv4.sin_port = htons(atoi(PortStart+1));
+    } else {
+        if (inet_pton(AF_INET, AddrStr, &Addr->Ipv4.sin_addr) != 1) {
+            return FALSE;
+        }
+    }
+    Addr->Ip.sa_family = QUIC_ADDRESS_FAMILY_INET;
+    return TRUE;
+}
+
+QUIC_INLINE
+BOOLEAN
+QuicAddr6FromString(
+    _In_z_ const char* AddrStr,
+    _Out_ QUIC_ADDR* Addr
+    )
+{
+    char TmpAddrStr[64];
+    if (AddrStr[0] == '[') {
+        const char* BracketEnd = strchr(AddrStr, ']');
+        if (BracketEnd == NULL || *(BracketEnd+1) != ':') {
+            return FALSE;
+        }
+
+        const size_t AddrLength = BracketEnd - AddrStr - 1;
+        if (AddrLength >= sizeof(TmpAddrStr)) {
+            return FALSE;
+        }
+        memcpy(TmpAddrStr, AddrStr + 1, AddrLength);
+        TmpAddrStr[AddrLength] = '\0';
+        Addr->Ipv6.sin6_port = htons(atoi(BracketEnd+2));
+    } else {
+        const size_t AddrLength = strlen(AddrStr);
+        if (AddrLength >= sizeof(TmpAddrStr)) {
+            return FALSE;
+        }
+        //
+        // Copy the string including the null terminator.
+        //
+        memcpy(TmpAddrStr, AddrStr, AddrLength + 1);
+    }
+
+    Addr->Ipv6.sin6_scope_id = 0;
+    char* ScopeStart = strchr(TmpAddrStr, '%');
+    if (ScopeStart != NULL) {
+        *ScopeStart++ = '\0';
+        if (*ScopeStart == '\0') {
+            return FALSE;
+        }
+        do {
+            if (*ScopeStart < '0' || *ScopeStart > '9' ||
+                Addr->Ipv6.sin6_scope_id > (UINT32_MAX - (*ScopeStart - '0')) / 10) {
+                return FALSE;
+            }
+            Addr->Ipv6.sin6_scope_id =
+                Addr->Ipv6.sin6_scope_id * 10 + (uint32_t)(*ScopeStart++ - '0');
+        } while (*ScopeStart != '\0');
+    }
+
+    if (inet_pton(AF_INET6, TmpAddrStr, &Addr->Ipv6.sin6_addr) != 1) {
+        return FALSE;
+    }
+    Addr->Ip.sa_family = QUIC_ADDRESS_FAMILY_INET6;
+    return TRUE;
+}
+
+QUIC_INLINE
+BOOLEAN
+QuicAddrFromString(
+    _In_z_ const char* AddrStr,
+    _In_ uint16_t Port, // Host byte order
+    _Out_ QUIC_ADDR* Addr
+    )
+{
+    Addr->Ipv4.sin_port = htons(Port);
+    return
+        QuicAddr4FromString(AddrStr, Addr) ||
+        QuicAddr6FromString(AddrStr, Addr);
+}
+
+typedef int QUIC_XDP_MAP_HANDLE;
+
+QUIC_INLINE
+BOOLEAN
+CxPlatIsIpLiteral(
+    _In_z_ const char* AddrStr
+    )
+{
+    IN_ADDR Ipv4Addr = {0};
+    IN6_ADDR Ipv6Addr = {0};
+    return
+        inet_pton(AF_INET, AddrStr, &Ipv4Addr) == 1 ||
+        inet_pton(AF_INET6, AddrStr, &Ipv6Addr) == 1;
+}
+
+//
+// Represents an IP address and (optionally) port number as a string.
+//
+typedef struct QUIC_ADDR_STR {
+    char Address[65];
+} QUIC_ADDR_STR;
+
+//
+// Formats only the IP literal, excluding the port and IPv6 brackets. For
+// example, an IPv6 address with port 443 is formatted as "2001:db8::1".
+//
+QUIC_INLINE
+BOOLEAN
+QuicAddrIpToString(
+    _In_ const QUIC_ADDR* Addr,
+    _Out_ QUIC_ADDR_STR* AddrStr
+    )
+{
+    const void* IpAddress;
+    AddrStr->Address[0] = '\0';
+    if (Addr->Ip.sa_family == QUIC_ADDRESS_FAMILY_INET) {
+        IpAddress = &Addr->Ipv4.sin_addr;
+    } else if (Addr->Ip.sa_family == QUIC_ADDRESS_FAMILY_INET6) {
+        IpAddress = &Addr->Ipv6.sin6_addr;
+    } else {
+        return FALSE;
+    }
+    return
+        inet_ntop(
+            Addr->Ip.sa_family,
+            IpAddress,
+            AddrStr->Address,
+            sizeof(AddrStr->Address)) != NULL;
+}
+
+//
+// Formats the complete endpoint, including a nonzero port and the brackets
+// required around IPv6 when a port is present. For example, an IPv6 address
+// with port 443 is formatted as "[2001:db8::1]:443".
+//
+QUIC_INLINE
+BOOLEAN
+QuicAddrToString(
+    _In_ const QUIC_ADDR* Addr,
+    _Out_ QUIC_ADDR_STR* AddrStr
+    )
+{
+    size_t AvailSpace = sizeof(AddrStr->Address);
+    char* Address = AddrStr->Address;
+    if (Addr->Ip.sa_family == QUIC_ADDRESS_FAMILY_INET6 && Addr->Ipv6.sin6_port != 0) {
+        Address[0] = '[';
+        Address++;
+        AvailSpace--;
+    }
+    if (inet_ntop(
+            Addr->Ip.sa_family == QUIC_ADDRESS_FAMILY_INET ? AF_INET : AF_INET6,
+            Addr->Ip.sa_family == QUIC_ADDRESS_FAMILY_INET ? (void*)&Addr->Ipv4.sin_addr : (void*)&Addr->Ipv6.sin6_addr,
+            Address,
+            AvailSpace) == NULL) {
+        return FALSE;
+    }
+    if (Addr->Ipv4.sin_port != 0) {
+        Address += strlen(Address);
+        if (Addr->Ip.sa_family == QUIC_ADDRESS_FAMILY_INET6) {
+            Address[0] = ']';
+            Address++;
+        }
+        AvailSpace = sizeof(AddrStr->Address) - (Address - AddrStr->Address);
+        snprintf(Address, AvailSpace, ":%hu", ntohs(Addr->Ipv4.sin_port));
+    }
+    return TRUE;
+}
+
+//
+// Event Queue Abstraction
+//
+
+#if __linux__
+
+//
+// TODO: build on other 64-bit architectures
+//
+#if CXPLAT_USE_IO_URING && (defined(__x86_64__) || defined(__aarch64__)) // liburing
+#define LIBURING_INTERNAL
+
+#if defined(__cplusplus)
+extern "C++" {
+#endif
+#include <liburing.h>
+#if defined(__cplusplus)
+} // extern "C++"
+#endif
+
+typedef struct CXPLAT_EVENTQ QUIC_EVENTQ;
+typedef struct io_uring_cqe* CXPLAT_CQE;
+typedef
+_IRQL_requires_max_(PASSIVE_LEVEL)
+void
+(CXPLAT_EVENT_COMPLETION)(
+    _In_ CXPLAT_CQE* Cqe
+    );
+typedef CXPLAT_EVENT_COMPLETION *CXPLAT_EVENT_COMPLETION_HANDLER;
+#define CXPLAT_USE_EVENT_BATCH_COMPLETION
+typedef
+_IRQL_requires_max_(PASSIVE_LEVEL)
+void
+(CXPLAT_EVENT_BATCH_COMPLETION)(
+    _Inout_ CXPLAT_CQE** Cqes,
+    _Inout_ uint32_t* Count
+    );
+typedef CXPLAT_EVENT_BATCH_COMPLETION *CXPLAT_EVENT_BATCH_COMPLETION_HANDLER;
+typedef struct CXPLAT_SQE QUIC_SQE;
+
+#else // epoll
+
+#include <sys/epoll.h>
+#include <sys/eventfd.h>
+
+typedef int QUIC_EVENTQ;
+
+typedef struct epoll_event QUIC_CQE;
+
+typedef
+void
+(QUIC_EVENT_COMPLETION)(
+    _In_ QUIC_CQE* Cqe
+    );
+typedef QUIC_EVENT_COMPLETION *QUIC_EVENT_COMPLETION_HANDLER;
+
+typedef struct QUIC_SQE {
+    int fd;
+    QUIC_EVENT_COMPLETION_HANDLER Completion;
+} QUIC_SQE;
+
+#endif // epoll
+
+#elif __APPLE__ || __FreeBSD__ // kqueue
+
+#include <sys/event.h>
+#include <fcntl.h>
+
+typedef int QUIC_EVENTQ;
+
+typedef struct kevent QUIC_CQE;
+
+typedef
+void
+(QUIC_EVENT_COMPLETION)(
+    _In_ QUIC_CQE* Cqe
+    );
+typedef QUIC_EVENT_COMPLETION *QUIC_EVENT_COMPLETION_HANDLER;
+
+typedef struct QUIC_SQE {
+    uintptr_t Handle;
+    QUIC_EVENT_COMPLETION_HANDLER Completion;
+} QUIC_SQE;
+
+#else
+
+#error Unsupported Platform
+
+#endif
+
+#if defined(__cplusplus)
+}
+#endif
+
+#endif