/*++ Copyright (c) Microsoft Corporation. All rights reserved. Module Name: mstcpip.h Abstract: This module contains Microsoft-specific extensions to the core Winsock definitions. Environment: user mode or kernel mode --*/ #ifndef _MSTCPIP_ #define _MSTCPIP_ #if _MSC_VER > 1000 #pragma once #endif #ifdef __cplusplus extern "C" { #endif #pragma warning(push) #pragma warning(disable:4200) #pragma warning(disable:4201) #ifdef _PREFAST_ #pragma prefast(push) #pragma prefast(disable: 24002, "Requires explicit use of IPv4 address types.") #endif #ifndef ASSERT #define MSTCPIP_ASSERT_UNDEFINED #define ASSERT(exp) ((VOID) 0) #endif #ifdef _MSC_VER #define MSTCPIP_INLINE __inline #else #define MSTCPIP_INLINE extern inline /* GNU style */ #endif #include /* Argument structure for SIO_KEEPALIVE_VALS */ struct tcp_keepalive { ULONG onoff; ULONG keepalivetime; ULONG keepaliveinterval; }; // // New WSAIoctl Options // #define SIO_RCVALL _WSAIOW(IOC_VENDOR,1) #define SIO_RCVALL_MCAST _WSAIOW(IOC_VENDOR,2) #define SIO_RCVALL_IGMPMCAST _WSAIOW(IOC_VENDOR,3) #define SIO_KEEPALIVE_VALS _WSAIOW(IOC_VENDOR,4) #define SIO_ABSORB_RTRALERT _WSAIOW(IOC_VENDOR,5) #define SIO_UCAST_IF _WSAIOW(IOC_VENDOR,6) #define SIO_LIMIT_BROADCASTS _WSAIOW(IOC_VENDOR,7) #define SIO_INDEX_BIND _WSAIOW(IOC_VENDOR,8) #define SIO_INDEX_MCASTIF _WSAIOW(IOC_VENDOR,9) #define SIO_INDEX_ADD_MCAST _WSAIOW(IOC_VENDOR,10) #define SIO_INDEX_DEL_MCAST _WSAIOW(IOC_VENDOR,11) // SIO_UDP_CONNRESET _WSAIOW(IOC_VENDOR,12) #define SIO_RCVALL_MCAST_IF _WSAIOW(IOC_VENDOR,13) #define SIO_RCVALL_IF _WSAIOW(IOC_VENDOR,14) // // Values for use with SIO_RCVALL* options // typedef enum { RCVALL_OFF = 0, RCVALL_ON = 1, RCVALL_SOCKETLEVELONLY = 2, RCVALL_IPLEVEL = 3, } RCVALL_VALUE, *PRCVALL_VALUE; #define RCVALL_MAX RCVALL_IPLEVEL typedef struct { RCVALL_VALUE Mode; ULONG Interface; } RCVALL_IF, *PRCVALL_IF; // // TCP/UDP port management definitions. // #define SIO_ACQUIRE_PORT_RESERVATION _WSAIOW(IOC_VENDOR, 100) #define SIO_RELEASE_PORT_RESERVATION _WSAIOW(IOC_VENDOR, 101) #define SIO_ASSOCIATE_PORT_RESERVATION _WSAIOW(IOC_VENDOR, 102) typedef struct _INET_PORT_RANGE { USHORT StartPort; USHORT NumberOfPorts; } INET_PORT_RANGE, *PINET_PORT_RANGE; typedef struct _INET_PORT_RANGE INET_PORT_RESERVATION, *PINET_PORT_RESERVATION; typedef struct { ULONG64 Token; } INET_PORT_RESERVATION_TOKEN, *PINET_PORT_RESERVATION_TOKEN; #define INVALID_PORT_RESERVATION_TOKEN ((ULONG64)0) typedef struct { #ifdef __cplusplus INET_PORT_RESERVATION Reservation; INET_PORT_RESERVATION_TOKEN Token; #else INET_PORT_RESERVATION; INET_PORT_RESERVATION_TOKEN; #endif } INET_PORT_RESERVATION_INSTANCE, *PINET_PORT_RESERVATION_INSTANCE; typedef struct { ULONG AssignmentCount; ULONG OwningPid; } INET_PORT_RESERVATION_INFORMATION, *PINET_PORT_RESERVATION_INFORMATION; #ifdef _WS2DEF_ #if (NTDDI_VERSION >= NTDDI_LONGHORN) #define _SECURE_SOCKET_TYPES_DEFINED_ // // Secure socket API type definitions. // #define SIO_SET_SECURITY _WSAIOW(IOC_VENDOR, 200) #define SIO_QUERY_SECURITY _WSAIORW(IOC_VENDOR, 201) #define SIO_SET_PEER_TARGET_NAME _WSAIOW(IOC_VENDOR, 202) #define SIO_DELETE_PEER_TARGET_NAME _WSAIOW(IOC_VENDOR, 203) // Type of security protocol typedef enum _SOCKET_SECURITY_PROTOCOL { SOCKET_SECURITY_PROTOCOL_DEFAULT, SOCKET_SECURITY_PROTOCOL_IPSEC, SOCKET_SECURITY_PROTOCOL_INVALID } SOCKET_SECURITY_PROTOCOL; // Flags for generic security settings #define SOCKET_SETTINGS_GUARANTEE_ENCRYPTION 0x1 #define SOCKET_SETTINGS_ALLOW_INSECURE 0x2 // Common security settings for the socket typedef struct _SOCKET_SECURITY_SETTINGS { SOCKET_SECURITY_PROTOCOL SecurityProtocol; ULONG SecurityFlags; } SOCKET_SECURITY_SETTINGS; // Flags specific to IPsec security settings. // NOTE: these flags must be specified under the // SOCKET_SECURITY_SETTINGS_IPSEC->IpsecFlags field. #define SOCKET_SETTINGS_IPSEC_SKIP_FILTER_INSTANTIATION 0x1 // IPsec specific security settings for the socket. typedef struct _SOCKET_SECURITY_SETTINGS_IPSEC { SOCKET_SECURITY_PROTOCOL SecurityProtocol; ULONG SecurityFlags; ULONG IpsecFlags; GUID AuthipMMPolicyKey; GUID AuthipQMPolicyKey; GUID Reserved; UINT64 Reserved2; ULONG UserNameStringLen; ULONG DomainNameStringLen; ULONG PasswordStringLen; wchar_t AllStrings[0]; } SOCKET_SECURITY_SETTINGS_IPSEC; // Common peer target name for the socket typedef struct _SOCKET_PEER_TARGET_NAME { SOCKET_SECURITY_PROTOCOL SecurityProtocol; SOCKADDR_STORAGE PeerAddress; ULONG PeerTargetNameStringLen; wchar_t AllStrings[0]; } SOCKET_PEER_TARGET_NAME; // Input for querying socket security typedef struct _SOCKET_SECURITY_QUERY_TEMPLATE { SOCKET_SECURITY_PROTOCOL SecurityProtocol; SOCKADDR_STORAGE PeerAddress; ULONG PeerTokenAccessMask; } SOCKET_SECURITY_QUERY_TEMPLATE; // Flags corresponding to the security query info #define SOCKET_INFO_CONNECTION_SECURED 0x1 #define SOCKET_INFO_CONNECTION_ENCRYPTED 0x2 // Common security query information from a socket typedef struct _SOCKET_SECURITY_QUERY_INFO { SOCKET_SECURITY_PROTOCOL SecurityProtocol; ULONG Flags; UINT64 PeerApplicationAccessTokenHandle; UINT64 PeerMachineAccessTokenHandle; } SOCKET_SECURITY_QUERY_INFO; // // Scalability type definitions // #define SIO_QUERY_RSS_SCALABILITY_INFO _WSAIOR(IOC_VENDOR, 210) // Scalability info for the transport typedef struct _RSS_SCALABILITY_INFO { BOOLEAN RssEnabled; } RSS_SCALABILITY_INFO, *PRSS_SCALABILITY_INFO; #endif // (NTDDI_VERSION >= NTDDI_LONGHORN) // // Microsoft-specific IPv4 definitions. // #define IN4_CLASSA(i) (((LONG)(i) & 0x00000080) == 0) #define IN4_CLASSB(i) (((LONG)(i) & 0x000000c0) == 0x00000080) #define IN4_CLASSC(i) (((LONG)(i) & 0x000000e0) == 0x000000c0) #define IN4_CLASSD(i) (((LONG)(i) & 0x000000f0) == 0x000000e0) #define IN4_MULTICAST(i) IN4_CLASSD(i) #define IN4ADDR_ANY INADDR_ANY #define IN4ADDR_LOOPBACK 0x0100007f #define IN4ADDR_BROADCAST INADDR_BROADCAST #define IN4ADDR_NONE INADDR_NONE #define IN4ADDR_ANY_INIT { 0 } #define IN4ADDR_LOOPBACK_INIT { 0x7f, 0, 0, 1 } #define IN4ADDR_BROADCAST_INIT { 0xff, 0xff, 0xff, 0xff } #define IN4ADDR_ALLNODESONLINK_INIT { 0xe0, 0, 0, 1 } #define IN4ADDR_ALLROUTERSONLINK_INIT { 0xe0, 0, 0, 2 } #define IN4ADDR_ALLIGMPV3ROUTERSONLINK_INIT { 0xe0, 0, 0, 0x16 } #define IN4ADDR_ALLTEREDONODESONLINK_INIT { 0xe0, 0, 0, 0xfd } #define IN4ADDR_LINKLOCALPREFIX_INIT { 0xa9, 0xfe, } #define IN4ADDR_MULTICASTPREFIX_INIT { 0xe0, } #define IN4ADDR_LOOPBACKPREFIX_LENGTH 8 #define IN4ADDR_LINKLOCALPREFIX_LENGTH 16 #define IN4ADDR_MULTICASTPREFIX_LENGTH 4 #if (NTDDI_VERSION >= NTDDI_WIN2KSP1) MSTCPIP_INLINE BOOLEAN IN4_ADDR_EQUAL(CONST IN_ADDR *a, CONST IN_ADDR *b) { return (BOOLEAN)(a->s_addr == b->s_addr); } MSTCPIP_INLINE BOOLEAN IN4_UNALIGNED_ADDR_EQUAL(CONST IN_ADDR UNALIGNED *a, CONST IN_ADDR UNALIGNED *b) { return (BOOLEAN)(a->s_addr == b->s_addr); } MSTCPIP_INLINE BOOLEAN IN4_IS_ADDR_UNSPECIFIED(CONST IN_ADDR *a) { return (BOOLEAN)(a->s_addr == IN4ADDR_ANY); } MSTCPIP_INLINE BOOLEAN IN4_IS_UNALIGNED_ADDR_UNSPECIFIED(CONST IN_ADDR UNALIGNED *a) { return (BOOLEAN)(a->s_addr == IN4ADDR_ANY); } MSTCPIP_INLINE BOOLEAN IN4_IS_ADDR_LOOPBACK(CONST IN_ADDR *a) { return (BOOLEAN)(*((PUCHAR) a) == 0x7f); // 127/8 } MSTCPIP_INLINE BOOLEAN IN4_IS_UNALIGNED_ADDR_LOOPBACK(CONST IN_ADDR UNALIGNED *a) { return (BOOLEAN)(*((PUCHAR) a) == 0x7f); // 127/8 } MSTCPIP_INLINE BOOLEAN IN4_IS_ADDR_BROADCAST(CONST IN_ADDR *a) { return (BOOLEAN)(a->s_addr == IN4ADDR_BROADCAST); } MSTCPIP_INLINE BOOLEAN IN4_IS_UNALIGNED_ADDR_BROADCAST(CONST IN_ADDR UNALIGNED *a) { return (BOOLEAN)(a->s_addr == IN4ADDR_BROADCAST); } MSTCPIP_INLINE BOOLEAN IN4_IS_ADDR_MULTICAST(CONST IN_ADDR *a) { return (BOOLEAN)IN4_MULTICAST(a->s_addr); } MSTCPIP_INLINE BOOLEAN IN4_IS_UNALIGNED_ADDR_MULTICAST(CONST IN_ADDR UNALIGNED *a) { return (BOOLEAN)IN4_MULTICAST(a->s_addr); } MSTCPIP_INLINE BOOLEAN IN4_IS_ADDR_LINKLOCAL(CONST IN_ADDR *a) { return (BOOLEAN)((a->s_addr & 0xffff) == 0xfea9); // 169.254/16 } MSTCPIP_INLINE BOOLEAN IN4_IS_UNALIGNED_ADDR_LINKLOCAL(CONST IN_ADDR UNALIGNED *a) { return (BOOLEAN)((a->s_addr & 0xffff) == 0xfea9); // 169.254/16 } MSTCPIP_INLINE BOOLEAN IN4_IS_ADDR_SITELOCAL(CONST IN_ADDR *a) { // // For existing scenarios (e.g. ICS) to work as expected, RFC-1918 prefixes // are deemed to be global scoped. When appropriate, site border routers // must explicitly filter packets with these addresses. // UNREFERENCED_PARAMETER(a); return FALSE; } #define IN4_IS_UNALIGNED_ADDR_SITELOCAL IN4_IS_ADDR_SITELOCAL MSTCPIP_INLINE BOOLEAN IN4_IS_ADDR_RFC1918(CONST IN_ADDR *a) { return (BOOLEAN)(((a->s_addr & 0x00ff) == 0x0a) || // 10/8 ((a->s_addr & 0xf0ff) == 0x10ac) || // 172.16/12 ((a->s_addr & 0xffff) == 0xa8c0)); // 192.168/16 } MSTCPIP_INLINE BOOLEAN IN4_IS_UNALIGNED_ADDR_RFC1918(CONST IN_ADDR UNALIGNED *a) { IN_ADDR Ipv4Address = *a; return IN4_IS_ADDR_RFC1918(&Ipv4Address); } MSTCPIP_INLINE BOOLEAN IN4_IS_ADDR_MC_LINKLOCAL(CONST IN_ADDR *a) { return (BOOLEAN)((a->s_addr & 0xffffff) == 0xe0); // 224.0.0/24 } MSTCPIP_INLINE BOOLEAN IN4_IS_ADDR_MC_ADMINLOCAL(CONST IN_ADDR *a) { return (BOOLEAN)((a->s_addr & 0xffff) == 0xffef); // 239.255/16 } MSTCPIP_INLINE BOOLEAN IN4_IS_ADDR_MC_SITELOCAL(CONST IN_ADDR *a) { return (BOOLEAN)((a->s_addr & 0xff) == 0xef) && !IN4_IS_ADDR_MC_ADMINLOCAL(a); } MSTCPIP_INLINE VOID IN4ADDR_SETSOCKADDR(PSOCKADDR_IN a, CONST IN_ADDR *addr, USHORT port) { a->sin_family = AF_INET; a->sin_port = port; a->sin_addr = *addr; memset(a->sin_zero, 0, sizeof(a->sin_zero)); } MSTCPIP_INLINE VOID IN4ADDR_SETANY(PSOCKADDR_IN a) { a->sin_family = AF_INET; a->sin_port = 0; a->sin_addr.s_addr = IN4ADDR_ANY; memset(a->sin_zero, 0, sizeof(a->sin_zero)); } MSTCPIP_INLINE VOID IN4ADDR_SETLOOPBACK(PSOCKADDR_IN a) { a->sin_family = AF_INET; a->sin_port = 0; a->sin_addr.s_addr = IN4ADDR_LOOPBACK; memset(a->sin_zero, 0, sizeof(a->sin_zero)); } MSTCPIP_INLINE BOOLEAN IN4ADDR_ISANY(CONST SOCKADDR_IN *a) { ASSERT(a->sin_family == AF_INET); return IN4_IS_ADDR_UNSPECIFIED(&a->sin_addr); } MSTCPIP_INLINE BOOLEAN IN4ADDR_ISLOOPBACK(CONST SOCKADDR_IN *a) { ASSERT(a->sin_family == AF_INET); return IN4_IS_ADDR_LOOPBACK(&a->sin_addr); } MSTCPIP_INLINE SCOPE_ID IN4ADDR_SCOPE_ID(CONST SOCKADDR_IN *a) { SCOPE_ID UnspecifiedScopeId = {0}; UNREFERENCED_PARAMETER(a); return UnspecifiedScopeId; } MSTCPIP_INLINE BOOLEAN IN4ADDR_ISEQUAL(CONST SOCKADDR_IN *a, CONST SOCKADDR_IN *b) { ASSERT(a->sin_family == AF_INET); return (BOOLEAN)(IN4ADDR_SCOPE_ID(a).Value == IN4ADDR_SCOPE_ID(b).Value && IN4_ADDR_EQUAL(&a->sin_addr, &b->sin_addr)); } MSTCPIP_INLINE BOOLEAN IN4ADDR_ISUNSPECIFIED(CONST SOCKADDR_IN *a) { ASSERT(a->sin_family == AF_INET); return (BOOLEAN)(IN4ADDR_SCOPE_ID(a).Value == 0 && IN4_IS_ADDR_UNSPECIFIED(&a->sin_addr)); } #define INET_IS_ALIGNED(Pointer, Type) \ (((ULONG_PTR)Pointer & (__builtin_alignof(Type)-1)) == 0) MSTCPIP_INLINE SCOPE_LEVEL Ipv4UnicastAddressScope( IN CONST UCHAR *Address ) /*++ Routine Description: Determines the scope of an IPv4 unicast address. For existing scenarios (e.g. ICS) to work as expected, RFC-1918 prefixes are deemed to be global scoped. When appropriate, site border routers must explicitly filter packets with these addresses. Arguments: Address - Supplies the IPv4 unicast address. Return Value: Returns the scope level of the address. Caller IRQL: May be called at PASSIVE through DISPATCH level. --*/ { IN_ADDR Ipv4Address; if (!INET_IS_ALIGNED(Address, IN_ADDR)) { Ipv4Address = *(CONST IN_ADDR UNALIGNED *)Address; Address = (CONST UCHAR *) &Ipv4Address; } if (IN4_IS_ADDR_LINKLOCAL((PIN_ADDR) Address) || IN4_IS_ADDR_LOOPBACK((PIN_ADDR) Address)) { return ScopeLevelLink; } return ScopeLevelGlobal; } MSTCPIP_INLINE SCOPE_LEVEL Ipv4MulticastAddressScope( IN CONST UCHAR *Address ) /*++ Routine Description: Determines the scope of an IPv4 multicast address. See RFC 2365. Arguments: Address - Supplies the IPv4 multicast address. Return Value: Returns the scope level of the multicast address. Caller IRQL: May be called at PASSIVE through DISPATCH level. --*/ { IN_ADDR Ipv4Address; if (!INET_IS_ALIGNED(Address, IN_ADDR)) { Ipv4Address = *(CONST IN_ADDR UNALIGNED *)Address; Address = (CONST UCHAR *) &Ipv4Address; } if (IN4_IS_ADDR_MC_LINKLOCAL((PIN_ADDR) Address)) { return ScopeLevelLink; } else if (IN4_IS_ADDR_MC_ADMINLOCAL((PIN_ADDR) Address)) { return ScopeLevelAdmin; } else if (IN4_IS_ADDR_MC_SITELOCAL((PIN_ADDR) Address)) { return ScopeLevelSite; } else { return ScopeLevelGlobal; } } MSTCPIP_INLINE SCOPE_LEVEL Ipv4AddressScope( IN CONST UCHAR *Address ) /*++ Routine Description: Examines an IPv4 address and determines its scope. Arguments: Address - Supplies the address to test. Return Value: Returns the scope level of the address. Caller IRQL: May be called at PASSIVE through DISPATCH level. --*/ { IN CONST IN_ADDR Ipv4Address = *(CONST IN_ADDR UNALIGNED *)Address; if (IN4_IS_ADDR_BROADCAST(&Ipv4Address)) { return ScopeLevelLink; } else if (IN4_IS_ADDR_MULTICAST(&Ipv4Address)) { return Ipv4MulticastAddressScope((UCHAR *) &Ipv4Address); } else { return Ipv4UnicastAddressScope((UCHAR *) &Ipv4Address); } } MSTCPIP_INLINE NL_ADDRESS_TYPE Ipv4AddressType( IN CONST UCHAR *Address ) { IN_ADDR Ipv4Address = *(CONST IN_ADDR UNALIGNED *) Address; if (IN4_IS_ADDR_MULTICAST(&Ipv4Address)) { return NlatMulticast; } if (IN4_IS_ADDR_BROADCAST(&Ipv4Address)) { return NlatBroadcast; } if (IN4_IS_ADDR_UNSPECIFIED(&Ipv4Address)) { return NlatUnspecified; } if (((Ipv4Address.s_addr & 0x000000ff) == 0) || ((Ipv4Address.s_addr & 0x000000f0) == 240)) { // // Following prefixes are invalid: // 1. 0.0.0.0/8 (except 0.0.0.0/32). // 2. 240.0.0.0/4 (except 255.255.255.255/32). // return NlatInvalid; } // // Loopback and anycast addresses are treated as unicast. // return NlatUnicast; } MSTCPIP_INLINE VOID IN4_UNCANONICALIZE_SCOPE_ID( IN CONST IN_ADDR *Address, IN OUT SCOPE_ID *ScopeId ) { SCOPE_LEVEL ScopeLevel = Ipv4AddressScope((CONST UCHAR *)Address); if ((IN4_IS_ADDR_LOOPBACK(Address)) || (ScopeLevel == ScopeLevelGlobal)) { ScopeId->Value = 0; } if ((SCOPE_LEVEL)ScopeId->Level == ScopeLevel) { ScopeId->Level = 0; } } MSTCPIP_INLINE BOOLEAN IN4_IS_ADDR_6TO4ELIGIBLE(CONST IN_ADDR *a) { return (BOOLEAN)((Ipv4AddressType((CONST UCHAR *) a) == NlatUnicast) && !(IN4_IS_ADDR_LOOPBACK(a) || IN4_IS_ADDR_LINKLOCAL(a) || IN4_IS_ADDR_SITELOCAL(a) || IN4_IS_ADDR_RFC1918(a))); } MSTCPIP_INLINE BOOLEAN IN4_IS_UNALIGNED_ADDR_6TO4ELIGIBLE(CONST IN_ADDR UNALIGNED *a) { IN_ADDR Ipv4Address = *a; return IN4_IS_ADDR_6TO4ELIGIBLE(&Ipv4Address); } #endif // _WS2DEF_ // // Microsoft-specific IPv6 definitions. // #ifdef _WS2IPDEF_ MSTCPIP_INLINE BOOLEAN IN6_PREFIX_EQUAL(CONST IN6_ADDR *a, CONST IN6_ADDR *b, UINT8 len) { UINT8 Bytes = len / 8; UINT8 Bits = len % 8; UINT8 Mask = 0xff << (8 - Bits); ASSERT(len <= (sizeof(IN6_ADDR) * 8)); return (BOOLEAN) (((memcmp(a, b, Bytes)) == 0) && ((Bits == 0) || ((a->s6_bytes[Bytes] | Mask) == (b->s6_bytes[Bytes] | Mask)))); } MSTCPIP_INLINE BOOLEAN IN6_IS_ADDR_ALLNODESONNODE(CONST IN6_ADDR *a) { return IN6_ADDR_EQUAL(a, &in6addr_allnodesonnode); } MSTCPIP_INLINE BOOLEAN IN6_IS_ADDR_ALLNODESONLINK(CONST IN6_ADDR *a) { return IN6_ADDR_EQUAL(a, &in6addr_allnodesonlink); } MSTCPIP_INLINE BOOLEAN IN6_IS_ADDR_ALLROUTERSONLINK(CONST IN6_ADDR *a) { return IN6_ADDR_EQUAL(a, &in6addr_allroutersonlink); } MSTCPIP_INLINE BOOLEAN IN6_IS_ADDR_SOLICITEDNODE(CONST IN6_ADDR *a) { return IN6_PREFIX_EQUAL( a, &in6addr_solicitednodemulticastprefix, IN6ADDR_SOLICITEDNODEMULTICASTPREFIX_LENGTH); } MSTCPIP_INLINE BOOLEAN IN6_IS_ADDR_ISATAP(CONST IN6_ADDR *a) { // // Disregard the u/g bit and compare the first byte of the interface id. // return (BOOLEAN)(((a->s6_words[4] & 0xfffd) == 0x0000) && (a->s6_words[5] == 0xfe5e)); } MSTCPIP_INLINE BOOLEAN IN6_IS_ADDR_6TO4(CONST IN6_ADDR *a) { C_ASSERT(IN6ADDR_6TO4PREFIX_LENGTH == RTL_BITS_OF(USHORT)); return (BOOLEAN)(a->s6_words[0] == in6addr_6to4prefix.s6_words[0]); } MSTCPIP_INLINE BOOLEAN IN6_IS_ADDR_TEREDO(CONST IN6_ADDR *a) { C_ASSERT(IN6ADDR_TEREDOPREFIX_LENGTH == 2 * RTL_BITS_OF(USHORT)); return (BOOLEAN)((a->s6_words[0] == in6addr_teredoprefix.s6_words[0]) && (a->s6_words[1] == in6addr_teredoprefix.s6_words[1])); } MSTCPIP_INLINE BOOLEAN IN6ADDR_ISV4MAPPED(CONST SOCKADDR_IN6 *a) { ASSERT(a->sin6_family == AF_INET6); return IN6_IS_ADDR_V4MAPPED(&a->sin6_addr); } MSTCPIP_INLINE BOOLEAN IN6ADDR_ISISATAP(CONST SOCKADDR_IN6 *a) { ASSERT(a->sin6_family == AF_INET6); return IN6_IS_ADDR_ISATAP(&a->sin6_addr); } MSTCPIP_INLINE BOOLEAN IN6ADDR_IS6TO4(CONST SOCKADDR_IN6 *a) { ASSERT(a->sin6_family == AF_INET6); return IN6_IS_ADDR_6TO4(&a->sin6_addr); } MSTCPIP_INLINE BOOLEAN IN6ADDR_ISTEREDO(CONST SOCKADDR_IN6 *a) { ASSERT(a->sin6_family == AF_INET6); return IN6_IS_ADDR_TEREDO(&a->sin6_addr); } MSTCPIP_INLINE CONST UCHAR* IN6_GET_ADDR_V4MAPPED(CONST IN6_ADDR *Ipv6Address) { return (CONST UCHAR *) (Ipv6Address->s6_words + 6); } MSTCPIP_INLINE CONST UCHAR* IN6_GET_ADDR_V4COMPAT(CONST IN6_ADDR *Ipv6Address) { return (CONST UCHAR *) (Ipv6Address->s6_words + 6); } MSTCPIP_INLINE CONST UCHAR* IN6_EXTRACT_V4ADDR_FROM_ISATAP(CONST IN6_ADDR *Ipv6Address) { return (CONST UCHAR *) (Ipv6Address->s6_words + 6); } MSTCPIP_INLINE CONST UCHAR* IN6_EXTRACT_V4ADDR_FROM_6TO4(CONST IN6_ADDR *Ipv6Address) { return (CONST UCHAR *) (Ipv6Address->s6_words + 1); } MSTCPIP_INLINE VOID IN6_SET_ADDR_V4MAPPED(PIN6_ADDR a6, CONST IN_ADDR* a4) { *a6 = in6addr_v4mappedprefix; a6->s6_bytes[12] = ((CONST UCHAR *) a4)[0]; a6->s6_bytes[13] = ((CONST UCHAR *) a4)[1]; a6->s6_bytes[14] = ((CONST UCHAR *) a4)[2]; a6->s6_bytes[15] = ((CONST UCHAR *) a4)[3]; } MSTCPIP_INLINE VOID IN6_SET_ADDR_V4COMPAT(PIN6_ADDR a6, CONST IN_ADDR* a4) { *a6 = in6addr_any; a6->s6_bytes[12] = ((CONST UCHAR *) a4)[0]; a6->s6_bytes[13] = ((CONST UCHAR *) a4)[1]; a6->s6_bytes[14] = ((CONST UCHAR *) a4)[2]; a6->s6_bytes[15] = ((CONST UCHAR *) a4)[3]; } MSTCPIP_INLINE VOID IN6_SET_ADDR_SOLICITEDNODE(PIN6_ADDR Multicast, CONST IN6_ADDR *Unicast) { *Multicast = in6addr_solicitednodemulticastprefix; Multicast->s6_bytes[13] = Unicast->s6_bytes[13]; Multicast->s6_bytes[14] = Unicast->s6_bytes[14]; Multicast->s6_bytes[15] = Unicast->s6_bytes[15]; } MSTCPIP_INLINE VOID IN6_SET_ISATAP_IDENTIFIER(IN6_ADDR *Ipv6Address, CONST IN_ADDR *Ipv4Address) { if (IN4_IS_ADDR_6TO4ELIGIBLE(Ipv4Address)) { Ipv6Address->s6_words[4] = 0x0002; } else { Ipv6Address->s6_words[4] = 0x0000; } // // 24-bit IANA OUI 00-00-5E and the 8-bit hex value 0xFE. // See section 6.1 of RFC 4214. // Ipv6Address->s6_words[5] = 0xFE5E; *((UNALIGNED IN_ADDR *) (Ipv6Address->s6_words + 6)) = *Ipv4Address; } MSTCPIP_INLINE VOID IN6_SET_6TO4_PREFIX(IN6_ADDR *Ipv6Address, CONST IN_ADDR *Ipv4Address) { Ipv6Address->s6_words[0] = 0x0220; *((UNALIGNED IN_ADDR *) (Ipv6Address->s6_words + 1)) = *Ipv4Address; Ipv6Address->s6_words[3] = 0x0000; } MSTCPIP_INLINE SCOPE_LEVEL Ipv6UnicastAddressScope( IN CONST UCHAR *Address ) /*++ Routine Description: Examines a unicast address and determines its scope. Note that v4-compatible and 6to4 addresses are deemed to have global scope; it is not legal to derive them from non IN4_IS_ADDR_6TO4ELIGIBLE addresses (IPv4 loopback, link-local, site-local, and RFC-1918 addresses). Arguments: Address - Supplies an IPv6 unicast address. Return Value: Returns the scope level of the address. Caller IRQL: May be called at PASSIVE through DISPATCH level. --*/ { IN6_ADDR Ipv6Address; if (!INET_IS_ALIGNED(Address, IN6_ADDR)) { Ipv6Address = *(CONST IN6_ADDR UNALIGNED *)Address; Address = (CONST UCHAR *) &Ipv6Address; } if (IN6_IS_ADDR_LINKLOCAL((PIN6_ADDR) Address) || IN6_IS_ADDR_LOOPBACK((PIN6_ADDR) Address)) { return ScopeLevelLink; } else if (IN6_IS_ADDR_SITELOCAL((PIN6_ADDR) Address)) { return ScopeLevelSite; } else { return ScopeLevelGlobal; } } MSTCPIP_INLINE SCOPE_LEVEL IN6_MULTICAST_SCOPE( IN CONST UCHAR *Address ) { PIN6_ADDR Ipv6Address = (PIN6_ADDR) Address; return (SCOPE_LEVEL)(Ipv6Address->s6_bytes[1] & 0xf); } MSTCPIP_INLINE SCOPE_LEVEL Ipv6AddressScope( IN CONST UCHAR *Address ) /*++ Routine Description: Examines an IPv6 address and determines its scope. Arguments: Address - Supplies an IPv6 address. Return Value: Returns the scope level of the address. Caller IRQL: May be called at PASSIVE through DISPATCH level. --*/ { if (IN6_IS_ADDR_MULTICAST((CONST IN6_ADDR *) Address)) { return IN6_MULTICAST_SCOPE(Address); } else { return Ipv6UnicastAddressScope(Address); } } MSTCPIP_INLINE NL_ADDRESS_TYPE Ipv6AddressType( IN CONST UCHAR *Address ) { CONST IN6_ADDR *Ipv6Address = (CONST IN6_ADDR *) Address; CONST UCHAR *Ipv4Address; if (IN6_IS_ADDR_MULTICAST(Ipv6Address)) { return NlatMulticast; } if (IN6_IS_ADDR_UNSPECIFIED(Ipv6Address)) { return NlatUnspecified; } // // Extract embedded IPv4 address, if any. // if (IN6_IS_ADDR_ISATAP(Ipv6Address) || IN6_IS_ADDR_V4COMPAT(Ipv6Address) || IN6_IS_ADDR_V4MAPPED(Ipv6Address) || IN6_IS_ADDR_V4TRANSLATED(Ipv6Address)) { Ipv4Address = IN6_EXTRACT_V4ADDR_FROM_ISATAP(Ipv6Address); } else if (IN6_IS_ADDR_6TO4(Ipv6Address)) { Ipv4Address = IN6_EXTRACT_V4ADDR_FROM_6TO4(Ipv6Address); } else { // // Anycast and loopback addresses are treated unicast address. // return NlatUnicast; } // // Ensure that the embedded IPv4 address is unicast. // if (Ipv4AddressType(Ipv4Address) != NlatUnicast) { return NlatInvalid; } return NlatUnicast; } MSTCPIP_INLINE VOID IN6_UNCANONICALIZE_SCOPE_ID( IN CONST IN6_ADDR *Address, IN OUT SCOPE_ID *ScopeId ) { SCOPE_LEVEL ScopeLevel = Ipv6AddressScope((CONST UCHAR *)Address); if ((IN6_IS_ADDR_LOOPBACK(Address)) || (ScopeLevel == ScopeLevelGlobal)) { ScopeId->Value = 0; } if ((SCOPE_LEVEL)ScopeId->Level == ScopeLevel) { ScopeId->Level = 0; } } #if (NTDDI_VERSION >= NTDDI_LONGHORN) MSTCPIP_INLINE VOID IN6ADDR_SETSOCKADDR(PSOCKADDR_IN6 a, CONST IN6_ADDR *addr, SCOPE_ID scope, USHORT port) { a->sin6_family = AF_INET6; a->sin6_port = port; a->sin6_flowinfo = 0; RtlCopyMemory(&a->sin6_addr, addr, sizeof(IN6_ADDR)); a->sin6_scope_struct = scope; IN6_UNCANONICALIZE_SCOPE_ID(&a->sin6_addr, &a->sin6_scope_struct); } MSTCPIP_INLINE VOID IN6ADDR_SETV4MAPPED(PSOCKADDR_IN6 a6, CONST IN_ADDR* a4, SCOPE_ID scope, USHORT port) { a6->sin6_family = AF_INET6; a6->sin6_port = port; a6->sin6_flowinfo = 0; IN6_SET_ADDR_V4MAPPED(&a6->sin6_addr, a4); a6->sin6_scope_struct = scope; IN4_UNCANONICALIZE_SCOPE_ID(a4, &a6->sin6_scope_struct); } #endif // // Define address-family-independent routines. // MSTCPIP_INLINE BOOLEAN INET_ADDR_EQUAL(ADDRESS_FAMILY af, CONST VOID* a, CONST VOID* b) { if (af == AF_INET6) { return IN6_ADDR_EQUAL((CONST IN6_ADDR*)a, (CONST IN6_ADDR*)b); } else { ASSERT(af == AF_INET); return IN4_ADDR_EQUAL((CONST IN_ADDR*)a, (CONST IN_ADDR*)b); } } MSTCPIP_INLINE BOOLEAN INET_UNALIGNED_ADDR_EQUAL(ADDRESS_FAMILY af, CONST VOID* a, CONST VOID* b) { if (af == AF_INET6) { return IN6_ADDR_EQUAL((CONST IN6_ADDR*)a, (CONST IN6_ADDR*)b); } else { ASSERT(af == AF_INET); return IN4_UNALIGNED_ADDR_EQUAL((CONST IN_ADDR*)a, (CONST IN_ADDR*)b); } } MSTCPIP_INLINE BOOLEAN INET_IS_ADDR_UNSPECIFIED(ADDRESS_FAMILY af, CONST VOID* a) { if (af == AF_INET6) { return IN6_IS_ADDR_UNSPECIFIED((CONST IN6_ADDR*)a); } else { ASSERT(af == AF_INET); return IN4_IS_ADDR_UNSPECIFIED((CONST IN_ADDR*)a); } } MSTCPIP_INLINE BOOLEAN INET_IS_UNALIGNED_ADDR_UNSPECIFIED(ADDRESS_FAMILY af, CONST VOID* a) { if (af == AF_INET6) { return IN6_IS_ADDR_UNSPECIFIED((CONST IN6_ADDR*)a); } else { ASSERT(af == AF_INET); return IN4_IS_UNALIGNED_ADDR_UNSPECIFIED((CONST IN_ADDR UNALIGNED*)a); } } MSTCPIP_INLINE BOOLEAN INET_IS_ADDR_LOOPBACK(ADDRESS_FAMILY af, CONST VOID* a) { if (af == AF_INET6) { return IN6_IS_ADDR_LOOPBACK((CONST IN6_ADDR*)a); } else { ASSERT(af == AF_INET); return IN4_IS_ADDR_LOOPBACK((CONST IN_ADDR*)a); } } MSTCPIP_INLINE BOOLEAN INET_IS_ADDR_BROADCAST(ADDRESS_FAMILY af, CONST VOID* a) { if (af == AF_INET6) { return FALSE; } else { ASSERT(af == AF_INET); return IN4_IS_ADDR_BROADCAST((CONST IN_ADDR*)a); } } MSTCPIP_INLINE BOOLEAN INET_IS_ADDR_MULTICAST(ADDRESS_FAMILY af, CONST VOID* a) { if (af == AF_INET6) { return IN6_IS_ADDR_MULTICAST((CONST IN6_ADDR*)a); } else { ASSERT(af == AF_INET); return IN4_IS_ADDR_MULTICAST((CONST IN_ADDR*)a); } } MSTCPIP_INLINE CONST UCHAR* INET_ADDR_UNSPECIFIED(ADDRESS_FAMILY af) { if (af == AF_INET6) { return (CONST UCHAR*)&in6addr_any; } else { ASSERT(af == AF_INET); return (CONST UCHAR*)&in4addr_any; } } MSTCPIP_INLINE VOID INET_SET_ADDRESS(ADDRESS_FAMILY Family, PUCHAR Address, CONST UCHAR *Value) { if (Family == AF_INET6) { *((PIN6_ADDR)Address) = *((PIN6_ADDR)Value); } else { ASSERT(Family == AF_INET); *((PIN_ADDR)Address) = *((PIN_ADDR)Value); } } MSTCPIP_INLINE SIZE_T INET_ADDR_LENGTH(ADDRESS_FAMILY af) { if (af == AF_INET6) { return sizeof(IN6_ADDR); } else { ASSERT(af == AF_INET); return sizeof(IN_ADDR); } } MSTCPIP_INLINE SIZE_T INET_SOCKADDR_LENGTH(ADDRESS_FAMILY af) { if (af == AF_INET6) { return sizeof(SOCKADDR_IN6); } else { ASSERT(af == AF_INET); return sizeof(SOCKADDR_IN); } } #if (NTDDI_VERSION >= NTDDI_LONGHORN) MSTCPIP_INLINE VOID INETADDR_SETSOCKADDR(ADDRESS_FAMILY af, PSOCKADDR a, CONST VOID* addr, SCOPE_ID scope, USHORT port) { if (af == AF_INET6) { IN6ADDR_SETSOCKADDR( (PSOCKADDR_IN6) a, (CONST IN6_ADDR *) addr, scope, port); } else { CONST IN_ADDR addr4 = *((IN_ADDR UNALIGNED *) addr); ASSERT(af == AF_INET); IN4ADDR_SETSOCKADDR( (PSOCKADDR_IN) a, (CONST IN_ADDR *) &addr4, port); } } #endif // (NTDDI_VERSION >= NTDDI_LONGHORN) MSTCPIP_INLINE VOID INETADDR_SETANY(PSOCKADDR a) { if (a->sa_family == AF_INET6) { IN6ADDR_SETANY((PSOCKADDR_IN6)a); } else { ASSERT(a->sa_family == AF_INET); IN4ADDR_SETANY((PSOCKADDR_IN)a); } } MSTCPIP_INLINE VOID INETADDR_SETLOOPBACK(PSOCKADDR a) { if (a->sa_family == AF_INET6) { IN6ADDR_SETLOOPBACK((PSOCKADDR_IN6)a); } else { ASSERT(a->sa_family == AF_INET); IN4ADDR_SETLOOPBACK((PSOCKADDR_IN)a); } } MSTCPIP_INLINE BOOLEAN INETADDR_ISANY(CONST SOCKADDR *a) { if (a->sa_family == AF_INET6) { return IN6ADDR_ISANY((CONST SOCKADDR_IN6*)a); } else { ASSERT(a->sa_family == AF_INET); return IN4ADDR_ISANY((CONST SOCKADDR_IN*)a); } } MSTCPIP_INLINE BOOLEAN INETADDR_ISLOOPBACK(CONST SOCKADDR *a) { if (a->sa_family == AF_INET6) { return IN6ADDR_ISLOOPBACK((CONST SOCKADDR_IN6*)a); } else { ASSERT(a->sa_family == AF_INET); return IN4ADDR_ISLOOPBACK((CONST SOCKADDR_IN*)a); } } MSTCPIP_INLINE BOOLEAN INETADDR_ISV4MAPPED(CONST SOCKADDR *a) { if (a->sa_family == AF_INET6) { return IN6ADDR_ISV4MAPPED((CONST SOCKADDR_IN6*)a); } else { return FALSE; } } MSTCPIP_INLINE BOOLEAN NL_ADDR_EQUAL( IN ADDRESS_FAMILY af, IN SCOPE_ID sa, IN CONST UCHAR* aa, IN SCOPE_ID sb, IN CONST UCHAR* ab ) { return (BOOLEAN)((sa.Value == sb.Value) && INET_ADDR_EQUAL(af, aa, ab)); } MSTCPIP_INLINE BOOLEAN NL_IS_ADDR_UNSPECIFIED( IN ADDRESS_FAMILY af, IN SCOPE_ID s, IN CONST UCHAR* a ) { return (BOOLEAN)((s.Value == 0) && INET_IS_ADDR_UNSPECIFIED(af, a)); } MSTCPIP_INLINE BOOLEAN INETADDR_ISEQUAL(CONST SOCKADDR *a, CONST SOCKADDR *b) { if (a->sa_family == AF_INET6) { return (BOOLEAN) (b->sa_family == AF_INET6 && IN6ADDR_ISEQUAL((CONST SOCKADDR_IN6*)a, (CONST SOCKADDR_IN6*)b)); } else { ASSERT(a->sa_family == AF_INET); return (BOOLEAN) (b->sa_family == AF_INET && IN4ADDR_ISEQUAL((CONST SOCKADDR_IN*)a, (CONST SOCKADDR_IN*)b)); } } MSTCPIP_INLINE BOOLEAN INETADDR_ISUNSPECIFIED(CONST SOCKADDR *a) { if (a->sa_family == AF_INET6) { return IN6ADDR_ISUNSPECIFIED((CONST SOCKADDR_IN6*)a); } else { ASSERT(a->sa_family == AF_INET); return IN4ADDR_ISUNSPECIFIED((CONST SOCKADDR_IN*)a); } } #if (NTDDI_VERSION >= NTDDI_LONGHORN) MSTCPIP_INLINE SCOPE_ID INETADDR_SCOPE_ID(CONST SOCKADDR *a) { if (a->sa_family == AF_INET6) { return ((CONST SOCKADDR_IN6*)a)->sin6_scope_struct; } else { ASSERT(a->sa_family == AF_INET); return IN4ADDR_SCOPE_ID((CONST SOCKADDR_IN*)a); } } #endif MSTCPIP_INLINE USHORT INETADDR_PORT(CONST SOCKADDR *a) { if (a->sa_family == AF_INET6) { return ((CONST SOCKADDR_IN6*)a)->sin6_port; } else { ASSERT(a->sa_family == AF_INET); return ((CONST SOCKADDR_IN*)a)->sin_port; } } MSTCPIP_INLINE PUCHAR INETADDR_ADDRESS(CONST SOCKADDR* a) { if (a->sa_family == AF_INET6) { return (PUCHAR)&((PSOCKADDR_IN6)a)->sin6_addr; } else { ASSERT(a->sa_family == AF_INET); return (PUCHAR)&((PSOCKADDR_IN)a)->sin_addr; } } MSTCPIP_INLINE VOID INETADDR_SET_PORT(PSOCKADDR a, USHORT Port) { SS_PORT(a) = Port; } MSTCPIP_INLINE VOID INETADDR_SET_ADDRESS(PSOCKADDR a, CONST UCHAR *Address) { if (a->sa_family == AF_INET6) { ((PSOCKADDR_IN6)a)->sin6_addr = *((CONST IN6_ADDR*)Address); } else { ASSERT(a->sa_family == AF_INET); ((PSOCKADDR_IN)a)->sin_addr = *((CONST IN_ADDR*)Address); } } MSTCPIP_INLINE VOID INET_UNCANONICALIZE_SCOPE_ID( IN ADDRESS_FAMILY AddressFamily, IN CONST UCHAR *Address, IN OUT SCOPE_ID *ScopeId ) { if (AddressFamily == AF_INET6) { IN6_UNCANONICALIZE_SCOPE_ID((CONST IN6_ADDR*) Address, ScopeId); } else { IN4_UNCANONICALIZE_SCOPE_ID((CONST IN_ADDR*) Address, ScopeId); } } #endif // _WS2IPDEF_ #endif // (NTDDI_VERSION >= NTDDI_WIN2KSP1) #ifdef _PREFAST_ #pragma prefast(pop) #endif #pragma warning(pop) #ifdef MSTCPIPDEF_ASSERT_UNDEFINED #undef ASSERT #endif #ifdef __cplusplus } #endif #endif // !_MSTCPIP_