785a08c4eb12b588f10cedefcbd9383cc7a3558d
[folly.git] / folly / test / IPAddressTest.cpp
1 /*
2  * Copyright 2016 Facebook, Inc.
3  *
4  * Licensed under the Apache License, Version 2.0 (the "License");
5  * you may not use this file except in compliance with the License.
6  * You may obtain a copy of the License at
7  *
8  *   http://www.apache.org/licenses/LICENSE-2.0
9  *
10  * Unless required by applicable law or agreed to in writing, software
11  * distributed under the License is distributed on an "AS IS" BASIS,
12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13  * See the License for the specific language governing permissions and
14  * limitations under the License.
15  */
16
17 #include <folly/test/IPAddressTest.h>
18
19 #include <gtest/gtest.h>
20
21 #include <folly/Bits.h>
22 #include <folly/Format.h>
23 #include <folly/String.h>
24 #include <folly/MacAddress.h>
25
26 using namespace folly;
27 using namespace std;
28
29 // tests code example
30 TEST(IPAddress, CodeExample) {
31   EXPECT_EQ(4, sizeof(IPAddressV4));
32   EXPECT_EQ(20, sizeof(IPAddressV6));
33   EXPECT_EQ(24, sizeof(IPAddress));
34   IPAddress uninitaddr;
35   IPAddress v4addr("192.0.2.129");
36   IPAddress v6map("::ffff:192.0.2.129");
37   ASSERT_TRUE(uninitaddr.empty());
38   ASSERT_FALSE(v4addr.empty());
39   ASSERT_FALSE(v6map.empty());
40   EXPECT_TRUE(v4addr.inSubnet("192.0.2.0/24"));
41   EXPECT_TRUE(v4addr.inSubnet(IPAddress("192.0.2.0"), 24));
42   EXPECT_TRUE(v4addr.inSubnet("192.0.2.128/30"));
43   EXPECT_FALSE(v4addr.inSubnet("192.0.2.128/32"));
44   EXPECT_EQ(2164392128, v4addr.asV4().toLong());
45   EXPECT_EQ(3221226113, v4addr.asV4().toLongHBO());
46   ASSERT_FALSE(uninitaddr.isV4());
47   ASSERT_FALSE(uninitaddr.isV6());
48   ASSERT_TRUE(v4addr.isV4());
49   ASSERT_TRUE(v6map.isV6());
50   EXPECT_TRUE(v4addr == v6map);
51   ASSERT_TRUE(v6map.isIPv4Mapped());
52   EXPECT_TRUE(v4addr.asV4() == IPAddress::createIPv4(v6map));
53   EXPECT_TRUE(IPAddress::createIPv6(v4addr) == v6map.asV6());
54 }
55
56 TEST(IPAddress, Scope) {
57   // Test that link-local scope is saved
58   auto str = "fe80::62eb:69ff:fe9b:ba60%eth0";
59   IPAddressV6 a2(str);
60   EXPECT_EQ(str, a2.str());
61
62   sockaddr_in6 sock = a2.toSockAddr();
63   EXPECT_NE(0, sock.sin6_scope_id);
64
65   IPAddress a1(str);
66   EXPECT_EQ(str, a1.str());
67
68   a2.setScopeId(0);
69   EXPECT_NE(a1, a2);
70
71   EXPECT_TRUE(a2 < a1);
72 }
73
74 TEST(IPAddress, Ordering) {
75   IPAddress a1("0.1.1.1");
76   IPAddress a2("1.1.1.0");
77   EXPECT_TRUE(a1 < a2);
78
79   IPAddress b1("::ffff:0.1.1.1");
80   IPAddress b2("::ffff:1.1.1.0");
81   EXPECT_TRUE(b1 < b2);
82 }
83
84 TEST(IPAddress, InvalidAddressFamilyExceptions) {
85   // asV4
86   {
87     IPAddress addr;
88     EXPECT_THROW(addr.asV4(), InvalidAddressFamilyException);
89   }
90   // asV6
91   {
92     IPAddress addr;
93     EXPECT_THROW(addr.asV6(), InvalidAddressFamilyException);
94   }
95   // sockaddr ctor
96   {
97     // setup
98     sockaddr_in addr;
99     addr.sin_family = AF_UNSPEC;
100
101     EXPECT_THROW(IPAddress((sockaddr *)&addr), InvalidAddressFamilyException);
102   }
103 }
104
105 TEST(IPAddress, CreateNetwork) {
106   // test valid IPv4 network
107   {
108     auto net = IPAddress::createNetwork("192.168.0.1/24");
109     ASSERT_TRUE(net.first.isV4());
110     EXPECT_EQ("192.168.0.0", net.first.str());
111     EXPECT_EQ(24, net.second);
112     EXPECT_EQ("192.168.0.0/24", IPAddress::networkToString(net));
113   }
114   // test valid IPv4 network without applying mask
115   {
116     auto net = IPAddress::createNetwork("192.168.0.1/24", -1, false);
117     ASSERT_TRUE(net.first.isV4());
118     EXPECT_EQ("192.168.0.1", net.first.str());
119     EXPECT_EQ(24, net.second);
120     EXPECT_EQ("192.168.0.1/24", IPAddress::networkToString(net));
121   }
122   // test valid IPv6 network
123   {
124     auto net = IPAddress::createNetwork("1999::1/24");
125     ASSERT_TRUE(net.first.isV6());
126     EXPECT_EQ("1999::", net.first.str());
127     EXPECT_EQ(24, net.second);
128     EXPECT_EQ("1999::/24", IPAddress::networkToString(net));
129   }
130   // test valid IPv6 network without applying mask
131   {
132     auto net = IPAddress::createNetwork("1999::1/24", -1, false);
133     ASSERT_TRUE(net.first.isV6());
134     EXPECT_EQ("1999::1", net.first.str());
135     EXPECT_EQ(24, net.second);
136     EXPECT_EQ("1999::1/24", IPAddress::networkToString(net));
137   }
138   // test empty string
139   EXPECT_THROW(IPAddress::createNetwork(""), IPAddressFormatException);
140   // test multi slash string
141   EXPECT_THROW(IPAddress::createNetwork("192.168.0.1/24/36"),
142                                         IPAddressFormatException);
143   // test no slash string with default IPv4
144   {
145     auto net = IPAddress::createNetwork("192.168.0.1");
146     ASSERT_TRUE(net.first.isV4());
147     EXPECT_EQ("192.168.0.1", net.first.str());
148     EXPECT_EQ(32, net.second);  // auto-detected
149     net = IPAddress::createNetwork("192.168.0.1", -1, false);
150     ASSERT_TRUE(net.first.isV4());
151     EXPECT_EQ("192.168.0.1", net.first.str());
152     EXPECT_EQ(32, net.second);
153   }
154   // test no slash string with default IPv6
155   {
156     auto net = IPAddress::createNetwork("1999::1");
157     ASSERT_TRUE(net.first.isV6());
158     EXPECT_EQ("1999::1", net.first.str());
159     EXPECT_EQ(128, net.second);
160   }
161   // test no slash string with invalid default
162   EXPECT_THROW(IPAddress::createNetwork("192.168.0.1", 33),
163                IPAddressFormatException);
164
165 }
166
167 // test assignment operators
168 TEST(IPAddress, Assignment) {
169   static const string kIPv4Addr = "69.63.189.16";
170   static const string kIPv6Addr = "2620:0:1cfe:face:b00c::3";
171
172   // Test assigning IPAddressV6 addr to IPAddress (was V4)
173   {
174     IPAddress addr(kIPv4Addr);
175     IPAddressV6 addrV6 = IPAddress(kIPv6Addr).asV6();
176     EXPECT_TRUE(addr.isV4());
177     EXPECT_EQ(kIPv4Addr, addr.str());
178     addr = addrV6;
179     EXPECT_TRUE(addr.isV6());
180     EXPECT_EQ(kIPv6Addr, addr.str());
181   }
182   // Test assigning IPAddressV4 addr to IPAddress (was V6)
183   {
184     IPAddress addr(kIPv6Addr);
185     IPAddressV4 addrV4 = IPAddress(kIPv4Addr).asV4();
186     EXPECT_TRUE(addr.isV6());
187     EXPECT_EQ(kIPv6Addr, addr.str());
188     addr = addrV4;
189     EXPECT_TRUE(addr.isV4());
190     EXPECT_EQ(kIPv4Addr, addr.str());
191   }
192   // Test assigning IPAddress(v6) to IPAddress (was v4)
193   {
194     IPAddress addr(kIPv4Addr);
195     IPAddress addrV6 = IPAddress(kIPv6Addr);
196     EXPECT_TRUE(addr.isV4());
197     EXPECT_EQ(kIPv4Addr, addr.str());
198     addr = addrV6;
199     EXPECT_TRUE(addr.isV6());
200     EXPECT_EQ(kIPv6Addr, addr.str());
201   }
202   // Test assigning IPAddress(v4) to IPAddress (was v6)
203   {
204     IPAddress addr(kIPv6Addr);
205     IPAddress addrV4 = IPAddress(kIPv4Addr);
206     EXPECT_TRUE(addr.isV6());
207     EXPECT_EQ(kIPv6Addr, addr.str());
208     addr = addrV4;
209     EXPECT_TRUE(addr.isV4());
210     EXPECT_EQ(kIPv4Addr, addr.str());
211   }
212 }
213
214 // Test the default constructors
215 TEST(IPAddress, CtorDefault) {
216   IPAddressV4 v4;
217   EXPECT_EQ(IPAddressV4("0.0.0.0"), v4);
218   IPAddressV6 v6;
219   EXPECT_EQ(IPAddressV6("::0"), v6);
220 }
221
222 // Test addresses constructed using a in[6]_addr value
223 TEST_P(IPAddressTest, CtorAddress) {
224   AddressData param = GetParam();
225   IPAddress strAddr(param.address);
226   IPAddress address;
227
228   if (param.version == 4) {
229     in_addr v4addr = detail::Bytes::mkAddress4(&param.bytes[0]);
230     address = IPAddress(v4addr);
231   } else {
232     in6_addr v6addr = detail::Bytes::mkAddress6(&param.bytes[0]);
233     address = IPAddress(v6addr);
234   }
235   ExpectIsValid(address);
236   EXPECT_EQ(strAddr, address);
237 }
238
239 // Test addresses constructed using a binary address
240 TEST_P(IPAddressTest, CtorBinary) {
241   AddressData param = GetParam();
242   IPAddress address;
243
244   if (param.version == 4) {
245     in_addr v4addr = AddressData::parseAddress4(param.address);
246     address = IPAddress::fromBinary(ByteRange((unsigned char*)&v4addr, 4));
247   } else {
248     in6_addr v6addr = AddressData::parseAddress6(param.address);
249     address = IPAddress::fromBinary(ByteRange((unsigned char*)&v6addr, 16));
250   }
251
252   ExpectIsValid(address);
253   EXPECT_EQ(IPAddress(param.address), address);
254 }
255
256 // Test addresses constructed using a string
257 TEST_P(IPAddressTest, CtorString) {
258   AddressData param = GetParam();
259   IPAddress address(param.address);
260
261   ExpectIsValid(address);
262
263   // Test the direct version-specific constructor
264   if (param.version == 4) {
265     IPAddressV4 v4(param.address);
266     ExpectIsValid(IPAddress(v4));
267     EXPECT_THROW(IPAddressV6 v6(param.address), IPAddressFormatException);
268   } else if (param.version == 6) {
269     IPAddressV6 v6(param.address);
270     ExpectIsValid(IPAddress(v6));
271     EXPECT_THROW(IPAddressV4 v4(param.address), IPAddressFormatException);
272   }
273 }
274
275 TEST(IPAddress, CtorSockaddr) {
276   // test v4 address
277   {
278     // setup
279     sockaddr_in addr;
280     in_addr sin_addr;
281     sin_addr.s_addr = htonl(2122547223);
282     addr.sin_family = AF_INET;
283     addr.sin_addr = sin_addr;
284
285     IPAddress ipAddr((sockaddr *)&addr);
286     EXPECT_TRUE(ipAddr.isV4());
287     EXPECT_EQ("126.131.128.23", ipAddr.str());
288   }
289   // test v6 address
290   {
291     // setup
292     sockaddr_in6 addr;
293     memset(&addr, 0, sizeof(addr));
294     in6_addr sin_addr;
295     ByteArray16 sec{{
296       // 2620:0:1cfe:face:b00c::3
297       38,32,0,0,28,254,250,206,176,12,0,0,0,0,0,3
298     }};
299     std::memcpy(sin_addr.s6_addr, sec.data(), 16);
300     addr.sin6_family = AF_INET6;
301     addr.sin6_addr = sin_addr;
302
303     IPAddress ipAddr((sockaddr *)&addr);
304     EXPECT_TRUE(ipAddr.isV6());
305     EXPECT_EQ("2620:0:1cfe:face:b00c::3", ipAddr.str());
306   }
307   // test nullptr exception
308   {
309     sockaddr *addr = nullptr;
310     EXPECT_THROW(IPAddress((const sockaddr*)addr), IPAddressFormatException);
311   }
312   // test invalid family exception
313   {
314     // setup
315     sockaddr_in addr;
316     in_addr sin_addr;
317     sin_addr.s_addr = htonl(2122547223);
318     addr.sin_family = AF_UNSPEC;
319     addr.sin_addr = sin_addr;
320
321     EXPECT_THROW(IPAddress((sockaddr *)&addr), IPAddressFormatException);
322   }
323 }
324
325 TEST(IPAddress, ToSockaddrStorage) {
326   // test v4 address
327   {
328     string strAddr("126.131.128.23");
329     IPAddress addr(strAddr);
330     sockaddr_storage out;
331
332     ASSERT_TRUE(addr.isV4()); // test invariant
333     EXPECT_GT(addr.toSockaddrStorage(&out), 0);
334
335     IPAddress sockAddr((sockaddr*)&out);
336     ASSERT_TRUE(sockAddr.isV4());
337     EXPECT_EQ(strAddr, sockAddr.str());
338   }
339   // test v6 address
340   {
341     string strAddr("2620:0:1cfe:face:b00c::3");
342     IPAddress addr(strAddr);
343     sockaddr_storage out;
344
345     ASSERT_TRUE(addr.isV6()); // test invariant
346     EXPECT_GT(addr.toSockaddrStorage(&out), 0);
347
348     IPAddress sockAddr((sockaddr*)&out);
349     ASSERT_TRUE(sockAddr.isV6());
350     EXPECT_EQ(strAddr, sockAddr.str());
351   }
352   // test nullptr exception
353   {
354     sockaddr_storage *out = nullptr;
355     IPAddress addr("127.0.0.1");
356     EXPECT_THROW(addr.toSockaddrStorage(out), IPAddressFormatException);
357   }
358   // test invalid family exception
359   {
360     IPAddress addr;
361     sockaddr_storage out;
362     ASSERT_EQ(AF_UNSPEC, addr.family());
363     EXPECT_THROW(addr.toSockaddrStorage(&out), InvalidAddressFamilyException);
364   }
365 }
366
367 TEST(IPAddress, ToString) {
368   // Test with IPAddressV4
369   IPAddressV4 addr_10_0_0_1("10.0.0.1");
370   EXPECT_EQ("10.0.0.1", folly::to<string>(addr_10_0_0_1));
371   // Test with IPAddressV6
372   IPAddressV6 addr_1("::1");
373   EXPECT_EQ("::1", folly::to<string>(addr_1));
374   // Test with IPAddress, both V4 and V6
375   IPAddress addr_10_1_2_3("10.1.2.3");
376   EXPECT_EQ("10.1.2.3", folly::to<string>(addr_10_1_2_3));
377   IPAddress addr_1_2_3("1:2::3");
378   EXPECT_EQ("1:2::3", folly::to<string>(addr_1_2_3));
379
380   // Test a combination of all the above arguments
381   EXPECT_EQ("1:2::3 - 10.0.0.1 - ::1 - 10.1.2.3",
382             folly::to<string>(addr_1_2_3, " - ", addr_10_0_0_1,
383                               " - ", addr_1, " - ", addr_10_1_2_3));
384 }
385
386 // Test that invalid string values are killed
387 TEST_P(IPAddressCtorTest, InvalidCreation) {
388   string addr = GetParam();
389   EXPECT_THROW(IPAddress((const string)addr), IPAddressFormatException)
390       << "IPAddress(" << addr << ") "
391       << "should have thrown an IPAddressFormatException";
392 }
393
394 // Test that invalid binary values throw an exception
395 TEST_P(IPAddressCtorBinaryTest, InvalidBinary) {
396   auto bin = GetParam();
397   EXPECT_THROW(IPAddress::fromBinary(ByteRange(&bin[0], bin.size())),
398                IPAddressFormatException);
399 }
400
401 // Test toFullyQualified()
402 TEST(IPAddress, ToFullyQualifiedFb) {
403   IPAddress ip("2620:0:1cfe:face:b00c::3");
404   EXPECT_EQ("2620:0000:1cfe:face:b00c:0000:0000:0003", ip.toFullyQualified())
405       << ip;
406 }
407 TEST(IPAddress, ToFullyQualifiedLocal) {
408   IPAddress ip("::1");
409   EXPECT_EQ("0000:0000:0000:0000:0000:0000:0000:0001", ip.toFullyQualified())
410       << ip;
411 }
412 TEST(IPAddress, ToFullyQualifiedSize) {
413   auto actual = IPAddressV6::kToFullyQualifiedSize;
414   auto expected = IPAddress("::").toFullyQualified().size();
415   EXPECT_EQ(expected, actual);
416 }
417
418 // test v4-v6 mapped addresses
419 TEST_P(IPAddressMappedTest, MappedEqual) {
420   auto param = GetParam();
421   string mappedIp = param.first;
422   string otherIp = param.second;
423
424   auto mapped = IPAddress(mappedIp);
425   auto expected = IPAddress(otherIp);
426
427   EXPECT_EQ(expected, mapped);
428
429   IPAddress v6addr;
430   if (mapped.isV4()) {
431     v6addr = mapped.asV4().createIPv6();
432   } else if (expected.isV4()) {
433     v6addr = expected.asV4().createIPv6();
434   }
435   EXPECT_TRUE(v6addr.isV6());
436   EXPECT_TRUE(mapped == v6addr);
437   EXPECT_TRUE(expected == v6addr);
438 }
439
440 // Test subnet mask calculations
441 TEST_P(IPAddressMaskTest, Masks) {
442   auto param = GetParam();
443
444   IPAddress ip(param.address);
445   IPAddress masked = ip.mask(param.mask);
446   EXPECT_EQ(param.subnet, masked.str())
447       << param.address << "/" << folly::to<std::string>(param.mask) << " -> "
448       << param.subnet;
449 }
450
451 // Test inSubnet calculations
452 TEST_P(IPAddressMaskTest, InSubnet) {
453   auto param = GetParam();
454
455   IPAddress ip(param.address);
456   IPAddress subnet(param.subnet);
457   EXPECT_TRUE(ip.inSubnet(subnet, param.mask));
458 }
459
460 // Test boundary conditions for subnet calculations
461 TEST_P(IPAddressMaskBoundaryTest, NonMaskedSubnet) {
462   auto param = GetParam();
463   IPAddress ip(param.address);
464   IPAddress subnet(param.subnet);
465   EXPECT_EQ(param.inSubnet, ip.inSubnet(subnet, param.mask));
466 }
467
468 TEST(IPAddress, UnitializedEqual) {
469   IPAddress addrEmpty;
470   IPAddress ip4("127.0.0.1");
471   EXPECT_FALSE(addrEmpty == ip4);
472   EXPECT_FALSE(ip4 == addrEmpty);
473   IPAddress ip6("::1");
474   EXPECT_FALSE(addrEmpty == ip6);
475   EXPECT_FALSE(ip6 == addrEmpty);
476   IPAddress ip6Map("::ffff:192.0.2.129");
477   EXPECT_FALSE(addrEmpty == ip6Map);
478   EXPECT_FALSE(ip6Map == addrEmpty);
479   IPAddress ip4Zero("0.0.0.0");
480   EXPECT_FALSE(addrEmpty == ip4Zero);
481   EXPECT_FALSE(ip4Zero == addrEmpty);
482   IPAddress ip6Zero("::");
483   EXPECT_FALSE(addrEmpty == ip6Zero);
484   EXPECT_FALSE(ip6Zero == addrEmpty);
485   EXPECT_EQ(addrEmpty, addrEmpty);
486 }
487
488 // Test subnet calcs with 6to4 addresses
489 TEST(IPAddress, InSubnetWith6to4) {
490   auto ip = IPAddress("2002:c000:022a::"); // 192.0.2.42
491   auto subnet = IPAddress("192.0.0.0");
492   EXPECT_TRUE(ip.inSubnet(subnet, 16));
493
494   auto ip2 = IPAddress("192.0.0.1");
495   auto subnet2 = IPAddress("2002:c000:0000::"); // 192.0.0.0
496   EXPECT_TRUE(ip2.inSubnet(subnet2, 14));
497
498   auto ip3 = IPAddress("2002:c000:022a::"); // 192.0.2.42
499   auto subnet3 = IPAddress("2002:c000:0000::"); // 192.0.0.0
500   EXPECT_TRUE(ip3.inSubnet(subnet3, 16));
501 }
502
503 static const vector<string> ipv4Strs = {
504   "127.0.0.1",
505   "198.168.0.1",
506   "8.8.0.0",
507 };
508 TEST(IPAddress, getIPv6For6To4) {
509   for (auto ipv4Str : ipv4Strs) {
510     auto ip = IPAddress(ipv4Str);
511     EXPECT_TRUE(ip.isV4());
512     IPAddressV4 ipv4 = ip.asV4();
513     auto ipv6 = ipv4.getIPv6For6To4();
514     EXPECT_EQ(ipv6.type(), IPAddressV6::Type::T6TO4);
515     auto ipv4New = ipv6.getIPv4For6To4();
516     EXPECT_TRUE(ipv4Str.compare(ipv4New.str()) == 0);
517   }
518 }
519
520 static const vector<pair<string, uint8_t> > invalidMasks = {
521   {"127.0.0.1", 33},
522   {"::1", 129},
523 };
524 TEST(IPAddress, InvalidMask) {
525   for (auto& tc : invalidMasks) {
526     auto ip = IPAddress(tc.first);
527     EXPECT_THROW(ip.mask(tc.second), IPAddressFormatException);
528   }
529 }
530
531 static const vector<pair<string, IPAddressV6::Type> > v6types = {
532   {"::1", IPAddressV6::Type::NORMAL},
533   {"2620:0:1cfe:face:b00c::3", IPAddressV6::Type::NORMAL},
534   {"2001:0000:4136:e378:8000:63bf:3fff:fdd2", IPAddressV6::Type::TEREDO},
535   {"2002:c000:022a::", IPAddressV6::Type::T6TO4},
536 };
537 TEST(IPAddress, V6Types) {
538   auto mkName = [&](const IPAddressV6::Type t) -> string {
539     switch (t) {
540       case IPAddressV6::Type::TEREDO:
541         return "teredo";
542       case IPAddressV6::Type::T6TO4:
543         return "6to4";
544       default:
545         return "default";
546     }
547   };
548
549   for (auto& tc : v6types) {
550     auto ip = IPAddress(tc.first);
551     EXPECT_TRUE(ip.isV6());
552     IPAddressV6 ipv6 = ip.asV6();
553     EXPECT_EQ(tc.second, ipv6.type())
554         << "expected " << mkName(tc.second) << ", got " << mkName(ipv6.type());
555     switch (tc.second) {
556       case IPAddressV6::Type::TEREDO:
557         EXPECT_TRUE(ipv6.isTeredo()) << "isTeredo was false";
558         EXPECT_FALSE(ipv6.is6To4()) << "is6To4 was true";
559         break;
560       case IPAddressV6::Type::T6TO4:
561         EXPECT_TRUE(ipv6.is6To4()) << "is6To4 was false";
562         EXPECT_FALSE(ipv6.isTeredo()) << "isTeredo was true";
563         break;
564       case IPAddressV6::Type::NORMAL:
565         EXPECT_FALSE(ipv6.is6To4()) << "is6To4 was true";
566         EXPECT_FALSE(ipv6.isTeredo()) << "isTeredo was true";
567         break;
568       default:
569         throw std::range_error("Invalid expected type: " +
570                                folly::to<std::string>(tc.second));
571     }
572   }
573 }
574
575 static const vector<pair<string, uint32_t> > provideToLong = {
576   {"0.0.0.0", 0},
577   {"10.0.0.0", 167772160},
578   {"126.131.128.23", 2122547223},
579   {"192.168.0.0", 3232235520},
580 };
581 TEST(IPAddress, ToLong) {
582   for (auto& tc : provideToLong) {
583     auto ip = IPAddress(tc.first);
584     EXPECT_TRUE(ip.isV4());
585     IPAddressV4 ipv4 = ip.asV4();
586     EXPECT_EQ(tc.second, ipv4.toLongHBO());
587
588     auto ip2 = IPAddress::fromLongHBO(tc.second);
589     EXPECT_TRUE(ip2.isV4());
590     EXPECT_TRUE(tc.first.compare(ip2.str()) == 0);
591     EXPECT_EQ(tc.second, ip2.asV4().toLongHBO());
592
593     auto nla = htonl(tc.second);
594     auto ip3 = IPAddress::fromLong(nla);
595     EXPECT_TRUE(ip3.isV4());
596     EXPECT_TRUE(tc.first.compare(ip3.str()) == 0);
597     EXPECT_EQ(nla, ip3.asV4().toLong());
598   }
599 }
600
601 TEST(IPAddress, fromBinaryV4) {
602   for (auto& tc : provideToLong) {
603     SCOPED_TRACE(tc.first);
604     union {
605       uint8_t u8[4];
606       uint32_t u32;
607     } data;
608     data.u32 = Endian::big(tc.second);
609     ByteRange bytes(data.u8, 4);
610
611     auto fromBin = IPAddressV4::fromBinary(bytes);
612     IPAddressV4 fromStr(tc.first);
613     EXPECT_EQ(fromStr, fromBin);
614
615     IPAddressV4 addr2("0.0.0.0");
616     addr2 = IPAddressV4::fromBinary(bytes);
617     EXPECT_EQ(fromStr, addr2);
618
619     IPAddress genericAddr = IPAddress::fromBinary(bytes);
620     ASSERT_TRUE(genericAddr.isV4());
621     EXPECT_EQ(fromStr, genericAddr.asV4());
622     EXPECT_EQ(ByteRange(genericAddr.bytes(), genericAddr.byteCount()), bytes);
623   }
624
625   uint8_t data[20];
626   EXPECT_THROW(IPAddressV4::fromBinary(ByteRange(data, 3)),
627                IPAddressFormatException);
628   EXPECT_THROW(IPAddressV4::fromBinary(ByteRange(data, 16)),
629                IPAddressFormatException);
630   EXPECT_THROW(IPAddressV4::fromBinary(ByteRange(data, 20)),
631                IPAddressFormatException);
632 }
633
634 TEST(IPAddress, toBinaryV4) {
635   for (auto& tc : provideToLong) {
636     SCOPED_TRACE(tc.first);
637     union {
638       uint8_t u8[4];
639       uint32_t u32;
640     } data;
641     data.u32 = Endian::big(tc.second);
642     ByteRange bytes(data.u8, 4);
643
644     auto fromBin = IPAddressV4::fromBinary(bytes);
645     auto toBin = fromBin.toBinary();
646     EXPECT_EQ(bytes, toBin);
647   }
648 }
649
650 static const vector<pair<string, vector<uint8_t> > > provideBinary16Bytes = {
651   {"::0",
652     {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
653      0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}},
654   {"1::2",
655     {0x00, 0x01, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
656      0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x02}},
657   {"fe80::0012:34ff:fe56:78ab",
658     {0xfe, 0x80, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
659      0x00, 0x12, 0x34, 0xff, 0xfe, 0x56, 0x78, 0xab}},
660   {"2001:db8:1234:5678:90ab:cdef:8765:4321",
661     {0x20, 0x01, 0x0d, 0xb8, 0x12, 0x34, 0x56, 0x78,
662      0x90, 0xab, 0xcd, 0xef, 0x87, 0x65, 0x43, 0x21}},
663   {"::ffff:0:c0a8:1",
664     {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
665      0xff, 0xff, 0x00, 0x00, 0xc0, 0xa8, 0x00, 0x01}},
666 };
667
668 TEST(IPAddress, fromBinaryV6) {
669   for (auto& tc : provideBinary16Bytes) {
670     SCOPED_TRACE(tc.first);
671     ByteRange bytes(&tc.second.front(), tc.second.size());
672
673     auto fromBin = IPAddressV6::fromBinary(bytes);
674     IPAddressV6 fromStr(tc.first);
675     EXPECT_EQ(fromStr, fromBin);
676
677     IPAddressV6 addr2("::0");
678     addr2 = IPAddressV6::fromBinary(bytes);
679     EXPECT_EQ(fromStr, addr2);
680
681     IPAddress genericAddr = IPAddress::fromBinary(bytes);
682     ASSERT_TRUE(genericAddr.isV6());
683     EXPECT_EQ(fromStr, genericAddr.asV6());
684     EXPECT_EQ(ByteRange(genericAddr.bytes(), genericAddr.byteCount()), bytes);
685   }
686
687   uint8_t data[20];
688   EXPECT_THROW(IPAddressV6::fromBinary(ByteRange(data, 3)),
689                IPAddressFormatException);
690   EXPECT_THROW(IPAddressV6::fromBinary(ByteRange(data, 4)),
691                IPAddressFormatException);
692   EXPECT_THROW(IPAddressV6::fromBinary(ByteRange(data, 20)),
693                IPAddressFormatException);
694 }
695
696 TEST(IPAddress, toBinaryV6) {
697   for (auto& tc : provideBinary16Bytes) {
698     SCOPED_TRACE(tc.first);
699     ByteRange bytes(&tc.second.front(), tc.second.size());
700
701     auto fromBin = IPAddressV6::fromBinary(bytes);
702     auto toBin = fromBin.toBinary();
703     EXPECT_EQ(bytes, toBin);
704   }
705 }
706
707 TEST_P(IPAddressFlagTest, IsLoopback) {
708   AddressFlags param = GetParam();
709   IPAddress addr(param.address);
710
711   EXPECT_EQ(param.version, addr.version());
712   EXPECT_EQ(param.isLoopback(), addr.isLoopback());
713 }
714
715 TEST_P(IPAddressFlagTest, IsPrivate) {
716   AddressFlags param = GetParam();
717   IPAddress addr(param.address);
718
719   EXPECT_EQ(param.version, addr.version());
720   EXPECT_EQ(param.isPrivate(), addr.isPrivate()) << addr;
721 }
722
723 TEST_P(IPAddressFlagTest, IsNonroutable) {
724   AddressFlags param = GetParam();
725   IPAddress addr(param.address);
726
727   EXPECT_EQ(param.version, addr.version());
728   EXPECT_EQ(param.isNonroutable(), addr.isNonroutable()) << addr;
729 }
730
731 TEST_P(IPAddressFlagTest, IsZero) {
732   AddressFlags param = GetParam();
733   IPAddress addr(param.address);
734
735   EXPECT_EQ(param.version, addr.version());
736   EXPECT_EQ(param.isZero(), addr.isZero()) << addr;
737 }
738
739 TEST_P(IPAddressFlagTest, IsLinkLocal) {
740   AddressFlags param = GetParam();
741   IPAddress addr(param.address);
742   EXPECT_EQ(param.isLinkLocal(), addr.isLinkLocal()) << addr;
743 }
744
745 TEST(IPAddress, CreateLinkLocal) {
746   IPAddressV6 addr(IPAddressV6::LINK_LOCAL, MacAddress("00:05:73:f9:46:fc"));
747   EXPECT_EQ(IPAddressV6("fe80::0205:73ff:fef9:46fc"), addr);
748
749   addr = IPAddressV6(IPAddressV6::LINK_LOCAL, MacAddress("02:00:00:12:34:56"));
750   EXPECT_EQ(IPAddressV6("fe80::ff:fe12:3456"), addr);
751 }
752
753 TEST_P(IPAddressFlagTest, IsLinkLocalBroadcast) {
754   AddressFlags param = GetParam();
755   IPAddress addr(param.address);
756   EXPECT_EQ(param.version, addr.version());
757   EXPECT_EQ(param.isLinkLocalBroadcast(), addr.isLinkLocalBroadcast());
758 }
759
760 TEST(IPAddress, SolicitedNodeAddress) {
761   // An example from RFC 4291 section 2.7.1
762   EXPECT_EQ(IPAddressV6("ff02::1:ff0e:8c6c"),
763             IPAddressV6("4037::01:800:200e:8c6c").getSolicitedNodeAddress());
764
765   // An example from wikipedia
766   // (http://en.wikipedia.org/wiki/Solicited-node_multicast_address)
767   EXPECT_EQ(IPAddressV6("ff02::1:ff28:9c5a"),
768             IPAddressV6("fe80::2aa:ff:fe28:9c5a").getSolicitedNodeAddress());
769 }
770
771 TEST_P(IPAddressByteAccessorTest, CheckBytes) {
772   auto addrData = GetParam();
773   IPAddress ip(addrData.address);
774   size_t i = 0;
775   for (auto byitr = addrData.bytes.begin(); i < ip.byteCount(); ++i, ++byitr) {
776     EXPECT_EQ(*byitr, ip.getNthMSByte(i));
777     EXPECT_EQ(*byitr, ip.isV4() ?
778           ip.asV4().getNthMSByte(i) : ip.asV6().getNthMSByte(i));
779   }
780   i = 0;
781   for (auto byritr = addrData.bytes.rbegin(); i < ip.byteCount(); ++i,
782       ++byritr) {
783     EXPECT_EQ(*byritr, ip.getNthLSByte(i));
784     EXPECT_EQ(*byritr, ip.isV4() ?
785         ip.asV4().getNthLSByte(i) : ip.asV6().getNthLSByte(i));
786   }
787 }
788
789 TEST_P(IPAddressBitAccessorTest, CheckBits) {
790   auto addrData = GetParam();
791   auto littleEndianAddrData = addrData.bytes;
792   //IPAddress stores address data in n/w byte order.
793   reverse(littleEndianAddrData.begin(), littleEndianAddrData.end());
794   //Bit iterator goes from LSBit to MSBit
795   //We will traverse the IPAddress bits from 0 to bitCount -1
796   auto bitr = folly::makeBitIterator(littleEndianAddrData.begin());
797   IPAddress ip(addrData.address);
798   for (size_t i = 0; i < ip.bitCount(); ++i) {
799     auto msbIndex = ip.bitCount() - i - 1;
800     EXPECT_EQ(*bitr, ip.getNthMSBit(msbIndex));
801     EXPECT_EQ(*bitr, ip.isV4() ? ip.asV4().getNthMSBit(msbIndex) :
802           ip.asV6().getNthMSBit(msbIndex));
803     EXPECT_EQ(*bitr, ip.getNthLSBit(i));
804     EXPECT_EQ(*bitr, ip.isV4() ? ip.asV4().getNthLSBit(i) :
805         ip.asV6().getNthLSBit(i));
806     ++bitr;
807   }
808 }
809
810 TEST(IPAddress, InvalidByteAccess) {
811   IPAddress ip4("10.10.10.10");
812   //MSByte, LSByte accessors are 0 indexed
813   EXPECT_THROW(ip4.getNthMSByte(ip4.byteCount()), std::invalid_argument);
814   EXPECT_THROW(ip4.getNthLSByte(ip4.byteCount()), std::invalid_argument);
815   EXPECT_THROW(ip4.getNthMSByte(-1), std::invalid_argument);
816   EXPECT_THROW(ip4.getNthLSByte(-1), std::invalid_argument);
817   auto asV4 = ip4.asV4();
818   EXPECT_THROW(asV4.getNthMSByte(asV4.byteCount()), std::invalid_argument);
819   EXPECT_THROW(asV4.getNthLSByte(asV4.byteCount()), std::invalid_argument);
820   EXPECT_THROW(asV4.getNthMSByte(-1), std::invalid_argument);
821   EXPECT_THROW(asV4.getNthLSByte(-1), std::invalid_argument);
822
823   IPAddress ip6("2620:0:1cfe:face:b00c::3");
824   EXPECT_THROW(ip6.getNthMSByte(ip6.byteCount()), std::invalid_argument);
825   EXPECT_THROW(ip6.getNthLSByte(ip6.byteCount()), std::invalid_argument);
826   EXPECT_THROW(ip6.getNthMSByte(-1), std::invalid_argument);
827   EXPECT_THROW(ip6.getNthLSByte(-1), std::invalid_argument);
828   auto asV6 = ip6.asV6();
829   EXPECT_THROW(asV6.getNthMSByte(asV6.byteCount()), std::invalid_argument);
830   EXPECT_THROW(asV6.getNthLSByte(asV6.byteCount()), std::invalid_argument);
831   EXPECT_THROW(asV6.getNthMSByte(-1), std::invalid_argument);
832   EXPECT_THROW(asV6.getNthLSByte(-1), std::invalid_argument);
833
834 }
835
836 TEST(IPAddress, InvalidBBitAccess) {
837   IPAddress ip4("10.10.10.10");
838   //MSByte, LSByte accessors are 0 indexed
839   EXPECT_THROW(ip4.getNthMSBit(ip4.bitCount()), std::invalid_argument);
840   EXPECT_THROW(ip4.getNthLSBit(ip4.bitCount()), std::invalid_argument);
841   EXPECT_THROW(ip4.getNthMSBit(-1), std::invalid_argument);
842   EXPECT_THROW(ip4.getNthLSBit(-1), std::invalid_argument);
843   auto asV4 = ip4.asV4();
844   EXPECT_THROW(asV4.getNthMSBit(asV4.bitCount()), std::invalid_argument);
845   EXPECT_THROW(asV4.getNthLSBit(asV4.bitCount()), std::invalid_argument);
846   EXPECT_THROW(asV4.getNthMSBit(-1), std::invalid_argument);
847   EXPECT_THROW(asV4.getNthLSBit(-1), std::invalid_argument);
848
849   IPAddress ip6("2620:0:1cfe:face:b00c::3");
850   EXPECT_THROW(ip6.getNthMSBit(ip6.bitCount()), std::invalid_argument);
851   EXPECT_THROW(ip6.getNthLSBit(ip6.bitCount()), std::invalid_argument);
852   EXPECT_THROW(ip6.getNthMSBit(-1), std::invalid_argument);
853   EXPECT_THROW(ip6.getNthLSBit(-1), std::invalid_argument);
854   auto asV6 = ip6.asV6();
855   EXPECT_THROW(asV6.getNthMSBit(asV6.bitCount()), std::invalid_argument);
856   EXPECT_THROW(asV6.getNthLSBit(asV6.bitCount()), std::invalid_argument);
857   EXPECT_THROW(asV6.getNthMSBit(-1), std::invalid_argument);
858   EXPECT_THROW(asV6.getNthLSBit(-1), std::invalid_argument);
859 }
860
861 TEST(IPAddress, StringFormat) {
862   in6_addr a6;
863   for (int i = 0; i < 8; ++i) {
864     a6.s6_addr16[i] = htons(0x0123 + ((i%4) * 0x4444));
865   }
866   EXPECT_EQ("0123:4567:89ab:cdef:0123:4567:89ab:cdef",
867             detail::fastIpv6ToString(a6));
868
869   in_addr a4;
870   a4.s_addr = htonl(0x01020304);
871   EXPECT_EQ("1.2.3.4", detail::fastIpv4ToString(a4));
872 }
873
874 TEST(IPAddress, LongestCommonPrefix) {
875   IPAddress ip10("10.0.0.0");
876   IPAddress ip11("11.0.0.0");
877   IPAddress ip12("12.0.0.0");
878   IPAddress ip128("128.0.0.0");
879   IPAddress ip10dot10("10.10.0.0");
880   auto prefix = IPAddress::longestCommonPrefix({ip10, 8}, {ip128, 8});
881   auto prefix4 = IPAddressV4::longestCommonPrefix({ip10.asV4(), 8},
882                                                   {ip128.asV4(), 8});
883   // No bits match b/w 128/8 and 10/8
884   EXPECT_EQ(IPAddress("0.0.0.0"), prefix.first);
885   EXPECT_EQ(0, prefix.second);
886   EXPECT_EQ(IPAddressV4("0.0.0.0"), prefix4.first);
887   EXPECT_EQ(0, prefix4.second);
888
889   prefix = IPAddress::longestCommonPrefix({ip10, 8}, {ip10dot10, 16});
890   prefix4 = IPAddressV4::longestCommonPrefix({ip10.asV4(), 8},
891                                              {ip10dot10.asV4(), 16});
892   // Between 10/8 and 10.10/16, 10/8 is the longest common match
893   EXPECT_EQ(ip10, prefix.first);
894   EXPECT_EQ(8, prefix.second);
895   EXPECT_EQ(ip10.asV4(), prefix4.first);
896   EXPECT_EQ(8, prefix4.second);
897
898   prefix = IPAddress::longestCommonPrefix({ip11, 8}, {ip12, 8});
899   prefix4 = IPAddressV4::longestCommonPrefix({ip11.asV4(), 8},
900                                              {ip12.asV4(), 8});
901   // 12 = 1100, 11 = 1011, longest match - 1000 = 8
902   EXPECT_EQ(IPAddress("8.0.0.0"), prefix.first);
903   EXPECT_EQ(5, prefix.second);
904   EXPECT_EQ(IPAddressV4("8.0.0.0"), prefix4.first);
905   EXPECT_EQ(5, prefix4.second);
906
907   // Between 128/1 and 128/2, longest match 128/1
908   prefix = IPAddress::longestCommonPrefix({ip128, 1}, {ip128, 2});
909   prefix4 = IPAddressV4::longestCommonPrefix({ip128.asV4(), 1},
910                                              {ip128.asV4(), 2});
911   EXPECT_EQ(ip128, prefix.first);
912   EXPECT_EQ(1, prefix.second);
913   EXPECT_EQ(ip128.asV4(), prefix4.first);
914   EXPECT_EQ(1, prefix4.second);
915
916   IPAddress ip6("2620:0:1cfe:face:b00c::3");
917   prefix = IPAddress::longestCommonPrefix({ip6, ip6.bitCount()},
918                                           {ip6, ip6.bitCount()});
919   auto prefix6 = IPAddressV6::longestCommonPrefix(
920     {ip6.asV6(), IPAddressV6::bitCount()},
921     {ip6.asV6(), IPAddressV6::bitCount()});
922   // Longest common b/w me and myself is myself
923   EXPECT_EQ(ip6, prefix.first);
924   EXPECT_EQ(ip6.bitCount(), prefix.second);
925   EXPECT_EQ(ip6.asV6(), prefix6.first);
926   EXPECT_EQ(ip6.asV6().bitCount(), prefix6.second);
927
928   IPAddress ip6Zero("::");
929   prefix = IPAddress::longestCommonPrefix({ip6, ip6.bitCount()}, {ip6Zero, 0});
930   prefix6 = IPAddressV6::longestCommonPrefix(
931     {ip6.asV6(), IPAddressV6::bitCount()},
932     {ip6Zero.asV6(), 0});
933   // Longest common b/w :: (ipv6 equivalent of 0/0) is ::
934   EXPECT_EQ(ip6Zero, prefix.first);
935   EXPECT_EQ(0, prefix.second);
936
937   // Exceptional cases
938   EXPECT_THROW(IPAddress::longestCommonPrefix({ip10, 8}, {ip6, 128}),
939                std::invalid_argument);
940   EXPECT_THROW(IPAddress::longestCommonPrefix({ip10, ip10.bitCount() + 1},
941                                               {ip10, 8}),
942                std::invalid_argument);
943   EXPECT_THROW(IPAddressV4::longestCommonPrefix(
944                  {ip10.asV4(), IPAddressV4::bitCount() + 1},
945                  {ip10.asV4(), 8}),
946                std::invalid_argument);
947   EXPECT_THROW(IPAddress::longestCommonPrefix({ip6, ip6.bitCount() + 1},
948                                               {ip6, ip6.bitCount()}),
949                std::invalid_argument);
950   EXPECT_THROW(IPAddressV6::longestCommonPrefix(
951                  {ip6.asV6(), IPAddressV6::bitCount() + 1},
952                  {ip6.asV6(), IPAddressV6::bitCount()}),
953                std::invalid_argument);
954
955 }
956
957 static const vector<AddressData> validAddressProvider = {
958   AddressData("127.0.0.1", {127,0,0,1}, 4),
959   AddressData("69.63.189.16", {69,63,189,16}, 4),
960   AddressData("0.0.0.0", {0,0,0,0}, 4),
961   AddressData("::1",
962               {0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1}, 6),
963   AddressData("2620:0:1cfe:face:b00c::3",
964               {38,32,0,0,28,254,250,206,176,12,0,0,0,0,0,3}, 6),
965 };
966
967 static const vector<string> invalidAddressProvider = {
968   "",
969   "foo",
970   "1.1.1.256",
971   "1",
972   ":1",
973   "127.0.0.1,127.0.0.1",
974   "[1234]",
975 };
976
977 static const vector<ByteVector> invalidBinaryProvider = {
978   {0x31, 0x32, 0x37, 0x2e, 0x30, 0x30, 0x2e, 0x30, 0x2e, 0x31},
979   // foo
980   {0x66, 0x6f, 0x6f},
981   {0x00},
982   {0x00, 0x00},
983   {0x00, 0x00, 0x00},
984   {0x00, 0x00, 0x00, 0x00, 0x00},
985   {0xff},
986 };
987
988 static const uint8_t IS_LOCAL = AddressFlags::IS_LOCAL;
989 static const uint8_t IS_NONROUTABLE = AddressFlags::IS_NONROUTABLE;
990 static const uint8_t IS_PRIVATE = AddressFlags::IS_PRIVATE;
991 static const uint8_t IS_ZERO = AddressFlags::IS_ZERO;
992 static const uint8_t IS_LINK_LOCAL =
993   AddressFlags::IS_LINK_LOCAL | IS_NONROUTABLE;
994 static const uint8_t IS_PVT_NONROUTE = IS_NONROUTABLE | IS_PRIVATE;
995 static const uint8_t IS_MULTICAST = AddressFlags::IS_MULTICAST;
996 static const uint8_t IS_LINK_LOCAL_BROADCAST =
997 AddressFlags::IS_LINK_LOCAL_BROADCAST;
998
999 static vector<AddressFlags> flagProvider = {
1000   // public v4
1001   AddressFlags("69.63.176.1", 4, 0),
1002   AddressFlags("128.12.65.3", 4, 0),
1003   AddressFlags("192.0.1.0", 4, 0),
1004   AddressFlags("198.51.101.0", 4, 0),
1005   AddressFlags("203.0.114.0", 4, 0),
1006   AddressFlags("128.12.64.115", 4, 0),
1007
1008   // public v6
1009   AddressFlags("2620:0:1cfe:face:b00c::3", 6, 0),
1010
1011   // localhost
1012   AddressFlags("127.0.0.1", 4, IS_LOCAL | IS_PVT_NONROUTE),
1013   AddressFlags("::1", 6, IS_LOCAL | IS_PVT_NONROUTE),
1014
1015   // link-local v4
1016   AddressFlags("169.254.0.1", 4, IS_LINK_LOCAL | IS_PVT_NONROUTE),
1017
1018   // private v4
1019   AddressFlags("10.0.0.0", 4, IS_PVT_NONROUTE),
1020   AddressFlags("10.11.12.13", 4, IS_PVT_NONROUTE),
1021   AddressFlags("10.255.255.255", 4, IS_PVT_NONROUTE),
1022   AddressFlags("127.128.129.200", 4, IS_LOCAL | IS_PVT_NONROUTE),
1023   AddressFlags("127.255.255.255", 4, IS_LOCAL | IS_PVT_NONROUTE),
1024   AddressFlags("169.254.0.0", 4, IS_LINK_LOCAL | IS_PVT_NONROUTE),
1025   AddressFlags("192.168.0.0", 4, IS_PVT_NONROUTE),
1026   AddressFlags("192.168.200.255", 4, IS_PVT_NONROUTE),
1027   AddressFlags("192.168.255.255", 4, IS_PVT_NONROUTE),
1028
1029   // private v6
1030   AddressFlags("fd01:1637:1c56:66af::", 6, IS_PVT_NONROUTE),
1031
1032   // non routable v4
1033   AddressFlags("0.0.0.0", 4, IS_NONROUTABLE | IS_ZERO),
1034   AddressFlags("0.255.255.255", 4, IS_NONROUTABLE),
1035   AddressFlags("192.0.0.0", 4, IS_NONROUTABLE),
1036   AddressFlags("192.0.2.0", 4, IS_NONROUTABLE),
1037   AddressFlags("198.18.0.0", 4, IS_NONROUTABLE),
1038   AddressFlags("198.19.255.255", 4, IS_NONROUTABLE),
1039   AddressFlags("198.51.100.0", 4, IS_NONROUTABLE),
1040   AddressFlags("198.51.100.255", 4, IS_NONROUTABLE),
1041   AddressFlags("203.0.113.0", 4, IS_NONROUTABLE),
1042   AddressFlags("203.0.113.255", 4, IS_NONROUTABLE),
1043   AddressFlags("224.0.0.0", 4, IS_NONROUTABLE | IS_MULTICAST),
1044   AddressFlags("240.0.0.0", 4, IS_NONROUTABLE),
1045   AddressFlags("224.0.0.0", 4, IS_NONROUTABLE),
1046   // v4 link local broadcast
1047   AddressFlags("255.255.255.255", 4, IS_NONROUTABLE | IS_LINK_LOCAL_BROADCAST),
1048
1049   // non routable v6
1050   AddressFlags("1999::1", 6, IS_NONROUTABLE),
1051   AddressFlags("0::0", 6, IS_NONROUTABLE | IS_ZERO),
1052   AddressFlags("0::0:0", 6, IS_NONROUTABLE | IS_ZERO),
1053   AddressFlags("0:0:0::0", 6, IS_NONROUTABLE | IS_ZERO),
1054
1055   // link-local v6
1056   AddressFlags("fe80::0205:73ff:fef9:46fc", 6, IS_LINK_LOCAL),
1057   AddressFlags("fe80::0012:34ff:fe56:7890", 6, IS_LINK_LOCAL),
1058
1059   // multicast v4
1060   AddressFlags("224.0.0.1", 4, IS_MULTICAST | IS_NONROUTABLE) ,
1061   AddressFlags("224.0.0.251", 4, IS_MULTICAST | IS_NONROUTABLE),
1062   AddressFlags("239.12.34.56", 4, IS_MULTICAST | IS_NONROUTABLE),
1063
1064   // multicast v6
1065   AddressFlags("ff00::", 6, IS_MULTICAST | IS_NONROUTABLE),
1066   AddressFlags("ff02:ffff::1", 6, IS_MULTICAST | IS_NONROUTABLE),
1067   AddressFlags("ff02::101", 6, IS_MULTICAST | IS_NONROUTABLE),
1068   AddressFlags("ff0e::101", 6, IS_MULTICAST),
1069   // v6 link local broadcast
1070   AddressFlags("ff02::1", 6, IS_NONROUTABLE | IS_LINK_LOCAL_BROADCAST),
1071 };
1072
1073 static const vector<pair<string, string> > mapProvider = {
1074   {"::ffff:192.0.2.128", "192.0.2.128"},
1075   {"192.0.2.128", "::ffff:192.0.2.128"},
1076   {"::FFFF:129.144.52.38", "129.144.52.38"},
1077   {"129.144.52.38", "::FFFF:129.144.52.38"},
1078   {"0:0:0:0:0:FFFF:222.1.41.90", "222.1.41.90"},
1079   {"::FFFF:222.1.41.90", "222.1.41.90"},
1080 };
1081
1082 static const vector<MaskData> masksProvider = {
1083   MaskData("255.255.255.255", 1, "128.0.0.0"),
1084   MaskData("255.255.255.255", 2, "192.0.0.0"),
1085   MaskData("192.0.2.42", 16, "192.0.0.0"),
1086   MaskData("255.255.255.255", 24, "255.255.255.0"),
1087   MaskData("255.255.255.255", 32, "255.255.255.255"),
1088   MaskData("10.10.10.10", 0, "0.0.0.0"),
1089   MaskData("::1", 64, "::"),
1090   MaskData("2620:0:1cfe:face:b00c::3", 1, "::"),
1091   MaskData("2620:0:1cfe:face:b00c::3", 3, "2000::"),
1092   MaskData("2620:0:1cfe:face:b00c::3", 6, "2400::"),
1093   MaskData("2620:0:1cfe:face:b00c::3", 7, "2600::"),
1094   MaskData("2620:0:1cfe:face:b00c::3", 11, "2620::"),
1095   MaskData("2620:0:1cfe:face:b00c::3", 36, "2620:0:1000::"),
1096   MaskData("2620:0:1cfe:face:b00c::3", 37, "2620:0:1800::"),
1097   MaskData("2620:0:1cfe:face:b00c::3", 38, "2620:0:1c00::"),
1098   MaskData("2620:0:1cfe:face:b00c::3", 41, "2620:0:1c80::"),
1099   MaskData("2620:0:1cfe:face:b00c::3", 42, "2620:0:1cc0::"),
1100   MaskData("2620:0:1cfe:face:b00c::3", 43, "2620:0:1ce0::"),
1101   MaskData("2620:0:1cfe:face:b00c::3", 44, "2620:0:1cf0::"),
1102   MaskData("2620:0:1cfe:face:b00c::3", 45, "2620:0:1cf8::"),
1103   MaskData("2620:0:1cfe:face:b00c::3", 46, "2620:0:1cfc::"),
1104   MaskData("2620:0:1cfe:face:b00c::3", 47, "2620:0:1cfe::"),
1105   MaskData("2620:0:1cfe:face:b00c::3", 49, "2620:0:1cfe:8000::"),
1106   MaskData("2620:0:1cfe:face:b00c::3", 50, "2620:0:1cfe:c000::"),
1107   MaskData("2620:0:1cfe:face:b00c::3", 51, "2620:0:1cfe:e000::"),
1108   MaskData("2620:0:1cfe:face:b00c::3", 52, "2620:0:1cfe:f000::"),
1109   MaskData("2620:0:1cfe:face:b00c::3", 53, "2620:0:1cfe:f800::"),
1110   MaskData("2620:0:1cfe:face:b00c::3", 55, "2620:0:1cfe:fa00::"),
1111   MaskData("2620:0:1cfe:face:b00c::3", 57, "2620:0:1cfe:fa80::"),
1112   MaskData("2620:0:1cfe:face:b00c::3", 58, "2620:0:1cfe:fac0::"),
1113   MaskData("2620:0:1cfe:face:b00c::3", 61, "2620:0:1cfe:fac8::"),
1114   MaskData("2620:0:1cfe:face:b00c::3", 62, "2620:0:1cfe:facc::"),
1115   MaskData("2620:0:1cfe:face:b00c::3", 63, "2620:0:1cfe:face::"),
1116   MaskData("2620:0:1cfe:face:b00c::3", 65, "2620:0:1cfe:face:8000::"),
1117   MaskData("2620:0:1cfe:face:b00c::3", 67, "2620:0:1cfe:face:a000::"),
1118   MaskData("2620:0:1cfe:face:b00c::3", 68, "2620:0:1cfe:face:b000::"),
1119   MaskData("2620:0:1cfe:face:b00c::3", 77, "2620:0:1cfe:face:b008::"),
1120   MaskData("2620:0:1cfe:face:b00c::3", 78, "2620:0:1cfe:face:b00c::"),
1121   MaskData("2620:0:1cfe:face:b00c::3", 127, "2620:0:1cfe:face:b00c::2"),
1122   MaskData("2620:0:1cfe:face:b00c::3", 128, "2620:0:1cfe:face:b00c::3"),
1123   MaskData("2620:0:1cfe:face:b00c::3", 0, "::")
1124 };
1125
1126 static const vector<MaskBoundaryData> maskBoundaryProvider = {
1127   MaskBoundaryData("10.1.1.1", 24, "10.1.1.1", true),
1128   MaskBoundaryData("10.1.1.1", 8, "10.1.2.3", true),
1129   MaskBoundaryData("2620:0:1cfe:face:b00c::1", 48, "2620:0:1cfe::", true),
1130   // addresses that are NOT in the same subnet once mask is applied
1131   MaskBoundaryData("10.1.1.1", 24, "10.1.2.1", false),
1132   MaskBoundaryData("10.1.1.1", 16, "10.2.3.4", false),
1133   MaskBoundaryData("2620:0:1cfe:face:b00c::1", 48, "2620:0:1cfc::", false),
1134 };
1135
1136 INSTANTIATE_TEST_CASE_P(IPAddress,
1137                         IPAddressTest,
1138                         ::testing::ValuesIn(validAddressProvider));
1139 INSTANTIATE_TEST_CASE_P(IPAddress,
1140                         IPAddressFlagTest,
1141                         ::testing::ValuesIn(flagProvider));
1142 INSTANTIATE_TEST_CASE_P(IPAddress,
1143                         IPAddressMappedTest,
1144                         ::testing::ValuesIn(mapProvider));
1145 INSTANTIATE_TEST_CASE_P(IPAddress,
1146                         IPAddressCtorTest,
1147                         ::testing::ValuesIn(invalidAddressProvider));
1148 INSTANTIATE_TEST_CASE_P(IPAddress,
1149                         IPAddressCtorBinaryTest,
1150                         ::testing::ValuesIn(invalidBinaryProvider));
1151 INSTANTIATE_TEST_CASE_P(IPAddress,
1152                         IPAddressMaskTest,
1153                         ::testing::ValuesIn(masksProvider));
1154 INSTANTIATE_TEST_CASE_P(IPAddress,
1155                         IPAddressMaskBoundaryTest,
1156                         ::testing::ValuesIn(maskBoundaryProvider));
1157 INSTANTIATE_TEST_CASE_P(IPAddress,
1158                         IPAddressByteAccessorTest,
1159                         ::testing::ValuesIn(validAddressProvider));
1160 INSTANTIATE_TEST_CASE_P(IPAddress,
1161                         IPAddressBitAccessorTest,
1162                         ::testing::ValuesIn(validAddressProvider));